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