feat(M08-B): 补免清洁统计展示

2026-07-08 10:11:35 +08:00
parent 19d6734b68
commit 642659ce3e
11 changed files with 79 additions and 43 deletions
@@ -585,14 +585,21 @@
 - `backend/tests/cleaning-route.test.mjs` 覆盖免清洁路由透传，`scripts/check-admin-m08-b.mjs` 增加免清洁 API、父组件、任务面板和仓储静态检查。
 - 验证：`npm run build`（`backend/`）PASS；`npm test -- --runInBand backend/tests/cleaning-route.test.mjs`（`backend/`，实际执行后端全量测试链）PASS；`npm run build`（`admin/`）PASS；`node scripts/check-admin-m08-b.mjs` PASS；`node scripts/check-miniapp-m08-a.mjs` PASS；`check-secrets.ps1` PASS；`check-large-files.ps1` 仅保留既有 `参考\mazongjian-server.xjar` 超 100MB 警告；`git diff --check` PASS。

+## 2026-07-08 免清洁统计展示增量
+
+- 管理侧 `GET /admin-api/cleaning/statistics` 新增 `exempted` 统计字段，summary、门店明细和每日趋势均可返回免清洁数量。
+- 后台统计页新增免清洁概览卡、每日趋势免清洁数量和门店明细免清洁列；统计 CSV 导出同步带出免清洁数量，并保留每日发放和门店奖励口径。
+- `backend/tests/cleaning-route.test.mjs` 补充 `summary.exempted`、`byStore[].exempted`、`trend[].exempted` 断言，`scripts/check-admin-m08-b.mjs` 增加免清洁统计展示和后端 SQL 聚合探针。
+- 验证：`npm run build`（`backend/`）PASS；`npm run build`（`admin/`）PASS；`node scripts/check-admin-m08-b.mjs` PASS；`npm test -- --runInBand backend/tests/cleaning-route.test.mjs`（`backend/`，实际执行后端全量测试链）PASS；其余门禁待本轮收尾回填。
+
 ## 状态

-M08-B 保持 `PARTIAL`。当前已完成保洁端任务大厅、我的任务、接单、开始、照片上传、提交验收、驳回补做、订单结束自动建保洁任务、统计、管理员任务查询、指派、验收、驳回、免清洁、批量验收、批量驳回、超时回收、任务事件流水、任务流水导出、多人协作分账、任务成员导出、任务详情协作分账展示、任务详情导出、待结算候选与后台预览/导出、正式结算单生成、确认、结算详情导出、结算列表导出、任务列表导出、结算批量同步微信状态、结算转账状态筛选、微信确认参数展示与导出、微信转账预检资料展示与导出、真实微信转账前自动预检拦截、发放成功标记、发放失败记录、微信商家转账 API 适配、转账中间态落库、主动轮询同步、微信转账通知回调、微信转账预检、非生产 Mock 门禁、后台任务成员协作管理、任务详情照片预览、操作流水、结算单详情、统计明细、统计导出、保洁员绩效排行、保洁员端统计看板、任务免清洁标记、保洁员资料管理界面、保洁员列表导出、保洁员待补资料导出、手机号维护、微信绑定状态、每日统计趋势、任务/结算/统计/候选门店和保洁员筛选、任务/协作者/结算/统计保洁员选择器、运营待处理快捷入口、运营待处理导出以及真实商户/微信/转账/硬件现场联调清单、联调状态筛选、联调负责人筛选、联调负责人看板、联调执行阶段看板、联调期限记录、联调逾期清单、联调批量标记、联调阻断摘要复制、联调场次信息记录、联调 JSON 快照导入导出、联调分类进度、联调验收结论复制、联调更新时间、联调证据记录、待补证据清单、联调交接报告、联调风险清单导出、联调归档包导出、联调收口签署字段和联调收口门禁；真实商户现场执行和更完整的后台/小程序管理界面仍待继续。M08-A 的真机合法域名、真实微信支付和实物开门验证按外部条件阻塞保留，不阻断 M08-B 工程推进。
+M08-B 保持 `PARTIAL`。当前已完成保洁端任务大厅、我的任务、接单、开始、照片上传、提交验收、驳回补做、订单结束自动建保洁任务、统计、管理员任务查询、指派、验收、驳回、免清洁、批量验收、批量驳回、超时回收、任务事件流水、任务流水导出、多人协作分账、任务成员导出、任务详情协作分账展示、任务详情导出、待结算候选与后台预览/导出、正式结算单生成、确认、结算详情导出、结算列表导出、任务列表导出、结算批量同步微信状态、结算转账状态筛选、微信确认参数展示与导出、微信转账预检资料展示与导出、真实微信转账前自动预检拦截、发放成功标记、发放失败记录、微信商家转账 API 适配、转账中间态落库、主动轮询同步、微信转账通知回调、微信转账预检、非生产 Mock 门禁、后台任务成员协作管理、任务详情照片预览、操作流水、结算单详情、统计明细、统计导出、保洁员绩效排行、保洁员端统计看板、任务免清洁标记、免清洁统计展示、保洁员资料管理界面、保洁员列表导出、保洁员待补资料导出、手机号维护、微信绑定状态、每日统计趋势、任务/结算/统计/候选门店和保洁员筛选、任务/协作者/结算/统计保洁员选择器、运营待处理快捷入口、运营待处理导出以及真实商户/微信/转账/硬件现场联调清单、联调状态筛选、联调负责人筛选、联调负责人看板、联调执行阶段看板、联调期限记录、联调逾期清单、联调批量标记、联调阻断摘要复制、联调场次信息记录、联调 JSON 快照导入导出、联调分类进度、联调验收结论复制、联调更新时间、联调证据记录、待补证据清单、联调交接报告、联调风险清单导出、联调归档包导出、联调收口签署字段和联调收口门禁；真实商户现场执行和更完整的后台/小程序管理界面仍待继续。M08-A 的真机合法域名、真实微信支付和实物开门验证按外部条件阻塞保留，不阻断 M08-B 工程推进。

 ## 提交

- 最近工程提交：`8ffb940` / `M08-B任务免清洁增量`
- 上次远端校验：`8ffb940bdb23b27b7cfb4c6ddc792a0da7d297ae`。
+- 最近工程提交：`M08-B免清洁统计展示增量`
+- 上次远端校验：待本轮提交后回填。