fix(compat): 修复真实系统性验证发现的 6 处运行时缺陷

- ResetPassword 改读官方 userPassword(已是 md5,原样落库),兼容 password/newPassword;改密后吊销该用户会话
- 修复三处 count SQL 与参数不匹配导致的 code=500;RecordList 同时补 f_monitor_id 过滤(原先会串监控记录)
- updatePasswordMessage 改 200 + data:null(官方前端每页无条件调用且不 catch)
- ensure_schema_all 不再吞掉业务包装载错误
- 路径参数非法时返回信封 400,不再吐纯文本
- 新增 tests/verify_fixes_it.rs 7 条回归;全量 661 passed,verify.sh --smoke 14 步全绿
This commit is contained in:
admin committed 2026-11-02 23:15:40 +08:00
1 parent fc31804f4e
commit 31e0e457ba
12 files changed
+755 -25

No files matched your search

+2 -2
View File
@@ -1966,7 +1966,7 @@ GET /api/permission/Users/All absent UserController.java:729 全量用户未做
GET /api/permission/Users/Selector implemented UserController.java:769 用户下拉未做
POST /api/permission/Users/UserCondition absent UserController.java:806 用户条件查询未做
GET /api/permission/Users/{id}/GetPosition implemented UserController.java:273 面 B 已落地:无 base_position 表 ⇒ 由 f_position_id 反推,包成 `[{id}]`
POST /api/permission/Users/{id}/Actions/ResetPassword implemented user.ts:37 面 B 已落地:body.password ⇒ md5;兼容 newPassword
POST /api/permission/Users/{id}/Actions/ResetPassword implemented user.ts:37 面 B 已落地:**官方字段 `userPassword` / `validatePassword`(值已是 md5)原样落库**;兼容 `password` / `newPassword`(32 位 hex 视为 md5,否则按明文 md5);改密后吊销该用户全部会话
PUT /api/permission/Users/{id}/Actions/unlock implemented user.ts:45 面 B 已落地:清 f_lock_mark / f_unlock_time / f_log_error_count
POST /api/permission/Users/getUserList implemented user.ts:49 批量选择族(可后置,未列入 v1 范围也未明确排除)
POST /api/permission/Users/getSelectedList implemented user.ts:73 批量选择族(可后置)
@@ -2553,7 +2553,7 @@ GET /api/oauth/getTicketStatus/{ticket} implemented LoginController.java:398 面
GET /api/oauth/codeCertificate implemented LoginController.java:454 面 B 已落地:与 `getTicket` 同构(`msg`=超时、`data`=凭证);扫码凭证与登录票据是**两张表**(`scc-` / `tkt-` 前缀),不串用
GET /api/oauth/codeCertificateStatus/{ticket} implemented LoginController.java:468 面 B 已落地:返官方 `LoginTicketModel` 形状;查不到返 `status=1`
GET /api/oauth/setCodeCertificateStatus/{ticket}/{status} implemented LoginController.java:507 面 B 已落地:改状态并**续期**(官方 `updateTicket` 同款);凭证不存在返 `status=1` 的空模型(不报错)
POST /api/oauth/updatePasswordMessage partial LoginController.java:269 本仓无邮件 / 短信通道 ⇒ **明确业务失败**(不假装发成功)
POST /api/oauth/updatePasswordMessage partial LoginController.java:269 本仓无邮件 / 短信通道 ⇒ **跳过发送但返 `200 + data:null`**(`msg` 说明已跳过);不能返 400 —— 官方前端 `layouts/header/index.vue:74` 每页无条件调用且不 catch
POST /api/oauth/Login/saas partial LoginController.java:554 本仓无多租户数据源切换 ⇒ **明确业务失败**
GET /api/oauth/mobilecode/saas partial LoginController.java:571 本仓无短信通道 ⇒ **明确业务失败**
POST /api/oauth/apply/saas partial LoginController.java:562 本仓未接入官方 SaaS 平台 ⇒ **明确业务失败**
+313
View File
@@ -0,0 +1,313 @@
# 真实系统性验证报告(官方前端 + dacli)
> 验证日期:2026-11-02 22:10–22:45 GMT+8
> 验证对象:`ssw-platform` 当前工作区(debug 产物,153 表数据库)
> 验证方式:**只读优先的真实 HTTP 请求 + 浏览器真跑 + dacli 真调用**
> 纪律:**本报告只记录问题,不修改任何源码、契约与既有文档**。文中所有行号均为验证当时的快照。
---
## 0. 一句话结论
**路由层是干净的**:契约里 765 条 `method+path` 在 HTTP 层 **765/765 全部注册**(OPTIONS 无一条 404),
静态闸门 `check-contract` 也是 `PASS=10 FAIL=0`。
**但运行时仍有 6 类真实缺陷**,且全部落在静态闸门的盲区:
3 个端点稳定返回 `code=500`、1 个官方「重置密码」弹窗必然失败、1 个登录后每页必现的未捕获异常、
1 个官方前端每页重连的 WebSocket 404。另有 4 个已挂菜单点进去就是 404 页。
---
## 0-bis. 修复状态(2026-11-02 23:13 更新)
| 编号 | 状态 | 落地内容 |
|---|---|---|
| P0-1 ResetPassword | **已修** | 接受官方 `userPassword` / `validatePassword`(32 位 hex 视为 md5,**原样落库**);兼容 `password` / `newPassword`;改密后吊销该用户会话。新增 2 条回归测试。 |
| P0-2 三个 500 | **已修** | `OnlineLog` 在 `modelId` 为空时不再传参;`share/Selector` 去掉多余参数;`RecordList` 补上 `f_monitor_id = $1`(同时修掉「串所有监控记录」的隐藏逻辑错误)。新增 3 条测试。 |
| P1-1 每页未捕获异常 | **已修** | `updatePasswordMessage` 改 `200 + data:null`,`msg` 说明「已跳过」;官方前端 `pageerror` 已清零。 |
| P1-2 WebSocket | **未修(有意)** | 需要一个真正的消息推送通道;返回 101 后静默挂起只会「看起来连上了」,违反本仓「不假装」原则。属功能缺口,不是缺陷修补。 |
| P1-3 四个死链菜单 | **未修(有意)** | 缺的是官方 vue 的页面组件;MVP 前端是 React 薄壳(`ssw-jnpf-lite-react`),这些菜单在那边有页面。删菜单会破坏 MVP,留到集成阶段补页面。 |
| P2-1 头像 404 | **已修(数据)** | `base_user.f_head_icon` 里的 `/upload/a.png` 已清空;三个页面 404 资源从 1 条降为 0 条。源码无此硬编码,无需改种子。 |
| P2-2 文档数字 | **已同步** | 验证期间落地的批次 20 提交已把 HANDOFF 改成 765 / 751-757 / 717-900,本次复核一致。 |
| P2-3 建库吞错 | **已修** | `ensure_schema_all` 返回 `Result<(), String>`,`packs()` 的 Err 不再被 `if let Ok` 吞掉。 |
| P3-1 非信封 400 | **已修** | 路径参数改为 `String` 接 + 手工校验,非法值返 `HTTP 200 + code=400` 信封。新增 1 条测试。 |
修复后复验:
- `cargo test --offline --workspace` = **661 passed / 0 failed**(新增 `verify_fixes_it` 7 条)。
- `bash scripts/verify.sh --smoke` = **14 步全绿**(含 perm-smoke 43、perm-smoke-jnpf 23、lowcode 15、baseline 10、mcp 14)。
- 586 条端点探针:**0 个 404 / 0 个 405 / 0 个 `code=500`**;非信封只剩 `/api/health`。
- OPTIONS 765 条:仍全部 405(无漏注册)。
- 浏览器复验:`/home`、`/permission/user`、`/permission/menu` 的 `pageerror` 与 404 资源均为空;
控制台只剩 WebSocket 404(P1-2 未修)。
---
## 1. 验证范围与方法
| 路 | 做了什么 | 规模 |
|---|---|---|
| A. 契约端点探针 | 解析 `docs/contract.md` 的 `[ENDPOINT]`,对 GET 与「带 `{id}` 的写」逐条真发请求 | 586 条 |
| B. 路由存在性扫描 | 对**全部**契约路径发 `OPTIONS`(不执行业务逻辑),404=未注册 | 765 条 |
| C. 官方前端真跑 | 系统 Chrome(Playwright)登录 `localhost:3000`,逐页抓 XHR / console / pageerror / 404 资源 | 9 个页面 |
| D. dacli 真调用 | 把 dacli 指向本仓 `127.0.0.1:30000/api`,逐命令族跑读命令 + 字典/组织/用户/角色/公告 CRUD | 30+ 命令 |
环境:
- 后端 `./target/debug/ssw-platform`,`PORT=30000`,数据目录 `src/backend/data/lite.pg`
- 前端 `~/Desktop/workspace/jnpf/7.0/frontend/web/jnpf-web-monorepo-framework`,vite `:3000`,`/dev → 30000`
- dacli `~/Desktop/workspace/dacli`(隔离 token 目录 `/tmp/dacli-ssw`,未污染其原有登录态)
---
## 2. 问题清单(按严重度)
### P0-1 「重置密码」官方前端必然失败,且字段对了也会被二次哈希(已修复)
- **端点**:`POST /api/permission/Users/{id}/Actions/ResetPassword`
- **官方 v7 事实**:`views/permission/user/ResetPassword.vue` 提交
`{ id, userPassword: md5(明文), validatePassword: md5(明文) }`
- **本仓实现**:`platform/compat/permission.rs:698-707` 只读 `password` / `newPassword`,
且把读到的值**再算一次 md5**(`md5_hex(&plain)`)
- **实测(两个方向都坏)**:
```bash
# ① 官方字段名 → 直接 400
curl -X POST .../Users/<id>/Actions/ResetPassword -d '{"userPassword":"<md5>","validatePassword":"<md5>"}'
# {"code":400,"msg":"口令不能为空","data":null}
# ② 用本仓字段传 md5 → 接口 200,但用户仍然登录不了(存进去的是 md5(md5))
curl -X POST .../Users/<id>/Actions/ResetPassword -d '{"password":"<md5>"}'
# {"code":200,"msg":"成功"}
curl -X POST /api/oauth/Login -d 'account=<user>&password=<AES(md5(123456))>'
# {"code":400,"msg":"账号或密码错误"}
```
- **附带**:`docs/contract.md:1969` 的说明也写错了 ——
「body.password ⇒ md5」与官方 v7 的 `userPassword` 口径不符,属于**契约文案与官方源码相反**。
- **测试覆盖**:`src/backend/tests/*.rs` 全仓 **0 处** `ResetPassword` ⇒ 静态闸门与单测都抓不到。
- **影响**:管理员在官方前端给任何人重置密码 100% 失败;用 curl 绕过去还会把口令写坏。
---
### P0-2 三个端点稳定 `code=500`:count SQL 没有占位符却传了参数(已修复)
三个端点返回**同一个根因**:`SELECT count(*) ...` 的 SQL 串里没有 `$N`,但代码仍把参数数组传了进去
⇒ pglite 报 `protocol error: statement takes 0 parameters, 1 given` ⇒ 被 `db_error` 兜成
`{"code":500,"msg":"系统异常,请联系管理员"}`。
| # | 端点 | 代码位置 | 服务端日志 |
|---|---|---|---|
| 1 | `GET /api/visualdev/OnlineLog` | `compat/online_dev.rs:2333-2350` | `[face-b] 在线日志总数查询失败: statement takes 0 parameters, 1 given` |
| 2 | `GET /api/visualdev/share/Selector` | `compat/online_dev.rs:2261-2272` | `[face-b] 跨应用功能查询失败: statement takes 0 parameters, 1 given` |
| 3 | `GET /api/message/Monitor/{id}/RecordList` | `compat/msg_center.rs:180`(`paged_query` 的 count 分支) | `[face-b] 消息发送记录列表总数查询失败: statement takes 0 parameters, 1 given` |
复现(三条都不依赖库里有没有数据):
```bash
T=<admin token>; H=(-H "Authorization: $T" -H 'Vue-Version: 3' -H 'App-Code: mainSystem')
curl -s localhost:30000/api/visualdev/OnlineLog "${H[@]}"
# {"code":500,"msg":"系统异常,请联系管理员","data":null}
curl -s localhost:30000/api/visualdev/share/Selector "${H[@]}"
# {"code":500,...}
curl -s localhost:30000/api/message/Monitor/xxx/RecordList "${H[@]}"
# {"code":500,...}
```
- **用户影响**:`OnlineLog` 与 `RecordList` 都被官方前端真实调用
(`api/onlineDev/visualDev.ts:5`、`api/msgCenter/msgMonitor.ts:24-25`)⇒ 对应页面打开即 500。
`share/Selector` 在官方 v7 前端里**没有调用点**,属于契约里遗留的孤儿端点,影响较低。
- **测试覆盖**:三个路径在 32 个集成测试文件里 **0 处**出现。
- **为什么闸门全绿**:`check-contract` 只比对路由/守卫/归属,不看 SQL 参数个数。
---
### P1-1 登录后每个页面必现一个未捕获异常(`updatePasswordMessage` 故意 400)(已修复)
- **端点**:`POST /api/oauth/updatePasswordMessage`
- **本仓**:`compat/core.rs:296` ⇒ `unsupported("修改密码提醒(没有邮件 / 短信通道)")`
⇒ `code=400`。契约 `docs/contract.md:2556` 把这条标成 `partial`「明确业务失败」,**是有意为之**。
- **官方前端**:`layouts/header/index.vue:74` 在布局挂载时**无条件调用且没有 catch**。
- **实测**:每个已登录页面都出现
```
pageerror: Error: 本极简引擎不支持修改密码提醒(没有邮件 / 短信通道)
```
- **判定**:单看后端「不假装成功」是对的;但**两端合起来是一个缺陷** ——
官方前端会把它当成功路径走。要么该端点返回 `200 + data:null`(能力缺失不阻断),
要么由前端兜底;当前形态让每个页面都带一条未捕获 Promise 异常。
---
### P1-2 WebSocket 完全未实现,官方前端每页重连失败
- **官方前端**:`hooks/web/useWebSocket.ts:21`,dev 模式连接
`ws://<host>:30000/api/message/websocket/<token>`
- **本仓**:`docs/contract.md` 与 `src/backend/src` 里 **grep 不到任何 websocket 字样**
⇒ 握手 404。
- **实测 console(每个页面都有,且反复重连)**:
```
WebSocket connection to 'ws://localhost:30000/api/message/websocket/lite-...' failed:
Error during WebSocket handshake: Unexpected response code: 404
```
- **影响**:站内消息/待办推送不可用;控制台持续噪声;`reconnecting-websocket` 会一直重试。
---
### P1-3 四个已挂菜单点进去就是 404 页
官方前端能读到这些菜单,但 `src/views/` 下**没有对应页面组件**:
| 菜单 | 点击后的真实路由 | 实测 |
|---|---|---|
| Demo 示例 | `/permission/demo-item` | 404 页 |
| 产品管理 | `/permission/shop/product` | 404 页 |
| 图书超市 | `/permission/books/book` | 404 页 |
| 数据资源 | `/permission/asset/dataResource` | 404 页 |
> 路由不是 `/<urlAddress>`,而是父菜单 `permission` 拼上 urlAddress 后再小写化
> (实测点「产品管理」落到 `/permission/shop/product`)。四条都用浏览器直接访问复核过。
- **证据**:`ls src/views | grep -E 'demo|shop|books|asset'` ⇒ 无;
浏览器访问上述 4 条路由,页面正文为「哎呀!未找到页面」。
- **影响**:后端种子/业务包把这些菜单挂进了 `base_module`,官方前端也渲染了,
但点击后是死链。要么集成阶段补页面,要么 MVP 阶段别种这些菜单。
---
### P2-1 用户头像 `headIcon=/upload/a.png` 不存在,每页一个 404 资源(已修复)
- 种子把 admin 的 `f_head_icon` 写成 `/upload/a.png`,后端**没有文件服务**
⇒ 浏览器每次渲染头像都 404。
- 实测:4 个业务页 + 所有系统页的 `badRes` 都含 `404 image /dev/upload/a.png`。
---
### P2-2 交接文档数字:验证开始时是旧数,批次 20 提交已同步(复核一致)
| 指标 | 验证开始时 HANDOFF | 本次实测 | 22:29 批次 20 提交后 |
|---|---|---|---|
| 契约端点数 | 714 | **765** 条 `method+path`(唯一路径 589) | 已改为 765 |
| 官方端点覆盖 | 700/706(537/163/6) | **751/757**(581/170/6;oos 4 单列) | 已改为 751/757 |
| fe-gap 覆盖 | 667/900(74.1%) | **717/900(79.7%)** | 已改为 717/900 |
- 复现:`bash scripts/check-contract.sh`、`python3 scripts/fe-gap.py`
- **结论**:旧数确实会低估 50 条缺口;但验证期间落地的批次 20 提交已经把这三个数字改对了,
本次复核与实测一致 ⇒ **当前文档无需再改**。后续排期按 HANDOFF 现在的数即可。
---
### P2-3 业务包表曾经缺失,但重启后自愈(已修复吞错分支)
- 现象:验证早期 `GET /api/asset/DataResource` 返回
`{"code":400,"msg":"系统异常"}`,服务端日志
`relation "asset_data_resource" does not exist`;
`GET /api/system/DataModel/0/Tables?pageSize=500` 只有 **152** 张表(缺业务包那 1 张)。
- 重启后端后同一条请求变 `200 + 空列表`;用全新数据目录(`PGLITE_DIR=/tmp/testpg`)冷启动,
`asset_data_resource` **存在**。
- **可疑点**:`src/backend/src/bootstrap.rs:172` 是 `if let Ok(reg) = packs() { ... }`
—— 包装载失败会被**静默吞掉**,只建平台表、不建业务表,启动仍然成功。
`main.rs` 第 3b 步虽然先校验过 `packs()`,但这条吞错分支会让「两段建库」的第二段在异常时无声消失。
- **建议**:先确认那次是历史库漂移还是真发生过 `packs()` Err;若是后者,这条吞错必须改。
---
### P3-1 路径参数类型不合法时返回**非信封**的纯文本 400(已修复)
- 端点:`GET /api/system/ModuleDataAuthorizeLink/{linkId}/Tables/{tableName}/Fields/{menuType}/{dataType}`
- 把 `menuType` / `dataType` 传成非数字(例如 UUID)时:
```
HTTP 400
Invalid URL: Cannot parse value at index 2 with value `00000000-...`
```
- 这是 axum `Path` 反序列化拒绝,**没走 `ActionResult` 信封**。
合法值(`menuType=1&dataType=1`)时返回正常 `200 + {list,pagination}`。
- 与 `docs/known-limitations.md` 里「(l) 已推翻」那条不是同一路径:那条是畸形百分号编码,
这条是**类型不匹配**,仍然会吐非信封响应。
---
## 3. 已验证正常的部分(避免只看到坏消息)
| 验证项 | 结果 |
|---|---|
| 全部契约路由注册 | `OPTIONS` 扫描 **765/765** 返回 405(无 404)⇒ 无漏注册路由 |
| 实际请求 | 586 条探针 **0 个 404「接口不存在」、0 个 405、0 个 HTTP 5xx** |
| 登录/认证 | `POST /api/oauth/Login` 成功;`CurrentUser`、`getLoginConfig`、`getConfig` 全 200 |
| RBAC | 普通用户(`role_user`)访问 `/api/permission/Users`、`/api/permission/Role` ⇒ **403 无权限**(判据生效) |
| 角色绑定 | `POST /api/permission/RoleRelation/addRoles` ⇒ 200,`roleList` 能读回 |
| 字典 CRUD | `type-create`(含 2 个子项)→ `type-list` → `type-update` → `data-update` → `type-delete` 全通 |
| 组织 CRUD | `org create` → `org list` → `org delete` 全通 |
| 用户 CRUD | `POST/PUT/DELETE /api/permission/Users` 全通;`ResetPassword` 用本仓字段传**明文**后可登录(传官方 md5 会失败,见 P0-1) |
| 角色 CRUD | `POST/DELETE /api/permission/Role` 全通(dacli 报错但数据已落库,见 §4) |
| 公告 | `POST /api/message/Notice`(v7 字段 `title/bodyText/category`)→ `POST /Notice/List` → `DELETE` 全通 |
| 系统页面渲染 | `/home`、`/permission/user`(1 行)、`/permission/role`、`/permission/organize`(空数据)、`/permission/menu`(10 行)均正常渲染 |
| 静态闸门 | `check-contract.sh` ⇒ `PASS=10 FAIL=0`,12 条反自证全过 |
---
## 4. dacli 侧口径落后(**不算本仓缺陷**,但会污染验证结论)
dacli 的部分命令仍按 JNPF v6 的端点/字段写死,与本机 v7 官方前端源码不一致:
| dacli 命令 | dacli 实际请求 | v7 官方事实 | 结论 |
|---|---|---|---|
| `msg template-list` | `GET /api/message/MessageTemplateConfig` → 404 | `api/msgCenter/msgTemplate.ts`:`/api/message/Template` | dacli 落后 |
| `msg notice-create` | `fullName` / `enCode` / `body` → 400「公告标题缺失」 | `views/msgCenter/notice/Form.vue`:`title` / `bodyText` / `category` | dacli 落后 |
| `schedule list` | `GET /api/teamwork/Schedule` → 404 | v7 是同名但语义为「日程安排」:`/api/system/Schedule`;定时任务另有模块 | dacli 落后 |
| `role create` | 数据已创建,却报 `code=undefined` 失败 | `POST /api/permission/Role` 实返 `{code:200,data:{id}}` | dacli 的 webapi shim 把 `data` 当 envelope |
| `bigscreen *` | 需要 `~/Desktop/workspace/jnpf-web-datascreen-vue3/src/api/visual.js` | 本机没有该子工程 | 环境缺件 |
| `app status` | 用 `GET /api` 探活 → 404 | 官方无此探活约定 | dacli 约定 |
| `dm list` | 默认 `pageSize=50`,只显示前 50 张 | 后端支持 `pageSize=500` 返回 152 | dacli 默认值 |
**结论**:dacli 的失败必须先对照 `apps/jnpf-web-apps-main/src/api/**.ts` 复核,不能直接计为本仓缺陷。
真正经得起复核的 dacli 发现只有:ResetPassword 失败、`updatePasswordMessage` 报错、`asset` 端点曾 500。
---
## 5. 附:探针统计与可复现资产
| 项 | 数值 |
|---|---|
| 契约 `[ENDPOINT]` 行数 | 765(唯一 method+path 765;唯一路径 589) |
| 实际请求探针 | 586(GET 355 + 带 id 写 231) |
| 其中 `code=200` | 293 |
| 其中业务失败 `code=400` | 292(多为「数据不存在」「未配置文件服务」等**诚实失败**) |
| 其中 `code=500` | **0**(修复前 3,见 P0-2) |
| 非信封响应 | 1(仅 `/api/health`,设计如此;P3-1 修复前另有 1 条纯文本 400) |
| OPTIONS 路由扫描 | 765 全 405,0 个 404 |
脚本(临时,未入库):
- `/tmp/probe_contract.py` —— 586 条真实请求探针,输出 `/tmp/contract-probe.json`
- `/tmp/options_scan.py` —— 765 条 OPTIONS 路由扫描,输出 `/tmp/options-scan.json`
- `/tmp/web-verify2.cjs`、`/tmp/web-verify3.cjs` —— Playwright 登录 + 逐页抓包
- `/tmp/dacli.sh` —— 指向本仓的 dacli 包装(隔离 token)
---
## 6. 附:本次验证对环境的改动与恢复(透明记录)
- 写探针早期误把真实 admin / role_admin / m_sys / businessType 的 id 用作 `DELETE` 的目标,
导致这 4 行被**软删**(admin 一度无法登录)。已用一次性维护程序把
`f_delete_mark` 复位为 0,并复核登录与列表恢复正常。
- `PUT /Users/{admin}` 验证字段映射时写入 `nickName=admin`,已复位为 `NULL`。
- admin 行里的 `f_head_icon=/upload/a.png` 已清空(源码没有这个硬编码,属历史数据)。
- 测试创建的字典类型、角色×2、公告×2、组织、用户×2 均已删除(软删,符合本仓删除语义)。
- dacli 使用独立 token 目录,未改动其 `~/.dacli-token/token.json`;
`~/.dacli/config.json` 被指向 `http://127.0.0.1:30000/api`(验证需要;未改项目代码)。
- 未修改任何源码、契约、既有文档。
---
## 7. 建议的下一步(1/2/3/5/6 已于 23:13 执行;4 与死链菜单未执行)
1. **P0-2 三个 count SQL**:最小修复是「SQL 无 `$N` 时不要传参数」,并各补一条集成测试。
2. **P0-1 ResetPassword**:按 v7 改读 `userPassword`(已是 md5)并**不再二次哈希**;
同时改 `docs/contract.md:1969` 的错误说明。
3. **P1-1**:`updatePasswordMessage` 改 `200 + data:null`(能力缺失不阻断),或前端补 catch。
4. **P1-2**:WebSocket 要么实现,要么在契约里显式标 `oos` 并让前端可关闭。
5. **P1-3**:MVP 阶段先撤掉 4 个无页面的业务菜单,避免死链。
6. **P2-3**:复核 `bootstrap.rs:172` 的 `if let Ok(reg) = packs()` 吞错分支。