历史 · 总体实施计划
重构前档案，仅供追溯，不作为新版本执行指令
历史档案 · 2026-09-11 重构前快照。 本文中的“当前”“已冻结”和实施顺序属于旧基线。新版本以现行总览和实施计划为准。
最新决定：从官方源码重新开始。 新版本直接基于官方 new-api，旧 Core、uumi 定制与产品代码不再作为实现基线。已建立干净开发目录
platform/oceanway-platform，分支codex/newapi-foundation。历史文件保留供需求参考；下方旧代码复用及迁移安排均以当前拆分方案为准。
2026-09-11 架构方向更新：以最新版 new-api 为共享后台基础，复用账户、Key、额度、计费与任务能力；new-api 前端可以全部重做，OceanWay 界面独立设计。Developer 提供公开模型、文档和教程，登录后的管理统一放 Console；Site 引导至各产品子站。先阅读基于 new-api 的平台拆分分析。下文及各仓旧计划中的 Core 重建、私有 Text Gateway 和 Developer 归档安排是待重新映射的旧基线，不代表新方向已完成实施。
当前由本人统一负责所有项目，采用本机协调优先，一个仓库一份实施计划。本轮先统一各平台的需求、产品设计与原型；后台 API、API 文档和联调按同一条用户流程逐步接入。已有代码、测试和设计作为复用基线，不要求从头再做。
这是对既有计划的补全。B0–B6 继续约束正式运行能力和切流顺序，不作为所有需求、设计、原型及本地开发的共同开工条件。GitHub Issue/PR 可以关联已有工作，但不是当前制定计划、确认需求、评审原型和记录本地测试的前提。
实施入口
| 入口 | 解决的问题 |
|---|---|
| new-api 平台拆分分析 | 固定最新版源码、Console / Developer 页面归属、共享后台模块、媒体接入及迁移顺序 |
| 统一实施流程 | 需求、设计、原型、后台 API、API 文档分别产出什么、怎样验收 |
| 本机协调与首轮工作台 | 本人怎样排任务、登记决定和交接本地成果 |
| 本页各仓计划 | 该平台的具体用户、页面、接口能力、依赖和切片 |
| 交付批次 | B0–B6 的正式运行接收、联调和切换顺序 |
| 验收、发布与回滚 | 需求/原型与代码/运行分别如何证明完成 |
首轮顺序：统一需求、设计与原型
| 顺序 | 工作 | 交付物 | 退出条件 |
|---|---|---|---|
| R1.1 全平台需求盘点 | 对照架构、现有实现与设计候选，确认用户、任务、首期范围和冲突 | 需求清单、首期/后续/不做、复用基线、待决策项 | 每个平台至少一个核心任务，未知未伪装成定案 |
| R1.2 产品与服务设计 | 页面、导航、旅程；资源、状态、权限、数据 Owner | 信息架构、设计说明、接口能力清单、API 文档草稿 | 页面动作有服务与数据来源；未接入部分明确 |
| R1.3 原型与串联评审 | 产品关键流程；服务时序、状态机及无副作用 fixture | 原型文件/预览、状态清单、本人意见 | 核心任务可走查，正常/空态/失败/无权限/未接入可解释 |
| R1.4 开发切片排期 | 从确认的流程反推 API、前端、数据与文档增量 | 本地工作包、依赖、复用来源和验收场景 | 能开工与需等待的包分开，排期与本人可用时间匹配 |
R1 是本轮计划与设计轮次，不对应 B1 技术批次。计划文件补全不等于需求已全部确认或原型已经制作完成。具体日期、工作量和产品发布先后在 R1.4 确定，不预填承诺日期。
首轮交叉确认：Console/Studio 入口与身份，Key/用量现有 Owner，Admin 员工视角，Studio 现有短剧保留，独立 Drama V2 与旧架构差异，Commerce 首期范围，Site 商务转化方式，Design 规范与平台特例。
各平台实施计划
当前 15 个独立仓库中，14 个承担目标活跃职责，Developer Center 是待归档历史来源。Design 已独立承接设计系统，默认分支为 baseten-ui。
| 分类 | 计划 | 首轮重点 | 后台 / 接口责任 |
|---|---|---|---|
| 产品 | Site | 品牌、产品入口、案例、合作转化 | 公开读能力；先确定表单是否需要后端 |
| 产品 | Console | 公开目录、客户壳、开发区、用量 | 同源 BFF；共享事实归 Core，迁移期按现有 Owner 接入 |
| 产品 | Studio | 创作、画布、恢复、素材、现有短剧 | 产品聚合；共享执行按能力接入 Core |
| 产品 | Admin | 员工检索、Run 详情、错误与证据 | Workforce BFF；Query/Grant/Audit 权威归 Core |
| 产品 | Drama | 独立 V2 需求、视频段交付候选流程 | Drama 私有聚合与共享 Run/Asset/Billing |
| 产品 | Commerce | 从工具 MVP 选择首期商品流程 | 商品/活动聚合；mock 与真实接口分列 |
| 平台 | Contracts | 消费者需求、接口规范、文档约定 | 版本化协议、OpenAPI/Schema、制品 |
| 平台 | Core | 资源、状态、权限、事件、时序 | 共享身份、钱包、Run、Asset、Operations |
| 平台 | API Edge | 公共 API 体验、错误、准入/执行差异 | 凭据终止、协议适配、Core 调用 |
| 网关 | Text Gateway | 旧代码取舍、执行/恢复协议原型 | 私有文本执行与 Evidence |
| 网关 | Media Gateway | 提交未知、轮询、取消、结果暂存 | 私有媒体执行；不新增客户平台 |
| 支撑 | Design | 品牌、token、组件、跨平台样板 | 组件 API/包；无须新建业务后端 |
| 支撑 | Docs | 帮助、API 分类、搜索、版本导航 | 构建与检索；引用固定规范 |
| 支撑 | Infrastructure | 开发/联调拓扑、身份网络、运行手册 | 环境、工具、部署、观测与证据 |
| 历史 | Developer Center | 内容/入口迁移与归档 | 不开独立新功能，产品规划归 Console |
完整实施链
原型与接口设计可以往返修订。API 文档从设计阶段起草，在实现和联调时持续更新。无 UI 服务用时序、状态机和 fixture 验证设计；静态页面与组件库不为凑流程新建业务 API。
事实源与协调方式
| 内容 | 维护位置 |
|---|---|
| 架构与领域边界 | 平台架构；新冲突先登记待决策 |
| 稳定实施范围、交付物与依赖 | 本实施目录及各平台实施页 |
| 当前任务、下一动作与工作树 | OceanWay 根目录本地协调工作台；见本机协调 |
| 本人决定与确认 | 本地决定记录，绑定文件版本；已有会话确认可回填 |
| 需求、原型、API 草稿与测试 | 对应仓库，工作台仅保存引用 |
| 已接收的稳定结果与上线记录 | 项目进度 |
| 远端评审、CI、制品与历史 | GitHub，需要时关联本地工作包 |
所有职责均由本人承担；Owner 表示能力归哪个仓库，不代表多个团队。跨仓协调允许本地文件、报告和预览；生产代码仍不导入其他仓源码、不复制 DTO、不跨库写入。每类正式命令保持唯一 Writer，产品不绕过 Core 直调 Gateway。
需求、原型、本地代码、真实联调、合并与上线分别记录。GitHub 暂不可用不阻塞本轮需求设计，也不会自动把本地测试变成生产资格。