docs(M07-C): 记录权益核销验收并推进会员管理

2026-06-24 15:46:43 +08:00
parent 4ae9296f83
commit 239ef4dcf1
6 changed files with 69 additions and 15 deletions
@@ -0,0 +1,25 @@
+# M07-C benefits
+
+- 工程 commit：`4ae9296`
+- 迁移文件：
+  - `database/migrations/2026062423_m07c_benefits.up.sql`
+  - `database/migrations/2026062423_m07c_benefits.down.sql`
+  - `database/migrations/2026062423_m07c_benefits.verify.sql`
+
+## 新增表
+
+- `qipai_coupon_templates`：优惠券模板，包含券类型、满减金额、时长、最低消费、门店/房型/房间/星期/节假日适用范围、有效期和使用次数。
+- `qipai_coupon_grants`：用户持券，记录券码、有效期、剩余次数、冻结订单和使用状态。
+- `qipai_package_plans`：套餐计划，记录售价、总时长、总金额和适用范围。
+- `qipai_package_holdings`：用户持有套餐，记录剩余时长/金额、冻结订单、有效期和状态。
+- `qipai_benefit_usages`：订单权益核销流水，记录优惠券或套餐对订单的冻结、确认和退回。
+
+## 约束与索引
+
+- `uq_qipai_coupon_grant_code (tenant_id, coupon_code)` 保证券码租户内唯一。
+- `uq_qipai_benefit_usage_request (tenant_id, user_id, client_request_id)` 保证客户端重复请求幂等。
+- `uq_qipai_benefit_usage_order_benefit (tenant_id, order_id, benefit_type, benefit_id)` 防止同一订单重复冻结同一权益。
+
+## 回滚
+
+down 迁移按依赖顺序删除权益核销流水、套餐持有、套餐计划、持券和优惠券模板，并移除 `2026062423` 迁移记录。