Kaynağa Gözat

docs(tdd): EVD-14 AI/Butler 域 17 SC 契约核对(重派发·错峰03)——独立工作树 feature/evd14-ai-butler-contract 重核实 origin/cfclub @ 6a3e6a2d2,修正首版直入 cfclub 的纪律偏差;端点实测全 17 SC 结论一致(9 ✅/8 ⚠/0 缺失),无假 RED;spec 元数据更新验证基线 + 分支工作流说明,API_REFERENCE §4.64 附注同步

iwt 1 hafta önce
ebeveyn
işleme
7137f28e0c

+ 1 - 1
docs/superpowers/api/API_REFERENCE.md

@@ -3484,7 +3484,7 @@ W0.2 双配置中心合并:`product_config` 已并入 `service_config`(唯
 | SC-H-04 | 升级与应急 | unassign/toggle-accepting 为停接/解绑开关,语义间接 | 需产品确认应急处理验收口径 |
 | SC-H-05 | 资源/活动对接 | 活动载体在 `/api/guide/activities/*`(非本域新增) | 需产品确认验收语义 |
 
-*文档更新:2026-11-07(EVD-14 AI成长教练 10 SC + 真人管家 7 SC 契约核对增补「AI成长教练 + 真人管家域」段落 4.64:成长咨询对话 / AI 会员门禁与隐私 / 健康教练跟进 / 报告智能解读 / 营养任务推荐 / 真人管家后勤与家庭自助选择 / 已废弃 410 / 真人管家运营管理 / AI 管家会话 / AI→真人管家协同与资源对接 + 契约缺口。完整核验表见 `docs/superpowers/specs/2026-11-07-ai-butler-contract.md`)*
+*文档更新:2026-11-07(EVD-14 AI成长教练 10 SC + 真人管家 7 SC 契约核对增补「AI成长教练 + 真人管家域」段落 4.64:成长咨询对话 / AI 会员门禁与隐私 / 健康教练跟进 / 报告智能解读 / 营养任务推荐 / 真人管家后勤与家庭自助选择 / 已废弃 410 / 真人管家运营管理 / AI 管家会话 / AI→真人管家协同与资源对接 + 契约缺口。完整核验表见 `docs/superpowers/specs/2026-11-07-ai-butler-contract.md`;2026-11-07 重派发会话基于 origin/cfclub @ 6a3e6a2d2 重新实测核对,结论一致,契约基线由 b36e26240 更新为 6a3e6a2d2)*
 ### 4.65 跨角色域剩余(SC-X-03/08/11/14/15/16/17/18,EVD-15 契约核对增补)
 > 跨角色域 22 个 SC(SC-X-01~22)中已由既有开工包覆盖 13 个(测评-方案 EVD-8R:X-01/06/09;报告闭环 EVD-7R:X-02/10/13;任务-心愿 EVD-3:X-05;五维能量 EVD-5:X-19/20/21;商城-会员 EVD-4:X-07/12;家庭-成员 EVD-2:X-04;CF 值预估 TR-5:X-22);本批 = 剩余 8 个无键 SC,端点载体逐条实测核验。完整核验表与实现缺口见 `docs/superpowers/specs/2026-11-07-cross-role-contract.md`。
 > 约定:所有端点 `POST`;越权语义统一 403(`FamilyAccessInterceptor` enforcement 模式 + `canAccessFamily`)。

+ 4 - 3
docs/superpowers/specs/2026-11-07-ai-butler-contract.md

@@ -1,9 +1,10 @@
 # AI成长教练 + 真人管家批次 · 契约核对结论(17 SC · 防假 RED)
 
 > 归属:契约补建计划 P0「AI成长教练(AI管家)+ 真人管家域」· 核对时间 2026-11-07(EVD-14)
-> 开工包:`docs/tdd/orchestration/ai-butler-kickoff-20261107.md`(origin/cfclub @ b36e26240)
-> 核对对象:origin/cfclub `cfc-backend` controller 源码(工作树 HEAD = origin/cfclub;直接在主分支工作,未新建分支)
+> 开工包:`docs/tdd/orchestration/ai-butler-kickoff-20261107.md`(origin/cfclub @ 069628810)
+> 核对对象:`origin/cfclub`(HEAD `6a3e6a2d2`)`cfc-backend` controller 源码;工作树 = 独立 worktree `feature/evd14-ai-butler-contract`(`/tmp/opencode/evd14-ai-butler-contract`,基于 `origin/cfclub` 新建,不与主工作树 WIP 冲突)
 > 核对方法:类级 `@RequestMapping` + 方法级 `@PostMapping` 逐一比对(`grep -rn '@RequestMapping|@PostMapping' cfc-backend/src/main/java/com/etotem/cfc/controller/` 实测定位,不假定包路径),逐端点记录存在性;对字面路径缺失或语义偏移者定位等价实现 / 替代载体(防假 RED:契约声明的接口范围必须能在真实源码中找到实现)
+> 再核对说明:本文件首版由 EVD-14 契约核对会话产出并**误提交 origin/cfclub**(commit `f62848933`,违反 O-7 分支纪律「先建 feature 分支再 push」);研发负责人闭环巡检登记回收(TR-16)并重新派发。本次为**重派发会话**:在独立 worktree + `feature/evd14-ai-butler-contract` 分支上,基于最新 `origin/cfclub`(`6a3e6a2d2`)对全部 17 SC 端点载体与语义**逐一重新实测核对**,结论与首版一致(无假 RED、无完整缺失 SC),仅纠正核对基线(`b36e26240`→`6a3e6a2d2`)与工作流说明。
 
 ## 0. 结论摘要
 
@@ -115,4 +116,4 @@
 3. **需产品确认验收语义**:SC-H-04(升级/应急 vs unassign/toggle-accepting 语义偏移)、SC-H-05(资源/活动对接验收口径)。
 4. 本批**未建伪实现任务**:确无端点载体的语义项(B-05 敏感词门控、B-12 定时推送)按 O-7 契约补建裁决登记语义缺口,不新建实现。
 
-*核对依据:origin/cfclub @ b36e26240(开工包 ai-butler-kickoff-20261107.md)+ 各 Controller 源码 @ 同 sha;核对人:TDD 契约核对会话 EVD-14(OpenCode)。本批仅新增契约文档(spec + API_REFERENCE 增补)、直接提交 origin/cfclub,未修改业务代码、测试文件、DB 迁移。*
+*核对依据:origin/cfclub @ 6a3e6a2d2(开工包 ai-butler-kickoff-20261107.md @ 069628810)+ 各 Controller 源码 @ 同 sha;核对人:TDD 契约核对会话 EVD-14(OpenCode,重派发)。本次在独立 worktree `feature/evd14-ai-butler-contract` 分支上重新实测核对后提交并 push(commit 见本会话汇报),未修改业务代码、测试文件、DB 迁移;本批仅新增/修订契约文档(spec + API_REFERENCE 增补 §4.64)。*