docs(M08-D): 回填后台运营总览

This commit is contained in:
Codex
2026-08-10 11:23:58 +08:00
parent 65f2e7c916
commit 04afce4417
7 changed files with 53 additions and 8 deletions
@@ -0,0 +1,29 @@
# M08-D Vue 平台后台
## 2026-08-10 运营总览与工作区导航
- `ENGINEERING_DELTA=YES`
- 后台壳层从单一保洁页面升级为“运营总览/保洁运营”可切换工作区;访问令牌分为草稿和已保存值,避免输入过程中逐字符触发请求。
- 新增授权门店运营总览,支持 7/30/90 日周期,展示成功实收与预订金额、订单/活跃/完成、OWNER 下单会员、验券成功/失败、当前房态、支付渠道和每日收入趋势。
- 核心业务导航明确区分已可用的保洁运营与后续门店、订单、会员、设备、支付增量,不把未实现页面伪装成可用入口。
- 新增 `/admin-api/statistics`,与 `/app-api/management/statistics` 共享同一路由处理与仓储权限边界;前端只调用固定 `/admin-api` 基地址。
- 新增 `scripts/check-admin-m08-d.mjs` 并接入 Windows 全量门禁,覆盖页面、统计 API、响应式样式、可用模块导航和后台路由别名。
### 测试证据
- Windows `scripts/dev/windows/test-all.ps1`:64.6 秒退出码 0;后端全测、M08-B/C/D 静态门禁、Vue TypeScript 与生产构建、域名/敏感信息/仓库完整性全部通过。
- WSL 原生临时副本 + MySQL 8.4.1028.3 秒退出码 0`up → verify → down → up → verify` 完成,136 条 up、114 条 verify、130 条 down。
- 后端路由测试同时验证 `/app-api/management/statistics``/admin-api/statistics` 返回一致统计,并保留最长 93 天限制。
- Vue 生产构建成功;已知 Element Plus chunk 超过 500kB、参考 xjar 超过 100MB 和 WSL npm 7 个 high audit 项仍为既有非阻塞提示,未执行破坏性自动升级。
### 变更影响
- 数据库:无迁移、无新增表。
- API:新增后台经营统计别名,鉴权和统计口径不变。
- 后台:新增响应式运营总览与模块切换;保洁工作台功能保持不变。
- 部署:后端与后台静态产物有变化,未自动部署生产。
- 工程提交:`65f2e7c`,已推送并验证 `HEAD == origin/main`
### 状态
M08-D 保持 `DOING`。运营总览与现有保洁工作区已接通;下一工程增量补门店与房间管理页面,不提前进入 M09。