Files
qipai/docs/db-changelog/2026-06-25-M08-B-cleaning.md
T
2026-06-26 17:47:39 +08:00

3.0 KiB
Raw Blame History

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、驳回原因和关键时间戳。
    • 状态约束:WAITINGCLAIMEDSTARTEDSUBMITTEDCOMPLETEDREJECTEDEXEMPTSETTLEDCANCELLED
    • 唯一约束:租户内任务号唯一;订单关联唯一。
    • 索引:任务大厅、保洁员任务、房间任务。
  • qipai_cleaning_task_events

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

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

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

权限

  • 新增 cleaning.task.write
  • 新增 cleaning.statistics.read
  • cleaning.task.readcleaning.task.writecleaning.statistics.read 授予现有 CLEANERSTORE_ADMINTENANT_ADMINPLATFORM_ADMIN 角色。
  • 新增 cleaning.settlement.readcleaning.settlement.write
  • cleaning.settlement.read 授予 CLEANERSTORE_ADMINTENANT_ADMINPLATFORM_ADMIN;将 cleaning.settlement.write 授予 STORE_ADMINTENANT_ADMINPLATFORM_ADMIN

2026-06-26 多保洁员协作增量

  • 新增迁移:
    • database/migrations/2026062627_m08b_cleaning_collaboration.up.sql
    • database/migrations/2026062627_m08b_cleaning_collaboration.down.sql
    • database/migrations/2026062627_m08b_cleaning_collaboration.verify.sql
  • 新增 qipai_cleaning_task_members
    • 记录任务保洁成员,member_role 支持 LEADASSIST
    • reward_cents 记录成员分账金额,removed_at 记录移除,settled_at 记录成员维度结算完成。
    • 同一租户、任务、用户唯一,支持负责人和协作者查询索引。
  • 调整 qipai_cleaning_settlement_items
    • 新增 cleaner_user_id,结算明细从“任务唯一”升级为“任务 + 保洁员唯一”。
    • uq_qipai_cleaning_settlement_item_task 替换为 uq_qipai_cleaning_settlement_item_task_user,支持同一协作任务按不同成员分别结算。