01 组织与品牌
BDOC-ROOT-001 文档体系说明
依据 ADR-0001。oceanway-docs 是需求、设计、架构、决策的唯一事实源。
| 目录 | 前缀 | 内容 |
|---|---|---|
| 01_组织与品牌 | BDOC | 愿景、产品矩阵、品牌命名、仓库治理、模板 |
| 02_决策 | ADR | 一个决策一个文件 |
| 03_平台 | PLAT / RT / MG / INFRA | 01_平台总览 + 02_platform / 03_运行时 / 04_媒体供应 / 05_基础设施；每个模块统一为 01_总览 / 02_需求与工作包 / 03_设计 / 04_开发 / 05_过程 |
| 04_产品 | PDOC-<产品> / DEV-<产品> | studio / commerce / site；产品文档 + 各自仓库的开发目录（studio/07_开发、commerce/02_开发、site/04_开发） |
| 05_设计 | DSN | 视觉与组件规范索引、设计验收（对应 Oceanway-design） |
| 06_开发 | DEV-X | 仅跨仓：技术总览、仓库依赖图、API与契约、统一规范、测试与质量基线、部署运维总览、内部工具（codex-config） |
| 07_过程记录 | PROC | 周报、证据、发布、复盘（非正文） |
| 08_归档 | ARCH | 只读 |
目录编号规则：每一级都用两位数，从 01 开始连续；以后新增的顶层分类插在 08_归档 之前，归档顺延。
仓库与文档目录的对应关系见 BDOC-03-001 仓库与文档对照表。
需求优先：代码和历史证据不能反向定义需求（ADR-0001 第 8 条，源自原 D-PLATFORM-PRODUCT-DRIVEN-DOCS）。
流程：PRD → FS → WP（任务卡）→ PR（标题带 [WP-xxx]）。Issue 仅用于 bug 与外部反馈。
旧英文目录（overview、platform 等）已于 2026-10-16 迁移至本体系，旧地址自动跳转；原决策页拆分为 ADR-0005~0021。