Data Horizon L3 系统架构设计 — 工作流状态
续接协议
读本文 → 看「打法与约束」「29 节结构映射」「阶段计划」→ 按阶段执行。上游真源：L2 system-product-definition.md（尤其第十五节承接补强：15.1 场景 / 15.2 对象关系 / 15.3 状态轮廓 / 15.4 接触契约 / 15.5 不变量+ADR候选 / 15.6 质量取舍）+ 白皮书。L3 质量标尺：projects/finbayes/engineering/architecture.md。
前情
- L2 已就绪（双轮评审：下推对齐 + L3 就绪度 + §15 补强 + §15 聚焦再评审，commit 至
af2927d）。 - 用户拍板：L3 对标 FinBayes 29 节全结构起。
- 外部依赖 G6：AI Trading Matrix 实际消费对象形态（event/signal/feed/alert/evidence），在 L3 §7 / ADR-03 与 Trading Matrix 团队对齐；对齐前 ADR-03 仅 proposed。
打法与约束（继承 L1/L2）
| 约束 | 内容 |
|---|---|
| 主笔分工 | L3 由 CC 主控亲笔撰写；Codex 与子 Agent 仅独立评审 |
| 承接不另起 | L3 承接 L2 §15 与白皮书，不重新定义战略/产品口径；DH 语义（感知/资产）改写 FinBayes 的认知/问答语义 |
| 工程层但有纪律 | L3 写对象/状态机/容器/子系统/协议/ADR；阈值与代码留工程包 |
| 建设性非防御 | 讲是什么/怎么搭；编号「第…节」 |
| 文件命名 | ASCII；中文标题在 frontmatter/H1 |
| 提交 | 并发会话直提 main：不切分支 + 选择性 git add 本工作流文件 + 无署名；pre-commit verify:kb + derive:check（过程稿勿带相对链接、补 frontmatter scope/maturity） |
| Stage Gate | 每部分停下汇报；大文档分部主笔 + 分部评审 |
29 节结构映射（FinBayes → DH 适配）
落位 projects/data-horizon/engineering/architecture.md。九部分：立架 / 业务架构 / 系统全景 / 系统运行 / 部署与基础设施 / 横向关注点 / 质量与验收 / 已知缺口与决策 / 落地映射。各节承接来源见架构文档骨架内联标注。DH 关键改写：FinBayes「认知流转/问答/Provider L1–L4 降级/澄清回路/会话压缩」→ DH「感知流转(采集→标准化→资产→输出)/来源健康降级/复核回路/去重聚合/高频管线(Scraper/Agent/Push Job)」。
阶段计划（Stage Gate）
| 阶段 | 内容 | Gate |
|---|---|---|
| 0 立架 | L3 workstream + 29 节骨架（每节职责 + 承接来源） | ✅ 结构 Gate 通过（用户「结构OK」，commit fd7e6b5） |
| 1 第一部分·立架 | §1–§3（角色读者 / 上位继承不变量 / 架构目标质量取舍） | ✅ 主笔（be4b806）+ 评审 |
| 2 第二部分·业务架构 | §4–§6（业务对象关系 / 感知价值流转 / 关键场景） | ✅ 主笔（c739c68）+ 双路评审修订 FB1–FB5（82a7aee）：补 P3 场景 S7 / 运营工作台 S8 / dn_event_news_std 去越权冻结 / 对象流转一致 / 四状态不变量 |
| 3 第三部分·系统全景 | §7–§10（外部关系 / 进程服务划分 / 子系统组件 / 场景流转图） | ✅ 主笔 + 双路评审修订 F-A/F-B/F-C：按实际代码改写 Job 链路 / 补资产库逻辑容器 / §10 补 Perception Record + 去重 |
| 4 第四部分·系统运行 | §11–§13（状态生命周期 / 并发异步 / 故障降级） | ✅ 主笔 + CC 代码核对修订（B1/B2/N1–N5）+ 用户过目认可；本轮并执行去自创术语/黑话（G6 等清零，横跨 §1–13）；Codex remote-compaction 失败仅部分 |
| — 术语治理 | 核心词「感知/感知资产」上游重审（owner 拍板要重审） | 独立任务（见 reviews/ 或新 workstream） |
| 5 第五部分·部署与基础设施 | §14–§16（部署 / 存储划分 / 通信协议） | ✅ 主笔 + 双路评审修订（F1–F5：sys_api_perms 表名 / §4↔§15 标准化存储统一 / push_log 消费确认缺口 / retry 措辞 / webhook 业务确认）+ 用户认可。窄 Codex 成功规避 compaction |
| — 术语治理（已执行） | 概念对象改透明名 + 概念↔代码桥接（commit c494c81/e7516cb） | ✅ owner 拍板 D1/D2/D3 后执行 |
| 6 第六部分·横向关注点 | §17–§19（边界安全 / 可观测性 / 演化版本） | ✅ 主笔 + 双路评审修订（F1–F6：MonitorJob 来源告警 / L2 验收 §11→§12 / 明文凭证风险 / 配置硬编码 / 量级去证据化 / 来源字段）+ 用户认可。🔴 派生明文凭证安全任务 |
| 7 第七部分·质量与验收 | §20–§21（测试体系 / 质量与反馈闭环） | ✅ 主笔 + 双路评审修订（F1 主链路零测试据实 / F3 资产状态底座 / F4-5 FinBayes 边界 / 契约口径）+ 用户认可 |
| 8 第八部分·缺口与决策 | §22–§24（缺口 / ADR 索引 / 风险登记） | ✅ 主笔 + 双路评审修订（汇总遗漏：补 WP-P0-03/P1-02/P2-01、部署/指标口径缺口、ADR-04/11 拆分）+ 用户认可 |
| 9 第九部分·落地映射 | §25–§29（任务对应 / 审计点 / 代码仓映射 / 首个工程包 / 感知前沿承接） | ✅ 主笔 + 双路评审修订（§29 白皮书 §4.2 六条前沿能力忠实重排 / xprivacy 路径）+ 用户认可。L3 正文 §1–§29 全完成 |
| 10 收尾 | 全文总评审 + ADR 落盘 + 复盘 + playbook 反馈 | ✅ 完成：全文总评审（B1 标准化记录终态统一 + N1/N2）、ADR 落盘 decisions/README.md（12 候选）、复盘 2026-06-01-retrospective.md、playbook v1.2→v1.3 |
工作流状态：✅ 完成（2026-06-01）
L3 系统架构文档 projects/data-horizon/engineering/architecture.md §1–§29 九部分全部主笔 + 逐部双路评审 + 全文总评审定稿。ADR 候选 12 条落盘待 M0 起草。下一步（新工作流）：M0 工程包设计（首发 DH-WP-001）+ 高优先 ADR 起草（含明文凭证安全任务）。
决策记录
- ADR 候选 12 条已落盘
decisions/README.md（承接 L2 §15.5 八条 + L3 评审新增 09–12）；M0 起草。 - G6（ATM 消费对象形态）= ADR-候选-03，待与 Trading Matrix 对齐。