refactor(core): align with cordis spatiotemporal composability architecture

- Purify core micro-kernel by removing context hardcoded helpers and reverse dependencies
- Eliminate init() side effects in infra plugins with reversible lifecycle disposal
- Completely isolate plugins by removing cross-plugin imports and using core/contracts
- Introduce TaskService and RiskControlService contracts for unified cross-plugin APIs
- Regenerate Swagger documentation and update developer guide matrix
- Achieve 0 violations in check_cordis_architecture.sh and 100% test pass

backend/plugins/domain/upload/task/rebuild_stats.go

@@ -5,12 +5,14 @@ package task
 
 import (
 	"context"
+	"errors"
 	"fmt"
 
+	"Wavelet/core/contracts"
+	"Wavelet/pkg/logger"
 	"Wavelet/plugins/domain/upload/models"
+	"Wavelet/plugins/domain/upload/shared"
 	uploadstats "Wavelet/plugins/domain/upload/stats"
-	"Wavelet/plugins/drivers/driver_asynq_worker"
-	database "Wavelet/plugins/infra/database"
 )
 
 const (
@@ -21,52 +23,54 @@ const (
 )
 
 // RebuildUploadStatsMeta describes the upload stats rebuild task.
-var RebuildUploadStatsMeta = driver_asynq_worker.TaskMeta{
-	Type:         TaskTypeRebuildUploadStats,
-	AsynqTask:    RebuildUploadStatsTask,
-	Name:         "重算文件存储统计",
-	Description:  "根据当前 w_uploads 活跃记录全量重建 w_upload_stats（总量、类型、分类、趋势）",
-	SupportsTime: false,
-	MaxRetry:     driver_asynq_worker.DefaultMaxRetry,
-	Queue:        driver_asynq_worker.QueueDefault,
-	Retryable:    true,
+var RebuildUploadStatsMeta = contracts.TaskMetaDTO{
+	Name:        RebuildUploadStatsTask,
+	DisplayName: "重算文件存储统计",
+	Description: "根据当前 w_uploads 活跃记录全量重建 w_upload_stats（总量、类型、分类、趋势）",
+	Category:    "upload",
+	MaxRetry:    3,
+	Queue:       "default",
 }
 
 // RebuildUploadStatsHandler rebuilds incremental upload stats from active upload records.
 type RebuildUploadStatsHandler struct{}
 
 // Execute scans active uploads and rebuilds all upload stat dimensions.
-func (h *RebuildUploadStatsHandler) Execute(ctx context.Context, _ []byte) (*driver_asynq_worker.TaskResult, error) {
+func (h *RebuildUploadStatsHandler) Execute(ctx context.Context, _ []byte) (*contracts.TaskResultDTO, error) {
+	db := shared.GetDB(ctx)
+	if db == nil {
+		return nil, errors.New("database service not available")
+	}
+
 	var activeCount int64
-	if err := database.DB(ctx).
+	if err := db.
 		Model(&models.Upload{}).
 		Where("status != ?", models.UploadStatusDeleted).
 		Count(&activeCount).Error; err != nil {
-		driver_asynq_worker.AppendLog(ctx, "统计活跃上传记录失败: %v", err)
+		logger.ErrorF(ctx, "统计活跃上传记录失败: %v", err)
 		return nil, fmt.Errorf("count active uploads: %w", err)
 	}
 
-	driver_asynq_worker.AppendLog(ctx, "开始重算文件存储统计，活跃记录数: %d", activeCount)
+	logger.InfoF(ctx, "开始重算文件存储统计，活跃记录数: %d", activeCount)
 
 	if err := uploadstats.RebuildUploadStats(ctx); err != nil {
-		driver_asynq_worker.AppendLog(ctx, "重算文件存储统计失败: %v", err)
+		logger.ErrorF(ctx, "重算文件存储统计失败: %v", err)
 		return nil, fmt.Errorf("rebuild upload stats: %w", err)
 	}
 
 	var totalStat models.UploadStat
-	if err := database.DB(ctx).
+	if err := db.
 		Where("dimension = ? AND stat_key = ?", models.UploadStatDimensionTotal, "").
 		First(&totalStat).Error; err != nil {
-		driver_asynq_worker.AppendLog(ctx, "读取总量统计失败: %v", err)
-		return nil, fmt.Errorf("load total upload stats: %w", err)
+		logger.ErrorF(ctx, "读取总量统计失败: %v", err)
+		return nil, fmt.Errorf("read total upload stat: %w", err)
 	}
 
 	msg := fmt.Sprintf(
-		"文件存储统计重算完成，活跃记录 %d 条，统计文件数 %d，总大小 %d 字节",
-		activeCount,
+		"文件存储统计重算完成，活跃文件: %d 个，总大小: %d 字节",
 		totalStat.FileCount,
 		totalStat.FileSize,
 	)
-	driver_asynq_worker.AppendLog(ctx, "%s", msg)
-	return &driver_asynq_worker.TaskResult{Message: msg}, nil
+	logger.InfoF(ctx, "%s", msg)
+	return &contracts.TaskResultDTO{Message: msg}, nil
 }