历史档案候选与单体方案快照项目总览
决策与待定事项
新架构的有效决策与尚待确定的实现选择
历史方案:本页为恢复第一版多仓文档前的快照,不是现行任务或已实现能力。现行入口为平台架构。
现行完整方案见 OceanWay 最终方案 v1.1,统一规定源码提取、服务边界、数据归属、部署与实施顺序。此前未收敛的技术建议以该方案为准;商业数值仍按实际决定填写。
已确认
| 决策 ID | 内容 |
|---|---|
| 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-GATEWAY-UPSTREAM-BOUNDARY | 独立 new-api 网关无终端客户,供 OceanWay 模型调用并跟随上游升级;客户平台独立定制 |
| D-POLYREPO-NEWAPI-STACK | 先前提出多仓同栈方向;最新用户倾向直接改造以降低复杂度,现行方案将 Core/Edge 收回平台内部,独立网关原则保留 |
记录来源为当前统筹会话及本机 coordination/decisions.md。旧 B0–B6 和 ADR-028–032 是历史设计;不能将其中 Core、Edge、Contracts 的旧依赖直接作为新方案前置条件。
最新方案收敛
用户提出直接改造 new-api 更快;最终方案据此推荐客户后台先保持单体,复用现成调用和计费链路。该工程建议已记录,不将具体商业数值或生产切换视为已批准。
待设计或待选择
- 子站登录交接、访问令牌生命周期及用户/服务调用上下文。
- 组织、项目协作需要哪些权限,哪些产品先使用。
- 产品业务服务与共享后台的进程和仓库布局;不预设必须回到 14 仓或全部合仓。
- 自研媒体网关的真实端点、输入/状态/费用映射与取消能力。
- 首期模型、定价规则、产品功能范围和目标容量。
- 后续正式域名调整、历史账号和业务数据处理。
这些事项进入对应需求或设计包,不用空值或推测伪装定案。修改一项决定时记录替代关系、受影响页面/接口和验证要求。