Quellcode durchsuchen

docs(tdd): 研发负责人 本槽位第53轮标准汇报 | 状态机22键=12DONE+10YELLOW+0RED维持 | 10YELLOW实现sha第6轮连续IN CHAIN 10/10 | P0契约补建第4批五维能量12SC开工包(12/12端点已实现0缺失)+TR-10(B-34复验+五维转测试) | O-1~O-9全已裁决 | 变更感知0新键 | 目标池空防假RED零派发 | SC覆盖5/241 | hash-object多文件入库

Agnes Agent vor 6 Tagen
Ursprung
Commit
aefad1b446

Datei-Diff unterdrückt, da er zu groß ist
+ 5 - 0
docs/tdd/dev/test-requests.md


+ 46 - 0
docs/tdd/orchestration/dimension-energy-kickoff-20261107.md

@@ -0,0 +1,46 @@
+# 五维能量批次 · 开工包(12 SC)
+> 归属:契约补建计划 P0「五维能量」· 生成 2026-11-07 04:1x
+> 数据源:sc-key-map.md(origin/cfclub,O-8 归一后 241 全量登记)· 端点核对:cfc-backend controller 源码(origin/cfclub 工作树)
+> 前置:O-7 裁决(2026-11-06 23:59 主理人最终确认)契约补建工作流正式生效——契约核对 = 文档核对 + 端点比对(防假 RED),产出契约文档后转测试侧补契约 JUnit + 三类流证据,渐进而非全量。
+
+## 批次定位
+五维能量:家长×7、跨角色×3、成长规划师×2,覆盖查看/流水/配置/发放/上限/重算/触发/自评/隔离/对账/并发 11 类能力;本批 12 个 SC 台账「对应能力键」列全为 `—`(五维能量域此前以 `dimension.* / energy.*` 为建议前缀,未契约化)。**按 O-7 裁决:契约核对 = 文档核对 + 端点比对(防假 RED),本批端点已核验 12/12 存在(见下表),无真实现缺口 → 非研发实现型 RED,产出契约文档后转测试侧(TR-10)补契约 JUnit + 三类流执行证据。**
+
+## 端点核验(12/12 已实现,0 缺失)
+
+| SC | 角色 | 场景标题 | 对应端点(origin/cfclub 工作树) | 核验 |
+|----|------|----------|-------------------------------|------|
+| SC-P-17 | 家长 | 查看五维能量 / 健康指数 | `EnergyController` `/api/energy/overview`;`HealthDimensionController` `/api/dimension/**`;`FamilyHealthController` `/api/family/health/ranking` | ✅ |
+| SC-P-18 | 家长 | 能量流水查看 | `EnergyController` `/api/energy/logs`、`/score-history`、`/family-score-history`、`/wealth-detail` | ✅ |
+| SC-P-19 | 家长 | 能量维度配置查看 | `DimensionAdminController` `/api/admin/dimension/**`;`DimensionConfigController` `/api/admin/dimension-config/**`;`DimensionWeightController` `/api/admin/dimension-weight/**`;`DimensionRegistryController` `/api/dimension-registry/**` | ✅ |
+| SC-P-89 | 家长 | 手动发放能量 grant | `EnergyController` `/api/energy/grant` | ✅ |
+| SC-P-90 | 家长 | 五维每日获取上限 DailyLimit | `AdminEnergyConfigController` `/api/admin/energy-config/daily-limits`、`/daily-limit-save` | ✅ |
+| SC-P-92 | 家长 | 五维权重/来源比例配置变更后重算 | `AdminEnergyConfigController` `/source-list`、`/source-save`、`/source-delete`;`AdminEnergyRuleController` `/api/admin/energy-rule/**` | ✅ |
+| SC-P-93 | 家长 | 文章互动与活动参与触发五维能量 | `AdminEnergyBehaviorConfigController` `/api/admin/energy-behavior/list|detail|update|toggle`;`EnergyController` `/sandbox`(行为计分链) | ✅ |
+| SC-T-31 | 成长规划师 | 手动维度打分覆盖/调整 | `ManualDimensionScoreController` `/api/family/manual-score/**` | ✅ |
+| SC-T-32 | 成长规划师 | 五维自评录入与变化 | `FiveDimensionSelfCheckController` `/api/family/self-check/questions|submit|latest|history|status|ignore|trend-analysis` | ✅ |
+| SC-X-19 | 跨角色 | 五维能量跨角色数据隔离 | `EnergyController` 各端点(`resolveMemberIdByUser` 双角色兜底);JwtInterceptor 登录/角色拦截 | ✅(权限流验证载体齐) |
+| SC-X-20 | 跨角色 | 五维能量流水溯源一致性(对账) | `EnergyController` `/logs`、`/score-history`、`/family-score-history`(按 memberId/date/type 溯源) | ✅ |
+| SC-X-21 | 跨角色 | 多来源并发同成员能量变动 | `EnergyController` `/grant`、`/deduct-for-wish`、`/sandbox`(行为事件驱动)+ EnergyRule 规则链 | ✅(并发场景执行证据测试侧补) |
+
+## 建议能力键(契约定稿后按 O-2 方案 A 映射)
+
+- `energy.viewOverview`(SC-P-17)
+- `energy.listLogs`(SC-P-18 / SC-X-20)
+- `energy.viewConfig`(SC-P-19)
+- `energy.grant`(SC-P-89)
+- `energy.setDailyLimit`(SC-P-90)
+- `energy.recalculate`(SC-P-92)
+- `energy.behaviorTrigger`(SC-P-93)
+- `energy.manualScore`(SC-T-31)
+- `energy.selfCheck`(SC-T-32)
+- `energy.isolation`(SC-X-19)
+- `energy.concurrentUpdate`(SC-X-21)
+
+> 注:以上为**建议映射**(防假 RED 端点核验用),非最终契约键;契约文档定稿时须逐条对齐 `docs/superpowers/api/API_REFERENCE.md` 与 `tests/test-cases/*.md` 派生用例,避免键名与既有契约冲突(`dimension.registry.getTree/mapLegacyCode` 已契约化,勿重复建键)。
+
+## 待办(O-7 授权节奏)
+
+1. 契约核对会话产出契约文档(API_REFERENCE 4.x 增补「五维能量」接口范围 + 契约缺口映射)→ 合入 origin/cfclub
+2. 测试侧 TR-10 登记:补契约 JUnit + 三类流执行证据
+3. 下一批 P1「内容-运营 6 SC」(article.* / content.*)照此节奏滚动

+ 150 - 0
docs/tdd/orchestration/report-dev-2026-11-07-0413.md

@@ -0,0 +1,150 @@
+# 研发负责人工作汇报(本槽位 05193ba0 · 第 53 轮 · 闭环巡检自动化)
+
+## 基本信息
+
+| 项目 | 内容 |
+|------|------|
+| 汇报人 | 研发负责人(本槽位 05193ba0 闭环巡检自动化;与远端错峰03 会话并行推进,其第 46 轮 04:10 已推 919434190) |
+| 汇报周期 | 2026-11-07 02:50 ~ 2026-11-07 04:13(本槽位第 53 轮,接 02:50 第 51 轮) |
+| 负责模块/单元范围 | 全量(DEV_GOAL 顶层目标 241 SC,O-8 归一已落地;契约补建按 O-7 授权渐进滚动) |
+
+> 本轮核心增量:**① 状态机 22 键 = DONE 12 / YELLOW 10 / RED 0 维持,10 个 YELLOW 实现 sha 第 6 轮连续复核全 IN origin/cfclub ✓**;**② SC 覆盖 5/241(O-3 收口)维持,236 未跑通全为「待三类流证据」(无真实现缺口)**;**③ P0 契约补建滚动第 4 批「五维能量 12 SC」开工包产出入库(12/12 端点核验已实现 0 缺失)+ TR-10 登记(B-34 修复复验 + 五维批转测试侧)**;**④ O-1~O-9 全部已裁决(无待裁决遗留)**。
+
+---
+
+## 一、本轮工作数据汇总
+
+### 1.1 问题接收与处置
+
+| 指标 | 数量 | 说明 |
+|------|------|------|
+| **收到的测试反馈问题数** | 0 个(新) | 本轮无新增;存量 B-34/B-35 修复已落地(1b15b67d2/9628df3d9 均已推 origin/cfclub 并回补 YELLOW),等待测试侧复验(TR-9/TR-10) |
+| **已解决问题数** | 0 个 | 本轮无新闭环(B-34/B-35 上一轮已 RED→YELLOW,mark-green 收口仍待测试侧) |
+| **待解决研发问题数** | 1 个 | **B-31**(application.yml 7 处明文凭据,P2,研发侧待主理人排期);B-33(.gitignore:70 `*.py` 全局忽略,研发/流程类待处理) |
+
+### 1.2 任务分发与会话管理
+
+| 指标 | 数量 | 说明 |
+|------|------|------|
+| **分派任务数** | 0 个 | 目标池 ⏳ 0 + `--changes` 0 新增能力键 + 无真实现缺口(SC 236 未跑通全为待证据)→ 防假 RED 纪律不派发伪实现任务;P0 契约补建批次为非研发实现型 RED(O-7),本轮产出「五维能量 12 SC」开工包转测试侧(TR-10) |
+| **恢复智能体会话数** | 0 个 | 无 wedged/swallowed/stalled/upstream_err/thrash 存量 |
+| **当前在用会话数** | 0 running | 5 可达智能体(lan-189/lan-204/local-lan-4090/mes-local-45278/pub-iwintrue)全 idle,任务账本 34 条 = 33 done + 1 failed(S-cfc-20 历史),池空无在途 |
+| **会话平均利用率** | 低(凌晨黑窗窗口) | 0 派发稳态轮,如实记录 |
+
+### 1.2b 各会话当前工作状态列表
+
+| 会话标签 | 会话 ID | 当前状态 | 当前任务 | 静默/空闲时长 | 工作目录 | 备注 |
+|----------|---------|----------|----------|---------------|----------|------|
+| lan-189 | — | `idle` | — | 本盘点时刻空闲 | 远端 | 配额剩余 3 |
+| lan-204 | — | `idle` | — | 本盘点时刻空闲 | 远端 | 配额剩余 3 |
+| local-lan-4090 | — | `idle` | — | 本盘点时刻空闲 | 远端 | 配额剩余 3 |
+| mes-local-45278 | — | `idle` | — | 本盘点时刻空闲 | 主工作树(117 处他人 WIP) | 纪律④只读列示 |
+| pub-iwintrue | — | `idle` | — | 本盘点时刻空闲 | 远端 | 配额剩余 3 |
+
+> 配额:5 可达智能体 busy=0、剩余配额各 3(上限 3);全局并发 limit=4 未触及。无 wedged/thrash/swallowed/stalled/upstream_err。hub.py status 实测 prod-etotem 不可达(HTTP 401,认证被拒),其余 5 实例可调度。
+
+### 1.3 变更感知与新任务建立
+
+| 指标 | 数量 | 说明 |
+|------|------|------|
+| **感知需求/设计变更数** | 0 次(新增能力键) | `--changes --days 7` 全部为既有键状态/内容变化,**新增能力键 0 / 0**(需求/设计/用例三源均无真新增) |
+| **新增入池任务数** | 0 个(状态机) | 无新键可锚定;P0 契约补建第 4 批「五维能量 12 SC」开工包按 O-7 节奏产出(非研发实现型 RED,转测试侧 TR-10) |
+| **既有键状态流转数** | 0 次 | 本轮无阶段流转(10 YELLOW 维持;B-34/B-35 上一轮已 RED→YELLOW 回补) |
+
+### 1.4 本轮 git 提交与推送证据(真理证据)
+
+| 提交 sha | 关联任务/能力键 | 阶段 | 触及文件类型 | 目标分支 | 已推送远端 | 备注 |
+|----------|-----------------|------|--------------|----------|------------|------|
+| (本轮核验)`6c7e09fe8` | admin.auth.login | YELLOW | 实现 | origin/cfclub | 是 ✓ | IN CHAIN(第 6 轮连续复核) |
+| (本轮核验)`78b72c14f` | health.report.upload | YELLOW | 实现 | origin/cfclub | 是 ✓ | IN CHAIN |
+| (本轮核验)`1767d4414` | health.report.createReport | YELLOW | 实现 | origin/cfclub | 是 ✓ | IN CHAIN |
+| (本轮核验)`c3e32460a` | dan.assessment.getActiveMaterial | YELLOW | 实现 | origin/cfclub | 是 ✓ | IN CHAIN |
+| (本轮核验)`ed8f1c347` | task.history.view | YELLOW | 实现 | origin/cfclub | 是 ✓ | IN CHAIN |
+| (本轮核验)`da2727f53` | growth.history.view | YELLOW | 实现 | origin/cfclub | 是 ✓ | IN CHAIN |
+| (本轮核验)`e205656ee` | achievement.grid.fiveCol | YELLOW | 实现 | origin/cfclub | 是 ✓ | IN CHAIN |
+| (本轮核验)`04d87cfd1` | sleep.config.tags | YELLOW | 实现 | origin/cfclub | 是 ✓ | IN CHAIN(10-26 措辞重构登记;真实实现 93aad0152/f8b145d3a/4734bcf45 在链,TR-6 已注明可放行) |
+| (本轮核验)`1b15b67d2` | langgraph.questionnaire.generate(S-cfc-33/B-34) | YELLOW | 实现(cfc-langgraph/src) | origin/cfclub | 是 ✓ | IN CHAIN;O-9 归口修复已落地,回补登记完成 |
+| (本轮核验)`9628df3d9` | dan.report.parseFormat(S-cfc-34/B-35) | YELLOW | 实现 | origin/cfclub | 是 ✓ | IN CHAIN;待测试侧复验(TR-9) |
+| (本轮产出)`(见提交)` | — | 文档 | docs/tdd | origin/cfclub | 入库即推 | 五维开工包 + TR-10 + 本轮汇报,hash-object 入库 |
+
+### 1.5 状态机阶段分布与部署状态
+
+| 阶段 | 键数 | 备注 |
+|------|------|------|
+| UNTRACKED | 0 | 已发现未入池 0 |
+| RED | 0 | 待开发实现 0(B-34/B-35 已推进 YELLOW) |
+| YELLOW | 10 | 待测试校验(8 键 TR-6 + langgraph.questionnaire.generate TR-10 + dan.report.parseFormat TR-9) |
+| GREEN | 0 | 待部署验证 0 |
+| DONE | 12 | 闭环归档 |
+
+| 部署项 | 值 | 说明 |
+|--------|-----|------|
+| 本轮部署次数 | 0 次 | 无新 YELLOW 闭合,无部署动作 |
+| 最近部署确认 | `292087771`(@11-06 19:22:17 done=true,testing) | deploy_state pending=0 / confirmed=20;292087771 IN origin/cfclub 链 ✓ |
+| GREEN 部署链验证 | 通过 | 无新 GREEN,链式验证维持通过 |
+
+### 1.6 数据源健康度
+
+| 数据源 | 读取键数 | 是否正常 | 备注 |
+|--------|----------|----------|------|
+| 需求侧(⏳ wish) | 0 | 正常 | 需求侧 ⏳ 键 0(文档口径稳定) |
+| 契约常量(contract) | 0 | 正常 | 契约常量 0(标注用,不入池门槛) |
+| 测试用例引用(test_case_map) | 0 | 正常 | 用例引用∩⏳ 0 |
+| 执行结果回填(case_results) | 0 | 正常 | 回填 0 键 |
+
+---
+
+## 二、下一步需要研发处理的事项
+
+| 序号 | 事项描述 | 依赖/前置条件 | 预估完成时间 | 优先级 | 状态 |
+|------|----------|---------------|--------------|--------|------|
+| 1 | B-31 application.yml 明文凭据整改(7 处 → ${ENV} + .env gitignore) | 主理人排期 + 凭据轮换 | 待定 | P2 | 待启动 |
+| 2 | B-33 .gitignore:70 `*.py` 例外放行(`!docs/tdd/tools/*.py` 等) | 研发侧改 .gitignore(属研发所有) | 待定 | P1 | 待启动 |
+| 3 | B-34/B-35 修复复验:langgraph.questionnaire.generate(TR-10)+ dan.report.parseFormat(TR-9)确认 mark-green | 测试侧复验 | 测试下一轮 | P0 | 进行中 |
+| 4 | P0 契约补建第 5 批「报告闭环 23 SC」/ P1「内容-运营 6 SC」开工包 | 前批转测试后滚动 | 后续巡检轮 | P1 | 待启动 |
+
+## 三、阻塞与风险
+
+| 阻塞项 | 影响范围 | 阻塞类型 | 处置进展 | 需要协调 |
+|--------|----------|----------|----------|----------|
+| B-31 明文凭据 | 安全(全仓读权限可取凭据) | 研发 | 待处理(P2) | 主理人排期 |
+| B-33 `.gitignore:70 *.py` | 度量/工具脚本无法入库(B-15/B-32 同源) | 研发/流程 | 待处理 | 研发侧改 .gitignore |
+| 8 YELLOW 键 mark-green 收口(TR-6) | 8 键 YELLOW→GREEN 通道 | 测试 | 待测试处理(实现 sha 全 IN CHAIN 已核) | 测试侧 mark-green |
+| prod-etotem 不可达(HTTP 401) | 生产部署通道 | 环境 | 待排查 | 本槽位不触碰 prod 部署 |
+| 主工作树 117 处他人 WIP | 工作目录不干净(--clean-check=1) | 研发 | 按 O-3 判据③(SC 关联提交级核验)不阻塞 SC 跑通 | 各产生 WIP 的会话收口 |
+
+## 四、下轮工作规划
+
+| 计划项 | 预计完成时间 | 前置依赖 | 涉及会话标签 | 备注 |
+|--------|--------------|----------|--------------|------|
+| 核验测试侧 66 轮及 B-34/B-35 复验结果 | 下一巡检轮 | 测试侧推进 | 测试侧 | 复验通过则登记 mark-green 建议 |
+| 契约补建滚动第 5 批(报告闭环 23 SC) | 下一巡检轮 | 五维批转测试完成 | 契约核对会话 | O-7 授权节奏 |
+| 检查 opencode 黑窗(429)解除情况 | 08:00 后 | 时间 | 各会话 | 黑窗解除后可恢复派发 |
+
+## 附录
+
+### 附录 A:收到的测试反馈问题明细(存量)
+
+| 问题 ID | 能力键/任务号 | 问题类型 | 来源 | 接收时间 | 处置状态 | 关联 sha |
+|---------|---------------|----------|------|----------|----------|----------|
+| B-34 | langgraph.questionnaire.generate(S-cfc-33) | 实现缺陷(P0) | 测试台账 65 轮 | 11-07 02:15 | 已解决(YELLOW,1b15b67d2 已推) | 1b15b67d2 |
+| B-35 | dan.report.parseFormat(S-cfc-34) | 实现缺陷 | 测试台账 65 轮 | 11-07 02:15 | 已解决(YELLOW,9628df3d9 已推,待复验) | 9628df3d9 |
+| B-31 | — | 安全 | 测试台账 62 轮 | 11-06 23:10 | 待处理(P2) | — |
+
+### 附录 B:任务分派与会话恢复明细
+
+| 任务号 | 目标会话标签 | 任务类型 | 分派时间 | 当前状态 | 恢复会话标签 | 恢复原因 | 恢复时间 |
+|--------|--------------|----------|----------|----------|--------------|----------|----------|
+| (本轮无派发) | — | — | — | — | 无 | 无 | — |
+
+### 附录 C:新增入池任务明细
+
+| 任务号 | 能力键 | 需求溯源 | 设计溯源 | 创建时间 | 状态 |
+|--------|--------|----------|----------|----------|------|
+| (本轮 0) | 五维能量 12 SC 开工包(非状态机入池,O-7 非研发实现型 RED) | SC 台账 241(sc-key-map.md) | O-7 契约补建工作流 / dimension-energy-kickoff-20261107.md | 2026-11-07 04:1x | 转测试侧 TR-10 |
+
+### 附录 D:变更感知明细(来自 `--changes`)
+
+| 变更文档 | 文档类型 | 变更日期 | 新增能力键 | 是否已入池 |
+|----------|----------|----------|------------|------------|
+| (无新增能力键) | — | — | 0 | — |

Einige Dateien werden nicht angezeigt, da zu viele Dateien in diesem Diff geändert wurden.