refactor(arch): M4 契约面下沉 —— 14 模块 / ~49,000 行迁入 6 个 crate

把 src/backend/src/platform/compat/ 下的 14 个契约面模块拆进 6 个 crate,
原路径全部变成 5 行转发壳 ⇒ 上层 import 零感知,695 个测试一个没改。

新 crate(按官方模块名切,实测依赖图定分组):
- sspf-compat-system     system + scheduletask + core
- sspf-compat-permission permission(单向依赖 system,4 符号)
- sspf-compat-msg        message + msg_center
- sspf-compat-workflow   workflow + report + visualdata
- sspf-compat-ext        extend + teamwork + ai + mobile(单向依赖 system + msg)
- sspf-compat-online_dev online_dev(🔴 Rust 包名不能带连字符)

闸门改造:
- check-arch.sh 新增 PLAT_SRC_DIRS(动态 glob)⇒ AR9/AR10 扫真源
- check-arch.sh 新增 AR12(契约面各包彼此独立,Cargo.toml 级判据 + 3 条单向白名单)
- check-contract-scan.py 动态收编所有 crates/sspf-compat-*/src(不写死列表)
- check-boundary.sh 新增动态 COMPAT_DIRS ⇒ CP1/CP2 纳入契约面包
- 修 8 条引文路径(行号 1:1 未变 ⇒ 迁移是纯搬运)

🔴 三个「尺子是假的」的坑(都是反自证抓出来的):
1. CC6 守卫推导静默失效 —— compat_dirs 只收了 sspf-compat-core,六包真源没收
   ⇒ 改动态 glob;反向验证:改坏真源 EN_ROLE ⇒ CC6 精确报出
2. CP1 业务标识符未扫契约面包 ⇒ 加 COMPAT_DIRS;反向验证:插 LEAK_PROBE ⇒ 精确报出
3. macOS 的 BSD grep 不支持 \s(POSIX ERE)⇒ AR11/AR12 的 Cargo.toml 级判据
   永远匹配不到 ⇒ 永远「通过」(AR11 从 M3 起就没真正生效过)
   ⇒ 改 [[:space:]];全仓扫过 scripts/*.sh 确认只有这一处

数字:cargo build 零警告;cargo test 695/0(与 M1 基线完全一致);
check-arch 15/15;--self-test 7/7;check-boundary 11/11;check-contract 10/10
(反自证 12 例全过);check-module 123/123;check-citations 4/4;
check-naming 3/0/1;verify.sh --smoke 14 步全绿(300.9s)
This commit is contained in:
admin committed 2026-11-03 18:57:00 +08:00
1 parent eea3d0329f
commit a2dc1df3a2
51 files changed
+48289 -47571

No files matched your search

+36 -3
View File
@@ -56,9 +56,9 @@
- **基线 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。
- **环 A**:`platform/auth.rs:336/403/337` ↔ `compat/helper.rs:22/23` —— 解法比预想简单:**`sspf_contract::headers::is_face_b` 早就存在**(带 3 条单测),`crates/sspf-compat-core/src/helper.rs:89` 只是转发 ⇒ `auth.rs` 改一行断一条边;残余是面 B `current_user`(`crates/sspf-compat-core/src/helper.rs:391`)仍需**注册表回调**才能断。
- **环 B**:`crates/sspf-compat-core/src/helper.rs:31` ↔ `crates/sspf-compat-system/src/system.rs:26` —— helper 下沉成 `sspf-compat-core`;`menu_node`/`official_view_path` 留 system。
- **环 C**:`crates/sspf-compat-core/src/helper.rs:32` ↔ `crates/sspf-compat-permission/src/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,不合绿不进下一批。
@@ -98,3 +98,36 @@
- 🔴 **踩坑(真踩了)**:反向验证后用 `git checkout -- <file>` 清理探针 ⇒ **把 M3 的改写一并回退到暂存区**(`crate::platform`×14、`pub(super)`×54 复活,编译会炸)。**教训:有未暂存改动的文件绝不能用 `git checkout --` 清理临时改动** ⇒ 必须用 Python/编辑精确删目标行。这次是靠事后核验文件内容才发现的。
- **数字**:`cargo build` 零警告;`cargo test` **695/0**;`check-arch` 14/14;`--self-test` 6/6;`check-boundary` 11/11;`check-contract` 10/10(CC6 零漂移);`check-module` 123/123;`check-citations` 4/4;`verify --smoke` 14 步全绿(561.3s)。
- ⏭ **下一步 = M4(六个契约面包)**:`sspf-compat-{system,permission,msg,workflow,ext,online-dev}`。⚠️ 必须同步做 `check-contract-scan.py` 六包收编 + 重跑 `--self-test`。
### 17:00–18:40 M4 完成:六个契约面包下沉(tag v0.1.4-m4)
- **做法**:`src/backend/src/platform/compat/` 下 **14 个模块 / ~49,000 行**下沉到 6 个 crate
(`sspf-compat-{system,permission,msg,workflow,ext,online_dev}`),原路径全变 5 行转发壳
(`pub use sspf_compat_<域>::<模块>::*;`)⇒ **上层零感知**(695 测试 import 一个没改)。
- 🔴 **与原计划的差异(实测依赖图,非拍脑袋)**:① `scheduletask`/`core` **不依赖**任何其它契约面模块 ⇒ 并进 system
(原计划分给 msg/ext),少两条 crate 边;② 🔴 **`sspf-compat-online-dev` 必须改名 `sspf-compat-online_dev`**
—— Rust 包名不能带连字符(`use sspf-compat-online-dev::…` 编译不过 ⇒ `expected one of '::', ';', or 'as', found '-'`);
③ 跨包依赖实测只有 **3 条**,全单向不成环:`permission→system`(4 符号)、`ext→system`+`ext→msg`(2 函数)。
- 🔴 **本批三个坑,全部是「尺子是假的」**:
1. **CC6 守卫推导静默失效** —— 搬迁后 `check-contract.sh` **首次跑就 10/10 全绿**(M2/M3 都报红)⇒ **可疑**。
核实 `check-contract-scan.py` 的 `compat_dirs` **只收了 `sspf-compat-core`**,六包真源没收 ⇒ 守卫推导读的是转发壳(无函数体)。
修法:**动态 glob 收编**所有 `crates/sspf-compat-*/src`(写死路径列表必然在某次新增包时漏掉 ⇒ 尺子静默失效)。
反向验证:改坏真源 `permission.rs:135` 的 `EN_ROLE`→`EN_ACTION` ⇒ CC6 精确报出「GET /api/permission/Role:契约写 permission.role,代码是 permission.action」;还原后 10/10。
2. **CP1 业务标识符未扫契约面包** —— `check-boundary.sh` 只扫 sspf-core + platform/。修法:动态 `COMPAT_DIRS` 纳入 CP1/CP2。
反向验证:往 `crates/sspf-compat-msg/src/msg_center.rs` 插 `const LEAK_PROBE: &str = "demo_item";` ⇒ CP1 精确报出该行;还原后 11/11。
3. 🔴 **macOS 的 BSD grep 不支持 `\s`(POSIX ERE)** —— AR11/AR12 的 Cargo.toml 级判据写成
`grep -E '^\s*sspf-compat-...'` ⇒ **永远匹配不到 ⇒ 永远"通过"**(AR11 从 M3 起就没真正生效过)。
是 **AR12 反自证第一次跑就失败**暴露的 ⇒ 修 `[[:space:]]`;全仓扫 `scripts/*.sh` 确认只有这一处(注释里还有一处,不影响执行)。
- 🔴 **AR12**(新增):契约面各包彼此独立,Cargo.toml 级判据,白名单 3 条单向边。
**反自证 7/7**:往 `sspf-compat-msg/Cargo.toml` 塞 `sspf-compat-workflow` 依赖(未授权且立刻成环)⇒ 必须被抓到。
- 🔴 **三条纪律(已写进计划文档 §12,M5/M6 必须继承)**:
① **闸门判据里的正则必须用反自证验证过一次才敢信** —— `grep` 不报错 + 退出码 0 + 打印 `ok` = 三重「看起来正常」,
但 BSD grep 的 `\s` 让 AR11/AR12 一直空转;② **收编新目录一律用 glob**,不写死清单;
③ **搬迁后第一反应不该是「全绿」而是「可疑」** —— M2/M3 搬迁后闸门都报红(正常),M4 首次跑就 10/10 ⇒ 反而是尺子坏了的信号。
- **数字**:`cargo build --workspace` 零警告;`cargo test --workspace` **695 passed / 0 failed**(与 M1 基线完全一致);
`check-arch` **15/15**;`--self-test` **7/7**;`check-boundary` 11/11;`check-contract` 10/10(反自证 12 例全过);
`check-module` 123/123;`check-citations` 4/4;`check-naming` 3/0/1;`verify --smoke` 14 步全绿(300.9s)。
- **引文修正**:8 条引文路径改到新真源(**行号 1:1 未变** ⇒ M4 迁移是纯搬运;用 difflib 建立旧→新行号映射核对)。
⚠️ 两处是**历史叙述**(记录当时动作),改了会失真 ⇒ 改措辞(去掉行号形式)而不是改路径。
- ⏭ **下一步 = M5(`sspf-lowcode-exec`)**:迁 `lowcode_{crud,ddl,check,seed}.rs`(2,674 行),
新 crate 依赖 sspf-lowcode + core + store + mcp。⚠️ 必须同步加 **AR13**(依赖白名单)+ 重跑全部 `--self-test`。
+9 -1
View File
@@ -102,6 +102,13 @@ ssw-platform/
│ ├── sspf-store/ # (P0-b)DB 抽象:pglite ⇄ 真实 PG
│ ├── sspf-core/ # 🔴 平台核心(M2):auth/CRUD/权限/种子/cipher/信封/…
│ │ # `src/backend/src/platform/*.rs` 只是它的转发壳
│ ├── sspf-compat-core/ # 🔴 契约面底座(M3):helper/res(判别头/守卫/分页信封)
│ ├── sspf-compat-system/ # 🔴 契约面(M4):system + scheduletask + core
│ ├── sspf-compat-permission/# 🔴 契约面(M4):permission(单向依赖 system)
│ ├── sspf-compat-msg/ # 🔴 契约面(M4):message + msg_center
│ ├── sspf-compat-workflow/ # 🔴 契约面(M4):workflow + report + visualdata
│ ├── sspf-compat-ext/ # 🔴 契约面(M4):extend + teamwork + ai + mobile
│ ├── sspf-compat-online_dev/# 🔴 契约面(M4):online_dev(🔴 包名不能带连字符)
│ ├── sspf-lowcode/ # (P2)元数据引擎 + Rhai 沙箱
│ ├── sspf-plugin/ # (P3)业务包加载器:静态 / dylib / wasm
│ └── sspf-mcp/ # (P1)MCP 2.0 元工具层
@@ -117,7 +124,8 @@ ssw-platform/
│ │ │ ├── platform/ # 【平台层】M2 起**真源在 `crates/sspf-core/src/`**
│ │ │ │ │ # 这里每个 .rs 只是转发壳(`pub use sspf_core::<mod>::*;`)
│ │ │ │ │ # ⇒ 上层 import 路径不变;别往壳里塞实现(AR9/AR10 会红)
│ │ │ │ ├── compat/ # 【面 B 契约面】尚未下沉(M3/M4)—— 真实现还在这里
│ │ │ │ ├── compat/ # 【面 B 契约面】M3/M4 起**真源在 `crates/sspf-compat-*/src/`**
│ │ │ │ │ # 这里每个 .rs 只是转发壳(`pub use sspf_compat_<域>::<模块>::*;`)
│ │ │ │ ├── test_support.rs # 测试用**进程级共享** pglite(依赖装配根 ⇒ 留壳层)
│ │ │ │ └── mod.rs # 转发壳汇总
│ │ │ ├── modules/ # 【业务层】加业务模块只改这里
Generated
+91
View File
@@ -1094,6 +1094,91 @@ dependencies = [
"sspf-core",
]
[[package]]
name = "sspf-compat-ext"
version = "0.1.0"
dependencies = [
"axum",
"chrono",
"serde",
"serde_json",
"sspf-compat-core",
"sspf-compat-msg",
"sspf-compat-system",
"sspf-contract",
"sspf-core",
]
[[package]]
name = "sspf-compat-msg"
version = "0.1.0"
dependencies = [
"axum",
"chrono",
"serde",
"serde_json",
"sspf-compat-core",
"sspf-contract",
"sspf-core",
]
[[package]]
name = "sspf-compat-online_dev"
version = "0.1.0"
dependencies = [
"axum",
"serde",
"serde_json",
"sspf-compat-core",
"sspf-contract",
"sspf-core",
]
[[package]]
name = "sspf-compat-permission"
version = "0.1.0"
dependencies = [
"axum",
"chrono",
"serde",
"serde_json",
"sspf-compat-core",
"sspf-compat-system",
"sspf-contract",
"sspf-core",
"sspf-store",
]
[[package]]
name = "sspf-compat-system"
version = "0.1.0"
dependencies = [
"axum",
"chrono",
"serde",
"serde_json",
"sspf-compat-core",
"sspf-contract",
"sspf-core",
"sspf-store",
]
[[package]]
name = "sspf-compat-workflow"
version = "0.1.0"
dependencies = [
"aes",
"axum",
"chrono",
"ecb",
"hex",
"serde",
"serde_json",
"sspf-compat-core",
"sspf-contract",
"sspf-core",
]
[[package]]
name = "sspf-contract"
version = "0.1.0"
@@ -1196,6 +1281,12 @@ dependencies = [
"serde_json",
"serde_urlencoded",
"sspf-compat-core",
"sspf-compat-ext",
"sspf-compat-msg",
"sspf-compat-online_dev",
"sspf-compat-permission",
"sspf-compat-system",
"sspf-compat-workflow",
"sspf-contract",
"sspf-core",
"sspf-lowcode",
+55 -2
View File
@@ -147,7 +147,7 @@ M2 的「转发壳 + 闸门扫真源 + 反自证两处注入」套路**直接复
**闸门改造(同「两处都扫」纪律)**:
- `check-arch.sh` AR11 扫真源 + 壳,**新增 Cargo.toml 级判据**(`sspf-compat-core` 不许依赖 `sspf-compat-*`);反自证 6/6 两处注入、按路径分别验
- `check-contract-scan.py` 的 `plat_files` 对 `compat__<mod>` **收真源 + 壳同键拼接** —— 守卫常量(`EN_ROLE` 等)在 helper 真源里,漏收则 CC6 假漂移
- 修 1 条引文(`compat/helper.rs:89-92` → `crates/sspf-compat-core/src/helper.rs:87-91`)
- 修 1 条引文(旧壳 `compat/helper.rs` 的 89-92 行 → `crates/sspf-compat-core/src/helper.rs:87-91`)
**反向验证**:只往真源 helper 塞 `use crate::res::Res;` ⇒ AR11 报红;清理后恢复绿。
@@ -164,6 +164,59 @@ M2 的「转发壳 + 闸门扫真源 + 反自证两处注入」套路**直接复
---
## 0-0-pre5. 2026-11-03 18:40 **M4 完成**:六个契约面包下沉(tag `v0.1.4-m4`)
**做了什么**:`src/backend/src/platform/compat/` 下 **14 个模块 / ~49,000 行**下沉到 6 个 crate,
原路径全部变成 5 行转发壳(`pub use sspf_compat_<域>::<模块>::*;`)⇒ **上层零感知**。
| crate | 模块 | 行数 | 额外依赖 |
|---|---|---|---|
| `sspf-compat-system` | system + scheduletask + core | 19,764 | store + chrono |
| `sspf-compat-permission` | permission | 6,266 | **system**(4 符号)+ store + chrono |
| `sspf-compat-msg` | message + msg_center | 6,053 | chrono |
| `sspf-compat-workflow` | workflow + report + visualdata | 8,729 | chrono + aes/ecb/hex |
| `sspf-compat-ext` | extend + teamwork + ai + mobile | 8,142 | **system + msg**(2 函数)+ chrono |
| `sspf-compat-online_dev` | online_dev | 3,175 | — |
**实际做法与原计划的差异**(实测依赖图,非拍脑袋):
- ① 计划的分组按「官方模块名」切,实测后把**无跨包依赖**的 `scheduletask`/`core` 并进 system ⇒ 少两条 crate 边;
- ② 🔴 **`sspf-compat-online-dev` 改名 `sspf-compat-online_dev`** —— Rust 包名不能带连字符(`use sspf-compat-online-dev::…` 编译不过);
- ③ 跨包依赖只有 **3 条**,全是单向 ⇒ 不成环:`permission→system`、`ext→system`、`ext→msg`。
**闸门改造**:
- `check-arch.sh` 新增 **`PLAT_SRC_DIRS`**(动态 glob:core + 7 个 compat 包 + 壳)⇒ AR9/AR10 都扫真源;
- `check-arch.sh` 新增 **AR12**(契约面各包彼此独立,白名单 3 条单向边,**Cargo.toml 级**判据);
- `check-contract-scan.py` 动态收编所有 `crates/sspf-compat-*/src`(**不写死列表**);
- `check-boundary.sh` 新增动态 `COMPAT_DIRS` ⇒ CP1/CP2 纳入契约面包;
- 修 8 条引文(路径改到新真源;**行号 1:1 未变** ⇒ M4 迁移是纯搬运)。
**🔴 本批踩的三个坑(都是「尺子是假的」)**:
1. **CC6 守卫推导静默失效** —— M4 搬迁后 `check-contract.sh` **首次跑就 10/10 全绿**(M2/M3 都报红)⇒ 可疑。
核实 `check-contract-scan.py` 的 `compat_dirs` **只收了 `sspf-compat-core`** ⇒ 守卫推导读的是转发壳(无函数体)⇒ 尺子已废。
**反向验证**:改坏真源 `permission.rs:135` 的 `EN_ROLE`→`EN_ACTION` ⇒ CC6 精确报出;还原后恢复 10/10。
2. **CP1 业务标识符未扫契约面包** —— **反向验证**:往 `crates/sspf-compat-msg/src/msg_center.rs` 插
`const LEAK_PROBE: &str = "demo_item";` ⇒ CP1 精确报出该行;还原后恢复 11/11。
3. 🔴 **macOS 的 BSD grep 不支持 `\s`**(POSIX ERE)—— AR11/AR12 的 Cargo.toml 级判据都写成
`grep -E '^\s*sspf-compat-...'` ⇒ **永远匹配不到 ⇒ 永远"通过"**。
是 **AR12 反自证第一次跑就失败**暴露的。修复:全部改成 `[[:space:]]`;全仓扫过 `scripts/*.sh`,只有这一处。
**🔴 教训(已写进计划文档 §12)**:① 闸门判据里的正则**必须用反自证验证过一次**才敢信
(`grep` 不报错 + 退出码 0 + 打印 `ok` = 三重「看起来正常」);② 收编新目录一律用 **glob**,
写死路径列表必然在某次新增包时漏掉 ⇒ 尺子静默失效;③ 搬迁后第一反应不该是「全绿」而是「可疑」——
M2/M3 搬迁后闸门都报红(正常),M4 首次跑就 10/10 ⇒ 反而是尺子坏了的信号。
**出口判据(全部达成)**:
`cargo build --workspace` 零警告;`cargo test --workspace` = **695 passed / 0 failed**(与 M1 基线完全一致);
`check-arch` **15/15**;`--self-test` **7/7**(新增 AR12 反自证);`check-boundary` 11/11;
`check-contract` 10/10(反自证 12 例全过);`check-module` 123/123;`check-citations` 4/4;
`check-naming` 3 通过 / 0 失败 / 1 提示;`verify.sh --smoke` **14 步全绿**(300.9s)。
**⏭ 下一步 = M5(`sspf-lowcode-exec`)**:迁 `lowcode_{crud,ddl,check,seed}.rs`(2,674 行),
新 crate `crates/sspf-lowcode-exec`(依赖 sspf-lowcode + core + store + mcp)。
⚠️ M5 必须同步加 **AR13**(依赖白名单)+ 重跑全部 `--self-test`。
---
## 0-0. 2026-11-02 23:13 验证修复轮(官方前端 + dacli 真跑后修的)
用官方 vue 前端 + dacli + 586 条端点探针做过一轮真实系统性验证(报告:
@@ -1874,7 +1927,7 @@ xop run --secret GU=git_local_user --secret GP=git_local_pass -- bash -c '
**按包顺序**执行 + 幂等(`CREATE TABLE IF NOT EXISTS`)。
- 🔴 **`sspf-store` 的两处表数断言必须改成「不写死」**(`db.rs:1226,1233`)——
写死 52 是批次 9/10 各踩一次的坑,改成「base 表数写死 + 业务表数 ≥ N」或直接读 `ddl_tables()` 对账。
- 🔴 **`is_builtin_table`(`platform/compat/system.rs:5879`)取 `ddl_tables()`** ⇒ 业务包建的表会**自动变成内置表**
- 🔴 **`is_builtin_table`(`crates/sspf-compat-system/src/system.rs:5879`)取 `ddl_tables()`** ⇒ 业务包建的表会**自动变成内置表**
⇒ 数据建模页**看不到**用户自己建的表了。这条要**重新想**(本批至少要保证行为不回退)。
- 🔴 `main.rs::whitelist_self_check` 的**双向对账**(孤儿 DDL / 漏建表)要改成
「DDL = base 表 + **所有包**的表」,否则包表会被判成孤儿 DDL ⇒ 启动失败。
+34
View File
@@ -0,0 +1,34 @@
[package]
name = "sspf-compat-ext"
version.workspace = true
edition.workspace = true
rust-version.workspace = true
# 🔴 **契约面「ext」域**(M4 起从 `src/backend/src/platform/compat/` 下沉到这里)。
#
# 装什么:扩展与协作域(官方 `api/extend/**` + `api/aiCenter/**` + `api/teamwork/**` + 移动端):扩展属性 + AI 中心 + 团队协作
#
# 🔴 **依赖纪律**:
# - 允许:契约面底座(`sspf-compat-core`)+ 平台核心(`sspf-core`)+ 契约层 + axum/serde。
# - 禁止:**业务包**(`sspf_pack_*`)—— 契约面不许认识任何业务。
# - 禁止:**其它契约面包** —— 各包彼此独立(AR12),唯一的例外见下方依赖段。
[dependencies]
# 契约面公共底座(判别头 / 守卫 / 分页信封 / 通用单表资源引擎)
sspf-compat-core = { path = "../sspf-compat-core" }
# 平台核心(auth / 权限 / CRUD / 信封 / 会话 / AppState)
sspf-core = { path = "../sspf-core" }
# 契约层(判别头 / 码表)
sspf-contract = { path = "../sspf-contract" }
# 时间戳(审计时间 / 消息过期时间)
chrono = { workspace = true }
# 🔴 **单向依赖**(不是环):移动端复用系统域的 `home_data`(控制台卡片数据源)
# 与消息域的 `send_config_select_list`(消息配置下拉)。
# 🔴 `sspf-compat-system` / `sspf-compat-msg` 都**不依赖**本包 ⇒ 方向单一,不会成环。
sspf-compat-system = { path = "../sspf-compat-system" }
sspf-compat-msg = { path = "../sspf-compat-msg" }
axum = { workspace = true }
serde = { workspace = true }
serde_json = { workspace = true }
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
+19
View File
@@ -0,0 +1,19 @@
//! # sspf-compat-ext —— 契约面「ext」域
//!
//! 扩展与协作域(官方 `api/extend/**` + `api/aiCenter/**` + `api/teamwork/**` + 移动端):扩展属性 + AI 中心 + 团队协作
//!
//! M4 起从 `src/backend/src/platform/compat/` 下沉到这里
//! (见 `docs/CRATES-MIGRATION.md` §4 M4)。
//!
//! 🔴 **依赖纪律(AR12)**:契约面各包**彼此独立** —— 本包**只**依赖
//! `sspf-compat-core`(底座)+ `sspf-core`(平台核心)+ `sspf-contract`(契约层)。
//! 禁止依赖其它 `sspf-compat-*` 包(唯一的单向例外已在 Cargo.toml 里注明白名单)。
//!
//! 🔴 **`src/backend/src/platform/compat/<模块>.rs` 只是转发壳**
//! (`pub use sspf_compat_ext::<模块>::*;`)⇒ 路由注册 `compat::<模块>::<handler>`
//! **不用改**(M7 删壳时才统一改 import)。
pub mod extend;
pub mod teamwork;
pub mod ai;
pub mod mobile;
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
+28
View File
@@ -0,0 +1,28 @@
[package]
name = "sspf-compat-msg"
version.workspace = true
edition.workspace = true
rust-version.workspace = true
# 🔴 **契约面「msg」域**(M4 起从 `src/backend/src/platform/compat/` 下沉到这里)。
#
# 装什么:消息域(官方 `api/message/**` + `api/msgCenter/**`):站内信 / 公告 / 消息模板
#
# 🔴 **依赖纪律**:
# - 允许:契约面底座(`sspf-compat-core`)+ 平台核心(`sspf-core`)+ 契约层 + axum/serde。
# - 禁止:**业务包**(`sspf_pack_*`)—— 契约面不许认识任何业务。
# - 禁止:**其它契约面包** —— 各包彼此独立(AR12),唯一的例外见下方依赖段。
[dependencies]
# 契约面公共底座(判别头 / 守卫 / 分页信封 / 通用单表资源引擎)
sspf-compat-core = { path = "../sspf-compat-core" }
# 平台核心(auth / 权限 / CRUD / 信封 / 会话 / AppState)
sspf-core = { path = "../sspf-core" }
# 契约层(判别头 / 码表)
sspf-contract = { path = "../sspf-contract" }
# 时间戳(审计时间 / 消息过期时间)
chrono = { workspace = true }
axum = { workspace = true }
serde = { workspace = true }
serde_json = { workspace = true }
+17
View File
@@ -0,0 +1,17 @@
//! # sspf-compat-msg —— 契约面「msg」域
//!
//! 消息域(官方 `api/message/**` + `api/msgCenter/**`):站内信 / 公告 / 消息模板
//!
//! M4 起从 `src/backend/src/platform/compat/` 下沉到这里
//! (见 `docs/CRATES-MIGRATION.md` §4 M4)。
//!
//! 🔴 **依赖纪律(AR12)**:契约面各包**彼此独立** —— 本包**只**依赖
//! `sspf-compat-core`(底座)+ `sspf-core`(平台核心)+ `sspf-contract`(契约层)。
//! 禁止依赖其它 `sspf-compat-*` 包(唯一的单向例外已在 Cargo.toml 里注明白名单)。
//!
//! 🔴 **`src/backend/src/platform/compat/<模块>.rs` 只是转发壳**
//! (`pub use sspf_compat_msg::<模块>::*;`)⇒ 路由注册 `compat::<模块>::<handler>`
//! **不用改**(M7 删壳时才统一改 import)。
pub mod message;
pub mod msg_center;
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
+25
View File
@@ -0,0 +1,25 @@
[package]
name = "sspf-compat-online_dev"
version.workspace = true
edition.workspace = true
rust-version.workspace = true
# 🔴 **契约面「online-dev」域**(M4 起从 `src/backend/src/platform/compat/` 下沉到这里)。
#
# 装什么:在线开发域(官方 `api/onlineDev/**`):在线表单设计器 / 报表配置
#
# 🔴 **依赖纪律**:
# - 允许:契约面底座(`sspf-compat-core`)+ 平台核心(`sspf-core`)+ 契约层 + axum/serde。
# - 禁止:**业务包**(`sspf_pack_*`)—— 契约面不许认识任何业务。
# - 禁止:**其它契约面包** —— 各包彼此独立(AR12),唯一的例外见下方依赖段。
[dependencies]
# 契约面公共底座(判别头 / 守卫 / 分页信封 / 通用单表资源引擎)
sspf-compat-core = { path = "../sspf-compat-core" }
# 平台核心(auth / 权限 / CRUD / 信封 / 会话 / AppState)
sspf-core = { path = "../sspf-core" }
# 契约层(判别头 / 码表)
sspf-contract = { path = "../sspf-contract" }
axum = { workspace = true }
serde = { workspace = true }
serde_json = { workspace = true }
+16
View File
@@ -0,0 +1,16 @@
//! # sspf-compat-online_dev —— 契约面「online-dev」域
//!
//! 在线开发域(官方 `api/onlineDev/**`):在线表单设计器 / 报表配置
//!
//! M4 起从 `src/backend/src/platform/compat/` 下沉到这里
//! (见 `docs/CRATES-MIGRATION.md` §4 M4)。
//!
//! 🔴 **依赖纪律(AR12)**:契约面各包**彼此独立** —— 本包**只**依赖
//! `sspf-compat-core`(底座)+ `sspf-core`(平台核心)+ `sspf-contract`(契约层)。
//! 禁止依赖其它 `sspf-compat-*` 包(唯一的单向例外已在 Cargo.toml 里注明白名单)。
//!
//! 🔴 **`src/backend/src/platform/compat/<模块>.rs` 只是转发壳**
//! (`pub use sspf_compat_online-dev::<模块>::*;`)⇒ 路由注册 `compat::<模块>::<handler>`
//! **不用改**(M7 删壳时才统一改 import)。
pub mod online_dev;
File diff suppressed because it is too large. Load diff
+37
View File
@@ -0,0 +1,37 @@
[package]
name = "sspf-compat-permission"
version.workspace = true
edition.workspace = true
rust-version.workspace = true
# 🔴 **契约面「permission」域**(M4 起从 `src/backend/src/platform/compat/` 下沉到这里)。
#
# 装什么:权限域(官方 `api/permission/**`):权限四源合并 + 管理员短路 + 菜单树 + 角色/岗位/组织/动作
#
# 🔴 **依赖纪律**:
# - 允许:契约面底座(`sspf-compat-core`)+ 平台核心(`sspf-core`)+ 契约层 + axum/serde。
# - 禁止:**业务包**(`sspf_pack_*`)—— 契约面不许认识任何业务。
# - 禁止:**其它契约面包** —— 各包彼此独立(AR12),唯一的例外见下方依赖段。
# 🔴 **唯一例外**:本包单向依赖 `sspf-compat-system`(见下方依赖段)——
# `system` 不依赖本包 ⇒ 无环。
[dependencies]
# 契约面公共底座(判别头 / 守卫 / 分页信封 / 通用单表资源引擎)
sspf-compat-core = { path = "../sspf-compat-core" }
# 平台核心(auth / 权限 / CRUD / 信封 / 会话 / AppState)
sspf-core = { path = "../sspf-core" }
# 契约层(判别头 / 码表)
sspf-contract = { path = "../sspf-contract" }
# 🔴 **单向依赖**(不是环):本包用 `sspf-compat-system` 的 4 个符号
# (`SYSTEM_LIST_PROJECTION` / `load_system_tops` / `log_page` / `shape_system_list_item`)。
# 🔴 `sspf-compat-system` **不依赖**本包 ⇒ 方向单一,不会成环(AR12 允许这条白名单)。
sspf-compat-system = { path = "../sspf-compat-system" }
# 存储层(ddl_tables / Db)—— 契约面要读 DDL 真源
sspf-store = { path = "../sspf-store" }
# 时间戳(审计时间 / 消息过期时间)
chrono = { workspace = true }
axum = { workspace = true }
serde = { workspace = true }
serde_json = { workspace = true }
+16
View File
@@ -0,0 +1,16 @@
//! # sspf-compat-permission —— 契约面「permission」域
//!
//! 权限域(官方 `api/permission/**`):权限四源合并 + 管理员短路 + 菜单树 + 角色/岗位/组织/动作
//!
//! M4 起从 `src/backend/src/platform/compat/` 下沉到这里
//! (见 `docs/CRATES-MIGRATION.md` §4 M4)。
//!
//! 🔴 **依赖纪律(AR12)**:契约面各包**彼此独立** —— 本包**只**依赖
//! `sspf-compat-core`(底座)+ `sspf-core`(平台核心)+ `sspf-contract`(契约层)。
//! 禁止依赖其它 `sspf-compat-*` 包(唯一的单向例外已在 Cargo.toml 里注明白名单)。
//!
//! 🔴 **`src/backend/src/platform/compat/<模块>.rs` 只是转发壳**
//! (`pub use sspf_compat_permission::<模块>::*;`)⇒ 路由注册 `compat::<模块>::<handler>`
//! **不用改**(M7 删壳时才统一改 import)。
pub mod permission;
File diff suppressed because it is too large. Load diff
+30
View File
@@ -0,0 +1,30 @@
[package]
name = "sspf-compat-system"
version.workspace = true
edition.workspace = true
rust-version.workspace = true
# 🔴 **契约面「system」域**(M4 起从 `src/backend/src/platform/compat/` 下沉到这里)。
#
# 装什么:系统域(官方 `api/system/**` + `api/core/**`):用户/角色/组织/菜单/日志/在线用户/定时任务 + 登录与令牌
#
# 🔴 **依赖纪律**:
# - 允许:契约面底座(`sspf-compat-core`)+ 平台核心(`sspf-core`)+ 契约层 + axum/serde。
# - 禁止:**业务包**(`sspf_pack_*`)—— 契约面不许认识任何业务。
# - 禁止:**其它契约面包** —— 各包彼此独立(AR12),唯一的例外见下方依赖段。
[dependencies]
# 契约面公共底座(判别头 / 守卫 / 分页信封 / 通用单表资源引擎)
sspf-compat-core = { path = "../sspf-compat-core" }
# 平台核心(auth / 权限 / CRUD / 信封 / 会话 / AppState)
sspf-core = { path = "../sspf-core" }
# 契约层(判别头 / 码表)
sspf-contract = { path = "../sspf-contract" }
# 存储层(ddl_tables / Db)—— 契约面要读 DDL 真源
sspf-store = { path = "../sspf-store" }
# 时间戳(审计时间 / 消息过期时间)
chrono = { workspace = true }
axum = { workspace = true }
serde = { workspace = true }
serde_json = { workspace = true }
+494
View File
@@ -0,0 +1,494 @@
//! core —— 官方面 B 的 **core** 端点集(`/api/oauth/*` / `/api/file/*` / `/api/system/Location/*`)。
//!
//! 🔴 官方前端 `src/api/core/**` 共 4 个文件(`auth` / `common` / `user` / `index`),
//! 对应的是**框架自带**能力(登录 / 票据 / 文件 / 地图),不是业务资源。
//!
//! 真源:官方 Java `jnpf-oauth` + `jnpf-file` + `jnpf-system`。
//!
//! 🔴 **本文件的端点分三类**(批次 18 逐条核对官方 Java + 官方前端后判定):
//! ① **真实现**(6 条):锁屏解锁、免密登录票据、扫码登录凭证 —— 本仓有落库/内存表可做;
//! ② **明确失败**(13 条):文件族(无文件存储)、地图族(无高德 key + 无 HTTP 客户端)、
//! 改密通知(无邮件/短信通道)⇒ `code=400` + 人话,**不返假 URL、不返假坐标**;
//! ③ **明确失败**(3 条):SaaS 多租户族 / 第三方登录 —— 本仓无多租户切换、无第三方配置。
use axum::body::Bytes;
use axum::extract::{Path, RawQuery, State};
use axum::http::HeaderMap;
use axum::Json;
use serde_json::{json, Value};
use sspf_core::cipher::decrypt_to_md5;
use sspf_core::envelope::{code, fail, ok, ActionResult};
use sspf_core::auth::require_login_face_b;
use sspf_core::session::{Ticket, TicketKind};
use sspf_core::state::AppState;
// ================================================================ 常量
/// 免密登录票据有效期(秒)—— 官方 `oauthConfig.getTicketTimeout()` 的默认值口径。
///
/// 🔴 官方值来自**系统配置**(`oauthConfig`)⇒ 本仓无该配置项 ⇒ 取一个
/// 合理默认值(官方同族配置的常见量级),并在响应里如实给出这个值。
const TICKET_TTL_SECONDS: i64 = 300;
/// 扫码登录凭证有效期(秒)—— 官方 `configValueUtil.getCodeCertificateTimeout()`。
const SCAN_CODE_TTL_SECONDS: i64 = 300;
/// 票据状态:**未登录**(官方 `LoginTicketStatus.UN_LOGIN`)。
const TICKET_STATUS_UN_LOGIN: i32 = 0;
/// 票据状态:**票据失效**(官方 `LoginTicketStatus.INVALID` / `ScanCodeTicketStatus.INVALID`)。
const TICKET_STATUS_INVALID: i32 = 1;
/// 「本极简引擎不支持 X」—— 能力缺失时的**诚实失败**。
///
/// 🔴 **绝不返假数据**:没有文件存储就不能返一个编出来的下载 URL;
/// 没有地图服务就不能返一组编出来的坐标。宁可 `code=400` 说清缺什么。
fn unsupported(what: &str) -> Json<ActionResult> {
fail(code::FAIL, format!("本极简引擎不支持{what}"))
}
// ================================================================ 退出登录
//
// 官方 `LoginController.java:155`(`@PostMapping("/Logout")`)。
/// `POST /api/oauth/Logout` —— 官方 `LoginController.java:155`。
///
/// 🔴 **未登录也返成功**:前端 `store/auth.ts:86` 把 `logoutApi()` 包在
/// `try { … } catch { /* 不做任何处理 */ }` 里,**返回值完全被忽略**;
/// 但它一旦是 **HTTP 404**,会走 `errorMessageResponseInterceptor` 弹一个红条。
/// ⇒ 这里恒 `ok(null)`,无论有没有 token。
///
/// 🔴 **不改变服务端会话状态**:本仓 token 是进程内内存表(`platform/session.rs`),
/// 没有 `revoke` 接口(接口 immutability 见 `SessionStore`)⇒ 登出即「客户端丢弃 token」,
/// 服务端不做失效登记。这是**已知限制 B5**(`docs/known-limitations.md`)。
pub async fn logout_handler(State(state): State<AppState>, headers: HeaderMap) -> Json<ActionResult> {
// 鉴权结果刻意丢弃:有 token ⇒ 走一遍换取无效的分支也已经够了(无 remove 接口)。
let _ = require_login_face_b(&state, &headers).await;
ok(Value::Null)
}
// ================================================================ 登录配置
//
// 官方 `LoginController.java`(`getLoginConfig` / `getConfig`)。
/// `GET /api/oauth/getLoginConfig` —— 登录页配置(**登录前**就拉 ⇒ 不能要 token)。
///
/// 🔴 前端 `views/_core/login/LoginForm.vue:160-163`:`res.data.redirect` ⇒ `data`
/// 必须是**对象**(给 `null` 会 `Cannot read properties of null`)。
pub async fn get_login_config() -> Json<ActionResult> {
ok(json!({}))
}
/// `GET /api/oauth/getConfig/{account}` —— 帐号的登录/锁屏配置(`user.ts:23`)。
pub async fn get_user_config(Path(account): Path<String>) -> Json<ActionResult> {
let _ = account.trim();
ok(json!({}))
}
// ================================================================ 锁屏解锁
//
// 官方 `LoginController.java:130`(`@PostMapping("/LockScreen")`)。
/// `POST /api/oauth/LockScreen` —— 锁屏解锁登录。
///
/// 官方 `LoginController.java:130-146`:
/// ```java
/// UserEntity userEntity = userApi.getUserByAccount(loginForm.getAccount());
/// if (userEntity == null) { …登出… throw new LoginException(MsgCode.FA001.get()); }
/// if (!EncryptUtil.encryptByMd5(loginForm.getPassword().toLowerCase() + userEntity.getSecretkey().toLowerCase())
/// .equals(userEntity.getPassword())) { throw new LoginException(MsgCode.OA020.get()); }
/// return ActionResult.success(MsgCode.SU005.get());
/// ```
///
/// 🔴 **本仓口令存储口径不同**:官方存 `md5(明文 + secretkey)`;本仓存
/// `md5(明文)`(`platform/auth.rs` 的 `decrypt_to_md5` ⇒ 比对 `f_password`)。
/// ⇒ 这里按**本仓口径**做等价校验:把前端传来的密文解成 `md5(明文)` 再比
/// `f_password`。与 `permission.rs` 的 `self_modify_password` 同一口径。
///
/// 🔴 **口令错 ⇒ 账号或密码错误**(不区分「账号不存在」与「口令错」——
/// 官方也分两种码,但前端只弹一句;本仓统一给一句,避免账号枚举)。
pub async fn lock_screen(
State(state): State<AppState>,
body: Bytes,
) -> Json<ActionResult> {
let obj = match sspf_compat_core::helper::parse_body(&body) {
Ok(Value::Object(o)) => o,
Ok(_) => return fail(code::FAIL, "请求参数格式错误"),
Err(resp) => return resp,
};
let account = obj
.get("account")
.and_then(Value::as_str)
.unwrap_or_default()
.trim()
.to_string();
let encrypted = obj.get("password").and_then(Value::as_str).unwrap_or_default();
if account.is_empty() || encrypted.is_empty() {
return fail(code::FAIL, "缺少 account / password");
}
let rows = match state
.db
.query_json_params(
"SELECT f_id AS \"id\", COALESCE(f_password, '') AS \"storedPassword\" \
FROM base_user WHERE f_account = $1::text AND f_delete_mark = 0 LIMIT 1",
&[&account],
)
.await
{
Ok(rows) => rows,
Err(e) => return sspf_compat_core::helper::db_error(e, "锁屏解锁查询用户"),
};
let Some(row) = rows.first() else {
return fail(code::FAIL, "账号或密码错误");
};
let stored = row
.get("storedPassword")
.and_then(Value::as_str)
.unwrap_or_default();
let plain_md5 = match decrypt_to_md5(encrypted) {
Some(md5) => md5,
None => return fail(code::FAIL, "账号或密码错误"),
};
if stored.is_empty() || !stored.eq_ignore_ascii_case(&plain_md5) {
return fail(code::FAIL, "账号或密码错误");
}
ok(Value::Null)
}
// ================================================================ 免密登录票据
//
// 官方 `LoginController.java:383`(`getTicket`)/ `:398`(`getTicketStatus`)。
/// `GET /api/oauth/getTicket` —— 获取登录票据。
///
/// 官方 `LoginController.java:383-390`:
/// ```java
/// LoginTicketModel ticketModel = new LoginTicketModel();
/// ticketModel.setTicketTimeout(System.currentTimeMillis() + oauthConfig.getTicketTimeout() * 1000);
/// String ticket = TicketUtil.createTicket(ticketModel, oauthConfig.getTicketTimeout());
/// return ActionResult.success(ticketModel.getTicketTimeout().toString(), ticket);
/// ```
///
/// 🔴 **官方 `ActionResult.success(msg, data)` 是两参版**:第一参是 `msg`、
/// 第二参是 `data` ⇒ 本仓必须**照抄这个错位**:有效期进 `msg`、票据进 `data`。
/// (本仓 `envelope::ok(data)` 恒 `msg="成功"` ⇒ 这里得自己造信封。)
///
/// 🔴 官方票据存 Redis ⇒ 本仓**无 Redis** ⇒ 用进程内内存表
/// (`platform/session.rs` 的 `TicketStore`),进程重启即失效。
pub async fn get_ticket(State(state): State<AppState>) -> Json<ActionResult> {
let (ticket, expires_at_ms) = state
.tickets
.issue(TicketKind::Login, TICKET_STATUS_UN_LOGIN, TICKET_TTL_SECONDS);
// 🔴 官方把 `ticketTimeout`(**毫秒时间戳**,不是剩余秒数)放进 `msg`。
Json(ActionResult {
code: code::SUCCESS,
msg: expires_at_ms.to_string(),
data: Value::String(ticket),
})
}
/// `GET /api/oauth/getTicketStatus/{ticket}` —— 查询票据登录状态。
///
/// 官方 `LoginController.java:398-412`:票据解析不出来 ⇒ 返回一张
/// `status = INVALID` 的空模型;能解析出来 ⇒ 返回票据本身。
///
/// 🔴 官方 `LoginTicketModel` 字段:`status` / `value` / `theme` / `ticketTimeout`。
pub async fn get_ticket_status(
State(state): State<AppState>,
Path(ticket): Path<String>,
) -> Json<ActionResult> {
let ticket = ticket.trim().to_string();
let found = state.tickets.get(TicketKind::Login, &ticket);
ok(ticket_value(found))
}
/// 把票据摊成官方 `LoginTicketModel` 的形状。
///
/// 🔴 官方 `LoginTicketModel` 只有 4 个字段(`status`/`value`/`theme`/`ticketTimeout`)
/// ⇒ **不要**多给字段(前端按 `ticketTimeout` 判断过期,多给反而会误导)。
fn ticket_value(found: Option<Ticket>) -> Value {
match found {
Some(t) => json!({
"status": t.status,
"value": t.value,
"theme": t.theme,
"ticketTimeout": t.expires_at_ms,
}),
None => json!({
"status": TICKET_STATUS_INVALID,
"value": "票据失效!",
"theme": "",
"ticketTimeout": 0,
}),
}
}
// ================================================================ 扫码登录凭证
//
// 官方 `LoginController.java:454`(`codeCertificate`)/ `:468`(`codeCertificateStatus`)
// / `:507`(`setCodeCertificateStatus`)。
/// `GET /api/oauth/codeCertificate` —— 生成扫码凭证。
///
/// 官方 `LoginController.java:454-462`:与 `getTicket` 同构 ——
/// `ActionResult.success(超时毫秒串, 凭证串)` ⇒ 同样是 **`msg`=超时、`data`=凭证**。
pub async fn code_certificate(State(state): State<AppState>) -> Json<ActionResult> {
let (ticket, expires_at_ms) = state
.tickets
.issue(TicketKind::ScanCode, TICKET_STATUS_UN_LOGIN, SCAN_CODE_TTL_SECONDS);
Json(ActionResult {
code: code::SUCCESS,
msg: expires_at_ms.to_string(),
data: Value::String(ticket),
})
}
/// `GET /api/oauth/codeCertificateStatus/{ticket}` —— 获取扫码凭证状态。
///
/// 官方 `LoginController.java:468-475`:解析不出来 ⇒ `status = INVALID`。
pub async fn code_certificate_status(
State(state): State<AppState>,
Path(ticket): Path<String>,
) -> Json<ActionResult> {
let ticket = ticket.trim().to_string();
let found = state.tickets.get(TicketKind::ScanCode, &ticket);
ok(ticket_value(found))
}
/// `GET /api/oauth/setCodeCertificateStatus/{ticket}/{status}` —— 更改扫码凭证状态。
///
/// 官方 `LoginController.java:507-519`:改状态 ⇒ 顺带把过期时间**续**上,
/// 然后回吐整张凭证模型。
///
/// 🔴 `status` 是路径上的**整数**(官方 `Integer status`)⇒ 解析失败 ⇒ `code=400`。
pub async fn set_code_certificate_status(
State(state): State<AppState>,
Path((ticket, status)): Path<(String, String)>,
) -> Json<ActionResult> {
let ticket = ticket.trim().to_string();
let status: i32 = match status.trim().parse() {
Ok(v) => v,
Err(_) => return fail(code::FAIL, "扫码凭证状态必须是整数"),
};
let updated = state
.tickets
.update(TicketKind::ScanCode, &ticket, status, "", SCAN_CODE_TTL_SECONDS);
match updated {
Some(t) => ok(ticket_value(Some(t))),
// 🔴 凭证不存在 ⇒ 官方造一张 `INVALID` 的空模型回吐(不报错)。
None => ok(ticket_value(None)),
}
}
// ================================================================ 改密通知
//
// 官方 `LoginController.java:269`(`updatePasswordMessage`)。
/// `POST /api/oauth/updatePasswordMessage` —— 修改密码信息发送。
///
/// 官方 `LoginController.java:269-273`:调 `loginService.updatePasswordMessage()`
/// ⇒ 走**邮件 / 短信**通道把「您的密码即将过期」发给用户。
///
/// 🔴 本仓**无邮件服务、无短信通道** ⇒ 没有提醒可发。
/// 🔴 **但不能返 400**:官方前端 `layouts/header/index.vue:74` 在**每个页面挂载时
/// 无条件调用且没有 catch** ⇒ `code=400` 会变成一条未捕获 Promise 异常。
/// ⇒ 返回 `200 + data:null`,并在 `msg` 里说清「已跳过」,不假装发过。
pub async fn update_password_message() -> Json<ActionResult> {
Json(ActionResult {
code: code::SUCCESS,
msg: "本极简引擎无邮件 / 短信通道,已跳过改密提醒".to_string(),
data: Value::Null,
})
}
// ================================================================ SaaS 多租户
//
// 官方 `LoginController.java:554`(`Login/saas`)/ `:562`(`apply/saas`)
// / `:571`(`mobilecode/saas`)。
/// `POST /api/oauth/Login/saas` —— 多租户登录。
///
/// 官方 `LoginController.java:554-559`:`grant_type=saas` ⇒ 切租户后登录
/// (`TenantSaasGranter.granter` → `checkTenantUser` → `switchTenant`)。
///
/// 🔴 官方 `TenantSaasGranter.checkTenantUser` **要求已有登录态**:
/// `UserProvider.getUser(UserProvider.getAuthorize())` 的 `userId` 为空
/// ⇒ 直接抛 `LoginException(GT105)` ⇒ **这就是「拿主租户身份换关联租户」**。
/// ⇒ 本仓也**必须真的拦**(不能像 `Logout` 那样丢弃 `Err`)。
///
/// 🔴 本仓**无多租户数据源切换**(`base_*` 表只有 `f_tenant_id` 一列,
/// 没有按租户切库的能力)⇒ 过了守卫也**明确失败**。
pub async fn login_saas(State(state): State<AppState>, headers: HeaderMap) -> Json<ActionResult> {
if let Err(resp) = require_login_face_b(&state, &headers).await {
return resp;
}
unsupported("SaaS 多租户登录(没有多租户数据源切换)")
}
/// `GET /api/oauth/mobilecode/saas` —— 租户申请短信验证码。
///
/// 官方 `LoginController.java:571-575`:走**短信通道**。
///
/// 🔴 本仓**无短信通道** ⇒ 如实失败。
pub async fn mobile_code_saas() -> Json<ActionResult> {
unsupported("租户申请短信验证码(没有短信通道)")
}
/// `POST /api/oauth/apply/saas` —— 企业申请接口。
///
/// 官方 `LoginController.java:562-568`:调 `LoginSaasUtil.saasApply(...)`
/// ⇒ 走**外部 SaaS 平台**。
///
/// 🔴 本仓无该外部平台 ⇒ 如实失败。
pub async fn apply_saas() -> Json<ActionResult> {
unsupported("企业申请(没有接入官方 SaaS 平台)")
}
/// `POST /api/oauth/Login/socials` —— 第三方登录回调后点登录。
///
/// 官方走 `LoginController.java:117` 的 `@RequestMapping("/Login/**")` 通配,
/// 由 `SocialsTokenGranter`(`grant_type=socials`)按 `code`/`state`/`source`
/// 去换第三方 token。
///
/// 🔴 本仓**无第三方登录配置**(没有 `base_socials` 之类的第三方账号表)
/// ⇒ 如实失败。
pub async fn socials_login() -> Json<ActionResult> {
unsupported("第三方登录(没有第三方账号配置)")
}
// ================================================================ 文件族
//
// 官方 `jnpf-file` 的 `UtilsController`(`@RequestMapping("/api/file")`):
// `:200` Download/{type}/{fileName} / `:100` PackDownload/{type}
// / `:172` Uploader/{type} / `:295` merge。
//
// 🔴 本仓**无文件存储层**(磁盘 / 对象存储都没有)⇒ 全部如实失败。
/// `GET /api/file/Download/{type}/{fileName}` —— 获取下载文件链接。
///
/// 官方 `UtilsController.java:200-215`:查文件是否存在 ⇒ 存在就返
/// `{name, url}`(`DownloadVO`),不存在就 `fail`。
///
/// 🔴 本仓无文件存储 ⇒ 如实失败(**不返假 URL**)。
pub async fn file_download(
Path((file_type, file_name)): Path<(String, String)>,
) -> Json<ActionResult> {
let _ = (file_type.trim(), file_name.trim());
unsupported("文件下载(没有文件存储)")
}
/// `POST /api/file/PackDownload/{type}` —— 打包下载链接。
///
/// 官方 `UtilsController.java:100-130`:把一批文件打成 zip ⇒ 返 zip 的 id。
///
/// 🔴 本仓无文件存储 ⇒ 如实失败。
pub async fn file_pack_download(Path(file_type): Path<String>) -> Json<ActionResult> {
let _ = file_type.trim();
unsupported("打包下载(没有文件存储)")
}
/// `GET /api/file/Uploader/Preview` —— 预览文件。
///
/// 🔴 **官方 Java 里没有这个端点**(`UtilsController` 只有 `/Uploader/{type}` 与
/// `/Uploader/imgToBase64`)⇒ 官方前端 `api/core/common.ts:21` 声明了但
/// 后端从没有过 ⇒ 记 `oos`。本仓照样给出**明确失败**而不是 404
/// (404 会让官方前端的 `errorMessageResponseInterceptor` 弹红条)。
pub async fn file_uploader_preview() -> Json<ActionResult> {
unsupported("文件预览(没有文件存储)")
}
/// `POST /api/file/merge` —— 分片组装。
///
/// 官方 `UtilsController.java:295-298`:把分片合成一个文件。
///
/// 🔴 本仓无文件存储 ⇒ 如实失败。
pub async fn file_merge() -> Json<ActionResult> {
unsupported("分片组装(没有文件存储)")
}
/// `GET /api/{prefix}/TemplateDownload` —— 下载导入示例模板。
///
/// 官方前端 `api/core/common.ts:29` 用 `/api/${url}/TemplateDownload` 拼地址
/// ⇒ `url` 是**模块名**(`system` / `permission` / `onlineDev` …)。
/// 官方各 Controller 各自有一份(`BaseLangController.java:142`、
/// `VisualdevModelDataController.java:944`、`EmployeeController.java:208` …)。
///
/// 🔴 本仓**没有导入模板文件** ⇒ 如实失败。
pub async fn template_download(Path(prefix): Path<String>) -> Json<ActionResult> {
let _ = prefix.trim();
unsupported("导入示例模板下载(没有模板文件)")
}
/// `GET /api/{prefix}/ImportPreview` —— 导入预览。
///
/// 官方前端 `api/core/common.ts:33`;官方各模块 Controller 各自有一份
/// (`VisualdevModelDataController.java:1000`、`EmployeeController.java:382`、
/// `OrganizeController.java:464` …)。
///
/// 🔴 本仓无导入预览能力 ⇒ 如实失败。
pub async fn import_preview(Path(prefix): Path<String>) -> Json<ActionResult> {
let _ = prefix.trim();
unsupported("导入预览(没有导入引擎)")
}
/// `POST /api/{prefix}/ImportData` —— 导入数据。
///
/// 官方前端 `api/core/common.ts:37`;官方各模块 Controller 各自有一份
/// (`VisualdevModelDataController.java:733`、`BaseLangController.java:182` …)。
///
/// 🔴 本仓无导入引擎 ⇒ 如实失败。
pub async fn import_data(Path(prefix): Path<String>) -> Json<ActionResult> {
let _ = prefix.trim();
unsupported("导入数据(没有导入引擎)")
}
/// `POST /api/{prefix}/ImportExceptionData` —— 导入异常数据。
///
/// 官方前端 `api/core/common.ts:41`;官方 `VisualdevModelDataController.java:1073`。
///
/// 🔴 本仓无导入引擎 ⇒ 如实失败。
pub async fn import_exception_data(Path(prefix): Path<String>) -> Json<ActionResult> {
let _ = prefix.trim();
unsupported("导入异常数据(没有导入引擎)")
}
// ================================================================ 地图族
//
// 官方 `jnpf-system` 的 `LocationController`(`@RequestMapping("/api/system/Location")`):
// `:32` around / `:47` text / `:62` inputtips —— 三个都是**转发高德 REST API**
// (`https://restapi.amap.com/v3/...`)。
//
// 🔴 本仓**没有高德 key**,而且**没有 HTTP 客户端依赖**(`Cargo.toml` 里无
// `reqwest` / `ureq`)⇒ 转发不了 ⇒ 如实失败(**不返编出来的坐标**)。
/// `GET /api/system/Location/around` —— 查询附近数据。
///
/// 官方 `LocationController.java:32-45`:转发高德 `place/around`。
///
/// 🔴 本仓无地图服务 ⇒ 如实失败。
pub async fn location_around(raw: RawQuery) -> Json<ActionResult> {
let _ = &raw;
unsupported("附近地点查询(没有地图服务)")
}
/// `GET /api/system/Location/text` —— 按关键字查询附近数据。
///
/// 官方 `LocationController.java:47-60`:转发高德 `place/text`。
///
/// 🔴 本仓无地图服务 ⇒ 如实失败。
pub async fn location_text(raw: RawQuery) -> Json<ActionResult> {
let _ = &raw;
unsupported("地点关键字查询(没有地图服务)")
}
/// `GET /api/system/Location/inputtips` —— 输入提示。
///
/// 官方 `LocationController.java:62-75`:转发高德 `assistant/inputtips`。
///
/// 🔴 本仓无地图服务 ⇒ 如实失败。
pub async fn location_input_tips(raw: RawQuery) -> Json<ActionResult> {
let _ = &raw;
unsupported("地点输入提示(没有地图服务)")
}
+18
View File
@@ -0,0 +1,18 @@
//! # sspf-compat-system —— 契约面「system」域
//!
//! 系统域(官方 `api/system/**` + `api/core/**`):用户/角色/组织/菜单/日志/在线用户/定时任务 + 登录与令牌
//!
//! M4 起从 `src/backend/src/platform/compat/` 下沉到这里
//! (见 `docs/CRATES-MIGRATION.md` §4 M4)。
//!
//! 🔴 **依赖纪律(AR12)**:契约面各包**彼此独立** —— 本包**只**依赖
//! `sspf-compat-core`(底座)+ `sspf-core`(平台核心)+ `sspf-contract`(契约层)。
//! 禁止依赖其它 `sspf-compat-*` 包(唯一的单向例外已在 Cargo.toml 里注明白名单)。
//!
//! 🔴 **`src/backend/src/platform/compat/<模块>.rs` 只是转发壳**
//! (`pub use sspf_compat_system::<模块>::*;`)⇒ 路由注册 `compat::<模块>::<handler>`
//! **不用改**(M7 删壳时才统一改 import)。
pub mod system;
pub mod scheduletask;
pub mod core;
@@ -0,0 +1,427 @@
//! scheduletask —— 官方面 B 的 **scheduletask** 端点集(`/api/scheduletask/*`)。
//!
//! 真源:官方 Java `jnpf-scheduletask` + 官方前端 `src/api/system/task.ts`。
use axum::body::Bytes;
use axum::extract::{Path, RawQuery, State};
use axum::http::HeaderMap;
use axum::Json;
use serde_json::{json, Map, Value};
use sspf_core::envelope::{code, fail, ok, ActionResult};
use sspf_core::ids::new_uuid;
use sspf_core::state::AppState;
use sspf_compat_core::helper::{Paging, db_error, guard, int_field, page_list, params_of, parse_body, text_field};
/// 官方 `@SaCheckPermission("sysService.task")`(任务调度)。
const EN_TASK: &str = "sysService.task";
/// 任务列表投影。
const TASK_LIST_PROJECTION: &str = "f_id AS \"id\", f_full_name AS \"fullName\", \
COALESCE(f_en_code, '') AS \"enCode\", COALESCE(f_execute_type, 1)::bigint AS \"executeType\", \
COALESCE(f_run_count, 0)::bigint AS \"runCount\", \
COALESCE(f_enabled_mark, 0)::bigint AS \"enabledMark\", \
COALESCE(f_sort_code, 0)::bigint AS \"sortCode\", f_description AS \"description\", \
(EXTRACT(EPOCH FROM f_last_run_time) * 1000)::bigint AS \"lastRunTime\", \
(EXTRACT(EPOCH FROM f_next_run_time) * 1000)::bigint AS \"nextRunTime\", \
COALESCE(f_execute_content, '') AS \"executeContentRaw\"";
/// `f_execute_content` 是 TEXT,内容约定是 JSON 对象(官方前端提交的就是对象)。
///
/// 解析不出来时**不丢数据**:包成 `{"cron": <原文>}`,至少还能回显。
fn exec_content_object(raw: &str) -> Map<String, Value> {
let text = raw.trim();
if text.is_empty() {
return Map::new();
}
match serde_json::from_str::<Value>(text) {
Ok(Value::Object(obj)) => obj,
Ok(other) => {
let mut obj = Map::new();
obj.insert("cron".to_string(), other);
obj
}
Err(_) => {
let mut obj = Map::new();
obj.insert("cron".to_string(), json!(text));
obj
}
}
}
/// 把一行任务摊平成列表项:`executeContent` 里的 `startTime` / `endTime` **提到顶层**。
///
/// 🔴 官方列表的 `startTime` / `endTime` 来自 XXL-JOB 的调度配置;本仓登记在
/// `executeContent` 里 ⇒ 必须提出来,否则前端那一列表头永远是空的。
fn shape_task_row(mut row: Value) -> Value {
let Some(obj) = row.as_object_mut() else {
return row;
};
let raw = obj
.remove("executeContentRaw")
.and_then(|v| v.as_str().map(str::to_string))
.unwrap_or_default();
let content = exec_content_object(&raw);
let start = content.get("startTime").cloned().unwrap_or(Value::Null);
let end = content.get("endTime").cloned().unwrap_or(Value::Null);
obj.insert("startTime".to_string(), start);
obj.insert("endTime".to_string(), end);
obj.insert("executeContent".to_string(), Value::Object(content));
row
}
/// `GET /api/scheduletask` —— 任务列表(分页 + 关键词)。
pub async fn task_list(
State(state): State<AppState>,
headers: HeaderMap,
raw: RawQuery,
) -> Json<ActionResult> {
if let Err(resp) = guard(&state, &headers, EN_TASK).await {
return resp;
}
let page = Paging::of(&raw);
let keyword = sspf_core::sys::query_param(&raw, "keyword")
.trim()
.to_string();
let mut conds = vec!["COALESCE(f_delete_mark, 0) = 0".to_string()];
let mut values: Vec<Option<String>> = Vec::new();
if !keyword.is_empty() {
values.push(Some(format!("%{keyword}%")));
let n = values.len();
conds.push(format!(
"(f_full_name ILIKE ${n}::text OR f_en_code ILIKE ${n}::text)"
));
}
let where_sql = conds.join(" AND ");
let total_sql = format!("SELECT COUNT(*)::bigint AS \"total\" FROM base_time_task WHERE {where_sql}");
let total = match state
.db
.query_json_params(&total_sql, &params_of(&values))
.await
{
Ok(rows) => rows
.first()
.and_then(|r| r.get("total"))
.and_then(Value::as_i64)
.unwrap_or(0),
Err(e) => return db_error(e, "任务计数"),
};
values.push(Some(page.page_size.to_string()));
let limit_at = values.len();
values.push(Some(page.offset.to_string()));
let offset_at = values.len();
let sql = format!(
"SELECT {TASK_LIST_PROJECTION} FROM base_time_task WHERE {where_sql} \
ORDER BY COALESCE(f_sort_code, 0) ASC, f_creator_time DESC NULLS LAST \
LIMIT ${limit_at}::text::integer OFFSET ${offset_at}::text::integer"
);
let rows = match state.db.query_json_params(&sql, &params_of(&values)).await {
Ok(rows) => rows,
Err(e) => return db_error(e, "任务列表查询"),
};
let list: Vec<Value> = rows.into_iter().map(shape_task_row).collect();
ok(page_list(page.current_page, page.page_size, total, list))
}
/// `GET /api/scheduletask/Info/{id}` —— 任务详情(`executeContent` 是**对象**)。
pub async fn task_info(
State(state): State<AppState>,
headers: HeaderMap,
Path(id): Path<String>,
) -> Json<ActionResult> {
if let Err(resp) = guard(&state, &headers, EN_TASK).await {
return resp;
}
let rows = match state
.db
.query_json_params(
&format!(
"SELECT {TASK_LIST_PROJECTION} FROM base_time_task \
WHERE f_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1"
),
&[&id.trim()],
)
.await
{
Ok(rows) => rows,
Err(e) => return db_error(e, "任务详情查询"),
};
let Some(row) = rows.into_iter().next() else {
return fail(code::FAIL, "任务不存在");
};
ok(shape_task_row(row))
}
/// `GET /api/scheduletask/TaskMethods` —— 本地任务方法清单。
///
/// 🔴 **官方这份清单来自 XXL-JOB 的执行器注册表**(`restScheduleTaskUtil.getHandlerList`),
/// 本仓没有执行器 ⇒ **空清单**。为什么不返 `fail`:任务表单的「方法选择」
/// 下拉要靠它,返错会让整个新建表单红条;空数组只是**选项为空**(如实)。
pub async fn task_methods(
State(state): State<AppState>,
headers: HeaderMap,
) -> Json<ActionResult> {
if let Err(resp) = guard(&state, &headers, EN_TASK).await {
return resp;
}
ok(json!({ "list": [] }))
}
/// `GET /api/scheduletask/{id}/TaskLog` —— 任务执行日志(分页)。
pub async fn task_log_list(
State(state): State<AppState>,
headers: HeaderMap,
Path(id): Path<String>,
raw: RawQuery,
) -> Json<ActionResult> {
if let Err(resp) = guard(&state, &headers, EN_TASK).await {
return resp;
}
let page = Paging::of(&raw);
let task_id = id.trim().to_string();
let total = match state
.db
.query_json_params(
"SELECT COUNT(*)::bigint AS \"total\" FROM base_time_task_log \
WHERE f_task_id = $1::text AND COALESCE(f_delete_mark, 0) = 0",
&[&task_id],
)
.await
{
Ok(rows) => rows
.first()
.and_then(|r| r.get("total"))
.and_then(Value::as_i64)
.unwrap_or(0),
Err(e) => return db_error(e, "任务日志计数"),
};
let size = page.page_size.to_string();
let offset = page.offset.to_string();
let rows = match state
.db
.query_json_params(
"SELECT f_id AS \"id\", f_task_id AS \"taskId\", \
(EXTRACT(EPOCH FROM f_run_time) * 1000)::bigint AS \"runTime\", \
COALESCE(f_run_result, 0)::bigint AS \"runResult\", \
f_description AS \"description\" \
FROM base_time_task_log \
WHERE f_task_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 \
ORDER BY f_run_time DESC NULLS LAST \
LIMIT $2::text::integer OFFSET $3::text::integer",
&[&task_id, &size, &offset],
)
.await
{
Ok(rows) => rows,
Err(e) => return db_error(e, "任务日志查询"),
};
ok(page_list(page.current_page, page.page_size, total, rows))
}
/// `POST /api/scheduletask` —— 新建任务(**登记**,不执行)。
pub async fn task_create(
State(state): State<AppState>,
headers: HeaderMap,
body: Bytes,
) -> Json<ActionResult> {
let user = match guard(&state, &headers, EN_TASK).await {
Ok(u) => u,
Err(resp) => return resp,
};
let obj = match parse_body(&body) {
Ok(Value::Object(o)) => o,
Ok(_) => return fail(code::FAIL, "请求参数格式错误"),
Err(resp) => return resp,
};
let Some(full_name) = text_field(&obj, "fullName") else {
return fail(code::FAIL, "任务名称不能为空");
};
let Some(en_code) = text_field(&obj, "enCode") else {
return fail(code::FAIL, "任务编码不能为空");
};
let dup = state
.db
.query_json_params(
"SELECT f_id AS \"id\" FROM base_time_task \
WHERE f_en_code = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1",
&[&en_code],
)
.await;
match dup {
Ok(rows) if !rows.is_empty() => return fail(code::FAIL, "任务编码已存在"),
Ok(_) => {}
Err(e) => return db_error(e, "任务编码查重"),
}
// `executeContent` 缺省也给 `{}`(官方 `@Valid` 要求 cron/startTime,但本仓不执行 ⇒ 不强制)
let content = match obj.get("executeContent") {
Some(Value::Object(o)) => Value::Object(o.clone()),
_ => json!({}),
};
let id = new_uuid();
let execute_type = int_field(&obj, "executeType").unwrap_or(1).to_string();
let enabled_mark = int_field(&obj, "enabledMark").unwrap_or(1).to_string();
let sort_code = int_field(&obj, "sortCode").unwrap_or(0).to_string();
let description = text_field(&obj, "description").unwrap_or_default();
let content_text = content.to_string();
let values: Vec<Option<String>> = vec![
Some(id.clone()),
Some(en_code),
Some(full_name),
Some(execute_type),
Some(content_text),
Some(description),
Some(sort_code),
Some(enabled_mark),
Some(user.account.clone()),
];
if let Err(e) = state
.db
.exec_params(
"INSERT INTO base_time_task \
(f_id, f_en_code, f_full_name, f_execute_type, f_execute_content, f_description, \
f_run_count, f_sort_code, f_enabled_mark, f_delete_mark, f_tenant_id, \
f_creator_time, f_creator_user_id) \
VALUES ($1::text, $2::text, $3::text, $4::text::integer, $5::text, $6::text, \
0, $7::text::bigint, $8::text::integer, 0, '0', now(), $9::text)",
&params_of(&values),
)
.await
{
return db_error(e, "新建任务");
}
ok(json!({ "id": id }))
}
/// `PUT /api/scheduletask/{id}` —— 更新任务(只改 body 里出现的键)。
pub async fn task_update(
State(state): State<AppState>,
headers: HeaderMap,
Path(id): Path<String>,
body: Bytes,
) -> Json<ActionResult> {
let user = match guard(&state, &headers, EN_TASK).await {
Ok(u) => u,
Err(resp) => return resp,
};
let id = id.trim().to_string();
let obj = match parse_body(&body) {
Ok(Value::Object(o)) => o,
Ok(_) => return fail(code::FAIL, "请求参数格式错误"),
Err(resp) => return resp,
};
let existed = match state
.db
.query_json_params(
"SELECT f_id AS \"id\" FROM base_time_task \
WHERE f_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1",
&[&id],
)
.await
{
Ok(rows) => !rows.is_empty(),
Err(e) => return db_error(e, "任务查询"),
};
if !existed {
return fail(code::FAIL, "任务不存在");
}
if let Some(en_code) = text_field(&obj, "enCode") {
let dup = state
.db
.query_json_params(
"SELECT f_id AS \"id\" FROM base_time_task \
WHERE f_en_code = $1::text AND f_id <> $2::text \
AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1",
&[&en_code, &id],
)
.await;
match dup {
Ok(rows) if !rows.is_empty() => return fail(code::FAIL, "任务编码已存在"),
Ok(_) => {}
Err(e) => return db_error(e, "任务编码查重"),
}
}
let mut sets: Vec<String> = Vec::new();
let mut values: Vec<Option<String>> = Vec::new();
for (key, column) in [
("fullName", "f_full_name"),
("enCode", "f_en_code"),
("description", "f_description"),
] {
if let Some(v) = text_field(&obj, key) {
values.push(Some(v));
sets.push(format!("{column} = ${}::text", values.len()));
}
}
for (key, column) in [
("executeType", "f_execute_type"),
("enabledMark", "f_enabled_mark"),
("sortCode", "f_sort_code"),
] {
if let Some(v) = int_field(&obj, key) {
values.push(Some(v.to_string()));
sets.push(format!("{column} = ${}::text::bigint", values.len()));
}
}
if let Some(Value::Object(content)) = obj.get("executeContent") {
values.push(Some(Value::Object(content.clone()).to_string()));
sets.push(format!("f_execute_content = ${}::text", values.len()));
}
if sets.is_empty() {
return fail(code::FAIL, "没有需要更新的字段");
}
values.push(Some(user.account.clone()));
let user_at = values.len();
values.push(Some(id.clone()));
let id_at = values.len();
let sql = format!(
"UPDATE base_time_task SET {}, f_last_modify_time = now(), \
f_last_modify_user_id = ${user_at}::text WHERE f_id = ${id_at}::text",
sets.join(", ")
);
if let Err(e) = state.db.exec_params(&sql, &params_of(&values)).await {
return db_error(e, "更新任务");
}
ok(json!({ "id": id }))
}
/// `DELETE /api/scheduletask/{id}` —— 删除任务(软删)。
pub async fn task_delete(
State(state): State<AppState>,
headers: HeaderMap,
Path(id): Path<String>,
) -> Json<ActionResult> {
if let Err(resp) = guard(&state, &headers, EN_TASK).await {
return resp;
}
let id = id.trim().to_string();
let existed = match state
.db
.query_json_params(
"SELECT f_id AS \"id\" FROM base_time_task \
WHERE f_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1",
&[&id],
)
.await
{
Ok(rows) => !rows.is_empty(),
Err(e) => return db_error(e, "任务查询"),
};
if !existed {
return fail(code::FAIL, "任务不存在");
}
if let Err(e) = state
.db
.exec_params(
"UPDATE base_time_task SET f_delete_mark = 1, f_delete_time = now() \
WHERE f_id = $1::text",
&[&id],
)
.await
{
return db_error(e, "删除任务");
}
ok(Value::Null)
}
File diff suppressed because it is too large. Load diff
+34
View File
@@ -0,0 +1,34 @@
[package]
name = "sspf-compat-workflow"
version.workspace = true
edition.workspace = true
rust-version.workspace = true
# 🔴 **契约面「workflow」域**(M4 起从 `src/backend/src/platform/compat/` 下沉到这里)。
#
# 装什么:流程与报表域(官方 `api/workFlow/**` + `api/report/**` + `api/visualdata/**`):工作流引擎 + 报表 + 可视化数据
#
# 🔴 **依赖纪律**:
# - 允许:契约面底座(`sspf-compat-core`)+ 平台核心(`sspf-core`)+ 契约层 + axum/serde。
# - 禁止:**业务包**(`sspf_pack_*`)—— 契约面不许认识任何业务。
# - 禁止:**其它契约面包** —— 各包彼此独立(AR12),唯一的例外见下方依赖段。
[dependencies]
# 契约面公共底座(判别头 / 守卫 / 分页信封 / 通用单表资源引擎)
sspf-compat-core = { path = "../sspf-compat-core" }
# 平台核心(auth / 权限 / CRUD / 信封 / 会话 / AppState)
sspf-core = { path = "../sspf-core" }
# 契约层(判别头 / 码表)
sspf-contract = { path = "../sspf-contract" }
# 时间戳(审计时间 / 消息过期时间)
chrono = { workspace = true }
# cipher 原语(aes-256-ecb)
aes = { workspace = true }
# cipher 原语(aes-256-ecb)
ecb = { workspace = true }
# cipher 原语(hex 编码)
hex = { workspace = true }
axum = { workspace = true }
serde = { workspace = true }
serde_json = { workspace = true }
+18
View File
@@ -0,0 +1,18 @@
//! # sspf-compat-workflow —— 契约面「workflow」域
//!
//! 流程与报表域(官方 `api/workFlow/**` + `api/report/**` + `api/visualdata/**`):工作流引擎 + 报表 + 可视化数据
//!
//! M4 起从 `src/backend/src/platform/compat/` 下沉到这里
//! (见 `docs/CRATES-MIGRATION.md` §4 M4)。
//!
//! 🔴 **依赖纪律(AR12)**:契约面各包**彼此独立** —— 本包**只**依赖
//! `sspf-compat-core`(底座)+ `sspf-core`(平台核心)+ `sspf-contract`(契约层)。
//! 禁止依赖其它 `sspf-compat-*` 包(唯一的单向例外已在 Cargo.toml 里注明白名单)。
//!
//! 🔴 **`src/backend/src/platform/compat/<模块>.rs` 只是转发壳**
//! (`pub use sspf_compat_workflow::<模块>::*;`)⇒ 路由注册 `compat::<模块>::<handler>`
//! **不用改**(M7 删壳时才统一改 import)。
pub mod workflow;
pub mod report;
pub mod visualdata;
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
+91 -39
View File
@@ -2,9 +2,9 @@
> **基线锚点**:`v0.1.0`(commit `b957a11`,已推送到 `origin`)
> **制定时间**:2026-11-03
> **状态**:**M3 已完成**(tag `v0.1.3-m3`)—— 契约面公共底座 `sspf-compat-core` 下沉完成;
> **状态**:**M4 已完成**(tag `v0.1.4-m4`)—— 六个契约面包(14 个模块 / ~49,000 行)下沉完成;
> 四个决策已拍板(§11):壳最后删 / compat 拆 6 包 / mcp_compat 放 crates / tests 跟着拆。
> 下一步 = M4(六个契约面包并行下沉)
> 下一步 = M5(`sspf-lowcode-exec`)
---
@@ -371,7 +371,7 @@ ssw-platform/
| `check-arch.sh` AR11 | 扫真源 `crates/sspf-compat-core/src/helper.rs` + 壳;**新增 Cargo.toml 级判据**(`sspf-compat-core` 不许依赖 `sspf-compat-*`,M4 的 6 个包) |
| `check-arch.sh` 反自证 6/6 | **两处都注入**探针(真源 + 壳),按路径分别验 |
| `check-contract-scan.py` | `plat_files` 的 `compat__<mod>` **收真源 + 壳同键拼接** —— 守卫常量(`EN_ROLE` 等)在 helper 真源里,漏收则 CC6 假漂移 |
| `docs/CRATES-MIGRATION.md` | 引文 `compat/helper.rs:89-92` → `crates/sspf-compat-core/src/helper.rs:87-91` |
| `docs/CRATES-MIGRATION.md` | 引文(旧壳 `compat/helper.rs` 89-92 行)→ `crates/sspf-compat-core/src/helper.rs:87-91` |
**反向验证**:只往真源 helper 塞 `use crate::res::Res;` ⇒ AR11 报红;清理后恢复绿。
@@ -385,20 +385,54 @@ ssw-platform/
- [x] `check-module.sh` 123/123;`check-citations.sh` 4/4
- [x] `verify.sh --smoke` 14 步全绿(561.3s)
### 批次 M4 —— 契约面业务包(6 个并行包)
### 批次 M4 —— 契约面业务包(6 个并行包)✅ 已完成(tag v0.1.4-m4)
按依赖顺序切,每个包 = 若干 `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 |
| `sspf-compat-system` | system + scheduletask + core | 17,505 + 1,163 + 1,096 | compat-core + core + store + chrono |
| `sspf-compat-permission` | permission | 6,266 | compat-core + core + **system** + store + chrono |
| `sspf-compat-msg` | message + msg_center | 2,662 + 3,391 | compat-core + core + chrono |
| `sspf-compat-workflow` | workflow + report + visualdata | 4,171 + 1,438 + 3,120 | compat-core + core + chrono + aes/ecb/hex |
| `sspf-compat-ext` | extend + teamwork + ai + mobile | 2,073 + 3,479 + 1,377 + 1,213 | compat-core + core + **system + msg** + chrono |
| `sspf-compat-online_dev` | online_dev | 3,175 | compat-core + core |
**出口判据**:每个包独立 `cargo build` 通过;`check-contract.sh` 10/10。
合计 **14 个模块 / ~49,000 行**。原 `src/backend/src/platform/compat/<模块>.rs` 全部变成 5 行转发壳(`pub use sspf_compat_<域>::<模块>::*;`)。
**⚠️ 实际做法与原计划的差异**(实测依赖图得出,非拍脑袋):
| 计划 | 实际 | 为什么 |
|---|---|---|
| `system` 只含 system.rs | 追加 `scheduletask` + `core` | 这两个模块**不依赖**任何其它契约面模块 ⇒ 与 system 同属「无跨包依赖」组,合并可少一条 crate 边 |
| `msg` 含 scheduletask | scheduletask 归 system | 同上 |
| `ext` 含 core | core 归 system | 同上 |
| `sspf-compat-online-dev` | **`sspf-compat-online_dev`** | 🔴 **Rust 包名不能带连字符**(`use sspf-compat-online-dev::…` 编译不过)⇒ 目录名与包名都改下划线 |
| 6 包互相独立 | 3 条**单向**跨包依赖 | 实测扫描得出:`permission→system`(4 符号)、`mobile→system`+`mobile→msg`(2 函数)。方向单一 ⇒ 不成环 |
**新增 AR12(防环回流闸门)**:`crates/sspf-compat-*` 之间不许互相依赖,白名单只放那 3 条单向边(`permission→system`、`ext→system`、`ext→msg`)。判据在 **Cargo.toml 级**(不是 grep 源码)⇒ 改依赖即被抓。
**🔴 本批踩的三个坑(都是「尺子是假的」)**:
1. **CC6 守卫推导静默失效**:M4 搬迁后 `check-contract.sh` **首次跑就 10/10 全绿**(M2/M3 都报红)⇒ 可疑。核实 `check-contract-scan.py` 的 `compat_dirs` **只收了 `sspf-compat-core`**,六个域包真源没收 ⇒ 守卫推导读的是转发壳(无函数体)⇒ 尺子已废。
**修复**:动态收编所有 `crates/sspf-compat-*/src`(写死路径列表必然在某次新增包时漏掉 ⇒ 用 glob)。**反向验证**:把真源 `permission.rs:135` 的 `EN_ROLE` 改成 `EN_ACTION` ⇒ CC6 精确报出「GET /api/permission/Role:契约写 permission.role,代码是 permission.action」;还原后恢复 10/10。
2. **CP1 业务标识符未扫契约面包**:`check-boundary.sh` 的 CP1/CP2 只扫 `sspf-core` + `platform/`。**修复**:新增动态 `COMPAT_DIRS` 并纳入。**反向验证**:往 `crates/sspf-compat-msg/src/msg_center.rs` 插入 `const LEAK_PROBE: &str = "demo_item";` ⇒ CP1 精确报出该行;还原后恢复 11/11。
3. **🔴 macOS 的 BSD grep 不支持 `\s`**(POSIX ERE)—— AR11 的 Cargo.toml 级判据和 AR12 都写成 `grep -E '^\s*sspf-compat-...'` ⇒ **永远匹配不到 ⇒ 永远"通过"**。这是 AR12 反自证第一次跑就**失败**暴露的("尺子是假的")。
**修复**:全部改成 POSIX 字符类 `[[:space:]]`。**全仓扫了一遍** `scripts/*.sh`,只有这一处(注释里还有一处,不影响执行)。
🔴 **教训**:闸门判据里的正则**必须用反自证验证过一次**才敢信 —— `grep` 不报错、退出码 0、`ok` 打印 ⇒ 三重「看起来正常」。
**出口判据(全部达成)**:
- [x] 6 个 crate 各自 `cargo build -p` 通过;`cargo build --workspace` 零警告
- [x] `cargo test --workspace` = **695 passed / 0 failed**(与 M1 基线完全一致)
- [x] `check-arch.sh` = **15/15**(新增 AR12);`--self-test` = **7/7**(新增 AR12 反自证)
- [x] `check-boundary.sh` = 11/11
- [x] `check-contract.sh` = 10/10(反自证 12 例全过)
- [x] `check-module.sh` = 123/123
- [x] `check-citations.sh` = 4/4(引文路径改到新真源,行号 1:1 未变 ⇒ 迁移是纯搬运)
- [x] `check-naming.sh` = 3 通过 / 0 失败 / 1 提示
- [x] `verify.sh --smoke` 14 步全绿(300.9s)
### 批次 M5 —— 低代码执行层下沉
@@ -440,12 +474,15 @@ ssw-platform/
| 判据 | 现状 | 改造后 |
|---|---|---|
| AR9(平台层不许认识业务包) | grep `src/backend/src/platform` | 改成 grep **所有 crates 平台包** |
| AR9(平台层不许认识业务包) | grep `src/backend/src/platform` | ✅ grep **所有 crates 平台包**(`PLAT_SRC_DIRS`,动态 glob) |
| 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} |
| 🆕 AR10 | — | ✅ `crates/sspf-core` 依赖 ⊆ {contract, store, axum, tokio, serde, serde_json} |
| 🆕 AR11 | — | ✅ `crates/sspf-compat-core`(底座)**不许**依赖其它契约面模块 + Cargo.toml 级判据 |
| 🆕 AR12 | — | ✅ `crates/sspf-compat-*` 之间**不许**互相依赖(防环回流),白名单 3 条单向边 |
| 🆕 AR13 | — | `crates/sspf-lowcode-exec` 依赖 ⊆ {lowcode, core, store, mcp}(M5 加) |
> 🔴 **AR11/AR12 的 Cargo.toml 级判据踩过 BSD grep 的坑**:`grep -E '^\s*...'` 在 macOS 上**永远匹配不到**(BSD grep 是 POSIX ERE,不认 `\s`)⇒ 尺子永远"通过"。
> 正确写法:`[[:space:]]`。**这个坑是 AR12 反自证第一次跑就失败暴露的** —— 没有反自证,就带着一把假尺子跑完了 M4。
### 5.2 `scripts/check-contract-scan.py` ✅ M2 已做(部分)
@@ -453,21 +490,27 @@ ssw-platform/
**M2 改造(已做)**:`plat_files` **两处都收** —— `crates/sspf-core/src/*.rs`(真源)+ `src/backend/src/platform/*.rs`(壳),重名键**拼接**而非覆盖(否则一边的函数推不出守卫)。
**M4 后续(待做)**:`compat/` 搬走后要收 `sspf-compat-*` 各包:
**M4 改造(已做)**:`compat/` 搬走后要收 `sspf-compat-*` 各包 —— **动态收编**(glob 扫 `crates/sspf-compat-*/src`,**不写死列表**):
```python
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))
crates_root = os.path.join(ROOT, "crates")
for cname in sorted(os.listdir(crates_root)):
if not cname.startswith("sspf-compat-"): continue
if cname == "sspf-compat-core": continue
cdir = os.path.join(crates_root, cname, "src")
if os.path.isdir(cdir): compat_dirs.append(cdir)
```
**必须**在 M4 之后立刻做,并**重跑 `check-contract.sh --self-test`** 确认没退化。
🔴 **为什么必须动态**:写死路径列表必然在某次新增包时漏掉 ⇒ 尺子**静默**失效(本次实测踩过:首次跑 10/10 全绿就是尺子已废的信号)。
### 5.3 `scripts/check-boundary-scan.py` / `check-boundary.sh` ✅ M2 已做
**M4 收尾(已做)**:`check-contract.sh --self-test` 12 例全过 ⇒ 尺子没退化。
### 5.3 `scripts/check-boundary-scan.py` / `check-boundary.sh` ✅ M2/M4 已做
**问题**:扫 `src/backend/src/platform/` 找业务标识符。代码搬走后**扫不到** ⇒ 平台层混入业务知识**不再被发现**。
**M2 改造(已做)**:新增 `PLATFORM_CORE="$ROOT/crates/sspf-core/src"`,CP1(业务标识符)/ CP2(`use crate::modules`)**两处都扫**;CP6 的 `seed.rs` 改读真源(`BUILTIN_MENUS` 在 core 里)。**实测**:改前 CP6 报「BUILTIN_MENUS 有 0 条」(读空壳)⇒ 改后 11/11 全绿。
**M4 改造(已做)**:新增**动态** `COMPAT_DIRS`(glob 扫 `crates/sspf-compat-*/src`),CP1/CP2 都纳入。**反向验证**:往 `crates/sspf-compat-msg/src/msg_center.rs` 插 `const LEAK_PROBE: &str = "demo_item";` ⇒ CP1 精确报出该行;还原后恢复 11/11。
### 5.4 `scripts/check-module.sh` ✅ M2 已做(CRUD 路径)
业务层(`modules/<app>.rs`)**留在壳里** ⇒ 主体不用改;但**软删契约**(`WHERE f_delete_mark = 0` / `SET f_delete_mark = 1`)读 `crud.rs` ⇒ `CRUD` 变量改读 `crates/sspf-core/src/crud.rs`(转发壳里没有 SQL)。**实测**:改前 8 项软删检查全 ❌(读不到 SQL)⇒ 改后 123/123 全绿。
@@ -495,6 +538,8 @@ for c in PLAT_CRATES:
| R6 | **AR 白名单要重写** ⇒ 纪律放松 | 🟡 中 | 每次新增 crate 必须同时加 AR 条目 + 反自证 |
| R7 | 合并冲突(多人并行) | 🟢 低 | 按包切分文件,冲突面小 |
| R8 | 迁移期间**功能退化** | 🔴 高 | 每批次必须全绿才进下一批;tag `v0.1.0` 随时可回滚 |
| R9 | 🔴 **闸门正则本身是坏的**(`\s` 在 BSD grep 上不生效 ⇒ 永远"通过") | 🔴 极高 | **每个新判据必须先跑一次反自证**;M4 的 AR12 反自证第一次就失败并暴露了 AR11 的同类缺陷 |
| R10 | 🔴 **写死的路径列表漏掉新包** ⇒ 尺子静默失效 | 🔴 极高 | 收编目录一律用 **glob**(`crates/sspf-compat-*/src`),不写死清单;M4 的 CC6 就是这么废的 |
---
@@ -539,19 +584,20 @@ git reset --hard v0.1.1-m1
## 9. 执行顺序建议
```
M1 解耦(3 个循环) ← 不搬文件,只改代码,风险最高,最先做
M1 解耦(3 个循环) ← ✅ v0.1.1-m1
↓
M2 sspf-core ← 平台核心下沉,保留 re-export 壳
M2 sspf-core ← ✅ v0.1.2-m2(19 模块 / 6,664 行)
↓
M3 sspf-compat-core ← 契约面底座
M3 sspf-compat-core ← ✅ v0.1.3-m3(helper/res / 1,454 行)
↓
M4 六个 compat 包 ← 🔴 同步改 check-contract-scan.py
M4 六个 compat 包 ← ✅ v0.1.4-m4(14 模块 / ~49,000 行)
│ 🔴 同步改 check-contract-scan.py + check-boundary.sh + 新增 AR12
↓
M5 sspf-lowcode-exec
M5 sspf-lowcode-exec ← 🔴 同步加 AR13
↓
M6 sspf-mcp-adapter
M6 sspf-mcp-adapter ← 决策③:mcp_compat 放 crates
↓
M7 壳收口 + 闸门补全 ← AR10–AR13 + 全量反自证
M7 壳收口 + 闸门补全 ← AR13 + 全量反自证 + 删 platform/ 转发壳 + 拆 tests/
```
**每一批的出口判据都相同**:
@@ -589,9 +635,10 @@ bash scripts/verify.sh --smoke # 14 步全绿
删壳时 AR9/AR10/CP1/CP2 的「两处都扫」收敛为只扫 `crates/`(壳没了)。
- **M7 出口判据**:`src/backend/src/platform/` 目录整个删除;全仓无 `crate::platform::` 引用。
2. ✅ **compat 拆 6 个包**(按官方模块名):`sspf-compat-{system,permission,msg,workflow,ext,online-dev}`。
2. ✅ **compat 拆 6 个包**(按官方模块名):`sspf-compat-{system,permission,msg,workflow,ext,online_dev}`。
- 边界清晰、与官方前端 `api/` 目录一一对应。
- **M4 必须同步**:`check-contract-scan.py` 收编 6 个包 + 重跑 `--self-test`。
- ⚠️ **实际落地时 `online-dev` 改名 `online_dev`** —— Rust 包名不能带连字符(`use sspf-compat-online-dev::…` 编译不过)。
- **M4 已同步**:`check-contract-scan.py` 动态收编 6 个包 + 重跑 `--self-test`(12 例全过)。
3. ✅ **`mcp_compat.rs` 放 crates**(`sspf-mcp-adapter`)。
- 接受它是依赖图里唯一的高扇入节点(依赖所有 compat 包)。
@@ -607,11 +654,16 @@ bash scripts/verify.sh --smoke # 14 步全绿
## 12. 立即可做的下一步
**执行 M4(六个契约面包并行下沉)**。理由:
1. M1(解环)/ M2(平台核心)/ M3(契约面底座)已完成并打 tag —— 地基与底座都稳了
2. 决策 ② 已拍板:按官方模块名拆 **6 个包**(`sspf-compat-{system,permission,msg,workflow,ext,online-dev}`)
3. 套路成熟:M2/M3 的「转发壳 + 闸门两处扫 + 反自证两处注入」直接复用
**执行 M5(`sspf-lowcode-exec`)**。理由:
1. M1/M2/M3/M4 已完成并打 tag —— 地基、平台核心、契约面底座、六个契约面包都稳了
2. M5 规模最小(2,674 行,4 个模块),是 M6/M7 前最后的低风险批次
3. 套路成熟:M2/M3/M4 的「转发壳 + 闸门两处扫 + 反自证两处注入」直接复用
M4 完成后打 tag `v0.1.4-m4`。
⚠️ **M4 必须同步做** §5.2 的 `check-contract-scan.py` 六包收编 + 重跑 `--self-test`(守卫推导的存亡线)。
之后 = M5(`sspf-lowcode-exec`)→ M6(`sspf-mcp-adapter`,决策③放 crates)→ M7(收口:删壳 + tests 拆分 + AR12/AR13)。
M5 完成后打 tag `v0.1.5-m5`。
⚠️ **M5 必须同步做**:① `check-arch.sh` 加 **AR13**(`sspf-lowcode-exec` 依赖 ⊆ {lowcode, core, store, mcp});② `check-boundary.sh` 的 CP6/软删检查若涉及 `lowcode_*.rs` 也要纳入真源;③ 重跑全部 `--self-test`。
之后 = M6(`sspf-mcp-adapter`,决策③放 crates)→ M7(收口:删壳 + tests 拆分 + AR13)。
> 🔴 **M4 留下的教训,M5/M6 必须继承**:
> ① **闸门判据里的正则要用反自证验证过一次**才敢信 —— `grep` 不报错 + 退出码 0 + 打印 `ok` = 三重「看起来正常」,但 BSD grep 的 `\s` 让 AR11/AR12 一直空转。
> ② **收编新目录要用 glob,不要写死路径列表** —— 写死列表必然在某次新增包时漏掉 ⇒ 尺子静默失效(M4 的 CC6 就是这么废的)。
> ③ **搬迁后第一反应不该是「全绿」而是「可疑」** —— M2/M3 搬迁后闸门都报红(正常),M4 首次跑就 10/10 ⇒ 反而是尺子坏了的信号。
+1 -1
View File
@@ -635,7 +635,7 @@ brief 原写「第 15 个字符是 `'-'`」「第 14 个字符是 `'4'`」——
- Concern 4(`save` 非单事务):按 S16 口径**不是本任务缺陷** ⇒ 归 P59 已知缺口。
- Concern 5(clippy):「`permission.rs` 已有同类告警」**属实**,但计数需修正 ——
实跑 `cargo clippy --all-targets`:`doc_lazy_continuation` **共 6 条**
(**本任务新引入 4 条**:`crud.rs:5-6` / `entity.rs:5-6`;既有 2 条:`permission.rs:18-19`)。
(**本任务新引入 4 条**:`crud.rs:5-6` / `entity.rs:5-6`;既有 2 条:`crates/sspf-compat-permission/src/permission.rs:18-19`)。
⇒ 另发现**既有**告警:`sys.rs` 3 条(`question_mark` / `unnecessary_first_then_check` /
`vec_init_then_push`)+ `tests/seed_it.rs` 1 条(`type_complexity`)⇒ 共 6 条待清。
🔴 **根因已定位**:`crud.rs:4` / `entity.rs:4` 的**行首是 `+`** ⇒ markdown 当成无序列表标记
+5 -5
View File
@@ -65,7 +65,7 @@
- **端点**:`POST /api/permission/Users/{id}/Actions/ResetPassword`
- **官方 v7 事实**:`views/permission/user/ResetPassword.vue` 提交
`{ id, userPassword: md5(明文), validatePassword: md5(明文) }`
- **本仓实现**:`platform/compat/permission.rs:698-707` 只读 `password` / `newPassword`,
- **本仓实现**:`crates/sspf-compat-permission/src/permission.rs:698-707` 只读 `password` / `newPassword`,
且把读到的值**再算一次 md5**(`md5_hex(&plain)`)
- **实测(两个方向都坏)**:
@@ -96,9 +96,9 @@
| # | 端点 | 代码位置 | 服务端日志 |
|---|---|---|---|
| 1 | `GET /api/visualdev/OnlineLog` | `compat/online_dev.rs:2333-2350` | `[face-b] 在线日志总数查询失败: statement takes 0 parameters, 1 given` |
| 2 | `GET /api/visualdev/share/Selector` | `compat/online_dev.rs:2261-2272` | `[face-b] 跨应用功能查询失败: statement takes 0 parameters, 1 given` |
| 3 | `GET /api/message/Monitor/{id}/RecordList` | `compat/msg_center.rs:180`(`paged_query` 的 count 分支) | `[face-b] 消息发送记录列表总数查询失败: statement takes 0 parameters, 1 given` |
| 1 | `GET /api/visualdev/OnlineLog` | `crates/sspf-compat-online_dev/src/online_dev.rs:2333-2350` | `[face-b] 在线日志总数查询失败: statement takes 0 parameters, 1 given` |
| 2 | `GET /api/visualdev/share/Selector` | `crates/sspf-compat-online_dev/src/online_dev.rs:2261-2272` | `[face-b] 跨应用功能查询失败: statement takes 0 parameters, 1 given` |
| 3 | `GET /api/message/Monitor/{id}/RecordList` | `crates/sspf-compat-msg/src/msg_center.rs:180`(`paged_query` 的 count 分支) | `[face-b] 消息发送记录列表总数查询失败: statement takes 0 parameters, 1 given` |
复现(三条都不依赖库里有没有数据):
@@ -123,7 +123,7 @@ curl -s localhost:30000/api/message/Monitor/xxx/RecordList "${H[@]}"
### P1-1 登录后每个页面必现一个未捕获异常(`updatePasswordMessage` 故意 400)(已修复)
- **端点**:`POST /api/oauth/updatePasswordMessage`
- **本仓**:`compat/core.rs:296` ⇒ `unsupported("修改密码提醒(没有邮件 / 短信通道)")`
- **本仓**:`crates/sspf-compat-system/src/core.rs:296` ⇒ `unsupported("修改密码提醒(没有邮件 / 短信通道)")`
⇒ `code=400`。契约 `docs/contract.md:2556` 把这条标成 `partial`「明确业务失败」,**是有意为之**。
- **官方前端**:`layouts/header/index.vue:74` 在布局挂载时**无条件调用且没有 catch**。
- **实测**:每个已登录页面都出现
+103 -14
View File
@@ -51,6 +51,19 @@ CRATES="$ROOT/crates"
KERNEL="$ROOT/src/backend"
MODULES_DIR="$KERNEL/src/modules"
# 🔴 **平台侧真源目录表**(M2/M3/M4 逐步扩):
# - `sspf-core/src` 平台核心(M2)
# - `sspf-compat-*/src` 契约面 7 个包(M3 底座 + M4 六个域包)
# - `platform/` 转发壳(防塞私货)
# 🔴 **动态收集**(`crates/sspf-compat-*/src`)⇒ 新增契约面包时**不会漏扫** ——
# 写死列表必然在某次新增包时漏掉 ⇒ 尺子静默失效(实测踩过)。
PLAT_SRC_DIRS=()
[ -d "$CRATES/sspf-core/src" ] && PLAT_SRC_DIRS+=("$CRATES/sspf-core/src")
for d in "$CRATES"/sspf-compat-*/src; do
[ -d "$d" ] && PLAT_SRC_DIRS+=("$d")
done
[ -d "$KERNEL/src/platform" ] && PLAT_SRC_DIRS+=("$KERNEL/src/platform")
PASS=0
FAIL=0
SKIP=0
@@ -215,13 +228,12 @@ check_ar8() {
# 只扫壳 = 尺子量空壳 = 虚假安全感。
check_ar9() {
local dirs=()
[ -d "$CRATES/sspf-core/src" ] && dirs+=("$CRATES/sspf-core/src")
[ -d "$KERNEL/src/platform" ] && dirs+=("$KERNEL/src/platform")
[ "${#dirs[@]}" -gt 0 ] || { skip "AR9 平台层目录不存在"; return; }
[ "${#PLAT_SRC_DIRS[@]}" -gt 0 ] || { skip "AR9 平台层目录不存在"; return; }
dirs=("${PLAT_SRC_DIRS[@]}")
local hits
hits="$(grep -rnE '^[[:space:]]*(pub )?use[[:space:]]+sspf_pack_' "${dirs[@]}" 2>/dev/null || true)"
if [ -z "$hits" ]; then
ok "AR9 平台层没有 use sspf_pack_*(业务知识没漏进 sspf-core/ 或 platform/)"
ok "AR9 平台层没有 use sspf_pack_*(业务知识没漏进 sspf-core/ / compat 各包 / platform/)"
else
bad "AR9 平台层出现了业务包引用(业务知识漏进平台层 ⇒ 加包要改平台层):"
printf '%s\n' "$hits" | sed 's/^/ /'
@@ -245,9 +257,8 @@ check_ar9() {
# **不含 compat/**)里都不许出现 `crate::platform::compat` / `super::compat` / `crate::compat`。
check_ar10() {
local dirs=()
[ -d "$CRATES/sspf-core/src" ] && dirs+=("$CRATES/sspf-core/src")
[ -d "$KERNEL/src/platform" ] && dirs+=("$KERNEL/src/platform")
[ "${#dirs[@]}" -gt 0 ] || { skip "AR10 平台层目录不存在"; return; }
[ "${#PLAT_SRC_DIRS[@]}" -gt 0 ] || { skip "AR10 平台层目录不存在"; return; }
dirs=("${PLAT_SRC_DIRS[@]}")
local hits
# 🔴 **必须排除注释行**(`//` / `//!` / `///`)—— 文档注释里的路径引用是
# **给人看的**(如 `//! (见 crate::platform::compat::helper::load_menus])`),
@@ -320,7 +331,7 @@ check_ar11() {
local toml="$CRATES/sspf-compat-core/Cargo.toml"
if [ -f "$toml" ]; then
local dep_hits
dep_hits="$(grep -nE '^\s*sspf-compat-[a-z-]+\s*=' "$toml" 2>/dev/null || true)"
dep_hits="$(grep -nE '^[[:space:]]*sspf-compat-[a-z_-]+[[:space:]]*=' "$toml" 2>/dev/null || true)"
if [ -n "$dep_hits" ]; then
hits="${hits:+$hits$'\n'}${dep_hits}"
fi
@@ -333,6 +344,56 @@ check_ar11() {
fi
}
# ---------------------------------------------------------------- AR12
# **契约面各包之间不许互相依赖**(M4 拆 6 个包时的防环回流闸门)。
#
# 🔴 **为什么需要**:M4 把 49,000 行契约面拆成 7 个 crate。各包本应**彼此独立**
# (都只依赖 `sspf-compat-core` 底座 + `sspf-core` 平台核心)。
# 一旦 A 包 `use sspf_compat_b::…` 而 B 包又 `use sspf_compat_a::…`
# ⇒ **循环依赖** ⇒ 编译器直接报错(但那时已经改了一堆东西,回滚成本高)。
#
# 🔴 **唯一允许的两条单向依赖**(方向单一 ⇒ 不成环,已核实被依赖方不反向依赖):
# · `sspf-compat-permission` → `sspf-compat-system`
# (权限域用系统域的 `SYSTEM_LIST_PROJECTION` / `load_system_tops` /
# `log_page` / `shape_system_list_item`)
# · `sspf-compat-ext` → `sspf-compat-system` + `sspf-compat-msg`
# (移动端复用系统域 `home_data` 控制台卡片 + 消息域 `send_config_select_list`)
#
# 判据:每个 `crates/sspf-compat-*/Cargo.toml` 里出现的 `sspf-compat-*` 依赖,
# 必须在白名单内,且**白名单方向要反过来核实**(被依赖方不许依赖依赖方)。
check_ar12() {
local hits=""
local dir
for dir in "$CRATES"/sspf-compat-*; do
[ -d "$dir" ] || continue
local toml="$dir/Cargo.toml"
[ -f "$toml" ] || continue
local self_name
self_name="$(basename "$dir")"
local dep
for dep in $(grep -oE '^[[:space:]]*sspf-compat-[a-z_-]+[[:space:]]*=' "$toml" 2>/dev/null | grep -oE 'sspf-compat-[a-z_-]+' | sort -u); do
# 底座(sspf-compat-core)永远允许
[ "$dep" = "sspf-compat-core" ] && continue
# 白名单:按「依赖方 → 被依赖方」判定
local allowed=0
case "${self_name}:${dep}" in
sspf-compat-permission:sspf-compat-system) allowed=1 ;;
sspf-compat-ext:sspf-compat-system) allowed=1 ;;
sspf-compat-ext:sspf-compat-msg) allowed=1 ;;
esac
if [ "$allowed" -eq 0 ]; then
hits="${hits:+$hits$'\n'}${toml}: ${self_name} → ${dep}(不在白名单)"
fi
done
done
if [ -z "$hits" ]; then
ok "AR12 契约面各包彼此独立(只依赖底座 + 两条单向白名单 ⇒ 不会成环)"
else
bad "AR12 契约面包之间出现了未授权依赖(跨包依赖易成环):"
printf '%s\n' "$hits" | sed 's/^/ /'
fi
}
# ---------------------------------------------------------------- PACK1
# **spec 单一真源**:`modules/<app>.rs` 只许做转发,不许自己写 spec。
#
@@ -466,7 +527,7 @@ PY
self_test() {
local rc=0
echo "── 反自证 1/6:造一个依赖越界的假 pack,AR2 必须报 ❌ ──"
echo "── 反自证 1/7:造一个依赖越界的假 pack,AR2 必须报 ❌ ──"
local tmp="$ROOT/packs/__arch_selftest__"
mkdir -p "$tmp"
cat > "$tmp/Cargo.toml" <<'TOML'
@@ -492,7 +553,7 @@ TOML
rc=1
fi
echo "── 反自证 2/6:往平台层塞一个 use sspf_pack_*,AR9 必须报 ❌ ──"
echo "── 反自证 2/7:往平台层塞一个 use sspf_pack_*,AR9 必须报 ❌ ──"
#
# 🔴 **为什么必须自证 AR9**:它的判据是 `grep 目录`。
# 目录名写错 / 路径拼错 ⇒ `grep` 永远返回空 ⇒ **永远"通过"**。
@@ -530,7 +591,7 @@ TOML
rc=1
fi
echo "── 反自证 3/6:往 re-export 的模块里塞一份 spec,PACK1 必须报 ❌ ──"
echo "── 反自证 3/7:往 re-export 的模块里塞一份 spec,PACK1 必须报 ❌ ──"
#
# 🔴 造在**临时模块文件**上(不动真文件):只要它同时有 `pub use sspf_pack_`
# 和 `= EntitySpec {`,PACK1 就必须红。
@@ -556,7 +617,7 @@ RS
echo "⏭ 跳过 PACK1 反自证(业务模块目录不存在)"
fi
echo "── 反自证 4/6:往 sspf-plugin 塞 axum 依赖,AR8 必须报 ❌ ──"
echo "── 反自证 4/7:往 sspf-plugin 塞 axum 依赖,AR8 必须报 ❌ ──"
local pfile="$CRATES/sspf-plugin/Cargo.toml"
if [ -f "$pfile" ]; then
cp "$pfile" "$pfile.bak"
@@ -577,7 +638,7 @@ RS
echo "⏭ 跳过 AR8 反自证(sspf-plugin 不存在)"
fi
echo "── 反自证 5/6:往平台层塞 crate::platform::compat,AR10 必须报 ❌ ──"
echo "── 反自证 5/7:往平台层塞 crate::platform::compat,AR10 必须报 ❌ ──"
#
# 🔴 **必须自证 AR10**:它的判据是「扫平台层目录找契约面引用」。
# 目录名写错 / 路径拼错 ⇒ 扫描永远返回空 ⇒ **永远"通过"** ⇒ 虚假安全感。
@@ -610,7 +671,7 @@ RS
rc=1
fi
echo "── 反自证 6/6:往契约面底座塞 use super::system,AR11 必须报 ❌ ──"
echo "── 反自证 6/7:往契约面底座塞 use super::system,AR11 必须报 ❌ ──"
#
# 🔴 **M3 起底座有两处**:真源 `crates/sspf-compat-core/src/helper.rs`(实现)
# + 转发壳 `src/backend/src/platform/compat/helper.rs`。**两处都注入、
@@ -637,6 +698,33 @@ RS
rc=1
fi
echo "── 反自证 7/7:给域包塞一条未授权的跨包依赖,AR12 必须报 ❌ ──"
#
# 🔴 **为什么必须自证 AR12**:它的判据是「读 Cargo.toml 找 sspf-compat-* 依赖」。
# 若 grep 模式写错(包名含连字符/下划线混用)⇒ 永远扫不到依赖 ⇒
# **永远"通过"** ⇒ 虚假安全感。而 AR12 守的正是「契约面各包不会成环」。
# 🔴 **注入必须避开白名单**:挑 `sspf-compat-msg`(它不在任何白名单里,
# 反向依赖 `sspf-compat-workflow` ⇒ 立刻成环)⇒ 必须被抓到。
local a12ok=0
local a12toml="$CRATES/sspf-compat-msg/Cargo.toml"
if [ -f "$a12toml" ]; then
cp "$a12toml" "$a12toml.bak"
printf '\nsspf-compat-workflow = { path = "../sspf-compat-workflow" }\n' >> "$a12toml"
local a12out
a12out="$(check_ar12 2>&1 || true)"
mv "$a12toml.bak" "$a12toml"
# 🔴 必须**按路径验**:输出里要明确出现被注入的那个包 + 那个依赖
if echo "$a12out" | grep -q "sspf-compat-msg → sspf-compat-workflow"; then
a12ok=1
fi
fi
if [ "$a12ok" -eq 1 ]; then
echo "✅ 反自证通过:AR12 抓到了 msg → workflow 的未授权跨包依赖"
else
echo "❌ 反自证失败:AR12 没抓到未授权的跨包依赖 ⇒ 尺子是假的"
rc=1
fi
return $rc
}
@@ -655,6 +743,7 @@ check_ar8
check_ar9
check_ar10
check_ar11
check_ar12
check_pack1
check_mem1
check_mem2
+12 -5
View File
@@ -42,6 +42,13 @@ PLATFORM="$SRC/platform"
# 只剩转发壳(`pub use sspf_core::*`)+ 尚未搬走的 `compat/`(M3/M4)。
# ⇒ 所有「扫平台层」的判据必须**两处都扫**(真源管实现、壳防塞私货)。
PLATFORM_CORE="$ROOT/crates/sspf-core/src"
# 🔴 **M4 起契约面真源分散在 7 个 crate**(`sspf-compat-core` + 6 个域包)——
# 契约面也是「平台侧」⇒ 业务标识符泄漏 / 反向依赖业务层同样要查。
# ⇒ 动态收集 `crates/sspf-compat-*/src`,**新增包时不会漏扫**(写死列表必然漏)。
COMPAT_DIRS=()
for d in "$ROOT"/crates/sspf-compat-*/src; do
[ -d "$d" ] && COMPAT_DIRS+=("$d")
done
MODULES="$SRC/modules"
MODULES_MOD="$MODULES/mod.rs"
BOOTSTRAP="$SRC/bootstrap.rs"
@@ -115,7 +122,7 @@ hdr "[CP1] 平台层零业务标识符(扫字符串字面量;禁止清单从
# + `packs/*/src/lib.rs`(业务包)⇒ 两处都要进「禁止清单」,
# 否则包里的业务表名会从清单里消失 ⇒ 尺子变弱。
# 🔴 **M2 起平台层真源在 `crates/sspf-core/src/`** ⇒ 它必须进扫描面(否则扫空壳)。
SCAN_OUT="$(SSW_PACKS_DIR="${ROOT}/packs" "${PY_BIN}" "${SCAN}" "${MODULES}" "${PLATFORM_CORE}" "${PLATFORM}" "${SRC}/routes.rs" "${SRC}/main.rs" "${BOOTSTRAP}" 2>&1)"
SCAN_OUT="$(SSW_PACKS_DIR="${ROOT}/packs" "${PY_BIN}" "${SCAN}" "${MODULES}" "${PLATFORM_CORE}" "${PLATFORM}" ${COMPAT_DIRS[@]+"${COMPAT_DIRS[@]}"} "${SRC}/routes.rs" "${SRC}/main.rs" "${BOOTSTRAP}" 2>&1)"
if [ "$?" -eq 0 ]; then
ok "平台层没有业务标识符($(printf '%s\n' "${SCAN_OUT}" | tail -1))"
else
@@ -124,11 +131,11 @@ else
fi
# ---- CP2 平台层不反向依赖业务层 ----
hdr "[CP2] 平台层不反向依赖业务层(sspf-core/** 与 platform/** 不许 use crate::modules)"
# 🔴 两处都扫:真源 `crates/sspf-core/src/`(实现)+ 转发壳(防塞私货)。
CP2_HITS="$(grep -rn "use crate::modules" "${PLATFORM_CORE}" "${PLATFORM}" 2>/dev/null)"
hdr "[CP2] 平台层不反向依赖业务层(sspf-core/** 与 compat 包/** 不许 use crate::modules)"
# 🔴 三处都扫:平台核心真源 + 平台转发壳 + 契约面 7 个包的真源。
CP2_HITS="$(grep -rn "use crate::modules" "${PLATFORM_CORE}" "${PLATFORM}" ${COMPAT_DIRS[@]+"${COMPAT_DIRS[@]}"} 2>/dev/null)"
if [ -z "${CP2_HITS}" ]; then
ok "sspf-core/** 与 platform/** 都没有 use crate::modules"
ok "平台核心 / 转发壳 / 契约面各包 都没有 use crate::modules"
else
no "平台层引用了业务层:"
printf '%s\n' "${CP2_HITS}" | sed 's/^/ /'
+14
View File
@@ -858,10 +858,24 @@ def scan_code(src_dir, packs_dir=None):
# 否则守卫推导**全部推不出**(CC6 退化成「全是 WARN」⇒ 静默失效)。
# 🔴 **M3 起契约面底座真源在 `crates/sspf-compat-core/src/`**(`helper.rs` 装守卫常量
# `EN_ROLE` 等)⇒ 必须一并收(与壳同键拼接),否则守卫常量找不到 ⇒ CC6 假漂移。
# 🔴 **M4 起六个域包的真源也分散在 `crates/sspf-compat-*/src/`** —— 必须**逐包收**,
# 否则守卫推导读到的全是转发壳(`pub use …` 无函数体)⇒ **CC6 静默失效**
# (实测:漏收时 check-contract 照样 10/10 全绿,但尺子已经废了)。
compat_dirs = [
os.path.join(ROOT, "crates", "sspf-compat-core", "src"), # M3 真源(helper/res)
os.path.join(plat_dir, "compat"), # 壳 + 尚未搬走的模块
]
# 🔴 **M4:六个契约面域包的真源**(按包名遍历 ⇒ 新增包时不会漏收)
crates_root = os.path.join(ROOT, "crates")
if os.path.isdir(crates_root):
for cname in sorted(os.listdir(crates_root)):
if not cname.startswith("sspf-compat-"):
continue
if cname == "sspf-compat-core":
continue # 已在上面收过
cdir = os.path.join(crates_root, cname, "src")
if os.path.isdir(cdir):
compat_dirs.append(cdir)
for d in compat_dirs:
if os.path.isdir(d):
for name in sorted(os.listdir(d)):
+9
View File
@@ -49,6 +49,15 @@ sspf-core = { path = "../../crates/sspf-core" }
# `src/backend/src/platform/compat/{helper,res}.rs` 现在只是转发壳 ⇒ 14 个模块零感知。
sspf-compat-core = { path = "../../crates/sspf-compat-core" }
# 🔴 **契约面六个域包**(M4)—— 按官方模块名拆:system / permission / msg / workflow / ext / online-dev。
# `src/backend/src/platform/compat/<模块>.rs` 现在只是转发壳 ⇒ 路由注册零感知。
sspf-compat-system = { path = "../../crates/sspf-compat-system" }
sspf-compat-permission = { path = "../../crates/sspf-compat-permission" }
sspf-compat-msg = { path = "../../crates/sspf-compat-msg" }
sspf-compat-workflow = { path = "../../crates/sspf-compat-workflow" }
sspf-compat-ext = { path = "../../crates/sspf-compat-ext" }
sspf-compat-online_dev = { path = "../../crates/sspf-compat-online_dev" }
# MCP 工具层(元工具 + 分层加载)—— 内核实现它的 PlatformAdapter,反向依赖
sspf-mcp = { path = "../../crates/sspf-mcp" }
# 低代码元数据引擎(纯计算:解析/校验/SQL 生成)
File diff suppressed because it is too large. Load diff
+4 -493
View File
@@ -1,494 +1,5 @@
//! core —— 官方面 B 的 **core** 端点集(`/api/oauth/*` / `/api/file/*` / `/api/system/Location/*`)。
//!
//! 🔴 官方前端 `src/api/core/**` 共 4 个文件(`auth` / `common` / `user` / `index`),
//! 对应的是**框架自带**能力(登录 / 票据 / 文件 / 地图),不是业务资源。
//!
//! 真源:官方 Java `jnpf-oauth` + `jnpf-file` + `jnpf-system`。
//!
//! 🔴 **本文件的端点分三类**(批次 18 逐条核对官方 Java + 官方前端后判定):
//! ① **真实现**(6 条):锁屏解锁、免密登录票据、扫码登录凭证 —— 本仓有落库/内存表可做;
//! ② **明确失败**(13 条):文件族(无文件存储)、地图族(无高德 key + 无 HTTP 客户端)、
//! 改密通知(无邮件/短信通道)⇒ `code=400` + 人话,**不返假 URL、不返假坐标**;
//! ③ **明确失败**(3 条):SaaS 多租户族 / 第三方登录 —— 本仓无多租户切换、无第三方配置。
//! core —— **转发壳**:真源在 [`sspf_compat_system::core`](M4 契约面「system」域下沉)。
//! 🔴 只做转发、不含实现;路由注册 `compat::core::…` 不用改。
//! 为什么留壳、闸门怎么改:见 `docs/CRATES-MIGRATION.md` §4 M4。
use axum::body::Bytes;
use axum::extract::{Path, RawQuery, State};
use axum::http::HeaderMap;
use axum::Json;
use serde_json::{json, Value};
use crate::platform::cipher::decrypt_to_md5;
use crate::platform::envelope::{code, fail, ok, ActionResult};
use crate::platform::auth::require_login_face_b;
use crate::platform::session::{Ticket, TicketKind};
use crate::platform::state::AppState;
// ================================================================ 常量
/// 免密登录票据有效期(秒)—— 官方 `oauthConfig.getTicketTimeout()` 的默认值口径。
///
/// 🔴 官方值来自**系统配置**(`oauthConfig`)⇒ 本仓无该配置项 ⇒ 取一个
/// 合理默认值(官方同族配置的常见量级),并在响应里如实给出这个值。
const TICKET_TTL_SECONDS: i64 = 300;
/// 扫码登录凭证有效期(秒)—— 官方 `configValueUtil.getCodeCertificateTimeout()`。
const SCAN_CODE_TTL_SECONDS: i64 = 300;
/// 票据状态:**未登录**(官方 `LoginTicketStatus.UN_LOGIN`)。
const TICKET_STATUS_UN_LOGIN: i32 = 0;
/// 票据状态:**票据失效**(官方 `LoginTicketStatus.INVALID` / `ScanCodeTicketStatus.INVALID`)。
const TICKET_STATUS_INVALID: i32 = 1;
/// 「本极简引擎不支持 X」—— 能力缺失时的**诚实失败**。
///
/// 🔴 **绝不返假数据**:没有文件存储就不能返一个编出来的下载 URL;
/// 没有地图服务就不能返一组编出来的坐标。宁可 `code=400` 说清缺什么。
fn unsupported(what: &str) -> Json<ActionResult> {
fail(code::FAIL, format!("本极简引擎不支持{what}"))
}
// ================================================================ 退出登录
//
// 官方 `LoginController.java:155`(`@PostMapping("/Logout")`)。
/// `POST /api/oauth/Logout` —— 官方 `LoginController.java:155`。
///
/// 🔴 **未登录也返成功**:前端 `store/auth.ts:86` 把 `logoutApi()` 包在
/// `try { … } catch { /* 不做任何处理 */ }` 里,**返回值完全被忽略**;
/// 但它一旦是 **HTTP 404**,会走 `errorMessageResponseInterceptor` 弹一个红条。
/// ⇒ 这里恒 `ok(null)`,无论有没有 token。
///
/// 🔴 **不改变服务端会话状态**:本仓 token 是进程内内存表(`platform/session.rs`),
/// 没有 `revoke` 接口(接口 immutability 见 `SessionStore`)⇒ 登出即「客户端丢弃 token」,
/// 服务端不做失效登记。这是**已知限制 B5**(`docs/known-limitations.md`)。
pub async fn logout_handler(State(state): State<AppState>, headers: HeaderMap) -> Json<ActionResult> {
// 鉴权结果刻意丢弃:有 token ⇒ 走一遍换取无效的分支也已经够了(无 remove 接口)。
let _ = require_login_face_b(&state, &headers).await;
ok(Value::Null)
}
// ================================================================ 登录配置
//
// 官方 `LoginController.java`(`getLoginConfig` / `getConfig`)。
/// `GET /api/oauth/getLoginConfig` —— 登录页配置(**登录前**就拉 ⇒ 不能要 token)。
///
/// 🔴 前端 `views/_core/login/LoginForm.vue:160-163`:`res.data.redirect` ⇒ `data`
/// 必须是**对象**(给 `null` 会 `Cannot read properties of null`)。
pub async fn get_login_config() -> Json<ActionResult> {
ok(json!({}))
}
/// `GET /api/oauth/getConfig/{account}` —— 帐号的登录/锁屏配置(`user.ts:23`)。
pub async fn get_user_config(Path(account): Path<String>) -> Json<ActionResult> {
let _ = account.trim();
ok(json!({}))
}
// ================================================================ 锁屏解锁
//
// 官方 `LoginController.java:130`(`@PostMapping("/LockScreen")`)。
/// `POST /api/oauth/LockScreen` —— 锁屏解锁登录。
///
/// 官方 `LoginController.java:130-146`:
/// ```java
/// UserEntity userEntity = userApi.getUserByAccount(loginForm.getAccount());
/// if (userEntity == null) { …登出… throw new LoginException(MsgCode.FA001.get()); }
/// if (!EncryptUtil.encryptByMd5(loginForm.getPassword().toLowerCase() + userEntity.getSecretkey().toLowerCase())
/// .equals(userEntity.getPassword())) { throw new LoginException(MsgCode.OA020.get()); }
/// return ActionResult.success(MsgCode.SU005.get());
/// ```
///
/// 🔴 **本仓口令存储口径不同**:官方存 `md5(明文 + secretkey)`;本仓存
/// `md5(明文)`(`platform/auth.rs` 的 `decrypt_to_md5` ⇒ 比对 `f_password`)。
/// ⇒ 这里按**本仓口径**做等价校验:把前端传来的密文解成 `md5(明文)` 再比
/// `f_password`。与 `permission.rs` 的 `self_modify_password` 同一口径。
///
/// 🔴 **口令错 ⇒ 账号或密码错误**(不区分「账号不存在」与「口令错」——
/// 官方也分两种码,但前端只弹一句;本仓统一给一句,避免账号枚举)。
pub async fn lock_screen(
State(state): State<AppState>,
body: Bytes,
) -> Json<ActionResult> {
let obj = match super::helper::parse_body(&body) {
Ok(Value::Object(o)) => o,
Ok(_) => return fail(code::FAIL, "请求参数格式错误"),
Err(resp) => return resp,
};
let account = obj
.get("account")
.and_then(Value::as_str)
.unwrap_or_default()
.trim()
.to_string();
let encrypted = obj.get("password").and_then(Value::as_str).unwrap_or_default();
if account.is_empty() || encrypted.is_empty() {
return fail(code::FAIL, "缺少 account / password");
}
let rows = match state
.db
.query_json_params(
"SELECT f_id AS \"id\", COALESCE(f_password, '') AS \"storedPassword\" \
FROM base_user WHERE f_account = $1::text AND f_delete_mark = 0 LIMIT 1",
&[&account],
)
.await
{
Ok(rows) => rows,
Err(e) => return super::helper::db_error(e, "锁屏解锁查询用户"),
};
let Some(row) = rows.first() else {
return fail(code::FAIL, "账号或密码错误");
};
let stored = row
.get("storedPassword")
.and_then(Value::as_str)
.unwrap_or_default();
let plain_md5 = match decrypt_to_md5(encrypted) {
Some(md5) => md5,
None => return fail(code::FAIL, "账号或密码错误"),
};
if stored.is_empty() || !stored.eq_ignore_ascii_case(&plain_md5) {
return fail(code::FAIL, "账号或密码错误");
}
ok(Value::Null)
}
// ================================================================ 免密登录票据
//
// 官方 `LoginController.java:383`(`getTicket`)/ `:398`(`getTicketStatus`)。
/// `GET /api/oauth/getTicket` —— 获取登录票据。
///
/// 官方 `LoginController.java:383-390`:
/// ```java
/// LoginTicketModel ticketModel = new LoginTicketModel();
/// ticketModel.setTicketTimeout(System.currentTimeMillis() + oauthConfig.getTicketTimeout() * 1000);
/// String ticket = TicketUtil.createTicket(ticketModel, oauthConfig.getTicketTimeout());
/// return ActionResult.success(ticketModel.getTicketTimeout().toString(), ticket);
/// ```
///
/// 🔴 **官方 `ActionResult.success(msg, data)` 是两参版**:第一参是 `msg`、
/// 第二参是 `data` ⇒ 本仓必须**照抄这个错位**:有效期进 `msg`、票据进 `data`。
/// (本仓 `envelope::ok(data)` 恒 `msg="成功"` ⇒ 这里得自己造信封。)
///
/// 🔴 官方票据存 Redis ⇒ 本仓**无 Redis** ⇒ 用进程内内存表
/// (`platform/session.rs` 的 `TicketStore`),进程重启即失效。
pub async fn get_ticket(State(state): State<AppState>) -> Json<ActionResult> {
let (ticket, expires_at_ms) = state
.tickets
.issue(TicketKind::Login, TICKET_STATUS_UN_LOGIN, TICKET_TTL_SECONDS);
// 🔴 官方把 `ticketTimeout`(**毫秒时间戳**,不是剩余秒数)放进 `msg`。
Json(ActionResult {
code: code::SUCCESS,
msg: expires_at_ms.to_string(),
data: Value::String(ticket),
})
}
/// `GET /api/oauth/getTicketStatus/{ticket}` —— 查询票据登录状态。
///
/// 官方 `LoginController.java:398-412`:票据解析不出来 ⇒ 返回一张
/// `status = INVALID` 的空模型;能解析出来 ⇒ 返回票据本身。
///
/// 🔴 官方 `LoginTicketModel` 字段:`status` / `value` / `theme` / `ticketTimeout`。
pub async fn get_ticket_status(
State(state): State<AppState>,
Path(ticket): Path<String>,
) -> Json<ActionResult> {
let ticket = ticket.trim().to_string();
let found = state.tickets.get(TicketKind::Login, &ticket);
ok(ticket_value(found))
}
/// 把票据摊成官方 `LoginTicketModel` 的形状。
///
/// 🔴 官方 `LoginTicketModel` 只有 4 个字段(`status`/`value`/`theme`/`ticketTimeout`)
/// ⇒ **不要**多给字段(前端按 `ticketTimeout` 判断过期,多给反而会误导)。
fn ticket_value(found: Option<Ticket>) -> Value {
match found {
Some(t) => json!({
"status": t.status,
"value": t.value,
"theme": t.theme,
"ticketTimeout": t.expires_at_ms,
}),
None => json!({
"status": TICKET_STATUS_INVALID,
"value": "票据失效!",
"theme": "",
"ticketTimeout": 0,
}),
}
}
// ================================================================ 扫码登录凭证
//
// 官方 `LoginController.java:454`(`codeCertificate`)/ `:468`(`codeCertificateStatus`)
// / `:507`(`setCodeCertificateStatus`)。
/// `GET /api/oauth/codeCertificate` —— 生成扫码凭证。
///
/// 官方 `LoginController.java:454-462`:与 `getTicket` 同构 ——
/// `ActionResult.success(超时毫秒串, 凭证串)` ⇒ 同样是 **`msg`=超时、`data`=凭证**。
pub async fn code_certificate(State(state): State<AppState>) -> Json<ActionResult> {
let (ticket, expires_at_ms) = state
.tickets
.issue(TicketKind::ScanCode, TICKET_STATUS_UN_LOGIN, SCAN_CODE_TTL_SECONDS);
Json(ActionResult {
code: code::SUCCESS,
msg: expires_at_ms.to_string(),
data: Value::String(ticket),
})
}
/// `GET /api/oauth/codeCertificateStatus/{ticket}` —— 获取扫码凭证状态。
///
/// 官方 `LoginController.java:468-475`:解析不出来 ⇒ `status = INVALID`。
pub async fn code_certificate_status(
State(state): State<AppState>,
Path(ticket): Path<String>,
) -> Json<ActionResult> {
let ticket = ticket.trim().to_string();
let found = state.tickets.get(TicketKind::ScanCode, &ticket);
ok(ticket_value(found))
}
/// `GET /api/oauth/setCodeCertificateStatus/{ticket}/{status}` —— 更改扫码凭证状态。
///
/// 官方 `LoginController.java:507-519`:改状态 ⇒ 顺带把过期时间**续**上,
/// 然后回吐整张凭证模型。
///
/// 🔴 `status` 是路径上的**整数**(官方 `Integer status`)⇒ 解析失败 ⇒ `code=400`。
pub async fn set_code_certificate_status(
State(state): State<AppState>,
Path((ticket, status)): Path<(String, String)>,
) -> Json<ActionResult> {
let ticket = ticket.trim().to_string();
let status: i32 = match status.trim().parse() {
Ok(v) => v,
Err(_) => return fail(code::FAIL, "扫码凭证状态必须是整数"),
};
let updated = state
.tickets
.update(TicketKind::ScanCode, &ticket, status, "", SCAN_CODE_TTL_SECONDS);
match updated {
Some(t) => ok(ticket_value(Some(t))),
// 🔴 凭证不存在 ⇒ 官方造一张 `INVALID` 的空模型回吐(不报错)。
None => ok(ticket_value(None)),
}
}
// ================================================================ 改密通知
//
// 官方 `LoginController.java:269`(`updatePasswordMessage`)。
/// `POST /api/oauth/updatePasswordMessage` —— 修改密码信息发送。
///
/// 官方 `LoginController.java:269-273`:调 `loginService.updatePasswordMessage()`
/// ⇒ 走**邮件 / 短信**通道把「您的密码即将过期」发给用户。
///
/// 🔴 本仓**无邮件服务、无短信通道** ⇒ 没有提醒可发。
/// 🔴 **但不能返 400**:官方前端 `layouts/header/index.vue:74` 在**每个页面挂载时
/// 无条件调用且没有 catch** ⇒ `code=400` 会变成一条未捕获 Promise 异常。
/// ⇒ 返回 `200 + data:null`,并在 `msg` 里说清「已跳过」,不假装发过。
pub async fn update_password_message() -> Json<ActionResult> {
Json(ActionResult {
code: code::SUCCESS,
msg: "本极简引擎无邮件 / 短信通道,已跳过改密提醒".to_string(),
data: Value::Null,
})
}
// ================================================================ SaaS 多租户
//
// 官方 `LoginController.java:554`(`Login/saas`)/ `:562`(`apply/saas`)
// / `:571`(`mobilecode/saas`)。
/// `POST /api/oauth/Login/saas` —— 多租户登录。
///
/// 官方 `LoginController.java:554-559`:`grant_type=saas` ⇒ 切租户后登录
/// (`TenantSaasGranter.granter` → `checkTenantUser` → `switchTenant`)。
///
/// 🔴 官方 `TenantSaasGranter.checkTenantUser` **要求已有登录态**:
/// `UserProvider.getUser(UserProvider.getAuthorize())` 的 `userId` 为空
/// ⇒ 直接抛 `LoginException(GT105)` ⇒ **这就是「拿主租户身份换关联租户」**。
/// ⇒ 本仓也**必须真的拦**(不能像 `Logout` 那样丢弃 `Err`)。
///
/// 🔴 本仓**无多租户数据源切换**(`base_*` 表只有 `f_tenant_id` 一列,
/// 没有按租户切库的能力)⇒ 过了守卫也**明确失败**。
pub async fn login_saas(State(state): State<AppState>, headers: HeaderMap) -> Json<ActionResult> {
if let Err(resp) = require_login_face_b(&state, &headers).await {
return resp;
}
unsupported("SaaS 多租户登录(没有多租户数据源切换)")
}
/// `GET /api/oauth/mobilecode/saas` —— 租户申请短信验证码。
///
/// 官方 `LoginController.java:571-575`:走**短信通道**。
///
/// 🔴 本仓**无短信通道** ⇒ 如实失败。
pub async fn mobile_code_saas() -> Json<ActionResult> {
unsupported("租户申请短信验证码(没有短信通道)")
}
/// `POST /api/oauth/apply/saas` —— 企业申请接口。
///
/// 官方 `LoginController.java:562-568`:调 `LoginSaasUtil.saasApply(...)`
/// ⇒ 走**外部 SaaS 平台**。
///
/// 🔴 本仓无该外部平台 ⇒ 如实失败。
pub async fn apply_saas() -> Json<ActionResult> {
unsupported("企业申请(没有接入官方 SaaS 平台)")
}
/// `POST /api/oauth/Login/socials` —— 第三方登录回调后点登录。
///
/// 官方走 `LoginController.java:117` 的 `@RequestMapping("/Login/**")` 通配,
/// 由 `SocialsTokenGranter`(`grant_type=socials`)按 `code`/`state`/`source`
/// 去换第三方 token。
///
/// 🔴 本仓**无第三方登录配置**(没有 `base_socials` 之类的第三方账号表)
/// ⇒ 如实失败。
pub async fn socials_login() -> Json<ActionResult> {
unsupported("第三方登录(没有第三方账号配置)")
}
// ================================================================ 文件族
//
// 官方 `jnpf-file` 的 `UtilsController`(`@RequestMapping("/api/file")`):
// `:200` Download/{type}/{fileName} / `:100` PackDownload/{type}
// / `:172` Uploader/{type} / `:295` merge。
//
// 🔴 本仓**无文件存储层**(磁盘 / 对象存储都没有)⇒ 全部如实失败。
/// `GET /api/file/Download/{type}/{fileName}` —— 获取下载文件链接。
///
/// 官方 `UtilsController.java:200-215`:查文件是否存在 ⇒ 存在就返
/// `{name, url}`(`DownloadVO`),不存在就 `fail`。
///
/// 🔴 本仓无文件存储 ⇒ 如实失败(**不返假 URL**)。
pub async fn file_download(
Path((file_type, file_name)): Path<(String, String)>,
) -> Json<ActionResult> {
let _ = (file_type.trim(), file_name.trim());
unsupported("文件下载(没有文件存储)")
}
/// `POST /api/file/PackDownload/{type}` —— 打包下载链接。
///
/// 官方 `UtilsController.java:100-130`:把一批文件打成 zip ⇒ 返 zip 的 id。
///
/// 🔴 本仓无文件存储 ⇒ 如实失败。
pub async fn file_pack_download(Path(file_type): Path<String>) -> Json<ActionResult> {
let _ = file_type.trim();
unsupported("打包下载(没有文件存储)")
}
/// `GET /api/file/Uploader/Preview` —— 预览文件。
///
/// 🔴 **官方 Java 里没有这个端点**(`UtilsController` 只有 `/Uploader/{type}` 与
/// `/Uploader/imgToBase64`)⇒ 官方前端 `api/core/common.ts:21` 声明了但
/// 后端从没有过 ⇒ 记 `oos`。本仓照样给出**明确失败**而不是 404
/// (404 会让官方前端的 `errorMessageResponseInterceptor` 弹红条)。
pub async fn file_uploader_preview() -> Json<ActionResult> {
unsupported("文件预览(没有文件存储)")
}
/// `POST /api/file/merge` —— 分片组装。
///
/// 官方 `UtilsController.java:295-298`:把分片合成一个文件。
///
/// 🔴 本仓无文件存储 ⇒ 如实失败。
pub async fn file_merge() -> Json<ActionResult> {
unsupported("分片组装(没有文件存储)")
}
/// `GET /api/{prefix}/TemplateDownload` —— 下载导入示例模板。
///
/// 官方前端 `api/core/common.ts:29` 用 `/api/${url}/TemplateDownload` 拼地址
/// ⇒ `url` 是**模块名**(`system` / `permission` / `onlineDev` …)。
/// 官方各 Controller 各自有一份(`BaseLangController.java:142`、
/// `VisualdevModelDataController.java:944`、`EmployeeController.java:208` …)。
///
/// 🔴 本仓**没有导入模板文件** ⇒ 如实失败。
pub async fn template_download(Path(prefix): Path<String>) -> Json<ActionResult> {
let _ = prefix.trim();
unsupported("导入示例模板下载(没有模板文件)")
}
/// `GET /api/{prefix}/ImportPreview` —— 导入预览。
///
/// 官方前端 `api/core/common.ts:33`;官方各模块 Controller 各自有一份
/// (`VisualdevModelDataController.java:1000`、`EmployeeController.java:382`、
/// `OrganizeController.java:464` …)。
///
/// 🔴 本仓无导入预览能力 ⇒ 如实失败。
pub async fn import_preview(Path(prefix): Path<String>) -> Json<ActionResult> {
let _ = prefix.trim();
unsupported("导入预览(没有导入引擎)")
}
/// `POST /api/{prefix}/ImportData` —— 导入数据。
///
/// 官方前端 `api/core/common.ts:37`;官方各模块 Controller 各自有一份
/// (`VisualdevModelDataController.java:733`、`BaseLangController.java:182` …)。
///
/// 🔴 本仓无导入引擎 ⇒ 如实失败。
pub async fn import_data(Path(prefix): Path<String>) -> Json<ActionResult> {
let _ = prefix.trim();
unsupported("导入数据(没有导入引擎)")
}
/// `POST /api/{prefix}/ImportExceptionData` —— 导入异常数据。
///
/// 官方前端 `api/core/common.ts:41`;官方 `VisualdevModelDataController.java:1073`。
///
/// 🔴 本仓无导入引擎 ⇒ 如实失败。
pub async fn import_exception_data(Path(prefix): Path<String>) -> Json<ActionResult> {
let _ = prefix.trim();
unsupported("导入异常数据(没有导入引擎)")
}
// ================================================================ 地图族
//
// 官方 `jnpf-system` 的 `LocationController`(`@RequestMapping("/api/system/Location")`):
// `:32` around / `:47` text / `:62` inputtips —— 三个都是**转发高德 REST API**
// (`https://restapi.amap.com/v3/...`)。
//
// 🔴 本仓**没有高德 key**,而且**没有 HTTP 客户端依赖**(`Cargo.toml` 里无
// `reqwest` / `ureq`)⇒ 转发不了 ⇒ 如实失败(**不返编出来的坐标**)。
/// `GET /api/system/Location/around` —— 查询附近数据。
///
/// 官方 `LocationController.java:32-45`:转发高德 `place/around`。
///
/// 🔴 本仓无地图服务 ⇒ 如实失败。
pub async fn location_around(raw: RawQuery) -> Json<ActionResult> {
let _ = &raw;
unsupported("附近地点查询(没有地图服务)")
}
/// `GET /api/system/Location/text` —— 按关键字查询附近数据。
///
/// 官方 `LocationController.java:47-60`:转发高德 `place/text`。
///
/// 🔴 本仓无地图服务 ⇒ 如实失败。
pub async fn location_text(raw: RawQuery) -> Json<ActionResult> {
let _ = &raw;
unsupported("地点关键字查询(没有地图服务)")
}
/// `GET /api/system/Location/inputtips` —— 输入提示。
///
/// 官方 `LocationController.java:62-75`:转发高德 `assistant/inputtips`。
///
/// 🔴 本仓无地图服务 ⇒ 如实失败。
pub async fn location_input_tips(raw: RawQuery) -> Json<ActionResult> {
let _ = &raw;
unsupported("地点输入提示(没有地图服务)")
}
pub use sspf_compat_system::core::*;
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
+4 -426
View File
@@ -1,427 +1,5 @@
//! scheduletask —— 官方面 B 的 **scheduletask** 端点集(`/api/scheduletask/*`)。
//!
//! 真源:官方 Java `jnpf-scheduletask` + 官方前端 `src/api/system/task.ts`。
//! scheduletask —— **转发壳**:真源在 [`sspf_compat_system::scheduletask`](M4 契约面「system」域下沉)。
//! 🔴 只做转发、不含实现;路由注册 `compat::scheduletask::…` 不用改。
//! 为什么留壳、闸门怎么改:见 `docs/CRATES-MIGRATION.md` §4 M4。
use axum::body::Bytes;
use axum::extract::{Path, RawQuery, State};
use axum::http::HeaderMap;
use axum::Json;
use serde_json::{json, Map, Value};
use crate::platform::envelope::{code, fail, ok, ActionResult};
use crate::platform::ids::new_uuid;
use crate::platform::state::AppState;
use super::helper::{Paging, db_error, guard, int_field, page_list, params_of, parse_body, text_field};
/// 官方 `@SaCheckPermission("sysService.task")`(任务调度)。
const EN_TASK: &str = "sysService.task";
/// 任务列表投影。
const TASK_LIST_PROJECTION: &str = "f_id AS \"id\", f_full_name AS \"fullName\", \
COALESCE(f_en_code, '') AS \"enCode\", COALESCE(f_execute_type, 1)::bigint AS \"executeType\", \
COALESCE(f_run_count, 0)::bigint AS \"runCount\", \
COALESCE(f_enabled_mark, 0)::bigint AS \"enabledMark\", \
COALESCE(f_sort_code, 0)::bigint AS \"sortCode\", f_description AS \"description\", \
(EXTRACT(EPOCH FROM f_last_run_time) * 1000)::bigint AS \"lastRunTime\", \
(EXTRACT(EPOCH FROM f_next_run_time) * 1000)::bigint AS \"nextRunTime\", \
COALESCE(f_execute_content, '') AS \"executeContentRaw\"";
/// `f_execute_content` 是 TEXT,内容约定是 JSON 对象(官方前端提交的就是对象)。
///
/// 解析不出来时**不丢数据**:包成 `{"cron": <原文>}`,至少还能回显。
fn exec_content_object(raw: &str) -> Map<String, Value> {
let text = raw.trim();
if text.is_empty() {
return Map::new();
}
match serde_json::from_str::<Value>(text) {
Ok(Value::Object(obj)) => obj,
Ok(other) => {
let mut obj = Map::new();
obj.insert("cron".to_string(), other);
obj
}
Err(_) => {
let mut obj = Map::new();
obj.insert("cron".to_string(), json!(text));
obj
}
}
}
/// 把一行任务摊平成列表项:`executeContent` 里的 `startTime` / `endTime` **提到顶层**。
///
/// 🔴 官方列表的 `startTime` / `endTime` 来自 XXL-JOB 的调度配置;本仓登记在
/// `executeContent` 里 ⇒ 必须提出来,否则前端那一列表头永远是空的。
fn shape_task_row(mut row: Value) -> Value {
let Some(obj) = row.as_object_mut() else {
return row;
};
let raw = obj
.remove("executeContentRaw")
.and_then(|v| v.as_str().map(str::to_string))
.unwrap_or_default();
let content = exec_content_object(&raw);
let start = content.get("startTime").cloned().unwrap_or(Value::Null);
let end = content.get("endTime").cloned().unwrap_or(Value::Null);
obj.insert("startTime".to_string(), start);
obj.insert("endTime".to_string(), end);
obj.insert("executeContent".to_string(), Value::Object(content));
row
}
/// `GET /api/scheduletask` —— 任务列表(分页 + 关键词)。
pub async fn task_list(
State(state): State<AppState>,
headers: HeaderMap,
raw: RawQuery,
) -> Json<ActionResult> {
if let Err(resp) = guard(&state, &headers, EN_TASK).await {
return resp;
}
let page = Paging::of(&raw);
let keyword = crate::platform::sys::query_param(&raw, "keyword")
.trim()
.to_string();
let mut conds = vec!["COALESCE(f_delete_mark, 0) = 0".to_string()];
let mut values: Vec<Option<String>> = Vec::new();
if !keyword.is_empty() {
values.push(Some(format!("%{keyword}%")));
let n = values.len();
conds.push(format!(
"(f_full_name ILIKE ${n}::text OR f_en_code ILIKE ${n}::text)"
));
}
let where_sql = conds.join(" AND ");
let total_sql = format!("SELECT COUNT(*)::bigint AS \"total\" FROM base_time_task WHERE {where_sql}");
let total = match state
.db
.query_json_params(&total_sql, &params_of(&values))
.await
{
Ok(rows) => rows
.first()
.and_then(|r| r.get("total"))
.and_then(Value::as_i64)
.unwrap_or(0),
Err(e) => return db_error(e, "任务计数"),
};
values.push(Some(page.page_size.to_string()));
let limit_at = values.len();
values.push(Some(page.offset.to_string()));
let offset_at = values.len();
let sql = format!(
"SELECT {TASK_LIST_PROJECTION} FROM base_time_task WHERE {where_sql} \
ORDER BY COALESCE(f_sort_code, 0) ASC, f_creator_time DESC NULLS LAST \
LIMIT ${limit_at}::text::integer OFFSET ${offset_at}::text::integer"
);
let rows = match state.db.query_json_params(&sql, &params_of(&values)).await {
Ok(rows) => rows,
Err(e) => return db_error(e, "任务列表查询"),
};
let list: Vec<Value> = rows.into_iter().map(shape_task_row).collect();
ok(page_list(page.current_page, page.page_size, total, list))
}
/// `GET /api/scheduletask/Info/{id}` —— 任务详情(`executeContent` 是**对象**)。
pub async fn task_info(
State(state): State<AppState>,
headers: HeaderMap,
Path(id): Path<String>,
) -> Json<ActionResult> {
if let Err(resp) = guard(&state, &headers, EN_TASK).await {
return resp;
}
let rows = match state
.db
.query_json_params(
&format!(
"SELECT {TASK_LIST_PROJECTION} FROM base_time_task \
WHERE f_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1"
),
&[&id.trim()],
)
.await
{
Ok(rows) => rows,
Err(e) => return db_error(e, "任务详情查询"),
};
let Some(row) = rows.into_iter().next() else {
return fail(code::FAIL, "任务不存在");
};
ok(shape_task_row(row))
}
/// `GET /api/scheduletask/TaskMethods` —— 本地任务方法清单。
///
/// 🔴 **官方这份清单来自 XXL-JOB 的执行器注册表**(`restScheduleTaskUtil.getHandlerList`),
/// 本仓没有执行器 ⇒ **空清单**。为什么不返 `fail`:任务表单的「方法选择」
/// 下拉要靠它,返错会让整个新建表单红条;空数组只是**选项为空**(如实)。
pub async fn task_methods(
State(state): State<AppState>,
headers: HeaderMap,
) -> Json<ActionResult> {
if let Err(resp) = guard(&state, &headers, EN_TASK).await {
return resp;
}
ok(json!({ "list": [] }))
}
/// `GET /api/scheduletask/{id}/TaskLog` —— 任务执行日志(分页)。
pub async fn task_log_list(
State(state): State<AppState>,
headers: HeaderMap,
Path(id): Path<String>,
raw: RawQuery,
) -> Json<ActionResult> {
if let Err(resp) = guard(&state, &headers, EN_TASK).await {
return resp;
}
let page = Paging::of(&raw);
let task_id = id.trim().to_string();
let total = match state
.db
.query_json_params(
"SELECT COUNT(*)::bigint AS \"total\" FROM base_time_task_log \
WHERE f_task_id = $1::text AND COALESCE(f_delete_mark, 0) = 0",
&[&task_id],
)
.await
{
Ok(rows) => rows
.first()
.and_then(|r| r.get("total"))
.and_then(Value::as_i64)
.unwrap_or(0),
Err(e) => return db_error(e, "任务日志计数"),
};
let size = page.page_size.to_string();
let offset = page.offset.to_string();
let rows = match state
.db
.query_json_params(
"SELECT f_id AS \"id\", f_task_id AS \"taskId\", \
(EXTRACT(EPOCH FROM f_run_time) * 1000)::bigint AS \"runTime\", \
COALESCE(f_run_result, 0)::bigint AS \"runResult\", \
f_description AS \"description\" \
FROM base_time_task_log \
WHERE f_task_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 \
ORDER BY f_run_time DESC NULLS LAST \
LIMIT $2::text::integer OFFSET $3::text::integer",
&[&task_id, &size, &offset],
)
.await
{
Ok(rows) => rows,
Err(e) => return db_error(e, "任务日志查询"),
};
ok(page_list(page.current_page, page.page_size, total, rows))
}
/// `POST /api/scheduletask` —— 新建任务(**登记**,不执行)。
pub async fn task_create(
State(state): State<AppState>,
headers: HeaderMap,
body: Bytes,
) -> Json<ActionResult> {
let user = match guard(&state, &headers, EN_TASK).await {
Ok(u) => u,
Err(resp) => return resp,
};
let obj = match parse_body(&body) {
Ok(Value::Object(o)) => o,
Ok(_) => return fail(code::FAIL, "请求参数格式错误"),
Err(resp) => return resp,
};
let Some(full_name) = text_field(&obj, "fullName") else {
return fail(code::FAIL, "任务名称不能为空");
};
let Some(en_code) = text_field(&obj, "enCode") else {
return fail(code::FAIL, "任务编码不能为空");
};
let dup = state
.db
.query_json_params(
"SELECT f_id AS \"id\" FROM base_time_task \
WHERE f_en_code = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1",
&[&en_code],
)
.await;
match dup {
Ok(rows) if !rows.is_empty() => return fail(code::FAIL, "任务编码已存在"),
Ok(_) => {}
Err(e) => return db_error(e, "任务编码查重"),
}
// `executeContent` 缺省也给 `{}`(官方 `@Valid` 要求 cron/startTime,但本仓不执行 ⇒ 不强制)
let content = match obj.get("executeContent") {
Some(Value::Object(o)) => Value::Object(o.clone()),
_ => json!({}),
};
let id = new_uuid();
let execute_type = int_field(&obj, "executeType").unwrap_or(1).to_string();
let enabled_mark = int_field(&obj, "enabledMark").unwrap_or(1).to_string();
let sort_code = int_field(&obj, "sortCode").unwrap_or(0).to_string();
let description = text_field(&obj, "description").unwrap_or_default();
let content_text = content.to_string();
let values: Vec<Option<String>> = vec![
Some(id.clone()),
Some(en_code),
Some(full_name),
Some(execute_type),
Some(content_text),
Some(description),
Some(sort_code),
Some(enabled_mark),
Some(user.account.clone()),
];
if let Err(e) = state
.db
.exec_params(
"INSERT INTO base_time_task \
(f_id, f_en_code, f_full_name, f_execute_type, f_execute_content, f_description, \
f_run_count, f_sort_code, f_enabled_mark, f_delete_mark, f_tenant_id, \
f_creator_time, f_creator_user_id) \
VALUES ($1::text, $2::text, $3::text, $4::text::integer, $5::text, $6::text, \
0, $7::text::bigint, $8::text::integer, 0, '0', now(), $9::text)",
&params_of(&values),
)
.await
{
return db_error(e, "新建任务");
}
ok(json!({ "id": id }))
}
/// `PUT /api/scheduletask/{id}` —— 更新任务(只改 body 里出现的键)。
pub async fn task_update(
State(state): State<AppState>,
headers: HeaderMap,
Path(id): Path<String>,
body: Bytes,
) -> Json<ActionResult> {
let user = match guard(&state, &headers, EN_TASK).await {
Ok(u) => u,
Err(resp) => return resp,
};
let id = id.trim().to_string();
let obj = match parse_body(&body) {
Ok(Value::Object(o)) => o,
Ok(_) => return fail(code::FAIL, "请求参数格式错误"),
Err(resp) => return resp,
};
let existed = match state
.db
.query_json_params(
"SELECT f_id AS \"id\" FROM base_time_task \
WHERE f_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1",
&[&id],
)
.await
{
Ok(rows) => !rows.is_empty(),
Err(e) => return db_error(e, "任务查询"),
};
if !existed {
return fail(code::FAIL, "任务不存在");
}
if let Some(en_code) = text_field(&obj, "enCode") {
let dup = state
.db
.query_json_params(
"SELECT f_id AS \"id\" FROM base_time_task \
WHERE f_en_code = $1::text AND f_id <> $2::text \
AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1",
&[&en_code, &id],
)
.await;
match dup {
Ok(rows) if !rows.is_empty() => return fail(code::FAIL, "任务编码已存在"),
Ok(_) => {}
Err(e) => return db_error(e, "任务编码查重"),
}
}
let mut sets: Vec<String> = Vec::new();
let mut values: Vec<Option<String>> = Vec::new();
for (key, column) in [
("fullName", "f_full_name"),
("enCode", "f_en_code"),
("description", "f_description"),
] {
if let Some(v) = text_field(&obj, key) {
values.push(Some(v));
sets.push(format!("{column} = ${}::text", values.len()));
}
}
for (key, column) in [
("executeType", "f_execute_type"),
("enabledMark", "f_enabled_mark"),
("sortCode", "f_sort_code"),
] {
if let Some(v) = int_field(&obj, key) {
values.push(Some(v.to_string()));
sets.push(format!("{column} = ${}::text::bigint", values.len()));
}
}
if let Some(Value::Object(content)) = obj.get("executeContent") {
values.push(Some(Value::Object(content.clone()).to_string()));
sets.push(format!("f_execute_content = ${}::text", values.len()));
}
if sets.is_empty() {
return fail(code::FAIL, "没有需要更新的字段");
}
values.push(Some(user.account.clone()));
let user_at = values.len();
values.push(Some(id.clone()));
let id_at = values.len();
let sql = format!(
"UPDATE base_time_task SET {}, f_last_modify_time = now(), \
f_last_modify_user_id = ${user_at}::text WHERE f_id = ${id_at}::text",
sets.join(", ")
);
if let Err(e) = state.db.exec_params(&sql, &params_of(&values)).await {
return db_error(e, "更新任务");
}
ok(json!({ "id": id }))
}
/// `DELETE /api/scheduletask/{id}` —— 删除任务(软删)。
pub async fn task_delete(
State(state): State<AppState>,
headers: HeaderMap,
Path(id): Path<String>,
) -> Json<ActionResult> {
if let Err(resp) = guard(&state, &headers, EN_TASK).await {
return resp;
}
let id = id.trim().to_string();
let existed = match state
.db
.query_json_params(
"SELECT f_id AS \"id\" FROM base_time_task \
WHERE f_id = $1::text AND COALESCE(f_delete_mark, 0) = 0 LIMIT 1",
&[&id],
)
.await
{
Ok(rows) => !rows.is_empty(),
Err(e) => return db_error(e, "任务查询"),
};
if !existed {
return fail(code::FAIL, "任务不存在");
}
if let Err(e) = state
.db
.exec_params(
"UPDATE base_time_task SET f_delete_mark = 1, f_delete_time = now() \
WHERE f_id = $1::text",
&[&id],
)
.await
{
return db_error(e, "删除任务");
}
ok(Value::Null)
}
pub use sspf_compat_system::scheduletask::*;
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff