历史档案候选与单体方案快照平台架构
模块与数据归属
现成能力、需要扩展的能力与唯一写入方
历史方案:本页为恢复第一版多仓文档前的快照,不是现行任务或已实现能力。现行入口为平台架构。
现行方案见直接改造 new-api:身份、Key、价格、积分、API 接入与客户任务均归 oceanway-platform 内部模块;供应适配归独立网关。API 规范先在平台仓维护。
当前模块边界
以独立网关与客户平台为现行职责:下表中的身份、客户 Key、商业与积分归 OceanWay;真实供应渠道、供应任务与网关运维归独立 new-api 网关;平台保留已有 Relay 作为到内部网关的接入链路。两边可有共同上游代码来源,不共享数据库或终端客户钱包。
上游能力来源
| 模块 | 上游实现入口 | 数据责任 |
|---|---|---|
| 身份与会话 | auth_session / user_session / auth middleware | 用户身份、会话有效性、撤销 |
| API 访问 | Token 路由与鉴权 | 用户 Key、模型访问、调用限制 |
| 商业与额度 | billing_session / funding_source / quota_reserve / subscription | 预扣、消费调整、额度、订阅 |
| 模型供应与调用 | relay / relaykit / channels | 文本调用与实际供应关联 |
| 供应任务接入 | task plugin / task_polling / task_billing | 网关执行任务与结果;OceanWay 另存客户关联并结算客户积分 |
| 运营与审计 | authz / logs / system tasks | 后台授权、操作与运行记录 |
这些是源码已有能力,是否满足 OceanWay 完整语义仍需集成验证。
OceanWay 扩展
产品、组织/项目成员、资产权限、跨步骤流程和用户结果选择不能直接等价为 new-api 的用户分组或单次 Task。按需求添加模块,通过应用服务或明确 API 使用上表能力。
| 对象 | 唯一写入方 | 其他模块如何使用 |
|---|---|---|
| 客户余额和消费 | 共享后台计费模块 | 查询或受控命令,不另建可独立扣费副本 |
| Key 与会话 | 共享身份/访问模块 | 验证身份并取得允许的上下文 |
| 供应商任务 | 对应网关 | 保存不透明关联 ID,不跨服务改任务表 |
| 创作项目和正式选择 | 产品业务模块 | 引用结果与资产 |
| 文件与访问授权 | 资产模块,具体部署待定 | 取得有时效、受权限约束的访问方式 |
一个服务可以包含多个模块;数据归属不取决于仓库数量。缓存用于加速时,应明确失效和恢复规则,不能另成一份未核对的余额或权限。