本文列出 Data Horizon 第一阶段从任务包到工程落地过程中需要产出的文档。目的不是增加文档负担，而是让团队知道每一类文档解决什么问题、什么时候需要写、放在哪里。
1. 文档原则
- 能用一页任务包设计卡说明的，不写成长篇方案；
- 工程执行状态不放知识库，放工程仓 issue、任务系统或运行 handoff；
- Data Horizon 自己的任务和产物放在
projects/data-horizon/implementation/；
- 每个 work package 建议在
projects/data-horizon/implementation/ 下建立独立子目录；
- 某个 work package 的任务包设计、字段字典、交付说明、试消费反馈和复盘记录，统一放入该 work package 子目录；
- Trading Matrix 提出的原始协同需求仍保留在
projects/trading-matrix/co-requests/；
- 每个文档必须有明确消费者、触发条件和下一步动作。
2. 当前必须产出的文档
| 文档 | 状态 | 作用 | 放置位置 |
|---|
| Data Horizon 第一阶段实施路线图与任务包索引 | 已创建 | 统一展示待实现需求、优先级、状态和下一步。 | 实施路线图与任务包索引 |
| DH-WP-001 Trading Matrix 信源候选与样本交付任务包设计 | 已创建 | 把第一个真实业务牵引需求转成 DH 可执行任务包。 | DH-WP-001 任务包目录 |
| DH-WP-001 S0 baseline 字段字典 | 已创建 | 冻结第一批 CSV / JSON 必填字段、可空字段和字段含义。 | S0 baseline 字段字典 |
| DH-WP-001 S0 baseline 交付说明 | 已创建 | 说明第一批信源和样本如何生成、如何校验、如何交给 Trading Matrix。 | S0 baseline 交付说明 |
| DH-WP-001 Trading Matrix 试消费反馈记录 | 已创建（待 TM 填写结论） | 记录 TM 是否能用 S0 baseline 生成策略种子，以及字段修正意见。 | Trading Matrix 试消费反馈记录 |
3. 进入 S1/S2 前再产出的文档
| 文档 | 触发条件 | 作用 |
|---|
| 信源画像与质量初评规则 | S0 baseline 被 Trading Matrix 确认为可试消费后 | 定义市场侧重、周期、风格、活跃状态、A/B/C/D 初评和证据要求。 |
| Trading Matrix 反馈回写契约 | Trading Matrix 开始生成策略种子或验证实例时 | 冻结 tm_seed_status、tm_validation_status、tm_asset_status 等反馈字段。 |
| 业务运营 Dashboard 信息架构 | S1 流程稳定后 | 定义 DH 管理后台列表、详情、筛选、推荐队列、反馈视图和审计视图。 |
| 动态服务 / API 方案 | 需要从静态导出升级为定期拉取时 | 定义列表、详情、样本查询、反馈回写接口。 |
| 工程实施方案 | 任务进入 Data Horizon 工程仓执行前 | 定义 schema、API、状态机、页面、权限、任务调度、测试和验收命令。 |
4. 文档产出流程
5. 不建议现在产出的文档
| 文档 | 暂不产出原因 |
|---|
| 完整年度路线图 | 第一阶段真实闭环尚未跑通，过早拉长会降低可执行性。 |
| 所有任务包的完整工程方案 | 当前应先用 DH-WP-001 跑通样板流程，再复制模板。 |
| 完整后台产品 PRD | S0/S1 还会改变字段、流程和复核动作，应等试消费反馈后再写。 |
| 完整 API / SDK / MCP 规范 | 第一阶段先验证静态导出和内部接口语义，避免过早冻结外部契约。 |
Changelog / 演化记录
2026-05-27：产出 DH-WP-001 S0 字段字典、交付说明与试消费反馈记录（试消费结论待 Trading Matrix 填写）。
2026-05-26：补充 work package 独立子目录原则，并将 DH-WP-001 后续文档产出路径收敛到该任务包目录下。
2026-05-26：创建第一阶段文档产出清单，明确哪些文档现在必须产出、哪些等 S1/S2 触发后再产出。