qipai/docs/db-changelog/2026-06-25-M08-B-cleaning.md

2026-06-25 M08-B 保洁端数据库变更

新增迁移

• database/migrations/2026062525_m08b_cleaner_tasks.up.sql
• database/migrations/2026062525_m08b_cleaner_tasks.down.sql
• database/migrations/2026062525_m08b_cleaner_tasks.verify.sql
• database/migrations/2026062626_m08b_cleaning_settlements.up.sql
• database/migrations/2026062626_m08b_cleaning_settlements.down.sql
• database/migrations/2026062626_m08b_cleaning_settlements.verify.sql

新增表

• qipai_cleaning_tasks

  • 保洁任务主表，包含租户、门店、房间、订单、任务号、状态、保洁员、奖励金额、要求、照片 URL、驳回原因和关键时间戳。
  • 状态约束：WAITING、CLAIMED、STARTED、SUBMITTED、COMPLETED、REJECTED、EXEMPT、SETTLED、CANCELLED。
  • 唯一约束：租户内任务号唯一；订单关联唯一。
  • 索引：任务大厅、保洁员任务、房间任务。

• qipai_cleaning_task_events

  • 保洁任务状态事件表，记录 from/to 状态、动作、操作人、trace、备注和 metadata。
  • 租户、任务、trace 唯一，便于幂等追踪。

• qipai_cleaning_settlements

  • 保洁结算单主表，包含结算号、保洁员、门店、状态、任务数、总奖励金额、结算周期、生成人、确认人、确认/支付时间和备注。
  • 状态约束：DRAFT、CONFIRMED、PAID、CANCELLED。
  • 唯一约束：租户内结算号唯一。

• qipai_cleaning_settlement_items

  • 保洁结算单明细表，关联结算单与任务并固化任务奖励金额。
  • 唯一约束：同一租户内同一任务只能进入一个结算单。

权限

• 新增 cleaning.task.write。
• 新增 cleaning.statistics.read。
• 将 cleaning.task.read、cleaning.task.write、cleaning.statistics.read 授予现有 CLEANER、STORE_ADMIN、TENANT_ADMIN 和 PLATFORM_ADMIN 角色。
• 新增 cleaning.settlement.read 和 cleaning.settlement.write。
• 将 cleaning.settlement.read 授予 CLEANER、STORE_ADMIN、TENANT_ADMIN 和 PLATFORM_ADMIN；将 cleaning.settlement.write 授予 STORE_ADMIN、TENANT_ADMIN 和 PLATFORM_ADMIN。