child-zone-kickoff-20261107.md 6.1 KB

孩子端批次 · 开工包(26 SC)

归属:契约补建计划 P0「孩子端(不能登录视角)」· 生成 2026-11-07 08:35 数据源:sc-key-map.md(origin/cfclub,O-8 归一后 241 全量登记)· 端点核对:cfc-backend controller 源码(origin/cfclub 工作树) 前置:O-7 裁决(主理人 2026-11-06 23:59 最终确认)契约补建工作流正式生效——契约核对 = 文档核对 + 端点比对(防假 RED),产出契约文档后转测试侧补契约 JUnit + 三类流证据,渐进而非全量。

批次定位

孩子端 = 「不能登录用户」视角(family_members.userId 为空或关联 User 无 openid,由同家庭能登录用户代管其数据)。本批 26 个 SC(SC-C-01~26)在 sc-key-map 台账「对应能力键」列全为 —(此前未契约化)。按 O-7 裁决:本批端点载体须逐条核验,产出契约文档后转测试侧,不建伪实现任务。

端点核验(初核候选,会话须逐条核实并回填)

SC 场景标题 候选端点载体(origin/cfclub 工作树) 初核
SC-C-01 孩子端登录(无家长入口) AuthController /api/auth/*(孩子 token 角色门禁);JwtInterceptor 角色校验 ✅
SC-C-02 执行任务 / 小游戏得积分 TaskController /api/tasks/*;PointsController /api/points/*;小游戏路由 ✅
SC-C-03 小游戏成绩上报 小游戏相关 Controller(/api/game*,须核实实际前缀) ⚠ 待核实
SC-C-04 提心愿 WishController /api/wishes/* ✅
SC-C-05 任务打卡 ⭐ TaskController 完成/打卡;DailyTaskController /api/daily-task/* ✅
SC-C-06 查看能量与报告(只读) EnergyController /api/energy/*(overview/logs) ✅
SC-C-07 查看 DAN 测评报告 DanAssessmentController /api/dan-assessment/*;/api/dan-assessment/result ✅
SC-C-08 方案打卡进度 HealthPlanController /api/health/plan/*;GrowthPlanController /api/growth/plan/* ✅
SC-C-09 勋章墙 成就/勋章 Controller(achievement.*,须核实路由前缀) ⚠ 待核实
SC-C-10 勋章解锁提醒 同上 + NotificationController /api/notification/* ⚠ 待核实
SC-C-11 成长记录查看(孩子视角) GrowthController /api/growth/* ✅
SC-C-12 饮食食谱查看 DietRecommendationController /api/diet/recommendation/*、/api/diet/meals/* ✅
SC-C-13 AI 对话(孩子视角) AIChatController /api/ai/*(孩子 token 上下文) ✅
SC-C-14 任务驳回重做 TaskController 审核/驳回;ReviewController /api/review/* ✅
SC-C-15 消息接收 NotificationController /api/notification/* ✅
SC-C-16 个人资料查看(受限) UserController /api/user/*(只读字段白名单) ✅
SC-C-17 退出登录 AuthController 登出/token 失效 ✅
SC-C-18 设备/账号绑定校验 AuthController + 微信登录态校验 ⚠ 待核实
SC-C-19 查看家人/规划师消息通知 NotificationController;GuideMessage /api/guide/messages/* ✅
SC-C-20 成长档案查看/家长代导出 GrowthController;导出端点(须核实) ⚠ 待核实
SC-C-21 舌诊/情绪自拍采集(孩子端) EmotionCheckinController /api/mind/checkin/*;舌诊采集端点 ⚠ 待核实
SC-C-22 商城浏览/积分兑换(孩子端消费) ProductController /api/product/*;/api/admin/product-ppoint(ppoint 兑换) ✅
SC-C-23 意见反馈(孩子端) ActivityFeedbackController /api/activity/feedback/* ✅
SC-C-24 小游戏/任务得分触发五维增长(仅自身可见) EnergyController 行为计分链 + AdminEnergyBehaviorConfigController ✅
SC-C-25 方案任务打卡触发五维增长 TaskController 完成 → Energy 归因链 ✅
SC-C-26 睡眠打卡:「正常」选项且由后台配置驱动 sleep.config.tags(YELLOW,实现已在 origin/cfclub;PublicConfigController + 后台配置项) ✅

⚠ 标注项:会话须以 grep -rn '@RequestMapping|@PostMapping' cfc-backend/src/main/java/com/etotem/cfc/controller/ 实测定位,不得假定包路径;若端点确实缺失 → 记入契约文档「实现缺口」段并回传研发侧,不在本任务内实现。

建议能力键(契约定稿后按 O-2 方案 A 映射)

  • child.login(SC-C-01 / C-17 / C-18)
  • child.task.execute(SC-C-02 / C-05 / C-25)
  • child.game.score(SC-C-03)
  • child.wish.create(SC-C-04)
  • child.energy.view(SC-C-06 / C-24)
  • child.dan.report.view(SC-C-07)
  • child.plan.progress(SC-C-08)
  • child.achievement.view(SC-C-09 / C-10)
  • child.growth.view(SC-C-11 / C-20)
  • child.diet.view(SC-C-12)
  • child.ai.chat(SC-C-13)
  • child.task.reject(SC-C-14)
  • child.notification.view(SC-C-15 / C-19)
  • child.profile.view(SC-C-16)
  • child.mind.capture(SC-C-21)
  • child.shop.redeem(SC-C-22)
  • child.feedback.submit(SC-C-23)
  • child.sleep.checkin(SC-C-26,关联既有 sleep.config.tags)

注:以上为建议映射(防假 RED 端点核验用),非最终契约键;定稿须逐条对齐 docs/superpowers/api/API_REFERENCE.md 与 tests/test-cases/*.md 派生用例,避免与既有键冲突(task.parent.* / energy.* / dimension.* 已存在)。

待办(O-7 授权节奏)

  1. 契约核对会话(本批 lan-189)产出契约文档:docs/superpowers/api/API_REFERENCE.md 增补「孩子端(不能登录用户视角)」段落 + docs/superpowers/specs/2026-11-07-child-zone-contract.md 契约 + 端点核验表回填(含 ⚠ 项实测结论)→ 单文件精确提交 push origin/cfclub。
  2. 产出后由研发负责人登记 TR-12 转测试侧:补契约 JUnit(MockMvc 风格沿用既有 ContractTest)+ 正常/异常/权限三类流执行证据。
  3. 测试侧证据入库 + 干净提交后,按 sc-key-map.md 逐 SC 登记「已跑通」。