PLAT-04-003 仓库与代码结构
new-api 基线导入、目标目录与审计删减约定
基线导入
2026-10-02 platform/oceanway-platform 已在验证分支 t01-baseline-environment 导入官方 new-api rc.41，完整 SHA 为 2035a82aeb5414253a728bd937d4b8f97aa99b9b；保留本地入口和上游许可证材料，详见平台 docs/baseline.md。阶段 1 使用此隔离基线开展审计与闭环验证；阶段 2 将已验证基线及必要扩展纳入正式平台。避免在已有文档目录上执行覆盖式 clone；先建立临时目录、核对来源，再合入本地入口。
导入时记录官方仓库 URL、标签、完整 SHA、导入时间、许可证/NOTICE、工具链和依赖锁文件；实际源码与版本必须一致。文档中的历史标签、references/new-api 或 uumi 分支不能冒充新基线。保留上游版权与许可证材料，对外源码供给安排按项目许可要求处理。
目标结构
以下为截至2026-10-13的实际主要目录；完整源码和启动入口以平台仓库README、锁文件与唯一契约为准，后续改造沿这些目录推进。
platform/oceanway-platform/
├─ README.md 实际启动与文档链接
├─ AGENTS.md 本仓开发约束
├─ main.go 沿用基线应用入口
├─ router/ 公共 API、内部产品接口和管理路由
├─ middleware/ 会话、Key、CSRF、角色和产品授权
├─ controller/ 请求/响应，不直接改余额
├─ service/ 身份、定价、记账、支付与恢复
├─ model/ 基线模型及平台扩展
├─ relay/ 协议及两个上游的接入
├─ ... 基线实际需要的其他包
├─ migrations/ 可审计数据库变更
├─ web/
│ └─ src/
│ ├─ features/platform/ Console/Admin及平台API客户端
│ ├─ components/ 既有基础与原生组件
│ └─ routes/ TanStack路由
├─ docs/
│ ├─ README.md 唯一产品/开发文档入口
│ ├─ baseline.md 基线 SHA 与代码审计事实
│ ├─ openapi/ 自有接口契约及兼容性说明
│ └─ verification/ 脱敏证据索引
├─ testdata/ 协议、支付和故障夹具
├─ scripts/ 从干净检出运行的检查/构建脚本
└─ .local/ 私有运行/冻结制品与诊断（不入Git）Console/Admin运行于同一 web/ 和Go嵌入服务，不新建独立前端/BFF。10-11私有GitHub首快照及随后dirty源码冻结部署分开追踪；当前已验证98f9制品与后续工作树差异见证据索引。部署编排以Infrastructure为唯一源，平台仓库不复制第二套生产编排。
审计删减
先给每项列出调用点、路由、中间件、用量解析、资金/Key 额度、测试与迁移影响，再决定保留/删除。优先保留可运行基线完成验证，不先批量删除适配器。替换旧 web/ 前确认两套前端可构建、资源路径和 API 路由互不遮盖。
OAuth、任务、价格和角色的既有代码均需按所选 SHA 验证。删除列表见new-api 基线，审计结果应能指出真实路径和测试结果。
本仓文档边界
仓库 README 写“实际如何运行”；docs/baseline.md 写“实际导入了什么”；OpenAPI 写“实际承诺的接口”；验证索引写“实际跑了什么”。PRD、架构方案、计划和进度不在本仓重写。自动生成文件从生成命令更新，密钥、支付凭证和生产导出不入 Git。