Console 操作覆盖与接入顺序
产品操作、实施任务、API 与 Core 前置的完整映射
如何读取覆盖关系
Console 共 19 项产品操作、8 个阶段、32 项任务。保留 CA-C/CA-A 产品操作与 CON-P/ADM-P 实施阶段编号;小数编号是可执行任务。表中不重写产品需求或接口 Schema,而是定位实施归属与后端依赖。
“首期复用/适配”说明上游参考来源,不代表当前 Core 或前端已完成。“按配置/待选择”项目不默认启用;一项操作可能分成必需与条件接口,以任务和 Core 覆盖表的细分范围为准。
操作到任务
每项操作的 API ID、方法/路径、来源页、Core 归属与运行基线可在完整实施映射 JSON查询;所有操作同时包含原型/验收等关联任务。此文件是计划台账,不是 OpenAPI,也不生成 SDK。
当前可接入范围
可先真实接入登录、self、刷新/退出、会话列表/单条撤销和单 Key 生命周期。注册恢复、批量 Key、本人价格、钱包、用量和全局交接等仍有 Core 前置。现有 self 仅身份字段,不能读取虚构余额。
完整事实和验证边界见两端开工基线与Core 开工基线。本次只细化文档,没有搭建两端前端或新增后端路由。
开发顺序与任务完成口径
CON-P01.01/02 → CON-P02.01/02 → CON-P03.01/02/03,先交付登录与单 Key 真实切片;CON-P06.03 跟随 CORE-03 接全局登录;价格/消费与钱包再按 CORE-04/05/06/07 就绪顺序推进。
开发由用户一人负责,按小批次切换任务;不以阶段编号推定所有阶段必须整体串行,也不要求三人并行开发。原型可在精确接口未就绪前先表达流程,真实接入必须有 DTO、授权、错误和恢复样例。
每个任务分别登记:需求/字段已明确 → 原型可走查 → 真实 API 已接入 → 异常与权限已验证。发布另按首发能力表验收;不以“页面完成”替代业务完成。执行状态只在 progress 与 coordination/workboard.json 更新。
需要明确关闭的协议缺口
| 缺口 | 前端处理要求 | 归属 |
|---|---|---|
| GAP-01/05:跨站身份和业务上下文 | 同一用户身份、允许返回目标、兑换响应丢失恢复;内部兑换不交给浏览器 | CORE-03,CON-P06.03 / ADM-P07.04 |
| GAP-02:Key 创建无 ID / 响应未知 | 成功回列表选定记录,未知不自动重建,不按同名猜 Key | CORE-02,CON-P03.02/03 |
| GAP-09:有效价、覆盖与版本 | 客户本人/指定账户预览/历史快照分别返回,不能前端猜价 | CORE-04,CON-P04 / ADM-P04 |
| GAP-03/10:精确订单、补单与调整恢复 | 稳定业务标识、请求绑定、授权/理由/证据、结果查询;写操作未知先查回 | CORE-05/07,CON-P05 / ADM-P05 |
| GAP-05/06/07:查询、筛选与任务命令 | 不支持的筛选不承诺全量聚合;查询与恢复命令分开 | CORE-06/07/08,CON-P04/07 / ADM-P06 |
| GAP-04/08/11:实际授权与商业配置 | 后端白名单、版本冲突/生效范围、商品和周期权益分离 | CORE-04/05/07,ADM-P05/07 |