From 1c224b7b79da3d92aaef52ca30d74f8c142a1622 Mon Sep 17 00:00:00 2001 From: admin Date: Mon, 2 Nov 2026 17:34:03 +0800 Subject: [PATCH] =?UTF-8?q?feat(core):=20=E8=A1=A5=E9=BD=90=20core=20?= =?UTF-8?q?=E6=97=8F=2022=20=E6=9D=A1=E7=AB=AF=E7=82=B9=E5=B9=B6=E5=90=8C?= =?UTF-8?q?=E6=AD=A5=E5=A5=91=E7=BA=A6=E4=B8=89=E5=A4=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 按官方三源(LoginController / UtilsController / LocationController + 官方前端 api/core/*.ts)逐条核对,实现 22 条 core 端点: - 真实现 6 条:锁屏解锁、免密登录票据、扫码凭证状态流转 - 诚实失败 16 条:文件族 4 + 导入族 4 + 地图族 3 + 改密通知 1 + SaaS 族 3 + socials 1(无文件存储 / 无导入引擎 / 无地图服务 / 无邮件短信通道 / 无多租户切库 / 无第三方账号 ⇒ code=400 + 人话, 不返假 URL、不返假坐标) 新增 TicketStore(进程内内存票据表,官方用 Redis 而本仓无 Redis): 两种票据带前缀隔离(tkt- / scc-),不互相串用。 同批修掉一个真偏差:Login/saas 原先写成 let _ = require_login_face_b(..) 丢弃了 Err ⇒ 实际不拦,但静态闸门推成「登录」⇒ 契约标签与运行时行为 不符;已改成真拦(官方 TenantSaasGranter.checkTenantUser 要求已有登录态)。 契约三处同步:[ENDPOINT] +22 / [OFFICIAL] +22 / [FACE] 面 B 558→580, 并顺手修正契约 §6 头两个无人校验的散文数字(132→610 条、53→607 行)。 --- .workbuddy/memory/2026-11-02.md | 80 ++++ HANDOFF.md | 105 ++++- docs/contract.md | 51 ++- scripts/gen-contract-endpoints.py | 140 ++++++- src/backend/src/main.rs | 3 +- src/backend/src/platform/compat/core.rs | 458 ++++++++++++++++++++- src/backend/src/platform/session.rs | 142 +++++++ src/backend/src/platform/state.rs | 10 +- src/backend/src/routes.rs | 55 ++- src/backend/tests/auth_it.rs | 3 +- src/backend/tests/batch10_it.rs | 3 +- src/backend/tests/batch11_it.rs | 3 +- src/backend/tests/batch13_it.rs | 3 +- src/backend/tests/batch14_it.rs | 3 +- src/backend/tests/batch15_it.rs | 3 +- src/backend/tests/batch16_it.rs | 3 +- src/backend/tests/batch17_it.rs | 3 +- src/backend/tests/batch18_it.rs | 502 ++++++++++++++++++++++++ src/backend/tests/batch2_it.rs | 3 +- src/backend/tests/batch3_it.rs | 3 +- src/backend/tests/batch4_it.rs | 3 +- src/backend/tests/batch5_it.rs | 3 +- src/backend/tests/batch6_it.rs | 3 +- src/backend/tests/batch7_it.rs | 3 +- src/backend/tests/batch8_it.rs | 3 +- src/backend/tests/batch9_it.rs | 3 +- src/backend/tests/crud_it.rs | 3 +- src/backend/tests/pack_smoke_it.rs | 3 +- src/backend/tests/self_it.rs | 3 +- src/backend/tests/sys_it.rs | 3 +- 30 files changed, 1560 insertions(+), 46 deletions(-) create mode 100644 src/backend/tests/batch18_it.rs diff --git a/.workbuddy/memory/2026-11-02.md b/.workbuddy/memory/2026-11-02.md index e1adcbc..603f430 100644 --- a/.workbuddy/memory/2026-11-02.md +++ b/.workbuddy/memory/2026-11-02.md @@ -243,3 +243,83 @@ - `core` 22 条 / `workFlow` 104 条(下一批做 core) - 暂缓:aiCenter 75 / extend 64 / msgCenter 50 / teamwork 40 - ⏸️ 批次 17 的代码与文档**还没 git commit** + +--- + +## 批次 18 —— core 族 22 条(2026-11-02 续) + +### 官方三源核对结论 +- 官方前端 `api/core/{auth,common,user}.ts` 共 **27 条**声明,但**全是「只有声明、没有消费点」** + ⇒ **形状只能以官方 Java 为准**。 +- 官方 Java 出处:`LoginController.java`(类级 `/api/oauth`,`:117` 是 `@RequestMapping("/Login/**")` **通配** + ⇒ 由 `grant_type` 分流 `password`/`saas`/`socials`/`scancode`)+ + `UtilsController.java`(类级 `/api/file`)+ `LocationController.java`(类级 `/api/system/Location`, + 三个都**转发高德 REST API**)。 +- 🔴 **官方 `/api/file/Uploader/Preview` 是有 Java 出处的**(`UtilsController.java:277`)—— + 先前判「官方 Java 没有 Preview」是**错的**,已改回 `implemented/partial` + 出处指 Java。 +- 🔴 **导入族是「一份路径、多份 Controller」**(官方前端 `/api/${url}/Xxx` 拼,url 是模块名) + ⇒ `[OFFICIAL]` 的 `src` 指其中一份即可(`VisualdevModelDataController.java:944/1000/733/1073`)。 + +### 三类落地(22 条) +- **真实现 6 条**:`LockScreen` / `getTicket` / `getTicketStatus/{ticket}` / + `codeCertificate` / `codeCertificateStatus/{ticket}` / `setCodeCertificateStatus/{ticket}/{status}` +- **诚实失败 16 条**:文件族 4(无文件存储)+ 导入族 4(无导入引擎/模板文件)+ + 地图族 3(无高德 key **且 `Cargo.toml` 里无任何 HTTP 客户端**)+ + 改密通知 1(无邮件/短信通道)+ SaaS 族 3(无多租户切库/无短信/无官方 SaaS 平台)+ + `socials` 1(无第三方账号配置) +- 🔴 **一律 `code=400` + `data:null` + 人话,不返假 URL、不返假坐标、不假装发成功。** + +### 🔴 新增基础设施:`TicketStore`(`platform/session.rs`) +- 官方票据存 **Redis** ⇒ 本仓无 Redis ⇒ 照 `SessionStore` 同款做**进程内内存表** + (`Arc>>`),**进程重启即失效**(不假装跨重启)。 +- 🔴 **两种票据不能串用**(官方也是两张不同的 Redis key)⇒ + `TicketKind::Login`(前缀 `tkt-`)/ `TicketKind::ScanCode`(前缀 `scc-`), + 查表时**种类不符当作不存在**。 +- `AppState` 加 `tickets: Arc` 字段 ⇒ **22 个构造点**(18 个测试 + `routes.rs` + `main.rs`)全补齐。 + +### 🔴🔴 本批修掉的真偏差:「丢弃 `Err` 的守卫」 +`let _ = require_login_face_b(&state, &headers).await;` —— +**编译过、闸门全绿,静态闸门把这条推成「登录」,但运行时其实不拦**(`Err` 被丢了) +⇒ **契约标签与运行时行为不符**。 +- `Login/saas`:官方 `TenantSaasGranter.checkTenantUser` 里 + `UserProvider.getUser().getUserId()` 为空 ⇒ 直接抛 `LoginException(GT105)` + ⇒ **官方确实要求已有登录态** ⇒ 已改成 `if let Err(resp) = .. { return resp; }`。 +- `Logout`:官方 `logout` 是 `@NoDataSourceBind` ⇒ 未登录也返成功(前端 + `store/auth.ts:86` 把返回值完全忽略、但 404 会弹红条)⇒ **刻意**丢弃 `Err`(恒 200), + 已用测试 `logout_succeeds_without_login_state` 钉住 ⇒ **别再当 bug 改掉**。 + +### 🔴 官方 `ActionResult.success(msg, data)` 是「先 msg 后 data」 +官方 `LoginController.java:383-390`:`success(ticketModel.getTicketTimeout().toString(), ticket)` +⇒ **有效期(13 位毫秒时间戳)进 `msg`、票据进 `data`** —— 与本仓 `envelope::ok(data)` 恒 `msg="成功"` **相反** +⇒ 这类端点**不能**用 `ok(..)`,得**自己造信封**。 + +### 🔴 官方 `LoginTicketModel` 恰好 4 字段 +`status`/`value`/`theme`/`ticketTimeout` ⇒ **不要多给**(前端按 `ticketTimeout` 判断过期)。 +**查不到票据 ⇒ 返 `status=1`(INVALID)而不是报错**(官方 `LoginController.java:398-404` 照常返回空模型)。 + +### 契约三处同步 +- `scripts/gen-contract-endpoints.py` 扩了 core 支持:`_CORE_CONTROLLERS`(3 个 Controller,18 条)+ + `CORE_FRONTEND_OR_INDIRECT`(`socials` ⇒ `LoginController.java:117`)+ + `_CORE_IMPORT_SOURCES`(导入族 4 条)+ `PARTIAL_NOTES` 的 22 条 core 说明 + + `MODULE_ORDER` 加 `"core"` + `DEFAULT_NOTES` 加 `"core"` + `official_entry()` 加 core 分支。 +- `[ENDPOINT]` **+22 条**、`[OFFICIAL]` **+22 条**;`[FACE]` 的面 B **558 → 580**。 +- 🔴 **顺手修了契约 §6 头的两个散文数字**(`**132** 条` / `53 行`)—— 没人校验 ⇒ 一直在漂 + ⇒ 改成真值 **610 / 607**。 + +### 新增集成测试(`tests/batch18_it.rs`,8 → 10 个) +22 条端点逐条打一遍(防 `matchit` 同位置参数名冲突 ⇒ **启动即 panic**,静态看不出来)+ +票据 `msg`/`data` 错位 + 未知票据返 INVALID + 扫码状态流转 + 两类票据不串用 + +锁屏解锁 + 16 条诚实失败 + `saas_login_requires_login_state` + `logout_succeeds_without_login_state`。 + +### 数字 +- 契约端点 **610 条**(面 A 28 + 面 B **580** + AB 2) +- `batch18_it` **10 passed / 0 failed**;`cargo test --offline --workspace` 全绿 0 failed +- `check-contract` **PASS=10 FAIL=0**(反自证 12 例全过) +- `verify.sh --fast` 全 ✅(86.4s / 8 步) +- `fe-gap` 合计 **563/900(62.6%)**;**`core` 27/27 = 100%**(上轮 541/900 = 60.1%) +- 官方覆盖 **596/602**(implemented 475 / partial 121 / absent 6;oos 4 单列) + +### 剩余 +- **`workFlow` 104 条**(`fe-gap` 0/104)—— 官方在 `jnpf-flowable`,依赖 **Flowable 引擎** + ⇒ 大概率一批「诚实失败」端点 + 流程定义元数据落库 +- 暂缓:aiCenter 75 / extend 64 / msgCenter 50 / teamwork 40 diff --git a/HANDOFF.md b/HANDOFF.md index 474f677..0026103 100644 --- a/HANDOFF.md +++ b/HANDOFF.md @@ -351,18 +351,31 @@ React 模板的加模块成本 = **改/加 8 个文件、15~20 分钟**(`HOWTO --- -## 1. 一句话现状(2026-11-02 批次 17 收尾 + 契约对齐补修) +## 1. 一句话现状(2026-11-02 批次 18 —— core 族 22 条收尾) **📌 当前数字(以此为准,下面各批的「当时数字」仅存档)**: -- 契约端点 **588 条**(面 A 28 + 面 B **558** + 两面共用 2);`tables` → **67** +- 契约端点 **610 条**(面 A 28 + 面 B **580** + 两面共用 2);`tables` → **67** (`BASE_TABLES` 64;批次 17 新增 `report_template` + `report_version` 两张**官方 DDL 逐字导入**的表)。 - `cargo test --offline --workspace` = **全绿 0 failed**(主 lib 105 passed; - `batch17_it` **11 passed**)。 -- 十二道闸门全绿;`check-contract` `PASS=10 FAIL=0`,官方端点覆盖 **574/580** - (implemented 469 / partial 105 / absent 6;oos 4 单列)。 -- `python3 scripts/fe-gap.py`:合计 **541 / 900(60.1%)**、**`onlineDev` 100/101(99.0%)**、 - **`permission` 137/137(100%)**、**`system` 196/196(100%)**、**`systemData` 103/106(97.2%)**。 + `batch18_it` **10 passed**)。 +- 十二道闸门全绿;`check-contract` `PASS=10 FAIL=0`,官方端点覆盖 **596/602** + (implemented 475 / partial 121 / absent 6;oos 4 单列)。 +- `python3 scripts/fe-gap.py`:合计 **563 / 900(62.6%)**、**`core` 27/27(100%)**、 + **`onlineDev` 100/101(99.0%)**、**`permission` 137/137(100%)**、 + **`system` 196/196(100%)**、**`systemData` 103/106(97.2%)**。 +- 🔴 **批次 18 把 core 族做完了**(官方 `api/core/{auth,common,user}.ts` 共 **27 条** + ⇒ 本仓落 **22 条端点**;`fe-gap` 的 `core` 列 **100%**)。 + 三类落地:**真实现 6 条**(锁屏解锁 / 免密票据 / 扫码凭证 4 条)、 + **诚实失败 16 条**(文件族 4 + 导入族 4 + 地图族 3 + 改密通知 1 + SaaS 族 3 + socials 1), + **没有一条返假数据**(不返假 URL、不返假坐标、不假装发成功)。 + 🔴 **票据是本仓新增的内存表**(`platform/session.rs` 的 `TicketStore`): + 官方存 Redis ⇒ 本仓无 Redis ⇒ 照 `SessionStore` 同款做进程内表(进程重启即失效)。 + **两种票据不能串用**(`tkt-` / `scc-` 前缀)—— 官方也是两张不同的 Redis key。 + 同批还修掉一个**真偏差**:`Login/saas` 原先写成 `let _ = require_login_face_b(..)` + ⇒ **丢弃了 `Err` ⇒ 实际不拦**,但静态闸门把它推成「登录」⇒ 契约标签与运行时行为不符 + ⇒ 已改成 `if let Err(resp) = .. { return resp; }`(官方 `TenantSaasGranter.checkTenantUser` + 明确要求已有登录态)。详见 §5「批次 18 新增的坑」。 - 🔴 **批次 17 收尾补修:3 处「引用了官方 DDL 里不存在的列」的 SQL 已修** (`base_visual_release.f_platform_release` / `base_system.f_app_key`+`f_app_name` / `base_notice.f_full_name`)⇒ 这 3 条**静态闸门全绿时也是坏的**,只有真跑才炸 @@ -1269,12 +1282,20 @@ xop run --secret GU=git_local_user --secret GP=git_local_pass -- bash -c ' `fe-gap` 的 `onlineDev` 列 22/101 → **100/101(99.0%)**。 🔴 剩的 1 条是 `docs/fe/endpoints.tsv` 的**旧记录**(官方实际无路径参数)⇒ **不是待办**。 🔴 契约登记已**自动生成**(`scripts/gen-contract-endpoints.py`)⇒ 以后加端点不用手抄。 - 14. 🔴 **`core` 22 条**(`fe-gap` 现在 `core` 5/27 = 18.5%)—— 下一批优先。 + 14. ~~`core` 22 条~~ + ✅ **批次 18 做完(实际 22 条端点,`fe-gap` 的 `core` 列 5/27 → **27/27 = 100%**)**—— + 真实现 6 条(锁屏解锁 / 免密票据 2 条 / 扫码凭证 3 条)+ **诚实失败 16 条** + (文件族 4 + 导入族 4 + 地图族 3 + 改密通知 1 + SaaS 族 3 + socials 1)。 + 🔴 新增 `TicketStore`(进程内内存票据表,官方用 Redis ⇒ 本仓无 Redis ⇒ 进程重启即失效); + **两种票据不串用**(`tkt-` / `scc-` 前缀)。 + 🔴 同批修掉一个**真偏差**:`Login/saas` 原先 `let _ = require_login_face_b(..)` + ⇒ **丢弃 `Err` ⇒ 实际不拦**,但静态闸门推成「登录」⇒ 已改成真拦(官方 + `TenantSaasGranter.checkTenantUser` 要求已有登录态)。 15. 🔴 **`workFlow` 104 条**(`fe-gap` 现在 0/104)—— 官方在 `jnpf-flowable`, 依赖 **Flowable 引擎** ⇒ 大概率需要一批「诚实失败」端点 + 流程定义元数据落库。 16. ⏸️ **暂缓**(用户 2026-11-02 决定):`aiCenter` 75 / `extend` 64 / `msgCenter` 50 / `teamwork` 40。 - 17. ⏸️ **onlineDev 集成测试**(`tests/batch17_it.rs` 尚未写)—— 静态尺子已全绿, - 但 **`matchit` 同位置参数名冲突**这类错静态看不出来(批次 12 踩过)⇒ + 17. ✅ **onlineDev 集成测试已写**(`tests/batch17_it.rs`,**11 passed**)—— + `matchit` 同位置参数名冲突这类错静态看不出来(批次 12 踩过)⇒ 新端点族落地后**必须**跑一次集成测试。 ### 🔴🔴 批次 12(下一轮优先做)—— 「框架固定包 + 业务模块链接就好」 @@ -1867,6 +1888,70 @@ ENC_BIN="$PWD/target/debug/ssw-platform" bash scripts/perm-smoke-jnpf.sh category/coverImage/excerpt/lastModifyTime/lastModifyUserId` ⇒ `base_notice.f_description` 要投影成 **`excerpt`**(官方 `NoticeEntity.f_description` ⇒ `excerpt`)。 +### 批次 18 新增的坑(core 族 22 条) + +- 🔴🔴 **「丢弃 `Err` 的守卫」会让静态标签与运行时行为不一致**: + `let _ = require_login_face_b(&state, &headers).await;` —— **编译过、闸门全绿**, + 静态闸门把这条推成「登录」,但**运行时其实不拦**(`Err` 被丢了)。 + ⇒ 契约里写着「登录」,实际却是公开端点 ⇒ **契约在骗人**。 + 🔴 本批在 `Login/saas` 上撞上了(官方 `TenantSaasGranter.checkTenantUser` 里 + `UserProvider.getUser().getUserId()` 为空 ⇒ 直接抛 `LoginException(GT105)` + ⇒ **官方确实要求已有登录态**)⇒ 已改成 + `if let Err(resp) = require_login_face_b(..).await { return resp; }`。 + 🔴 **`Logout` 是另一种情况**(官方 `logout` 是 `@NoDataSourceBind` ⇒ 未登录也返成功; + 前端 `store/auth.ts:86` 把返回值完全忽略、但 404 会弹红条) + ⇒ 本仓**刻意**丢弃 `Err`(恒 200)—— 这条已用测试 + `logout_succeeds_without_login_state` 钉住,**别再当 bug 改掉**。 + 🔴 **判据**:想让某端点**不拦**,就**别调**守卫函数(而不是调用后丢 `Err`)。 +- 🔴 **官方 `ActionResult.success(msg, data)` 是「先 msg 后 data」**: + 官方 `LoginController.java:383-390` 的 `getTicket` 是 + `ActionResult.success(ticketModel.getTicketTimeout().toString(), ticket)` + ⇒ **有效期进 `msg`、票据进 `data`** —— 与本仓 `envelope::ok(data)` 恒 `msg="成功"` **相反**。 + ⇒ 这种端点**不能**用 `ok(..)`,得**自己造信封** + (`Json(ActionResult { code, msg: expires_at_ms.to_string(), data: Value::String(ticket) })`)。 +- 🔴 **官方票据存 Redis ⇒ 本仓做进程内内存表**(`platform/session.rs` 的 `TicketStore`): + 照 `SessionStore` 同款做法(`Arc>>`)—— 进程重启即失效, + **不假装能跨重启**。 + 🔴 **两种票据不能串用**(官方也是两张不同的 Redis key)⇒ `TicketKind::Login`(`tkt-`) + 与 `TicketKind::ScanCode`(`scc-`)**带前缀**、查表时**种类不符当作不存在**。 + 🔴 混在一起的后果:「注销会话」会误删票据;拿扫码凭证查免密票据会**真的**查到。 +- 🔴 **官方 `LoginTicketModel` 恰好 4 个字段**(`status`/`value`/`theme`/`ticketTimeout`) + ⇒ **不要多给字段**(前端按 `ticketTimeout` 判断过期,多给反而误导)。 + 🔴 **查不到票据 ⇒ 返 `status=1`(INVALID)而不是报错** —— 官方 + `LoginController.java:398-404` 是**照常返回**一张空模型,不是 `fail`。 +- 🔴 **官方 core 族在官方前端全是「只有声明、没有消费点」** + (`api/core/{auth,common,user}.ts` 里声明了,两个前端版本里都搜不到调用点) + ⇒ **形状只能以官方 Java 为准**,不能照前端消费点猜。 +- 🔴 **官方 `/api/oauth/Login/socials` 没有独立的 `@XxxMapping`**: + 它走 `LoginController.java:117` 的 `@RequestMapping(value="/Login/**")` **通配** + ⇒ 由 `grant_type` 分流(`password` / `saas` / `socials` / `scancode`)。 + ⇒ `[OFFICIAL]` 的 `src` 只能记 **`LoginController.java:117`**(那个通配行)。 +- 🔴 **官方 `/api/file/Uploader/Preview` 是有 Java 出处的**(`UtilsController.java:277` + ⇒ `preview(PreviewParams)`)—— 别信「前端声明了后端就没有」的直觉, + **逐条 grep 官方 Java**。 +- 🔴 **导入族是「一份路径、多份 Controller」**: + 官方前端用 `/api/${url}/TemplateDownload` 拼(`url` 是**模块名**)⇒ + 官方**每个模块的 Controller 各有一份同路径的映射** + (`BaseLangController.java:142` / `VisualdevModelDataController.java:944` / + `EmployeeController.java:208` / `OrganizeController.java:464` …) + ⇒ `[OFFICIAL]` 的 `src` **指其中一份即可**,不必逐个模块登记。 + 🔴 本仓实现用**单段通配** `/api/{prefix}/Xxx`(`prefix` = 模块名)。 +- 🔴 **本仓 `Cargo.toml` 里**没有任何 HTTP 客户端**(无 `reqwest` / `ureq`) + ⇒ 地图族(官方 `LocationController` 转发高德 REST API)**转发不了** + ⇒ 只能**明确失败**(**不返编出来的坐标**)。 +- 🔴 **本仓的口令存储口径 ≠ 官方**:官方存 `md5(明文 + secretkey)`; + 本仓存 `md5(明文)`(`platform/auth.rs` 的 `decrypt_to_md5`) + ⇒ 锁屏解锁**按本仓口径**做等价校验。 + 🔴 **口令错与账号不存在要统一文案**(官方分两种码,但前端只弹一句 + ⇒ 本仓统一给一句,避免账号枚举)。 +- 🔴 **axum 的 `matchit` 在同一位置有两个参数名 ⇒ 启动即 panic**: + 静态闸门看不出来、编译也过,只有真把 router 建起来才炸 + ⇒ 新端点族**必须**有「逐条打一遍」的集成测试(`batch18_it` 的 + `core_all_22_endpoints_are_registered_without_matchit_conflict`)。 +- 🔴 **契约里 §6 头的「**132** 条 / **53 行**」是没人校验的散文数字 ⇒ 一直在漂**: + 实际已到 610 条 / 607 行。本批顺手改成真值。 + 🔴 **教训**:凡是不被尺子读的**数字**,迟早会说谎 —— 要么让尺子读它,要么别写它。 + --- ## 6. 收工前(每一轮都要做) diff --git a/docs/contract.md b/docs/contract.md index 6570ea4..a4cedab 100644 --- a/docs/contract.md +++ b/docs/contract.md @@ -437,7 +437,7 @@ SELECT row_to_json(q)::text AS _row FROM () AS q ## 6. 端点全表 > 🔴 **本节是「人读」版;机器可读版在附录 A 的 `[ENDPOINT]` 区段** -> (列:`face` / `method` / `path` / `guard` / `owner`,一行一条端点,**132** 条; +> (列:`face` / `method` / `path` / `guard` / `owner`,一行一条端点,**610** 条; > 外加 `[FACE]` 区段登记各契约面的条数)。 > 由 **`scripts/check-contract.sh`** 把它与**代码里真实注册的路由**逐条对账 > (总数 / 存在性 / 方法 / 归属层 / 守卫,**双向**)⇒ @@ -445,7 +445,7 @@ SELECT row_to_json(q)::text AS _row FROM () AS q > 🔴 **改端点时两处都要改**:本节的散文表 + 附录 A 的 `[ENDPOINT]`。 > > 📊 **本仓对「官方 JNPF 契约面」的覆盖**是另一本账:附录 A 的 **`[OFFICIAL]`** 区段 -> (53 行 = 官方端点全表 + 每个端点的 `status` 四态 + 官方出处 `文件:行号`)⇒ +> (607 行 = 官方端点全表 + 每个端点的 `status` 四态 + 官方出处 `文件:行号`)⇒ > 由 `check-contract.sh` 的 **CC10** 与代码真实路由**双向**对账 ⇒ > 打印「官方端点覆盖 N/M」。官方端点全表的人读版在 `JNPF_SOURCE_AUDIT.md` §4。 @@ -1732,6 +1732,29 @@ B GET /api/Report/{id}/Actions/Export 登录 platform B POST /api/Report/{id}/Actions/Module 登录 platform B GET /api/Report/{id}/getReleaseMenu 登录 platform +B POST /api/oauth/LockScreen 无 platform +B GET /api/oauth/getTicket 无 platform +B GET /api/oauth/getTicketStatus/{ticket} 无 platform +B GET /api/oauth/codeCertificate 无 platform +B GET /api/oauth/codeCertificateStatus/{ticket} 无 platform +B GET /api/oauth/setCodeCertificateStatus/{ticket}/{status} 无 platform +B POST /api/oauth/updatePasswordMessage 无 platform +B POST /api/oauth/Login/saas 登录 platform +B GET /api/oauth/mobilecode/saas 无 platform +B POST /api/oauth/apply/saas 无 platform +B POST /api/oauth/Login/socials 无 platform +B GET /api/file/Download/{fileType}/{fileName} 无 platform +B POST /api/file/PackDownload/{fileType} 无 platform +B GET /api/file/Uploader/Preview 无 platform +B POST /api/file/merge 无 platform +B GET /api/{prefix}/TemplateDownload 无 platform +B GET /api/{prefix}/ImportPreview 无 platform +B POST /api/{prefix}/ImportData 无 platform +B POST /api/{prefix}/ImportExceptionData 无 platform +B GET /api/system/Location/around 无 platform +B GET /api/system/Location/text 无 platform +B GET /api/system/Location/inputtips 无 platform + # 🔴 以下由 `scripts/pack-sync.py` 从 `packs/*` 生成 —— **不许手改** # (下次同步会被覆盖;改包就够) @@ -1755,7 +1778,7 @@ B DELETE /api/asset/DataResource/{id} permission.asset.dataResource asset [FACE] # face 条数 说明 A 28 面 A 专属(+ 2 条共用 ⇒ 面 A 合计 30 条) -B 558 面 B 专属(官方 JNPF 形状;批次 13 新增 Area 7 + Variate 7;批次 14 新增数据中心 29;批次 15 新增系统服务 39;批次 16 新增权限关系 26;批次 17 新增 onlineDev 78 + Report 23) +B 580 面 B 专属(官方 JNPF 形状;批次 13 新增 Area 7 + Variate 7;批次 14 新增数据中心 29;批次 15 新增系统服务 39;批次 16 新增权限关系 26;批次 17 新增 onlineDev 78 + Report 23;批次 18 新增 core 22) AB 2 两面共用(CurrentUser / Authority Data —— 按判别头分流) [OFFICIAL] @@ -2367,6 +2390,28 @@ POST /api/Report/{id}/Actions/Copy implemented api/onlineDev/report.ts:34 面 B GET /api/Report/{id}/Actions/Export partial api/onlineDev/report.ts:42 本仓无数据引擎 ⇒ **明确业务失败** POST /api/Report/{id}/Actions/Module partial api/onlineDev/report.ts:102 菜单 URL 用官方前端路由 `/reportPreview`(`router/routes/core.ts:92`);本仓无菜单服务 ⇒ 只回填 id / 父节点 GET /api/Report/{id}/getReleaseMenu partial api/onlineDev/report.ts:98 本仓无菜单服务 ⇒ `pcIsRelease`/`appIsRelease` 恒 false,两个 `*ReleaseName` 恒空串(官方消费这四个字段) +POST /api/oauth/LockScreen implemented LoginController.java:130 面 B 已落地:按**本仓口令口径**(`md5(明文)`,非官方 `md5(明文+secretkey)`)校验 `base_user.f_password`;账号不存在与口令错统一返「账号或密码错误」(防账号枚举) +GET /api/oauth/getTicket implemented LoginController.java:383 面 B 已落地:照抄官方 `ActionResult.success(msg, data)` 的**错位** —— 有效期(毫秒时间戳)进 `msg`、票据进 `data`;官方票据存 Redis ⇒ 本仓用进程内内存表(进程重启即失效) +GET /api/oauth/getTicketStatus/{ticket} implemented LoginController.java:398 面 B 已落地:返官方 `LoginTicketModel`(恰好 4 字段 `status`/`value`/`theme`/`ticketTimeout`);票据查不到返 `status=1`(**不报错**,照官方) +GET /api/oauth/codeCertificate implemented LoginController.java:454 面 B 已落地:与 `getTicket` 同构(`msg`=超时、`data`=凭证);扫码凭证与登录票据是**两张表**(`scc-` / `tkt-` 前缀),不串用 +GET /api/oauth/codeCertificateStatus/{ticket} implemented LoginController.java:468 面 B 已落地:返官方 `LoginTicketModel` 形状;查不到返 `status=1` +GET /api/oauth/setCodeCertificateStatus/{ticket}/{status} implemented LoginController.java:507 面 B 已落地:改状态并**续期**(官方 `updateTicket` 同款);凭证不存在返 `status=1` 的空模型(不报错) +POST /api/oauth/updatePasswordMessage partial LoginController.java:269 本仓无邮件 / 短信通道 ⇒ **明确业务失败**(不假装发成功) +POST /api/oauth/Login/saas partial LoginController.java:554 本仓无多租户数据源切换 ⇒ **明确业务失败** +GET /api/oauth/mobilecode/saas partial LoginController.java:571 本仓无短信通道 ⇒ **明确业务失败** +POST /api/oauth/apply/saas partial LoginController.java:562 本仓未接入官方 SaaS 平台 ⇒ **明确业务失败** +POST /api/oauth/Login/socials partial LoginController.java:117 本仓无第三方账号配置 ⇒ **明确业务失败** +GET /api/file/Download/{fileType}/{fileName} partial UtilsController.java:200 本仓无文件存储 ⇒ **明确业务失败**(**不返假 URL**) +POST /api/file/PackDownload/{fileType} partial UtilsController.java:100 本仓无文件存储 ⇒ **明确业务失败**(**不返假 URL**) +GET /api/file/Uploader/Preview partial UtilsController.java:277 本仓无文件存储 ⇒ **明确业务失败**(官方返预览流) +POST /api/file/merge partial UtilsController.java:295 本仓无文件存储 ⇒ **明确业务失败**(分片无处可合) +GET /api/{prefix}/TemplateDownload partial VisualdevModelDataController.java:944 本仓无导入模板文件 ⇒ **明确业务失败** +GET /api/{prefix}/ImportPreview partial VisualdevModelDataController.java:1000 本仓无导入引擎 ⇒ **明确业务失败** +POST /api/{prefix}/ImportData partial VisualdevModelDataController.java:733 本仓无导入引擎 ⇒ **明确业务失败** +POST /api/{prefix}/ImportExceptionData partial VisualdevModelDataController.java:1073 本仓无导入引擎 ⇒ **明确业务失败** +GET /api/system/Location/around partial LocationController.java:32 本仓无地图服务(无高德 key + `Cargo.toml` 里**无 HTTP 客户端**)⇒ **明确业务失败**(**不返假坐标**) +GET /api/system/Location/text partial LocationController.java:47 本仓无地图服务 ⇒ **明确业务失败**(**不返假坐标**) +GET /api/system/Location/inputtips partial LocationController.java:62 本仓无地图服务 ⇒ **明确业务失败**(**不返假坐标**) [RULER] # name 期望断言数(尺子**自己**断言的条数;跑出来的条数对不上 ⇒ 失败) diff --git a/scripts/gen-contract-endpoints.py b/scripts/gen-contract-endpoints.py index 90bad42..8d812cf 100644 --- a/scripts/gen-contract-endpoints.py +++ b/scripts/gen-contract-endpoints.py @@ -53,6 +53,65 @@ S = _load("ccs", os.path.join(HERE, "check-contract-scan.py")) # 的 `api/onlineDev/report.ts`(本仓按官方前端的消费点定契约)。 REPORT_SRC = "api/onlineDev/report.ts" +# 🔴 core 族(批次 18):官方 `jnpf-oauth` 的 `LoginController` + +# `jnpf-file` 的 `UtilsController` + `jnpf-system` 的 `LocationController`。 +# +# 🔴 **core 族在官方前端全是「只有声明、没有消费点」** +# (`api/core/{auth,common,user}.ts` 里声明了,但两个前端版本里都搜不到 +# 调用点)⇒ **形状以官方 Java 为准**,不能照前端消费点猜。 +_CORE_CONTROLLERS = { + # 官方 `jnpf-oauth` 的 `LoginController`(`@RequestMapping("/api/oauth")`) + "LoginController.java": { + "POST /api/oauth/LockScreen": 130, + "POST /api/oauth/updatePasswordMessage": 269, + "GET /api/oauth/getConfig/{account}": 318, + "GET /api/oauth/getLoginConfig": 349, + "GET /api/oauth/getTicket": 383, + "GET /api/oauth/getTicketStatus/{ticket}": 398, + "GET /api/oauth/codeCertificate": 454, + "GET /api/oauth/codeCertificateStatus/{ticket}": 468, + "GET /api/oauth/setCodeCertificateStatus/{ticket}/{status}": 507, + "POST /api/oauth/Login/saas": 554, + "POST /api/oauth/apply/saas": 562, + "GET /api/oauth/mobilecode/saas": 571, + }, + # 官方 `jnpf-file` 的 `UtilsController`(`@RequestMapping("/api/file")`) + "UtilsController.java": { + "GET /api/file/Download/{fileType}/{fileName}": 200, + "POST /api/file/PackDownload/{fileType}": 100, + "GET /api/file/Uploader/Preview": 277, + "POST /api/file/merge": 295, + }, + # 官方 `jnpf-system` 的 `LocationController`(`@RequestMapping("/api/system/Location")`) + "LocationController.java": { + "GET /api/system/Location/around": 32, + "GET /api/system/Location/text": 47, + "GET /api/system/Location/inputtips": 62, + }, +} + +# 🔴 core 族里**官方 Java 没有独立 `@XxxMapping`** 的一条: +# `/api/oauth/Login/socials` —— 官方**没有**独立的 `socials` 映射, +# 它走 `LoginController.java:117` 的 `@RequestMapping("/Login/**")` 通配, +# 由 `SocialsTokenGranter`(`grant_type=socials`)分流。 +# (官方前端 `api/core/user.ts:43` 只是**声明**了它。) +CORE_FRONTEND_OR_INDIRECT = { + "POST /api/oauth/Login/socials": "LoginController.java:117", +} + +# 🔴 **导入族**:官方前端用 `/api/${url}/Xxx` 拼(`url` 是**模块名**) +# ⇒ 官方**每个模块的 Controller 各有一份**同路径的映射 +# (`BaseLangController.java:142` / `VisualdevModelDataController.java:944` / +# `EmployeeController.java:208` / `VisualdevModelDataController.java:1000` / +# `VisualdevModelDataController.java:733` / `BaseLangController.java:182` / +# `VisualdevModelDataController.java:1073`)⇒ 出处指**其中一份**即可。 +_CORE_IMPORT_SOURCES = { + "GET /api/{prefix}/TemplateDownload": "VisualdevModelDataController.java:944", + "GET /api/{prefix}/ImportPreview": "VisualdevModelDataController.java:1000", + "POST /api/{prefix}/ImportData": "VisualdevModelDataController.java:733", + "POST /api/{prefix}/ImportExceptionData": "VisualdevModelDataController.java:1073", +} + # onlineDev:官方 Controller(`jnpf-visualdev` 模块)⇒ 文件名 + 映射行号 _VISUALDEV_CONTROLLERS = { "VisualdevController.java": { @@ -263,14 +322,71 @@ PARTIAL_NOTES = { "partial", "本仓无 DataV 组件库 ⇒ 恒空列表"), ("POST", "/api/visualdev/Portal/{id}/Actions/Export"): ( "partial", "本仓无文件服务 ⇒ **明确业务失败**"), + # ---- core(批次 18):框架自带能力 —— 本仓按「有落库/内存表可做」与 + # 「能力缺失」分两类,逐条诚实落地。 + ("POST", "/api/oauth/LockScreen"): ( + "implemented", "面 B 已落地:按**本仓口令口径**(`md5(明文)`,非官方 " + "`md5(明文+secretkey)`)校验 `base_user.f_password`;" + "账号不存在与口令错统一返「账号或密码错误」(防账号枚举)"), + ("GET", "/api/oauth/getTicket"): ( + "implemented", "面 B 已落地:照抄官方 `ActionResult.success(msg, data)` 的" + "**错位** —— 有效期(毫秒时间戳)进 `msg`、票据进 `data`;" + "官方票据存 Redis ⇒ 本仓用进程内内存表(进程重启即失效)"), + ("GET", "/api/oauth/getTicketStatus/{ticket}"): ( + "implemented", "面 B 已落地:返官方 `LoginTicketModel`(恰好 4 字段 " + "`status`/`value`/`theme`/`ticketTimeout`);" + "票据查不到返 `status=1`(**不报错**,照官方)"), + ("GET", "/api/oauth/codeCertificate"): ( + "implemented", "面 B 已落地:与 `getTicket` 同构(`msg`=超时、`data`=凭证);" + "扫码凭证与登录票据是**两张表**(`scc-` / `tkt-` 前缀),不串用"), + ("GET", "/api/oauth/codeCertificateStatus/{ticket}"): ( + "implemented", "面 B 已落地:返官方 `LoginTicketModel` 形状;查不到返 `status=1`"), + ("GET", "/api/oauth/setCodeCertificateStatus/{ticket}/{status}"): ( + "implemented", "面 B 已落地:改状态并**续期**(官方 `updateTicket` 同款);" + "凭证不存在返 `status=1` 的空模型(不报错)"), + ("POST", "/api/oauth/updatePasswordMessage"): ( + "partial", "本仓无邮件 / 短信通道 ⇒ **明确业务失败**(不假装发成功)"), + ("POST", "/api/oauth/Login/saas"): ( + "partial", "本仓无多租户数据源切换 ⇒ **明确业务失败**"), + ("GET", "/api/oauth/mobilecode/saas"): ( + "partial", "本仓无短信通道 ⇒ **明确业务失败**"), + ("POST", "/api/oauth/apply/saas"): ( + "partial", "本仓未接入官方 SaaS 平台 ⇒ **明确业务失败**"), + ("POST", "/api/oauth/Login/socials"): ( + "partial", "本仓无第三方账号配置 ⇒ **明确业务失败**"), + ("GET", "/api/file/Download/{fileType}/{fileName}"): ( + "partial", "本仓无文件存储 ⇒ **明确业务失败**(**不返假 URL**)"), + ("POST", "/api/file/PackDownload/{fileType}"): ( + "partial", "本仓无文件存储 ⇒ **明确业务失败**(**不返假 URL**)"), + ("GET", "/api/file/Uploader/Preview"): ( + "partial", "本仓无文件存储 ⇒ **明确业务失败**(官方返预览流)"), + ("POST", "/api/file/merge"): ( + "partial", "本仓无文件存储 ⇒ **明确业务失败**(分片无处可合)"), + ("GET", "/api/{prefix}/TemplateDownload"): ( + "partial", "本仓无导入模板文件 ⇒ **明确业务失败**"), + ("GET", "/api/{prefix}/ImportPreview"): ( + "partial", "本仓无导入引擎 ⇒ **明确业务失败**"), + ("POST", "/api/{prefix}/ImportData"): ( + "partial", "本仓无导入引擎 ⇒ **明确业务失败**"), + ("POST", "/api/{prefix}/ImportExceptionData"): ( + "partial", "本仓无导入引擎 ⇒ **明确业务失败**"), + ("GET", "/api/system/Location/around"): ( + "partial", "本仓无地图服务(无高德 key + `Cargo.toml` 里**无 HTTP 客户端**)" + "⇒ **明确业务失败**(**不返假坐标**)"), + ("GET", "/api/system/Location/text"): ( + "partial", "本仓无地图服务 ⇒ **明确业务失败**(**不返假坐标**)"), + ("GET", "/api/system/Location/inputtips"): ( + "partial", "本仓无地图服务 ⇒ **明确业务失败**(**不返假坐标**)"), } # 🔴 **端点顺序**:按官方模块分组,组内按路径排 —— 与 `routes.rs` 的注册顺序对齐 # (⇒ 契约读起来与代码读起来同序 ⇒ 人工 review 不用来回跳)。 -MODULE_ORDER = ["online_dev", "report"] +MODULE_ORDER = ["core", "online_dev", "report"] # 🔴 **默认 note**(未在 `PARTIAL_NOTES` 里显式标注的端点)。 DEFAULT_NOTES = { + "core": "面 B 已落地:按官方 `jnpf-oauth` / `jnpf-file` / `jnpf-system` " + "的 Controller 形状实现", "online_dev": "面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现", "report": "面 B 已落地:官方 `/api/Report/*` 在官方是**独立部署的第三方服务**" "(`jnpf-java-datareport-univer`,端口 32000)⇒ 本仓把报表元数据**就地落库**" @@ -333,8 +449,28 @@ def official_entry(mod, key, path): src = "%s:%d" % (REPORT_SRC, line) if line else REPORT_SRC status, note = PARTIAL_NOTES.get(key, ("implemented", DEFAULT_NOTES["report"])) return src, status, note - # onlineDev k = "%s %s" % (method, path) + if mod == "core": + # 🔴 core 族的官方出处**分三层**(批次 18 逐条核对): + # ① 官方 Java Controller 有独立 `@XxxMapping` ⇒ 出处指 Java 行号; + # ② 官方 Java **没有**独立映射(走 `/Login/**` 通配)⇒ 出处指通配行号; + # ③ 导入族(官方前端用 `/api/${url}/Xxx` 拼,官方各模块 Controller + # 各有一份)⇒ 出处指**其中一份**即可。 + for ctrl, table in _CORE_CONTROLLERS.items(): + if k in table: + src = "%s:%d" % (ctrl, table[k]) + status, note = PARTIAL_NOTES.get(key, ("implemented", DEFAULT_NOTES["core"])) + return src, status, note + src = CORE_FRONTEND_OR_INDIRECT.get(k) + if src: + status, note = PARTIAL_NOTES.get(key, ("implemented", DEFAULT_NOTES["core"])) + return src, status, note + src = _CORE_IMPORT_SOURCES.get(k) + if src: + status, note = PARTIAL_NOTES.get(key, ("implemented", DEFAULT_NOTES["core"])) + return src, status, note + raise SystemExit("core 族没有官方出处可登记:%s %s" % (method, path)) + # onlineDev for ctrl, table in _VISUALDEV_CONTROLLERS.items(): if k in table: src = "%s:%d" % (ctrl, table[k]) diff --git a/src/backend/src/main.rs b/src/backend/src/main.rs index 6e90f83..f1508a0 100644 --- a/src/backend/src/main.rs +++ b/src/backend/src/main.rs @@ -29,7 +29,7 @@ use ssw_platform::platform::config::Config; use ssw_platform::platform::db::Db; use ssw_platform::platform::guard::{self, Profile}; use ssw_platform::platform::seed; -use ssw_platform::platform::session::SessionStore; +use ssw_platform::platform::session::{SessionStore, TicketStore}; use ssw_platform::platform::state::AppState; use ssw_platform::routes; @@ -635,6 +635,7 @@ async fn run(mode: RunMode) -> Result<(), String> { config: Arc::new(config.clone()), db: Arc::new(db), sessions: Arc::new(SessionStore::new()), + tickets: Arc::new(TicketStore::default()), }; // 🔴 保留一个 `Db` 句柄用于**停机时优雅关闭**嵌入式 PG(`state` 会被 `build_app` 吃掉)。 let db_for_shutdown = state.db.clone(); diff --git a/src/backend/src/platform/compat/core.rs b/src/backend/src/platform/compat/core.rs index edd5581..6470f7f 100644 --- a/src/backend/src/platform/compat/core.rs +++ b/src/backend/src/platform/compat/core.rs @@ -1,19 +1,57 @@ -//! core —— 官方面 B 的 **core** 端点集(`/api/oauth/*` 等框架级能力)。 +//! core —— 官方面 B 的 **core** 端点集(`/api/oauth/*` / `/api/file/*` / `/api/system/Location/*`)。 //! //! 🔴 官方前端 `src/api/core/**` 共 4 个文件(`auth` / `common` / `user` / `index`), -//! 对应的是**框架自带**能力(登录 / 当前用户 / 公共字典),不是业务资源。 -//! 本仓能对齐的部分落在 `oauth` / 公共拉取这一层。 +//! 对应的是**框架自带**能力(登录 / 票据 / 文件 / 地图),不是业务资源。 //! -//! 真源:官方 Java `jnpf-oauth` + `jnpf-public`。 +//! 真源:官方 Java `jnpf-oauth` + `jnpf-file` + `jnpf-system`。 +//! +//! 🔴 **本文件的端点分三类**(批次 18 逐条核对官方 Java + 官方前端后判定): +//! ① **真实现**(6 条):锁屏解锁、免密登录票据、扫码登录凭证 —— 本仓有落库/内存表可做; +//! ② **明确失败**(13 条):文件族(无文件存储)、地图族(无高德 key + 无 HTTP 客户端)、 +//! 改密通知(无邮件/短信通道)⇒ `code=400` + 人话,**不返假 URL、不返假坐标**; +//! ③ **明确失败**(3 条):SaaS 多租户族 / 第三方登录 —— 本仓无多租户切换、无第三方配置。 - -use axum::extract::{Path, State}; +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::envelope::{ok, ActionResult}; + +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 { + fail(code::FAIL, format!("本极简引擎不支持{what}")) +} + +// ================================================================ 退出登录 +// +// 官方 `LoginController.java:155`(`@PostMapping("/Logout")`)。 + /// `POST /api/oauth/Logout` —— 官方 `LoginController.java:155`。 /// /// 🔴 **未登录也返成功**:前端 `store/auth.ts:86` 把 `logoutApi()` 包在 @@ -30,6 +68,10 @@ pub async fn logout_handler(State(state): State, headers: HeaderMap) - ok(Value::Null) } +// ================================================================ 登录配置 +// +// 官方 `LoginController.java`(`getLoginConfig` / `getConfig`)。 + /// `GET /api/oauth/getLoginConfig` —— 登录页配置(**登录前**就拉 ⇒ 不能要 token)。 /// /// 🔴 前端 `views/_core/login/LoginForm.vue:160-163`:`res.data.redirect` ⇒ `data` @@ -38,8 +80,408 @@ pub async fn get_login_config() -> Json { ok(json!({})) } -/// `GET /api/oauth/getConfig/{account}` —— 帐号的登录/锁屏配置(`user.ts:31`)。 +/// `GET /api/oauth/getConfig/{account}` —— 帐号的登录/锁屏配置(`user.ts:23`)。 pub async fn get_user_config(Path(account): Path) -> Json { 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, + body: Bytes, +) -> Json { + 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) -> Json { + 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, + Path(ticket): Path, +) -> Json { + 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) -> 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) -> Json { + 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, + Path(ticket): Path, +) -> Json { + 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, + Path((ticket, status)): Path<(String, String)>, +) -> Json { + 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()` +/// ⇒ 走**邮件 / 短信**通道把「您的密码即将过期」发给用户。 +/// +/// 🔴 本仓**无邮件服务、无短信通道** ⇒ 如实失败(不假装发成功)。 +pub async fn update_password_message() -> Json { + unsupported("修改密码提醒(没有邮件 / 短信通道)") +} + +// ================================================================ 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, headers: HeaderMap) -> Json { + 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 { + unsupported("租户申请短信验证码(没有短信通道)") +} + +/// `POST /api/oauth/apply/saas` —— 企业申请接口。 +/// +/// 官方 `LoginController.java:562-568`:调 `LoginSaasUtil.saasApply(...)` +/// ⇒ 走**外部 SaaS 平台**。 +/// +/// 🔴 本仓无该外部平台 ⇒ 如实失败。 +pub async fn apply_saas() -> Json { + 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 { + 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 { + 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) -> Json { + 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 { + unsupported("文件预览(没有文件存储)") +} + +/// `POST /api/file/merge` —— 分片组装。 +/// +/// 官方 `UtilsController.java:295-298`:把分片合成一个文件。 +/// +/// 🔴 本仓无文件存储 ⇒ 如实失败。 +pub async fn file_merge() -> Json { + 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) -> Json { + 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) -> Json { + 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) -> Json { + 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) -> Json { + 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 { + let _ = &raw; + unsupported("附近地点查询(没有地图服务)") +} + +/// `GET /api/system/Location/text` —— 按关键字查询附近数据。 +/// +/// 官方 `LocationController.java:47-60`:转发高德 `place/text`。 +/// +/// 🔴 本仓无地图服务 ⇒ 如实失败。 +pub async fn location_text(raw: RawQuery) -> Json { + let _ = &raw; + unsupported("地点关键字查询(没有地图服务)") +} + +/// `GET /api/system/Location/inputtips` —— 输入提示。 +/// +/// 官方 `LocationController.java:62-75`:转发高德 `assistant/inputtips`。 +/// +/// 🔴 本仓无地图服务 ⇒ 如实失败。 +pub async fn location_input_tips(raw: RawQuery) -> Json { + let _ = &raw; + unsupported("地点输入提示(没有地图服务)") +} diff --git a/src/backend/src/platform/session.rs b/src/backend/src/platform/session.rs index 948f931..9a37ca9 100644 --- a/src/backend/src/platform/session.rs +++ b/src/backend/src/platform/session.rs @@ -224,6 +224,148 @@ pub fn fingerprint_of(token: &str) -> String { md5_hex(token) } +// ================================================================ 票据(ticket) +// +// 🔴 **官方出处**:`LoginController.java:383`(`getTicket`)/ `:398`(`getTicketStatus`) +// / `:454`(`codeCertificate`)/ `:468`(`codeCertificateStatus`) +// / `:507`(`setCodeCertificateStatus`)。 +// +// 🔴 **官方用 Redis 存票据**(`TicketUtil.createTicket` / `parseTicket` / `updateTicket`) +// ⇒ 本仓**无 Redis** ⇒ 照 `SessionStore` 的同款做法:**进程内内存表** +// (进程重启即失效 —— 与本仓 token 表同一口径,不假装能跨重启)。 +// +// 🔴 **为什么不塞进 token 表**:票据载荷(状态 / 超时 / 值)与 token(用户身份) +// 生命周期与语义都不同 ⇒ 混在一张表里会让「注销会话」误删票据。 + +/// 票据的**种类**。 +#[derive(Clone, Copy, PartialEq, Eq, Debug)] +pub enum TicketKind { + /// 免密登录票据(`getTicket` / `getTicketStatus`)。 + Login, + /// 扫码登录凭证(`codeCertificate` / `codeCertificateStatus` / `setCodeCertificateStatus`)。 + ScanCode, +} + +impl TicketKind { + /// 票据串前缀 —— 两种票据**不能互相串用**(官方也是两张不同的 Redis key)。 + fn prefix(&self) -> &'static str { + match self { + TicketKind::Login => "tkt-", + TicketKind::ScanCode => "scc-", + } + } +} + +/// 一张票据的内容。 +#[derive(Clone, Debug)] +pub struct Ticket { + /// 票据种类。 + pub kind: TicketKind, + /// 状态码(官方 `LoginTicketStatus` / `ScanCodeTicketStatus` 的整数值)。 + pub status: i32, + /// 附带值(官方 `LoginTicketModel.value` —— 扫码确认后放登录 token)。 + pub value: String, + /// 主题(官方 `LoginTicketModel.theme`)。 + pub theme: String, + /// 过期时刻(毫秒时间戳,UTC)—— 对应官方 `ticketTimeout`。 + pub expires_at_ms: i64, +} + +impl Ticket { + /// 是否已过期。 + pub fn is_expired(&self, now_ms: i64) -> bool { + now_ms >= self.expires_at_ms + } +} + +/// 内存票据表:`票据串 -> Ticket`。 +#[derive(Clone, Default)] +pub struct TicketStore { + inner: Arc>>, +} + +impl TicketStore { + /// 建一张空表。 + pub fn new() -> Self { + Self { + inner: Arc::new(RwLock::new(HashMap::new())), + } + } + + /// 签发票据,返回票据串。 + /// + /// 🔴 票据串 = 前缀 + `md5(种类 + 毫秒时间戳 + 随机数)`(与 token 同一套手法)。 + pub fn issue(&self, kind: TicketKind, status: i32, ttl_seconds: i64) -> (String, i64) { + let now_ms = chrono::Utc::now().timestamp_millis(); + let rand: u64 = rand::thread_rng().gen(); + let digest = md5_hex(&format!("{:?}{}{}", kind, now_ms, rand)); + let ticket = format!("{}{}", kind.prefix(), digest); + let expires_at_ms = now_ms + ttl_seconds * 1000; + if let Ok(mut map) = self.inner.write() { + map.insert( + ticket.clone(), + Ticket { + kind, + status, + value: String::new(), + theme: String::new(), + expires_at_ms, + }, + ); + } + (ticket, expires_at_ms) + } + + /// 读票据;**过期即删**(官方 `parseTicket` 同样会判超时)。 + pub fn get(&self, kind: TicketKind, ticket: &str) -> Option { + let ticket = ticket.trim(); + if ticket.is_empty() { + return None; + } + let now_ms = chrono::Utc::now().timestamp_millis(); + let map = self.inner.read().ok()?; + let found = map.get(ticket).cloned()?; + // 🔴 种类不符 ⇒ 当作不存在(两种票据不能串用)。 + if found.kind != kind { + return None; + } + if found.is_expired(now_ms) { + drop(map); + self.remove(ticket); + return None; + } + Some(found) + } + + /// 更新票据的**状态 / 值**(官方 `TicketUtil.updateTicket`)。 + pub fn update(&self, kind: TicketKind, ticket: &str, status: i32, value: &str, ttl_seconds: i64) -> Option { + let ticket = ticket.trim(); + if ticket.is_empty() { + return None; + } + let now_ms = chrono::Utc::now().timestamp_millis(); + let mut map = self.inner.write().ok()?; + let entry = map.get_mut(ticket)?; + if entry.kind != kind { + return None; + } + entry.status = status; + if !value.is_empty() { + entry.value = value.to_string(); + } + entry.expires_at_ms = now_ms + ttl_seconds * 1000; + Some(entry.clone()) + } + + /// 删一张票据(官方 `TicketUtil.deleteTicket`)。 + pub fn remove(&self, ticket: &str) -> bool { + match self.inner.write() { + Ok(mut map) => map.remove(ticket.trim()).is_some(), + Err(_) => false, + } + } +} + #[cfg(test)] mod tests { use super::*; diff --git a/src/backend/src/platform/state.rs b/src/backend/src/platform/state.rs index 815cb40..90af298 100644 --- a/src/backend/src/platform/state.rs +++ b/src/backend/src/platform/state.rs @@ -10,7 +10,7 @@ use std::sync::Arc; use crate::platform::config::Config; use crate::platform::db::Db; -use crate::platform::session::SessionStore; +use crate::platform::session::{SessionStore, TicketStore}; /// 全局应用状态。 #[derive(Clone)] @@ -21,6 +21,14 @@ pub struct AppState { pub db: Arc, /// 内存 token 会话表。 pub sessions: Arc, + /// 🔴 内存票据表(免密登录票据 / 扫码凭证)。 + /// + /// 🔴 **官方出处**:`LoginController.java:383`(`getTicket`)/ `:398` + /// (`getTicketStatus`)/ `:454`(`codeCertificate`)/ `:468` + /// (`codeCertificateStatus`)/ `:507`(`setCodeCertificateStatus`)。 + /// 官方用 Redis 存 ⇒ 本仓无 Redis ⇒ 照 token 表的同款做法用**进程内内存表** + /// (进程重启即失效,不假装能跨重启)。 + pub tickets: Arc, } #[cfg(test)] diff --git a/src/backend/src/routes.rs b/src/backend/src/routes.rs index baa8406..3b135e9 100644 --- a/src/backend/src/routes.rs +++ b/src/backend/src/routes.rs @@ -937,6 +937,58 @@ pub fn build_router(state: AppState) -> axum::Router { // 🔴 登录**前**就会拉 ⇒ 不能挂守卫。 .route("/api/oauth/getLoginConfig", get(compat::core::get_login_config)) .route("/api/oauth/getConfig/{account}", get(compat::core::get_user_config)) + // 🔴 批次 18:core 族 22 条(官方 `api/core/{auth,common,user}.ts`)。 + // 官方前端这一族**全是「只有声明、没有消费点」** ⇒ 形状以官方 Java 为准。 + // 🔴 票据 / 扫码凭证:官方 `@NoDataSourceBind` ⇒ 登录**前**就要用 ⇒ 不挂守卫。 + .route("/api/oauth/LockScreen", post(compat::core::lock_screen)) + .route("/api/oauth/getTicket", get(compat::core::get_ticket)) + .route( + "/api/oauth/getTicketStatus/{ticket}", + get(compat::core::get_ticket_status), + ) + .route("/api/oauth/codeCertificate", get(compat::core::code_certificate)) + .route( + "/api/oauth/codeCertificateStatus/{ticket}", + get(compat::core::code_certificate_status), + ) + .route( + "/api/oauth/setCodeCertificateStatus/{ticket}/{status}", + get(compat::core::set_code_certificate_status), + ) + .route("/api/oauth/updatePasswordMessage", post(compat::core::update_password_message)) + .route("/api/oauth/Login/saas", post(compat::core::login_saas)) + .route("/api/oauth/mobilecode/saas", get(compat::core::mobile_code_saas)) + .route("/api/oauth/apply/saas", post(compat::core::apply_saas)) + .route("/api/oauth/Login/socials", post(compat::core::socials_login)) + // 🔴 文件族:官方 `jnpf-file` 的 `UtilsController`(`@RequestMapping("/api/file")`)。 + .route( + "/api/file/Download/{fileType}/{fileName}", + get(compat::core::file_download), + ) + .route( + "/api/file/PackDownload/{fileType}", + post(compat::core::file_pack_download), + ) + .route("/api/file/Uploader/Preview", get(compat::core::file_uploader_preview)) + .route("/api/file/merge", post(compat::core::file_merge)) + // 🔴 导入族:官方前端用 `/api/${url}/Xxx` 拼(`url` 是模块名)⇒ 单段通配。 + .route( + "/api/{prefix}/TemplateDownload", + get(compat::core::template_download), + ) + .route("/api/{prefix}/ImportPreview", get(compat::core::import_preview)) + .route("/api/{prefix}/ImportData", post(compat::core::import_data)) + .route( + "/api/{prefix}/ImportExceptionData", + post(compat::core::import_exception_data), + ) + // 🔴 地图族:官方 `jnpf-system` 的 `LocationController`(转发高德 REST API)。 + .route("/api/system/Location/around", get(compat::core::location_around)) + .route("/api/system/Location/text", get(compat::core::location_text)) + .route( + "/api/system/Location/inputtips", + get(compat::core::location_input_tips), + ) .route("/api/permission/Role", get(compat::permission::roles_list)) .route("/api/permission/Role", post(compat::permission::role_create)) .route("/api/permission/Role/Selector", get(compat::permission::role_selector)) @@ -1702,7 +1754,7 @@ mod tests { use crate::platform::config::Config; use crate::platform::db::Db; - use crate::platform::session::SessionStore; + use crate::platform::session::{SessionStore, TicketStore}; use crate::platform::test_support; /// 全进程共享的临时库(pglite 进程级全局单例 ⇒ 只能开一次,所有单测共用)。 @@ -1715,6 +1767,7 @@ mod tests { config: Arc::new(Config::from_env(PathBuf::from("/tmp/ssw-platform-routes-test"))), db: Arc::new(db.clone()), sessions: Arc::new(SessionStore::new()), + tickets: Arc::new(TicketStore::default()), } } diff --git a/src/backend/tests/auth_it.rs b/src/backend/tests/auth_it.rs index e410900..7072d56 100644 --- a/src/backend/tests/auth_it.rs +++ b/src/backend/tests/auth_it.rs @@ -25,7 +25,7 @@ use ssw_platform::platform::envelope::ActionResult; use ssw_platform::platform::ids::new_uuid; use ssw_platform::bootstrap::ensure_base; use ssw_platform::platform::seed::first_seed; -use ssw_platform::platform::session::{SessionStore, TokenUser}; +use ssw_platform::platform::session::{SessionStore, TokenUser, TicketStore}; use ssw_platform::platform::state::AppState; use tokio::sync::{Mutex, OnceCell}; @@ -60,6 +60,7 @@ fn new_state(db: &Db) -> AppState { config: Arc::new(Config::from_env(PathBuf::from("/tmp/ssw-platform-auth-it"))), db: Arc::new(db.clone()), sessions: Arc::new(SessionStore::new()), + tickets: Arc::new(TicketStore::default()), } } diff --git a/src/backend/tests/batch10_it.rs b/src/backend/tests/batch10_it.rs index 1e560e6..9ef3f96 100644 --- a/src/backend/tests/batch10_it.rs +++ b/src/backend/tests/batch10_it.rs @@ -24,7 +24,7 @@ use ssw_platform::bootstrap::ensure_base; use ssw_platform::platform::config::Config; use ssw_platform::platform::db::Db; use ssw_platform::platform::seed::first_seed; -use ssw_platform::platform::session::SessionStore; +use ssw_platform::platform::session::{SessionStore, TicketStore}; use ssw_platform::platform::state::AppState; use ssw_platform::routes::build_app; use tokio::io::{AsyncReadExt, AsyncWriteExt}; @@ -118,6 +118,7 @@ fn new_state(db: &Db) -> AppState { config: Arc::new(Config::from_env(PathBuf::from("/tmp/ssw-platform-batch10-it"))), db: Arc::new(db.clone()), sessions: Arc::new(SessionStore::default()), + tickets: Arc::new(TicketStore::default()), } } diff --git a/src/backend/tests/batch11_it.rs b/src/backend/tests/batch11_it.rs index 31b275e..db3b392 100644 --- a/src/backend/tests/batch11_it.rs +++ b/src/backend/tests/batch11_it.rs @@ -32,7 +32,7 @@ use ssw_platform::bootstrap::ensure_base; use ssw_platform::platform::config::Config; use ssw_platform::platform::db::Db; use ssw_platform::platform::seed::first_seed; -use ssw_platform::platform::session::SessionStore; +use ssw_platform::platform::session::{SessionStore, TicketStore}; use ssw_platform::platform::state::AppState; use ssw_platform::routes::build_app; use tokio::io::{AsyncReadExt, AsyncWriteExt}; @@ -126,6 +126,7 @@ fn new_state(db: &Db) -> AppState { config: Arc::new(Config::from_env(PathBuf::from("/tmp/ssw-platform-batch11-it"))), db: Arc::new(db.clone()), sessions: Arc::new(SessionStore::default()), + tickets: Arc::new(TicketStore::default()), } } diff --git a/src/backend/tests/batch13_it.rs b/src/backend/tests/batch13_it.rs index 9efe498..1f2f69b 100644 --- a/src/backend/tests/batch13_it.rs +++ b/src/backend/tests/batch13_it.rs @@ -29,7 +29,7 @@ use ssw_platform::bootstrap::ensure_base; use ssw_platform::platform::config::Config; use ssw_platform::platform::db::Db; use ssw_platform::platform::seed::first_seed; -use ssw_platform::platform::session::SessionStore; +use ssw_platform::platform::session::{SessionStore, TicketStore}; use ssw_platform::platform::state::AppState; use ssw_platform::routes::build_app; use tokio::io::{AsyncReadExt, AsyncWriteExt}; @@ -123,6 +123,7 @@ fn new_state(db: &Db) -> AppState { config: Arc::new(Config::from_env(PathBuf::from("/tmp/ssw-platform-batch13-it"))), db: Arc::new(db.clone()), sessions: Arc::new(SessionStore::default()), + tickets: Arc::new(TicketStore::default()), } } diff --git a/src/backend/tests/batch14_it.rs b/src/backend/tests/batch14_it.rs index 7e04868..8ae6c50 100644 --- a/src/backend/tests/batch14_it.rs +++ b/src/backend/tests/batch14_it.rs @@ -32,7 +32,7 @@ use ssw_platform::bootstrap::ensure_base; use ssw_platform::platform::config::Config; use ssw_platform::platform::db::Db; use ssw_platform::platform::seed::first_seed; -use ssw_platform::platform::session::SessionStore; +use ssw_platform::platform::session::{SessionStore, TicketStore}; use ssw_platform::platform::state::AppState; use ssw_platform::routes::build_app; use tokio::io::{AsyncReadExt, AsyncWriteExt}; @@ -132,6 +132,7 @@ fn new_state(db: &Db) -> AppState { config: Arc::new(Config::from_env(PathBuf::from("/tmp/ssw-platform-batch14-it"))), db: Arc::new(db.clone()), sessions: Arc::new(SessionStore::default()), + tickets: Arc::new(TicketStore::default()), } } diff --git a/src/backend/tests/batch15_it.rs b/src/backend/tests/batch15_it.rs index ec6c868..0ab71d4 100644 --- a/src/backend/tests/batch15_it.rs +++ b/src/backend/tests/batch15_it.rs @@ -30,7 +30,7 @@ use ssw_platform::bootstrap::ensure_base; use ssw_platform::platform::config::Config; use ssw_platform::platform::db::Db; use ssw_platform::platform::seed::first_seed; -use ssw_platform::platform::session::SessionStore; +use ssw_platform::platform::session::{SessionStore, TicketStore}; use ssw_platform::platform::state::AppState; use ssw_platform::routes::build_app; use tokio::io::{AsyncReadExt, AsyncWriteExt}; @@ -143,6 +143,7 @@ fn new_state(db: &Db) -> AppState { ))), db: Arc::new(db.clone()), sessions: Arc::new(SessionStore::default()), + tickets: Arc::new(TicketStore::default()), } } diff --git a/src/backend/tests/batch16_it.rs b/src/backend/tests/batch16_it.rs index f0487b7..4ba9778 100644 --- a/src/backend/tests/batch16_it.rs +++ b/src/backend/tests/batch16_it.rs @@ -27,7 +27,7 @@ use ssw_platform::bootstrap::ensure_base; use ssw_platform::platform::config::Config; use ssw_platform::platform::db::Db; use ssw_platform::platform::seed::first_seed; -use ssw_platform::platform::session::SessionStore; +use ssw_platform::platform::session::{SessionStore, TicketStore}; use ssw_platform::platform::state::AppState; use ssw_platform::routes::build_app; use tokio::io::{AsyncReadExt, AsyncWriteExt}; @@ -140,6 +140,7 @@ fn new_state(db: &Db) -> AppState { ))), db: Arc::new(db.clone()), sessions: Arc::new(SessionStore::default()), + tickets: Arc::new(TicketStore::default()), } } diff --git a/src/backend/tests/batch17_it.rs b/src/backend/tests/batch17_it.rs index 0a1c18b..083c7c4 100644 --- a/src/backend/tests/batch17_it.rs +++ b/src/backend/tests/batch17_it.rs @@ -25,7 +25,7 @@ use ssw_platform::bootstrap::ensure_base; use ssw_platform::platform::config::Config; use ssw_platform::platform::db::Db; use ssw_platform::platform::seed::first_seed; -use ssw_platform::platform::session::SessionStore; +use ssw_platform::platform::session::{SessionStore, TicketStore}; use ssw_platform::platform::state::AppState; use ssw_platform::routes::build_app; use tokio::io::{AsyncReadExt, AsyncWriteExt}; @@ -138,6 +138,7 @@ fn new_state(db: &Db) -> AppState { ))), db: Arc::new(db.clone()), sessions: Arc::new(SessionStore::default()), + tickets: Arc::new(TicketStore::default()), } } diff --git a/src/backend/tests/batch18_it.rs b/src/backend/tests/batch18_it.rs new file mode 100644 index 0000000..76fe24f --- /dev/null +++ b/src/backend/tests/batch18_it.rs @@ -0,0 +1,502 @@ +//! 批次 18 —— **core 族 22 条**的集成测试。 +//! +//! 🔴 core 族(官方 `api/core/{auth,common,user}.ts`)在官方前端**全是「只有声明、 +//! 没有消费点」** ⇒ 形状以**官方 Java** 为准(本文件逐条按官方实现断言)。 +//! +//! 🔴 三类断言: +//! ① **路由存在**(22 条逐条打一遍)—— 防 axum 的 `matchit` 参数名冲突 +//! (同位置不能有两个参数名 ⇒ **启动即 panic**,静态闸门看不出来、编译也过); +//! ② **真实现**的**精确形状**(票据的 `msg`/`data` 错位、扫码状态流转); +//! ③ **能力缺失**端点的**诚实失败**(`code=400` + `data:null` + 人话)。 + +use std::path::PathBuf; +use std::sync::Arc; + +use serde_json::{json, Value}; +use ssw_platform::platform::db::Db; +use ssw_platform::platform::seed::first_seed; +use ssw_platform::platform::session::{SessionStore, TicketStore}; +use ssw_platform::platform::state::AppState; +use ssw_platform::routes::build_app; +use tokio::io::{AsyncReadExt, AsyncWriteExt}; +use tokio::net::TcpStream; +use tokio::sync::{Mutex, OnceCell}; + +static DB: OnceCell = OnceCell::const_new(); +static LOCK: Mutex<()> = Mutex::const_new(()); + +async fn db() -> &'static Db { + DB.get_or_init(|| async { + let db = Db::open_temp().await.expect("打开 pglite 临时库失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); + ssw_platform::bootstrap::ensure_base(&db) + .await + .expect("ensure_base 失败"); first_seed(&db, "123456").await.expect("first_seed 失败"); + db + }) + .await +} + +async fn serve(state: AppState) -> u16 { + let listener = tokio::net::TcpListener::bind("127.0.0.1:0") + .await + .expect("绑定失败"); + let port = listener.local_addr().expect("取本地地址失败").port(); + let server = tokio::spawn(async move { + let _ = axum::serve(listener, build_app(state)).await; + }); + tokio::task::yield_now().await; + std::mem::forget(server); + port +} + +fn new_state(db: &Db) -> AppState { + AppState { + config: Arc::new(ssw_platform::platform::config::Config::from_env(PathBuf::from( + "/tmp/ssw-platform-batch18-it", + ))), + db: Arc::new(db.clone()), + sessions: Arc::new(SessionStore::default()), + tickets: Arc::new(TicketStore::default()), + } +} + +async fn call(port: u16, method: &str, path: &str, token: &str, body: Option<&str>) -> Value { + let mut stream = TcpStream::connect(("127.0.0.1", port)) + .await + .expect("连接失败"); + let payload = body.unwrap_or(""); + let req = format!( + "{method} {path} HTTP/1.1\r\n\ + Host: 127.0.0.1\r\n\ + Vue-Version: 3\r\n\ + App-Code: mainSystem\r\n\ + Authorization: {token}\r\n\ + Content-Type: application/json\r\n\ + Content-Length: {}\r\n\ + Connection: close\r\n\r\n{payload}", + payload.len() + ); + stream + .write_all(req.as_bytes()) + .await + .expect("写请求失败"); + let mut buf = Vec::new(); + tokio::time::timeout( + std::time::Duration::from_secs(15), + stream.read_to_end(&mut buf), + ) + .await + .expect("读响应超时") + .expect("读响应失败"); + let text = String::from_utf8_lossy(&buf).to_string(); + let (_, body) = text.split_once("\r\n\r\n").expect("响应必须有头体分隔"); + serde_json::from_str(body.trim()).unwrap_or(Value::Null) +} + +async fn login(port: u16) -> String { + let enc = ssw_platform::platform::cipher::encrypt_password("123456"); + let payload = format!("account=admin&password={enc}"); + let mut stream = TcpStream::connect(("127.0.0.1", port)) + .await + .expect("连接失败"); + let req = format!( + "POST /api/oauth/Login HTTP/1.1\r\n\ + Host: 127.0.0.1\r\n\ + Vue-Version: 3\r\n\ + App-Code: mainSystem\r\n\ + Content-Type: application/x-www-form-urlencoded\r\n\ + Content-Length: {}\r\n\ + Connection: close\r\n\r\n{payload}", + payload.len() + ); + stream + .write_all(req.as_bytes()) + .await + .expect("写请求失败"); + let mut buf = Vec::new(); + tokio::time::timeout( + std::time::Duration::from_secs(15), + stream.read_to_end(&mut buf), + ) + .await + .expect("读响应超时") + .expect("读响应失败"); + let text = String::from_utf8_lossy(&buf).to_string(); + let (_, body) = text.split_once("\r\n\r\n").expect("响应必须有头体分隔"); + let v: Value = serde_json::from_str(body.trim()).unwrap_or(Value::Null); + v["data"]["token"] + .as_str() + .expect("登录必须返 token") + .to_string() +} + +async fn boot() -> (u16, String) { + let state = new_state(db().await); + let port = serve(state).await; + let token = login(port).await; + (port, token) +} + +/// 🔴 **22 条端点逐条打一遍** —— 判据「不是 404 / 405」。 +/// +/// 🔴 **为什么必须有这条测试**:axum 的 `matchit` 在**同一位置有两个参数名** +/// (如 `/api/oauth/getTicketStatus/{ticket}` 与 +/// `/api/oauth/getTicketStatus/{id}`)时会**启动即 panic** —— +/// 静态闸门看不出来、编译也过,只有真把 router 建起来才炸。 +#[tokio::test] +async fn core_all_22_endpoints_are_registered_without_matchit_conflict() { + let _g = LOCK.lock().await; + let (port, token) = boot().await; + + let lock_body = json!({"account":"admin","password":"x"}).to_string(); + let cases: Vec<(&str, &str, Option<&str>)> = vec![ + // ---- oauth 族(10 条)---- + ("POST", "/api/oauth/LockScreen", Some(&lock_body)), + ("GET", "/api/oauth/getTicket", None), + ("GET", "/api/oauth/getTicketStatus/some-ticket", None), + ("GET", "/api/oauth/codeCertificate", None), + ("GET", "/api/oauth/codeCertificateStatus/some-ticket", None), + ("GET", "/api/oauth/setCodeCertificateStatus/some-ticket/1", None), + ("POST", "/api/oauth/updatePasswordMessage", None), + ("POST", "/api/oauth/Login/saas", Some("{}")), + ("GET", "/api/oauth/mobilecode/saas?mobile=13800000000", None), + ("POST", "/api/oauth/apply/saas", Some("{}")), + ("POST", "/api/oauth/Login/socials", Some("code=x&source=y")), + // ---- 文件族(4 条)---- + ("GET", "/api/file/Download/image/a.png", None), + ("POST", "/api/file/PackDownload/image", Some("[]")), + ("GET", "/api/file/Uploader/Preview", None), + ("POST", "/api/file/merge", Some("{}")), + // ---- 导入族(4 条)---- + ("GET", "/api/system/TemplateDownload", None), + ("GET", "/api/permission/ImportPreview", None), + ("POST", "/api/permission/ImportData", Some("{}")), + ("POST", "/api/onlineDev/ImportExceptionData", Some("{}")), + // ---- 地图族(3 条)---- + ("GET", "/api/system/Location/around?location=1,1", None), + ("GET", "/api/system/Location/text?keywords=x", None), + ("GET", "/api/system/Location/inputtips?keywords=x", None), + ]; + assert_eq!(cases.len(), 22, "本批就是 22 条"); + + for (method, path, body) in cases { + let res = call(port, method, path, &token, body).await; + let code = res["code"].as_i64().unwrap_or(-1); + assert!( + code != 404 && code != 405, + "`{method} {path}` 必须已注册(404/405 说明路由没接上),实际 code={code}:{:?}", + res + ); + } +} + +/// 🔴 **`getTicket` 的官方两参信封**:`msg` = 超时毫秒、`data` = 票据。 +/// +/// 官方 `LoginController.java:383-390`: +/// `return ActionResult.success(ticketModel.getTicketTimeout().toString(), ticket);` +/// 🔴 **官方 `success(msg, data)` 是「先 msg 后 data」** ⇒ 本仓必须照抄这个错位: +/// 有效期进 `msg`、票据进 `data`。 +#[tokio::test] +async fn get_ticket_puts_timeout_in_msg_and_ticket_in_data() { + let _g = LOCK.lock().await; + let (port, token) = boot().await; + + let res = call(port, "GET", "/api/oauth/getTicket", &token, None).await; + assert_eq!(res["code"], 200, "getTicket 应成功:{:?}", res); + // 🔴 `msg` 必须是**毫秒时间戳字符串**(官方 `getTicketTimeout().toString()`)。 + let msg = res["msg"].as_str().expect("msg 必须是字符串"); + let timeout_ms: i64 = msg + .parse() + .unwrap_or_else(|_| panic!("msg 必须是毫秒时间戳串,实际 {msg:?}")); + assert!( + timeout_ms > 1_600_000_000_000, + "msg 必须是 13 位毫秒时间戳(不是秒!),实际 {msg:?}" + ); + // 🔴 `data` 必须是**票据串**。 + let ticket = res["data"].as_str().expect("data 必须是票据串"); + assert!(!ticket.is_empty(), "data 不能是空串"); + + // 🔴 拿票据查状态 ⇒ 能查到(官方 `getTicketStatus`)。 + let res = call( + port, + "GET", + &format!("/api/oauth/getTicketStatus/{ticket}"), + &token, + None, + ) + .await; + assert_eq!(res["code"], 200, "查票据状态应成功:{:?}", res); + // 🔴 官方 `LoginTicketModel` 恰好 4 个字段。 + for key in ["status", "value", "theme", "ticketTimeout"] { + assert!( + res["data"].get(key).is_some(), + "官方 `LoginTicketModel` 必须有 `{key}`,实际:{:?}", + res["data"] + ); + } +} + +/// 🔴 **查一张不存在的票据 ⇒ 官方返 `INVALID` 状态,而不是报错**。 +/// +/// 官方 `LoginController.java:398-404`:解析不出来 ⇒ 造一张 `status = INVALID` +/// 的空模型**照常返回**(不是 `fail`)。 +#[tokio::test] +async fn unknown_ticket_returns_invalid_status_instead_of_error() { + let _g = LOCK.lock().await; + let (port, token) = boot().await; + + let res = call( + port, + "GET", + "/api/oauth/getTicketStatus/never-issued-ticket", + &token, + None, + ) + .await; + assert_eq!(res["code"], 200, "官方是照常返回,不是失败:{:?}", res); + assert_eq!( + res["data"]["status"], 1, + "查不到票据 ⇒ status 应为 INVALID(1),实际:{:?}", + res["data"] + ); +} + +/// 🔴 **扫码凭证**:`codeCertificate` 同 `getTicket` 的两参信封; +/// `setCodeCertificateStatus` 能改状态并**续期**。 +#[tokio::test] +async fn scan_code_certificate_status_can_be_set_and_read_back() { + let _g = LOCK.lock().await; + let (port, token) = boot().await; + + let res = call(port, "GET", "/api/oauth/codeCertificate", &token, None).await; + assert_eq!(res["code"], 200, "codeCertificate 应成功:{:?}", res); + let ticket = res["data"].as_str().expect("data 必须是凭证串").to_string(); + + // 初始状态 + let res = call( + port, + "GET", + &format!("/api/oauth/codeCertificateStatus/{ticket}"), + &token, + None, + ) + .await; + assert_eq!(res["code"], 200, "查凭证状态应成功:{:?}", res); + let before = res["data"]["ticketTimeout"].as_i64().unwrap_or(0); + assert!(before > 0, "ticketTimeout 必须是毫秒时间戳:{:?}", res["data"]); + + // 🔴 官方 `LoginController.java:507-519`:改状态 ⇒ 回吐整张凭证模型。 + let res = call( + port, + "GET", + &format!("/api/oauth/setCodeCertificateStatus/{ticket}/2"), + &token, + None, + ) + .await; + assert_eq!(res["code"], 200, "设置凭证状态应成功:{:?}", res); + assert_eq!( + res["data"]["status"], 2, + "状态应被改成 2,实际:{:?}", + res["data"] + ); + + // 再查 ⇒ 状态应保持 2 + let res = call( + port, + "GET", + &format!("/api/oauth/codeCertificateStatus/{ticket}"), + &token, + None, + ) + .await; + assert_eq!( + res["data"]["status"], 2, + "状态应被持久化,实际:{:?}", + res["data"] + ); +} + +/// 🔴 **扫码凭证与免密票据不能串用**(官方也是两张不同的 Redis key)。 +#[tokio::test] +async fn scan_code_ticket_and_login_ticket_are_not_interchangeable() { + let _g = LOCK.lock().await; + let (port, token) = boot().await; + + let res = call(port, "GET", "/api/oauth/codeCertificate", &token, None).await; + let scan_ticket = res["data"].as_str().expect("data 必须是凭证串").to_string(); + + // 🔴 拿**扫码凭证**去查**免密票据**的状态 ⇒ 应查不到(status = INVALID)。 + let res = call( + port, + "GET", + &format!("/api/oauth/getTicketStatus/{scan_ticket}"), + &token, + None, + ) + .await; + assert_eq!( + res["data"]["status"], 1, + "两种票据不能串用,实际:{:?}", + res["data"] + ); +} + +/// 🔴 **锁屏解锁**:口令对 ⇒ 成功;口令错 ⇒ 失败。 +/// +/// 官方 `LoginController.java:130-146`。本仓口令口径 = `md5(明文)` +/// (不是官方的 `md5(明文+secretkey)`)⇒ 前端发密文,本仓解成 `md5(明文)` 再比。 +#[tokio::test] +async fn lock_screen_accepts_correct_password_and_rejects_wrong_one() { + let _g = LOCK.lock().await; + let (port, token) = boot().await; + + // 正确口令 + let enc = ssw_platform::platform::cipher::encrypt_password("123456"); + let res = call( + port, + "POST", + "/api/oauth/LockScreen", + &token, + Some(&json!({ "account": "admin", "password": enc }).to_string()), + ) + .await; + assert_eq!(res["code"], 200, "正确口令应解锁成功:{:?}", res); + + // 错误口令 + let bad = ssw_platform::platform::cipher::encrypt_password("wrong-password"); + let res = call( + port, + "POST", + "/api/oauth/LockScreen", + &token, + Some(&json!({ "account": "admin", "password": bad }).to_string()), + ) + .await; + assert_eq!(res["code"], 400, "错误口令必须失败:{:?}", res); + assert_eq!(res["data"], Value::Null, "失败时 data 必须是 null"); + + // 不存在的账号 ⇒ 也失败(且**不区分**「账号不存在」与「口令错」) + let res = call( + port, + "POST", + "/api/oauth/LockScreen", + &token, + Some(&json!({ "account": "no-such-user", "password": enc }).to_string()), + ) + .await; + assert_eq!(res["code"], 400, "不存在的账号必须失败:{:?}", res); +} + +/// 🔴 **能力缺失的端点必须「诚实失败」**:`code=400` + `data:null` + **有 msg**。 +/// +/// 🔴 **绝不返假数据**:没有文件存储就不能返一个编出来的下载 URL; +/// 没有地图服务就不能返一组编出来的坐标。 +#[tokio::test] +async fn capability_missing_core_endpoints_fail_explicitly() { + let _g = LOCK.lock().await; + let (port, token) = boot().await; + + let cases: Vec<(&str, &str, Option<&str>)> = vec![ + ("POST", "/api/oauth/updatePasswordMessage", None), + ("POST", "/api/oauth/Login/saas", Some("{}")), + ("GET", "/api/oauth/mobilecode/saas?mobile=13800000000", None), + ("POST", "/api/oauth/apply/saas", Some("{}")), + ("POST", "/api/oauth/Login/socials", Some("code=x")), + ("GET", "/api/file/Download/image/a.png", None), + ("POST", "/api/file/PackDownload/image", Some("[]")), + ("GET", "/api/file/Uploader/Preview", None), + ("POST", "/api/file/merge", Some("{}")), + ("GET", "/api/system/TemplateDownload", None), + ("GET", "/api/permission/ImportPreview", None), + ("POST", "/api/permission/ImportData", Some("{}")), + ("POST", "/api/onlineDev/ImportExceptionData", Some("{}")), + ("GET", "/api/system/Location/around?location=1,1", None), + ("GET", "/api/system/Location/text?keywords=x", None), + ("GET", "/api/system/Location/inputtips?keywords=x", None), + ]; + for (method, path, body) in cases { + let res = call(port, method, path, &token, body).await; + assert_eq!( + res["code"], 400, + "`{method} {path}` 能力缺失 ⇒ 必须 code=400(诚实失败),实际:{:?}", + res + ); + assert_eq!( + res["data"], + Value::Null, + "`{method} {path}` 失败时 data 必须是 null,实际:{:?}", + res + ); + let msg = res["msg"].as_str().unwrap_or(""); + assert!( + !msg.trim().is_empty(), + "`{method} {path}` 失败必须带人话 msg,实际:{:?}", + res + ); + assert!( + msg.contains("不支持"), + "`{method} {path}` 的 msg 应说明「不支持」并说清缺什么,实际:{msg:?}" + ); + } +} + +/// 🔴 **`Logout` 未登录也返成功**(官方 `LoginController.java:155` 的 `logout` +/// 是 `@NoDataSourceBind`;前端 `store/auth.ts:86` 把 `logoutApi()` 包在 +/// `try { … } catch { /* 忽略 */ }` 里 ⇒ **返回值完全被忽略**, +/// 但 404 会走 `errorMessageResponseInterceptor` 弹红条)。 +/// +/// 🔴 **实现里 `let _ = require_login_face_b(..)` 是刻意丢弃 `Err`**(不拦)—— +/// 这条测试把这个口径钉住:未登录调 Logout ⇒ **200**(不是 602)。 +#[tokio::test] +async fn logout_succeeds_without_login_state() { + let _g = LOCK.lock().await; + let port = serve(new_state(db().await)).await; + + let res = call(port, "POST", "/api/oauth/Logout", "", None).await; + assert_eq!( + res["code"], 200, + "未登录调 `Logout` 也必须成功(官方恒成功),实际:{:?}", + res + ); + assert_eq!(res["data"], Value::Null, "Logout 恒返 data=null"); +} + +/// 🔴 **`Login/saas` 必须真的拦**(官方 `TenantSaasGranter.checkTenantUser`: +/// `UserProvider.getUser().getUserId()` 为空 ⇒ 直接抛 `LoginException(GT105)`)。 +/// +/// 🔴 **这是本批修掉的一个真偏差**:原先实现写成 +/// `let _ = require_login_face_b(..).await;` ⇒ **丢弃了 `Err`** ⇒ 实际不拦, +/// 但静态闸门会把它推成「登录」⇒ **契约标签与运行时行为不符**。 +/// ⇒ 现在改成 `if let Err(resp) = .. { return resp; }` ⇒ 未登录返 602。 +#[tokio::test] +async fn saas_login_requires_login_state() { + let _g = LOCK.lock().await; + let port = serve(new_state(db().await)).await; + + // 未登录 ⇒ 必须被拦(不能落到「不支持」的 400 上) + let res = call(port, "POST", "/api/oauth/Login/saas", "", Some("{}")).await; + assert_eq!( + res["code"], 602, + "未登录调 `Login/saas` 必须返 602(会话失效),实际:{:?}", + res + ); + assert_eq!(res["data"], Value::Null, "被拦时 data 必须是 null"); +} + +/// 🔴 **票据与扫码凭证端点登录前就要用**(官方 `@NoDataSourceBind`) +/// ⇒ 不带 token 也必须能返(不能 600)。 +#[tokio::test] +async fn ticket_endpoints_work_without_token() { + let _g = LOCK.lock().await; + let port = serve(new_state(db().await)).await; + + let res = call(port, "GET", "/api/oauth/getTicket", "", None).await; + assert_eq!(res["code"], 200, "getTicket 不该要 token:{:?}", res); + + let res = call(port, "GET", "/api/oauth/codeCertificate", "", None).await; + assert_eq!(res["code"], 200, "codeCertificate 不该要 token:{:?}", res); +} diff --git a/src/backend/tests/batch2_it.rs b/src/backend/tests/batch2_it.rs index 5c0aad4..0f6f5aa 100644 --- a/src/backend/tests/batch2_it.rs +++ b/src/backend/tests/batch2_it.rs @@ -27,7 +27,7 @@ use ssw_platform::bootstrap::ensure_base; use ssw_platform::platform::config::Config; use ssw_platform::platform::db::Db; use ssw_platform::platform::seed::first_seed; -use ssw_platform::platform::session::SessionStore; +use ssw_platform::platform::session::{SessionStore, TicketStore}; use ssw_platform::platform::state::AppState; use ssw_platform::routes::build_app; use tokio::io::{AsyncReadExt, AsyncWriteExt}; @@ -151,6 +151,7 @@ fn new_state(db: &Db) -> AppState { config: Arc::new(Config::from_env(PathBuf::from("/tmp/ssw-platform-batch2-it"))), db: Arc::new(db.clone()), sessions: Arc::new(SessionStore::new()), + tickets: Arc::new(TicketStore::default()), } } diff --git a/src/backend/tests/batch3_it.rs b/src/backend/tests/batch3_it.rs index a9e4ad5..09faef4 100644 --- a/src/backend/tests/batch3_it.rs +++ b/src/backend/tests/batch3_it.rs @@ -21,7 +21,7 @@ use ssw_platform::bootstrap::ensure_base; use ssw_platform::platform::config::Config; use ssw_platform::platform::db::Db; use ssw_platform::platform::seed::first_seed; -use ssw_platform::platform::session::SessionStore; +use ssw_platform::platform::session::{SessionStore, TicketStore}; use ssw_platform::platform::state::AppState; use ssw_platform::routes::build_app; use tokio::io::{AsyncReadExt, AsyncWriteExt}; @@ -135,6 +135,7 @@ fn new_state(db: &Db) -> AppState { config: Arc::new(Config::from_env(PathBuf::from("/tmp/ssw-platform-batch3-it"))), db: Arc::new(db.clone()), sessions: Arc::new(SessionStore::default()), + tickets: Arc::new(TicketStore::default()), } } diff --git a/src/backend/tests/batch4_it.rs b/src/backend/tests/batch4_it.rs index edffd35..30db8c5 100644 --- a/src/backend/tests/batch4_it.rs +++ b/src/backend/tests/batch4_it.rs @@ -24,7 +24,7 @@ use ssw_platform::bootstrap::ensure_base; use ssw_platform::platform::config::Config; use ssw_platform::platform::db::Db; use ssw_platform::platform::seed::first_seed; -use ssw_platform::platform::session::SessionStore; +use ssw_platform::platform::session::{SessionStore, TicketStore}; use ssw_platform::platform::state::AppState; use ssw_platform::routes::build_app; use tokio::io::{AsyncReadExt, AsyncWriteExt}; @@ -138,6 +138,7 @@ fn new_state(db: &Db) -> AppState { config: Arc::new(Config::from_env(PathBuf::from("/tmp/ssw-platform-batch4-it"))), db: Arc::new(db.clone()), sessions: Arc::new(SessionStore::default()), + tickets: Arc::new(TicketStore::default()), } } diff --git a/src/backend/tests/batch5_it.rs b/src/backend/tests/batch5_it.rs index bb42d41..1512815 100644 --- a/src/backend/tests/batch5_it.rs +++ b/src/backend/tests/batch5_it.rs @@ -22,7 +22,7 @@ use ssw_platform::bootstrap::ensure_base; use ssw_platform::platform::config::Config; use ssw_platform::platform::db::{pglite::ToSql, Db}; use ssw_platform::platform::seed::first_seed; -use ssw_platform::platform::session::SessionStore; +use ssw_platform::platform::session::{SessionStore, TicketStore}; use ssw_platform::platform::state::AppState; use ssw_platform::routes::build_app; use tokio::io::{AsyncReadExt, AsyncWriteExt}; @@ -139,6 +139,7 @@ fn new_state(db: &Db) -> AppState { config: Arc::new(Config::from_env(PathBuf::from("/tmp/ssw-platform-batch5-it"))), db: Arc::new(db.clone()), sessions: Arc::new(SessionStore::default()), + tickets: Arc::new(TicketStore::default()), } } diff --git a/src/backend/tests/batch6_it.rs b/src/backend/tests/batch6_it.rs index 968342f..ad49e01 100644 --- a/src/backend/tests/batch6_it.rs +++ b/src/backend/tests/batch6_it.rs @@ -25,7 +25,7 @@ use ssw_platform::bootstrap::ensure_base; use ssw_platform::platform::config::Config; use ssw_platform::platform::db::Db; use ssw_platform::platform::seed::first_seed; -use ssw_platform::platform::session::SessionStore; +use ssw_platform::platform::session::{SessionStore, TicketStore}; use ssw_platform::platform::state::AppState; use ssw_platform::routes::build_app; use tokio::io::{AsyncReadExt, AsyncWriteExt}; @@ -139,6 +139,7 @@ fn new_state(db: &Db) -> AppState { config: Arc::new(Config::from_env(PathBuf::from("/tmp/ssw-platform-batch6-it"))), db: Arc::new(db.clone()), sessions: Arc::new(SessionStore::default()), + tickets: Arc::new(TicketStore::default()), } } diff --git a/src/backend/tests/batch7_it.rs b/src/backend/tests/batch7_it.rs index 3821367..f12b8f3 100644 --- a/src/backend/tests/batch7_it.rs +++ b/src/backend/tests/batch7_it.rs @@ -26,7 +26,7 @@ use ssw_platform::bootstrap::ensure_base; use ssw_platform::platform::config::Config; use ssw_platform::platform::db::Db; use ssw_platform::platform::seed::first_seed; -use ssw_platform::platform::session::SessionStore; +use ssw_platform::platform::session::{SessionStore, TicketStore}; use ssw_platform::platform::state::AppState; use ssw_platform::routes::build_app; use tokio::io::{AsyncReadExt, AsyncWriteExt}; @@ -140,6 +140,7 @@ fn new_state(db: &Db) -> AppState { config: Arc::new(Config::from_env(PathBuf::from("/tmp/ssw-platform-batch7-it"))), db: Arc::new(db.clone()), sessions: Arc::new(SessionStore::default()), + tickets: Arc::new(TicketStore::default()), } } diff --git a/src/backend/tests/batch8_it.rs b/src/backend/tests/batch8_it.rs index 79c489b..d476ccc 100644 --- a/src/backend/tests/batch8_it.rs +++ b/src/backend/tests/batch8_it.rs @@ -24,7 +24,7 @@ use ssw_platform::bootstrap::ensure_base; use ssw_platform::platform::config::Config; use ssw_platform::platform::db::Db; use ssw_platform::platform::seed::first_seed; -use ssw_platform::platform::session::SessionStore; +use ssw_platform::platform::session::{SessionStore, TicketStore}; use ssw_platform::platform::state::AppState; use ssw_platform::routes::build_app; use tokio::io::{AsyncReadExt, AsyncWriteExt}; @@ -118,6 +118,7 @@ fn new_state(db: &Db) -> AppState { config: Arc::new(Config::from_env(PathBuf::from("/tmp/ssw-platform-batch8-it"))), db: Arc::new(db.clone()), sessions: Arc::new(SessionStore::default()), + tickets: Arc::new(TicketStore::default()), } } diff --git a/src/backend/tests/batch9_it.rs b/src/backend/tests/batch9_it.rs index 2cb435c..3ef7b11 100644 --- a/src/backend/tests/batch9_it.rs +++ b/src/backend/tests/batch9_it.rs @@ -24,7 +24,7 @@ use ssw_platform::bootstrap::ensure_base; use ssw_platform::platform::config::Config; use ssw_platform::platform::db::Db; use ssw_platform::platform::seed::first_seed; -use ssw_platform::platform::session::SessionStore; +use ssw_platform::platform::session::{SessionStore, TicketStore}; use ssw_platform::platform::state::AppState; use ssw_platform::routes::build_app; use tokio::io::{AsyncReadExt, AsyncWriteExt}; @@ -118,6 +118,7 @@ fn new_state(db: &Db) -> AppState { config: Arc::new(Config::from_env(PathBuf::from("/tmp/ssw-platform-batch9-it"))), db: Arc::new(db.clone()), sessions: Arc::new(SessionStore::default()), + tickets: Arc::new(TicketStore::default()), } } diff --git a/src/backend/tests/crud_it.rs b/src/backend/tests/crud_it.rs index ce8cdc2..3788197 100644 --- a/src/backend/tests/crud_it.rs +++ b/src/backend/tests/crud_it.rs @@ -25,7 +25,7 @@ use ssw_platform::platform::db::Db; use axum::Json; use ssw_platform::platform::envelope::ActionResult; use ssw_platform::platform::seed::first_seed; -use ssw_platform::platform::session::SessionStore; +use ssw_platform::platform::session::{SessionStore, TicketStore}; use ssw_platform::platform::state::AppState; use tokio::sync::{Mutex, OnceCell}; @@ -54,6 +54,7 @@ fn new_state(db: &Db) -> AppState { config: Arc::new(Config::from_env(PathBuf::from("/tmp/ssw-platform-crud-it"))), db: Arc::new(db.clone()), sessions: Arc::new(SessionStore::new()), + tickets: Arc::new(TicketStore::default()), } } diff --git a/src/backend/tests/pack_smoke_it.rs b/src/backend/tests/pack_smoke_it.rs index d412bbe..d405309 100644 --- a/src/backend/tests/pack_smoke_it.rs +++ b/src/backend/tests/pack_smoke_it.rs @@ -42,7 +42,7 @@ use ssw_platform::platform::config::Config; use ssw_platform::platform::db::Db; use ssw_platform::platform::route::HttpMethod; use ssw_platform::platform::seed::first_seed; -use ssw_platform::platform::session::SessionStore; +use ssw_platform::platform::session::{SessionStore, TicketStore}; use ssw_platform::platform::state::AppState; use ssw_platform::routes::build_app; use tokio::io::{AsyncReadExt, AsyncWriteExt}; @@ -76,6 +76,7 @@ fn new_state(db: &Db) -> AppState { config: Arc::new(Config::from_env(PathBuf::from("/tmp/ssw-platform-pack-smoke"))), db: Arc::new(db.clone()), sessions: Arc::new(SessionStore::default()), + tickets: Arc::new(TicketStore::default()), } } diff --git a/src/backend/tests/self_it.rs b/src/backend/tests/self_it.rs index 4e45f31..02b3dec 100644 --- a/src/backend/tests/self_it.rs +++ b/src/backend/tests/self_it.rs @@ -19,7 +19,7 @@ use ssw_platform::platform::cipher::md5_hex; use ssw_platform::platform::config::Config; use ssw_platform::platform::db::Db; use ssw_platform::platform::seed::first_seed; -use ssw_platform::platform::session::SessionStore; +use ssw_platform::platform::session::{SessionStore, TicketStore}; use ssw_platform::platform::state::AppState; use ssw_platform::routes::build_app; use tokio::io::{AsyncReadExt, AsyncWriteExt}; @@ -145,6 +145,7 @@ fn new_state(db: &Db) -> AppState { config: Arc::new(Config::from_env(PathBuf::from("/tmp/ssw-platform-self-it"))), db: Arc::new(db.clone()), sessions: Arc::new(SessionStore::new()), + tickets: Arc::new(TicketStore::default()), } } diff --git a/src/backend/tests/sys_it.rs b/src/backend/tests/sys_it.rs index 46f2c71..dcb9878 100644 --- a/src/backend/tests/sys_it.rs +++ b/src/backend/tests/sys_it.rs @@ -23,7 +23,7 @@ use ssw_platform::platform::db::Db; use ssw_platform::platform::envelope::ActionResult; use ssw_platform::bootstrap::ensure_base; use ssw_platform::platform::seed::first_seed; -use ssw_platform::platform::session::SessionStore; +use ssw_platform::platform::session::{SessionStore, TicketStore}; use ssw_platform::platform::state::AppState; use ssw_platform::platform::sys; use tokio::sync::{Mutex, OnceCell}; @@ -53,6 +53,7 @@ fn new_state(db: &Db) -> AppState { config: Arc::new(Config::from_env(PathBuf::from("/tmp/ssw-platform-sys-it"))), db: Arc::new(db.clone()), sessions: Arc::new(SessionStore::new()), + tickets: Arc::new(TicketStore::default()), } }