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卡和设备补建资产钱包
57 lines
3.0 KiB
Markdown
57 lines
3.0 KiB
Markdown
## 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 从已退回变回待审批
|