huang
f339fb1987
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 7m8s
- client_order: 新增 getOrCreateWallet 兜底，钱包不存在时自动创建 - device_import: 设备导入事务内同步创建设备钱包 - iot_card_import: IoT卡批量导入后批量创建卡钱包 - queue/handler: 传递 AssetWalletStore 给两个导入 handler - migration 000098: 为存量IoT卡和设备补建资产钱包
3.0 KiB
3.0 KiB
ADDED Requirements
Requirement: 发起退款申请接口
POST /api/admin/refunds SHALL 创建退款申请。请求体 MUST 包含 order_id、actual_received_amount、requested_refund_amount、refund_reason。可选 package_usage_id。仅平台用户（user_type IN 1,2）可调用。
Scenario: 成功创建退款申请
- WHEN 平台管理员提交合法的退款申请（关联已支付套餐订单且无进行中的退款记录）
- THEN 系统 SHALL 返回创建成功的退款记录，状态为待审批
Scenario: 订单不可退款
- WHEN 管理员对非已支付订单、充值订单或已有进行中退款记录的订单发起退款
- THEN 系统 SHALL 返回对应错误
Requirement: 退款列表查询接口
GET /api/admin/refunds SHALL 返回分页退款列表，支持按 status、order_id、shop_id 筛选。自动应用数据权限过滤（通过 shop_id 字段）。
Scenario: 按状态筛选退款列表
- WHEN 管理员查询
status=1的退款列表 - THEN 系统 SHALL 返回所有待审批的退款记录，支持分页
Requirement: 退款详情查询接口
GET /api/admin/refunds/:id SHALL 返回退款单详情，包含关联订单信息。
Scenario: 查询退款详情
- WHEN 管理员查询某退款单详情
- THEN 系统 SHALL 返回退款单完整信息（含
commission_deducted和asset_reset标记状态）
Requirement: 审批通过接口
POST /api/admin/refunds/:id/approve SHALL 审批通过退款。请求体可选 approved_refund_amount（不填则等于 requested_refund_amount）和 remark。审批通过后异步触发资产处理和佣金全额回扣。
Scenario: 审批通过并触发副作用
- WHEN 审批人通过退款申请
- THEN 退款状态 SHALL 变为已通过，记录审批人和审批时间
- AND 系统 SHALL 异步执行：失效所有套餐 → 停机 → 世代重置资产 → 更新订单状态为已退款 → 标记
asset_reset=true - AND 系统 SHALL 异步执行：全额回扣该订单所有佣金 → 标记
commission_deducted=true
Requirement: 审批拒绝接口
POST /api/admin/refunds/:id/reject SHALL 拒绝退款。请求体 MUST 包含 reject_reason。
Scenario: 拒绝退款
- WHEN 审批人拒绝退款且填写了拒绝原因
- THEN 退款状态 SHALL 变为已拒绝
Requirement: 退回申请接口
POST /api/admin/refunds/:id/return SHALL 退回退款申请。请求体可选 remark。
Scenario: 退回退款申请
- WHEN 审批人退回退款申请
- THEN 退款状态 SHALL 变为已退回，申请人可重新提交
Requirement: 重新提交接口
POST /api/admin/refunds/:id/resubmit SHALL 重新提交被退回的退款申请。请求体可修改 actual_received_amount、requested_refund_amount、refund_reason。
Scenario: 重新提交退款申请
- WHEN 申请人重新提交被退回的退款
- THEN 退款状态 SHALL 从已退回变回待审批