PLAT-04-001 平台开发文档
从代码基线到接口、数据、前端、测试和发布的开发入口
开发入口先读核心PRD，确定PL子行为，再读取页面与交互规格、需求追踪与相关架构/契约。已有代码不得反向定义产品范围。
本组文档给 oceanway-platform 的实际开发提供约束与实施依据。产品要求见产品文档，具体任务见实施计划。截至2026-10-13，官方rc.41源码及T-01～T-03列明本地验证已完成；正式身份/账务/商业/页面与产品接口已有分批实现，T-10隔离联调环境已部署。最近已核制品为98f9/image426b，当前工作树的后续Chat、Key/资金/迁移和快速开始变更另按证据索引交接；T-04～T-13适用剩余范围、完整首发与旧客户迁移继续跟踪。实际命令/契约/测试证据在平台仓库；以下设计不得自动算作已验收能力。
| 文档 | 内容 |
|---|---|
| 架构与模块 | 调用链、模块边界、鉴权及持久恢复 |
| 仓库与代码结构 | 基线导入、目录、删减与源码记录 |
| 本地开发环境 | 启动依赖、隔离配置和可重复开发要求 |
| 数据与状态 | 逻辑实体、唯一约束、资金事务、任务状态 |
| 接口设计 | 主体、操作语义、错误、版本和契约 |
| Console 与 Admin 迁移 | 现有前端保留、API 改接和旧依赖退出 |
| 测试与验证 | 协议、权限、资金、故障、证据与 CI |
| 运行与发布 | 配置、恢复、监控、备份与发布 |
| 迁移与切换 | 前端、产品与历史客户迁移门槛 |
每项开发的完成条件
PRD子行为与页面/交互预期明确 → 需求和任务编号明确 → 先读基线相关代码 → 更新唯一接口契约与数据迁移 → 实现并验证后端权限/资金约束 → 页面改接及回读 → 保存证据 → 更新实际进度。文档中的建议不能在没有审计的情况下直接变成已验证能力。
开发中优先复用 new-api 已有结构和可验证代码。新功能加入同一 Go 服务，不恢复 Core/Edge/Contracts 多仓，也不为清理目录先做全面重写。Go/React 工具链与启动命令以最终导入基线和锁文件为准；现有 go.mod、锁文件与运行脚本来自已导入的真实基线；不另造未验证入口。
文档分工
需求、架构、决策、计划和进度在 oceanway-docs。平台仓库保存实际运行说明、源码基线、OpenAPI、数据库迁移、测试夹具和脱敏验证证据索引。新增接口以平台仓库 OpenAPI 为契约源，本组文档解释语义并链接契约，不另建 Contracts 仓库。