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`。
-- 最近工程提交：`1ca783e` / `M08-D门店与房间管理`，Vue 后台已接入门店筛选/详情/安全编辑和房间定价、状态、停用时段、归档等完整运营入口。
+- 最近工程提交：`20a292e` / `M08-D后台订单运营`，Vue 后台已接入授权门店/状态筛选、分页导出、订单详情/状态流水、状态处置、备注、时段调整、续费和换房。
-- 下一工程目标：继续 M08-D，补后台订单筛选、详情与运营处置页面。
+- 下一工程目标：继续 M08-D，补后台支付、退款与分账运营页面。
 
 ## 版本递进
 

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

@@ -14,3 +14,12 @@
 | 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 后台接入既有房间列表、创建、编辑、状态、停用时段和归档接口，权限契约不变。 |
+
+## 订单运营增量
+
+| 方法 | 路径 | 变更 |
+|---|---|---|
+| GET | `/admin-api/orders` | 新增后台别名，支持 `page`、`pageSize`、`status`、`storeId`，复用订单仓储的租户和授权门店范围。 |
+| GET | `/admin-api/orders/:orderId` | 新增后台详情别名，返回服务端金额、时段、门店/房间和最近支付摘要。 |
+| GET | `/admin-api/orders/:orderId/history` | 新增后台状态流水别名，复用经理数据范围校验。 |
+| POST | `/admin-api/orders/:orderId/actions|note|adjust-time|renew|change-room` | 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 授权门店运营总览和门店/房间管理工作区；支持门店筛选、详情、营业时间、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；运营总览、门店房间和保洁工作台可切换，读写继续由后端校验租户/门店范围并写审计；下一增量补订单管理页面 |
+| 后台管理端 | 已建立 Vue3 + Vite + TypeScript + Element Plus 工程，接入 M08-B 保洁运营工作台，并新增 M08-D 授权门店运营总览、门店/房间管理和订单运营工作区；订单支持门店/状态筛选、分页/导出、详情/状态流水、状态机处置、备注、时段调整、续费和换房 | `admin/src/App.vue`、`admin/src/components/OperationsOverviewPanel.vue`、`admin/src/components/StoresRoomsPanel.vue`、`admin/src/components/OrdersPanel.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

@@ -5,3 +5,4 @@
 - 订单、OWNER 会员、成功支付、团购核销均按租户、门店和时间区间参数化过滤；房态读取当前 `qipai_rooms` 快照。
 - WSL MySQL 8.4.10 已完成 136 up、114 verify、130 down 的完整往返，并继续通过订单、成功支付、团购渠道和验券统计集成断言。
 - 门店/房间管理增量无 schema 变化；门店查询新增营业时段批量读取和 Wi-Fi 是否配置的布尔投影，Wi-Fi 密码仍不返回；门店更新省略密码时由 `COALESCE` 保留原值。
+- 订单运营增量无 schema 变化；后台 GET 别名复用现有订单、支付摘要和状态流水查询，写操作继续使用既有订单状态历史、调整记录与审计表。

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

@@ -54,3 +54,30 @@ M08-D 保持 `DOING`。运营总览与现有保洁工作区已接通；下一工
 ### 状态
 
 M08-D 保持 `DOING`。门店与房间管理增量完成；下一工程增量补后台订单筛选、详情与运营处置页面。
+
+## 2026-08-10 后台订单运营
+
+- `ENGINEERING_DELTA=YES`
+- 新增订单运营工作区，支持授权门店与十种订单状态筛选、分页、当前页 CSV 导出和页面内金额/待支付/进行中摘要。
+- 新增订单详情抽屉和完整状态流水，展示门店、房间、时段、应收/实收、最近支付渠道/状态、操作来源、操作人、原因和 traceId。
+- 接入服务端订单状态机处置、运营备注、时段调整、锁定价/当前价续费和同门店可用房间换房；前端只提交业务动作与原因，不提交目标状态或客户端计算金额。
+- 新增 `/admin-api/orders` 列表/详情和 `/admin-api/orders/:orderId/history` 后台别名，与小程序管理端共享仓储的租户、门店范围、并发冲突和审计边界。
+
+### 测试证据
+
+- Windows `scripts/dev/windows/test-all.ps1`：63.5 秒退出码 0；后端全测、M08-B/C/D 静态门禁、Vue TypeScript 与生产构建、域名/敏感信息检查均通过。
+- WSL 原生临时副本 + MySQL 8.4.10：26.9 秒退出码 0，`up → verify → down → up → verify` 完成，136 条 up、114 条 verify、130 条 down。
+- `backend/tests/order-query.test.mjs` 覆盖后台列表/详情别名，`backend/tests/order-state.test.mjs` 覆盖后台状态历史别名；Vue 生产构建成功。
+- 既有 Element Plus chunk 超过 500kB、参考 xjar 超过 100MB 和 WSL npm 7 个 high audit 项仍为非阻塞提示。
+
+### 变更影响
+
+- 数据库：无迁移、无新增表。
+- API：新增订单列表、详情和状态历史的 `/admin-api` GET 别名；既有写接口与权限契约不变。
+- 后台：新增订单筛选、导出、详情、状态流水和运营处置工作区。
+- 部署：后端与后台静态产物有变化，未自动部署生产。
+- 工程提交：`20a292e`，已推送并验证 `HEAD == origin/main`。
+
+### 状态
+
+M08-D 保持 `DOING`。订单运营增量完成；下一工程增量补支付、退款与分账运营页面。

docs/feature-status.md

@@ -18,6 +18,8 @@
 
 > 2026-08-10 M08-D 增量：工程提交 `1ca783e` 为 `STORE-001`、`ROOM-001` 建立 Vue 后台门店/房间工作区；门店筛选、详情、营业时段、Wi-Fi 配置状态、安全保留原密码的编辑，以及房间定价、标签、图片、启停、运营房态、停用时段和归档均复用既有租户/门店范围与审计边界。Windows 全量、Vue 生产构建与 WSL MySQL 8.4.10 往返通过，M08-D 继续后台订单管理。
 
+> 2026-08-10 M08-D 增量：工程提交 `20a292e` 为 `ORD-001` 建立 Vue 后台订单运营工作区；授权门店/状态筛选、分页、当前页导出、详情、支付摘要、状态流水、受控状态机处置、运营备注、时段调整、续费计价和同门店换房均复用既有服务端权限、并发冲突与审计边界。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 校验通过。 | - | 后续每模块继续复检。 |
@@ -52,7 +54,7 @@
 | MAP-001 | 地图选店和最近门店 | M03-C/M08 | PARTIAL | `4ac2c96` | 已实现 AppID/tenant 隔离门店发现、城市/营业筛选、按门店时区判断营业中、后端 Haversine 距离排序；小程序支持定位和手工城市降级，并可从门店卡片进入公开门店详情与房间列表。 | 地图 SDK 可视化和真机定位授权尚未验收。 | M08-A 继续补真机定位、地图展示和门店装修渲染。 |
 | QR-001 | 门店/房间场景码与 NFC | M03-D/M08 | PARTIAL | `d563078` | 已实现场景码生成、重建失效、撤销、扫码统计和二维码/NFC 统一页面解析；返回权限固定为空，旧码失效已在 MySQL 8.4.9 实测。 | 真实微信小程序码图片生成依赖可用 AppSecret 与真机环境。 | M08 接入微信小程序码接口并完成真机扫描验收。 |
 | WIFI-001 | 受控 Wi-Fi 凭据 | M03-D/M04/M08 | PARTIAL | `4ac2c96` | 正式订单与分享令牌均执行最小权限；M08-A 门店详情新增登录后受控 Wi-Fi 请求入口，不在未鉴权页面暴露密码。 | 真实到店权限、真机 Wi-Fi 连接和设备权限仍需现场联调。 | M08-A 补有效订单下的 Wi-Fi 真机连接验证。 |
-| ORD-001 | 预约下单与多方式支付 | M04/M05/M08 | PARTIAL | `4701674` | 已完成订单全生命周期、微信支付 v3 工程闭环和团购支付；M08-A 小程序已接入报价、预占、测试支付、余额支付、订单生产微信预支付调起、优惠券/套餐下单抵扣和可视化选择器、订单列表、订单详情、状态历史、取消测算、取消订单、续费和同门店换房入口。 | 缺真实微信和团购平台授权联调；真机支付验收待补。 | M08-A 继续补真机合法域名和真实微信支付验收。 |
+| ORD-001 | 预约下单与多方式支付 | M04/M05/M08 | PARTIAL | `20a292e` | 已完成订单全生命周期、微信支付 v3 工程闭环和团购支付；顾客端已接入下单、支付、订单详情/历史、取消、续费和换房；Vue 后台已接入授权门店/状态筛选、分页/导出、详情/状态流水、状态机处置、备注、时段调整、续费计价和同门店换房。 | 缺真实微信和团购平台授权联调；真机支付验收待补。 | M08-D 继续支付/退款运营页面；具备外部条件后补真实支付验收。 |
 | WAL-001 | 充值优惠 | M07-B/M08 | PARTIAL | `53f5d67` | 已建立充值规则和充值订单表，支持有效期、适用门店、限购、启停、clientRequestId 幂等；M08-A 新增顾客端充值计划查询、充值单创建 API、小程序充值页、微信 JSAPI 预支付调起和 WeChat Pay v3 通知验签解密入账；重复支付回调不重复充值；Windows 全量回归通过。 | 真实微信商户凭据、生产合法域名和微信侧回调仍需联调。 | M08-A 继续补余额/优惠券/套餐下单抵扣集成。 |
 | WAL-002 | 门店独立会员余额 | M07-A | DONE | `63711ad` | 已建立租户/门店余额范围策略、现金/赠送双余额账户和不可变流水；充值、赠送、消费、退款、人工调整均预留 entry type；消费按赠送后现金扣款，业务号幂等，余额不足拒绝；Windows 全量后端回归通过。 | - | M07-D 聚合会员余额和权益状态。 |
 | WAL-003 | 余额账单 | M07-A/M08 | PARTIAL | `7446852` | 账单底表已包含业务类型、业务号、现金/赠送变动、变动后余额、操作人、trace 和 metadata；M07-B 充值成功后写入真实充值流水；M08-A 个人中心已展示最近钱包账单。 | 完整分页账单页面待继续；优惠券/套餐不直接写钱包流水。 | 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: `1ca783e`
+  last_engineering_commit: `20a292e`
   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:41:05+08:00
+  updated_at: 2026-08-10T11:52:41+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 | `1ca783e` | docs/devlogs/2026-08-10-M08-D-Vue平台后台.md | M08-A 顾客端、M08-B 保洁端和 M08-C 管理员/员工端的可独立工程内容已完成，真实微信、团购和硬件现场验收按 BLOCKED_EXTERNAL 旁路。M08-D 已建立 Vue 运营总览、保洁工作台以及门店/房间管理：授权门店筛选、详情、营业时间、Wi-Fi 配置状态、门店新增/编辑/归档、房间定价/标签/图片/启停/房态/停用时段/归档均已接入既有权限与审计接口；继续后台订单管理。 |
+| M08 微信原生小程序完整业务 | PARTIAL | `20a292e` | docs/devlogs/2026-08-10-M08-D-Vue平台后台.md | M08-A 顾客端、M08-B 保洁端和 M08-C 管理员/员工端的可独立工程内容已完成，真实微信、团购和硬件现场验收按 BLOCKED_EXTERNAL 旁路。M08-D 已建立 Vue 运营总览、保洁工作台、门店/房间管理和订单运营；订单支持门店/状态筛选、分页/导出、详情/状态流水、状态机处置、备注、时段调整、续费与换房，继续支付、退款和分账运营页面。 |
 | M09 后台管理端完整业务 | TODO | - | - | - |
 | M10 部署、域名、验收和运维闭环 | TODO | - | - | - |