ADM-P05 充值订单、积分处理与商品
Admin 分阶段实施任务、接口依赖与验收
范围与代码边界
资金写入由 Core 执行授权、持久去重与审计。前端禁重复点击只是交互保护;没有稳定命令和查回协议时,不开放真实补单或积分调整。
需求与接口输入
产品行为引用Admin 操作范围;精确字段与差异见两端 API 映射。以下接口按所关联 CA 操作列出本任务核对范围,不表示每个接口都已挂载或必须同时启用。
设计采用OceanWay 与 shadcn 规范,场景沿用原型任务书。建议目录和交付物是实施要求,实际工程状态见开工基线。
任务与交付
ADM-P05.01 · 接入订单定位与支付证据
范围级别:必需。
产品操作:CA-A10
前置:ADM-P01.03、ADM-P02.02、CORE-05.06、CORE-07.02
实施范围:先按实际 keyword/分页查询,再接精确订单、客户/状态过滤协议;展示人民币实付、权益快照、支付交易号、入账/流水与核对状态。
接口依据:CORE-BILL-051
交付物:订单列表/详情、过滤能力表、支付异常线索和证据字段脱敏。
验收场景:未实现过滤不伪装可用;支付记录与入账不一致可定位;订单不存在与读取失败不同,不按回跳参数判断支付成功。
ADM-P05.02 · 实现受控补单与结果恢复
范围级别:必需。
产品操作:CA-A11
前置:ADM-P05.01、CORE-07.03、CORE-05.06
实施范围:提交目标订单、理由、证据引用与稳定业务操作标识;展示预期影响,未知时查询原操作,冲突/已处理时按返回回读。具体 DTO 在 Contracts 冻结后接入。
接口依据:CORE-BILL-053
交付物:补单受控表单、幂等/未知状态处理、订单与审计回查;不沿用只有 trade_no 就当完整协议。
验收场景:重复提交/响应丢失后仅入账一次;不同请求同幂等标识被拒绝;无证据/无权限不能补单,不以改余额替代订单处理。
ADM-P05.03 · 实现积分增减与账务处置
范围级别:必需。
前置:ADM-P05.01、CORE-07.03、CORE-05.03
实施范围:积分增加/扣减和费用核对分开动作,输入账户、方向、额度、原因、业务依据;只读显示后端前后余额和流水。OW-06 处置未具备恢复语义前只查不写。
接口依据:CORE-USER-010;CORE-ADMIN-002;OW-05;OW-06
交付物:调整与核对表单、稳定操作结果查询、审计和账务关联说明。
验收场景:不把覆盖余额冒充增减;并发消费下调整仍由后端原子执行;旧余额不能提交覆盖,新请求不能借重试再次加款。
ADM-P05.04 · 接入充值商品并隔离周期权益
范围级别:充值商品必需;周期订阅待选择。
前置:ADM-P04.03、CORE-05.04、CORE-05.07
实施范围:必需部分定义人民币实付、购买/赠送积分、适用客户、有效期及商品版本;已售订单保留快照。周期订阅选择后再启用编辑/上下架/分配,先完成人民币适配。
接口依据:CORE-ADMIN-013;CORE-ADMIN-014;CORE-BILL-054;CORE-BILL-021;CORE-BILL-022;CORE-BILL-024;CORE-BILL-023;CORE-BILL-029;CORE-BILL-027
交付物:充值商品表单与客户端预览、版本/资格协议;条件订阅的分配和失效说明及开关。
验收场景:改商品不重算旧订单;停售不撤销已购权益;未决定数值不创建真实默认套餐,订阅未选不阻塞充值商品交付。
阶段退出与记录
本阶段必需任务的交付物和验收记录齐全,条件项明确是否启用及原因;接口缺口有对应 Core/Contracts 任务。原型走查、真实接口接入和业务联调分开记录。前置任务是本任务真实完成的依赖,设计和明确标识的模拟页面可先行,不据此宣称后端完成。
遇到方法、字段、权限或恢复语义缺口,更新原 CA/GAP 和 Contracts 草案并关联本任务,不在前端猜测补出权威价格、余额或命令结果。
返回 Admin 主计划 · 操作覆盖 · 联合验收。