Polyrepo 仓库拓扑与迁移治理
第一版仓库职责恢复，修正 Developer 与 new-api 参考方式
当前执行原则与重点
2026-09-12 用户明确：大部分代码参考并优先复用 new-api，大部分现有接口直接沿用，当前技术栈与 new-api 完全一致；工作重点转为 Core 和 API Edge。多仓架构保持不变。
采用已核验的固定 new-api 版本作为代码与接口基线，优先保留原有路由、HTTP 方法、请求/响应字段、鉴权语义、分页与错误结构。主要工作是按职责提取、接入与补差，不重新设计全部 API。复用比例是实施原则，不是已完成的覆盖率；实际支持状态以迁移和兼容验证为准。
Core 承接客户管理与商业实现，Edge 承接模型 API 入口和流式处理。跨服务授权/预留/结算/查询及 OceanWay 商业差异才新增或调整接口。Contracts 接收现成规范并记录差异，不成为全量协议重写前置。
恢复第一版平台、产品、网关与支撑仓结构。下表是职责清单，不表示本轮已创建远端、迁移代码或发布服务。2026-09-22 用户确认 Developer Center 合入 Console，取消独立开发者门户仓库及部署计划；当前为 14 项目标职责。
| 分类 | 仓库 | 唯一职责 |
|---|---|---|
| 平台 | oceanway-core | 身份、Key、模型目录、价格、积分、订单、操作与任务、内部授权和审计 |
| 平台 | oceanway-api-edge | 公共模型协议、凭据接入、限流、流式转发与 Core 协作 |
| 平台 | oceanway-contracts | 版本化 API、事件、错误码、Go/TypeScript 客户端 |
| 网关 | oceanway-text-gateway | 基于 new-api 的独立供应网关，供应商与渠道在此维护 |
| 网关 | oceanway-media-gateway | 自研媒体供应任务、适配与结果 |
| 产品 | oceanway-site | 品牌与各产品入口 |
| 产品 | oceanway-console | 公开模型、开发文档、教程及登录后客户账户、Key、充值、价格、用量与订单 |
| 产品 | oceanway-admin | 统一管理入口、公共客户/商业管理、产品管理空间集成与审计界面 |
| 产品 | oceanway-studio | 创作画布、项目、资产关联与产品工作流 |
| 产品 | oceanway-drama | 漫剧业务与产品工作流 |
| 产品 | oceanway-commerce | 商品内容、批次与产品工作流 |
| 支撑 | Oceanway-design | 品牌、设计资源、通用组件与规范 |
| 支撑 | oceanway-docs | 本体系、API 使用说明与进度证据 |
| 支撑 | oceanway-infrastructure | 环境、部署、监控、备份与运行手册 |
依赖方向
Core 内部继续按领域模块组织，身份/价格/钱包不再分别拆成微服务。Worker 先在 Core 仓库内独立进程运行，产品流程编排归产品仓库。Contracts 无业务数据库或账务执行逻辑；各服务通过版本化接口协作，不跨仓直接引用未发布源码，不跨库写账。
客户数据由 Core 持有，网关使用独立库和内部服务账号；Edge 不创建第二套用户/钱包数据库。产品可以拥有自己的业务库。实例与数据库集群可以按资源合并部署，但访问身份和数据写入边界仍隔离。
各产品管理空间通过 Admin 统一入口访问，产品管理事实仍由对应服务持有；功能空间不直接映射为新仓库或新服务。Studio 后台提供迁移基座，独立 Admin 已接通能力保留合并。详细边界见管理空间架构。
new-api 的定位
固定官方工作区 references/new-api 作为源码参考和隔离验证来源，不再视为最终统一后台仓。Core/Edge 参考、提取符合各自职责的代码，并记录来源、依赖和验证。网关保留近官方版本，独立更新；新技术栈与其对齐不等于每次补丁必须同步。
本轮不移动工作树、删除旧仓或恢复旧 CI 完成结论；实际远端、分支和制品映射在首个技术包核对。各仓计划见实施总控。
仓库保留与内容替换
Contracts 保留原 Git 仓库及 src/scripts/test/docs 的职责，旧内容整体退出当前基线，新候选工作树为 platform/oceanway-contracts。本次未替换其他业务仓库代码，Core/Edge/Console/Admin 继续按各自工作包推进。历史发布不覆盖，详见替换决定。