Codex
77 lines
4.6 KiB
Markdown
77 lines
4.6 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`。
|
||
## 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` 支持 `LEAD` 和 `ASSIST`。
|
||
- `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`，支持同一协作任务按不同成员分别结算。
|
||
|
||
## 2026-06-27 发放闭环增量
|
||
|
||
- 新增迁移：
|
||
- `database/migrations/2026062728_m08b_cleaning_payouts.up.sql`
|
||
- `database/migrations/2026062728_m08b_cleaning_payouts.down.sql`
|
||
- `database/migrations/2026062728_m08b_cleaning_payouts.verify.sql`
|
||
- 调整 `qipai_cleaning_settlements`：
|
||
- 新增 `paid_by`，关联发放确认操作人。
|
||
- 新增 `payout_channel`，记录发放渠道，例如微信零钱、企业付款或线下人工发放。
|
||
- 新增 `payout_reference`，记录外部付款流水或人工凭证号。
|
||
- 新增 `payout_error`，记录最近一次发放失败原因，成功标记为 `PAID` 时清空。
|
||
- 新增 `idx_qipai_cleaning_settlement_payout`，支持按租户、状态和发放时间查询。
|
||
## 2026-06-27 微信转账适配增量
|
||
|
||
- 新增迁移：
|
||
- `database/migrations/2026062729_m08b_cleaning_transfer_state.up.sql`
|
||
- `database/migrations/2026062729_m08b_cleaning_transfer_state.down.sql`
|
||
- `database/migrations/2026062729_m08b_cleaning_transfer_state.verify.sql`
|
||
- 调整 `qipai_cleaning_settlements`：
|
||
- 新增 `payout_state`，记录微信转账结果或中间态，例如 `SUCCESS`、`FAIL`、`WAIT_USER_CONFIRM`、`PROCESSING`。
|
||
- 新增 `payout_package_info`，保存微信待用户确认等场景返回的 package 信息。
|
||
- 新增 `idx_qipai_cleaning_settlement_transfer_state`，支持按租户、转账状态和更新时间筛选待跟进结算单。
|
||
- 既有 `payout_channel`、`payout_reference`、`payout_error` 继续保存发放渠道、外部流水和最近失败原因；`PAID` 时同步将 `payout_state` 标记为 `SUCCESS`。
|