feat(core): 补齐 core 族 22 条端点并同步契约三处

按官方三源(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 行)。
This commit is contained in:
admin committed 2026-11-02 17:34:03 +08:00
1 parent cf154d50ff
commit 1c224b7b79
30 files changed
+1560 -46

No files matched your search

+2 -1
View File
@@ -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();
+450 -8
View File
@@ -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<ActionResult> {
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<AppState>, 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<ActionResult> {
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<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()`
/// ⇒ 走**邮件 / 短信**通道把「您的密码即将过期」发给用户。
///
/// 🔴 本仓**无邮件服务、无短信通道** ⇒ 如实失败(不假装发成功)。
pub async fn update_password_message() -> Json<ActionResult> {
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<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("地点输入提示(没有地图服务)")
}
+142
View File
@@ -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<RwLock<HashMap<String, Ticket>>>,
}
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<Ticket> {
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<Ticket> {
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::*;
+9 -1
View File
@@ -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<Db>,
/// 内存 token 会话表。
pub sessions: Arc<SessionStore>,
/// 🔴 内存票据表(免密登录票据 / 扫码凭证)。
///
/// 🔴 **官方出处**:`LoginController.java:383`(`getTicket`)/ `:398`
/// (`getTicketStatus`)/ `:454`(`codeCertificate`)/ `:468`
/// (`codeCertificateStatus`)/ `:507`(`setCodeCertificateStatus`)。
/// 官方用 Redis 存 ⇒ 本仓无 Redis ⇒ 照 token 表的同款做法用**进程内内存表**
/// (进程重启即失效,不假装能跨重启)。
pub tickets: Arc<TicketStore>,
}
#[cfg(test)]
+54 -1
View File
@@ -937,6 +937,58 @@ pub fn build_router(state: AppState) -> axum::Router<AppState> {
// 🔴 登录**前**就会拉 ⇒ 不能挂守卫。
.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()),
}
}
+2 -1
View File
@@ -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()),
}
}
+2 -1
View File
@@ -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()),
}
}
+2 -1
View File
@@ -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()),
}
}
+2 -1
View File
@@ -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()),
}
}
+2 -1
View File
@@ -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()),
}
}
+2 -1
View File
@@ -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()),
}
}
+2 -1
View File
@@ -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()),
}
}
+2 -1
View File
@@ -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()),
}
}
+502
View File
@@ -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<Db> = 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);
}
+2 -1
View File
@@ -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()),
}
}
+2 -1
View File
@@ -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()),
}
}
+2 -1
View File
@@ -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()),
}
}
+2 -1
View File
@@ -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()),
}
}
+2 -1
View File
@@ -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()),
}
}
+2 -1
View File
@@ -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()),
}
}
+2 -1
View File
@@ -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()),
}
}
+2 -1
View File
@@ -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()),
}
}
+2 -1
View File
@@ -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()),
}
}
+2 -1
View File
@@ -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()),
}
}
+2 -1
View File
@@ -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()),
}
}
+2 -1
View File
@@ -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()),
}
}