路线图

业务开发和上线按阶段门槛推进。每个阶段列出做完的标准，达到之后再进入下一阶段；下一阶段的文档准备可提前进行，不表示验证或上线已完成。当前所处阶段和进行中的任务见进度。

0. 冻结与重建

• 各仓库未提交的改动提交到快照分支并推送远端。
• Core、API Edge、Contracts 移入工作区 archive/repos/。
• 旧文档整体移入归档，按新结构重写文档。

做完的标准： 所有代码都有远端备份；新文档覆盖总览、平台、产品、网关、工程规范、运维、进度七个分区，构建和链接检查通过。

1. 平台验证

专项产品文档、开发文档和实施计划已建立，T-01 已于 2026-10-02 固定官方 rc.41 并导入本地验证分支、准备隔离环境；业务验证尚未开始。按 T-01～T-03 完成下面的验证，再进入正式平台阶段。

在本地用最新 new-api 起一个平台实例，把 uumi 配成上游渠道，不改 uumi，不删任何现有代码。逐项验证：

1. 计费正确性：OpenAI、Claude、Gemini 三种格式，普通响应和流式各测一遍；缓存命中和推理 token 的扣费符合预期。
2. 差异价：零售、FDE、企业协议价三个分组，同一请求按各自价格扣费；人民币充值按非 1:1 换算成积分。
3. Console 前端改接：把现有 Console 前端指向这个实例，Key、模型、价格、用量几页能跑通；列出还需要补的平台接口。
4. 异常场景：上游缺少用量字段、流中途断开时，扣费的表现可以接受。
5. 视频：把媒体网关配成视频渠道，任务提交、轮询、失败退款和计价能跑通。
6. 跨产品闭环：一个测试产品入口与平台共享登录；受限代用户模型调用和非模型消费使用同一余额，Console 或记录接口能查询两类消费；注销及越权拒绝符合约定。
7. 恢复与能力覆盖：验证预留到期、并发结算/释放、崩溃恢复、提交未知不重做生成；审计图片/音频供应候选，并用本地夹具验证图片及结果保存授权。

原版能力和最小验证性扩展分别保存证据，详细场景见平台集成验证。本地夹具不需要收费调用授权；真实上游另行授权，未验证组合不上架。

做完的标准： 七项都有结论，最小跨产品闭环有实际余额、流水与授权证据。某一项不通过时，记录原因、需要自研补足的部分与复验条件，再决定下一阶段范围；不能仅因为 new-api 自带功能就判通过。

2. 平台首发

• 将阶段 1 已固定并验证的官方 new-api 基线及必要扩展纳入正式 oceanway-platform 仓库，按审计结果删减模块；若更换基线，先复验。
• 实现主域名共享 Cookie 的全局登录，以及平台角色和产品角色。
• 钱包按“所有产品共用”设计：使用记录带来源产品，新增内部扣费接口（预留、结算、释放，幂等）。
• 完成同一记账服务、价格快照、持久恢复与产品作用域授权；多媒体组合仅在验证通过后开放。
• Console、Admin 前端迁入平台仓库，去掉原来的 BFF 层，原仓库归档。
• 确定积分换算和首发套餐，接通支付。
• 部署上线。

做完的标准： 一个新用户能注册、充值、创建 Key、调用文本模型并看到正确的扣费记录；员工能在 Admin 管理用户、价格和订单。

3. Studio 接入

• 删除 Studio 自己的账号、积分、账单、渠道和模型路由，以及签到、邀请等营销功能；这些能力由平台提供。
• 登录改为平台共享 Cookie；模型调用改走平台 API；非模型收费改调平台扣费接口。
• Studio 管理页只保留产品级管理，并接入 Admin 的统一入口。

做完的标准： 同一个用户在 Studio 生成视频和在 API 调用文本模型，扣的是同一个余额，Console 里能分别看到两条记录。

4. Drama 与 Commerce

• Drama：把已验证的页面和交互从 Vite 迁入 oceanway-studio 的 Drama 子站；后端按 Studio 的方式重写，复用任务运行、存储和平台接入代码。
• Commerce：前端迁入 Commerce 子站，新建后端，复用同样的公共能力。
• 两个子站按第 3 阶段同样的方式接入平台；原 oceanway-drama、oceanway-commerce 仓库归档。

做完的标准： 两个子站各跑通一条真实的生产流程，扣费进入同一个钱包。

5. 迁移与退役

• 核对 sub2api 零售客户的余额购买力和旧价保护范围，制定换算规则。
• 先小批量迁移，确认无误后全量迁移，sub2api 退役。

做完的标准： 零售客户全部在平台上使用，sub2api 停止服务。