文档
产品应用Admin 实施计划

ADM-P05 充值订单、积分处理与商品

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

范围与代码边界

资金写入由 Core 执行授权、持久去重与审计。前端禁重复点击只是交互保护;没有稳定命令和查回协议时,不开放真实补单或积分调整。

需求与接口输入

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

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

任务与交付

ADM-P05.01 · 接入订单定位与支付证据

范围级别:必需。

产品操作CA-A10

前置ADM-P01.03ADM-P02.02CORE-05.06CORE-07.02

实施范围:先按实际 keyword/分页查询,再接精确订单、客户/状态过滤协议;展示人民币实付、权益快照、支付交易号、入账/流水与核对状态。

接口依据CORE-BILL-051

交付物:订单列表/详情、过滤能力表、支付异常线索和证据字段脱敏。

验收场景:未实现过滤不伪装可用;支付记录与入账不一致可定位;订单不存在与读取失败不同,不按回跳参数判断支付成功。

ADM-P05.02 · 实现受控补单与结果恢复

范围级别:必需。

产品操作CA-A11

前置ADM-P05.01CORE-07.03CORE-05.06

实施范围:提交目标订单、理由、证据引用与稳定业务操作标识;展示预期影响,未知时查询原操作,冲突/已处理时按返回回读。具体 DTO 在 Contracts 冻结后接入。

接口依据CORE-BILL-053

交付物:补单受控表单、幂等/未知状态处理、订单与审计回查;不沿用只有 trade_no 就当完整协议。

验收场景:重复提交/响应丢失后仅入账一次;不同请求同幂等标识被拒绝;无证据/无权限不能补单,不以改余额替代订单处理。

ADM-P05.03 · 实现积分增减与账务处置

范围级别:必需。

产品操作CA-A12CA-A16

前置ADM-P05.01CORE-07.03CORE-05.03

实施范围:积分增加/扣减和费用核对分开动作,输入账户、方向、额度、原因、业务依据;只读显示后端前后余额和流水。OW-06 处置未具备恢复语义前只查不写。

接口依据CORE-USER-010CORE-ADMIN-002OW-05OW-06

交付物:调整与核对表单、稳定操作结果查询、审计和账务关联说明。

验收场景:不把覆盖余额冒充增减;并发消费下调整仍由后端原子执行;旧余额不能提交覆盖,新请求不能借重试再次加款。

ADM-P05.04 · 接入充值商品并隔离周期权益

范围级别:充值商品必需;周期订阅待选择。

产品操作CA-A13CA-A14

前置ADM-P04.03CORE-05.04CORE-05.07

实施范围:必需部分定义人民币实付、购买/赠送积分、适用客户、有效期及商品版本;已售订单保留快照。周期订阅选择后再启用编辑/上下架/分配,先完成人民币适配。

接口依据CORE-ADMIN-013CORE-ADMIN-014CORE-BILL-054CORE-BILL-021CORE-BILL-022CORE-BILL-024CORE-BILL-023CORE-BILL-029CORE-BILL-027

交付物:充值商品表单与客户端预览、版本/资格协议;条件订阅的分配和失效说明及开关。

验收场景:改商品不重算旧订单;停售不撤销已购权益;未决定数值不创建真实默认套餐,订阅未选不阻塞充值商品交付。

阶段退出与记录

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

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

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

On this page