十四仓实施总控
OceanWay 十四个独立仓库的实施入口、交付批次、依赖关系与事实源边界
本目录是 OceanWay 从目标架构进入多仓实施的统一入口。正式采用“一个仓库一个实施主页，跨仓依赖由总控页编排”的组织方式。
架构文档回答系统最终是什么、边界在哪里；本目录回答每个仓库由谁实施、依赖什么、按什么顺序交付、怎样切换与怎样证明完成。GitHub Issues、Pull Request 和 Project 继续承载可变的任务状态，本文档不复制逐条任务列表。
文档职责分层
| 文档层 | 回答的问题 | 更新节奏 | 不承载 |
|---|---|---|---|
| 平台架构 | 为什么这样设计、事实 Owner 与不变量是什么 | 发生架构决策时 | Sprint 任务和临时排期 |
| 本实施目录 | 谁在什么仓库交付什么、先后依赖和验收证据是什么 | 交付批次或门禁变化时 | 每个 Issue 的实时状态 |
| 项目进度 | 当前已经完成到哪里、下一项工程动作是什么 | 每次正式验收后 | 目标架构的重复说明 |
| GitHub | 具体任务、PR、评审、CI 与 Release | 持续更新 | 跨仓架构事实源 |
同一事实只能有一个权威位置。仓库边界以Polyrepo 仓库拓扑为准；跨仓发布顺序以交付批次为准；当前完成状态以项目进度为准。
十四仓实施入口
| 分类 | 仓库 | 实施结果 | 当前所处位置 |
|---|---|---|---|
| 产品 | oceanway-site | 公共品牌、商业合作与 FDE 公开展示 | 可并行建设公开内容，登录态与私有数据不前置 |
| 产品 | oceanway-developer-center | ai.oceanway.tech 公开模型/API 内容 | 公开信息架构可并行，私有控制能力留在 Console |
| 产品 | oceanway-console | 唯一客户控制台与 /ai 专业空间 | 等待 Core、Asset 与最小文本链路后切换 Writer |
| 产品 | oceanway-studio | canvas.oceanway.tech 创作与 Canvas | 以 oceanway-vozeb 为迁移来源，逐命令切换 |
| 产品 | oceanway-drama | AI 漫剧垂直工作台 | 保留既有历史，等待共享执行骨架后接入 |
| 产品 | oceanway-commerce | 电商内容与渠道工作台 | 保留既有历史，等待共享执行骨架后接入 |
| 产品 | oceanway-admin | Workforce 管理与运维控制面 | 当前批次先交付只读 Run Explorer |
| 平台 | oceanway-contracts | 跨仓 Schema、OpenAPI、事件与生成制品 | 0.2.0 已发布；当前扩展 Outbox/Ops 契约 |
| 平台 | oceanway-core | 共享领域、执行、计量、账务与 Operations | Run Admission 已验收；当前实现 Outbox/Ops |
| 平台 | oceanway-api-edge | Public API 认证、协议与请求入口 | 受控准入已验收，公网继续关闭 |
| 网关 | oceanway-text-gateway | UUMI/new-api 私有文本模型基础设施 | 等待 Metering/Settlement 后执行 canary |
| 网关 | oceanway-media-gateway | 图片/视频 Provider 直连执行服务 | 可整理内部模块，正式接入晚于文本 canary |
| 运维 | oceanway-docs | 架构、实施、运行手册与公开文档 | 已自动部署，持续维护契约与证据索引 |
| 运维 | oceanway-infrastructure | IaC、身份、网络、发布、可观测与证据 | 已有受控准入证据；当前补 Operations 门禁 |
“仓库已建立”不等于实现、迁移或生产切流已经完成。每个实施页都必须明确区分：已有基线、当前批次、后续批次和禁止提前声明的能力。
当前关键路径
Site、Developer Center 的匿名公开内容，以及各产品的非写入型设计和迁移盘点可以并行；任何创建正式 Run、Reservation、Ledger、Asset 或 Provider Task 的路径都不能越过这条关键路径。
每个仓库实施页的固定结构
每个仓库主页都维护以下内容：
- 目标结果：该仓库完成后对用户或平台提供什么结果。
- 当前基线：只记录已验证的代码、制品、部署或历史来源。
- 范围边界：负责与明确不负责的内容。
- 输入与输出契约：固定依赖、调用方向、事件和制品。
- 里程碑：按可独立验收的仓库内增量排序。
- 跨仓门禁：哪些上游证据未完成时不得切流。
- 验收证据：测试、构建、部署、故障注入、迁移和安全证明。
- 切换与回滚：Writer、流量、在途任务、数据与 Secret 的处理。
实施页只记录稳定工作包，不记录开发者个人 Todo、临时分支名或未经确认的日期。任务级信息使用仓库 Issue；实施页只链接里程碑、固定 Release 和最终证据。
总控规则
- 跨仓契约必须先进入
oceanway-contracts固定 Release，消费者不能复制 DTO。 - 同一个业务命令始终只有一个 Writer of Record；迁移允许代理或无副作用 Shadow，不允许业务双写。
- Surface 仓不直连 Core 或 Gateway 数据库；Gateway 不拥有客户、价格、钱包、产品 Run 或正式 Asset。
- 每个批次完成时必须同时更新实施页、项目状态和 Changelog，并登记 Commit、CI、Release 与证据摘要。
- 没有验收证据的“代码已写完”不算通过门禁；没有切流授权的“测试通过”不算生产上线。
- 新增第十五个仓库必须先通过 ADR，不能因为单个实施页变长就拆仓。
下一步从交付批次查看整体顺序，再进入对应仓库主页执行当前工作包。