# 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` 迁移记录。