PLAT-01-001 平台总述
oceanway-platform 的定位、范围、技术栈与当前状态
oceanway-platform 是 OceanWay 唯一的平台服务。所有产品的账号、权限和钱都在这里；开发者的模型 API 也由它直接提供。
专项文档入口
客户端与平台管理端同等重要；核心PRD管理端章节、管理端工作流/设计及AC-10专项分别覆盖员工产品结果、操作体验和验收。
| 文档组 | 用途 |
|---|---|
| 核心产品PRD | 统领用户结果、产品行为、范围和验收预期 |
| 文档体系 | 产品、设计、实现与验收的唯一责任及维护规则 |
| 产品文档 | 定位、首发范围、用户流程、需求编号与验收 |
| 体验与设计 | 页面、两端流程、全状态与交互规格 |
| 开发文档 | 架构、仓库、环境、数据、接口、前端、测试、运行和迁移 |
| 实施与验收 | T-01～T-13 任务、依赖、待定决策与验证证据 |
先读总PRD，再读相关页面/交互规格与需求追踪，按实施任务进入开发；下列模块文档继续作为身份、资金等规则的唯一细则。
负责什么
| 能力 | 说明 | 详细文档 |
|---|---|---|
| 全局登录与权限 | 一处登录、所有产品识别；平台角色与产品角色 | 身份与权限 |
| 积分钱包与计费 | 唯一余额、充值与订单、价格方案、使用记录、产品扣费接口 | 钱包与计费 |
| 模型 API 中转 | OpenAI、Claude、Gemini 格式的文本 API，以及视频任务 API；文本转给 uumi，视频转给媒体网关 | 模型中转 |
| Console | 客户后台：公开模型与标准价、Playground、账户、Key、充值、全平台积分与使用记录；接入文档后续独立建设 | Console |
| Admin | 员工后台：统一管理入口与平台级管理 | Admin |
不负责什么
- 产品业务：作品、项目、素材、漫剧分镜、电商任务等，归各产品。
- 模型供应：供应商账号、渠道、供应成本，归 uumi 和媒体网关。
- 产品自己的管理功能：作品审核、提示词运营、生成排障等，留在各产品的管理页。
技术栈
| 层 | 选型 |
|---|---|
| 后端 | Go，沿用 new-api 的 Gin + GORM 结构 |
| 数据库 | PostgreSQL；开发和资金集成测试使用隔离的同类数据库 |
| 缓存 | Redis（new-api 用于限流、缓存和会话等） |
| 前端 | Console/Admin位于现有React/TypeScript前端；Console沿已设计的oceanway-console迁入，Admin基于new-api原版界面改造、参照旧Admin功能；沿用shadcn/ui及OceanWay品牌 |
| 构建 | 前端构建产物随后端一起打包部署，和 new-api 打包 web/ 的方式一致 |
起点与维护方式
以 new-api 最新版本为起点硬分叉，删掉不需要的部分，此后自主维护，不再合并上游。起点版本、保留和删除范围见 new-api 基线。
当前状态
截至2026-10-13，官方rc.41基线已导入，T-01～T-03完成列明本地验证；正式身份、唯一资金/商业路径、Console/Admin、模型中转和产品接口已有分批实现及证据。console.oceanway.tech 隔离平台已部署，最近只读核对仍为98f9/image426b、Healthy；九型Responses、自动原操作恢复/告警、非零缓存及离机资金恢复按各自制品分项登记，详情见部署与证据索引。T-04～T-10及T-11～T-13适用剩余范围继续跟踪，父任务/完整P0与旧客户承接没有整体结项。
按路线图，Platform线上运行与剩余收尾、Studio分批接入准备并行推进；身份/协议/原请求恢复按产品切片交接。当前工作树另有Chat、Key/资金/迁移与快速开始调整，其与98f9制品的版本边界见证据索引，不把源码存在或旧版验证算作新版全部通过。全量承接la-vps2仍为NO GO，实际切换继续开发任务清单。
旧的自研 Core、API Edge、Contracts 已冻结，代码在工作区 archive/repos/。其中值得借鉴的设计（价格快照、幂等结算）在钱包与计费中注明。