feat(M08-B): 补待结算候选预览

2026-06-30 18:15:36 +08:00
parent 78fb6ed2d0
commit 67e7796652
11 changed files with 176 additions and 15 deletions
@@ -214,6 +214,10 @@
  - 统计按保洁员筛选增量后 `npm run build`（`admin/`）：PASS。
  - 统计按保洁员筛选增量后 `node backend/tests/cleaning-route.test.mjs`：PASS，覆盖管理统计 `cleanerUserId` 参数透传。
  - 统计按保洁员筛选增量后 `node scripts/check-admin-m08-b.mjs`：PASS。
+  - 待结算候选预览增量后 `npm run build`（`backend/`）：PASS。
+  - 待结算候选预览增量后 `npm run build`（`admin/`）：PASS。
+  - 待结算候选预览增量后 `node backend/tests/cleaning-route.test.mjs`：PASS，覆盖候选接口门店/保洁员筛选参数透传。
+  - 待结算候选预览增量后 `node scripts/check-admin-m08-b.mjs`：PASS。

 ## 2026-06-30 统计按保洁员筛选增量

@@ -221,13 +225,19 @@
 - 后台统计页新增可搜索保洁员选择器，与任务列表和结算列表的筛选口径保持一致，支持按单个保洁员定位待验收、待结算、已发放和每日趋势。
 - `backend/tests/cleaning-route.test.mjs` 补充管理统计筛选参数透传断言，`scripts/check-admin-m08-b.mjs` 补充统计页保洁员筛选控件检查。

+## 2026-06-30 待结算候选预览增量
+
+- 后端 `GET /admin-api/cleaning/settlement-candidates` 新增 `storeId` 和 `cleanerUserId` 查询参数，候选任务继续限定为 `COMPLETED` 且未结算，保洁员筛选覆盖负责人和未移除、未结算协作者。
+- 后台结算页新增“候选”入口，可按当前门店/保洁员筛选预览待结算任务、当前页金额、房间、负责人和完成时间，并可将当前筛选带入生成结算单弹窗。
+- `backend/tests/cleaning-route.test.mjs` 补充候选接口筛选参数透传断言，`scripts/check-admin-m08-b.mjs` 补充后台候选预览控件检查。
+
 ## 状态

-M08-B 保持 `PARTIAL`。当前已完成保洁端任务大厅、我的任务、接单、开始、照片上传、提交验收、驳回补做、订单结束自动建任务、统计、管理员任务查询、指派、验收、驳回、超时回收、多人协作分账、待结算候选、正式结算单生成、确认、发放成功标记、发放失败记录、微信商家转账 API 适配、转账中间态落库、主动轮询同步、微信转账通知回调、微信转账预检、非生产 Mock 门禁、后台任务成员协作管理、任务详情照片预览、结算单详情、统计明细、保洁员资料管理界面、手机号维护、微信绑定状态、每日统计趋势、任务/结算/统计门店和保洁员筛选以及任务/协作者/结算/统计保洁员选择器；真实商户现场联调和更完整的后台/小程序管理界面仍待继续。M08-A 的真机合法域名、真实微信支付和实物开门验证按外部条件阻塞保留，不阻断 M08-B 工程推进。
+M08-B 保持 `PARTIAL`。当前已完成保洁端任务大厅、我的任务、接单、开始、照片上传、提交验收、驳回补做、订单结束自动建任务、统计、管理员任务查询、指派、验收、驳回、超时回收、多人协作分账、待结算候选与后台预览、正式结算单生成、确认、发放成功标记、发放失败记录、微信商家转账 API 适配、转账中间态落库、主动轮询同步、微信转账通知回调、微信转账预检、非生产 Mock 门禁、后台任务成员协作管理、任务详情照片预览、结算单详情、统计明细、保洁员资料管理界面、手机号维护、微信绑定状态、每日统计趋势、任务/结算/统计/候选门店和保洁员筛选以及任务/协作者/结算/统计保洁员选择器；真实商户现场联调和更完整的后台/小程序管理界面仍待继续。M08-A 的真机合法域名、真实微信支付和实物开门验证按外部条件阻塞保留，不阻断 M08-B 工程推进。

 ## 提交

- 工程提交：`M08-B统计按保洁员筛选增量`
+- 工程提交：`M08-B待结算候选预览增量`
 - 远端校验：待本轮 push 后执行 `HEAD == origin/main`。