归属:契约补建计划 P0「任务-激励」· 生成 2026-11-07 01:05 数据源:sc-key-map.md(origin/cfclub,236 全量登记)· 端点核对:cfc-backend controller 源码(origin/cfclub 工作树)
任务 → 心愿 → 勋章 → 积分/五维归因 → 家庭排行 → 活动打卡,覆盖家长/孩子/规划师/运营/AI教练/跨角色六视角;本批 22 个 SC 均无合法能力键(台账「对应能力键」列全为 —),需先定契约才能 --add-task 入池。
覆盖五段:孩子执行(任务/小游戏/心愿/勋章/打卡/积分兑换)→ 家长管理(频率/心愿审批/积分对账/排行/五维归因)→ 规划师审核与批量下发 → 运营勋章/挑战配置 → 跨角色任务激励闭环。
| SC | 角色 | 场景标题 | 建议能力键 | 契约接口范围 | 依赖 Controller |
|---|---|---|---|---|---|
| SC-A-05 | 平台运营 | 勋章配置 CRUD | admin.badge.manage | /api/badges/create、/api/badges/update、/api/badges/delete、/api/admin/challenge-score-config/list、/api/admin/challenge-score-config/update | BadgeController、AdminChallengeScoreConfigController |
| SC-B-07 | AI成长教练 | 个性化任务/饮食推荐与采纳 | coach.recommend.adopt | /api/food/recommendation、/api/meal、/api/tasks | FoodRecommendController、MealRecommendController、TaskController |
| SC-C-02 | 孩子 | 执行任务 / 小游戏得积分 | task.child.execute | /api/tasks/{id}/complete、/api/tasks/{id}/start、/api/game/record | TaskController、GameRecordController |
| SC-C-04 | 孩子 | 提心愿 | wish.child.create | /api/wishes/create | WishController |
| SC-C-05 | 孩子 | 任务打卡 ⭐ | task.child.checkin | /api/tasks/{id}/complete、/api/daily/checkin/create | TaskController、DailyCheckinController |
| SC-C-09 | 孩子 | 勋章墙 | badge.child.wall | /api/badges/member/list、/api/badges/all | BadgeController |
| SC-C-10 | 孩子 | 勋章解锁提醒 | badge.child.unlockNotice | /api/badges/member/list、/api/badges/detail | BadgeController |
| SC-C-14 | 孩子 | 任务驳回重做 | task.child.rework | /api/tasks/reject/{id}、/api/tasks/{id}/start | TaskController |
| SC-C-22 | 孩子 | 商城浏览/积分兑换(孩子端消费) | mall.child.exchange | /api/points/exchange/product/list、/api/points/exchange/product/detail、/api/points/exchange/create、/api/points/exchange/records | PointsExchangeController、MarketController |
| SC-C-24 | 孩子 | 小游戏/任务得分触发五维增长(仅自身可见) | energy.child.trigger | /api/game/record、/api/energy/* | GameRecordController、EnergyController |
| SC-P-12 | 家长 | 任务频率/周期配置 | task.parent.frequency | /api/task/reminder-config/get、/api/task/reminder-config/save、/api/packages | TaskReminderConfigController、TaskTemplatePackageController |
| SC-P-13 | 家长 | 心愿创建-审批-兑换闭环 | wish.parent.closedLoop | /api/wishes/create、/{id}/set-price、/{id}/approve-exchange、/{id}/exchange | WishController |
| SC-P-14 | 家长 | 心愿驳回/失效处理 | wish.parent.reject | /api/wishes/{id}/reject、/api/wishes/{id}/cancel | WishController |
| SC-P-15 | 家长 | 积分明细查看 | points.parent.detail | /api/points/exchange/records | PointsExchangeController |
| SC-P-16 | 家长 | 积分流水对账 | points.parent.reconcile | /api/points/exchange/records、/api/tasks/statistics | PointsExchangeController、TaskController |
| SC-P-77 | 家长 | 活动打卡/助力(营销) | activity.parent.checkin | /api/activity、/api/daily/checkin | ActivityController、DailyCheckinController |
| SC-P-86 | 家长 | 成长打卡榜/家庭排行 | task.parent.ranking | /api/tasks/statistics/family、/api/daily-task/overview、/api/badges/ranking/family | TaskController、DailyTaskController、BadgeController |
| SC-P-87 | 家长 | 任务完成触发五维能量按规则归因增长 | task.parent.triggerFiveDim | /api/tasks/{id}/complete、/api/attribution/analyze | TaskController、AttributionController |
| SC-P-88 | 家长 | 心愿兑换扣减五维能量(余额不为负) | wish.parent.exchangeDeduct | /api/wishes/{id}/exchange、/api/energy/deduct-for-wish | WishController、EnergyController |
| SC-T-06 | 成长规划师 | 家庭任务审核 | task.guide.review | /api/tasks/pending-review、/api/tasks/{id}/review | TaskController |
| SC-T-18 | 成长规划师 | 批量任务下发 | task.guide.batchDispatch | /api/tasks/batch-complete、/api/tasks/batch-delete、/api/growth-task/batch-complete | TaskController、GrowthTaskController |
| SC-X-05 | 跨角色 | 任务激励闭环 | task.closedLoop.incentive | 任务→心愿→勋章→积分→五维 全链路 | 全链路 |
孩子执行(10)
task.child.executetask.child.checkintask.child.reworkwish.child.createbadge.child.wallbadge.child.unlockNoticemall.child.exchangeenergy.child.trigger家长管理(8)
task.parent.frequencytask.parent.rankingtask.parent.triggerFiveDimwish.parent.closedLoopwish.parent.rejectwish.parent.exchangeDeductpoints.parent.detailpoints.parent.reconcile运营 / 规划师 / 跨角色(4)
admin.badge.manageactivity.parent.checkintask.guide.reviewtask.guide.batchDispatchtask.closedLoop.incentiveTaskController(/api/tasks create|today|complete|start|review|history|pending-review|reject|batch-complete|batch-delete|statistics)+ DailyTaskController(overview)+ GrowthTaskController。重点写清「任务状态机」(待开始→进行中→已完成/已驳回→重做)与五维归因触发点。WishController(create|set-price|price|reject|exchange|approve-exchange|fulfill|confirm|cancel|list|pending)+ BadgeController(all|list|detail|create|update|delete|member/list|ranking/family)+ PointsExchangeController(product/list|product/detail|records)。重点写清「心愿审批-兑换」状态机与余额不为负约束。AdminChallengeScoreConfigController、GameRecordController(record|history|leaderboard)、EnergyController(grant|deduct-for-wish|logs)、AttributionController(analyze)。重点写清「五维扣减/归因」规则来源与跨角色可见性。origin/cfclub → 逐组记录 sha(一组一 sha,便于分级 --design)。--add-task <key> --requirement "SC-xxx:<场景标题>(tests/user-scenarios/应用场景总览.md)" --design <契约 sha>。
--design 必须标注「契约已在 origin/cfclub;实现若在 feature 分支须显式说明、不得假定包路径」。points/exchange 线、五维增长走 energy/attribution 线,能力键需在各自 Controller 补齐后聚合,建议拆分独立任务、不并入 mall.child 单键。batch-complete/batch-delete 语义,须先明确「批量」是否含子任务递归下发,否则能力键名与实现会错位。/api/food/recommendation + /api/meal 已存在,但「采纳」动作语义(是否写回任务)尚未有契约定义,定契约前须确认推荐→任务转化规则。/api/activity + /api/daily/checkin 已存在,但「助力」营销动作(分享/组队加成)属运营配置,需与 AdminActivityController 对齐,避免重复建键。