1398281322-a11y/java-backend-guardrails / skills/java-backend-guardrails/refund-aftersale
refund-aftersale
VerifiedUse when implementing 售后, 仅退款, 退货退款, 退库存, 退优惠券, reverse order flow. Do not reuse 正向下单代码硬改状态. Payment callback idempotency is backend-idempotent.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.7 KB |
SKILL.md
View on GitHub---
name: refund-aftersale
description: Use when implementing 售后, 仅退款, 退货退款, 退库存, 退优惠券, reverse order flow. Do not reuse 正向下单代码硬改状态. Payment callback idempotency is backend-idempotent.
---
# 售后 / 逆向
## When to Invoke
未发货退款、已发货退货退款、部分退、退库存、退券、退分佣。电商面试:「正向和逆向怎么走」。
## When NOT
支付回调入账 → `idempotent`。订单正向跳转 → `order-state`。对账 → `reconciliation`。
## 风险(面试考点)
逆向不是 `status=REFUND` 一行改完。要按 **是否已发货 / 是否已核销** 分路径。重复退款、库存加回两次、券退回后被已使用订单再占用,都是资损。
售后单自己做状态机,不要和订单状态搅在一个字段里打补丁。
## 方案选型(轻量优先)
| 场景 | 默认路径 |
|------|----------|
| 未发货仅退款 | 售后单 → 调渠道退款 → 回调成功 → 订单 PAID→REFUNDED,释放预占,券 LOCKED/USED 按规则回退 |
| 已发货退货 | 审核 → 用户寄回 → 确认收货 → 再退款 |
| 已核销(票务) | 通常不能原路退库存名额,走废票/人工规则 |
| 部分退 | 按订单行退,不整单关 |
退款调用渠道:同一 `refundNo` 重试,禁止每次新单号。超时查单,见 `rpc-remote`。
## 默认方案
```text
t_aftersale: aftersale_no uk, order_no, type, status, refund_amount
允许:CREATED → APPROVED → REFUNDING → REFUNDED
CREATED → REJECTED
退款回调:uk(refund_no, channel)
```
```java
int n = aftersaleMapper.update(null, Wrappers.<Aftersale>lambdaUpdate()
.set(Aftersale::getStatus, "REFUNDED")
.eq(Aftersale::getAftersaleNo, no)
.eq(Aftersale::getStatus, "REFUNDING"));
if (n == 1) {
releaseStockOnce(orderNo); // 流水 uk
unlockCouponOnce(orderNo);
orderMapper.update(..., .eq(Order::getStatus, "PAID")); // 整单退
}
```
库存释放用 `inventory-occupy` 的释放流水。分佣已入账要记负向流水,不要 delete。
## 反例
错误:退款成功直接 `stock++`,回调重试加两次。
正确:释放流水唯一键。
错误:已发货仅退款不走仓库,货还在路上钱已退。
正确:分路径。
错误:把订单从 COMPLETED 直接改 CLOSED。
正确:售后单推进,订单到 REFUNDED/PARTIAL_REFUND。
## 验证
- 同一退款回调 10 次,钱只退一次、库存只加一次。
- 未发货退款后可售恢复;已核销票按规则不恢复或走废票。
- 正向 PAID 与售后 REFUNDING 并发,状态机不丢钱。
## 评审清单
- [ ] 售后单独立状态机
- [ ] 退款单号稳定可重试
- [ ] 回库存/回券有流水
- [ ] 发货前后路径分开
---
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |