Codex
65 lines
5.2 KiB
Markdown
65 lines
5.2 KiB
Markdown
# M08-B 保洁端
|
||
|
||
## 本次工程增量
|
||
|
||
- 新增 `2026062525_m08b_cleaner_tasks` 迁移，建立 `qipai_cleaning_tasks` 与 `qipai_cleaning_task_events`，覆盖 WAITING、CLAIMED、STARTED、SUBMITTED、COMPLETED、REJECTED、EXEMPT、SETTLED、CANCELLED 状态和事件追踪。
|
||
- 权限补齐 `cleaning.task.write`、`cleaning.statistics.read`，`CLEANER`、门店管理员、租户管理员和平台管理员可获得保洁任务读写与统计能力。
|
||
- 新增 `CleaningTaskRepository` 与 `/app-api/cleaning/*` 路由：任务大厅、我的任务、接单、开始、提交验收和个人统计均要求登录态与保洁权限。
|
||
- 生产 `server.ts` 注入真实保洁仓储，迁移 runner 纳入 M08-B 数据库迁移。
|
||
- 小程序新增 `pages/cleaner/tasks`，调用真实 app-api 展示任务大厅、我的任务、待结算统计，并支持接单、开始和提交照片 URL 验收。
|
||
- `scripts/check-miniapp-m08-a.mjs` 扩展为同时检查 M08-A 顾客端与 M08-B 保洁端页面注册和真实接口调用。
|
||
|
||
## 2026-06-26 增量
|
||
|
||
- `/app-api/cleaning/tasks/:taskId/photos` 接入受控图片上传：保洁员必须登录且拥有当前任务，任务状态必须为 `STARTED` 或 `REJECTED`，上传后复用 `MediaStorage` 压缩为 WebP 并返回固定 `https://api.txyundm.cn/uploads/...` URL。
|
||
- `/app-api/cleaning/tasks/:taskId/submit` 改为必须提交至少一张照片；`REJECTED` 任务允许再次提交，提交后清空驳回原因并记录事件。
|
||
- 新增 `/app-api/cleaning/tasks/:taskId/rework`，保洁员可将本人 `REJECTED` 任务重新转为 `STARTED`，清空旧照片和驳回原因，进入补做流程。
|
||
- `OrderStateRepository` 在订单状态进入 `FINISHED` 时通过同一事务调用 `CleaningTaskRepository.createForFinishedOrder`，按 `order_id` 唯一键幂等创建 `WAITING` 保洁任务并写入 `AUTO_CREATE` 事件。
|
||
- 小程序保洁端将手工照片 URL 文本框改为相机/相册选择图片，上传成功后再提交验收；驳回任务显示原因并提供“重做”入口。
|
||
- 修复 `marketing-benefit-service.test.mjs` 中固定订单时间导致 2026-06-26 后自然过期的问题，改为相对未来时间，避免测试随日期漂移失效。
|
||
|
||
## 2026-06-26 继续增量
|
||
|
||
- 新增管理侧保洁任务查询 `/admin-api/cleaning/tasks`，按管理员门店范围和状态筛选任务。
|
||
- 新增管理侧指派 `/admin-api/cleaning/tasks/:taskId/assign`，指派前校验被指派用户为有效 `CLEANER` 且拥有任务门店范围。
|
||
- 新增管理侧验收 `/admin-api/cleaning/tasks/:taskId/complete`，将 `SUBMITTED` 任务转为 `COMPLETED` 并记录事件。
|
||
- 新增管理侧驳回 `/admin-api/cleaning/tasks/:taskId/reject`，写入驳回原因并允许保洁端进入补做链路。
|
||
- 新增 `/admin-api/cleaning/settlement-candidates`，返回 `COMPLETED` 且未结算的任务，作为后续结算单生成前置。
|
||
|
||
## 2026-06-26 结算增量
|
||
|
||
- 新增 `2026062626_m08b_cleaning_settlements` 迁移，建立保洁结算单主表和明细表，任务明细唯一进入一个结算单。
|
||
- 新增 `cleaning.settlement.read` 和 `cleaning.settlement.write` 权限，保洁员可读本人结算相关能力，门店/租户/平台管理员可生成和确认结算。
|
||
- 新增 `GET /admin-api/cleaning/settlements`、`POST /admin-api/cleaning/settlements` 和 `POST /admin-api/cleaning/settlements/:id/confirm`，支持从已完成未结算任务生成 `DRAFT` 结算单并确认到 `CONFIRMED`。
|
||
- 结算生成会锁定当前候选任务，写入结算明细，固化任务奖励金额，并把任务转为 `SETTLED`，避免同一任务重复结算。
|
||
- 新增 `POST /admin-api/cleaning/reclaim-timeouts`，可按分钟阈值和数量限制回收超时停留在 `CLAIMED`/`STARTED` 的任务，恢复到任务大厅。
|
||
|
||
## 验收结果
|
||
|
||
- `npm run build`（`backend/`）：PASS。
|
||
- `node scripts/check-miniapp-m08-a.mjs`：PASS。
|
||
- `node tests/cleaning-route.test.mjs`：PASS。
|
||
- `node tests/migration-contract.test.mjs`：PASS。
|
||
- `node tests/migration-runner.test.mjs`：PASS。
|
||
- `npm test`（`backend/`）：PASS。
|
||
- 2026-06-26 追加验证：
|
||
- `node tests/cleaning-route.test.mjs`：PASS，覆盖 `rework` 和照片上传路由。
|
||
- `npm test -- --runInBand`（`backend/`）：PASS。
|
||
- `node scripts/check-miniapp-m08-a.mjs`：PASS。
|
||
- 继续增量后 `npm test -- --runInBand`（`backend/`）：PASS，覆盖管理侧指派、验收、驳回和待结算候选路由。
|
||
- 结算增量后 `npm test -- --runInBand`（`backend/`）：PASS，覆盖结算迁移、结算单路由和超时回收路由。
|
||
- 结算增量后 `node scripts/check-miniapp-m08-a.mjs`：PASS。
|
||
|
||
## 状态
|
||
|
||
M08-B 保持 `PARTIAL`。当前已完成保洁端任务大厅、我的任务、接单、开始、照片上传、提交验收、驳回补做、订单结束自动建任务、统计、管理员任务查询、指派、验收、驳回、超时回收、待结算候选、正式结算单生成和确认基础工程闭环；多保洁员协作策略、结算真实支付/发放和后台/小程序管理界面仍待继续。M08-A 的真机合法域名、真实微信支付和实物开门验证按外部条件阻塞保留，不阻断 M08-B 工程推进。
|
||
|
||
## 提交
|
||
|
||
- 工程提交：`2ec4376`
|
||
- 远端校验：待本轮 push 后执行 `HEAD == origin/main`。
|
||
|
||
|
||
|
||
|