平台总述
oceanway-platform 的定位、范围、技术栈与当前状态
oceanway-platform 是 OceanWay 唯一的平台服务。所有产品的账号、权限和钱都在这里；开发者的模型 API 也由它直接提供。
专项文档入口
先读产品范围与需求，再按实施任务进入开发；下列模块文档继续作为身份、资金等规则的唯一细则。
负责什么
| 能力 | 说明 | 详细文档 |
|---|---|---|
| 全局登录与权限 | 一处登录、所有产品识别；平台角色与产品角色 | 身份与权限 |
| 积分钱包与计费 | 唯一余额、充值与订单、价格方案、使用记录、产品扣费接口 | 钱包与计费 |
| 模型 API 中转 | OpenAI、Claude、Gemini 格式的文本 API，以及视频任务 API；文本转给 uumi，视频转给媒体网关 | 模型中转 |
| Console | 客户后台：公开模型与文档、账户、Key、充值、全平台积分与使用记录 | Console |
| Admin | 员工后台：统一管理入口与平台级管理 | Admin |
不负责什么
- 产品业务：作品、项目、素材、漫剧分镜、电商任务等，归各产品。
- 模型供应：供应商账号、渠道、供应成本，归 uumi 和媒体网关。
- 产品自己的管理功能：作品审核、提示词运营、生成排障等，留在各产品的管理页。
技术栈
| 层 | 选型 |
|---|---|
| 后端 | Go，沿用 new-api 的 Gin + GORM 结构 |
| 数据库 | PostgreSQL；开发和资金集成测试使用隔离的同类数据库 |
| 缓存 | Redis（new-api 用于限流、缓存和会话等） |
| 前端 | Console、Admin 两个 React 应用，基于现有 oceanway-console、oceanway-admin 前端迁入；界面基于 shadcn/ui，沿用 OceanWay 品牌风格 |
| 构建 | 前端构建产物随后端一起打包部署，和 new-api 打包 web/ 的方式一致 |
起点与维护方式
以 new-api 最新版本为起点硬分叉，删掉不需要的部分，此后自主维护，不再合并上游。起点版本、保留和删除范围见 new-api 基线。
当前状态
2026-10-01 已建立产品、开发、实施三组专项文档，并在 platform/oceanway-platform 建立 README、AGENTS 与本仓文档索引。2026-10-02 已执行 T-01，导入官方 new-api rc.41 并建立本机隔离 PostgreSQL/Redis、夹具、构建和启动命令；验证分支为 t01-baseline-environment。没有 OceanWay 远端或正式发布；平台新增业务接口、两前端迁移及资金/身份闭环仍未实现。
按路线图，阶段 1 固定官方基线并隔离验证，阶段 2 形成正式平台并改造。文档与基线环境准备已执行；后续业务任务按 开发任务清单 开始，验证状态见证据索引。
旧的自研 Core、API Edge、Contracts 已冻结，代码在工作区 archive/repos/。其中值得借鉴的设计（价格快照、幂等结算）在钱包与计费中注明。