From 85d65068e74d868e4aa1b5bb94affdcc1336b6cd Mon Sep 17 00:00:00 2001 From: Codex Date: Tue, 7 Jul 2026 09:52:28 +0800 Subject: [PATCH] =?UTF-8?q?feat(M08-B):=20=E8=A1=A5=E8=81=94=E8=B0=83?= =?UTF-8?q?=E9=80=BE=E6=9C=9F=E6=B8=85=E5=8D=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 4 +- .../components/CleaningFieldHandoffPanel.vue | 76 ++++++++++++++++++- docs/devlogs/2026-06-25-M08-B-保洁端.md | 12 ++- docs/feature-status.md | 4 +- docs/module-status.md | 6 +- scripts/check-admin-m08-b.mjs | 6 ++ 6 files changed, 97 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 5e89c23..f1de976 100644 --- a/README.md +++ b/README.md @@ -19,7 +19,7 @@ ## 目录 - `backend/`：Fastify + TypeScript 后端 API；若实际后端位于仓库根目录，以 `docs/repository-map.md` 为准 -- `admin/`：Vue3 后台管理端，已接入 M08-B 保洁运营工作台、运营待处理入口、运营待处理导出、待验收任务批量验收/驳回、协作者管理、任务成员导出、任务详情照片预览、任务操作流水、任务流水导出、任务详情协作分账、任务列表导出、任务详情导出、结算详情、结算详情导出、待结算候选预览与导出、结算列表导出、结算批量同步微信状态、结算转账状态筛选、微信确认参数展示与导出、微信转账预检资料展示与导出、真实转账前自动预检拦截、统计明细、每日趋势、统计导出、保洁员资料管理、保洁员列表导出、保洁员待补资料导出、微信绑定状态、保洁员选择器、任务/结算/统计筛选、联调负责人筛选、联调期限记录、联调风险清单导出和联调归档包导出，必须适配桌面、平板和手机 +- `admin/`：Vue3 后台管理端，已接入 M08-B 保洁运营工作台、运营待处理入口、运营待处理导出、待验收任务批量验收/驳回、协作者管理、任务成员导出、任务详情照片预览、任务操作流水、任务流水导出、任务详情协作分账、任务列表导出、任务详情导出、结算详情、结算详情导出、待结算候选预览与导出、结算列表导出、结算批量同步微信状态、结算转账状态筛选、微信确认参数展示与导出、微信转账预检资料展示与导出、真实转账前自动预检拦截、统计明细、每日趋势、统计导出、保洁员资料管理、保洁员列表导出、保洁员待补资料导出、微信绑定状态、保洁员选择器、任务/结算/统计筛选、联调负责人筛选、联调期限记录、联调逾期清单、联调风险清单导出和联调归档包导出，必须适配桌面、平板和手机 - `miniapp/`：微信原生小程序 - `database/`：迁移、种子和兼容 SQL - `deploy/`：Nginx、PM2、EMQX 模板与部署版本 @@ -121,7 +121,7 @@ WSL 已验证：EMQX `5.8.9`、MQTTX CLI `1.13.0`、EMQX 服务 `active (running 项目已开发部分模块。具体完成度不得从 README 猜测，必须以现有代码、测试、数据库迁移、Git 历史以及 `docs/current-baseline.md`、`docs/module-status.md`、`docs/feature-status.md` 为准。 - 当前执行游标：`M08-B`（PARTIAL） -- 最近工程提交：`bcc89ad` / `M08-B联调期限记录增量`，本轮在后台现场联调面板补齐检查项处理期限记录，并同步带入批量标记、报告、CSV、风险清单和归档包。 +- 最近工程提交：`M08-B联调逾期清单增量`，本轮在后台现场联调面板补齐逾期检查项统计、复制和归档，处理已过期限但未通过/不适用的现场检查项。 - 下一工程目标：继续 M08-B，补更完整保洁运营管理界面和真实商户现场执行记录。 ## 版本递进 diff --git a/admin/src/components/CleaningFieldHandoffPanel.vue b/admin/src/components/CleaningFieldHandoffPanel.vue index 08104b0..9aa2d4f 100644 --- a/admin/src/components/CleaningFieldHandoffPanel.vue +++ b/admin/src/components/CleaningFieldHandoffPanel.vue @@ -8,6 +8,7 @@ 待处理 {{ pendingCount }} 证据 {{ evidenceRecordedCount }} 待补证据 {{ evidenceMissingCount }} + 逾期 {{ overdueItems.length }} 收口 {{ closeoutReady ? '可归档' : '待补齐' }} 更新 {{ sessionMeta.updatedAt || '未记录' }} @@ -210,6 +211,21 @@ +
+
+
+

逾期检查项

+ {{ overdueItems.length }} 个现场检查项已超过处理期限 +
+ 复制逾期清单 +
+ +
@@ -410,6 +426,7 @@ const evidenceMissingItems = computed(() => checklist.filter((item) => ( ))); const evidenceMissingCount = computed(() => evidenceMissingItems.value.length); const blockedItems = computed(() => checklist.filter((item) => draft[item.id].status === 'BLOCKED')); +const overdueItems = computed(() => checklist.filter((item) => isOverdueDraft(draft[item.id]))); const riskItems = computed(() => checklist.filter((item) => { const itemDraft = draft[item.id]; return itemDraft.status === 'BLOCKED' @@ -422,6 +439,7 @@ const missingCloseoutFields = computed(() => { const fields: string[] = []; if (!handoffReady.value) fields.push('检查项状态'); if (evidenceMissingCount.value > 0) fields.push('现场证据'); + if (overdueItems.value.length > 0) fields.push('逾期检查项'); if (!sessionMeta.acceptor.trim()) fields.push('验收人'); if (!sessionMeta.closeoutVerdict.trim()) fields.push('收口结论'); return fields; @@ -508,6 +526,30 @@ function touchSessionMeta() { sessionMeta.updatedAt = formatLocalMinute(new Date()); } +function isOverdueDraft(itemDraft: HandoffDraft) { + if (itemDraft.status === 'PASS' || itemDraft.status === 'SKIP') return false; + const deadline = parseDeadline(itemDraft.deadline); + if (!deadline) return false; + return deadline.getTime() < Date.now(); +} + +function parseDeadline(value: string) { + const normalized = value.trim().replace(/\//g, '-'); + if (!normalized) return null; + const match = normalized.match(/^(\d{4})-(\d{1,2})-(\d{1,2})(?:\s+(\d{1,2}):(\d{1,2}))?$/); + if (!match) return null; + const [, year, month, day, hour = '23', minute = '59'] = match; + const parsed = new Date( + Number(year), + Number(month) - 1, + Number(day), + Number(hour), + Number(minute), + 59 + ); + return Number.isNaN(parsed.getTime()) ? null : parsed; +} + function resetDraft() { for (const item of checklist) { draft[item.id] = normalizeDraft(); @@ -577,6 +619,27 @@ async function copyEvidenceSummary() { } } +async function copyOverdueSummary() { + const header = [ + `联调批次：${sessionMeta.batchNo || '未填写'}`, + `现场/门店：${sessionMeta.site || '未填写'}`, + `负责人：${sessionMeta.coordinator || '未填写'}`, + `执行时间：${sessionMeta.executedAt || '未填写'}`, + `最后更新：${sessionMeta.updatedAt || '未记录'}`, + `逾期检查项：${overdueItems.value.length}` + ].join('\n'); + const content = overdueItems.value.map((item) => { + const itemDraft = draft[item.id]; + return `[${item.category}] ${item.title} - ${statusText(itemDraft.status)} - ${itemDraft.owner || '未分派'} - 期限：${itemDraft.deadline} - ${itemDraft.note || item.expected}`; + }).join('\n'); + try { + await navigator.clipboard.writeText(`${header}\n\n${content}`); + ElMessage.success('逾期清单已复制'); + } catch { + ElMessage.warning('当前浏览器不允许自动复制，请使用风险导出或归档包留存'); + } +} + async function copyVerdict() { const verdict = [ `联调批次：${sessionMeta.batchNo || '未填写'}`, @@ -659,11 +722,13 @@ function buildCloseoutArchive() { blocked: blockedCount.value, pending: pendingCount.value, evidenceRecorded: evidenceRecordedCount.value, - evidenceMissing: evidenceMissingCount.value + evidenceMissing: evidenceMissingCount.value, + overdue: overdueItems.value.length }, categoryProgress: categoryProgress.value, riskItems: riskItems.value.map((item) => serializeHandoffItem(item)), evidenceMissingItems: evidenceMissingItems.value.map((item) => serializeHandoffItem(item)), + overdueItems: overdueItems.value.map((item) => serializeHandoffItem(item)), checklist: checklist.map((item) => serializeHandoffItem(item)), report: buildHandoffReport() }; @@ -699,7 +764,7 @@ function buildHandoffReport() { `最后更新：${sessionMeta.updatedAt || '未记录'}`, `结论：${handoffReady.value ? '可进入现场验收收口' : '仍不可收口'}`, `归档门禁：${closeoutReady.value ? '可归档' : `待补齐 ${missingCloseoutFields.value.join('、')}`}`, - `汇总：总项 ${checklist.length}，通过 ${passedCount.value}，阻断 ${blockedCount.value}，待处理 ${pendingCount.value}，证据 ${evidenceRecordedCount.value}/${checklist.length}，待补证据 ${evidenceMissingCount.value}` + `汇总：总项 ${checklist.length}，通过 ${passedCount.value}，阻断 ${blockedCount.value}，待处理 ${pendingCount.value}，证据 ${evidenceRecordedCount.value}/${checklist.length}，待补证据 ${evidenceMissingCount.value}，逾期 ${overdueItems.value.length}` ]; const progress = categoryProgress.value.map((item) => ( `- ${item.category}：${item.passed}/${item.total} 通过，阻断 ${item.blocked}，待处理 ${item.pending}，不适用 ${item.skipped}` @@ -710,6 +775,9 @@ function buildHandoffReport() { const evidenceGaps = evidenceMissingItems.value.length ? evidenceMissingItems.value.map((item) => `- [${item.category}] ${item.title}：${item.evidence}`) : ['- 无']; + const overdueGaps = overdueItems.value.length + ? overdueItems.value.map((item) => `- [${item.category}] ${item.title}：${draft[item.id].owner || '未分派'} / ${draft[item.id].deadline}`) + : ['- 无']; const details = checklist.map((item) => formatReportItem(item)); return [ ...header, @@ -723,6 +791,9 @@ function buildHandoffReport() { '## 待补证据', ...evidenceGaps, '', + '## 逾期检查项', + ...overdueGaps, + '', '## 明细', ...details ].join('\n'); @@ -765,6 +836,7 @@ function exportChecklist() { ['session', '归档门禁', closeoutReady.value ? '可归档' : `待补齐 ${missingCloseoutFields.value.join('、')}`, '', '', '', '', '', ''], ['session', '证据记录数', `${evidenceRecordedCount.value}/${checklist.length}`, '', '', '', '', '', ''], ['session', '待补证据数', String(evidenceMissingCount.value), '', '', '', '', '', ''], + ['session', '逾期检查项', String(overdueItems.value.length), '', '', '', '', '', ''], ['ID', '类别', '检查项', '期望', '状态', '负责人', '期限', '结果记录', '应留证据', '证据记录'], ...checklist.map((item) => [ item.id, diff --git a/docs/devlogs/2026-06-25-M08-B-保洁端.md b/docs/devlogs/2026-06-25-M08-B-保洁端.md index bc3f21d..39f7f75 100644 --- a/docs/devlogs/2026-06-25-M08-B-保洁端.md +++ b/docs/devlogs/2026-06-25-M08-B-保洁端.md @@ -538,13 +538,21 @@ - `scripts/check-admin-m08-b.mjs` 扩展检查 `deadline`、期限列、批量标记期限和日期占位。 - 验证：`npm run build`（`admin/`）PASS；`node scripts/check-admin-m08-b.mjs` PASS。 +## 2026-07-07 联调逾期清单增量 + +- 后台现场联调面板新增逾期统计和“逾期检查项”清单，自动汇总已过期限且状态仍未通过/不适用的检查项。 +- 新增“复制逾期清单”按钮，可带出批次、现场、负责人、最后更新、状态、负责人、期限和结果记录，便于现场负责人追踪超时缺口。 +- 收口门禁会把逾期检查项纳入待补字段；交接报告、清单 CSV 和归档包同步带出逾期数量与逾期明细。 +- `scripts/check-admin-m08-b.mjs` 扩展检查 `overdueItems`、`isOverdueDraft`、`parseDeadline`、`copyOverdueSummary` 和逾期复制提示。 +- 验证：`npm run build`（`admin/`）PASS；`node scripts/check-admin-m08-b.mjs` PASS。 + ## 状态 -M08-B 保持 `PARTIAL`。当前已完成保洁端任务大厅、我的任务、接单、开始、照片上传、提交验收、驳回补做、订单结束自动建保洁任务、统计、管理员任务查询、指派、验收、驳回、批量验收、批量驳回、超时回收、任务事件流水、任务流水导出、多人协作分账、任务成员导出、任务详情协作分账展示、任务详情导出、待结算候选与后台预览/导出、正式结算单生成、确认、结算详情导出、结算列表导出、任务列表导出、结算批量同步微信状态、结算转账状态筛选、微信确认参数展示与导出、微信转账预检资料展示与导出、真实微信转账前自动预检拦截、发放成功标记、发放失败记录、微信商家转账 API 适配、转账中间态落库、主动轮询同步、微信转账通知回调、微信转账预检、非生产 Mock 门禁、后台任务成员协作管理、任务详情照片预览、操作流水、结算单详情、统计明细、统计导出、保洁员资料管理界面、保洁员列表导出、保洁员待补资料导出、手机号维护、微信绑定状态、每日统计趋势、任务/结算/统计/候选门店和保洁员筛选、任务/协作者/结算/统计保洁员选择器、运营待处理快捷入口、运营待处理导出以及真实商户/微信/转账/硬件现场联调清单、联调状态筛选、联调负责人筛选、联调期限记录、联调批量标记、联调阻断摘要复制、联调场次信息记录、联调 JSON 快照导入导出、联调分类进度、联调验收结论复制、联调更新时间、联调证据记录、待补证据清单、联调交接报告、联调风险清单导出、联调归档包导出、联调收口签署字段和联调收口门禁；真实商户现场执行和更完整的后台/小程序管理界面仍待继续。M08-A 的真机合法域名、真实微信支付和实物开门验证按外部条件阻塞保留，不阻断 M08-B 工程推进。 +M08-B 保持 `PARTIAL`。当前已完成保洁端任务大厅、我的任务、接单、开始、照片上传、提交验收、驳回补做、订单结束自动建保洁任务、统计、管理员任务查询、指派、验收、驳回、批量验收、批量驳回、超时回收、任务事件流水、任务流水导出、多人协作分账、任务成员导出、任务详情协作分账展示、任务详情导出、待结算候选与后台预览/导出、正式结算单生成、确认、结算详情导出、结算列表导出、任务列表导出、结算批量同步微信状态、结算转账状态筛选、微信确认参数展示与导出、微信转账预检资料展示与导出、真实微信转账前自动预检拦截、发放成功标记、发放失败记录、微信商家转账 API 适配、转账中间态落库、主动轮询同步、微信转账通知回调、微信转账预检、非生产 Mock 门禁、后台任务成员协作管理、任务详情照片预览、操作流水、结算单详情、统计明细、统计导出、保洁员资料管理界面、保洁员列表导出、保洁员待补资料导出、手机号维护、微信绑定状态、每日统计趋势、任务/结算/统计/候选门店和保洁员筛选、任务/协作者/结算/统计保洁员选择器、运营待处理快捷入口、运营待处理导出以及真实商户/微信/转账/硬件现场联调清单、联调状态筛选、联调负责人筛选、联调期限记录、联调逾期清单、联调批量标记、联调阻断摘要复制、联调场次信息记录、联调 JSON 快照导入导出、联调分类进度、联调验收结论复制、联调更新时间、联调证据记录、待补证据清单、联调交接报告、联调风险清单导出、联调归档包导出、联调收口签署字段和联调收口门禁；真实商户现场执行和更完整的后台/小程序管理界面仍待继续。M08-A 的真机合法域名、真实微信支付和实物开门验证按外部条件阻塞保留，不阻断 M08-B 工程推进。 ## 提交 -- 最近工程提交：`M08-B联调期限记录增量` +- 最近工程提交：`M08-B联调逾期清单增量` - 上次远端校验：`bcc89addbab15e9c3ba578ee68e8cadebcce595e`。 diff --git a/docs/feature-status.md b/docs/feature-status.md index d78eb40..31a41dc 100644 --- a/docs/feature-status.md +++ b/docs/feature-status.md @@ -17,13 +17,13 @@ | OPS-003 | 整仓发布清单 | M00-E/M10 | PARTIAL | `59d92c0` | `deploy-business.sh --dry-run` 可在 Windows/WSL 验证当前 HEAD 的 release manifest 结构；`check-release-manifest.ps1` 已接入 `test-all.ps1`；正式构建待项目生成。 | 后端/后台尚未生成，生产菜单未执行。 | M01/M09 后接入真实构建结果，并在生产菜单 2 生成真实 release manifest。 | | OPS-004 | 菜单式更新与环境监测 | M00-E/M10 | PARTIAL | `292ab7f` | `setup.sh` 已接入初始化、更新、MQTT、HTTPS、状态、备份、恢复、回滚和诊断菜单；`--backup-status` 已在 WSL 验证，可检查备份工具、目录和模板。 | 未在生产 Ubuntu 执行；真实备份配置未启用。 | 生产执行后补部署记录、真实备份和恢复演练记录。 | | IOT-001 | MQTT Broker 生产部署 | M00/M06 | PARTIAL | `d01f771` | 菜单 3 已支持 Ubuntu 24.04 amd64 原生安装/更新与复检；正式 Topic ACL 已固定；后端实现 MQTT.js 3.1、QoS 1、持久会话、自动重连、订阅恢复、健康检查、消息上限和真实硬件烟测运行器；Windows 全量测试通过，WSL EMQX 5.8.9 服务级检查通过。 | 缺生产 EMQX 安装、正式账号、ACL/端口/备份验收；WSL 本地账号未配置，真实硬件烟测按预期 SKIP。 | 由管理员在生产菜单 3 执行并登记结果；提供生产账号、DeviceID 和实物后执行 `node dist/devices/hardware-smoke-runner.js`。 | -| SYS-001 | 微信原生小程序 | M00-C/M08 | PARTIAL | `M08-B联调期限记录增量` | 微信原生模板已接入顾客端登录态、选店跳转、门店详情、房间列表、报价、预占、测试支付、订单生产微信预支付调起、充值微信支付调起、余额支付、优惠券/套餐下单抵扣参数与可视化选择器、受控 Wi-Fi、订单列表、订单详情、状态历史、取消入口、订单权限开门入口、续费、同门店换房、分享口令生成、个人中心余额/权益/账单汇总、充值计划/充值单入口、优惠券/套餐明细，以及保洁端任务大厅、我的任务、接单、开始、照片上传、提交验收、驳回补做入口、统计和管理侧验收/驳回/批量验收/批量驳回/指派/结算/多人协作/发放 API；后端已接入微信商家转账适配、转账中间态落库、主动轮询同步、微信转账通知回调、微信转账预检、结算详情、管理统计、员工角色筛选、统计趋势、统计按保洁员筛选、待结算候选筛选、任务事件流水、保洁员微信绑定状态、结算转账状态筛选和非生产 Mock 门禁；后台已建立保洁运营工作台，可维护任务协作者、导出单任务成员分账、查看任务详情、照片预览、操作流水和协作分账、批量验收/批量驳回待验收任务、导出当前任务列表、单任务详情和单任务操作流水、查看并导出结算单详情、预览并导出待结算候选任务、导出结算列表、批量同步微信转账状态、按转账状态筛选结算单、在结算详情和导出中查看微信确认参数、在微信转账预检中查看并导出凭据/授权/通知 URL/平台证书/OpenID 资料和检查项、发起真实转账前自动预检并在阻断项未处理时禁用 API 发起、统计明细、每日趋势、导出当前统计结果、管理保洁员手机号/资料完整度、导出当前保洁员列表、导出当前待补资料保洁员清单、通过保洁员选择器完成任务指派/协作者/结算生成人员选择，按门店和保洁员筛选任务/结算/统计/候选，通过首屏运营待处理入口跳转待验收、驳回补做、待确认结算和待发放队列，并可导出待处理队列摘要，查看微信转账真实商户前置条件，提供真实商户/微信/转账/硬件现场联调清单并支持本地记录、场次信息、状态筛选、联调负责人筛选、联调期限记录、批量标记、阻断摘要复制、CSV 导出、JSON 快照导入导出、分类进度展示、验收结论复制、最后更新时间、证据记录、待补证据清单、联调交接报告、联调风险清单导出、联调归档包导出、收口签署字段和收口归档门禁；`admin npm run build` 和 `node scripts/check-admin-m08-b.mjs` 通过。 | M08-A 真机联调缺微信后台/商户/硬件条件；M08-B 真实商户现场执行和更完整管理界面待继续。 | 继续 M08-B，补更完整保洁运营管理界面和真实商户现场执行记录。 | +| SYS-001 | 微信原生小程序 | M00-C/M08 | PARTIAL | `M08-B联调逾期清单增量` | 微信原生模板已接入顾客端登录态、选店跳转、门店详情、房间列表、报价、预占、测试支付、订单生产微信预支付调起、充值微信支付调起、余额支付、优惠券/套餐下单抵扣参数与可视化选择器、受控 Wi-Fi、订单列表、订单详情、状态历史、取消入口、订单权限开门入口、续费、同门店换房、分享口令生成、个人中心余额/权益/账单汇总、充值计划/充值单入口、优惠券/套餐明细，以及保洁端任务大厅、我的任务、接单、开始、照片上传、提交验收、驳回补做入口、统计和管理侧验收/驳回/批量验收/批量驳回/指派/结算/多人协作/发放 API；后端已接入微信商家转账适配、转账中间态落库、主动轮询同步、微信转账通知回调、微信转账预检、结算详情、管理统计、员工角色筛选、统计趋势、统计按保洁员筛选、待结算候选筛选、任务事件流水、保洁员微信绑定状态、结算转账状态筛选和非生产 Mock 门禁；后台已建立保洁运营工作台，可维护任务协作者、导出单任务成员分账、查看任务详情、照片预览、操作流水和协作分账、批量验收/批量驳回待验收任务、导出当前任务列表、单任务详情和单任务操作流水、查看并导出结算单详情、预览并导出待结算候选任务、导出结算列表、批量同步微信转账状态、按转账状态筛选结算单、在结算详情和导出中查看微信确认参数、在微信转账预检中查看并导出凭据/授权/通知 URL/平台证书/OpenID 资料和检查项、发起真实转账前自动预检并在阻断项未处理时禁用 API 发起、统计明细、每日趋势、导出当前统计结果、管理保洁员手机号/资料完整度、导出当前保洁员列表、导出当前待补资料保洁员清单、通过保洁员选择器完成任务指派/协作者/结算生成人员选择，按门店和保洁员筛选任务/结算/统计/候选，通过首屏运营待处理入口跳转待验收、驳回补做、待确认结算和待发放队列，并可导出待处理队列摘要，查看微信转账真实商户前置条件，提供真实商户/微信/转账/硬件现场联调清单并支持本地记录、场次信息、状态筛选、联调负责人筛选、联调期限记录、联调逾期清单、批量标记、阻断摘要复制、CSV 导出、JSON 快照导入导出、分类进度展示、验收结论复制、最后更新时间、证据记录、待补证据清单、联调交接报告、联调风险清单导出、联调归档包导出、收口签署字段和收口归档门禁；`admin npm run build` 和 `node scripts/check-admin-m08-b.mjs` 通过。 | M08-A 真机联调缺微信后台/商户/硬件条件；M08-B 真实商户现场执行和更完整管理界面待继续。 | 继续 M08-B，补更完整保洁运营管理界面和真实商户现场执行记录。 | | CFG-001 | 小程序品牌自定义 | M02-A/M03/M08 | PARTIAL | `8b8fb28` | 已建立 AppID/tenant 品牌配置表和 `/app-api/bootstrap`；同一 AppID 两租户隔离读取在 MySQL 8.4.9 实测通过。 | Logo/分享图片上传与小程序实际展示属于后续阶段。 | M03/M08 接入配置管理和小程序展示。 | | BKG-010 | 后台多小程序管理 | M02-A/M08/M10 | PARTIAL | `8b8fb28` | 已建立逻辑应用、租户绑定和租户配置模型；多租户 AppID 未指定租户会被拒绝。 | 尚无后台管理页面，多 AppID 真机配置未验证。 | M02-B/C 完成身份权限，M08 增加管理页面。 | | AUTH-001 | 多端统一小程序身份 | M02-B/M02-C/M08 | PARTIAL | `5a300a8` | 已实现微信 code 交换适配器、租户/AppID 隔离身份、JWT、服务端会话、当前用户和注销；禁用、角色/门店范围变化及管理员重置均使旧会话立即失效。 | 缺真实 AppSecret 真机联调和小程序动态角色界面。 | M08 完成小程序角色界面与真机登录。 | | AUTH-002 | 多级权限 | M02-B/M02-C/M08 | PARTIAL | `5a300a8` | 已建立六类角色、权限目录、用户角色和门店范围；后台员工 API 同时执行 capability、租户和门店范围校验，越权分配被拒绝并记录审计。 | 后续业务资源接口和前端按钮/菜单仍需逐模块接入。 | M03 起所有管理接口复用 capability 与数据范围；M08 完成前端菜单按钮控制。 | | CLN-001 | 保洁人员管理 | M08-B/M09 | PARTIAL | `M08-B保洁员待补资料导出增量` | `CLEANER` 角色已接入 `cleaning.task.read/write` 和 `cleaning.statistics.read`，保洁接口按登录态、capability 和门店范围裁剪任务大厅；后台已可按 `CLEANER` 角色筛选员工，创建保洁员，编辑姓名/手机号/门店范围/备注，启停账号并重置会话；员工列表返回头像 URL 和微信小程序 openid 绑定状态，后台展示“已绑微信/未绑微信”和资料完整度标签，并复用该列表作为任务指派、协作者管理和生成结算单的可搜索保洁员选择源；保洁员管理页可导出当前筛选页 CSV，带出资料完整度、微信绑定、门店范围、脱敏手机号、最近登录/IP 和备注，也可单独导出待补资料清单，列出未绑定微信、未配置门店范围和缺姓名等缺口。 | 真实商户现场联调和更完整管理界面仍待继续。 | 继续 M08-B/M09，补更完整保洁运营管理界面。 | -| CLN-002 | 保洁任务大厅 | M08-B/M09 | PARTIAL | `M08-B联调期限记录增量` | 新增 `qipai_cleaning_tasks`、`qipai_cleaning_task_events`、`GET /app-api/cleaning/tasks/hall`、`GET /app-api/cleaning/tasks/mine`、接单、开始、照片上传、提交验收、驳回补做接口；订单 `FINISHED` 时同事务幂等创建 `WAITING` 保洁任务；管理侧已支持任务查询、按状态/门店/负责人或协作者筛选、任务详情、照片预览、任务事件流水、任务详情协作分账、指派、验收、驳回、批量验收、批量驳回、超时回收、协作者查看/添加/移除、待结算候选筛选与后台预览/导出、正式结算单生成/确认、发放成功标记、发放失败记录、微信转账发放、转账预检、主动同步、批量同步、微信通知回调、结算单详情、结算详情导出、结算转账状态筛选、微信确认参数展示与导出、管理统计、每日趋势、统计按保洁员筛选和保洁员资料管理；小程序 `pages/cleaner/tasks` 已调用真实 app-api 并支持相机/相册上传；后台 `admin/` 已提供任务筛选、当前任务列表导出、单任务详情导出、单任务流水导出、单任务成员导出、待验收任务多选批量验收/驳回、保洁员选择器指派、验收、驳回、超时回收、任务成员协作管理、任务详情操作流水和协作分账、结算详情、结算详情导出、待结算候选预览导出、结算列表导出、结算批量同步微信状态、转账状态筛选、微信确认参数展示与导出、统计明细、每日趋势、统计保洁员筛选、保洁员资料、待补资料导出、手机号维护、微信绑定状态、结算微信转账预检资料展示导出和转账前自动拦截界面、运营待处理快捷入口、运营待处理导出、真实商户/微信/转账/硬件现场联调清单、联调状态筛选、联调负责人筛选、联调期限记录、联调批量标记、联调阻断摘要复制、联调场次信息记录、联调 JSON 快照导入导出、联调分类进度、联调验收结论复制、联调更新时间、联调证据记录、待补证据清单、联调交接报告、联调风险清单导出、联调归档包导出、收口签署字段和收口归档门禁。 | 真实商户现场执行和更完整管理界面仍待继续。 | 继续 M08-B，补更完整保洁运营管理界面。 | +| CLN-002 | 保洁任务大厅 | M08-B/M09 | PARTIAL | `M08-B联调逾期清单增量` | 新增 `qipai_cleaning_tasks`、`qipai_cleaning_task_events`、`GET /app-api/cleaning/tasks/hall`、`GET /app-api/cleaning/tasks/mine`、接单、开始、照片上传、提交验收、驳回补做接口；订单 `FINISHED` 时同事务幂等创建 `WAITING` 保洁任务；管理侧已支持任务查询、按状态/门店/负责人或协作者筛选、任务详情、照片预览、任务事件流水、任务详情协作分账、指派、验收、驳回、批量验收、批量驳回、超时回收、协作者查看/添加/移除、待结算候选筛选与后台预览/导出、正式结算单生成/确认、发放成功标记、发放失败记录、微信转账发放、转账预检、主动同步、批量同步、微信通知回调、结算单详情、结算详情导出、结算转账状态筛选、微信确认参数展示与导出、管理统计、每日趋势、统计按保洁员筛选和保洁员资料管理；小程序 `pages/cleaner/tasks` 已调用真实 app-api 并支持相机/相册上传；后台 `admin/` 已提供任务筛选、当前任务列表导出、单任务详情导出、单任务流水导出、单任务成员导出、待验收任务多选批量验收/驳回、保洁员选择器指派、验收、驳回、超时回收、任务成员协作管理、任务详情操作流水和协作分账、结算详情、结算详情导出、待结算候选预览导出、结算列表导出、结算批量同步微信状态、转账状态筛选、微信确认参数展示与导出、统计明细、每日趋势、统计保洁员筛选、保洁员资料、待补资料导出、手机号维护、微信绑定状态、结算微信转账预检资料展示导出和转账前自动拦截界面、运营待处理快捷入口、运营待处理导出、真实商户/微信/转账/硬件现场联调清单、联调状态筛选、联调负责人筛选、联调期限记录、联调逾期清单、联调批量标记、联调阻断摘要复制、联调场次信息记录、联调 JSON 快照导入导出、联调分类进度、联调验收结论复制、联调更新时间、联调证据记录、待补证据清单、联调交接报告、联调风险清单导出、联调归档包导出、收口签署字段和收口归档门禁。 | 真实商户现场执行和更完整管理界面仍待继续。 | 继续 M08-B，补更完整保洁运营管理界面。 | | CLN-003 | 保洁统计 | M08-B/M09 | PARTIAL | `M08-B保洁统计导出增量` | 新增 `GET /app-api/cleaning/stats`，返回当前保洁员负责人/协作者任务状态计数和按成员分账计算的待结算金额，小程序展示已抢、进行、待验、完成和待结算金额；管理侧新增 `GET /admin-api/cleaning/statistics`，按租户、门店范围、日期、门店和保洁员筛选返回状态分布、门店明细、结算口径、成员分账排行和每日趋势，保洁员筛选同时覆盖负责人/协作者任务口径、结算单口径和每日已发放金额；后台首屏汇总改为使用管理侧统计接口，统计页支持今日、近7天、本月快捷周期、每日趋势条形展示和可搜索保洁员筛选，任务/结算/统计列表支持门店和保洁员筛选以辅助定位统计异常，并可导出当前筛选条件下的汇总、任务状态、结算口径、每日趋势、门店明细和成员分账 CSV。 | 真实商户现场联调和更完整管理界面待继续。 | M08-B/M09-C 补更完整管理界面。 | | STAFF-001 | 员工账号 | M02-D/M08 | PARTIAL | `5a300a8` | 已实现创建员工、分配角色/门店、禁用、备注、重置会话和审计；WSL MySQL 实测权限变化撤销活动会话。 | 后台与管理员小程序页面尚未实现。 | M08 接入管理界面。 | | BKG-002 | 后台用户管理 | M02-D/M08 | PARTIAL | `5a300a8` | 已实现分页筛选 API、注册/登录时间、状态、角色、门店范围以及手机号/IP 脱敏。 | Vue3 后台页面尚未实现。 | M08 实现响应式用户管理页面。 | diff --git a/docs/module-status.md b/docs/module-status.md index 0457d19..525309a 100644 --- a/docs/module-status.md +++ b/docs/module-status.md @@ -7,10 +7,10 @@ execution_cursor: stage_status: PARTIAL last_completed_stage: M07-D next_stage: M08-B - last_engineering_commit: `M08-B联调期限记录增量` + last_engineering_commit: `M08-B联调逾期清单增量` last_push_verified: true base_branch: main - blocked_reason: "M08-A 真机合法域名、真实微信支付和实物开门验证缺微信后台/商户/硬件现场条件；M08-B 已完成照片上传、驳回补做、订单结束自动建保洁任务、管理员查询/指派/验收/驳回、批量验收、批量驳回、超时回收、任务事件流水、任务流水导出、任务成员导出、待结算候选与后台预览/导出、正式结算单生成/确认、多保洁员协作分账策略、任务详情协作分账展示、任务列表导出、任务详情导出、结算详情导出、结算列表导出、结算批量同步微信状态、结算转账状态筛选、微信确认参数展示与导出、发放成功标记、发放失败记录、微信商家转账 API 适配、转账中间态落库、主动轮询同步、微信转账通知回调、微信转账预检、微信转账预检资料展示与导出、真实微信转账前自动预检拦截、非生产 Mock 门禁、后台任务成员协作管理、任务详情照片预览、操作流水、结算单详情、统计明细、统计导出、每日统计趋势、保洁员资料管理界面、保洁员列表导出、保洁员待补资料导出、手机号维护、微信绑定状态展示、任务/协作者/结算/统计保洁员选择器、任务/结算/统计/候选门店和保洁员筛选、运营待处理快捷入口、运营待处理导出以及真实商户/微信/转账/硬件现场联调清单、联调状态筛选、联调负责人筛选、联调期限记录、联调批量标记、联调阻断摘要复制、联调场次信息记录、联调 JSON 快照导入导出、联调分类进度、联调验收结论复制、联调更新时间、联调证据记录、待补证据清单、联调交接报告、联调风险清单导出、联调归档包导出、联调收口签署字段和联调收口门禁，仍需继续补真实商户现场执行和更完整的管理界面。M06-G 真实硬件联调仍缺生产 MQTT 账号/ACL、DeviceID、控制箱、门锁、插座和现场配线。" + blocked_reason: "M08-A 真机合法域名、真实微信支付和实物开门验证缺微信后台/商户/硬件现场条件；M08-B 已完成照片上传、驳回补做、订单结束自动建保洁任务、管理员查询/指派/验收/驳回、批量验收、批量驳回、超时回收、任务事件流水、任务流水导出、任务成员导出、待结算候选与后台预览/导出、正式结算单生成/确认、多保洁员协作分账策略、任务详情协作分账展示、任务列表导出、任务详情导出、结算详情导出、结算列表导出、结算批量同步微信状态、结算转账状态筛选、微信确认参数展示与导出、发放成功标记、发放失败记录、微信商家转账 API 适配、转账中间态落库、主动轮询同步、微信转账通知回调、微信转账预检、微信转账预检资料展示与导出、真实微信转账前自动预检拦截、非生产 Mock 门禁、后台任务成员协作管理、任务详情照片预览、操作流水、结算单详情、统计明细、统计导出、每日统计趋势、保洁员资料管理界面、保洁员列表导出、保洁员待补资料导出、手机号维护、微信绑定状态展示、任务/协作者/结算/统计保洁员选择器、任务/结算/统计/候选门店和保洁员筛选、运营待处理快捷入口、运营待处理导出以及真实商户/微信/转账/硬件现场联调清单、联调状态筛选、联调负责人筛选、联调期限记录、联调逾期清单、联调批量标记、联调阻断摘要复制、联调场次信息记录、联调 JSON 快照导入导出、联调分类进度、联调验收结论复制、联调更新时间、联调证据记录、待补证据清单、联调交接报告、联调风险清单导出、联调归档包导出、联调收口签署字段和联调收口门禁，仍需继续补真实商户现场执行和更完整的管理界面。M06-G 真实硬件联调仍缺生产 MQTT 账号/ACL、DeviceID、控制箱、门锁、插座和现场配线。" updated_at: 2026-07-06T00:00:00+08:00 ``` @@ -24,6 +24,6 @@ execution_cursor: | M05 会员、余额、套餐、优惠券 | PARTIAL | `1680d73` | docs/devlogs/2026-06-22-M05-D-分账与收款配置.md | M05-A/B/C/D 工程闭环已完成：统一支付、微信支付退款、团购直订、门店收款账户、分账接收方、比例策略、授权门禁、幂等分账和对账查询均通过 Windows 与 WSL MySQL 回归；真实微信/团购/分账权限未提供，模块保持 PARTIAL/BLOCKED_EXTERNAL。 | | M06 设备、MQTT 与真实硬件联动 | PARTIAL | `d01f771` | docs/devlogs/2026-06-24-M06-G-真实硬件联调.md | M06-A 至 F 已完成 MQTT、拓扑、协议幂等、控制箱、Sub-1G 门锁、智慧插座和订单自动联动任务；M06-G 已补真实硬件烟测运行器，缺生产 MQTT 账号/ACL、DeviceID 和实物配线，保持 BLOCKED_EXTERNAL。 | | M07 会员、余额、充值、优惠券和套餐营销 | DONE | `ed0d455` | docs/devlogs/2026-06-24-M07-D-会员管理.md | M07-A 已完成现金/赠送双余额账本；M07-B 已完成充值优惠；M07-C 已完成优惠券/套餐权益底表和冻结、确认、退回的可靠补偿核销服务；M07-D 已完成会员画像、订单、消费、余额、充值、优惠券和套餐聚合查询。 | -| M08 微信原生小程序完整业务 | PARTIAL | `M08-B联调期限记录增量` | docs/devlogs/2026-06-25-M08-B-保洁端.md | M08-A 已完成顾客端选店、门店/房间浏览、报价、预占、测试支付、订单生产微信预支付调起、充值微信支付调起与通知入账、受控 Wi-Fi、订单列表、订单详情、状态历史、取消测算、取消订单、订单权限开门、顾客续费、同门店换房、分享口令生成、个人中心余额/权益/账单汇总、充值计划/充值单入口、优惠券/套餐明细、优惠券/套餐/余额下单抵扣工程闭环和权益可视化选择器；真机合法域名、真实微信支付和实物开门验证按 BLOCKED_EXTERNAL 旁路。M08-B 已完成保洁任务底表、权限、任务大厅、我的任务、接单、开始、照片上传、提交验收、驳回补做、订单结束自动建任务、统计、管理员查询、指派、验收、驳回、批量验收、批量驳回、超时回收、任务事件流水、任务流水导出、任务成员导出、任务详情协作分账展示、待结算候选与后台预览/导出、正式结算单生成/确认、多保洁员协作分账策略、任务列表导出、任务详情导出、结算详情导出、结算列表导出、结算批量同步微信状态、结算转账状态筛选、微信确认参数展示与导出、发放成功标记、发放失败记录、微信商家转账 API 适配、转账中间态落库、主动轮询同步、微信转账通知回调、微信转账预检、预检资料展示导出和真实转账前预检拦截、非生产 Mock 门禁、后台任务成员协作管理、任务详情照片预览、操作流水、结算单详情、统计明细、统计导出、保洁员资料管理界面、保洁员列表导出、保洁员待补资料导出、手机号维护、微信绑定状态、每日统计趋势、任务/协作者/结算/统计保洁员选择器、任务/结算/统计/候选门店和保洁员筛选、运营待处理快捷入口、运营待处理导出以及真实商户/微信/转账/硬件现场联调清单、联调状态筛选、联调负责人筛选、联调期限记录、联调批量标记、联调阻断摘要复制、联调场次信息记录、联调 JSON 快照导入导出、联调分类进度、联调验收结论复制、联调更新时间、联调证据记录、待补证据清单、联调交接报告、联调风险清单导出、联调归档包导出、联调收口签署字段和联调收口门禁；真实商户现场执行和更完整的管理界面待继续。 | +| M08 微信原生小程序完整业务 | PARTIAL | `M08-B联调逾期清单增量` | docs/devlogs/2026-06-25-M08-B-保洁端.md | M08-A 已完成顾客端选店、门店/房间浏览、报价、预占、测试支付、订单生产微信预支付调起、充值微信支付调起与通知入账、受控 Wi-Fi、订单列表、订单详情、状态历史、取消测算、取消订单、订单权限开门、顾客续费、同门店换房、分享口令生成、个人中心余额/权益/账单汇总、充值计划/充值单入口、优惠券/套餐明细、优惠券/套餐/余额下单抵扣工程闭环和权益可视化选择器；真机合法域名、真实微信支付和实物开门验证按 BLOCKED_EXTERNAL 旁路。M08-B 已完成保洁任务底表、权限、任务大厅、我的任务、接单、开始、照片上传、提交验收、驳回补做、订单结束自动建任务、统计、管理员查询、指派、验收、驳回、批量验收、批量驳回、超时回收、任务事件流水、任务流水导出、任务成员导出、任务详情协作分账展示、待结算候选与后台预览/导出、正式结算单生成/确认、多保洁员协作分账策略、任务列表导出、任务详情导出、结算详情导出、结算列表导出、结算批量同步微信状态、结算转账状态筛选、微信确认参数展示与导出、发放成功标记、发放失败记录、微信商家转账 API 适配、转账中间态落库、主动轮询同步、微信转账通知回调、微信转账预检、预检资料展示导出和真实转账前预检拦截、非生产 Mock 门禁、后台任务成员协作管理、任务详情照片预览、操作流水、结算单详情、统计明细、统计导出、保洁员资料管理界面、保洁员列表导出、保洁员待补资料导出、手机号维护、微信绑定状态、每日统计趋势、任务/协作者/结算/统计保洁员选择器、任务/结算/统计/候选门店和保洁员筛选、运营待处理快捷入口、运营待处理导出以及真实商户/微信/转账/硬件现场联调清单、联调状态筛选、联调负责人筛选、联调期限记录、联调逾期清单、联调批量标记、联调阻断摘要复制、联调场次信息记录、联调 JSON 快照导入导出、联调分类进度、联调验收结论复制、联调更新时间、联调证据记录、待补证据清单、联调交接报告、联调风险清单导出、联调归档包导出、联调收口签署字段和联调收口门禁；真实商户现场执行和更完整的管理界面待继续。 | | M09 后台管理端完整业务 | TODO | - | - | - | | M10 部署、域名、验收和运维闭环 | TODO | - | - | - | diff --git a/scripts/check-admin-m08-b.mjs b/scripts/check-admin-m08-b.mjs index ae6bb7a..ea07f12 100644 --- a/scripts/check-admin-m08-b.mjs +++ b/scripts/check-admin-m08-b.mjs @@ -240,6 +240,12 @@ for (const pattern of [ '待补证据', 'evidenceMissingItems', 'evidenceMissingCount', + 'overdueItems', + 'isOverdueDraft', + 'parseDeadline', + 'copyOverdueSummary', + '逾期检查项', + '逾期清单已复制', 'copyEvidenceSummary', '待补证据清单已复制', '现场交接报告已复制',