ADM-P03 客户账户与专属价格绑定
Admin 分阶段实施任务、接口依赖与验收
范围与代码边界
Core 负责客户写入、角色边界、禁用效果和审计;Admin 按 user_id 操作,不直接连接数据库。账户级企业方案不引入多人组织。
需求与接口输入
产品行为引用Admin 操作范围;精确字段与差异见两端 API 映射。以下接口按所关联 CA 操作列出本任务核对范围,不表示每个接口都已挂载或必须同时启用。
设计采用OceanWay 与 shadcn 规范,场景沿用原型任务书。建议目录和交付物是实施要求,实际工程状态见开工基线。
任务与交付
ADM-P03.01 · 接入客户搜索、列表与详情
范围级别:必需。
产品操作:CA-A02
前置:ADM-P01.03、ADM-P02.01、CORE-07.01
实施范围:按实际接口接列表/搜索/详情、分页与脱敏字段;保留目标 user_id 和检索上下文,详情请求取消/排序防止串用户。
接口依据:CORE-USER-002;CORE-USER-011;CORE-USER-003;CORE-USER-006
交付物:客户列表/详情、查询参数及显示字段适配、404/403/空态和未知字段呈现。
验收场景:同名记录稳定定位;普通员工仅见已授权数据;改 URL 不能越权,输入关键词不请求废弃查询端点。
ADM-P03.02 · 接入建客、资料和启停
范围级别:必需。
前置:ADM-P03.01、CORE-07.01、CORE-02.02
实施范围:客户创建和资料编辑分开处理,受控启停明确对象和影响;表单不可带任意权限字段。创建响应丢失按冻结后的查询/幂等语义恢复。
接口依据:CORE-USER-002;CORE-USER-011;CORE-USER-003;CORE-USER-006;CORE-USER-004;CORE-USER-010
交付物:新建/编辑/状态变更表单、目标角色限制说明和写后回读,审计记录关联。
验收场景:客户类型不提升后台权限;重复点击不盲目再建客;停用后会话和模型调用均按 Core 规则拒绝,不能仅改列表颜色。
ADM-P03.03 · 接入企业属性和价格绑定
范围级别:必需。
产品操作:CA-A04
前置:ADM-P03.01、ADM-P04.03、CORE-04.04
实施范围:记录客户名称、类型、内部备注、基础方案、协议覆盖和有效期;绑定与编辑价格内容分开,显示未覆盖回退规则。
接口依据:CORE-USER-006;OW-02;OW-03
交付物:客户价格面板、OW-02/03 适配、保存影响和生效时间说明;备注不进入客户 DTO。
验收场景:过期协议回退可解释;目标账户与方案 ID 不串用;不强制迁移 uumi 客户,也不默认所有企业共享同一折扣。
ADM-P03.04 · 接入客户维度的消费和订单线索
范围级别:必需。
产品操作:CA-A05
实施范围:仅接可精确限定 user_id 的消费、订单和任务查询;订阅按启用状态接入。后端暂缺筛选时保留明确任务缺口和手动业务 ID 定位入口。
接口依据:CORE-USAGE-005;CORE-USAGE-006;CORE-BILL-028
交付物:客户详情子页、精确过滤协议、聚合口径和未知/读取失败状态。
验收场景:客户切换不残留前一人数据;不能拿全站订单当客户订单;无订阅与查询异常区分,分页局部数不当全量总数。
阶段退出与记录
本阶段必需任务的交付物和验收记录齐全,条件项明确是否启用及原因;接口缺口有对应 Core/Contracts 任务。原型走查、真实接口接入和业务联调分开记录。前置任务是本任务真实完成的依赖,设计和明确标识的模拟页面可先行,不据此宣称后端完成。
遇到方法、字段、权限或恢复语义缺口,更新原 CA/GAP 和 Contracts 草案并关联本任务,不在前端猜测补出权威价格、余额或命令结果。
返回 Admin 主计划 · 操作覆盖 · 联合验收。