微信小程序页面迁移校验之前 P5任务处理之前

docs/prd/specs/P4-miniapp-core-business.md

@@ -12,9 +12,10 @@
 1. 作为助教，我每天打开小程序能看到系统为我分配的任务列表，按优先级排序。
 2. 作为助教，我可以置顶/放弃任务，放弃时必须填写原因。
 3. 作为助教，我完成召回任务后（客户到店被服务），系统自动标记任务完成。
-4. 作为助教，我给客户添加回访备注后，系统自动评估备注含金量（≥6 分算完成）。
-5. 作为系统，回访任务至少保留 48 小时，到期后自动失效。
-6. 作为系统，当 ETL 数据延迟导致召回完成晚于备注提交时，需要回溯重分类备注。
+4. 作为助教，我给客户添加备注后，系统自动通过 AI 分析备注内容（应用 6），提取维客线索并评分。回访备注评分 ≥6 分算回访完成。
+5. 作为助教，我在添加备注时可以对客户进行星星评分（再次服务意愿、再来店可能性，各 1-5 星），回访任务默认展开评分区域，其他任务类型通过"展开评价"按钮手动打开。
+6. 作为系统，回访任务至少保留 48 小时，到期后自动失效。
+7. 作为系统，当 ETL 数据延迟导致召回完成晚于备注提交时，需要回溯重分类备注。
 
 ### 验收标准
 
@@ -23,9 +24,11 @@
 - AC3：回访任务 48 小时滞留机制正常（生成时间算起）
 - AC4：任务有效/无效状态 + 有效期字段正确流转
 - AC5：召回完成检测在 ETL 数据到达后自动触发
-- AC6：数据回溯将普通备注重分类为回访备注并触发 AI 评分
+- AC6：数据回溯将普通备注重分类为回访备注并触发 AI 备注分析
 - AC7：备注 CRUD 正常，type 字段正确区分
-- AC8：生日信息独立于 ETL 数据，不被覆盖
+- AC8：生日信息作为维客线索（客户基础信息类别）存储于 `member_retention_clue`，独立于 ETL 数据
+- AC9：备注星星评分（再次服务意愿、再来店可能性）正确存储，不参与完成判定，不参与应用 6 分析，仅作辅助数据
+- AC10：回访任务页面默认展开评分区域；其他任务类型默认隐藏，通过"展开评价"按钮手动打开（数据迟到场景：助教在召回任务中提前写备注+评分）
 
 ---
 
@@ -37,7 +40,7 @@
 |--------|------|---------|---------|
 | 0 | 高优先召回 | max(WBI,NCI) > 7 | 助教为该客户服务（ETL 检测） |
 | 0 | 优先召回 | max(WBI,NCI) > 5 | 同上 |
-| 1 | 客户回访 | 完成召回后未备注 | 提交备注且 AI 评分 ≥ 6 |
+| 1 | 客户回访 | 完成召回后未备注 | 提交备注且应用 6 备注分析评分 ≥ 6 |
 | 2 | 关系构建 | RS < 6 | 无自动完成条件（手动标记或指数变化） |
 
 ### 任务状态机
@@ -68,6 +71,25 @@ biz.coach_tasks
   - created_at, updated_at
 ```
 
+### notes 表核心字段
+
+```
+biz.notes
+  - id, site_id, user_id, target_type, target_id
+  - type (normal / follow_up / abandon_reason)
+  - content (TEXT)
+  - rating_service_willingness (SMALLINT 1-5, 可空，再次服务此客户意愿)
+  - rating_revisit_likelihood (SMALLINT 1-5, 可空，再来店可能性)
+  - task_id (关联任务 ID, 可空)
+  - created_at, updated_at
+```
+
+> 星星评分说明：
+> - 回访任务（follow_up_visit）：备注弹窗默认展开评分区域
+> - 其他任务类型：评分区域默认隐藏，通过"展开评价"按钮手动打开
+> - 数据迟到场景：助教在召回任务中完成服务后顺手写备注，此时 ETL 数据未到，任务仍为召回类型，评分区域隐藏但可手动展开；当 ETL 数据到达、召回完成检测触发后，回溯机制将该备注重分类为回访备注，星星评分数据一并保留
+> - 星星评分不参与回访完成判定（完成判定仅看应用 6 评分 ≥6），不参与应用 6 分析，仅作辅助数据存储，后期功能扩展使用
+
 ### 触发器机制
 
 ```
@@ -91,12 +113,12 @@ biz.trigger_jobs
 ## 任务清单
 
 - [ ] T1：创建 `biz.coach_tasks` + `biz.coach_task_history` 表
-- [ ] T2：创建 `biz.notes` 表（type: normal/follow_up/birthday/abandon_reason）
+- [ ] T2：创建 `biz.notes` 表（type: normal/follow_up/abandon_reason，含 `rating_service_willingness` SMALLINT 1-5 可空、`rating_revisit_likelihood` SMALLINT 1-5 可空）
 - [ ] T3：创建 `biz.trigger_jobs` 表 + 轮询调度框架
 - [ ] T4：实现任务生成器（读取指数 → 分配任务 → 跳过/更新逻辑）
 - [ ] T5：实现 48 小时滞留机制 + 有效期轮询
 - [ ] T6：实现召回完成检测（ETL 数据到达后匹配 service_log）
-- [ ] T7：实现数据回溯机制（普通备注 → 回访备注 + 触发 AI 评分）
+- [ ] T7：实现数据回溯机制（普通备注 → 回访备注 + 触发 AI 备注分析）
 - [ ] T8：实现任务 CRUD API（列表/详情/置顶/放弃/取消置顶/取消放弃）
-- [ ] T9：实现备注 CRUD API（创建/列表/删除）
-- [ ] T10：实现生日信息隔离存储逻辑
+- [ ] T9：实现备注 CRUD API（创建/列表/删除，含星星评分字段的存储与读取）
+- [ ] T10：生日信息已迁移至维客线索系统（`member_retention_clue`），无需单独处理