From 215b5e8fcf6449893ac68fec7d9f6362485d7e6b Mon Sep 17 00:00:00 2001 From: admin Date: Tue, 3 Nov 2026 13:25:06 +0800 Subject: [PATCH] =?UTF-8?q?refactor(arch):=20M1=20=E8=A7=A3=E8=80=A6=20?= =?UTF-8?q?=E2=80=94=E2=80=94=20=E6=8B=86=E6=8E=89=E4=B8=89=E5=A4=84?= =?UTF-8?q?=E8=B7=A8=20crate=20=E5=BE=AA=E7=8E=AF=E4=BE=9D=E8=B5=96=20+=20?= =?UTF-8?q?=E5=8A=A0=20AR10/AR11=20=E9=97=B8=E9=97=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 平台能力全迁 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 步全绿。 --- .workbuddy/memory/2026-11-03.md | 13 ++ CLAUDE.md | 6 +- HANDOFF.md | 47 +++++- docs/CRATES-MIGRATION.md | 76 ++++++--- scripts/check-arch.sh | 152 +++++++++++++++++- src/backend/src/platform/auth.rs | 27 ++-- src/backend/src/platform/compat/helper.rs | 96 ++++++++++- src/backend/src/platform/compat/permission.rs | 54 ++----- src/backend/src/platform/compat/system.rs | 34 ---- src/backend/src/routes.rs | 11 +- 10 files changed, 385 insertions(+), 131 deletions(-) diff --git a/.workbuddy/memory/2026-11-03.md b/.workbuddy/memory/2026-11-03.md index 4582e2c..8e25867 100644 --- a/.workbuddy/memory/2026-11-03.md +++ b/.workbuddy/memory/2026-11-03.md @@ -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**。 diff --git a/CLAUDE.md b/CLAUDE.md index a3e5d34..a110d36 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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) diff --git a/HANDOFF.md b/HANDOFF.md index c04653c..a8198ab 100644 --- a/HANDOFF.md +++ b/HANDOFF.md @@ -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。 --- diff --git a/docs/CRATES-MIGRATION.md b/docs/CRATES-MIGRATION.md index 8f6851d..850c8e9 100644 --- a/docs/CRATES-MIGRATION.md +++ b/docs/CRATES-MIGRATION.md @@ -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>` 静态槽位, -> 由**壳(`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` diff --git a/scripts/check-arch.sh b/scripts/check-arch.sh index 3bab1a6..d775f98 100755 --- a/scripts/check-arch.sh +++ b/scripts/check-arch.sh @@ -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/.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 diff --git a/src/backend/src/platform/auth.rs b/src/backend/src/platform/auth.rs index 5138b8a..b59b684 100644 --- a/src/backend/src/platform/auth.rs +++ b/src/backend/src/platform/auth.rs @@ -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 { - // 🔴 判别头 = `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> { - 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 { +/// 🔴 `pub` —— 面 B 的 `compat::helper` 也要用它(官方形状的 `CurrentUser`)。 +/// 拆 crate 后 compat 包要跨 crate 调它 ⇒ `pub(crate)` 会失效。 +/// 它**不泄密**:只从 `Authorization` 头取 token,解析失败返 `None`。 +pub fn resolve_user(state: &AppState, headers: &HeaderMap) -> Option { let auth = headers.get("authorization")?; let auth = auth.to_str().ok()?; state.sessions.resolve(Some(auth)) diff --git a/src/backend/src/platform/compat/helper.rs b/src/backend/src/platform/compat/helper.rs index 3b48d1f..b83fcd6 100644 --- a/src/backend/src/platform/compat/helper.rs +++ b/src/backend/src/platform/compat/helper.rs @@ -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::(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 { + 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, 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>, + depth: usize, +) -> Value { + // 防御:`f_parent_id` 被改成人为环时不要无限递归(层数封顶 ⇒ 截断)。 + let children: Vec = 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) -> Vec { let visible: HashSet = 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 { + 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` / diff --git a/src/backend/src/platform/compat/permission.rs b/src/backend/src/platform/compat/permission.rs index a4e038f..f880b88 100644 --- a/src/backend/src/platform/compat/permission.rs +++ b/src/backend/src/platform/compat/permission.rs @@ -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 { - 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) -> Vec<(&'static str, &'static str, Option)> { let mut out = Vec::new(); diff --git a/src/backend/src/platform/compat/system.rs b/src/backend/src/platform/compat/system.rs index 96ac24b..a13d77e 100644 --- a/src/backend/src/platform/compat/system.rs +++ b/src/backend/src/platform/compat/system.rs @@ -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 { - 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>, - depth: usize, -) -> Value { - // 防御:`f_parent_id` 被改成人为环时不要无限递归(层数封顶 ⇒ 截断)。 - let children: Vec = 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`。 /// diff --git a/src/backend/src/routes.rs b/src/backend/src/routes.rs index 3f02caf..4dcd446 100644 --- a/src/backend/src/routes.rs +++ b/src/backend/src/routes.rs @@ -74,10 +74,19 @@ pub fn build_router(state: AppState) -> axum::Router { .route("/api/oauth/Login", post(auth::login_handler)) // 🔴 `auth::current_user` 收的是 `&AppState`(不是 `State`) // ⇒ 不是合法的 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, 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)----