docs(M08-D): 回填门店与房间管理

README.md

@@ -121,8 +121,8 @@ 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-D`（DOING）；`M08-C` 的可独立工程内容已完成，真实团购商家授权、微信和硬件现场验收保持 `BLOCKED_EXTERNAL`。
-- 最近工程提交：`65f2e7c` / `M08-D后台运营总览`，Vue 后台可切换授权门店和 7/30/90 日周期，查看成功实收、订单、会员、房态、支付渠道、收入趋势与验券结果，并直达保洁工作台。
+- 最近工程提交：`1ca783e` / `M08-D门店与房间管理`，Vue 后台已接入门店筛选/详情/安全编辑和房间定价、状态、停用时段、归档等完整运营入口。
-- 下一工程目标：继续 M08-D，补后台门店与房间管理页面。
+- 下一工程目标：继续 M08-D，补后台订单筛选、详情与运营处置页面。
 
 ## 版本递进
 

docs/api-changelog/2026-08-10-M08-D-admin-overview.md

@@ -6,3 +6,11 @@
 | GET | `/admin-api/stores` | 既有门店读权限与数据范围 | 运营总览只展示当前账号有权查看的门店，用于统计门店选择。 |
 
 后台 API 基地址仍固定为 `/admin-api`。新增别名不复制统计逻辑，不降低鉴权；实收只累计 `SUCCEEDED` 支付，房态为查询时快照，订单和验券按各自创建时间口径。
+
+## 门店与房间管理增量
+
+| 方法 | 路径 | 变更 |
+|---|---|---|
+| GET | `/admin-api/stores` | 增加 `businessHours`、`wifiConfigured`、经纬度、联系电话、Wi-Fi SSID、通知地址和排序；不返回 Wi-Fi 密码。 |
+| POST/PUT | `/admin-api/stores[/:id]` | `wifiPassword` 改为可省略；创建时省略写入空值，更新时省略使用 `COALESCE` 保持原密码。 |
+| GET/POST/PUT/PATCH/DELETE | `/admin-api/stores/:storeId/rooms`、`/admin-api/rooms/**` | Vue 后台接入既有房间列表、创建、编辑、状态、停用时段和归档接口，权限契约不变。 |

docs/current-baseline.md

@@ -2,7 +2,7 @@
 
 > V5.0 首次核验日期：2026-06-16  
 > audited_commit: `4ae9296`
-> next_engineering_target: 继续 M08-D Vue 平台后台，补门店与房间管理页面
+> next_engineering_target: 继续 M08-D Vue 平台后台，补订单筛选、详情与运营处置页面
 > 事实源：当前工作区、Git 历史、状态文档、Windows/WSL 检查脚本。
 
 ## 总体结论
@@ -12,7 +12,7 @@
 | 总纲版本 | V5.4 已成为当前权威总纲，旧版已保留为历史备份 | 根目录存在 `V5.4.md` 及旧版总纲 | 可继续按 V5.4 的执行游标开发 |
 | Git 远端 | `origin=ssh://git@git.txyundm.cn:2222/panda/qipai.git`，分支 `main` | `git rev-list main...origin/main` 为 `0 0` | 本地与远端同步 |
 | 正式后端 | 已完成 Fastify、迁移兼容、outbox/worker、多应用租户、微信身份/会话，以及六角色 RBAC 和门店范围 | `backend/src/auth/**`、`database/migrations/2026061805_m02c_rbac.*.sql`、`backend/tests/**` | M01、M02-A/B/C DONE；MySQL 已验证 capability 和跨租户门店授权拒绝；下一阶段 M02-D |
-| 后台管理端 | 已建立 Vue3 + Vite + TypeScript + Element Plus 工程，接入 M08-B 保洁运营工作台，并新增 M08-D 授权门店运营总览、7/30/90 日经营指标、成功支付渠道、收入趋势、当前房态、验券统计和模块导航 | `admin/src/App.vue`、`admin/src/components/OperationsOverviewPanel.vue`、`admin/src/components/CleaningTasksPanel.vue`、`admin/src/components/CleaningSettlementsPanel.vue`、`admin/src/components/CleaningStatisticsPanel.vue`、`admin/src/components/CleanersPanel.vue`、`admin/src/components/CleaningFieldHandoffPanel.vue`、`scripts/check-admin-m08-b.mjs`、`scripts/check-admin-m08-d.mjs` | M08-D 保持 DOING；运营总览和保洁工作台可切换，统计继续由后端校验租户/门店范围；下一增量补门店与房间管理页面 |
+| 后台管理端 | 已建立 Vue3 + Vite + TypeScript + Element Plus 工程，接入 M08-B 保洁运营工作台，并新增 M08-D 授权门店运营总览和门店/房间管理工作区；支持门店筛选、详情、营业时间、Wi-Fi 配置状态、安全编辑/归档，以及房间价格、标签、图片、启停、房态、停用时段和归档 | `admin/src/App.vue`、`admin/src/components/OperationsOverviewPanel.vue`、`admin/src/components/StoresRoomsPanel.vue`、`admin/src/components/CleaningTasksPanel.vue`、`admin/src/components/CleaningSettlementsPanel.vue`、`admin/src/components/CleaningStatisticsPanel.vue`、`admin/src/components/CleanersPanel.vue`、`admin/src/components/CleaningFieldHandoffPanel.vue`、`scripts/check-admin-m08-b.mjs`、`scripts/check-admin-m08-d.mjs` | M08-D 保持 DOING；运营总览、门店房间和保洁工作台可切换，读写继续由后端校验租户/门店范围并写审计；下一增量补订单管理页面 |
 | 微信小程序 | 已纳管微信原生模板，并完成顾客端订单、充值、权益明细、下单抵扣主体链路、保洁任务端照片上传/补做主体链路，以及管理员门店/房态/订单/代下单/验券/会员/员工/保洁/设备/经营统计 | `miniapp/pages/index`、`miniapp/pages/store/detail`、`miniapp/pages/room/detail`、`miniapp/pages/orders/*`、`miniapp/pages/recharge/*`、`miniapp/pages/profile/*`、`miniapp/pages/cleaner/*`、`miniapp/pages/manager/*`、`miniapp/utils/api.js`、`scripts/check-miniapp-m08-a.mjs`、`scripts/check-miniapp-m08-c.mjs` | M08 PARTIAL；M08-A 顾客端工程闭环按外部阻塞旁路；M08-B 可独立工程内容已完成；M08-C 可独立工程内容已完成并通过 Windows 与 MySQL 模块回归，游标进入 M08-D；真实团购、微信和硬件现场验收保持外部阻塞 |
 | 数据库迁移 | 已新增 M01-B 核心 schema up/down/verify SQL、最小脱敏 seed、旧库结构 fixture、迁移计划/执行 CLI、验证结果数量门禁和 MySQL 8 集成测试 | `database/migrations/2026061601_m01b_core_schema.*.sql`、`database/seeds/2026061601_m01b_minimal_seed.sql`、`database/fixtures/2026061801_m01b_legacy_schema.sql`、`backend/src/db/migration-runner.ts`、`backend/tests/mysql-migration-roundtrip.test.mjs` | M01-B DONE；WSL MySQL 8.4.9 已验证 8 条旧库 fixture、11 条 up、3 条 verify、10 条 down，并验证租户隔离和旧金额整数分转换；不导入真实旧数据 |
 | M00 部署脚本 | 已有菜单、状态、HTTPS、Certbot、EMQX、备份检查模板 | `setup.sh`、`scripts/setup/`、`deploy/` | PARTIAL，生产未执行 |
@@ -35,6 +35,6 @@
 
 ## 下一步
 
-1. 继续 M08-D：在已完成运营总览和保洁工作台导航基础上，补门店列表、筛选、详情与房间配置管理页面。
+1. 继续 M08-D：在已完成运营总览、门店/房间管理和保洁工作台导航基础上，补订单筛选、详情与运营处置页面。
 2. 继续复用 M02 权限、M03 门店、M04 订单、M05 支付/团购、M06 设备和 M07 会员能力，不重复初始化后台工程。
 3. M06-G 真实硬件联调仍等待生产 MQTT 账号/ACL、DeviceID 和现场实物配线。

docs/db-changelog/2026-08-10-M08-D-admin-overview.md

@@ -4,3 +4,4 @@
 - 后台运营总览复用 M08-C 的门店经营统计查询，不新增缓存表或冗余汇总表。
 - 订单、OWNER 会员、成功支付、团购核销均按租户、门店和时间区间参数化过滤；房态读取当前 `qipai_rooms` 快照。
 - WSL MySQL 8.4.10 已完成 136 up、114 verify、130 down 的完整往返，并继续通过订单、成功支付、团购渠道和验券统计集成断言。
+- 门店/房间管理增量无 schema 变化；门店查询新增营业时段批量读取和 Wi-Fi 是否配置的布尔投影，Wi-Fi 密码仍不返回；门店更新省略密码时由 `COALESCE` 保留原值。

docs/devlogs/2026-08-10-M08-D-Vue平台后台.md

@@ -27,3 +27,30 @@
 ### 状态
 
 M08-D 保持 `DOING`。运营总览与现有保洁工作区已接通；下一工程增量补门店与房间管理页面，不提前进入 M09。
+
+## 2026-08-10 门店与房间管理
+
+- `ENGINEERING_DELTA=YES`
+- 新增响应式门店/房间工作区，支持授权门店搜索、营业状态筛选、详情、每周营业时段、Wi-Fi 配置状态、新增、编辑和归档。
+- 房间管理支持房号/分类/标签搜索、房态筛选、完整整数分价格配置、标签/图片、启停、运营房态、停用时段和归档。
+- 门店列表读取补充营业时段与 `wifiConfigured`，不返回 Wi-Fi 密码；更新接口允许省略 `wifiPassword` 并使用 `COALESCE` 保留原值，避免后台编辑清空既有密码。
+- 所有写操作继续复用 M03 的租户、门店范围、capability 与审计边界，前端错误显示保留业务错误码和 traceId。
+
+### 测试证据
+
+- Windows `scripts/dev/windows/test-all.ps1`：63.4 秒退出码 0；后端全测、M08-B/C/D 静态门禁、Vue TypeScript 与生产构建、域名/敏感信息检查均通过。
+- WSL 原生临时副本 + MySQL 8.4.10：26.5 秒退出码 0，`up → verify → down → up → verify` 完成，136 条 up、114 条 verify、130 条 down。
+- `backend/tests/store-room.test.mjs` 新增营业时段、Wi-Fi 配置状态与省略密码更新断言；Vue 生产构建成功。
+- 既有 Element Plus chunk 超过 500kB、参考 xjar 超过 100MB 和 WSL npm 7 个 high audit 项仍为非阻塞提示，未执行破坏性自动升级。
+
+### 变更影响
+
+- 数据库：无迁移、无新增表。
+- API：`GET /admin-api/stores` 增加营业时段、Wi-Fi 配置状态及既有门店详情字段；`POST/PUT /admin-api/stores` 的 `wifiPassword` 可省略，更新省略时保持原值。
+- 后台：新增门店/房间响应式管理入口和完整表单。
+- 部署：后端与后台静态产物有变化，未自动部署生产。
+- 工程提交：`1ca783e`，已推送并验证 `HEAD == origin/main`。
+
+### 状态
+
+M08-D 保持 `DOING`。门店与房间管理增量完成；下一工程增量补后台订单筛选、详情与运营处置页面。

docs/feature-status.md

@@ -16,6 +16,8 @@
 
 > 2026-08-10 M08-D 增量：工程提交 `65f2e7c` 为 `REP-001` 建立 Vue 后台授权门店运营总览；7/30/90 日成功实收、订单、会员、房态、渠道、趋势与验券统计使用 `/admin-api/statistics` 同源权限边界，并从总览直达既有保洁工作台。Windows 全量、Vue 生产构建与 WSL MySQL 8.4.10 往返通过，M08-D 继续门店与房间管理。
 
+> 2026-08-10 M08-D 增量：工程提交 `1ca783e` 为 `STORE-001`、`ROOM-001` 建立 Vue 后台门店/房间工作区；门店筛选、详情、营业时段、Wi-Fi 配置状态、安全保留原密码的编辑，以及房间定价、标签、图片、启停、运营房态、停用时段和归档均复用既有租户/门店范围与审计边界。Windows 全量、Vue 生产构建与 WSL MySQL 8.4.10 往返通过，M08-D 继续后台订单管理。
+
 | ID | 功能 | 模块子阶段 | 状态 | 最近提交 | 测试/验收证据 | 阻塞原因 | 下一步 |
 |---|---|---|---|---|---|---|---|
 | ENV-001 | 固定 Windows 工作区 | M00-A/M00-B | DONE | 远端 HEAD | 已确认 `D:\qipai`，Git 根、main 分支、固定 origin 和 push 校验通过。 | - | 后续每模块继续复检。 |
@@ -43,8 +45,8 @@
 | STAFF-001 | 员工账号 | M02-D/M08 | PARTIAL | `5a300a8` | 已实现创建员工、分配角色/门店、禁用、备注、重置会话和审计；WSL MySQL 实测权限变化撤销活动会话。 | 后台与管理员小程序页面尚未实现。 | M08 接入管理界面。 |
 | BKG-002 | 后台用户管理 | M02-D/M08 | PARTIAL | `5a300a8` | 已实现分页筛选 API、注册/登录时间、状态、角色、门店范围以及手机号/IP 脱敏。 | Vue3 后台页面尚未实现。 | M08 实现响应式用户管理页面。 |
 | TEN-001 | 多门店支持 | M02/M03 | PARTIAL | `15139b3` | 门店 CRUD 与门店管理员数据范围已实现；跨门店写操作在 Windows 和 WSL MySQL 实测被拒绝。 | 地图选店、前端切换与完整订单数据范围待后续阶段。 | M03-C 接入地图选店，M04 起业务资源继承门店范围。 |
-| STORE-001 | 门店运营配置 | M03-A | PARTIAL | `15139b3` | 已实现地址、经纬度、营业状态、每周营业时间、时区、客服电话、Wi-Fi、通知地址和排序。 | 通宵场、延时关灯和清洁策略将在订单/设备阶段接入。 | M03-B/C/D 继续补装修、地图和受控 Wi-Fi。 |
+| STORE-001 | 门店运营配置 | M03-A/M08 | PARTIAL | `1ca783e` | 已实现地址、经纬度、营业状态、每周营业时间、时区、客服电话、Wi-Fi、通知地址和排序；Vue 后台支持授权范围内门店筛选、详情、新增、编辑和归档，列表只返回 Wi-Fi 是否已配置，编辑留空不会清除原密码。 | 通宵场、延时关灯和清洁策略仍需与订单/设备联动补齐。 | M08-D 后续页面继续复用门店选择；M10 做生产配置验收。 |
-| ROOM-001 | 房间配置 | M03-A/M04 | PARTIAL | `15139b3` | 已实现房型、整数分价格、工作日/节假日/通宵价、押金、最低时长、提前规则、禁用时段、标签、图片和软删除。 | 价格计算、节假日日历及下单时段冲突属于 M04。 | M04 接入定价快照和预约校验。 |
+| ROOM-001 | 房间配置 | M03-A/M04/M08 | PARTIAL | `1ca783e` | 已实现房型、整数分价格、工作日/节假日/通宵/全天价、最低消费、押金、最低时长、提前规则、禁用时段、标签、图片和软删除；Vue 后台支持筛选、新增、完整编辑、配置启停、运营房态、停用时段和归档。 | 节假日日历与真实运营价格复算仍需生产验收。 | M08-D 订单页复用房间信息；M10 做生产数据验收。 |
 | ADV-001 | 广告管理 | M03-B/M08 | PARTIAL | `f746242` | 已实现平台、租户、门店三级广告，素材租户归属、投放时间、跳转、排序和范围权限均由后端校验。 | 后台编辑页面和小程序展示待 M08。 | M08 接入广告管理和前端投放。 |
 | UI-001 | 门店装修和多套模板 | M03-B/M08 | PARTIAL | `f746242` | 已实现装修草稿版本、Schema 版本、组件白名单、发布和旧版本归档。 | 可视化编辑器及小程序模板渲染待 M08。 | M08 实现编辑器与渲染组件。 |
 | MAP-001 | 地图选店和最近门店 | M03-C/M08 | PARTIAL | `4ac2c96` | 已实现 AppID/tenant 隔离门店发现、城市/营业筛选、按门店时区判断营业中、后端 Haversine 距离排序；小程序支持定位和手工城市降级，并可从门店卡片进入公开门店详情与房间列表。 | 地图 SDK 可视化和真机定位授权尚未验收。 | M08-A 继续补真机定位、地图展示和门店装修渲染。 |

docs/module-status.md

@@ -7,11 +7,11 @@ execution_cursor:
   stage_status: DOING
   last_completed_stage: M08-C
   next_stage: M08-D
-  last_engineering_commit: `65f2e7c`
+  last_engineering_commit: `1ca783e`
   last_push_verified: true
   base_branch: main
   blocked_reason: "M08-A 真机合法域名、真实微信支付和实物开门验证缺微信后台/商户/硬件现场条件；M08-B 可独立工程内容已完成，真实商户凭据、微信后台配置、生产小额转账和实物硬件结果保持 BLOCKED_EXTERNAL；M08-C 可独立工程内容已完成，真实美团/抖音/快手商家授权与真机验券保持 BLOCKED_EXTERNAL，已按规则旁路进入 M08-D。M06-G 真实硬件联调仍缺生产 MQTT 账号/ACL、DeviceID、控制箱、门锁、插座和现场配线。"
-  updated_at: 2026-08-10T11:22:34+08:00
+  updated_at: 2026-08-10T11:41:05+08:00
 ```
 
 | 模块 | 状态 | 最近提交 | 最近开发日志 | 备注 |
@@ -24,7 +24,7 @@ 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 | `96c5fa4` | docs/devlogs/2026-06-25-M08-B-保洁端.md | M08-A 已完成顾客端选店、门店/房间浏览、报价、预占、测试支付、订单生产微信预支付调起、充值微信支付调起与通知入账、受控 Wi-Fi、订单列表、订单详情、状态历史、取消测算、取消订单、订单权限开门、顾客续费、同门店换房、分享口令生成、个人中心余额/权益/账单汇总、充值计划/充值单入口、优惠券/套餐明细、优惠券/套餐/余额下单抵扣工程闭环和权益可视化选择器；真机合法域名、真实微信支付和实物开门验证按 BLOCKED_EXTERNAL 旁路。M08-B 已完成保洁任务底表、权限、任务大厅、我的任务、接单、开始、照片上传、提交验收、驳回补做、订单结束自动建任务、统计、管理员查询、指派、验收、驳回、免清洁、批量验收、批量驳回、批量免清洁、超时回收、任务事件流水、任务流水导出、任务成员导出、任务详情协作分账展示、待结算候选与后台预览/导出、正式结算单生成/确认、多保洁员协作分账策略、任务列表导出、任务详情导出、结算详情导出、结算列表导出、结算批量同步微信状态、结算转账状态筛选、微信确认参数展示与导出、发放成功标记、发放失败记录、微信商家转账 API 适配、转账中间态落库、主动轮询同步、微信转账通知回调、微信转账预检、预检资料展示导出和真实转账前预检拦截、非生产 Mock 门禁、后台任务成员协作管理、任务详情照片预览、操作流水、结算单详情、统计明细、统计导出、保洁员绩效排行、保洁员端统计看板、任务免清洁标记、免清洁统计展示、保洁员资料管理界面、保洁员列表导出、保洁员待补资料导出、手机号维护、微信绑定状态、每日统计趋势、任务/协作者/结算/统计保洁员选择器、任务/结算/统计/候选门店和保洁员筛选、运营待处理快捷入口、运营待处理导出以及真实商户/微信/转账/硬件现场联调清单、联调检查项搜索、联调筛选结果导出与筛选清除、联调状态筛选、联调负责人筛选、联调负责人看板、联调执行阶段看板、联调期限记录、联调逾期清单、联调批量标记、联调阻断摘要复制、联调场次信息记录、联调 JSON 快照导入导出、联调分类进度、联调验收结论复制、联调更新时间、联调证据记录、待补证据清单、联调交接报告、联调风险清单导出、联调归档包导出、联调收口签署字段和联调收口门禁；真实商户现场执行和更完整的管理界面待继续。 |
+| M08 微信原生小程序完整业务 | PARTIAL | `1ca783e` | docs/devlogs/2026-08-10-M08-D-Vue平台后台.md | M08-A 顾客端、M08-B 保洁端和 M08-C 管理员/员工端的可独立工程内容已完成，真实微信、团购和硬件现场验收按 BLOCKED_EXTERNAL 旁路。M08-D 已建立 Vue 运营总览、保洁工作台以及门店/房间管理：授权门店筛选、详情、营业时间、Wi-Fi 配置状态、门店新增/编辑/归档、房间定价/标签/图片/启停/房态/停用时段/归档均已接入既有权限与审计接口；继续后台订单管理。 |
 | M09 后台管理端完整业务 | TODO | - | - | - |
 | M10 部署、域名、验收和运维闭环 | TODO | - | - | - |