Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
215b5e8fcf | ||
|
|
1694e77324 | ||
|
|
639ade7923 |
No files matched your search
@@ -48,3 +48,33 @@
|
||||
- **诚实失败(8 类)**:外部数据库连接 / 动态 SQL / 任意 URL 转发(proxy、GetApiData)/ 文件服务(put-file、图片列表)/ 导入导出 / 地图数据源 ⇒ 一律 400 + 人话,不返假连接成功、假 geojson、假链接。
|
||||
- **数字**:契约 **1040** 条(面 B 1010,+52);官方台账覆盖 **1026/1031**(implemented 815 / partial 211 / absent 5);test **695 passed / 0 failed**(基线 684+11);verify --smoke 14 步全绿(793.9s);check-contract PASS=10;check-citations PASS=4(1264 条引文)。
|
||||
- **文档**:`docs/known-limitations.md` §K(9 条降级/口径);`HANDOFF.md` §0-0-quinque。
|
||||
|
||||
### 12:00–12:20 打 tag v0.1.0 + 制定「平台能力全迁 crates/」计划
|
||||
|
||||
- **触发**:用户问「`crates/` 与 `src/backend/` 是不是重叠了?应该参考 ssw-mvp 做一个薄壳,平台能力打成包」⇒ 复核后确认:**不重叠**(分工清晰),但**壳不薄**(壳只占 6%)⇒ 用户拍板「打 tag + 制定计划,只留壳装配,其余迁 crates/」。
|
||||
- 🔴 **关键结论(复核后修正了初判)**:初判「crates 与 src/backend 重叠」是**错的** —— `platform/{db,entity,route}.rs` 是**纯 re-export 转发**,真值源在 crates;`lowcode` 是**纯计算 ↔ 执行**分层(AR7);`mcp_adapter` 是内核**实现** `sspf_mcp::PlatformAdapter` trait(AR5 规定 mcp 不许依赖内核,否则远程基线那条路就死了)。**三层无重叠。**
|
||||
- **基线 tag**:`v0.1.0`(commit `b957a11`,已推 origin)= 迁移前可回滚锚点。打 tag 前先跑基线:`cargo test --workspace` = **695 passed / 0 failed**、`check-arch.sh` = **12/12**、`cargo build` 成功。**这三个数是整个迁移的回归基准。**
|
||||
- 🔴 **Git 服务器一度 502**(`127.0.0.1:13300` upstream connect failed)⇒ tag 先落本地、push 失败;服务器恢复后重推成功。**打 tag 前先 `git push` 试探连通性**,别让 tag 卡在本地。
|
||||
- 🔴 **三处跨 crate 循环依赖(实测定位,非推断)**:
|
||||
- **环 A**:`platform/auth.rs:336/403/337` ↔ `compat/helper.rs:22/23` —— 解法比预想简单:**`sspf_contract::headers::is_face_b` 早就存在**(带 3 条单测),`helper.rs:89` 只是转发 ⇒ `auth.rs` 改一行断一条边;残余是面 B `current_user`(`helper.rs:391`)仍需**注册表回调**才能断。
|
||||
- **环 B**:`helper.rs:31` ↔ `system.rs:26` —— helper 下沉成 `sspf-compat-core`;`menu_node`/`official_view_path` 留 system。
|
||||
- **环 C**:`helper.rs:32` ↔ `permission.rs:29`(**22 个符号**)—— `USER_DETAIL_COLUMNS`/`organize_name_of` 留 permission。
|
||||
- ✅ **已验证 `platform/` 内部 17 个文件无环**(依赖全单向向下)⇒ M2 核心下沉**不受环影响**,可独立推进。
|
||||
- 🔴 **最大风险不是代码,是闸门**:`check-contract-scan.py:827/839` 与 `check-boundary-scan.py` 把 `src/backend/src/platform` **路径写死** ⇒ 搬迁后脚本扫不到文件 ⇒ **永远"通过"** ⇒ **虚假安全感**(`check-arch.sh` AR9 的自证注释里已警告过「这类尺子比没有更危险」)。M4 之后必须同步改脚本并重跑 `--self-test`。
|
||||
- **计划**:`docs/CRATES-MIGRATION.md`(543 行)—— 7 批次(M1 解耦 → M2 `sspf-core` → M3 `sspf-compat-core` → M4 六个 compat 包 → M5 `sspf-lowcode-exec` → M6 `sspf-mcp-adapter` → M7 收口+AR10–AR13),每批次独立 commit + 独立 tag,不合绿不进下一批。
|
||||
- 🔴 **踩坑(工具)**:`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**。
|
||||
@@ -6,6 +6,10 @@
|
||||
> 🔴 **长期架构与路线(定位 / 分层 / 动态加载 / MCP / 迁移 / P0–P5)见 [`PLAN.md`](PLAN.md)。**
|
||||
> 本文件只管**当前阶段的红线与范围**,范围表随阶段推进滚动;两者冲突时以 `PLAN.md` 的架构决策为准。
|
||||
> 改代码后回头核对两文件是否还成立。
|
||||
>
|
||||
> 🔴 **「平台能力全部迁到 `crates/`、内核只留薄壳」的迁移计划见 [`docs/CRATES-MIGRATION.md`](docs/CRATES-MIGRATION.md)**
|
||||
> (基线 tag = `v0.1.0`)。**动手前先读它** —— 里面有实测的依赖图、三处循环依赖的解法、
|
||||
> 闸门改造清单与逐批出口判据。
|
||||
|
||||
---
|
||||
|
||||
@@ -219,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 已绿** |
|
||||
@@ -293,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)
|
||||
|
||||
+79
@@ -9,6 +9,85 @@
|
||||
|
||||
---
|
||||
|
||||
## 0-0-pre. 2026-11-03 12:15 打 tag `v0.1.0` + 制定「平台能力全迁 crates/」计划
|
||||
|
||||
**做了什么**:① 在 `b957a11` 上打**迁移前基线 tag** `v0.1.0`(已推 `origin`);
|
||||
② 写出完整迁移计划 `docs/CRATES-MIGRATION.md`。
|
||||
|
||||
**为什么打 tag**:这次迁移是「纯搬迁、零功能收益」的大改 ⇒ 必须有可一键回滚的锚点。
|
||||
|
||||
**基线绿灯(打 tag 时实测)**:
|
||||
`cargo test --workspace` = **695 passed / 0 failed**;`check-arch.sh` = **12/12**;
|
||||
`cargo build --workspace` = 成功。**这三个数是整个迁移的回归基准。**
|
||||
|
||||
### 🔴 迁移前必读:`docs/CRATES-MIGRATION.md`
|
||||
|
||||
**关键结论(都是实测,不是推断)**:
|
||||
|
||||
| 项 | 数据 |
|
||||
|---|---|
|
||||
| 壳只占 | `src/backend/src` 90,471 行里 **5,664 行(6%)** 是装配 + 转发 |
|
||||
| 要搬走的 | `platform/compat` 48,980 + `platform/` 6,598 + `lowcode_*` 2,674 + `mcp_*` 3,283 ≈ **61,500 行** |
|
||||
| 现有 crates | 7 个 / 17,174 行 |
|
||||
| 目标 crates | **15 个** |
|
||||
|
||||
**🔴 三处循环依赖(跨 crate 前必须先解开,否则编译不过)**:
|
||||
|
||||
| 环 | 涉及 | 解法 | 状态 |
|
||||
|---|---|---|---|
|
||||
| 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 核心下沉不受环影响**,可独立推进。
|
||||
|
||||
**🔴 闸门是最大的坑**:`check-contract-scan.py:827/839` 与 `check-boundary-scan.py`
|
||||
把 `src/backend/src/platform` **路径写死** ⇒ 代码搬走后脚本**扫不到文件 ⇒ 永远"通过"**
|
||||
⇒ **虚假安全感**(`check-arch.sh` 的 AR9 自证注释里已警告过这一点)。
|
||||
**M4 之后必须同步改这些脚本,并重跑 `--self-test`。**
|
||||
|
||||
**批次划分**:M1 解耦 → M2 `sspf-core` → M3 `sspf-compat-core` → M4 六个 compat 包
|
||||
→ M5 `sspf-lowcode-exec` → M6 `sspf-mcp-adapter` → M7 收口 + AR12–AR13。
|
||||
**每批次独立 commit + 独立 tag(`v0.1.N-mX`),不合绿不进下一批。**
|
||||
|
||||
---
|
||||
|
||||
## 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。
|
||||
|
||||
---
|
||||
|
||||
## 0-0. 2026-11-02 23:13 验证修复轮(官方前端 + dacli 真跑后修的)
|
||||
|
||||
用官方 vue 前端 + dacli + 586 条端点探针做过一轮真实系统性验证(报告:
|
||||
|
||||
@@ -0,0 +1,569 @@
|
||||
# CRATES-MIGRATION —— 「只留壳装配,平台能力全部迁到 crates/」迁移计划
|
||||
|
||||
> **基线锚点**:`v0.1.0`(commit `b957a11`,已推送到 `origin`)
|
||||
> **制定时间**:2026-11-03
|
||||
> **状态**:**M1 已完成**(tag `v0.1.1-m1`)—— 三处循环依赖全部解开;
|
||||
> 下一步 = M2(`sspf-core` 平台核心下沉)
|
||||
|
||||
---
|
||||
|
||||
## 0. 一句话目标
|
||||
|
||||
把 `src/backend/` 里的 90,471 行平台能力**全部搬进 `crates/`**,
|
||||
让 `src/backend/` 只剩**启动装配 + 路由注册**(薄壳),
|
||||
对齐 `ssw-mvp/boot` 的「薄壳 + 能力包」形态。
|
||||
|
||||
---
|
||||
|
||||
## 1. 现状盘点(`v0.1.0` 快照)
|
||||
|
||||
### 1.1 行数分布
|
||||
|
||||
| 位置 | 行数 | 占比 | 归属判断 |
|
||||
|---|---|---|---|
|
||||
| `crates/`(7 个包) | 17,174 | 16% | ✅ 已是能力包形态 |
|
||||
| `src/backend/src/platform/compat/` | 48,980 | 54% | ❌ **契约面 handler 压在内核** |
|
||||
| `src/backend/src/platform/`(非 compat) | 6,598 | 7% | ❌ 平台核心压在内核 |
|
||||
| `src/backend/src/lowcode_*.rs` | 2,674 | 3% | ❌ 执行层压在内核 |
|
||||
| `src/backend/src/mcp_*.rs` | 3,283 | 4% | ❌ 适配层压在内核 |
|
||||
| `src/backend/src/{routes,main,bootstrap,lib,packs_gen}.rs` | 5,664 | 6% | ✅ **这就是要保留的壳** |
|
||||
| `src/backend/src/modules/` | 900 | 1% | ⚠️ 业务层,保留在壳侧 |
|
||||
| `src/backend/tests/` | 23,272 | — | 集成测试,随壳走 |
|
||||
|
||||
**结论**:壳只占 6%。目标是把这 6% 之外、且属于「平台能力」的部分(≈61,500 行)全部搬进 `crates/`。
|
||||
|
||||
### 1.2 基线绿灯(打 tag 时的实测值)
|
||||
|
||||
```
|
||||
cargo test --workspace → 695 passed / 0 failed
|
||||
scripts/check-arch.sh → 12 通过 / 0 失败 / 0 跳过
|
||||
cargo build --workspace → 成功
|
||||
```
|
||||
|
||||
**这三条是整个迁移的回归基准,任何一步做完都必须重跑并保持一致。**
|
||||
|
||||
### 1.3 现有 crates 与职责
|
||||
|
||||
| crate | 行数(src) | 依赖白名单 | 职责 |
|
||||
|---|---|---|---|
|
||||
| `sspf-contract` | 646 | serde/serde_json/uuid/http | 契约类型、码表、判别头、EntitySpec/Route |
|
||||
| `sspf-sdk` | 184 | sspf-contract | 业务包唯一入口(AR1) |
|
||||
| `sspf-store` | 1,685 | pglite/tokio/serde/chrono | 存储层:db + config(**不认识 HTTP**) |
|
||||
| `sspf-lowcode` | 6,261(+803 tests) | sspf-contract/serde | 低代码**纯计算**:解析/校验/SQL 生成 |
|
||||
| `sspf-mcp` | 5,619 | sspf-contract/serde/tokio | MCP 协议 + 工具契约 + PlatformAdapter trait |
|
||||
| `sspf-plugin` | 780 | sspf-sdk/sspf-contract | 业务包装载器(L2 静态) |
|
||||
| `sspf-adapter-baseline` | 1,078 | sspf-mcp/http/hyper | 基线 Java 后端 HTTP 适配器 |
|
||||
|
||||
> 另:`crates/sspf-lowcode/tests/` = 803 行(低代码 fixture 与单测)。
|
||||
|
||||
---
|
||||
|
||||
## 2. 🔴 三个必须先解开的循环依赖
|
||||
|
||||
> **这是整个迁移的技术核心。** crate 之间不允许循环依赖(Rust 编译器直接报错),
|
||||
> 而当前代码里有 **3 处** 循环。**不解开,第一步就会编译失败。**
|
||||
|
||||
### 2.1 循环 A:`platform/auth.rs` ↔ `platform/compat/helper.rs` ⛔ 最难
|
||||
|
||||
```
|
||||
auth.rs:336 crate::platform::compat::helper::is_face_b(&headers)
|
||||
auth.rs:337 crate::platform::compat::helper::current_user(state, &headers).await
|
||||
auth.rs:403 crate::platform::compat::helper::is_face_b(headers)
|
||||
|
||||
helper.rs:22 use crate::platform::auth::require_login_face_b;
|
||||
helper.rs:23 use crate::platform::auth::resolve_user;
|
||||
```
|
||||
|
||||
**解法**:**面 B 判定已经在 contract 层了** —— 这是个好消息,改动量比预想小得多。
|
||||
|
||||
```
|
||||
crates/sspf-contract/src/headers.rs:32
|
||||
pub fn is_face_b(headers: &HeaderMap) -> bool # 已有,且带 3 条单测
|
||||
```
|
||||
|
||||
当前 `compat/helper.rs:89-92` 只是一个**转发壳**:
|
||||
```rust
|
||||
pub fn is_face_b(headers: &HeaderMap) -> bool {
|
||||
sspf_contract::headers::is_face_b(headers)
|
||||
}
|
||||
```
|
||||
|
||||
⇒ **`auth.rs` 改一行就能断环**:
|
||||
|
||||
```rust
|
||||
// auth.rs:336
|
||||
- if crate::platform::compat::helper::is_face_b(&headers) {
|
||||
+ if sspf_contract::headers::is_face_b(&headers) {
|
||||
```
|
||||
|
||||
**循环 A 至此只剩一半**:auth 不再依赖 compat ✅,但
|
||||
`helper.rs` 仍依赖 `auth::{require_login_face_b, resolve_user}`(反向单向,合法)。
|
||||
|
||||
> ⚠️ **仍需处理的残余**:`auth.rs:337` 调用 `compat::helper::current_user`(面 B 形状)。
|
||||
> 这是 auth → compat 的**第二条边**,断不掉 —— 除非把面 B 的 `current_user` 实现
|
||||
> **下沉到 compat 包**并让 auth 通过**回调/trait**取得,或反过来:
|
||||
> **把 `current_user` 的面 B 分流逻辑改为「auth 提供通用骨架 + compat 提供形状适配」**。
|
||||
>
|
||||
> **推荐解法**:auth 侧只保留「判定 + 取 user」,
|
||||
> 面 B 的 `PcUserVO` 形状组装**整体搬进 compat 包**(M4 时迁走),
|
||||
> auth 侧的 `current_user` 改为**按面分流**:
|
||||
> - 面 A ⇒ auth 内部实现(现状)
|
||||
> - 面 B ⇒ 由 compat 包注册的 handler 提供
|
||||
>
|
||||
> **工程手法**(避免 trait object 复杂度):把面 B 的 `current_user`
|
||||
> **整体搬到 compat 包**,auth 侧的 `current_user` 只留面 A 分支,
|
||||
> 面 B 分支改为**查一张「面 B current_user 处理器」注册表**(`OnceLock` 静态表,
|
||||
> 由壳在启动时注册)⇒ 运行时单向,编译期无环。
|
||||
|
||||
### 2.2 循环 B:`compat/helper.rs` ↔ `compat/system.rs`
|
||||
|
||||
```
|
||||
helper.rs:31 use super::system::{menu_node, official_view_path};
|
||||
system.rs:26 use super::helper::{EN_MENU, EN_USER, ..., guard, guard_any, ...};
|
||||
```
|
||||
|
||||
**解法**:两者必须**拆成两个 crate**,或**下沉公共部分**。
|
||||
|
||||
- `system.rs`(17,539 行):菜单树 / 字典 / 用户 / 日志 / 系统配置
|
||||
- `helper.rs`(902 行):公共底座(守卫 / 分页 / 参数解析 / VO 构造)
|
||||
|
||||
**依赖广度证据**(实测,**14/14** 个 compat 模块都依赖 helper):
|
||||
```
|
||||
ai.rs:1 extend.rs:1 message.rs:1 mobile.rs:1 msg_center.rs:1
|
||||
online_dev.rs:1 permission.rs:1 report.rs:1 res.rs:1
|
||||
scheduletask.rs:1 system.rs:1 teamwork.rs:1 visualdata.rs:1 workflow.rs:1
|
||||
```
|
||||
⇒ **helper 必须是所有 compat 包的公共底座** ⇒ 它**必须**独立成一个 crate。
|
||||
|
||||
> `helper.rs` 依赖 `platform/auth` + `platform/authorization` + `platform/crud` + `platform/db`
|
||||
> ⇒ 它**不是纯契约层**,得是一个能依赖 axum 的 crate。
|
||||
> **决策**:新建 `crates/sspf-compat-core`(依赖 axum + sspf-core + sspf-contract + sspf-store),
|
||||
> 承载 helper + 通用守卫 + VO 构造。
|
||||
>
|
||||
> **注意**:`helper.rs` 里的 `menu_node` / `official_view_path`(来自 system)
|
||||
> 与 `USER_DETAIL_COLUMNS` / `organize_name_of`(来自 permission)**要搬回各自的包**
|
||||
> —— 否则 compat-core 反过来依赖 system/permission ⇒ 环只是换了个位置。
|
||||
|
||||
### 2.3 循环 C:`compat/helper.rs` ↔ `compat/permission.rs`
|
||||
|
||||
```
|
||||
helper.rs:32 use super::permission::{USER_DETAIL_COLUMNS, organize_name_of};
|
||||
permission.rs:29 use super::helper::{...}; // ← 22 个符号
|
||||
```
|
||||
|
||||
**解法**:与 2.2 同源 —— helper 下沉成独立 crate 后,
|
||||
`USER_DETAIL_COLUMNS`(一个 SQL 列清单常量)与 `organize_name_of`(一个查询函数)
|
||||
随 permission 留在 permission 包,helper 反过来依赖 permission ⇒ **单向**。
|
||||
|
||||
> ⚠️ 这会让 helper → permission,而 permission → helper 的 22 个符号必须**全部**从
|
||||
> helper 侧消失 ⇒ 需要逐个确认它们各自归属哪个包。
|
||||
> **本项是迁移中工作量最大的一步**,建议单独排一个批次。
|
||||
|
||||
### 2.4 循环汇总与解法
|
||||
|
||||
| 环 | 涉及 | 解法 | 难度 |
|
||||
|---|---|---|---|
|
||||
| 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(核心下沉)**不受环影响**,可以独立推进。
|
||||
|
||||
---
|
||||
|
||||
## 2.5 环的完整证据(实测,非推断)
|
||||
|
||||
```
|
||||
# 循环 A(auth → compat)
|
||||
auth.rs:336 if crate::platform::compat::helper::is_face_b(&headers) {
|
||||
auth.rs:337 return crate::platform::compat::helper::current_user(state, &headers).await;
|
||||
auth.rs:403 if crate::platform::compat::helper::is_face_b(headers) {
|
||||
# compat → auth(反向边)
|
||||
helper.rs:22 use crate::platform::auth::require_login_face_b;
|
||||
helper.rs:23 use crate::platform::auth::resolve_user;
|
||||
|
||||
# 循环 B
|
||||
helper.rs:31 use super::system::{menu_node, official_view_path};
|
||||
system.rs:26 use super::helper::{EN_MENU, EN_USER, ..., guard, guard_any, ...};
|
||||
|
||||
# 循环 C
|
||||
helper.rs:32 use super::permission::{USER_DETAIL_COLUMNS, organize_name_of};
|
||||
permission.rs:29 use super::helper::{...22 个符号...};
|
||||
```
|
||||
|
||||
**已验证 `platform/` 内部无环**(实测依赖图):
|
||||
```
|
||||
auth → authorization/cipher/db/envelope/registry/session/state
|
||||
session → cipher
|
||||
authorization → db
|
||||
crud → auth/authorization/db/entity/envelope/ids/registry/route/session/state
|
||||
registry → authorization/db
|
||||
state → config/db/session
|
||||
sys → auth/cipher/db/envelope/ids/state
|
||||
seed → cipher/db/ids/menu/registry
|
||||
```
|
||||
⇒ 全部**单向向下**,无回边 ✅ ⇒ M2 可独立推进。
|
||||
|
||||
---
|
||||
|
||||
## 3. 目标形态
|
||||
|
||||
```
|
||||
ssw-platform/
|
||||
├── Cargo.toml # workspace 根(members 自动含 crates/*)
|
||||
├── crates/ # 【平台能力包】全部在这里
|
||||
│ ├── sspf-contract/ # 契约类型 + 面 B 判定(is_face_b)+ 码表
|
||||
│ ├── sspf-sdk/ # 业务包唯一入口(AR1 不变)
|
||||
│ ├── sspf-store/ # 存储层(db + config)
|
||||
│ ├── sspf-lowcode/ # 低代码纯计算
|
||||
│ ├── sspf-mcp/ # MCP 协议层
|
||||
│ ├── sspf-plugin/ # 业务包装载器
|
||||
│ ├── sspf-adapter-baseline/ # 基线 Java 适配器
|
||||
│ │
|
||||
│ ├── 🆕 sspf-core/ # 平台核心:auth/session/authorization/crud/sys/menu
|
||||
│ │ # (依赖 axum + store + contract)
|
||||
│ ├── 🆕 sspf-compat-core/ # 契约面公共底座:helper/守卫/VO/参数解析
|
||||
│ ├── 🆕 sspf-compat-system/ # 契约面:system(菜单/字典/用户/日志)
|
||||
│ ├── 🆕 sspf-compat-permission/ # 契约面:permission(用户/角色/机构/授权)
|
||||
│ ├── 🆕 sspf-compat-workflow/ # 契约面:workflow + report + visualdata
|
||||
│ ├── 🆕 sspf-compat-msg/ # 契约面:message + msg_center + scheduletask
|
||||
│ ├── 🆕 sspf-compat-ext/ # 契约面:extend + teamwork + ai + mobile + core + res
|
||||
│ └── 🆕 sspf-compat-online-dev/ # 契约面:online_dev
|
||||
│
|
||||
├── packs/ # 【业务包】不变
|
||||
└── src/backend/ # 【薄壳】只剩这些
|
||||
├── Cargo.toml
|
||||
├── src/
|
||||
│ ├── main.rs # 启动装配(1,108 行)
|
||||
│ ├── lib.rs # 模块清单
|
||||
│ ├── routes.rs # 路由注册(3,249 行 —— 引用各 compat 包)
|
||||
│ ├── bootstrap.rs # 装配根(320 行)
|
||||
│ ├── packs_gen.rs # 生成物
|
||||
│ ├── modules/ # 业务层(900 行)
|
||||
│ └── platform/ # 🔴 只剩 re-export 转发壳(保持旧路径不破)
|
||||
└── tests/ # 集成测试(跟着壳走)
|
||||
```
|
||||
|
||||
**壳的判定标准**:能搬到 `crates/` 且**不属于业务**的,全部搬走;
|
||||
`src/backend/` 里保留的代码**必须**是「装配」或「转发」。
|
||||
|
||||
---
|
||||
|
||||
## 4. 迁移顺序(7 个批次,每批独立可交付、可回滚)
|
||||
|
||||
> **原则**:每批次结束必须 `cargo test --workspace` 全绿 + `check-arch.sh` 全绿 + `verify.sh --smoke` 全绿。
|
||||
> **不合批**:编译不过的中间态不进主干(用 feature flag 或分支)。
|
||||
|
||||
### 批次 M1 —— 解开三个循环(**不改目录结构,只改代码**)
|
||||
|
||||
**目标**:消除 A/B/C 三个环,但代码**仍在** `src/backend/` 里(用模块重命名,不搬 crate)。
|
||||
|
||||
| # | 动作 | 文件:行 | 断掉的边 | 实际做法 |
|
||||
|---|---|---|---|---|
|
||||
| 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 | ✅ 同上 |
|
||||
|
||||
> ✅ **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 又得依赖它们 ⇒ 环还在。
|
||||
|
||||
**出口判据**(全部已达成):
|
||||
- [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`
|
||||
|
||||
**迁入**:`platform/{auth,session,authorization,crud,sys,menu,guard,monitor,registry,state,seed,variate_catalog}.rs` + `platform/{cipher,envelope,ids,config,db}.rs`(后四个转 `pub use sspf_store` / `sspf_contract` 转发)
|
||||
|
||||
**新 crate**:`crates/sspf-core`
|
||||
```toml
|
||||
[dependencies]
|
||||
sspf-contract = { path = "../sspf-contract" }
|
||||
sspf-store = { path = "../sspf-store" }
|
||||
axum = { workspace = true }
|
||||
tokio = { workspace = true }
|
||||
serde = { workspace = true }
|
||||
serde_json = { workspace = true }
|
||||
```
|
||||
|
||||
**保留转发壳**:`src/backend/src/platform/*.rs` 全部改成 `pub use sspf_core::*;`
|
||||
⇒ **上层零感知**(测试、routes、modules 全部不用改 import)。
|
||||
|
||||
> 🔴 **`state.rs`(AppState)是关键**:`config`/`db`/`sessions`/`tickets` 四个 `Arc`。
|
||||
> 它必须跟着 core 走(compat 包也要用 AppState)⇒ 放在 `sspf-core` 最底部。
|
||||
|
||||
**出口判据**:`src/backend/src/platform/` 每个文件 ≤ 10 行(纯 re-export);695 测试仍全绿。
|
||||
|
||||
### 批次 M3 —— 契约面公共底座:`sspf-compat-core`
|
||||
|
||||
**迁入**:`platform/compat/helper.rs`(902 行)+ `platform/compat/res.rs`(460 行)
|
||||
|
||||
**新 crate**:`crates/sspf-compat-core`(依赖 axum + sspf-core + sspf-contract + sspf-store)
|
||||
|
||||
**出口判据**:`check-contract-scan.py` 的守卫推导**仍然有效**(见 §5 闸门改造)。
|
||||
|
||||
### 批次 M4 —— 契约面业务包(6 个并行包)
|
||||
|
||||
按依赖顺序切,每个包 = 若干 `compat/<模块>.rs`:
|
||||
|
||||
| 新 crate | 含文件 | 行数 | 依赖 |
|
||||
|---|---|---|---|
|
||||
| `sspf-compat-system` | system.rs | 17,539 | compat-core + core |
|
||||
| `sspf-compat-permission` | permission.rs | 6,300 | compat-core + core |
|
||||
| `sspf-compat-msg` | message + msg_center + scheduletask | 6,053 | compat-core + core |
|
||||
| `sspf-compat-workflow` | workflow + report + visualdata | 7,729 | compat-core + core |
|
||||
| `sspf-compat-ext` | extend + teamwork + ai + mobile + core | 6,787 | compat-core + core |
|
||||
| `sspf-compat-online-dev` | online_dev.rs | 3,175 | compat-core + core |
|
||||
|
||||
**出口判据**:每个包独立 `cargo build` 通过;`check-contract.sh` 10/10。
|
||||
|
||||
### 批次 M5 —— 低代码执行层下沉
|
||||
|
||||
**迁入**:`lowcode_{crud,ddl,check,seed}.rs`(2,674 行)
|
||||
|
||||
**新 crate**:`crates/sspf-lowcode-exec`(依赖 sspf-lowcode + sspf-core + sspf-store + sspf-mcp)
|
||||
|
||||
> `sspf-lowcode`(纯计算)**不动** —— AR7 白名单保持不变。
|
||||
> 新 crate 是「执行层」,允许依赖 DB。
|
||||
|
||||
### 批次 M6 —— MCP 适配层下沉
|
||||
|
||||
**迁入**:`mcp_adapter.rs`(2,652 行)+ `mcp_compat.rs`(631 行)
|
||||
|
||||
**新 crate**:`crates/sspf-mcp-adapter`(依赖 sspf-mcp + sspf-core + sspf-compat-*)
|
||||
|
||||
> 🔴 `mcp_compat.rs` 直调 `platform::compat::*` 的 handler ⇒ 它依赖**所有** compat 包。
|
||||
> 这是唯一「知道全部包」的 crate ⇒ 它属于壳还是能力?
|
||||
> **决策**:放 `crates/`(它是「MCP 适配」这一项独立能力),但**放在最后一批**。
|
||||
|
||||
### 批次 M7 —— 收口:壳瘦身 + 闸门改造
|
||||
|
||||
- `src/backend/src/platform/` 只剩 re-export(如果 M2 决定保留旧路径)
|
||||
- 或**直接删掉** `platform/` 目录,全仓 import 改成 `sspf_core::…`(更干净,但改动面大 ⇒ 建议保留转发壳一个版本)
|
||||
- `routes.rs` 的 `compat::xxx::yyy` 引用改成 `sspf_compat_xxx::yyy`
|
||||
- `check-arch.sh` 新增 AR10–AR13
|
||||
- `check-contract-scan.py` / `check-boundary-scan.py` 路径改造(见 §5)
|
||||
|
||||
---
|
||||
|
||||
## 5. 🔴 闸门改造(**必须与迁移同步做,否则尺子失效**)
|
||||
|
||||
> 🔴 **这是最容易翻车的地方**:
|
||||
> 闸门脚本里写死了 `src/backend/src/platform` 路径。
|
||||
> 代码搬走后,脚本会**扫不到文件 ⇒ 永远"通过"** ⇒ **虚假安全感**。
|
||||
> `check-arch.sh` 的 AR9 自证注释里已经写明这一点(「这类尺子比没有更危险」)。
|
||||
|
||||
### 5.1 `scripts/check-arch.sh`
|
||||
|
||||
| 判据 | 现状 | 改造后 |
|
||||
|---|---|---|
|
||||
| AR9(平台层不许认识业务包) | grep `src/backend/src/platform` | 改成 grep **所有 crates 平台包** |
|
||||
| MEM1 / MEM2 | walk `src/backend/src` + `crates` | 保持(已覆盖 crates)✅ |
|
||||
| 🆕 AR10 | — | `crates/sspf-core` 依赖 ⊆ {contract, store, axum, tokio, serde, serde_json} |
|
||||
| 🆕 AR11 | — | `crates/sspf-compat-*` 依赖 ⊆ {compat-core, core, contract, store, axum, ...},**不许**依赖 `packs/*` |
|
||||
| 🆕 AR12 | — | `crates/sspf-compat-*` 之间**不许**互相依赖(防环回流) |
|
||||
| 🆕 AR13 | — | `crates/sspf-lowcode-exec` 依赖 ⊆ {lowcode, core, store, mcp} |
|
||||
|
||||
### 5.2 `scripts/check-contract-scan.py`
|
||||
|
||||
**问题**:第 827 行 `plat_dir = os.path.join(src_dir, "platform")`、第 839 行 `compat_dir = ...` ——
|
||||
代码搬走后这两个目录**不存在** ⇒ `plat_files` 为空 ⇒ **守卫推导全部推不出** ⇒ CC6 静默退化成「全是 WARN」。
|
||||
|
||||
**改造**:
|
||||
```python
|
||||
# 改成扫描所有 crates 平台包
|
||||
PLAT_CRATES = ["sspf-core", "sspf-compat-core", "sspf-compat-system", ...]
|
||||
for c in PLAT_CRATES:
|
||||
d = os.path.join(ROOT, "crates", c, "src")
|
||||
... plat_files[f"{c}__{name}"] = (o, mask_rust(o))
|
||||
```
|
||||
**必须**在 M4 之后立刻做,并**重跑 `check-contract.sh --self-test`** 确认没退化。
|
||||
|
||||
### 5.3 `scripts/check-boundary-scan.py` / `check-boundary.sh`
|
||||
|
||||
**问题**:扫 `src/backend/src/platform/` 找业务标识符。代码搬走后**扫不到** ⇒ 平台层混入业务知识**不再被发现**。
|
||||
|
||||
**改造**:扫目录改成「所有 crates 平台包」+ `src/backend/src`(薄壳也要扫)。
|
||||
|
||||
### 5.4 `scripts/check-module.sh`
|
||||
|
||||
`BACKEND="$ROOT/src/backend"` + `src/backend/src/modules/<app>.rs` ——
|
||||
业务层**留在壳里** ⇒ **不用改** ✅(除非 M7 决定把业务层也搬走,**不建议**)。
|
||||
|
||||
### 5.5 `scripts/check-naming.sh`
|
||||
|
||||
第 128 行已经扫 `crates/*/Cargo.toml` ⇒ **不用改** ✅。
|
||||
|
||||
### 5.6 `scripts/pack-sync.py`
|
||||
|
||||
生成 `src/backend/src/packs_gen.rs` + `src/backend/Cargo.toml` 的包依赖段 ——
|
||||
业务包留在壳侧 ⇒ **不用改** ✅。
|
||||
|
||||
---
|
||||
|
||||
## 6. 风险清单
|
||||
|
||||
| # | 风险 | 等级 | 缓解 |
|
||||
|---|---|---|---|
|
||||
| R1 | **闸门静默失效**(扫不到文件 ⇒ 永远通过) | 🔴 极高 | 每批次后跑 `--self-test`;M4 之后必须重跑 `check-contract.sh --self-test` |
|
||||
| R2 | **三处循环解不干净** ⇒ 编译失败 | 🔴 高 | M1 单独一批,不与其他混;解不干净就停手回滚 |
|
||||
| R3 | **694+ 测试的 import 路径全断** | 🟡 中 | M2 保留 `platform/` re-export 转发壳 ⇒ 上层零感知 |
|
||||
| R4 | **`mcp_compat.rs` 依赖所有 compat 包** ⇒ 依赖网爆炸 | 🟡 中 | 放最后一批(M6) |
|
||||
| R5 | **crate 数量爆炸**(7 → 15)⇒ 编译变慢 | 🟡 中 | cargo 增量编译按 crate 隔离,实际可能**变快**(改一个包不必重编全仓) |
|
||||
| R6 | **AR 白名单要重写** ⇒ 纪律放松 | 🟡 中 | 每次新增 crate 必须同时加 AR 条目 + 反自证 |
|
||||
| R7 | 合并冲突(多人并行) | 🟢 低 | 按包切分文件,冲突面小 |
|
||||
| R8 | 迁移期间**功能退化** | 🔴 高 | 每批次必须全绿才进下一批;tag `v0.1.0` 随时可回滚 |
|
||||
|
||||
---
|
||||
|
||||
## 7. 回滚策略
|
||||
|
||||
```bash
|
||||
# 任意批次失败 ⇒ 一条命令回到基线
|
||||
git reset --hard v0.1.0
|
||||
|
||||
# 或回到上一个绿批次(每批次一个 tag)
|
||||
git tag -a v0.1.1-m1 -m "M1 解耦完成"
|
||||
git reset --hard v0.1.1-m1
|
||||
```
|
||||
|
||||
**纪律**:
|
||||
- 每个批次**单独 commit**,message 写清批次号
|
||||
- 每批次**单独 tag**(`v0.1.N-mX`)
|
||||
- **任何一批不合绿,不进下一批**
|
||||
|
||||
---
|
||||
|
||||
## 8. 验收标准(最终态)
|
||||
|
||||
| 指标 | 现状 | 目标 |
|
||||
|---|---|---|
|
||||
| `src/backend/src` 行数 | 90,471 | **≤ 8,000**(壳:routes + main + bootstrap + modules + 转发壳) |
|
||||
| `crates/` 包数 | 7 | **15** |
|
||||
| `src/backend/src/platform/` 内容 | 55,578 行真实实现 | **纯 re-export(每文件 ≤ 10 行)** |
|
||||
| `cargo test --workspace` | 695 passed | **695 passed(数不许减少)** |
|
||||
| `check-arch.sh` | 12/12 | **17/17**(新增 AR10–AR13 + 反自证) |
|
||||
| `check-contract.sh` | 10/10 | **10/10(不得退化)** |
|
||||
| `check-boundary.sh` | 11/11 | **11/11(不得退化)** |
|
||||
| `verify.sh --smoke` | 14 步全绿 | **14 步全绿** |
|
||||
| `mem-budget.sh` | 8MB / 40MB | **≤ 40MB**(拆 crate 不应增加) |
|
||||
| 586 探针 | 0 个 404/405/500 | **0 个** |
|
||||
|
||||
> 🔴 **断言数不许写死**:拆 crate 后测试数会变(集成测试可能要重新归位到各 crate 的 `tests/`),
|
||||
> 跑一遍看实际值再更新文档(CLAUDE.md §6 已明确这条纪律)。
|
||||
|
||||
---
|
||||
|
||||
## 9. 执行顺序建议
|
||||
|
||||
```
|
||||
M1 解耦(3 个循环) ← 不搬文件,只改代码,风险最高,最先做
|
||||
↓
|
||||
M2 sspf-core ← 平台核心下沉,保留 re-export 壳
|
||||
↓
|
||||
M3 sspf-compat-core ← 契约面底座
|
||||
↓
|
||||
M4 六个 compat 包 ← 🔴 同步改 check-contract-scan.py
|
||||
↓
|
||||
M5 sspf-lowcode-exec
|
||||
↓
|
||||
M6 sspf-mcp-adapter
|
||||
↓
|
||||
M7 壳收口 + 闸门补全 ← AR10–AR13 + 全量反自证
|
||||
```
|
||||
|
||||
**每一批的出口判据都相同**:
|
||||
```bash
|
||||
cargo build --workspace &&
|
||||
cargo test --workspace && # 695 全绿,0 failed
|
||||
bash scripts/check-arch.sh && # 全绿
|
||||
bash scripts/check-contract.sh && # 全绿,且 --self-test 通过
|
||||
bash scripts/check-boundary.sh && # 全绿
|
||||
bash scripts/verify.sh --smoke # 14 步全绿
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 10. 与 ssw-mvp/boot 的对应关系
|
||||
|
||||
| ssw-mvp/boot | 本仓目标 | 说明 |
|
||||
|---|---|---|
|
||||
| `ssw-common/`(biz/entity/controller) | `crates/sspf-core` + `crates/sspf-contract` | 本仓**多一层** contract(因为要兼容官方 JNPF 契约) |
|
||||
| `ssw-sswflow/`(biz/entity/controller) | `crates/sspf-compat-workflow` | 同款三件套思路,但本仓是「契约面 handler」不是「业务实体」 |
|
||||
| `ssw-tdc/`、`ssw-tds/` | `crates/sspf-compat-*` 其余包 | 按官方模块名切,边界最清晰 |
|
||||
| `ssw-admin/`(聚合入口) | `src/backend/`(薄壳) | **启动装配 + 路由注册**,与 ssw-admin 同款定位 |
|
||||
|
||||
> ⚠️ **一处差异**:ssw-mvp 的 `*-controller` **自带 axum 依赖**(它就是 web 层);
|
||||
> 本仓的 `crates/sspf-compat-*` 也依赖 axum ⇒ **两者同款**,
|
||||
> 不违反 AR6(AR6 管的是 `sspf-plugin` 装载器不许拖 web 框架,不是管 compat 包)。
|
||||
|
||||
---
|
||||
|
||||
## 11. 待确认决策
|
||||
|
||||
1. **M2 保留 `platform/` re-export 转发壳,还是直接删掉?**
|
||||
- 保留 ⇒ 上层零感知、改动小,但壳里多 20 个转发文件
|
||||
- 删除 ⇒ 壳更干净,但全仓 import 要改(测试 30+ 处)
|
||||
- **建议**:保留一个版本(M7 再决定删不删)
|
||||
|
||||
2. **compat 包拆几个?** 现在按「官方模块名」拆 6 个。
|
||||
另一种拆法:按「业务域」拆 3 个(大系统/大流程/大消息)。
|
||||
**建议**:按官方模块名(边界清晰、与官方前端 `api/` 目录一一对应)
|
||||
|
||||
3. **`mcp_compat.rs` 放 crates 还是留壳?**
|
||||
它依赖**所有** compat 包 ⇒ 放 crates 会让「壳依赖能力」变成「能力依赖能力」。
|
||||
**建议**:放 crates(它是独立能力),但**接受**它是依赖图里唯一的高扇入节点
|
||||
|
||||
4. **`src/backend/tests/` 要不要跟着拆到各 crate 的 `tests/`?**
|
||||
- 拆 ⇒ 测试与代码同域,但需要共享 pglite 单例(`test_support.rs`)跨 crate 复用
|
||||
- 不拆 ⇒ 留壳里(`tests/` 是壳的一部分,测的是「装配后的整体」⇒ 语义更对)
|
||||
- **建议**:不拆(集成测试测的是装配结果,留在壳侧语义正确)
|
||||
|
||||
---
|
||||
|
||||
## 12. 立即可做的下一步
|
||||
|
||||
**执行 M1(解开三个循环)**。理由:
|
||||
1. 不改目录结构 ⇒ 风险最低
|
||||
2. 是所有后续批次的**前置**(不解开,后面全部编译不过)
|
||||
3. 单独可验证(编译过 + 695 测试仍全绿)
|
||||
|
||||
M1 完成后打 tag `v0.1.1-m1`,再进 M2。
|
||||
+148
-4
@@ -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
|
||||
|
||||
@@ -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))
|
||||
|
||||
@@ -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` /
|
||||
|
||||
@@ -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();
|
||||
|
||||
@@ -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`。
|
||||
///
|
||||
|
||||
@@ -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)----
|
||||
|
||||
Reference in new issue
Block a user