归属:契约补建计划 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/实测定位,不得假定包路径;若端点确实缺失 → 记入契约文档「实现缺口」段并回传研发侧,不在本任务内实现。
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.*已存在)。
docs/superpowers/api/API_REFERENCE.md 增补「孩子端(不能登录用户视角)」段落 + docs/superpowers/specs/2026-11-07-child-zone-contract.md 契约 + 端点核验表回填(含 ⚠ 项实测结论)→ 单文件精确提交 push origin/cfclub。sc-key-map.md 逐 SC 登记「已跑通」。