docs(M08-B): 记录保洁多人协作进度

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

@@ -34,6 +34,15 @@
 - 结算生成会锁定当前候选任务，写入结算明细，固化任务奖励金额，并把任务转为 `SETTLED`，避免同一任务重复结算。
 - 新增 `POST /admin-api/cleaning/reclaim-timeouts`，可按分钟阈值和数量限制回收超时停留在 `CLAIMED`/`STARTED` 的任务，恢复到任务大厅。
 
+## 2026-06-26 多人协作增量
+
+- 新增 `2026062627_m08b_cleaning_collaboration` 迁移，建立 `qipai_cleaning_task_members`，支持 `LEAD` 负责人和 `ASSIST` 协作者、成员分账金额、移除和成员维度结算时间。
+- 调整 `qipai_cleaning_settlement_items`，新增 `cleaner_user_id`，唯一键从“任务唯一”升级为“任务 + 保洁员唯一”，允许同一协作任务按成员分别进入不同保洁员结算单。
+- `CleaningTaskRepository` 在接单、指派和验收时自动维护负责人成员；重新指派会撤掉旧未结算负责人，避免同一任务出现多个有效 `LEAD`。
+- 新增管理侧成员接口：查看成员、添加/更新协作者、移除未结算协作者。协作者必须拥有 `CLEANER` 角色和任务门店范围，协作者分账总额不能超过任务奖励。
+- `GET /app-api/cleaning/tasks/mine` 与 `GET /app-api/cleaning/stats` 扩展为负责人/协作者视角；待结算金额按成员分账金额统计。
+- 结算生成改为按成员 `reward_cents` 生成明细，单个成员结算后只标记该成员 `settled_at`；所有有效成员均结清后任务才整体转为 `SETTLED`。
+
 ## 验收结果
 
 - `npm run build`（`backend/`）：PASS。
@@ -49,14 +58,18 @@
   - 继续增量后 `npm test -- --runInBand`（`backend/`）：PASS，覆盖管理侧指派、验收、驳回和待结算候选路由。
   - 结算增量后 `npm test -- --runInBand`（`backend/`）：PASS，覆盖结算迁移、结算单路由和超时回收路由。
   - 结算增量后 `node scripts/check-miniapp-m08-a.mjs`：PASS。
+  - 多人协作增量后 `npm run build`（`backend/`）：PASS。
+  - 多人协作增量后 `node tests/migration-contract.test.mjs`：PASS。
+  - 多人协作增量后 `node tests/migration-runner.test.mjs`：PASS。
+  - 多人协作增量后 `node tests/cleaning-route.test.mjs`：PASS，覆盖成员查看、添加和移除路由。
 
 ## 状态
 
-M08-B 保持 `PARTIAL`。当前已完成保洁端任务大厅、我的任务、接单、开始、照片上传、提交验收、驳回补做、订单结束自动建任务、统计、管理员任务查询、指派、验收、驳回、超时回收、待结算候选、正式结算单生成和确认基础工程闭环；多保洁员协作策略、结算真实支付/发放和后台/小程序管理界面仍待继续。M08-A 的真机合法域名、真实微信支付和实物开门验证按外部条件阻塞保留，不阻断 M08-B 工程推进。
+M08-B 保持 `PARTIAL`。当前已完成保洁端任务大厅、我的任务、接单、开始、照片上传、提交验收、驳回补做、订单结束自动建任务、统计、管理员任务查询、指派、验收、驳回、超时回收、多人协作分账、待结算候选、正式结算单生成和确认基础工程闭环；结算真实支付/发放和后台/小程序管理界面仍待继续。M08-A 的真机合法域名、真实微信支付和实物开门验证按外部条件阻塞保留，不阻断 M08-B 工程推进。
 
 ## 提交
 
-- 工程提交：`2ec4376`
+- 工程提交：`03496d7`
 - 远端校验：待本轮 push 后执行 `HEAD == origin/main`。