Admin 操作覆盖与接入顺序
产品操作、实施任务、API 与 Core 前置的完整映射
如何读取覆盖关系
Admin 共 20 项产品操作、8 个阶段、32 项任务。保留 CA-C/CA-A 产品操作与 CON-P/ADM-P 实施阶段编号;小数编号是可执行任务。表中不重写产品需求或接口 Schema,而是定位实施归属与后端依赖。
“首期复用/适配”说明上游参考来源,不代表当前 Core 或前端已完成。“按配置/待选择”项目不默认启用;一项操作可能分成必需与条件接口,以任务和 Core 覆盖表的细分范围为准。
操作到任务
| 产品操作 | 产品范围 | 具体实施任务 | Core 接口归属任务 |
|---|---|---|---|
| CA-A01 用量统计与异常定位入口 | 首期适配 | ADM-P06.01 | CORE-07.02 |
| CA-A02 搜索、创建和读取客户 | 首期复用 | ADM-P03.01、ADM-P03.02 | CORE-07.01 |
| CA-A03 资料编辑与启停账户 | 首期适配 | ADM-P03.02 | CORE-07.01 |
| CA-A04 企业属性、协议价绑定与有效期 | 首期补齐 | ADM-P03.03 | CORE-07.01、CORE-04.04 |
| CA-A05 查看该客户消费及订阅线索 | 首期适配 | ADM-P03.04 | CORE-07.02、CORE-05.07 |
| CA-A06 客户模型元数据编辑、查询 | 首期适配 | ADM-P04.01 | CORE-04.01 |
| CA-A07 同步预览与采用范围 | 按配置启用 | ADM-P04.04 | CORE-04.06 |
| CA-A08 读取、编辑和预览基础价格 | 首期适配 | ADM-P04.02 | CORE-04.03、CORE-04.05、CORE-04.02 |
| CA-A09 企业覆盖、有效期和价格版本 | 首期补齐 | ADM-P04.03 | CORE-04.04、CORE-04.05 |
| CA-A10 查询订单及支付异常线索 | 首期复用 | ADM-P05.01 | CORE-07.02 |
| CA-A11 有支付证据的补单 | 首期补齐 | ADM-P05.02 | CORE-07.03 |
| CA-A12 加减积分与调整记录 | 首期补齐 | ADM-P05.03 | CORE-07.01、CORE-07.04 |
| CA-A13 人民币金额、积分权益与适用客户 | 首期补齐 | ADM-P05.04 | CORE-07.04、CORE-05.04 |
| CA-A14 套餐编辑、上下架与分配 | 待产品选择 | ADM-P05.04 | CORE-05.07 |
| CA-A15 按请求和任务定位异常 | 首期适配 | ADM-P06.02 | CORE-07.02 |
| CA-A16 跨产品关联与费用核对 | 首期补齐 | ADM-P05.03、ADM-P06.03 | CORE-07.02、CORE-07.03 |
| CA-A17 当前能力和受控授权 | 首期适配 | ADM-P07.01、ADM-P07.04 | CORE-07.01、CORE-02.01 |
| CA-A18 查询操作、对象和结果 | 首期复用 | ADM-P06.04 | CORE-07.04 |
| CA-A19 站点、认证、支付能力 | 首期适配 | ADM-P07.02 | CORE-07.04 |
| CA-A20 跳转独立网关后台 | 外部网关 | ADM-P07.03 | 外部入口/条件方案,见具体任务 |
每项操作的 API ID、方法/路径、来源页、Core 归属与运行基线可在完整实施映射 JSON查询;所有操作同时包含原型/验收等关联任务。此文件是计划台账,不是 OpenAPI,也不生成 SDK。
当前可接入范围
可使用已有登录/self 设计身份接入,但客户管理、后台授权目录、价格、订单、审计等运营接口尚未挂载在现有 Core。Admin 主体先做权限/字段设计和原型,按 Core 任务交付逐批接入;不能连接参考网关来假装客户后台已完成。
完整事实和验证边界见两端开工基线与Core 开工基线。本次只细化文档,没有搭建两端前端或新增后端路由。
开发顺序与任务完成口径
ADM-P01.01/02/04 → ADM-P02.01/02,先明确权限和客户/财务原型;ADM-P01.03 与 ADM-P03.01/02 跟随 CORE-07.01;ADM-P04 按 CORE-04 分批,资金操作等待 CORE-05 与 CORE-07.03。
开发由用户一人负责,按小批次切换任务;不以阶段编号推定所有阶段必须整体串行,也不要求三人并行开发。原型可在精确接口未就绪前先表达流程,真实接入必须有 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 |