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

40 lines
2.1 KiB
Markdown

# 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`