feat(push): implement system notification and push framework

internal/apps/upload/tasks.go

@@ -11,21 +11,14 @@ import (
 	"fmt"
 	"strings"
 	"sync"
-	"time"
 
 	"github.com/Rain-kl/Wavelet/internal/db"
 	"github.com/Rain-kl/Wavelet/internal/model"
-	"github.com/Rain-kl/Wavelet/internal/storage"
 	"github.com/Rain-kl/Wavelet/internal/task"
-	"gorm.io/gorm"
 )
 
 // 异步任务名称与管理类型定义
 const (
-	// CleanupUnusedUploadsTask 清理未使用上传任务标识
-	CleanupUnusedUploadsTask = "upload:cleanup_unused"
-	// TaskTypeCleanupUploads 清理未使用上传管理类型
-	TaskTypeCleanupUploads = "cleanup_unused_uploads"
 	// WarmImageCacheTask 图片压缩缓存预热任务标识
 	WarmImageCacheTask = "upload:warm_image_cache"
 	// TaskTypeWarmImageCache 图片压缩缓存预热管理类型
@@ -34,18 +27,6 @@ const (
 
 var warmImageCacheMu sync.Mutex
 
-// CleanupUnusedUploadsMeta represents the task metadata.
-var CleanupUnusedUploadsMeta = task.TaskMeta{
-	Type:         TaskTypeCleanupUploads,
-	AsynqTask:    CleanupUnusedUploadsTask,
-	Name:         "清理未使用上传",
-	Description:  "清理超过1小时未使用的上传文件",
-	SupportsTime: false,
-	MaxRetry:     task.DefaultMaxRetry,
-	Queue:        task.QueueDefault,
-	Retryable:    true,
-}
-
 // WarmImageCacheMeta represents the image cache warmup task metadata.
 var WarmImageCacheMeta = task.TaskMeta{
 	Type:         TaskTypeWarmImageCache,
@@ -73,86 +54,12 @@ type WarmImageCachePayload struct {
 	Quality string `json:"quality"`
 }
 
-// CleanupUnusedUploadsHandler 清理未使用上传文件的异步任务处理器
-type CleanupUnusedUploadsHandler struct{}
+// SystemCleanupHandler 系统定期垃圾清理异步任务处理器
 
 // WarmImageCacheHandler serially warms compressed image cache entries.
 type WarmImageCacheHandler struct{}
 
-// Execute 执行清理未使用上传文件的业务逻辑
-func (h *CleanupUnusedUploadsHandler) Execute(ctx context.Context, _ []byte) (*task.TaskResult, error) {
-	if storageReadOnly(ctx) {
-		return nil, errors.New(ErrStorageReadOnly)
-	}
-	const batchSize = 100 // 每批处理100个文件
-	var lastID uint64
-	var totalProcessed int
-	var totalDeleted int
-
-	// 计算1小时前的时间
-	oneHourAgo := time.Now().Add(-1 * time.Hour)
-
-	task.AppendLog(ctx, "开始扫描未使用上传文件，阈值: %s", oneHourAgo.Format(time.RFC3339))
-
-	for {
-		// 使用游标分页查询未使用且超过1小时的上传记录
-		var unusedUploads []model.Upload
-		if err := db.DB(ctx).
-			Where("id > ? AND status = ? AND created_at < ?", lastID, model.UploadStatusPending, oneHourAgo).
-			Order("id ASC").
-			Limit(batchSize).
-			Find(&unusedUploads).Error; err != nil {
-			task.AppendLog(ctx, "查询未使用的上传文件失败: %v", err)
-			return nil, fmt.Errorf(ErrQueryUnusedUploadsFailed, err)
-		}
-
-		// 没有更多数据，退出循环
-		if len(unusedUploads) == 0 {
-			break
-		}
-
-		task.AppendLog(ctx, "本批次找到 %d 个需要清理的上传文件", len(unusedUploads))
-
-		// 处理每个未使用的上传文件
-		for _, upload := range unusedUploads {
-			totalProcessed++
-
-			if err := db.DB(ctx).Transaction(func(tx *gorm.DB) error {
-				// 更新上传记录状态
-				if err := tx.Model(&model.Upload{}).
-					Where("id = ? AND status = ?", upload.ID, model.UploadStatusPending).
-					Update("status", model.UploadStatusDeleted).Error; err != nil {
-					return err
-				}
-
-				driver := storage.Driver(upload.StorageDriver)
-				if driver == "" {
-					driver = storage.DriverLocal
-				}
-				backend, err := storage.ForDriver(ctx, driver)
-				if err != nil {
-					return err
-				}
-				if err := backend.Delete(ctx, upload.FilePath); err != nil {
-					return err
-				}
-
-				return nil
-			}); err != nil {
-				task.AppendLog(ctx, "清理上传文件失败 [ID:%d]: %v", upload.ID, err)
-				lastID = upload.ID
-				continue
-			}
-
-			totalDeleted++
-			lastID = upload.ID
-		}
-	}
-
-	msg := fmt.Sprintf("共处理 %d 个文件，成功删除 %d 个", totalProcessed, totalDeleted)
-	task.AppendLog(ctx, "%s", msg)
-	return &task.TaskResult{Message: msg}, nil
-}
+// Execute 执行系统清理（包含文件清理和历史消息推送日志清理）
 
 // ValidatePayload validates and normalizes image cache warmup parameters.
 func (h *WarmImageCacheHandler) ValidatePayload(payload []byte) ([]byte, error) {