qipai/docs/db-changelog/2026-06-24-M07-C-benefits.md

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