项目初始化

02-用户侧流程/退款流程.md

@@ -0,0 +1,49 @@
+# 退款流程
+
+## 1. 文档目标
+明确用户、商户、平台在退款场景下的申请、审核、回调和状态同步逻辑，避免后续资金链路和责任归属不清。
+
+## 2. 常见退款场景
+- 用户在允许时间内主动取消报名。
+- 商户因赛事关闭、延期、名额调整发起退款。
+- 平台因异常订单、重复扣款、风控问题发起退款。
+
+## 3. 参与角色
+| 角色 | 职责 |
+| --- | --- |
+| 用户 | 提交退款申请、查看退款进度 |
+| 商户 | 审核或发起退款、处理赛事关闭场景 |
+| 平台运营 | 处理异常退款、争议退款、人工复核 |
+| 后台 API | 校验条件、创建退款单、接收回调 |
+| 支付渠道 | 执行实际退款并回传结果 |
+
+## 4. 主流程
+1. 发起退款申请。
+2. 系统校验退款资格、退款金额与责任方。
+3. 创建退款单并进入“待处理”或“退款中”状态。
+4. 调用支付渠道提交退款。
+5. 接收退款回调并更新状态。
+6. 同步更新订单状态、报名状态，并通知用户。
+
+## 5. 异常分支
+- 超出退款时限：拒绝退款。
+- 已核销/已参赛：按规则禁止或需人工处理。
+- 支付渠道退款失败：进入人工复核。
+- 重复退款申请：幂等拦截。
+
+## 6. 状态流转
+| 对象 | 状态 |
+| --- | --- |
+| 退款单 | 待处理 / 退款中 / 退款成功 / 退款失败 / 已关闭 |
+| 订单 | 已支付 / 已退款 / 部分退款（如后续支持） |
+| 报名单 | 已报名 / 已取消 / 已退款 |
+
+## 7. 关键控制点
+- 退款必须记录申请人、审批人、处理时间和原因。
+- 金额计算规则要可追溯。
+- 与支付渠道交互必须幂等与验签。
+
+## 8. 待确认事项
+- 是否允许部分退款。
+- 是否支持按退款责任方区分手续费承担。
+- 用户退款是否都需要商户审核。