决策与待定事项
新架构的有效决策与尚待确定的实现选择
当前实现决定
D-NEWAPI-REUSE-FIRST：大部分代码和接口优先直接复用 new-api，当前技术栈完全一致；按多仓职责迁入，仅补职责拆分和业务差异。D-CORE-EDGE-PRIORITY：现在重点开展 Core 与 API Edge，既有产品需求与原型作为配套输入，不等待全量页面完成。来源为 2026-09-12 当前用户明确要求。
最新最终决定
D-RESTORE-FIRST-POLYREPO：2026-09-12 用户明确恢复最初多仓设计、代码重点参考 new-api，直接修改第一版文档。替代单体二开与 Core/Edge 内部模块建议；独立网关和后续产品商业决定继续有效。原始第一版结构恢复，不据此恢复旧代码或旧验收。
已确认
| 决策 ID | 内容 |
|---|---|
| D-GLOBAL-LOGIN | 任一 OceanWay 平台登录，全平台共享同一用户登录状态；平台权限分别校验 |
| D-LOCAL-FIRST | 三人团队、用户负责开发，本机协调优先，计划与设计不依赖 GitHub Issue |
| D-DUAL-PRODUCT-LINES | 创作者线和开发者线都要完成 |
| D-NEWAPI-FOUNDATION | 以官方 new-api 后台能力为基础建设平台 |
| D-NEWAPI-BACKEND-ONLY | 上游前端可以全部重做，不约束 OceanWay 前端 |
| D-DEVELOPER-PUBLIC | Developer 公开；全部登录后的管理放 Console |
| D-NEWAPI-CLEAN-RESTART | 原先建立的官方固定工作区保留为源码参考；最终服务按多仓实现，旧代码不自动恢复 |
| D-DOCS-V2 | 曾按候选方向重组文档；当前目录已按最终决定恢复第一版并修订，候选方案归档 |
| D-UI-SHADCN | 原型使用 shadcn，沿用 OceanWay 风格；客户页面参考 new-api 二次修改 |
| D-KEY-COPY | 掩码旁复制按钮直接获取完整 Key 并复制 |
| D-CNY-CREDITS | 人民币充值、系统内积分；具体套餐待定 |
| D-ENTERPRISE-ACCOUNT | 企业专属账户与协议价，首期不做多人协作 |
| D-UNIFIED-CUSTOMER-PLATFORM | 零售迁入新平台，sub2api 迁移后退役；模型对接客户是否迁入按 D-CUSTOMER-SEGMENTS 单列，不再强制所有客户迁入 |
| D-CUSTOMER-SEGMENTS | 零售、FDE、模型对接为三类客户；前两类消费倍率 1、充值非 1:1，模型对接客户在 uumi 充值 1:1、多组多倍率 |
| D-GATEWAY-UPSTREAM-BOUNDARY | 独立 new-api 网关无终端客户，供 OceanWay 模型调用并跟随上游升级；客户平台独立定制 |
| D-POLYREPO-NEWAPI-STACK | 多仓同栈方向恢复有效；Core/Edge/Contracts 分仓，独立网关原则保留 |
记录来源为当前统筹会话及本机 coordination/decisions.md。旧 B0–B6 和 ADR-028–032 是历史设计；不能将其中 Core、Edge、Contracts 的旧依赖直接作为新方案前置条件。
三类客户背景与本轮讨论已固化到客户定价。零售与 FDE 进入统一平台、模型对接客户暂留 uumi 是当前推荐方案；模型对接客户最终迁移选择、旧价承诺范围及具体套餐仍待定。
待设计或待选择
- 全局登录已确认；域名部署、交接协议、访问令牌生命周期、撤销时限与服务调用上下文仍待设计。
- 组织、项目协作需要哪些权限，哪些产品先使用。
- 各仓实际工作树、分支与部署实例映射；Core/Edge/Contracts 分仓已确定，不再作为待选择项。
- 自研媒体网关的真实端点、输入／状态／费用映射与取消能力。
- 首期模型、定价规则、产品功能范围和目标容量。
- 后续正式域名调整、历史账号和业务数据处理。
这些事项进入对应需求或设计包，不用空值或推测伪装定案。修改一项决定时记录替代关系、受影响页面／接口和验证要求。
D-CONTRACTS-CONTENT-REPLACEMENT
2026-09-12 用户决定保留原仓库结构、整体替换旧 Contracts 内容。保留 Git 历史与目录职责；当前契约以固定 new-api 原接口和 OceanWay 必要差异重新建立，不继承旧包的过期协议限制。新工作树为本地候选，旧发布和消费者尚未切换。