docs(M08-D-R1): 回填后台架构返工与游标

This commit is contained in:
Codex
2026-08-10 20:59:17 +08:00
parent 3faf86872d
commit b507e87999
5 changed files with 41 additions and 17 deletions
@@ -308,3 +308,25 @@ M08-D 保持 `DOING`。审计日志与系统配置增量完成;下一工程增
### 状态
M08-D 可独立工程内容完成。M08 真实微信、团购和硬件现场验收继续保持 `PARTIAL/BLOCKED_EXTERNAL`,执行游标按规则进入 M09-A 保洁任务状态机复核与补齐。
## 2026-08-10 M08-D-R1 后台架构与性能返工
- `ENGINEERING_DELTA=YES`
- 保留既有 12 个业务功能页,将 `App.vue` 收口为登录、会话恢复、权限布局和 `RouterView`;业务页通过 `/overview``/stores``/orders``/payments``/third-party``/people``/cleaning``/devices``/apps``/content``/franchise``/system` 独立深链接访问。
- 路由同时校验服务端 `menus` 和 capability/平台角色,未授权深链接确定回落到首个可访问入口;刷新通过 `/auth/me` 恢复身份,401 继续复用单航班令牌轮换,懒加载失败展示可重载恢复界面。
- 清洁工作台从 `App.vue` 原样抽入 `CleaningWorkspace.vue`;旧 M08-B/D 静态门禁同步兼容新结构,未重写第二套业务流程。
- Element Plus 改为组件按需解析,12 个业务页均生成独立异步块;最大 JS 分块为 217,195 B,入口 gzip 74.94 KiB,原 923.28 KiB 单块警告消除。总门禁新增原生命令失败退出检查,避免子命令失败被后续命令掩盖。
### 测试证据
- `admin/npm run verify:r1`:类型检查、Vite 生产构建、深链接/菜单/capability/刷新回落测试、源码架构检查和产物分块检查通过;`npm audit --omit=dev` 为 0 个漏洞。
- in-app Browser 生产预览:1440×900、768×900、375×812 三档均无横向溢出;375 下卡片边界为 18–357.33 px,输入框和按钮全部位于视口内;控制台 warning/error 为 0。
- Windows `scripts/dev/windows/test-all.ps1`:69.1 秒退出码 0;包含后端全测、迁移契约、M08-B/C/D 兼容门禁、M08-D-R1 源码/产物门禁、Vue 类型检查/生产构建、敏感信息和仓库完整性检查。
- 构建仅保留 `@vueuse/core` 的第三方 PURE 注释位置提示,不隐藏 warning;所有 JS 分块均低于 Vite 500 KiB 阈值。
### 变更影响与状态
- 数据库/API:无迁移、无接口语义变更;继续复用既有后台会话与权限响应。
- 后台:新增 Vue Router、按需组件解析、路由会话状态和三档响应式收口;未自动部署生产。
- 工程提交:`3faf868`,已推送并验证 `HEAD == origin/main`
- M08-D-R1 完成;M08 因真实微信、团购和硬件现场条件继续保持 `PARTIAL/BLOCKED_EXTERNAL`。执行游标进入 M09-B。