ADM-P04 销售目录、客户价格与版本
Admin 分阶段实施任务、接口依赖与验收
范围与代码边界
销售模型与价格属于 Core,供应渠道和凭据属于网关。Root 定价接口按真实权限使用;新增精细授权由 Core 实现后再调整页面。
需求与接口输入
产品行为引用Admin 操作范围;精确字段与差异见两端 API 映射。以下接口按所关联 CA 操作列出本任务核对范围,不表示每个接口都已挂载或必须同时启用。
设计采用OceanWay 与 shadcn 规范,场景沿用原型任务书。建议目录和交付物是实施要求,实际工程状态见开工基线。
任务与交付
ADM-P04.01 · 接入销售模型与计费规格
范围级别:必需。
产品操作:CA-A06
前置:ADM-P01.03、ADM-P02.01、CORE-04.01
实施范围:维护 model 标识、展示名、能力、计费规格、供应品牌展示元数据和销售状态;模型路由保留 /api/models 与 /api/models/ 的区别。
接口依据:CORE-MODEL-002;CORE-MODEL-003;CORE-MODEL-004;CORE-MODEL-006;CORE-MODEL-009
交付物:模型列表/详情/表单、规格字段与可售/可调用边界说明;禁止携带供应凭据。
验收场景:同名不同 ID 不被覆盖;规格单位对文本/媒体正确;删除/停售遵循后端对已有引用的处理,不误删历史价格依据。
ADM-P04.02 · 接入基础定价与报价预览
范围级别:必需。
产品操作:CA-A08
前置:ADM-P04.01、CORE-04.03、CORE-04.05
实施范围:按 Root 能力接基础规则读取/编辑/预览,输入模型、规格、参数和时间,展示单位、精度、规则版本与有效性;不在浏览器计算权威报价。
接口依据:CORE-BILL-003;CORE-BILL-004;CORE-BILL-006;CORE-BILL-002
交付物:基础价格编辑器与预览结果、错误字段映射及缺价/无权限样例。
验收场景:负值、无效维度和精度错误服务端拒绝;预览不自动保存;旧倍数字段不足时明确补协议,不擅自把多维价压成一个折扣。
ADM-P04.03 · 接入客户覆盖、生效与变更冲突
范围级别:必需。
产品操作:CA-A09
前置:ADM-P04.02、CORE-04.04、CORE-04.05
实施范围:按账户方案配置模型/规格覆盖、起止时间、基础回退与版本;编辑时带后端约定版本控制,保存前展示影响范围,冲突后回读比较而非静默覆盖。
交付物:协议价编辑/预览与版本对比、OW-02/03 Schema 差异及生效说明。
验收场景:两个员工同时编辑有冲突结果;在途调用保持原版本;新价格、Console 本人价与调用计费依据一致;优惠叠加未定不默认相乘。
ADM-P04.04 · 按能力实现目录同步预览
范围级别:按配置启用。
产品操作:CA-A07
实施范围:在来源可信与权限明确后读取同步差异,逐项选择新增/更新项,展示采用范围与部分失败;同步不覆盖客户自定义展示和商业价格。
接口依据:CORE-MODEL-011;CORE-MODEL-010
交付物:预览/采用两步适配、来源版本与结果清单、过期预览处理。
验收场景:只预览不写入;来源变更后重新核对;同步元数据不代表供应可用或自动上架,关闭此功能仍可人工维护目录。
阶段退出与记录
本阶段必需任务的交付物和验收记录齐全,条件项明确是否启用及原因;接口缺口有对应 Core/Contracts 任务。原型走查、真实接口接入和业务联调分开记录。前置任务是本任务真实完成的依赖,设计和明确标识的模拟页面可先行,不据此宣称后端完成。
遇到方法、字段、权限或恢复语义缺口,更新原 CA/GAP 和 Contracts 草案并关联本任务,不在前端猜测补出权威价格、余额或命令结果。
返回 Admin 主计划 · 操作覆盖 · 联合验收。