跳到主要内容

<子系统名> 子系统工程包

⚠️ 模板占位。基于 EvalHarness 子系统 / KnowledgeGraphService 子系统 等 4 子系统实测提炼。

§1 职责定位​

  • 本子系统在 architecture.md §9（6 通路子系统）或 §29（4 认知子系统）中的位置
  • 与上下游子系统的接口边界

§2 输入 / 输出契约（引用 contracts/structured-cognition-result.yaml）​

  • 输入字段（StructuredCognitionResult 哪些 / Task 元数据哪些）
  • 输出字段（产 1.1 哪些机制层字段 / 哪些子结构）

§3 接口签名​

# src/finbayes/<subsystem>/types.py
# 引用 contracts/code-paths.yaml

§4 数据流​

§5 状态机（如有，引用 contracts/state-machines.yaml）​

本子系统是否有独立状态机（如 ProviderReadiness 之于 Provider Adapter）。

§6 v1 回退策略​

承接 architecture.md §13 故障与降级路径。本子系统的降级行为。

§7 待解决问题（与 owner map 联动）​

问题 ID（来源 owner map）内容归口档（P0/P1/P2）

§8 测试要求​

tests/<subsystem>/
  test_<feature>.py
  test_<contract_compatibility>.py

§9 里程碑映射​

Milestoneimplement / stub / 未触及字段范围
M0stub / implement...
M1......
.........

§10 ADR 引用（namespace prefixed）​

承接整改包 IV-1 audit Rule 4。

  • arch-rewrite/ADR-XXX
  • whitepaper-rewrite/ADR-XXX

§11 关联资产​

  • 上位架构：architecture.md §9 / §29
  • 配套工程包：engineering-packs/m-.md
  • 上位整改：Step 11 整改包 II 详细方案