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