feat(M08-B): 补保洁结算发放记录

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

@@ -43,6 +43,13 @@
 - `GET /app-api/cleaning/tasks/mine` 与 `GET /app-api/cleaning/stats` 扩展为负责人/协作者视角；待结算金额按成员分账金额统计。
 - 结算生成改为按成员 `reward_cents` 生成明细，单个成员结算后只标记该成员 `settled_at`；所有有效成员均结清后任务才整体转为 `SETTLED`。
 
+## 2026-06-27 发放闭环增量
+
+- 新增 `2026062728_m08b_cleaning_payouts` 迁移，为 `qipai_cleaning_settlements` 增加 `paid_by`、`payout_channel`、`payout_reference` 和 `payout_error`，记录保洁结算发放操作人、渠道、外部流水号和失败原因。
+- 新增 `POST /admin-api/cleaning/settlements/:settlementId/paid`，仅允许管理员将 `CONFIRMED` 结算单标记为 `PAID`，写入发放渠道、流水号、发放人和 `paid_at`，并清空旧失败原因。
+- 新增 `POST /admin-api/cleaning/settlements/:settlementId/payout-failure`，仅允许对 `CONFIRMED` 结算单记录发放失败原因，保留 `CONFIRMED` 状态，支持修复外部付款后重试。
+- 结算单查询返回新增发放字段，管理端后续可以直接展示发放状态、渠道流水和失败原因。
+
 ## 验收结果
 
 - `npm run build`（`backend/`）：PASS。
@@ -62,10 +69,14 @@
   - 多人协作增量后 `node tests/migration-contract.test.mjs`：PASS。
   - 多人协作增量后 `node tests/migration-runner.test.mjs`：PASS。
   - 多人协作增量后 `node tests/cleaning-route.test.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 工程推进。
 
 ## 提交