Version: 0.6.3.dev.260316

✨ feat(task): 新增四象限任务懒触发自动平移链路（读时派生 + Outbox 异步收敛） - 🧩 为 `Task` 模型新增 `urgency_threshold_at` 字段，并补充复合索引 `user_id,is_completed,urgency_threshold_at,priority` 及相关事件 payload - ♻️ 重构 `TaskService.GetUserTasks`：调整为“缓存/DB 读取原始任务 -> 读时派生优先级（`2 -> 1`、`4 -> 3`）-> 通过 `SETNX` 去重后发布平移事件”的处理链路 - 🚚 新增任务平移事件链路： - `service/events/task_urgency_promote.go` - 事件类型：`task.urgency.promote.requested` - 支持 `Publish` + `RegisterHandler` + `ConsumeAndMarkConsumed` 的事务化消费流程 - 🛡️ 为 `TaskDAO` 新增幂等批量更新能力 `PromoteTaskUrgencyByIDs`，采用条件更新策略，仅对“达到阈值且未完成”的任务生效 - 🔌 更新启动接线逻辑：注册任务平移 handler，并将 `eventBus` 注入 `NewTaskService` - 🧹 修复并升级任务缓存层，统一为 `[]model.Task` 原始模型缓存；同时清理误导性注释，并补充详细中文步骤化注释 - 🔗 打通 `QuickNote` 链路中的 `urgency_threshold_at` 透传与校验，覆盖 `state` / `tool` / `nodes` / `prompt` / `agent_quick_note` 全链路 - 💾 写库时补充落库 `task.UrgencyThresholdAt` - 📝 新增功能决策记录之前画的饼正在一块块填上~这一块饼填上之后，第一批开发的后端部分基本已经搞定了。后面的功能全都是天马行空的拓展功能。
2026-03-16 20:33:33 +08:00
parent daeff0afab
commit 84371e2ff8
12 changed files with 792 additions and 115 deletions
--- a/backend/dao/cache.go
+++ b/backend/dao/cache.go
@@ -19,44 +19,44 @@ func NewCacheDAO(client *redis.Client) *CacheDAO {
 	return &CacheDAO{client: client}
 }

-// SetBlacklist 把 Token 扔进黑名单
+// SetBlacklist 鎶?Token 鎵旇繘榛戝悕鍗?
 func (d *CacheDAO) SetBlacklist(jti string, expiration time.Duration) error {
 	return d.client.Set(context.Background(), "blacklist:"+jti, "1", expiration).Err()
 }

-// IsBlacklisted 检查 Token 是否在黑名单中
+// IsBlacklisted 妫€鏌?Token 鏄惁鍦ㄩ粦鍚嶅崟涓?
 func (d *CacheDAO) IsBlacklisted(jti string) (bool, error) {
 	result, err := d.client.Get(context.Background(), "blacklist:"+jti).Result()
 	if errors.Is(err, redis.Nil) {
-		return false, nil // 不在黑名单
+		return false, nil // 涓嶅湪榛戝悕鍗?
 	} else if err != nil {
-		return false, err // 其他错误
+		return false, err // 鍏朵粬閿欒
 	}
-	return result == "1", nil // 在黑名单
+	return result == "1", nil // 鍦ㄩ粦鍚嶅崟
 }

 func (d *CacheDAO) AddTaskClassList(ctx context.Context, userID int, list *model.UserGetTaskClassesResponse) error {
-	// 1. 定义 Key，使用 userID 隔离不同用户的数据
+	// 1. 瀹氫箟 Key锛屼娇鐢?userID 闅旂涓嶅悓鐢ㄦ埛鐨勬暟鎹?
 	key := fmt.Sprintf("smartflow:task_classes:%d", userID)
-	// 2. 序列化：将结构体转为 []byte
+	// 2. 搴忓垪鍖栵細灏嗙粨鏋勪綋杞负 []byte
 	data, err := json.Marshal(list)
 	if err != nil {
 		return err
 	}
-	// 3. 存储：设置 30 分钟过期（根据业务灵活调整）
+	// 3. 瀛樺偍锛氳缃?30 鍒嗛挓杩囨湡锛堟牴鎹笟鍔＄伒娲昏皟鏁达級
 	return d.client.Set(ctx, key, data, 30*time.Minute).Err()
 }

 func (d *CacheDAO) GetTaskClassList(ctx context.Context, userID int) (*model.UserGetTaskClassesResponse, error) {
 	key := fmt.Sprintf("smartflow:task_classes:%d", userID)
 	var resp model.UserGetTaskClassesResponse
-	// 1. 从 Redis 获取字符串
+	// 1. 浠?Redis 鑾峰彇瀛楃涓?
 	val, err := d.client.Get(ctx, key).Result()
 	if err != nil {
-		// 注意：如果是 redis.Nil，交给 Service 层处理查库逻辑
+		// 娉ㄦ剰锛氬鏋滄槸 redis.Nil锛屼氦缁?Service 灞傚鐞嗘煡搴撻€昏緫
 		return &resp, err
 	}
-	// 2. 反序列化：将 JSON 还原回结构体
+	// 2. 鍙嶅簭鍒楀寲锛氬皢 JSON 杩樺師鍥炵粨鏋勪綋
 	err = json.Unmarshal([]byte(val), &resp)
 	return &resp, err
 }
@@ -69,9 +69,9 @@ func (d *CacheDAO) DeleteTaskClassList(ctx context.Context, userID int) error {
 func (d *CacheDAO) GetRecord(ctx context.Context, key string) (string, error) {
 	val, err := d.client.Get(ctx, key).Result()
 	if errors.Is(err, redis.Nil) {
-		return "", nil // 正常没命中的情况
+		return "", nil // 姝ｅ父娌″懡涓殑鎯呭喌
 	}
-	return val, err // 真正的 Redis 报错
+	return val, err // 鐪熸鐨?Redis 鎶ラ敊
 }

 func (d *CacheDAO) SaveRecord(ctx context.Context, key string, val string, ttl time.Duration) error {
@@ -86,18 +86,40 @@ func (d *CacheDAO) ReleaseLock(ctx context.Context, key string) error {
 	return d.client.Del(ctx, key).Err()
 }

-func (d *CacheDAO) GetUserTasksFromCache(ctx context.Context, userID int) ([]model.GetUserTaskResp, error) {
+// GetUserTasksFromCache 读取用户任务缓存（内部模型版本）。
+//
+// 职责边界：
+// 1. 负责从 Redis 读取 `[]model.Task`，供 Service 层做“读时派生优先级”；
+// 2. 不负责把模型转换成对外 DTO（该职责在 conv 层）；
+// 3. 不负责缓存回填和缓存失效（回填由 Service 控制，失效由 GORM cache_deleter 统一处理）。
+//
+// 输入输出语义：
+// 1. 命中缓存时返回任务模型切片与 nil error；
+// 2. 未命中时返回 redis.Nil，由上层决定是否回源 DB；
+// 3. 反序列化失败时返回 error，避免把损坏缓存继续向后传播。
+func (d *CacheDAO) GetUserTasksFromCache(ctx context.Context, userID int) ([]model.Task, error) {
 	key := fmt.Sprintf("smartflow:tasks:%d", userID)
-	var tasks []model.GetUserTaskResp
+	var tasks []model.Task
 	val, err := d.client.Get(ctx, key).Result()
 	if err != nil {
-		return nil, err // 注意：如果是 redis.Nil，交给 Service 层处理查库逻辑
+		return nil, err // 娉ㄦ剰锛氬鏋滄槸 redis.Nil锛屼氦缁?Service 灞傚鐞嗘煡搴撻€昏緫
 	}
 	err = json.Unmarshal([]byte(val), &tasks)
 	return tasks, err
 }

-func (d *CacheDAO) SetUserTasksToCache(ctx context.Context, userID int, tasks []model.GetUserTaskResp) error {
+// SetUserTasksToCache 写入用户任务缓存（内部模型版本）。
+//
+// 职责边界：
+// 1. 负责把 DB 读取到的原始 `[]model.Task` 写入缓存；
+// 2. 不负责对任务做“紧急性平移派生”，避免把派生结果写回缓存导致后续无法继续触发异步平移；
+// 3. 不负责缓存删除，删除策略由 cache_deleter 在写库后触发。
+//
+// 步骤说明：
+// 1. 先把模型序列化为 JSON，确保 `urgency_threshold_at` 等字段完整保留；
+// 2. 再写入固定 TTL 缓存，命中后可减少 DB 读取压力；
+// 3. 若序列化失败立即返回 error，避免写入半结构化垃圾数据。
+func (d *CacheDAO) SetUserTasksToCache(ctx context.Context, userID int, tasks []model.Task) error {
 	key := fmt.Sprintf("smartflow:tasks:%d", userID)
 	data, err := json.Marshal(tasks)
 	if err != nil {
@@ -116,7 +138,7 @@ func (d *CacheDAO) GetUserTodayScheduleFromCache(ctx context.Context, userID int
 	var schedules []model.UserTodaySchedule
 	val, err := d.client.Get(ctx, key).Result()
 	if err != nil {
-		return nil, err // 注意：如果是 redis.Nil，交给 Service 层处理查库逻辑
+		return nil, err // 娉ㄦ剰锛氬鏋滄槸 redis.Nil锛屼氦缁?Service 灞傚鐞嗘煡搴撻€昏緫
 	}
 	err = json.Unmarshal([]byte(val), &schedules)
 	return schedules, err
@@ -128,7 +150,7 @@ func (d *CacheDAO) SetUserTodayScheduleToCache(ctx context.Context, userID int,
 	if err != nil {
 		return err
 	}
-	// 设置过期时间为当天剩余的时间，确保每天更新一次缓存
+	// 璁剧疆杩囨湡鏃堕棿涓哄綋澶╁墿浣欑殑鏃堕棿锛岀‘淇濇瘡澶╂洿鏂颁竴娆＄紦瀛?
 	return d.client.Set(ctx, key, data, time.Until(time.Date(time.Now().Year(), time.Now().Month(), time.Now().Day()+1, 0, 0, 0, 0, time.Now().Location()))).Err()
 }

@@ -142,7 +164,7 @@ func (d *CacheDAO) GetUserWeeklyScheduleFromCache(ctx context.Context, userID in
 	var schedules model.UserWeekSchedule
 	val, err := d.client.Get(ctx, key).Result()
 	if err != nil {
-		return nil, err // 注意：如果是 redis.Nil，交给 Service 层处理查库逻辑
+		return nil, err // 娉ㄦ剰锛氬鏋滄槸 redis.Nil锛屼氦缁?Service 灞傚鐞嗘煡搴撻€昏緫
 	}
 	err = json.Unmarshal([]byte(val), &schedules)
 	return &schedules, err
@@ -154,7 +176,7 @@ func (d *CacheDAO) SetUserWeeklyScheduleToCache(ctx context.Context, userID int,
 	if err != nil {
 		return err
 	}
-	// 设置过期时间为一天
+	// 璁剧疆杩囨湡鏃堕棿涓轰竴澶?
 	return d.client.Set(ctx, key, data, 24*time.Hour).Err()
 }

@@ -168,7 +190,7 @@ func (d *CacheDAO) GetUserRecentCompletedSchedulesFromCache(ctx context.Context,
 	var resp model.UserRecentCompletedScheduleResponse
 	val, err := d.client.Get(ctx, key).Result()
 	if err != nil {
-		return &resp, err // 注意：如果是 redis.Nil，交给 Service 层处理查库逻辑
+		return &resp, err // 娉ㄦ剰锛氬鏋滄槸 redis.Nil锛屼氦缁?Service 灞傚鐞嗘煡搴撻€昏緫
 	}
 	err = json.Unmarshal([]byte(val), &resp)
 	return &resp, err
@@ -180,7 +202,7 @@ func (d *CacheDAO) SetUserRecentCompletedSchedulesToCache(ctx context.Context, u
 	if err != nil {
 		return err
 	}
-	// 设置过期时间为30分钟
+	// 璁剧疆杩囨湡鏃堕棿涓?0鍒嗛挓
 	return d.client.Set(ctx, key, data, 30*time.Minute).Err()
 }

@@ -194,7 +216,7 @@ func (d *CacheDAO) DeleteUserRecentCompletedSchedulesFromCache(ctx context.Conte
 			return err
 		}
 		if len(keys) > 0 {
-			// 用 UNLINK\(\) 异步删除，降低阻塞风险；如需强一致删除可改用 Del\(\)
+			// 鐢?UNLINK\(\) 寮傛鍒犻櫎锛岄檷浣庨樆濉為闄╋紱濡傞渶寮轰竴鑷村垹闄ゅ彲鏀圭敤 Del\(\)
 			if err := d.client.Unlink(ctx, keys...).Err(); err != nil {
 				return err
 			}
@@ -212,10 +234,10 @@ func (d *CacheDAO) GetUserOngoingScheduleFromCache(ctx context.Context, userID i
 	var schedule model.OngoingSchedule
 	val, err := d.client.Get(ctx, key).Result()
 	if err != nil {
-		return &schedule, err // 注意：如果是 redis.Nil，交给 Service 层处理查库逻辑
+		return &schedule, err // 娉ㄦ剰锛氬鏋滄槸 redis.Nil锛屼氦缁?Service 灞傚鐞嗘煡搴撻€昏緫
 	}
 	if val == "null" {
-		return nil, nil // 之前缓存过没有正在进行的日程，直接返回 nil
+		return nil, nil // 涔嬪墠缂撳瓨杩囨病鏈夋鍦ㄨ繘琛岀殑鏃ョ▼锛岀洿鎺ヨ繑鍥?nil
 	}
 	err = json.Unmarshal([]byte(val), &schedule)
 	return &schedule, err
@@ -223,7 +245,7 @@ func (d *CacheDAO) GetUserOngoingScheduleFromCache(ctx context.Context, userID i

 func (d *CacheDAO) SetUserOngoingScheduleToCache(ctx context.Context, userID int, schedule *model.OngoingSchedule) error {
 	if schedule == nil {
-		// 如果没有正在进行的日程，设置空值并短暂过期，避免频繁查库
+		// 濡傛灉娌℃湁姝ｅ湪杩涜鐨勬棩绋嬶紝璁剧疆绌哄€煎苟鐭殏杩囨湡锛岄伩鍏嶉绻佹煡搴?
 		key := fmt.Sprintf("smartflow:ongoing_schedule:%d", userID)
 		return d.client.Set(ctx, key, "null", 5*time.Minute).Err()
 	}
@@ -232,7 +254,7 @@ func (d *CacheDAO) SetUserOngoingScheduleToCache(ctx context.Context, userID int
 	if err != nil {
 		return err
 	}
-	// 设置过期时间为到 endTime 的剩余时间（若已过期则不写入缓存）
+	// 璁剧疆杩囨湡鏃堕棿涓哄埌 endTime 鐨勫墿浣欐椂闂达紙鑻ュ凡杩囨湡鍒欎笉鍐欏叆缂撳瓨锛?
 	ttl := time.Until(schedule.EndTime)
 	if ttl <= 0 {
 		return nil
--- a/backend/dao/task.go
+++ b/backend/dao/task.go
@@ -1,6 +1,9 @@
 package dao

 import (
+	"context"
+	"time"
+
 	"github.com/LoveLosita/smartflow/backend/model"
 	"github.com/LoveLosita/smartflow/backend/respond"
 	"gorm.io/gorm"
@@ -41,3 +44,65 @@ func (dao *TaskDAO) GetTasksByUserID(userID int) ([]model.Task, error) {
 	}
 	return tasks, nil
 }
+
+// PromoteTaskUrgencyByIDs 批量执行“任务紧急性平移”。
+//
+// 职责边界：
+//  1. 只负责把满足条件的任务从“不紧急象限”平移到“紧急象限”：
+//     1.1 priority=2 -> 1（重要不紧急 -> 重要且紧急）；
+//     1.2 priority=4 -> 3（不简单不重要 -> 简单不重要）；
+//  2. 只更新本次指定 user_id + task_ids 范围内的数据；
+//  3. 不负责事件发布、重试去重和缓存策略（由 Service/Outbox 负责）。
+//
+// 幂等与一致性说明：
+// 1. SQL 条件会限制 `is_completed=0`、`urgency_threshold_at<=now`、`priority IN (2,4)`；
+// 2. 同一批任务重复调用时，已经平移过的记录不会再次更新（幂等）；
+// 3. 使用 `Model(&model.Task{UserID:userID})` 是为了让 GORM 回调拿到 user_id，从而触发 cache_deleter 删除任务缓存。
+func (dao *TaskDAO) PromoteTaskUrgencyByIDs(ctx context.Context, userID int, taskIDs []int, now time.Time) (int64, error) {
+	// 1. 基础兜底：非法 user 或空任务列表直接无操作返回。
+	if userID <= 0 || len(taskIDs) == 0 {
+		return 0, nil
+	}
+
+	// 2. 去重并过滤非正数 ID，避免无效 where in 条件放大 SQL 噪音。
+	validTaskIDs := compactPositiveIntIDs(taskIDs)
+	if len(validTaskIDs) == 0 {
+		return 0, nil
+	}
+
+	// 3. 条件更新：只更新“已到紧急分界线且仍处于非紧急象限”的任务。
+	result := dao.db.WithContext(ctx).
+		Model(&model.Task{UserID: userID}).
+		Where("user_id = ?", userID).
+		Where("id IN ?", validTaskIDs).
+		Where("is_completed = ?", false).
+		Where("urgency_threshold_at IS NOT NULL AND urgency_threshold_at <= ?", now).
+		Where("priority IN ?", []int{2, 4}).
+		Update("priority", gorm.Expr("CASE WHEN priority = 2 THEN 1 WHEN priority = 4 THEN 3 ELSE priority END"))
+
+	if result.Error != nil {
+		return 0, result.Error
+	}
+	return result.RowsAffected, nil
+}
+
+// compactPositiveIntIDs 对 int 切片做“去重 + 过滤非正数”。
+//
+// 说明：
+// 1. 该函数是 DAO 内部参数清洗工具，不参与任何业务判定；
+// 2. 返回结果不保证稳定顺序，对当前 SQL where in 场景无影响。
+func compactPositiveIntIDs(ids []int) []int {
+	seen := make(map[int]struct{}, len(ids))
+	result := make([]int, 0, len(ids))
+	for _, id := range ids {
+		if id <= 0 {
+			continue
+		}
+		if _, exists := seen[id]; exists {
+			continue
+		}
+		seen[id] = struct{}{}
+		result = append(result, id)
+	}
+	return result
+}