跳到主要内容

Data Horizon L3 系统架构工作流复盘（Phase J）

概述​

对标 FinBayes L3 架构（29 节 9 部分）适配 Data Horizon，从立架到 §1–§29 全文 + 收尾。分部主笔（CC 亲笔）+ 逐部双路独立评审（CC 子 Agent 代码核对 + Codex）+ 用户每部过目，9 部 + 全文总评审 + 收尾。承接 L1 白皮书 + L2（含第十五节 L3 承接补强）。

做对的​

  • 承接而非另起：L3 全程承接 L2 §15 与白皮书，DH 语义（感知/资产）改写 FinBayes 的认知/问答语义，零 FinBayes 残留。
  • 逐部双路评审抓出大量真问题：每部都有 blocking 被代码核对揪出（见下「教训」），证明分部评审的价值；CC 与 Codex 互补（CC 抓表名/锚点/汇总遗漏，Codex 抓明文凭证/配置硬编码）。
  • 工程层纪律守住：阈值/schema/字段/排期/熔断参数全程留工程包，未冻结。
  • 全文跨节一致性（总评审）：L2 引用全程带前缀、与本文自引用零混淆；同一事实（webhook 无业务确认/dn_event_news_std 停写/push 无重试/明文凭证）多节零漂移；缺口↔ADR↔风险↔任务四表自洽。

教训（沉淀为方法）​

1. 代码事实必须逐文件核对实际代码，绝不信任 CLAUDE.md / 二手文档​

最重要、贯穿全程的教训。 CLAUDE.md 自身已漂移，多次把 L3 引向错误现实：

  • dn_event_news_std 述为活跃推送表 → 实际停写、零写入；
  • agent_job.go / news_std_agent.go → 实际不存在（是 raw_news_job.go + analyst/social/forward agent）；
  • MonitorJob 价格异动监控 → 实际是来源静默告警；
  • push 有重试 → MaxRetryCount=3 无调用方、retry_count 恒 0（死代码）；
  • sys_api_perms 被当资产隔离 → 实为后台 RBAC；
  • 「配置驱动」→ 实际多处硬编码（1h/2h、retry<3、@every 60s）；
  • 明文凭证：etc/*.yaml 含明文 Bot token/API Key/JWT secret（已派生安全任务）。 方法：L3 涉现行代码处，CC 评审子 Agent 与 Codex 都被要求逐文件核对 server/internal/，不采信 CLAUDE.md；漂移登记入 §24/§27。

2. 窄 Codex（只附受审小节）规避 remote-compaction​

§11–13 时 Codex 读全文（6000+ 行等价上下文）+ 代码 → remote-compaction failed、结论丢失。自第五部分起改为把受审小节抽到 /tmp 只附该段给 Codex —— 连续多部成功无 compaction。Codex 大上下文任务必窄化范围。

3. 分部主笔 + 逐部评审 + 用户每部过目​

大文档（29 节）一次主笔不可控；分部（约 3 节/部）主笔 + 双路评审 + 用户过目，节奏稳、每部可纠偏。用户中途指出「这几轮没参与 Review」后，确立「每部先由用户过目再继续」——核心文档评审用户必须在环。

4. 去自创术语/黑话，glossary 非免罪牌​

owner 原则：术语须过四测试（无上下文能懂/句段准确/下推合理代码/他人可维护）。清除：opaque 标签 G6（gap 索引，脱离会话无人能懂）、时效内核/first-class/投影/通道中性等造词。核心词「感知/感知资产」重审保留为策略身份名 + 概念↔代码桥接；概念对象改透明名（Raw Signal→原始信息、Perception Record→标准化记录、Delivery Artifact→交付记录）横跨 L2/L3/gap-map。

5. 不丢已确认的下位文档内容​

owner 提醒：已审定 L2 内容是基线，不为「重构」丢弃。评审揪出 §6 一度把 L2 已确认的 P3 历史市场数据场景静默降零 → 补回 S7。

6. 汇总层易漏收​

§22–24（缺口/ADR/风险汇总）易漏前序节已登记项（WP-P0-03/P1-02/P2-01 一度缺席）；双路评审对汇总层专查「遗漏 + 编号引用」。

7. 安全发现派生独立任务​

明文凭证是真实生产风险但超文档范围 → 文档登记（§17/§24）+ 派生独立安全任务（迁密钥管理 + 轮换）。

对 playbook 的反馈​

教训 1（代码事实逐文件核对、勿信 stale 文档）、教训 2（窄 Codex 规避 compaction）、教训 3（分部主笔+用户每部过目）、教训 6（汇总层查遗漏）增量合入 commons/playbooks/architecture-document-rewrite.md。

收尾产物​

  • L3 正文 §1–§29（commit be4b806…§25-29），逐部 reviews/ + synthesis。
  • 全文总评审（本工作流）+ B1 标准化记录终态统一。
  • ADR 落盘：见 decisions/README.md（12 条 ADR 候选索引，M0 起草）。
  • 本复盘 + playbook 反馈。