文档
产品应用Admin 实施计划

ADM-P04 销售目录、客户价格与版本

Admin 分阶段实施任务、接口依赖与验收

范围与代码边界

销售模型与价格属于 Core,供应渠道和凭据属于网关。Root 定价接口按真实权限使用;新增精细授权由 Core 实现后再调整页面。

需求与接口输入

产品行为引用Admin 操作范围;精确字段与差异见两端 API 映射。以下接口按所关联 CA 操作列出本任务核对范围,不表示每个接口都已挂载或必须同时启用。

设计采用OceanWay 与 shadcn 规范,场景沿用原型任务书。建议目录和交付物是实施要求,实际工程状态见开工基线

任务与交付

ADM-P04.01 · 接入销售模型与计费规格

范围级别:必需。

产品操作CA-A06

前置ADM-P01.03ADM-P02.01CORE-04.01

实施范围:维护 model 标识、展示名、能力、计费规格、供应品牌展示元数据和销售状态;模型路由保留 /api/models 与 /api/models/ 的区别。

接口依据CORE-MODEL-002CORE-MODEL-003CORE-MODEL-004CORE-MODEL-006CORE-MODEL-009

交付物:模型列表/详情/表单、规格字段与可售/可调用边界说明;禁止携带供应凭据。

验收场景:同名不同 ID 不被覆盖;规格单位对文本/媒体正确;删除/停售遵循后端对已有引用的处理,不误删历史价格依据。

ADM-P04.02 · 接入基础定价与报价预览

范围级别:必需。

产品操作CA-A08

前置ADM-P04.01CORE-04.03CORE-04.05

实施范围:按 Root 能力接基础规则读取/编辑/预览,输入模型、规格、参数和时间,展示单位、精度、规则版本与有效性;不在浏览器计算权威报价。

接口依据CORE-BILL-003CORE-BILL-004CORE-BILL-006CORE-BILL-002

交付物:基础价格编辑器与预览结果、错误字段映射及缺价/无权限样例。

验收场景:负值、无效维度和精度错误服务端拒绝;预览不自动保存;旧倍数字段不足时明确补协议,不擅自把多维价压成一个折扣。

ADM-P04.03 · 接入客户覆盖、生效与变更冲突

范围级别:必需。

产品操作CA-A09

前置ADM-P04.02CORE-04.04CORE-04.05

实施范围:按账户方案配置模型/规格覆盖、起止时间、基础回退与版本;编辑时带后端约定版本控制,保存前展示影响范围,冲突后回读比较而非静默覆盖。

接口依据OW-02OW-03OW-01

交付物:协议价编辑/预览与版本对比、OW-02/03 Schema 差异及生效说明。

验收场景:两个员工同时编辑有冲突结果;在途调用保持原版本;新价格、Console 本人价与调用计费依据一致;优惠叠加未定不默认相乘。

ADM-P04.04 · 按能力实现目录同步预览

范围级别:按配置启用。

产品操作CA-A07

前置ADM-P04.01CORE-04.06

实施范围:在来源可信与权限明确后读取同步差异,逐项选择新增/更新项,展示采用范围与部分失败;同步不覆盖客户自定义展示和商业价格。

接口依据CORE-MODEL-011CORE-MODEL-010

交付物:预览/采用两步适配、来源版本与结果清单、过期预览处理。

验收场景:只预览不写入;来源变更后重新核对;同步元数据不代表供应可用或自动上架,关闭此功能仍可人工维护目录。

阶段退出与记录

本阶段必需任务的交付物和验收记录齐全,条件项明确是否启用及原因;接口缺口有对应 Core/Contracts 任务。原型走查、真实接口接入和业务联调分开记录。前置任务是本任务真实完成的依赖,设计和明确标识的模拟页面可先行,不据此宣称后端完成。

遇到方法、字段、权限或恢复语义缺口,更新原 CA/GAP 和 Contracts 草案并关联本任务,不在前端猜测补出权威价格、余额或命令结果。

返回 Admin 主计划 · 操作覆盖 · 联合验收

On this page