解耦任务框架与业务任务

internal/apps/admin/task/routers.go

@@ -37,7 +37,7 @@ func init() {
 // @Failure 403 {object} util.ResponseAny "无管理员权限"
 // @Router /api/v1/admin/tasks/types [get]
 func ListTaskTypes(c *gin.Context) {
-	c.JSON(http.StatusOK, util.OK(task.DispatchableTasks))
+	c.JSON(http.StatusOK, util.OK(task.GetDispatchableTasks()))
 }
 
 // DispatchTaskRequest 下发任务请求

internal/apps/admin/task/routers_test.go

@@ -15,6 +15,8 @@ import (
 	"time"
 
 	"github.com/Rain-kl/Wavelet/internal/apps/oauth"
+	"github.com/Rain-kl/Wavelet/internal/apps/upload"
+	"github.com/Rain-kl/Wavelet/internal/apps/user"
 	"github.com/Rain-kl/Wavelet/internal/model"
 	"github.com/Rain-kl/Wavelet/internal/task"
 	"github.com/Rain-kl/Wavelet/internal/testhelper"
@@ -88,13 +90,13 @@ func TestListTaskTypes(t *testing.T) {
 
 	foundCleanup := false
 	for _, m := range taskMetas {
-		if m.Type == task.TaskTypeCleanupUploads {
+		if m.Type == upload.TaskTypeCleanupUploads {
 			foundCleanup = true
 			break
 		}
 	}
 	if !foundCleanup {
-		t.Errorf("expected task type %s to be listed", task.TaskTypeCleanupUploads)
+		t.Errorf("expected task type %s to be listed", upload.TaskTypeCleanupUploads)
 	}
 }
 
@@ -107,7 +109,7 @@ func TestDispatchTask(t *testing.T) {
 
 	t.Run("dispatch valid task successfully", func(t *testing.T) {
 		payload := DispatchTaskRequest{
-			TaskType: task.TaskTypeCleanupUploads,
+			TaskType: upload.TaskTypeCleanupUploads,
 		}
 		body, _ := json.Marshal(payload)
 		req, _ := http.NewRequest("POST", "/api/v1/admin/tasks/dispatch", bytes.NewBuffer(body))
@@ -130,7 +132,7 @@ func TestDispatchTask(t *testing.T) {
 
 	t.Run("dispatch send_email task successfully with valid payload", func(t *testing.T) {
 		payload := DispatchTaskRequest{
-			TaskType: task.TaskTypeSendEmail,
+			TaskType: user.TaskTypeSendEmail,
 			Payload:  `{"to":"receiver@example.com","subject":"Test Subject","body":"Test Body"}`,
 		}
 		body, _ := json.Marshal(payload)
@@ -149,7 +151,7 @@ func TestDispatchTask(t *testing.T) {
 
 	t.Run("dispatch send_email task failure with invalid payload json", func(t *testing.T) {
 		payload := DispatchTaskRequest{
-			TaskType: task.TaskTypeSendEmail,
+			TaskType: user.TaskTypeSendEmail,
 			Payload:  `{"to":`,
 		}
 		body, _ := json.Marshal(payload)
@@ -166,7 +168,7 @@ func TestDispatchTask(t *testing.T) {
 
 	t.Run("dispatch send_email task failure with missing fields", func(t *testing.T) {
 		payload := DispatchTaskRequest{
-			TaskType: task.TaskTypeSendEmail,
+			TaskType: user.TaskTypeSendEmail,
 			Payload:  `{"to":"","subject":"Test","body":"Test"}`,
 		}
 		body, _ := json.Marshal(payload)

internal/apps/upload/tasks.go

@@ -16,6 +16,26 @@ import (
 	"gorm.io/gorm"
 )
 
+// 异步任务名称与管理类型定义
+const (
+	// CleanupUnusedUploadsTask 清理未使用上传任务标识
+	CleanupUnusedUploadsTask = "upload:cleanup_unused"
+	// TaskTypeCleanupUploads 清理未使用上传管理类型
+	TaskTypeCleanupUploads = "cleanup_unused_uploads"
+)
+
+// 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,
+}
+
 // CleanupUnusedUploadsHandler 清理未使用上传文件的异步任务处理器
 type CleanupUnusedUploadsHandler struct{}
 

internal/apps/user/logics.go

@@ -109,7 +109,7 @@ func sendEmailVerificationCode(ctx context.Context, email, scene, templateName s
 		Body:    emailBody,
 	}
 	payloadBytes, _ := json.Marshal(payload)
-	_, err = task.DispatchTask(ctx, task.TaskTypeSendEmail, payloadBytes, "system")
+	_, err = task.DispatchTask(ctx, TaskTypeSendEmail, payloadBytes, "system")
 	if err != nil {
 		return errors.New(errDispatchEmailTaskFailed)
 	}

internal/apps/user/tasks.go

@@ -1,4 +1,3 @@
-// Copyright 2025 linux.do
 // Copyright 2026 Arctel.net
 // SPDX-License-Identifier: Apache-2.0
 
@@ -17,6 +16,52 @@ import (
 	"github.com/Rain-kl/Wavelet/internal/util/mail"
 )
 
+// 异步任务名称与管理类型定义
+const (
+	// SendEmailTask 发送邮件任务标识
+	SendEmailTask = "mail:send"
+	// TaskTypeSendEmail 发送邮件管理类型
+	TaskTypeSendEmail = "send_email"
+)
+
+// SendEmailMeta represents the task metadata.
+var SendEmailMeta = task.TaskMeta{
+	Type:         TaskTypeSendEmail,
+	AsynqTask:    SendEmailTask,
+	Name:         "发送邮件",
+	Description:  "异步发送系统邮件",
+	SupportsTime: false,
+	MaxRetry:     task.DefaultMaxRetry,
+	Queue:        task.QueueDefault,
+	Retryable:    true,
+	Params: []task.TaskParam{
+		{
+			Name:        "to",
+			Label:       "接收邮箱 (To)",
+			Type:        "string",
+			Required:    true,
+			Placeholder: "receiver@example.com",
+			Description: "接收邮件的目标邮箱地址",
+		},
+		{
+			Name:        "subject",
+			Label:       "邮件主题 (Subject)",
+			Type:        "string",
+			Required:    true,
+			Placeholder: "请输入邮件主题",
+			Description: "发送邮件的主题标题",
+		},
+		{
+			Name:        "body",
+			Label:       "邮件内容 (Body)",
+			Type:        "text",
+			Required:    true,
+			Placeholder: "请输入邮件内容（支持 HTML 格式）",
+			Description: "发送邮件的内容主体",
+		},
+	},
+}
+
 // SendEmailPayload 邮件发送任务载荷
 type SendEmailPayload struct {
 	To      string `json:"to"`