FinBayes Atlas V2 结构与内容组织（讨论稿）
已于 2026-08-20 获 owner 批准并完成重写、终审与治理切换。 Atlas 已正式接管；本文只保留为该任务的过程附件，不再维护任务状态。
0. 这份讨论稿用来做什么
本稿用于 owner 与团队在重写 Atlas 前确认三件事：
- 新版 Atlas 的目录和阅读逻辑；
- 阶段、子阶段、模块、任务、状态、依赖和参考方案如何组织；
- 当前 Atlas、Roadmap 与阶段四草案中的内容分别如何迁入新版 Atlas。
本稿只是 Atlas 重写任务的过程附件。确认后的结论应进入 Atlas 本身，本稿不成为另一份长期维护的规划文档。
1. 已确认的方向
Atlas 是 FinBayes 的统一规划与推进总图，不只是一个链接目录。团队应能从 Atlas 一处理解和查看：
- FinBayes 的产品目标、边界和目标形态；
- 总体架构、阶段、必要的子阶段和主要模块；
- 任务、负责人、依赖、状态和预期结果；
- 当前处于哪个阶段，正在讨论或推进什么；
- 各阶段、模块和任务有哪些强 AI Agent 与行业产品可供参考；
- 已形成的决定、尚待讨论的问题和对应任务链接。
同一项信息只维护一次，但可以通过总览、阶段树、当前工作、依赖关系和参考地图等不同视图查看。
Atlas 不保存历史方案正文，也不描述当前代码、接口、文件路径和实现细节。需要核对实现事实时仍以当前代码、测试和新鲜验证为准。
2. Atlas 的建议目录
00 总览
- FinBayes 是什么、不是什么；
- 当前阶段、当前重点、主要阻塞和下一步；
- 各阶段整体状态；
- 快速进入当前任务、目标架构和参考地图。
01 产品目标与边界
- 产品目标和面向的用户问题；
- 产品边界与明确非目标；
- 本地、联网服务和自部署之间的关系；
- 与 Data Horizon、Trading Matrix 等相关系统的边界。
02 目标架构与模块
- FinBayes 最终由哪些主要部分组成；
- 各模块解决什么问题；
- 模块之间的主要关系；
- 每种交付形态复用什么、允许在哪里不同。
03 阶段与任务树
- S0—S5 的阶段目标、状态和完成条件；
- 每个阶段下的子阶段（确有时间顺序时才设置）、模块和任务；
- 任务负责人、状态、依赖、结果和相关附件；
- 默认突出当前阶段，历史阶段折叠但仍可查看。
04 当前工作
- 当前进行中、待讨论和受阻的任务；
- 按负责人、状态、阶段和模块筛选；
- 当前需要 owner 或团队决定的问题；
- 最近完成和下一步。
本章不是第二份任务清单，而是第 03 章同一批任务的聚合视图。
05 依赖关系
- 阶段之间的前后关系；
- 跨模块和跨阶段的任务依赖；
- 关键阻塞和可以并行推进的工作。
本章只展示第 03 章已经维护的依赖，不重新写一遍。
06 强 Agent 与行业参考
- 按 FinBayes 模块或任务查看适用参考；
- 按强 AI Agent、行业产品、框架、基础设施、组件或协议反向查看可参考的 FinBayes 范围；
- 说明可以借鉴什么、适用条件、代价和不应照搬什么；
- 展示参考研究状态以及是否已经形成 FinBayes 采用决定。
07 决定、待讨论问题与附件
- 已形成并仍有效的产品或架构决定；
- 尚未解决的问题及其所属阶段、模块或任务；
- 当前讨论稿、Issue、评审和其他过程附件；
- 讨论完成后将结论写回相应节点，附件不替代 Atlas 正文。
08 术语与使用说明
- 必要的产品和行业术语；
- 状态与参考研究状态的含义；
- Atlas 的更新责任和阅读方法。
三种阅读路径
- Owner 看全局与做决定：总览 → 当前阶段 → 受阻与待讨论问题 → 阶段目标和完成条件 → 相关参考；
- 团队成员领取和推进任务：当前工作 → 按负责人或模块筛选 → 任务详情 → 依赖、完成条件、参考方案和附件；
- 新成员理解 FinBayes：产品目标与边界 → 目标架构与模块 → 阶段树 → 当前阶段 → 按需展开参考地图。
三条路径都从 Atlas 完成，不要求读者再打开 Roadmap 才能拼出项目全貌。
3. 阶段、模块与任务的组织
Atlas 以阶段树为主要骨架：
FinBayes
├── S0 阶段
├── S1 阶段
├── S2 阶段
├── S3 阶段
└── S4 B/S 与商业化产品化
├── 阶段目标、边界和完成条件
├── 子阶段（只有确有交付顺序时才出现）
│ ├── 模块
│ │ ├── 任务
│ │ │ └── 子任务（只有能够独立负责和判断完成时才出现）
│ │ └── 任务
│ └── 模块
└── 阶段级决定与待讨论问题
层级含义：
- 阶段说明一个时期要形成的整体产品结果；
- 子阶段只用于表达阶段内明确的交付顺序，不要求每个阶段都有；
- 模块说明需要建设或演进的一组产品能力；
- 任务是可以明确负责、推进和完成的工作单元；
- 子任务只在一项任务确实需要多个可独立负责、独立判断状态的交付单元时使用；普通步骤留在任务说明中，不继续加深层级；
- 依赖可以跨树连接，不通过复制任务或强行改变归属来表达。
4. 各类节点保留的信息
4.1 阶段
| 信息 | 用途 |
|---|---|
| 名称与目标 | 说明阶段最终要形成什么用户或产品结果 |
| 状态 | 说明未开始、进行中、受阻、已完成或已取消 |
| 负责人 | 对阶段整体结果负责的人或团队 |
| 前置条件 | 说明进入阶段前必须满足什么 |
| 完成条件 | 说明什么情况下可以认为阶段完成 |
| 主要模块 | 连接阶段内的能力范围 |
| 决定与待讨论问题 | 记录会改变阶段方向的关键结论与未决问题 |
4.2 模块
| 信息 | 用途 |
|---|---|
| 名称与职责 | 说明模块解决什么问题 |
| 所属阶段 | 说明当前主要在哪个阶段建设；长期模块不重复创建 |
| 状态与负责人 | 说明当前推进情况和主要责任人 |
| 依赖 | 连接其他模块或任务 |
| 任务 | 展示组成该模块的实际工作 |
| 参考方案 | 连接相关强 Agent、行业产品和最佳实践 |
4.3 任务
| 信息 | 用途 |
|---|---|
| 名称与目标 | 说清要解决的问题和预期结果 |
| 状态 | 未开始、进行中、待合入、受阻、已完成或已取消 |
| 负责人 | 一个主要负责人；协作者按需要补充 |
| 所属阶段与模块 | 保持任务在总图中的位置清楚 |
| 依赖 | 指向必须先完成或共同决定的节点 |
| 完成条件 | 说明怎样判断任务完成，不写实现步骤 |
| 参考状态 | 尚未研究、已有参考、比较完成、决定借鉴或不适用 |
| 决定与附件 | 连接 Issue、讨论稿、评审或其他过程材料 |
| 子任务 | 仅在需要单独负责人、状态或完成条件时出现 |
4.4 状态不要混用
- 阶段、模块、任务和子任务的工作状态：未开始、进行中、待合入、受阻、已完成、已取消；
- 议题状态：待讨论、讨论中、已定、暂缓；
- 参考状态：尚未研究、已有参考、比较完成、决定借鉴、不适用。
“待讨论”不是普通任务状态。一次方案讨论可以是一项“进行中”的任务，任务下面包含若干“待讨论”的议题。
5. 强 Agent 与行业参考的组织方式
参考内容在 Atlas 中只维护一次，并形成双向关系：
- 从阶段、模块或任务节点查看与当前问题有关的参考；
- 从某个强 Agent、行业产品、框架、基础设施、组件或协议反向查看它对应哪些 FinBayes 节点。
每个参考对象至少说明：
- 它解决什么问题；
- 对应 FinBayes 的哪些阶段、模块或任务；
- 值得借鉴的设计与最佳实践；
- 适用条件和主要代价；
- 不应直接照搬的部分；
- 当前研究和采用状态；
- 资料入口与核对时间。
参考对象不是任务，也不参与阶段完成度计算。一个参考对象可以关联多个模块和任务，不复制正文。
6. 阶段四讨论草案的位置
阶段四草案只作为当前任务的附件出现：
S4 B/S 与商业化产品化
└── 任务：阶段四整体方案讨论与团队对齐
├── 状态：进行中
├── 目标：收敛阶段目标、议题、模块、分阶段方案和参考范围
└── 附件：阶段四讨论草案
讨论过程中形成的结论按内容写回：
- 阶段目标、边界和完成条件写回 S4 阶段节点；
- 能力范围写回对应模块；
- 可推进工作写回任务节点；
- 强 Agent 和行业实践写回参考地图并关联相应节点；
- 未解决问题写回对应阶段、模块或任务的待讨论问题；
- 草案本身继续作为过程记录，不成为另一份长期规划真源。
7. 当前内容迁移原则
| 当前 Atlas 内容 | 新版去向 | 处理方式 |
|---|---|---|
| 产品主线与非目标 | 00、01 | 保留并用当前产品语言重写 |
| 当前进度快照 | 00、03、04 | 从只读投影改为 Atlas 自身任务数据的不同视图 |
| S4 草案入口与代表场景 | 当前 S4 任务、阶段完成条件 | 草案保留为附件；场景只保留为验收方向 |
| 当前架构标签页 | 不迁入 | 删除；当前实现事实回到代码和验证 |
| 目标架构标签页 | 02 | 保留并重写为唯一目标架构 |
| 差距与任务标签页 | 03 | 拆入具体模块和任务，删除过期进度叙述 |
| S0—S5 阶段卡片 | 03 | 改造成阶段树；状态只维护一次 |
| 16 项整体改造范围 | 02、03 | 合并为模块和阶段范围，不再单独维护一张表 |
| Local、Web、B/S 交付形态 | 01、02 | 保留为产品与目标架构的一部分 |
| 协作与并行说明 | 05、08 或工程规则 | 依赖关系进入第 05 章；协作纪律不占主视图 |
| 四套参考整机与参考分类 | 06 | 改造成统一参考对象和分类 |
| 强 Agent 蓝图与组件矩阵 | 06 | 合并为参考对象的设计做法和适用范围 |
| 19 个领域与 76 张参考卡 | 02、06 | 领域与模块对齐；参考卡去重后建立双向关联 |
| FinBayes 当前实现映射 | 不迁入 | 删除 |
| A01—A19 依赖表 | 05 | 改用可理解的阶段、模块和任务名称；不要求记内部编号 |
| 多端与技术栈 | 02 | 多端关系保留；会随实现变化的技术快照删除 |
| 术语 | 08 | 保留并减少内部方言 |
| 事实与实施约定 | 08 或工程规则 | 只保留 Atlas 的使用和维护规则 |
| 旧方案处置与退役附录 | 不迁入 | 删除，不参与当前规划理解 |
| Roadmap 有效阶段和任务 | 03、04、05 | 迁入 Atlas，包含负责人、依赖、状态和完成条件 |
| Roadmap 任务接入与验证规则 | 工程规则 | 不放入 Atlas 主视图 |
| 阶段四讨论草案 | 当前 S4 任务附件 | 结论按阶段、模块、任务、议题和参考对象逐步写回 Atlas |
8. Roadmap 的退出方式
新版 Atlas 建立后，阶段、任务、负责人、依赖和状态都只在 Atlas 维护。迁移期间按以下顺序处理：
- 把 Roadmap 中仍有效的阶段和任务完整迁入 Atlas；
- 核对任务数量、负责人、依赖和状态没有遗漏；
- 经 owner 明确批准后，将铁律、仓库入口、协作规则和 Agent 指引改为以 Atlas 为唯一任务来源；
- 停止人工更新 Roadmap；
- 需要兼容旧链接时，只保留指向 Atlas 的说明页或由 Atlas 自动生成的只读页面；
- 确认团队不再依赖后删除兼容入口。
不允许 Atlas 与 Roadmap 在迁移后继续并行维护任务状态。
Atlas 是团队唯一需要阅读和维护的产品规划入口。页面可以由一份便于审查和更新的内容源生成，但这种内部组织不得要求团队再去维护另一份 Roadmap 或参考文档；阶段树、当前工作、依赖关系和参考地图都必须来自同一批内容。
9. 已确认的实现选择
- S0—S3 默认显示阶段和主要结果，已完成任务折叠并可搜索；
- 阶段和重要任务显示主要负责人，模块允许由团队负责；
- 首批参考地图覆盖所有模块和当前阶段任务，不把历史实施流水逐项搬入；
- Roadmap 旧链接跳转到 Atlas，仓库原文冻结为迁移前历史快照；
- V2 先完成核心树形阅读、当前工作、依赖和参考视图，复杂图形按真实需要再补；
- 铁律第 8 条及相关治理声明改为 Atlas 是唯一任务来源。
- 保留新版阶段与任务结构，同时补回旧版有价值的“当前能力基线 → 目标状态 → 剩余差距”关系；差距直接来自 Atlas 未完成任务，不维护第二份差距清单。
- 增加模块能力地图，每个模块显示子组件、当前基线、目标、候选边界、任务和参考模式；不恢复代码、端点和文件级实现快照。
- 恢复八类代表性金融场景，作为可演进的产品与阶段验收样本，不成为固定金融工作流。
- 强 Agent 与行业参考同时支持“参考对象中心”和“FinBayes 模块中心”两种查看方式，并标明证据范围与不照搬边界。
- 本次迁移同步升级
PRODUCT.md的产品事实结构，并从现行DESIGN.md刷新 Workbench 设计侧车；两者属于 Atlas 治理交付，不为 Atlas 另建产品或设计真源。
10. 建议的重写顺序
- 确认本稿的目录、层级和字段；
- 完成所有旧内容到新节点的逐项映射；
- 先建立 S0—S5 阶段树及仍有效任务；
- 合并目标架构和模块；
- 重组强 Agent 与行业参考并建立双向关联；
- 建立总览、当前工作和依赖视图；
- 删除实现快照、历史方案和重复内容；
- 修改治理规则并停止 Roadmap 的独立人工维护；
- 核对 owner、团队成员和新成员三条阅读路径；
- 发布并验证公网页面与仓库内容一致。