qipai/docs/devlogs/2026-06-25-M08-B-保洁端.md

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 保洁端页面注册和真实接口调用。

验收结果

• 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。

状态

M08-B 进入 PARTIAL。本次完成保洁端任务大厅、我的任务、接单、开始、提交验收和统计的基础工程闭环；照片真实上传、驳回补做、订单结束自动建任务、管理员指派、超时回收和结算单仍待继续。M08-A 的真机合法域名、真实微信支付和实物开门验证按外部条件阻塞保留，不阻断 M08-B 工程推进。

提交

• 工程提交：2a4dcd0
• 远端校验：待本轮 push 后执行 HEAD == origin/main。