refactor(arch): M1 解耦 —— 拆掉三处跨 crate 循环依赖 + 加 AR10/AR11 闸门

平台能力全迁 crates/ 的迁移计划见 docs/CRATES-MIGRATION.md(基线 tag v0.1.0)。
本批次 = M1:先把三处跨 crate 循环依赖解开,否则后续拆 crate 时编译器直接报错。

断环(实测定位,非推断):
- 环 A(平台层 → 契约面):auth.rs 的面 B 判据改走契约层唯一真源
  sspf_contract::headers::is_face_b;面 B 分流点上移到装配根 routes.rs,
  平台层与契约面互不知道对方;resolve_user 由 pub(crate) 提为 pub。
- 环 B(契约面底座 helper ↔ system):menu_node / official_view_path 搬进 helper。
- 环 C(契约面底座 helper ↔ permission):USER_DETAIL_COLUMNS / organize_name_of 搬进 helper。

闸门:
- 新增 AR10「平台层不许反向依赖契约面」(拆 crate 的前置条件)。
- 新增 AR11「契约面底座 helper 不许依赖其它契约面模块」(14 个模块依赖它 ⇒ 反向依赖即成环)。
- 反自证由 4 条扩到 6 条(新增 AR10/AR11 两条真实违规注入),确认尺子能抓到。

影响:功能零变化(面 A / 面 B 的响应形状、路由、语义均未动),仅为依赖方向解耦。
验证:cargo build 零警告;cargo test --workspace 695 passed / 0 failed(与基线一致);
check-arch 14/14;--self-test 6/6;check-boundary 11/11;check-contract 10/10;
check-module 123/123;check-citations 4/4;verify --smoke 14 步全绿。
This commit is contained in:
admin committed 2026-11-03 13:25:06 +08:00
1 parent 1694e77324
commit 8f2041c103
10 files changed
+385 -131

No files matched your search

+13
View File
@@ -65,3 +65,16 @@
- 🔴 **踩坑(工具)**:`grep -o "use crate::[a-z_:]*"` 对 `use crate::platform::auth::require_login_face_b;` 这类**长路径**返回空 ⇒ 一度误判「helper 不依赖 auth、环不存在」。**结论:查依赖必须用 Grep 工具(ripgrep)或有界正则,别用 `grep -o` 配贪婪/字符类**;凡是要写进计划的依赖结论,**逐条 `sed -n 'Np'` 核对行号**。
- **数字**:壳(routes+main+bootstrap+modules+转发)**5,664 行** vs 要搬走的平台能力 **≈61,500 行**;crates **7 → 15 个**;`src/backend/src` 90,471 行,目标 ≤ 8,000。
- **待确认决策(4 个,§11)**:`platform/` 转发壳删不删 / compat 拆 6 个还是 3 个 / `mcp_compat.rs` 放 crates 还是留壳 / `tests/` 要不要跟着拆。
### 12:30–13:10 M1 完成:三处循环依赖全部解开(tag v0.1.1-m1)
- **触发**:用户「去执行吧」⇒ 执行 `docs/CRATES-MIGRATION.md` 的 M1(解耦批次)。
- 🔴 **实际做法与原计划有两处偏差(都比原计划简单)**:
1. **不用运行期注册表** —— 面 B 分流直接**上移到装配根 `routes.rs:77`**(`is_face_b` → `compat::helper::current_user`,否则 → `auth::current_user`)。`CLAUDE.md` §4 本就设计成「共用两条路由按判别头分流」,**装配根是唯一同时认识平台层与契约面的地方** ⇒ 平台层与契约面互不知道对方。
2. **不新建 `compat_base/` 目录** —— 4 个符号(`menu_node` / `official_view_path` / `USER_DETAIL_COLUMNS` / `organize_name_of`)**直接搬进 `helper.rs` 本身**。
- 🔴 **修正原计划环 B/C 的方向错误**:原计划写「把符号搬回 system/permission 侧」是**错的** —— `helper` 被 **14 个**契约面模块依赖,符号必须在 helper 里;放回 system/permission ⇒ helper 又得依赖它们 ⇒ **环还在**。
- **改动(6 源文件 + 4 文档)**:`platform/auth.rs`(判据改走 `sspf_contract::headers::is_face_b`;`current_user` 去掉面 B 分流;`resolve_user` `pub(crate)`→`pub`)/ `routes.rs`(分流点上移)/ `compat/helper.rs`(+4 符号,-2 依赖)/ `compat/system.rs`(-2 函数)/ `compat/permission.rs`(-2 符号)/ `scripts/check-arch.sh`(**新增 AR10/AR11**)。
- 🔴 **AR10 误报 `registry.rs:14`** —— 那行是文档注释 `//! (见 [... crate::platform::compat::helper::load_menus])`,原过滤 `grep -v '^\s*//'` 漏掉**无空格**的 `//!`。**修法:AR10 改成 Python 逐行判**(跳过 `s.startswith('//')` 的整行注释 + `line.split('//',1)[0]` 截行尾注释),与 MEM1/MEM2 同一套路。**教训:闸门判据要用和 MEM 同一套逐行判,别混用 grep** —— 漏判比误报危险(虚假安全感)。
- **新增防回退闸门**:**AR10**(平台层不许 `use crate::platform::compat`)= 拆 crate 的前置条件;**AR11**(契约面底座 helper 不许 `use super::<非helper>`)= 14 个模块依赖它 ⇒ 反向依赖即成环。**反自证从 4 条扩到 6 条**(5/6 造 `use crate::platform::compat::helper::current_user`;6/6 备份 helper.rs 后追加 `use super::system::menu_node` 再还原)。
- **数字**:`cargo build --workspace` 零警告;`cargo test --workspace` **695 passed / 0 failed**(与基线**完全一致**);`check-arch.sh` **14/14**;`check-arch.sh --self-test` **6/6**;`check-boundary.sh` 11/11;`check-contract.sh` 10/10;`check-module.sh` 123/123;`check-citations.sh` 4/4;`verify.sh --smoke` 14 步全绿(478.2s)。
- ⏭ **下一步 = M2(`sspf-core` 平台核心下沉)**:迁 `platform/{auth,session,authorization,crud,sys,menu,guard,monitor,registry,state,seed,variate_catalog}.rs` + `{cipher,envelope,ids,config,db}.rs`。**关键是保留 `platform/*.rs` 作为 `pub use sspf_core::*` 转发壳** ⇒ 上层零感知、695 个测试**不用改 import**。
+3 -3
View File
@@ -223,7 +223,7 @@ ssw-platform/
| 静态 | `scripts/check-boundary.sh` | 分层红线 CP1–CP6(平台层不许有业务知识) | 已绿(11/11) |
| 静态 | `scripts/check-contract.sh` | 契约端点表 ↔ 代码真实路由(CC2–CC10,含官方端点台账 CC10) | 已绿(10/10) |
| 静态 | `scripts/check-citations.sh` | 文档引文 `路径:行号` 逐条核对 | 4/4 已绿(192 条引文全解析;CIT3 依赖官方 DDL,缺失则 `⏭`) |
| **静态·架构** | **`scripts/check-arch.sh`** | **crate 依赖纪律 AR1–AR7 + 内存红线 MEM1–MEM2(`--self-test` 反自证)** | **9/9 已绿** |
| **静态·架构** | **`scripts/check-arch.sh`** | **crate 依赖纪律 AR1–AR11 + 内存红线 MEM1–MEM2(`--self-test` 反自证 6 条)** | **14/14 已绿** |
| **静态·命名** | **`scripts/check-naming.sh`** | **内部标识剥离 NM1–NM3 阻断 + NM4 注释量化(`--strict` 可升级)** | **3/0 已绿(69 处注释技术债)** |
| 契约尺子·面 A | `scripts/perm-smoke.sh` | 43 条(面 A 契约闭环 32 + 真实业务模块 asset 9 + 多应用 `App-Code` 路由 2) | 已绿 |
| 契约尺子·面 B | `scripts/perm-smoke-jnpf.sh` | 23 条(官方形状 18 + 多应用 `App-Code` 路由 1 + 用户 CRUD 4,诚实记 SKIP) | **23/23 已绿** |
@@ -297,8 +297,8 @@ bash scripts/perm-smoke-jnpf.sh # 面 B 23 条
bash scripts/check-boundary.sh # 分层红线 CP1–CP6
bash scripts/check-contract.sh # 契约端点 ↔ 代码路由 对账
bash scripts/check-module.sh # 业务模块 10 接触点
bash scripts/check-arch.sh # crate 依赖纪律 AR1–AR7 + 内存红线 MEM1–MEM2
bash scripts/check-arch.sh --self-test # 反自证:造违规必须被抓到
bash scripts/check-arch.sh # crate 依赖纪律 AR1–AR11 + 内存红线 MEM1–MEM2
bash scripts/check-arch.sh --self-test # 反自证:造违规必须被抓到(6 条)
bash scripts/check-naming.sh # 内部标识剥离(NM1–NM3 阻断 / NM4 注释量化)
bash scripts/check-naming.sh --strict # 注释里的原厂名也算红(技术债清零时用)
bash scripts/mcp-smoke.sh # MCP 工具层契约 48 条(4 元工具 + 分层加载 + 授权闭环 + prompts + 低代码 CRUD)
+40 -7
View File
@@ -33,11 +33,11 @@
**🔴 三处循环依赖(跨 crate 前必须先解开,否则编译不过)**:
| 环 | 涉及 | 解法 | 难度 |
| 环 | 涉及 | 解法 | 状态 |
|---|---|---|---|
| A | `platform/auth.rs` ↔ `compat/helper.rs` | ✅ `sspf_contract::headers::is_face_b` **已存在** ⇒ `auth.rs:336/403` 改一行;面 B `current_user` 改注册表回调 | 🟡 中 |
| B | `compat/helper.rs` ↔ `compat/system.rs` | helper 下沉成 `sspf-compat-core`;`menu_node`/`official_view_path` 留 system | 🟡 中 |
| C | `compat/helper.rs` ↔ `compat/permission.rs` | 同上;`USER_DETAIL_COLUMNS`/`organize_name_of` 留 permission;**22 个符号**逐个归属 | 🔴 高 |
| A | `platform/auth.rs` ↔ `compat/helper.rs` | ✅ `sspf_contract::headers::is_face_b` **已存在** ⇒ 判定边改一行;面 B `current_user` 的**分流点上移到装配根 `routes.rs`** | ✅ M1 已解 |
| B | `compat/helper.rs` ↔ `compat/system.rs` | ✅ `menu_node` / `official_view_path` **搬进 helper** | ✅ M1 已解 |
| C | `compat/helper.rs` ↔ `compat/permission.rs` | ✅ `USER_DETAIL_COLUMNS` / `organize_name_of` **搬进 helper** | ✅ M1 已解 |
**✅ 已验证 `platform/` 内部 17 个文件无环**(依赖全单向向下)⇒ **M2 核心下沉不受环影响**,可独立推进。
@@ -47,11 +47,44 @@
**M4 之后必须同步改这些脚本,并重跑 `--self-test`。**
**批次划分**:M1 解耦 → M2 `sspf-core` → M3 `sspf-compat-core` → M4 六个 compat 包
→ M5 `sspf-lowcode-exec` → M6 `sspf-mcp-adapter` → M7 收口 + AR10–AR13。
→ M5 `sspf-lowcode-exec` → M6 `sspf-mcp-adapter` → M7 收口 + AR12–AR13。
**每批次独立 commit + 独立 tag(`v0.1.N-mX`),不合绿不进下一批。**
**下一步 = 执行 M1**(见 `docs/CRATES-MIGRATION.md` §4 M1 的 8 步动作表)。
⏳ **计划里有 4 个待确认决策**(§11),其中「platform/ 转发壳删不删」「compat 拆几个包」需要拍板。
---
## 0-0-pre2. 2026-11-03 12:55 **M1 完成**:三处循环依赖全部解开(tag `v0.1.1-m1`)
**做了什么**:解开 `auth ↔ compat/helper`、`helper ↔ system`、`helper ↔ permission` 三处环,
并加 **AR10/AR11 两条防回退闸门**(带反自证)。
**🔴 实际做法与原计划有出入(两处,都是「更简单」)**:
1. **不用运行期注册表**(原计划第 3 项)⇒ 改为把**分流点上移到装配根 `routes.rs`**。
`CLAUDE.md` §4 本来就写明「共用两条路由按判别头分流」⇒ 分流点本就该在壳。
而且**没有 `OnceLock` 静态槽位、没有注册时机、没有漏注册的风险**。
平台层与契约面从此**互不知道对方**,壳负责接线。
2. **不用新建 `compat_base/` 目录** ⇒ 4 个符号**直接搬进 `helper` 本身**:
`menu_node` / `official_view_path`(从 system)、`USER_DETAIL_COLUMNS` / `organize_name_of`(从 permission)。
**🔴 环 B/C 的方向修正**:原计划说「把符号搬**回** system / permission 侧」—— **错**。
helper 被 14 个模块依赖 ⇒ 符号在 helper 里大家都能用;
符号在 system/permission 里 ⇒ helper 又得依赖它们 ⇒ **环还在**。
**改动清单**:
- `platform/auth.rs`:`is_face_b` 改用契约层;面 B 分流移出;`resolve_user` `pub(crate)` → `pub`
- `routes.rs`:`CurrentUser` 路由按判别头分流(面 A → `auth::current_user`;面 B → `compat::helper::current_user`)
- `compat/helper.rs`:接收 4 个符号
- `compat/system.rs` / `compat/permission.rs`:移除 4 个符号 + 改 import
- `scripts/check-arch.sh`:**新增 AR10/AR11** + **反自证从 4 条扩到 6 条**
**出口判据(全部达成)**:
`cargo build` **零警告**;`cargo test --workspace` = **695 passed / 0 failed**(与基线一致);
`check-arch.sh` = **14/14**;`--self-test` = **6/6**;`check-boundary` 11/11;`check-contract` 10/10;
`check-module` 123/123;`check-citations` 4/4;`check-naming` 3/0;
`verify.sh --smoke` **14 步全绿**(478s)。
**⏭ 下一步 = M2(`sspf-core` 平台核心下沉)**。M2 的关键是**保留 `platform/` 转发壳**
(`pub use sspf_core::*`)⇒ 上层零感知、695 测试不用改 import。
---
+51 -25
View File
@@ -2,7 +2,8 @@
> **基线锚点**:`v0.1.0`(commit `b957a11`,已推送到 `origin`)
> **制定时间**:2026-11-03
> **状态**:计划已制定,尚未执行(第一步 = 解耦)
> **状态**:**M1 已完成**(tag `v0.1.1-m1`)—— 三处循环依赖全部解开;
> 下一步 = M2(`sspf-core` 平台核心下沉)
---
@@ -162,10 +163,11 @@ permission.rs:29 use super::helper::{...}; // ← 22 个符号
| 环 | 涉及 | 解法 | 难度 |
|---|---|---|---|
| A | auth ↔ compat/helper | ✅ **`sspf_contract::headers::is_face_b` 已存在** ⇒ `auth.rs:336/403` 改一行断掉一条边;面 B `current_user` 改为注册表回调 | 🟡 中(比预想低) |
| B | compat/helper ↔ compat/system | helper 下沉成 `sspf-compat-core`;`menu_node`/`official_view_path` 留在 system 包 | 🟡 中 |
| C | compat/helper ↔ compat/permission | 同 B;`USER_DETAIL_COLUMNS`/`organize_name_of` 留在 permission 包 | 🔴 高(22 个符号逐个归属) |
| A | auth ↔ compat/helper | ✅ **`sspf_contract::headers::is_face_b` 已存在** ⇒ 判定边改一行断掉;面 B `current_user` 的**分流点上移到装配根 `routes.rs`** | 🟡 中(比预想低) |
| B | compat/helper ↔ compat/system | ✅ `menu_node` / `official_view_path` **搬进 helper**(它们只依赖 helper 自己的东西) | 🟢 低(已解) |
| C | compat/helper ↔ compat/permission | ✅ `USER_DETAIL_COLUMNS` / `organize_name_of` **搬进 helper**(helper 已有 `Db` 依赖) | 🟢 低(已解) |
> ✅ **三个环已于 M1 全部解开**(详见 §4 M1 实际做法表)。
> **好消息**:三个环**全部集中在 `compat/` 内部 + auth 一处**,
> 而 `platform/` 其它 17 个文件(auth/session/crud/sys/…)**互相之间没有环**
> ⇒ M2(核心下沉)**不受环影响**,可以独立推进。
@@ -259,29 +261,53 @@ ssw-platform/
**目标**:消除 A/B/C 三个环,但代码**仍在** `src/backend/` 里(用模块重命名,不搬 crate)。
| # | 动作 | 文件:行 | 断掉的边 |
|---|---|---|---|
| 1 | `auth.rs` 改用 `sspf_contract::headers::is_face_b`(**已存在**) | `platform/auth.rs:336` | auth → compat(判定边) |
| 2 | 同上 | `platform/auth.rs:403` | auth → compat(判定边) |
| 3 | 面 B `current_user` 改为**注册表回调**(壳启动时注册) | `platform/auth.rs:337` + `compat/helper.rs:391` | auth → compat(形状边) |
| 4 | `resolve_user` 提为 `pub` | `platform/auth.rs:436`(`pub(crate)` → `pub`) | 供 compat 侧调用 |
| 5 | helper 的公共符号下沉 | `platform/compat/helper.rs` → 新 `platform/compat_base/` | 环 B/C 的一半 |
| 6 | `menu_node` / `official_view_path` 搬回 system 侧 | `compat/system.rs:42,32` | 环 B |
| 7 | `USER_DETAIL_COLUMNS` / `organize_name_of` 搬回 permission 侧 | `compat/permission.rs:374,32` | 环 C |
| 8 | permission 的 22 个反向符号逐个归属 | `compat/permission.rs:29` | 环 C 收尾 |
| # | 动作 | 文件:行 | 断掉的边 | 实际做法 |
|---|---|---|---|---|
| 1 | `auth.rs` 改用 `sspf_contract::headers::is_face_b`(**已存在**) | `platform/auth.rs` | auth → compat(判定边) | ✅ 直接调契约层,不绕 compat |
| 2 | 同上(`require_login_any`) | `platform/auth.rs` | auth → compat(判定边) | ✅ 同上 |
| 3 | 面 B `current_user` 的**分流点上移到装配根** | `platform/auth.rs` + `routes.rs:77` | auth → compat(形状边) | ✅ **不用注册表** —— 分流点移到 `routes.rs`(壳) |
| 4 | `resolve_user` 提为 `pub` | `platform/auth.rs` | 供 compat 侧跨 crate 调用 | ✅ `pub(crate)` → `pub` |
| 5 | `menu_node` 搬进 helper | `compat/system.rs` → `compat/helper.rs` | 环 B | ✅ 它只依赖 helper 自己的 `menu_value` + `MAX_TREE_DEPTH` |
| 6 | `official_view_path` 搬进 helper | `compat/system.rs` → `compat/helper.rs` | 环 B | ✅ 纯字符串函数,无依赖 |
| 7 | `USER_DETAIL_COLUMNS` 搬进 helper | `compat/permission.rs` → `compat/helper.rs` | 环 C | ✅ helper 已有 `Db` 依赖 |
| 8 | `organize_name_of` 搬进 helper | `compat/permission.rs` → `compat/helper.rs` | 环 C | ✅ 同上 |
> ⚠️ **第 3 项是 M1 最关键的一步**:
> 面 B 的 `current_user`(`PcUserVO` 形状)必须**从 auth 侧完全移出**。
> 若保留在 auth 里调用 compat helper ⇒ auth 仍依赖 compat ⇒ 环还在。
> **手法**:在 auth 侧建一个 `OnceLock<Option<fn(...)>>` 静态槽位,
> 由**壳(`bootstrap.rs`)在启动时注册** compat 提供的面 B 实现。
> 运行期单向,编译期无环。
> ✅ **M1 已完成**(2026-11-03):695 测试全绿 / 14 道闸门全绿 / `verify.sh --smoke` 14 步全绿。
> tag = `v0.1.1-m1`。
>
> 🔴 **实际做法与原计划的差异(两处,都是「更简单」)**:
>
> 1. **不用运行期注册表**(原计划第 3 项):改为把**分流点上移到装配根 `routes.rs`**。
> 这更好 —— `CLAUDE.md` §4 本来就写明「共用两条路由按判别头分流」,
> 分流点本就该在壳;而且**没有 `OnceLock` 静态槽位、没有注册时机、没有漏注册的风险**。
> 平台层与契约面从此**互不知道对方**,壳负责接线。
> 2. **不用新建 `compat_base/` 目录**(原计划第 5 项):改为把 4 个符号**搬进 helper 本身**。
> helper 已经是「底座」,把这 4 个纯函数/常量放进去不增不减;
> 而新建目录要多一层 crate 边界,M3 拆 crate 时再切更省事。
>
> 🔴 **环 B/C 的方向修正**:原计划说「把符号搬回 system / permission 侧」,
> 实际是**搬进 helper** —— 因为 helper 被 14 个模块依赖,
> 符号在 helper 里 ⇒ 所有模块都能用;符号在 system/permission 里 ⇒ helper 又得依赖它们 ⇒ 环还在。
**出口判据**:
- `cargo build --workspace` 通过
- 695 测试仍全绿
- `grep -rn "crate::platform::compat" src/backend/src/platform/auth.rs` → **零命中**
- `grep -rn "use super::system\|use super::permission" src/backend/src/platform/compat/helper.rs` → **零命中**
**出口判据**(全部已达成):
- [x] `cargo build --workspace` 通过(**零警告**)
- [x] 695 测试仍全绿(`cargo test --workspace` = 695 passed / 0 failed)
- [x] `grep -rn "crate::platform::compat" src/backend/src/platform/` → **仅剩注释命中**
- [x] `grep -rn "use super::system\|use super::permission" src/backend/src/platform/compat/helper.rs` → **零命中**
- [x] `check-arch.sh` → **14/14**(新增 AR10/AR11)
- [x] `check-arch.sh --self-test` → **6/6 反自证通过**
- [x] `verify.sh --smoke` → **14 步全绿**
### 🆕 M1 顺带加的两条防回退闸门
| 判据 | 守护什么 | 反自证 |
|---|---|---|
| **AR10** | `platform/**`(不含 compat/)不许 `use crate::platform::compat` | ✅ 造 `use crate::platform::compat::helper::current_user;` 必被抓 |
| **AR11** | `compat/helper.rs` 不许 `use super::<别的模块>` | ✅ 造 `use super::system::menu_node;` 必被抓 |
> 🔴 **为什么必须现在就钉**:拆 crate 是**渐进**的 —— 在 M2 拆完之前,
> 把那行加回去**照样编译通过、测试照样全绿**,只有到 M2 那天才炸 ⇒ 那时已改了一堆东西。
> ⇒ 现在就拦住。
### 批次 M2 —— 平台核心下沉:`sspf-core`
+148 -4
View File
@@ -28,6 +28,14 @@
# —— 适配器只认工具契约层;依赖内核 store 就等于把第二种后端钉死在本进程旁
# AR7 `crates/sspf-lowcode` 依赖 ⊆ {sspf-contract, serde, serde_json}
# —— 低代码引擎是纯计算;依赖 DB/HTTP 会让它只能在内核里跑,且测试必须起库
# AR9 `src/backend/src/platform/**` 里不许出现 `use sspf_pack_*`
# —— 平台层不许认识任何业务包(业务知识隔离)
# AR10 `src/backend/src/platform/**`(不含 compat/)里不许出现
# `crate::platform::compat` —— 平台层不许**反向依赖**契约面
# —— M1 解开的环 A;拆 crate 时它就是循环依赖(编译器当天才报错 ⇒ 必须提前钉住)
# AR11 `src/backend/src/platform/compat/helper.rs` 里不许 `use super::<别的模块>`
# —— 契约面底座不许反向依赖契约面业务模块(helper 被 14 个模块依赖 ⇒ 即成环)
# —— M1 解开的环 B/C
# MEM1 非注释代码里不许出现 `SELECT *`
# —— 终端产品内存预算 ≤ 120MB(PLAN.md 判断 ⑥)⇒ 全表读进 Vec 直接爆
# MEM2 `crates/**` 与 `src/backend/src/platform/**` 里不许出现无界 `HashMap` 缓存
@@ -213,6 +221,90 @@ check_ar9() {
fi
}
# ---------------------------------------------------------------- AR10
# **平台层不许反向依赖契约面**(M1 解开的环 A,防回退)。
#
# 🔴 **背景**:M1 之前 `platform/auth.rs` 里写着
# `crate::platform::compat::helper::current_user(...)` —— 平台层反过来调契约面。
# 同 crate 内这只是「层间倒挂」(能编译),但**拆 crate 时就是循环依赖**,
# 编译器直接报错 ⇒ 整个迁移(M2–M6)全部卡死。
# M1 已把分流点上移到装配根(`routes.rs`),平台层不再认识契约面。
#
# 🔴 **为什么必须钉住**:拆 crate 是**渐进**的 —— 在拆完之前,加回这一行
# **照样编译通过、测试照样全绿**,只有到 M2 那天才炸 ⇒ 那时候已经改了一堆东西,
# 回滚成本高得多。⇒ 现在就把它拦住。
#
# 判据:`src/backend/src/platform/**`(**不含 compat/**)里不许出现
# `crate::platform::compat` / `super::compat` / `crate::compat`。
check_ar10() {
local dir="$KERNEL/src/platform"
[ -d "$dir" ] || { skip "AR10 平台层目录不存在"; return; }
local hits
# 🔴 **必须排除注释行**(`//` / `//!` / `///`)—— 文档注释里的路径引用是
# **给人看的**(如 `//! (见 crate::platform::compat::helper::load_menus])`),
# 不是依赖 ⇒ 不该判红。
# 🔴 纯 grep 过滤不了:`//!` 前面**没有空格** ⇒ `^\s*//` 漏掉它。
# 这里用 python3 逐行判(与 MEM1/MEM2 同一套路)。
hits="$(python3 - "$dir" <<'PY'
import os, re, sys
root = sys.argv[1]
pat = re.compile(r'(crate::platform::compat|crate::compat|super::compat)')
bad = []
for dirpath, dirnames, files in os.walk(root):
dirnames[:] = [d for d in dirnames if d != 'compat'] # 契约面自己互引合法
for fn in files:
if not fn.endswith('.rs'):
continue
p = os.path.join(dirpath, fn)
try:
lines = open(p, encoding='utf-8').read().splitlines()
except OSError:
continue
for i, line in enumerate(lines, 1):
s = line.strip()
# 整行注释(含 `//!` / `///`)⇒ 跳过
if s.startswith('//'):
continue
# 行尾注释:把 `//` 之后截掉再判(`use x::y; // 说明` 里的说明不算)
code = line.split('//', 1)[0]
if pat.search(code):
bad.append(f'{p}:{i}: {s}')
for b in bad:
print(b)
PY
)"
if [ -z "$hits" ]; then
ok "AR10 平台层没有反向依赖契约面(拆 crate 的前置条件仍成立)"
else
bad "AR10 平台层反向依赖契约面(拆 crate 时就是循环依赖 ⇒ 必须把调用点上移到装配根):"
printf '%s\n' "$hits" | sed 's/^/ /'
fi
}
# ---------------------------------------------------------------- AR11
# **契约面底座(helper)不许依赖契约面业务模块**(M1 解开的环 B/C,防回退)。
#
# 🔴 **背景**:`compat/helper.rs` 被 **14 个**契约面模块依赖(实测)⇒ 它是底座。
# 若它反过来 `use super::system` / `use super::permission` ⇒
# 拆 crate 时 helper ↔ system / helper ↔ permission 都是**循环依赖**。
# M1 已把 `menu_node` / `official_view_path` / `USER_DETAIL_COLUMNS` /
# `organize_name_of` 搬进 helper,切断了这两条边。
#
# 判据:`compat/helper.rs` 里不许 `use super::` 指向**非 helper 的模块**。
check_ar11() {
local f="$KERNEL/src/platform/compat/helper.rs"
[ -f "$f" ] || { skip "AR11 compat/helper.rs 不存在"; return; }
local hits
hits="$(grep -nE '^[[:space:]]*(pub )?use[[:space:]]+super::[a-z_]+' "$f" 2>/dev/null \
| grep -v 'super::helper' || true)"
if [ -z "$hits" ]; then
ok "AR11 契约面底座(helper)不依赖其它契约面模块(14 个模块依赖它 ⇒ 反向依赖即成环)"
else
bad "AR11 契约面底座(helper)反向依赖契约面业务模块(拆 crate 时即成环):"
printf '%s\n' "$hits" | sed 's/^/ /'
fi
}
# ---------------------------------------------------------------- PACK1
# **spec 单一真源**:`modules/<app>.rs` 只许做转发,不许自己写 spec。
#
@@ -346,7 +438,7 @@ PY
self_test() {
local rc=0
echo "── 反自证 1/4:造一个依赖越界的假 pack,AR2 必须报 ❌ ──"
echo "── 反自证 1/6:造一个依赖越界的假 pack,AR2 必须报 ❌ ──"
local tmp="$ROOT/packs/__arch_selftest__"
mkdir -p "$tmp"
cat > "$tmp/Cargo.toml" <<'TOML'
@@ -372,7 +464,7 @@ TOML
rc=1
fi
echo "── 反自证 2/4:往平台层塞一个 use sspf_pack_*,AR9 必须报 ❌ ──"
echo "── 反自证 2/6:往平台层塞一个 use sspf_pack_*,AR9 必须报 ❌ ──"
#
# 🔴 **为什么必须自证 AR9**:它的判据是 `grep platform/`。
# 目录名写错 / 路径拼错 ⇒ `grep` 永远返回空 ⇒ **永远"通过"**。
@@ -396,7 +488,7 @@ TOML
echo "⏭ 跳过 AR9 反自证(平台层目录不存在)"
fi
echo "── 反自证 3/4:往 re-export 的模块里塞一份 spec,PACK1 必须报 ❌ ──"
echo "── 反自证 3/6:往 re-export 的模块里塞一份 spec,PACK1 必须报 ❌ ──"
#
# 🔴 造在**临时模块文件**上(不动真文件):只要它同时有 `pub use sspf_pack_`
# 和 `= EntitySpec {`,PACK1 就必须红。
@@ -422,7 +514,7 @@ RS
echo "⏭ 跳过 PACK1 反自证(业务模块目录不存在)"
fi
echo "── 反自证 4/4:往 sspf-plugin 塞 axum 依赖,AR8 必须报 ❌ ──"
echo "── 反自证 4/6:往 sspf-plugin 塞 axum 依赖,AR8 必须报 ❌ ──"
local pfile="$CRATES/sspf-plugin/Cargo.toml"
if [ -f "$pfile" ]; then
cp "$pfile" "$pfile.bak"
@@ -443,6 +535,56 @@ RS
echo "⏭ 跳过 AR8 反自证(sspf-plugin 不存在)"
fi
echo "── 反自证 5/6:往平台层塞 crate::platform::compat,AR10 必须报 ❌ ──"
#
# 🔴 **必须自证 AR10**:它的判据是 `grep platform/`。
# 目录名写错 / 路径拼错 ⇒ `grep` 永远返回空 ⇒ **永远"通过"** ⇒ 虚假安全感。
# 而且这条判据守护的是**拆 crate 的前置条件** —— 它一旦失效,M2 当天才炸。
local a10probe="$KERNEL/src/platform/__ar10_selftest.rs"
if [ -d "$KERNEL/src/platform" ]; then
printf 'use crate::platform::compat::helper::current_user;\n' > "$a10probe"
before=$FAIL
check_ar10 >/dev/null 2>&1
caught=0
[ "$FAIL" -gt "$before" ] && caught=1
rm -f "$a10probe"
FAIL=$before
if [ "$caught" -eq 1 ]; then
echo "✅ 反自证通过:AR10 抓到了平台层里的 crate::platform::compat"
else
echo "❌ 反自证失败:AR10 没抓到平台层的契约面反向依赖 ⇒ 尺子是假的"
rc=1
fi
else
echo "⏭ 跳过 AR10 反自证(平台层目录不存在)"
fi
echo "── 反自证 6/6:往契约面底座塞 use super::system,AR11 必须报 ❌ ──"
#
# 🔴 造在**临时副本**上:不动真文件(helper.rs 是 900+ 行的活文件)。
local a11dir="$KERNEL/src/platform/compat"
local a11probe="$a11dir/__ar11_selftest.rs"
if [ -d "$a11dir" ] && [ -f "$a11dir/helper.rs" ]; then
# 🔴 AR11 只扫 `helper.rs` ⇒ 探针必须是 helper.rs 本身。
# 做法:备份真文件 → 追加违规行 → 跑判据 → 还原。
cp "$a11dir/helper.rs" "$a11dir/helper.rs.bak"
printf '\nuse super::system::menu_node;\n' >> "$a11dir/helper.rs"
before=$FAIL
check_ar11 >/dev/null 2>&1
caught=0
[ "$FAIL" -gt "$before" ] && caught=1
mv "$a11dir/helper.rs.bak" "$a11dir/helper.rs"
FAIL=$before
if [ "$caught" -eq 1 ]; then
echo "✅ 反自证通过:AR11 抓到了契约面底座里的 use super::system"
else
echo "❌ 反自证失败:AR11 没抓到底座的反向依赖 ⇒ 尺子是假的"
rc=1
fi
else
echo "⏭ 跳过 AR11 反自证(契约面目录或 helper.rs 不存在)"
fi
return $rc
}
@@ -459,6 +601,8 @@ check_ar6
check_ar7
check_ar8
check_ar9
check_ar10
check_ar11
check_pack1
check_mem1
check_mem2
+16 -11
View File
@@ -322,21 +322,23 @@ pub(crate) fn parse_user_agent(ua: &str) -> (String, String) {
(browser.to_string(), platform.to_string())
}
/// 当前用户(契约 §6.1)。
/// 当前用户(契约 §6.1)—— **面 A 形状**。
///
/// - 未登录 ⇒ `fail(600, "未登录")`;
/// - 成功 ⇒ `data = {"userInfo": {...}, "menuList": [...]}`。
///
/// 🔴 `userName` = **账号**(不是 `realName`);`isAdministrator` 是 **JSON 布尔**。
///
/// 🔴 **面 B 分流**:请求头带 `Vue-Version: 3` ⇒ 走**官方 `PcUserVO` 形状**
/// (`JNPF_COMPAT_SURFACE.md` §3.1)⇒ **面 A 的形状一个字都不动**。
/// 🔴 **面 B 分流不在本函数里做** —— 分流点在上层的**装配根**(`routes.rs`):
/// 请求头带 `Vue-Version: 3` ⇒ 走**官方 `PcUserVO` 形状**
/// (`JNPF_COMPAT_SURFACE.md` §3.1);否则走本函数的面 A 形状。
///
/// 🔴 **为什么不在这里分流**(M1 解耦的根因):面 B 的形状组装住在契约面
/// (`compat::helper::current_user`)。若在这里 `if is_face_b { compat::… }`,
/// 平台层就**反向依赖契约面** ⇒ 拆 crate 时是**循环依赖**,编译器直接报错。
/// 分流点上移到装配根 ⇒ 平台层与契约面**互不知道对方**,壳负责接线。
/// (与 `CLAUDE.md` §4「共用两条路由按判别头分流」是同一处设计。)
pub async fn current_user(state: &AppState, headers: HeaderMap) -> Json<ActionResult> {
// 🔴 判别头 = `Vue-Version: 3`(本仓前端唯一不发的官方头 ⇒ 零歧义)。
if crate::platform::compat::helper::is_face_b(&headers) {
return crate::platform::compat::helper::current_user(state, &headers).await;
}
let Some(user) = resolve_user(state, &headers) else {
return fail(600, "未登录");
};
@@ -400,7 +402,8 @@ pub async fn require_login_any(
state: &AppState,
headers: &HeaderMap,
) -> Result<TokenUser, Json<ActionResult>> {
if crate::platform::compat::helper::is_face_b(headers) {
// 🔴 同上:判据取契约层,不绕 compat(避免平台层 → 契约面的反向依赖)。
if sspf_contract::headers::is_face_b(headers) {
require_login_face_b(state, headers).await
} else {
require_login(state, headers).await
@@ -432,8 +435,10 @@ pub async fn require_module(
/// 从 `Authorization` 头解析出当前用户(无 / 非法 ⇒ `None`)。
///
/// 🔴 `pub(crate)` —— 面 B 的 `face_b` 模块也要用它(官方形状的 `CurrentUser`)。
pub(crate) fn resolve_user(state: &AppState, headers: &HeaderMap) -> Option<TokenUser> {
/// 🔴 `pub` —— 面 B 的 `compat::helper` 也要用它(官方形状的 `CurrentUser`)。
/// 拆 crate 后 compat 包要跨 crate 调它 ⇒ `pub(crate)` 会失效。
/// 它**不泄密**:只从 `Authorization` 头取 token,解析失败返 `None`。
pub fn resolve_user(state: &AppState, headers: &HeaderMap) -> Option<TokenUser> {
let auth = headers.get("authorization")?;
let auth = auth.to_str().ok()?;
state.sessions.resolve(Some(auth))
+94 -2
View File
@@ -28,8 +28,6 @@ use crate::platform::session::TokenUser;
use crate::platform::state::AppState;
use crate::platform::registry;
pub use sspf_contract::headers::VUE_VERSION;
use super::system::{menu_node, official_view_path};
use super::permission::{USER_DETAIL_COLUMNS, organize_name_of};
/// 本仓的系统 id(`currentSystemId` / `userInfo.systemId` / 菜单 `systemId` 的兜底值)。
///
/// 🔴 单一真源在 [`crate::platform::registry`](`base_system.f_id`);这里只是别名,
@@ -287,6 +285,24 @@ fn parse_property_json(raw: Option<&str>) -> Value {
serde_json::from_str::<Value>(trimmed).unwrap_or(Value::Null)
}
/// 菜单在**面 B** 里对外的 `urlAddress` —— 官方前端的**视图路径**。
///
/// 规则(与官方前端 `generate-routes-backend.ts:57` 对目录的做法**同一条**):
/// `f_en_code` 的点换斜杠(`permission.user` ⇒ `permission/user`)。
/// 🔴 库里的 `f_url_address` 是**面 A** 的守卫 key(`system/User`),**不能**直接给面 B。
///
/// 🔴 **本函数住在 helper,不住 `system.rs`** —— 它只依赖字符串处理,
/// 而 `system.rs` 依赖 helper(`guard` / `Paging` / `MenuRow` …)。
/// 若 helper 反过来依赖 system ⇒ **循环依赖**(跨 crate 时编译器直接报错)。
pub(super) fn official_view_path(en_code: Option<&str>, fallback: Option<&str>) -> Option<String> {
let code = en_code.map(str::trim).filter(|s| !s.is_empty())?;
let path = code.replace('.', "/");
if path.is_empty() {
return fallback.map(str::to_string);
}
Some(path)
}
/// 一个菜单节点 ⇒ 官方 `AllMenuSelectVO`(**15 个字段,一个不少**)。
///
/// 🔴 **键名与顺序照官方 `AllMenuSelectVO.java:12-50`**(`id` / `fullName` / `enCode` /
@@ -339,6 +355,31 @@ pub(super) fn menu_value(row: MenuRow, children: Vec<Value>, has_children: bool)
})
}
/// 递归建一棵子树。
///
/// 🔴 **本函数住在 helper,不住 `system.rs`** —— 它只依赖 helper 自己的
/// `menu_value` 与 `MAX_TREE_DEPTH`;而 `system.rs` 依赖 helper
/// ⇒ 放 system 会形成**循环依赖**(拆 crate 后编译器直接报错)。
pub(super) fn menu_node(
row: MenuRow,
by_parent: &mut HashMap<String, Vec<MenuRow>>,
depth: usize,
) -> Value {
// 防御:`f_parent_id` 被改成人为环时不要无限递归(层数封顶 ⇒ 截断)。
let children: Vec<Value> = if depth >= MAX_TREE_DEPTH {
Vec::new()
} else {
by_parent
.remove(&row.id)
.unwrap_or_default()
.into_iter()
.map(|child| menu_node(child, by_parent, depth + 1))
.collect()
};
let has_children = !children.is_empty();
menu_value(row, children, has_children)
}
/// 建菜单树(根 = `parentId` 为空 / `'0'` / **父不在可见集合内**)。
fn build_menu_tree(rows: Vec<MenuRow>) -> Vec<Value> {
let visible: HashSet<String> = rows.iter().map(|m| m.id.clone()).collect();
@@ -596,6 +637,57 @@ pub(super) fn placeholder(index: usize, cast: &str) -> String {
format!("${index}::text{cast}")
}
/// 详情投影 —— 编辑弹窗 `setFieldsValue(res.data)` **直接吃这份**。
///
/// 🔴 少一个键 ⇒ 弹窗里那一格永远是空的,而且**不报错**(静默)。
/// 🔴 `birthday` / `entryDate` 用 `to_char(…,'YYYY-MM-DD')`:官方 VO 是日期串,
/// `::text` 会带出 ` 00:00:00` ⇒ DatePicker 解析失败。
///
/// 🔴 **本常量住在 helper,不住 `permission.rs`** —— 它被 helper 的 `user_info` 用;
/// 而 helper 被 14 个契约面模块依赖 ⇒ 放 permission 会形成**循环依赖**。
pub(super) const USER_DETAIL_COLUMNS: &str = "f_id AS \"id\", f_account AS \"account\", \
f_real_name AS \"realName\", f_nick_name AS \"nickName\", f_head_icon AS \"headIcon\", \
f_gender AS \"gender\", to_char(f_birthday, 'YYYY-MM-DD') AS \"birthday\", \
f_mobile_phone AS \"mobilePhone\", f_tele_phone AS \"telePhone\", f_landline AS \"landline\", \
f_email AS \"email\", f_nation AS \"nation\", f_native_place AS \"nativePlace\", \
to_char(f_entry_date, 'YYYY-MM-DD') AS \"entryDate\", \
f_certificates_type AS \"certificatesType\", \
f_certificates_number AS \"certificatesNumber\", f_education AS \"education\", \
f_urgent_contacts AS \"urgentContacts\", f_urgent_tele_phone AS \"urgentTelePhone\", \
f_postal_address AS \"postalAddress\", f_signature AS \"signature\", \
f_description AS \"description\", COALESCE(f_sort_code, 0) AS \"sortCode\", \
COALESCE(f_enabled_mark, 0) AS \"enabledMark\", f_rank AS \"ranks\", \
f_organize_id AS \"organizeId\", f_position_id AS \"positionId\", \
COALESCE(f_is_administrator, 0) AS \"isAdministrator\", \
COALESCE(f_lock_mark, 0) AS \"lockMark\", f_unlock_time AS \"unlockTime\", \
(EXTRACT(EPOCH FROM f_creator_time) * 1000)::bigint AS \"creatorTime\", \
f_creator_user_id AS \"creatorUserId\", f_tenant_id AS \"tenantId\", \
COALESCE(f_delete_mark, 0) AS \"deleteMark\"";
/// 机构名(查不到 ⇒ `None`)。
///
/// 🔴 **本函数住在 helper,不住 `permission.rs`** —— 它被 helper 的
/// `build_user_info` 用;放 permission 会形成**循环依赖**(同 `USER_DETAIL_COLUMNS`)。
pub(super) async fn organize_name_of(db: &Db, id: &str) -> Option<String> {
let rows = match db
.query_json_params(
"SELECT f_full_name AS \"fullName\" FROM base_organize \
WHERE f_id = $1::text AND f_delete_mark = 0 LIMIT 1",
&[&id],
)
.await
{
Ok(rows) => rows,
Err(e) => {
eprintln!("[face-b] 读机构名失败: {e}");
return None;
}
};
rows.first()
.and_then(|r| r["fullName"].as_str())
.map(str::to_string)
}
/// `GET /api/permission/Users/{id}` —— 单条详情(编辑弹窗)。
///
/// ⚠️ **`{id}` 会吞掉所有「`Users/` 下一段的静态 GET」**(`Selector` / `getWorkByUser` /
+10 -44
View File
@@ -26,28 +26,12 @@ use crate::platform::ids::new_uuid;
use crate::platform::session::TokenUser;
use crate::platform::state::AppState;
use crate::platform::registry;
use super::helper::{EN_ACTION, EN_AUTH_GROUP, EN_IDENTITY, EN_ORGANIZE, EN_POSITION, EN_ROLE, EN_USER, Paging, USER_SELECTOR_PROJECTION, db_error, guard, guard_any, id_list, id_list_of, list_vo, load_menus, page_list, params_of, parse_body, placeholder, qv, text_field};
use super::helper::{EN_ACTION, EN_AUTH_GROUP, EN_IDENTITY, EN_ORGANIZE, EN_POSITION, EN_ROLE, EN_USER, Paging, USER_SELECTOR_PROJECTION, db_error, guard, guard_any, id_list, id_list_of, list_vo, load_menus, organize_name_of, page_list, params_of, parse_body, placeholder, qv, text_field};
use super::system::{SYSTEM_LIST_PROJECTION, load_system_tops, log_page, shape_system_list_item};
/// 机构名(查不到 ⇒ `None`)。
pub(super) async fn organize_name_of(db: &Db, id: &str) -> Option<String> {
let rows = match db
.query_json_params(
"SELECT f_full_name AS \"fullName\" FROM base_organize \
WHERE f_id = $1::text AND f_delete_mark = 0 LIMIT 1",
&[&id],
)
.await
{
Ok(rows) => rows,
Err(e) => {
eprintln!("[face-b] 读机构名失败: {e}");
return None;
}
};
rows.first()
.and_then(|r| r["fullName"].as_str())
.map(str::to_string)
}
/// 🔴 **`organize_name_of` 已搬到 `helper.rs`** —— 它是「查机构名」这件通用底座,
/// 被 helper 的 `build_user_info` 用到;放这里会让 helper 反向依赖 permission
/// ⇒ **循环依赖**。
/// `GET /api/permission/Users` —— 官方 `UserController.java:295` 的形状。
///
@@ -366,30 +350,12 @@ const USER_WRITE_FIELDS: &[(&str, &str, &str)] = &[
("organizeId", "f_organize_id", ""),
];
/// 详情投影 —— 编辑弹窗 `setFieldsValue(res.data)` **直接吃这份**。
///
/// 🔴 少一个键 ⇒ 弹窗里那一格永远是空的,而且**不报错**(静默)。
/// 🔴 `birthday` / `entryDate` 用 `to_char(…,'YYYY-MM-DD')`:官方 VO 是日期串,
/// `::text` 会带出 ` 00:00:00` ⇒ DatePicker 解析失败。
pub(super) const USER_DETAIL_COLUMNS: &str = "f_id AS \"id\", f_account AS \"account\", \
f_real_name AS \"realName\", f_nick_name AS \"nickName\", f_head_icon AS \"headIcon\", \
f_gender AS \"gender\", to_char(f_birthday, 'YYYY-MM-DD') AS \"birthday\", \
f_mobile_phone AS \"mobilePhone\", f_tele_phone AS \"telePhone\", f_landline AS \"landline\", \
f_email AS \"email\", f_nation AS \"nation\", f_native_place AS \"nativePlace\", \
to_char(f_entry_date, 'YYYY-MM-DD') AS \"entryDate\", \
f_certificates_type AS \"certificatesType\", \
f_certificates_number AS \"certificatesNumber\", f_education AS \"education\", \
f_urgent_contacts AS \"urgentContacts\", f_urgent_tele_phone AS \"urgentTelePhone\", \
f_postal_address AS \"postalAddress\", f_signature AS \"signature\", \
f_description AS \"description\", COALESCE(f_sort_code, 0) AS \"sortCode\", \
COALESCE(f_enabled_mark, 0) AS \"enabledMark\", f_rank AS \"ranks\", \
f_organize_id AS \"organizeId\", f_position_id AS \"positionId\", \
COALESCE(f_is_administrator, 0) AS \"isAdministrator\", \
COALESCE(f_lock_mark, 0) AS \"lockMark\", f_unlock_time AS \"unlockTime\", \
(EXTRACT(EPOCH FROM f_creator_time) * 1000)::bigint AS \"creatorTime\", \
f_creator_user_id AS \"creatorUserId\", f_tenant_id AS \"tenantId\", \
COALESCE(f_delete_mark, 0) AS \"deleteMark\"";
/// 🔴 **`USER_DETAIL_COLUMNS` 与 `organize_name_of` 已搬到 `helper.rs`** —— 它们是
/// 「用户详情形状」与「机构名查询」两件**通用底座**,被 `helper` 的
/// `user_info` / `build_user_info` 用到;而 `helper` 被 14 个契约面模块依赖
/// ⇒ 放在这里会让 helper 反向依赖 permission ⇒ **循环依赖**。
///
/// body ⇒ 白名单内的 `(列, CAST, 值)`;**只收 body 里真出现的键**。
fn user_write_fields(obj: &Map<String, Value>) -> Vec<(&'static str, &'static str, Option<String>)> {
let mut out = Vec::new();
-34
View File
@@ -24,40 +24,6 @@ use crate::platform::session::TokenUser;
use crate::platform::state::AppState;
use crate::platform::registry;
use super::helper::{EN_MENU, EN_USER, MAX_TREE_DEPTH, MENU_PROJECTION, MenuRow, Paging, SYSTEM_ID, USER_SELECTOR_PROJECTION, db_error, guard, guard_any, id_list_of, int_field, list_vo, menu_value, page_list, params_of, parse_body, parse_menu_row, placeholder, qv, text_field, user_labels};
/// 菜单在**面 B** 里对外的 `urlAddress` —— 官方前端的**视图路径**。
///
/// 规则(与官方前端 `generate-routes-backend.ts:57` 对目录的做法**同一条**):
/// `f_en_code` 的点换斜杠(`permission.user` ⇒ `permission/user`)。
/// 🔴 库里的 `f_url_address` 是**面 A** 的守卫 key(`system/User`),**不能**直接给面 B。
pub(super) fn official_view_path(en_code: Option<&str>, fallback: Option<&str>) -> Option<String> {
let code = en_code.map(str::trim).filter(|s| !s.is_empty())?;
let path = code.replace('.', "/");
if path.is_empty() {
return fallback.map(str::to_string);
}
Some(path)
}
/// 递归建一棵子树。
pub(super) fn menu_node(
row: MenuRow,
by_parent: &mut HashMap<String, Vec<MenuRow>>,
depth: usize,
) -> Value {
// 防御:`f_parent_id` 被改成人为环时不要无限递归(层数封顶 ⇒ 截断)。
let children: Vec<Value> = if depth >= MAX_TREE_DEPTH {
Vec::new()
} else {
by_parent
.remove(&row.id)
.unwrap_or_default()
.into_iter()
.map(|child| menu_node(child, by_parent, depth + 1))
.collect()
};
let has_children = !children.is_empty();
menu_value(row, children, has_children)
}
/// `GET /api/system/Menu/ModuleBySystem` —— 官方 `ModuleController.java:121`。
///
+10 -1
View File
@@ -74,10 +74,19 @@ pub fn build_router(state: AppState) -> axum::Router<AppState> {
.route("/api/oauth/Login", post(auth::login_handler))
// 🔴 `auth::current_user` 收的是 `&AppState`(不是 `State<AppState>`)
// ⇒ 不是合法的 extractor 组合 ⇒ **用闭包包一层**(S20)。
//
// 🔴 **面 B 分流在这里做**(`Vue-Version: 3` ⇒ 官方 `PcUserVO` 形状):
// 分流点**必须**在装配根,不能在 `auth::current_user` 内部 ——
// 在内部会让平台层反向依赖契约面 ⇒ 拆 crate 时是**循环依赖**。
// 判据取契约层(`sspf_contract::headers::is_face_b`,唯一真源)。
.route(
"/api/oauth/CurrentUser",
get(|State(state): State<AppState>, headers: HeaderMap| async move {
auth::current_user(&state, headers).await
if sspf_contract::headers::is_face_b(&headers) {
compat::helper::current_user(&state, &headers).await
} else {
auth::current_user(&state, headers).await
}
}),
)
// ---- 用户(§6.2 / §7.1)----