Files
ssw-platform/src/backend/src/routes.rs
T
admin 1c224b7b79 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 行)。
2026-11-02 17:34:03 +08:00

2311 lines
112 KiB
Rust
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
//! routes —— 路由装配 + 三层兜底(404 / 405 / 413 改写 / catch-all)。
//!
//! 契约:`docs/contract.md` §9(`routes.rs` 接口)、§6.5(兜底三条)、§R1.2(业务失败恒 HTTP 200)。
//!
//! 🔴 **三层兜底的挂法**(控制器裁决 S25)—— **唯一真源**是 [`build_app`]:
//! ```text
//! build_app(state) // ← 生产(main.rs)与单测都调它
//! build_router(state.clone())
//! .fallback(not_found_handler) // 404 兜底
//! .layer(m_status_rewrite()) // 405 / 413 改写中间件
//! .layer(catch_all()) // panic 捕获中间件
//! .with_state(state) // ← 链尾(唯一一次把类型落成 Router<()>)
//! ```
//! `Router::layer` 是**后进先出** ⇒ 最后挂的最外层 ⇒ 请求**先**撞 `catch_all`,
//! **再**撞 `m_status_rewrite`,**最后**才进 handler / 404 兜底。
//!
//! 🔴 `.fallback(...)` 必须写在两个 `.layer(...)` **之前** —— axum 官方文档原话:
//! 「the middleware is only applied to existing routes. So you have to first add your
//! routes (and / or fallback) and then call `layer` afterwards.」
//! 否则 404 兜底不在中间件的保护范围内。
//!
//! 🔴 **axum 0.8.9 用 matchit 0.8.4** —— 不支持 `{a,b}` 这种「一段里多个参数」的写法
//! (会把 `List,Save,Delete` 当成**一个**参数名 ⇒ 路由能注册上但**永远匹配不到**,
//! 且**编译不报错**)⇒ 本文件**逐条**注册 27 条具体路径(见 S15 / S21)。
use std::any::Any;
use std::future::Future;
use std::panic::{catch_unwind, AssertUnwindSafe};
use std::pin::Pin;
use std::task::{Context, Poll};
use axum::body::Body;
use axum::extract::{Request, State};
use axum::http::{header, HeaderMap, HeaderValue, StatusCode};
use axum::middleware::Next;
use axum::response::{IntoResponse, Response};
use axum::routing::{delete, get, post, put};
use axum::{Json, Router};
use serde_json::{json, Value};
use crate::modules;
use crate::platform::auth;
use crate::platform::envelope::{self, ActionResult};
use crate::platform::compat;
use crate::platform::state::AppState;
use crate::platform::sys;
/// 🔴 **仅测试构建**存在的 handler —— 故意 panic,用来钉住 catch-all 中间件
/// (契约 §6.5:panic ⇒ HTTP 200 + `code=400`)。
#[cfg(test)]
async fn panic_handler() -> Json<ActionResult> {
panic!("测试用 panic(由 catch-all 中间件接住)")
}
/// 装配全部路由(27 条,见 S15 的路由表)。
///
/// 🔴 **不在这里终结状态** —— 契约 §9 的括注与 §10 第 6 步都要求
/// `with_state` 由调用方在**链尾**调用(axum 0.8 的 `Router<S>` 的 `S`
/// 是「还缺什么状态」,`with_state` 必须是**链条最后一步**)。
/// ⇒ **完整的装配链只有一份**,在 [`build_app`](生产与单测都调它)。
///
/// 这里末尾的 `.with_state(state)` 是**类型层面**的 no-op(`S2` 显式落在 `AppState`
/// ⇒ 返回类型仍是 `Router<AppState>`):它只是让契约 §9 的 `state` 参数**有去处**
/// (否则 `unused_variables` warning ⇒ 验收门① 破),**并不**把状态喂给 handler。
/// 🔴 **真正把状态喂给 handler 的是链尾那次 `with_state`**(在 [`build_app`] 里)。
/// 🔴 两次拿到的是**同一个 `AppState` 的两个 clone** —— 而 `AppState` 的三个字段
/// (`config` / `db` / `sessions`)**全是 `Arc`** ⇒ 两份 clone **共享同一份底层状态**
/// ⇒ 行为完全等价,**不是**两个独立状态。
pub fn build_router(state: AppState) -> axum::Router<AppState> {
let router = Router::new()
// ---- 探活(§6.5 末条,非契约)----
.route("/api/health", get(health))
// ---- 认证(§6.1)----
.route("/api/oauth/Login", post(auth::login_handler))
// 🔴 `auth::current_user` 收的是 `&AppState`(不是 `State<AppState>`)
// ⇒ 不是合法的 extractor 组合 ⇒ **用闭包包一层**(S20)。
.route(
"/api/oauth/CurrentUser",
get(|State(state): State<AppState>, headers: HeaderMap| async move {
auth::current_user(&state, headers).await
}),
)
// ---- 用户(§6.2 / §7.1)----
.route("/api/ssw/sys/User/List", get(sys::user_list))
.route("/api/ssw/sys/User/Save", post(sys::user_save))
.route("/api/ssw/sys/User/Delete", delete(sys::user_delete))
// ---- 角色(§6.2 / §7.2)----
.route("/api/ssw/sys/Role/List", get(sys::role_list))
.route("/api/ssw/sys/Role/Save", post(sys::role_save))
.route("/api/ssw/sys/Role/Delete", delete(sys::role_delete))
.route("/api/ssw/sys/Role/Modules", get(sys::role_modules))
// ---- 机构(§6.2 / §7.3)----
.route("/api/ssw/sys/Organize/List", get(sys::organize_list))
.route("/api/ssw/sys/Organize/Save", post(sys::organize_save))
.route("/api/ssw/sys/Organize/Delete", delete(sys::organize_delete))
// ---- 菜单(§6.2 / §7.4)----
.route("/api/ssw/sys/Module/List", get(sys::module_list))
.route("/api/ssw/sys/Module/Save", post(sys::module_save))
.route("/api/ssw/sys/Module/Delete", delete(sys::module_delete))
// ---- 授权(§6.3 / §7.5)----
// 🔴 全仓唯一的路径参数(axum 0.8 的花括号语法)。
.route(
"/api/permission/Authority/Data/{objectId}",
put(sys::authority_data),
)
.route(
"/api/permission/Authority/RoleModules",
get(sys::authority_role_modules),
)
// ---- 业务模块(§6.4 / §7.6):demo / shop / books ----
// 🔴 **业务路由不在本文件注册** —— 每个业务模块自带 `router()`(`modules/<app>.rs`),
// 这里只 merge 一次 ⇒ 加业务模块**不动本文件**(对齐 react 版的 module 注册)。
// ---- 面 B:官方 JNPF 契约面(`JNPF_COMPAT_SURFACE.md` §3)----
// 🔴 **面 A 的 27 条路由一个都没动** —— 面 B 全部是**新增**的官方形状路径。
// 唯一共用的是 `CurrentUser` / `Authority/Data`,它们按**判别头**分流
// (`Vue-Version: 3` ⇒ 面 B)。
// 🔴 **一条 `.route()` 只挂一个方法**:`scripts/check-contract-scan.py` 只解析
// 每个 `.route(path, <method>(handler))` 的第一个方法调用;写成
// `get(a).post(b)` 会让 CC3 认为「契约写 POST、代码是 GET」。
// 同一路径多次 `.route()` 在 axum 里是**合并**(方法不冲突即可)。
.route("/api/permission/Users", get(compat::permission::users_list))
.route("/api/permission/Users", post(compat::permission::user_create))
.route("/api/permission/Users/{id}", get(compat::helper::user_info))
.route("/api/permission/Users/{id}", put(compat::permission::user_update))
.route("/api/permission/Users/{id}", delete(compat::permission::user_delete))
.route(
"/api/permission/Users/BatchDelete",
post(compat::permission::users_batch_delete),
)
.route(
"/api/permission/Users/BatchUpdateState",
post(compat::permission::users_batch_update_state),
)
.route(
"/api/permission/Users/{id}/GetPosition",
get(compat::permission::user_get_position),
)
.route(
"/api/permission/Users/{id}/Actions/ResetPassword",
post(compat::permission::user_reset_password),
)
.route(
"/api/permission/Users/{id}/Actions/unlock",
put(compat::permission::user_unlock),
)
// ---- 会话与前端启动(面 B):这两条是**打开第一个页面之前**就会被打的 ----
// 🔴 `Logout` 恒成功(前端把返回值包在 try/catch 里丢弃,但 404 会弹红条)。
.route("/api/oauth/Logout", post(compat::core::logout_handler))
// 🔴 i18n 远端词条包:登录成功后立刻被 `locales/index.ts` 拉,缺了会炸整个 app。
.route("/api/system/BaseLang/LangJson", get(compat::system::base_lang_json))
// ---- 用户分组(用户管理页左侧树)----
.route("/api/permission/Group", get(compat::permission::group_list))
.route("/api/permission/Group", post(compat::permission::group_create))
.route("/api/permission/Group/{id}", get(compat::permission::group_info))
.route("/api/permission/Group/{id}", put(compat::permission::group_update))
.route("/api/permission/Group/{id}", delete(compat::permission::group_delete))
.route(
"/api/permission/Group/{id}/Actions/AddUser",
post(compat::permission::group_add_user),
)
.route(
"/api/permission/Group/{id}/Actions/DeleteUser",
post(compat::permission::group_remove_user),
)
// ---- 岗位 / 交接 / 第三方 ----
// 🔴 `SetPositionBatch` 必须**单独注册**:挂在 `/Users/{id}` 上会被当 id 吃掉。
.route(
"/api/permission/Users/SetPositionBatch",
post(compat::permission::users_set_position_batch),
)
.route(
"/api/permission/Users/workHandover",
post(compat::permission::users_work_handover),
)
.route(
"/api/permission/Users/{id}/SetPosition",
post(compat::permission::user_set_position),
)
.route(
"/api/permission/Users/{id}/SelectorByUserPosId",
get(compat::permission::user_selector_by_pos_id),
)
.route("/api/permission/Users/Selector", get(compat::permission::users_selector))
.route("/api/permission/Users/getUserList", post(compat::permission::users_get_user_list))
.route("/api/permission/Users/getSelectedList", post(compat::permission::users_get_selected_list))
.route("/api/permission/Users/getSelectedUserList", post(compat::permission::users_get_selected_user_list))
.route("/api/permission/Users/ReceiveUserList", get(compat::permission::users_receive_user_list))
.route("/api/permission/Users/getAllPermission", get(compat::permission::users_get_all_permission))
.route("/api/permission/Users/Authorize", get(compat::permission::users_authorize))
.route("/api/permission/Authority/{kind}/{objectId}", get(compat::permission::authority_common_values))
.route("/api/permission/Authority/{kind}/{objectId}", post(compat::permission::authority_common_update))
.route("/api/permission/RoleRelation/roleList", get(compat::permission::role_relation_role_list))
.route("/api/permission/RoleRelation/addRoles", post(compat::permission::role_relation_add_roles))
.route("/api/permission/RoleRelation/deleteRoles", post(compat::permission::role_relation_delete_roles))
.route("/api/permission/RoleRelation/delete", post(compat::permission::role_relation_delete))
.route("/api/permission/UserRelation", post(compat::permission::user_relation_create))
.route("/api/permission/UserRelation/delete", post(compat::permission::user_relation_delete))
.route("/api/permission/UserRelation/userList", get(compat::permission::user_relation_user_list))
.route(
"/api/system/System/getDevUser",
get(compat::system::system_get_dev_user),
)
// ---- 应用中心(官方 `SystemController.java`)----
// 🔴 一条 `.route()` 只挂一个方法(契约扫描器只看第一个方法)。
.route("/api/system/System", get(compat::system::system_list))
.route("/api/system/System", post(compat::system::system_create))
.route("/api/system/System/Selector", get(compat::system::system_selector))
.route(
"/api/system/System/userAuthList",
get(compat::system::system_user_auth_list),
)
.route(
"/api/system/System/actionTop",
post(compat::system::system_action_top),
)
.route(
"/api/system/System/getAppAuthorization/{id}",
get(compat::system::system_app_auth_get),
)
.route(
"/api/system/System/saveAppAuthorization",
post(compat::system::system_app_auth_save),
)
.route(
"/api/system/System/changeAppAuthorization",
post(compat::system::system_app_auth_change),
)
.route("/api/system/System/{id}", get(compat::system::system_info))
.route("/api/system/System/{id}", put(compat::system::system_update))
.route("/api/system/System/{id}", delete(compat::system::system_delete))
.route(
"/api/system/System/{id}/Actions/Copy",
post(compat::system::system_copy),
)
.route(
"/api/system/System/preferenceSave/{id}",
post(compat::system::system_preference_save),
)
// ---- 标签(应用中心页一进来就拉 selector)----
.route("/api/system/Tag", get(compat::system::tag_list))
.route("/api/system/Tag", post(compat::system::tag_create))
.route("/api/system/Tag/selector", get(compat::system::tag_selector))
.route("/api/system/Tag/{id}", get(compat::system::tag_info))
.route("/api/system/Tag/{id}", put(compat::system::tag_update))
.route("/api/system/Tag/{id}", delete(compat::system::tag_delete))
// ---- 消息业务分类(消息记录页左侧两级页签 + 公告类型下拉)----
.route(
"/api/system/BusinessCategory",
get(compat::system::business_category_list),
)
.route(
"/api/system/BusinessCategory",
post(compat::system::business_category_create),
)
.route(
"/api/system/BusinessCategory/treeList",
get(compat::system::business_category_tree_list),
)
.route(
"/api/system/BusinessCategory/selector",
get(compat::system::business_category_selector),
)
.route(
"/api/system/BusinessCategory/{id}",
get(compat::system::business_category_info),
)
.route(
"/api/system/BusinessCategory/{id}",
put(compat::system::business_category_update),
)
.route(
"/api/system/BusinessCategory/{id}",
delete(compat::system::business_category_delete),
)
// ---- 站内消息(消息记录页 / 首页铃铛)----
.route("/api/message", get(compat::message::message_list))
.route("/api/message/Actions/ReadAll", post(compat::message::message_read_all))
.route("/api/message/ReadInfo/{id}", get(compat::message::message_read_info))
.route("/api/message/Record", delete(compat::message::message_record_delete))
.route("/api/message/Reply/{id}", post(compat::message::message_reply))
// ---- 系统公告(公告管理页)----
.route("/api/message/Notice/List", post(compat::message::notice_list))
.route("/api/message/Notice", post(compat::message::notice_create))
.route("/api/message/Notice/{id}", get(compat::message::notice_info))
.route("/api/message/Notice/{id}", put(compat::message::notice_update))
.route("/api/message/Notice/{id}", delete(compat::message::notice_delete))
.route(
"/api/message/Notice/{id}/Actions/Release",
put(compat::message::notice_release),
)
.route(
"/api/message/Notice/{id}/ReplyUserList",
get(compat::message::notice_reply_user_list),
)
// ---- 系统日志(sysLog 四个页面 + 个人中心登录日志)----
// 🔴 `Log/deleteLoginLog` / `Log/ModuleName` 是静态段,matchit 里**优先于**
// `Log/{id}` 参数段 ⇒ 两条同时存在也不会互相抢(以测试钉住)。
// 🔴 `/Log/{id}` 上同时挂 GET(详情)与 DELETE(按分类一键清空)——
// 官方也是这么复用的(`@DeleteMapping("/{type}")` + `@GetMapping("/{id}")`),
// 段名必须统一写 `{id}`(matchit 不允许同一位置两个不同的参数名)。
.route("/api/system/Log", get(compat::system::log_list))
.route("/api/system/Log", delete(compat::system::log_delete))
.route("/api/system/Log/deleteLoginLog", delete(compat::system::log_clear_login))
.route("/api/system/Log/ModuleName", get(compat::system::log_module_name))
.route("/api/system/Log/{id}", delete(compat::system::log_clear))
.route("/api/system/Log/{id}", get(compat::system::log_info))
// ---- 审批常用语(模板中心 / 常用语)----
.route("/api/system/CommonWords", get(compat::system::common_words_list))
.route("/api/system/CommonWords", post(compat::system::common_words_create))
.route(
"/api/system/CommonWords/Selector",
get(compat::system::common_words_selector),
)
.route(
"/api/system/CommonWords/UsesNum",
post(compat::system::common_words_uses_num),
)
.route(
"/api/system/CommonWords/{id}",
get(compat::system::common_words_info),
)
.route(
"/api/system/CommonWords/{id}",
put(compat::system::common_words_update),
)
.route(
"/api/system/CommonWords/{id}",
delete(compat::system::common_words_delete),
)
// ---- 单据规则(模板中心 / 单据规则 + 各种「自动单号」)----
.route("/api/system/BillRule", get(compat::system::bill_rule_list))
.route("/api/system/BillRule", post(compat::system::bill_rule_create))
.route(
"/api/system/BillRule/Selector",
get(compat::system::bill_rule_selector),
)
.route(
"/api/system/BillRule/BillNumber/{enCode}",
get(compat::system::bill_rule_number),
)
.route(
"/api/system/BillRule/Actions/Import",
post(compat::system::bill_rule_import),
)
.route("/api/system/BillRule/{id}", get(compat::system::bill_rule_info))
.route("/api/system/BillRule/{id}", put(compat::system::bill_rule_update))
.route(
"/api/system/BillRule/{id}",
delete(compat::system::bill_rule_delete),
)
.route(
"/api/system/BillRule/{id}/Actions/State",
put(compat::system::bill_rule_state),
)
.route(
"/api/system/BillRule/{id}/Actions/Export",
get(compat::system::bill_rule_export),
)
// ---- 数据连接(官方 `DbLinkController`,路由前缀 `DataSource`)----
// 🔴 `Selector` / `getGroup` 是**静态段**,`{id}` 是参数段 —— matchit 静态优先,
// 两者不冲突(`/DataSource/getGroup` 不会被 `/DataSource/{id}` 抢走)。
.route("/api/system/DataSource", get(compat::system::data_source_list))
.route("/api/system/DataSource", post(compat::system::data_source_create))
.route(
"/api/system/DataSource/Selector",
get(compat::system::data_source_selector),
)
.route(
"/api/system/DataSource/getGroup",
get(compat::system::data_source_group),
)
.route(
"/api/system/DataSource/Actions/Test",
post(compat::system::data_source_test),
)
.route("/api/system/DataSource/{id}", get(compat::system::data_source_info))
.route(
"/api/system/DataSource/{id}",
put(compat::system::data_source_update),
)
.route(
"/api/system/DataSource/{id}",
delete(compat::system::data_source_delete),
)
// ---- 数据建模的查询面(官方 `DbTableController`,路由前缀 `DataModel`)----
// 🔴 `{linkId}` 一律**忽略**(本仓只有一个内置库);保留段位是为了让
// 官方前端的 URL 形状原样命中。
// ---- 数据中心(批次 14):基准类型 / 控件映射 / 数据库 / 字段类型映射 / 常用字段 ----
// 🔴 这两族的**列表**在批次 5(数据模型)就接上了,本轮补齐 info/增删改;
// 列表与新建合并进同一行(同一个 `MethodRouter`)。
// ⚠️ 同一 path 只能 `.route()` **一次** —— axum 对重复注册会 panic
// (`Overlapping method route`)⇒ create 不能另起一行。
.route(
"/api/system/BasicDataType",
get(compat::system::basic_data_type_list).post(compat::system::basic_data_type_create),
)
.route(
"/api/system/BasicDataType/{id}",
get(compat::system::basic_data_type_info)
.put(compat::system::basic_data_type_update)
.delete(compat::system::basic_data_type_delete),
)
.route(
"/api/system/DataTypeMapping",
get(compat::system::data_type_mapping_list).post(compat::system::data_type_mapping_create),
)
// 🔴 静态段 `getKeyList` 必须**先于**参数段 `/{id}` 注册的直觉仍然成立
// (axum/matchit 本身是静态优先,这里按可读性排)。
.route(
"/api/system/DataTypeMapping/getKeyList",
get(compat::system::data_type_mapping_key_list),
)
.route(
"/api/system/DataTypeMapping/{id}",
get(compat::system::data_type_mapping_info)
.put(compat::system::data_type_mapping_update)
.delete(compat::system::data_type_mapping_delete),
)
.route(
"/api/system/DataBase",
get(compat::system::data_base_list).post(compat::system::data_base_create),
)
.route(
"/api/system/DataBase/{id}",
get(compat::system::data_base_info)
.put(compat::system::data_base_update)
.delete(compat::system::data_base_delete),
)
.route(
"/api/system/DataTypeRelation",
get(compat::system::data_type_relation_list).post(compat::system::data_type_relation_create),
)
.route(
"/api/system/DataTypeRelation/{id}",
get(compat::system::data_type_relation_info)
.put(compat::system::data_type_relation_update)
.delete(compat::system::data_type_relation_delete),
)
.route(
"/api/system/CommonFields",
get(compat::system::common_fields_list).post(compat::system::common_fields_create),
)
.route(
"/api/system/CommonFields/{id}",
get(compat::system::common_fields_info)
.put(compat::system::common_fields_update)
.delete(compat::system::common_fields_delete),
)
// ---- 数据同步(四条一律明确拒绝:本仓无跨库能力,见 `face_b` 的注释)----
.route("/api/system/DataSync", post(compat::system::data_sync_check))
.route(
"/api/system/DataSync/Actions/checkDbLink",
post(compat::system::data_sync_check_db_link),
)
.route(
"/api/system/DataSync/Actions/Execute",
post(compat::system::data_sync_execute),
)
.route(
"/api/system/DataSync/Actions/batchExecute",
post(compat::system::data_sync_batch_execute),
)
.route(
"/api/system/DataInterfaceVariate/Selector",
get(compat::system::data_interface_variate_selector),
)
.route(
"/api/system/DataModel/{linkId}/Tables",
get(compat::system::data_model_tables),
)
.route(
"/api/system/DataModel/{linkId}/TableAll",
get(compat::system::data_model_table_all),
)
.route(
"/api/system/DataModel/{linkId}/Table/{tableName}",
get(compat::system::data_model_info),
)
.route(
"/api/system/DataModel/{linkId}/Tables/{tableName}/Fields",
get(compat::system::data_model_fields),
)
.route(
"/api/system/DataModel/{linkId}/Tables/{tableName}/Fields/Selector",
get(compat::system::data_model_fields_selector),
)
.route(
"/api/system/DataModel/{linkId}/Table/{tableName}/Preview",
get(compat::system::data_model_preview),
)
// ---- 数据建模的写面(真 DDL:建表 / 改表 / 加字段 / 删表 / 复制)----
// 🔴 两条护栏在 handler 里:`db_ident` 标识符白名单 + `is_builtin_table`
// (`schema.sql` 定义过的 35 张只给看,禁改禁删)。
.route(
"/api/system/DataModel/{linkId}/Table",
post(compat::system::data_model_create),
)
.route(
"/api/system/DataModel/{linkId}/Table",
put(compat::system::data_model_update),
)
.route(
"/api/system/DataModel/{linkId}/addFields",
put(compat::system::data_model_add_fields),
)
.route(
"/api/system/DataModel/{linkId}/Table/{tableName}",
delete(compat::system::data_model_delete),
)
.route(
"/api/system/DataModel/{linkId}/deleteAllTable",
delete(compat::system::data_model_delete_all),
)
.route(
"/api/system/DataModel/{linkId}/Table/{tableName}/Actions/Copy",
post(compat::system::data_model_copy),
)
.route(
"/api/system/DataModel/{linkId}/Table/{tableName}/Actions/Export",
get(compat::system::data_model_export),
)
.route(
"/api/system/DataModel/{linkId}/Actions/Import",
post(compat::system::data_model_import),
)
// ---- 数据集(官方 `DataSetController`)----
// 🔴 这是全仓**唯一**执行用户手写 SQL 的地方。三道护栏在 `dataset_sql_guard`:
// 只放行 select/with、不许有分号、按词边界扫危险动词。
// 变量 `${xxx}` / `@xxx` 一律转 `$N` **绑定**,不拼文本。
.route("/api/system/Dataset", get(compat::system::dataset_list))
.route("/api/system/Dataset", post(compat::system::dataset_create))
.route("/api/system/Dataset/getList", get(compat::system::dataset_get_list))
.route("/api/system/Dataset/previewSql", post(compat::system::dataset_preview_sql))
.route("/api/system/Dataset/fields", post(compat::system::dataset_fields))
.route(
"/api/system/Dataset/Actions/Import",
post(compat::system::dataset_import),
)
.route(
"/api/system/Dataset/GetParam/{id}",
get(compat::system::dataset_get_param),
)
.route("/api/system/Dataset/{id}", get(compat::system::dataset_info))
.route("/api/system/Dataset/{id}", put(compat::system::dataset_update))
.route("/api/system/Dataset/{id}", delete(compat::system::dataset_delete))
.route("/api/system/Dataset/{id}/get", get(compat::system::dataset_des_get))
.route("/api/system/Dataset/{id}/save", post(compat::system::dataset_des_save))
.route(
"/api/system/Dataset/{id}/Actions/Export",
get(compat::system::dataset_export),
)
.route(
"/api/system/Dataset/{id}/Actions/Copy",
post(compat::system::dataset_copy),
)
.route(
"/api/system/Dataset/{id}/Actions/Preview",
post(compat::system::dataset_preview),
)
.route(
"/api/system/Dataset/{id}/Actions/List",
post(compat::system::dataset_actions_list),
)
.route(
"/api/system/Dataset/{id}/Actions/InfoByIds",
post(compat::system::dataset_info_by_ids),
)
.route(
"/api/system/Dataset/{id}/Actions/getRes",
post(compat::system::dataset_get_res),
)
// ---- 数据接口(官方 `DataInterfaceController.java`,权限 `dataCenter.dataService`)----
// 🔴 `Actions/Preview` 复用 Dataset 的 SQL 护栏 + 绑定引擎(`dataset_run`)。
.route("/api/system/DataInterface", get(compat::system::data_interface_list))
.route("/api/system/DataInterface", post(compat::system::data_interface_create))
.route(
"/api/system/DataInterface/getList",
get(compat::system::data_interface_get_list),
)
.route(
"/api/system/DataInterface/GetParam/{id}",
get(compat::system::data_interface_get_param),
)
.route("/api/system/DataInterface/{id}", get(compat::system::data_interface_info))
.route(
"/api/system/DataInterface/{id}",
put(compat::system::data_interface_update),
)
.route(
"/api/system/DataInterface/{id}",
delete(compat::system::data_interface_delete),
)
.route(
"/api/system/DataInterface/{id}/get",
get(compat::system::data_interface_get),
)
.route(
"/api/system/DataInterface/{id}/save",
post(compat::system::data_interface_save),
)
.route(
"/api/system/DataInterface/{id}/Actions/Copy",
post(compat::system::data_interface_copy),
)
.route(
"/api/system/DataInterface/{id}/Actions/Export",
get(compat::system::data_interface_export),
)
.route(
"/api/system/DataInterface/{id}/Actions/Preview",
post(compat::system::data_interface_preview),
)
// ---- 接口认证(官方 `InterfaceOauthController.java`,权限 `integrationCenter.openApi`)----
.route(
"/api/system/InterfaceOauth",
get(compat::system::interface_oauth_list),
)
.route(
"/api/system/InterfaceOauth",
post(compat::system::interface_oauth_create),
)
.route(
"/api/system/InterfaceOauth/getAppId",
get(compat::system::interface_oauth_get_app_id),
)
.route(
"/api/system/InterfaceOauth/getInterfaceList",
post(compat::system::interface_oauth_get_interface_list),
)
.route(
"/api/system/InterfaceOauth/dataInterfaceLog/{id}",
get(compat::system::interface_oauth_data_interface_log),
)
.route(
"/api/system/InterfaceOauth/interfaceSelector",
get(compat::system::interface_oauth_interface_selector),
)
.route(
"/api/system/InterfaceOauth/SaveUserList",
post(compat::system::interface_oauth_save_user_list),
)
.route(
"/api/system/InterfaceOauth/{id}",
get(compat::system::interface_oauth_info),
)
.route(
"/api/system/InterfaceOauth/{id}",
put(compat::system::interface_oauth_update),
)
.route(
"/api/system/InterfaceOauth/{id}",
delete(compat::system::interface_oauth_delete),
)
// ---- 打印模板(官方 `PrintDevController.java`,权限 `onlineDev.printDev`)----
// 🔴 打印渲染引擎不在本仓 ⇒ `Actions/Export` / `BatchData` 返回业务失败 400。
.route("/api/system/printDev", get(compat::system::print_dev_list))
.route("/api/system/printDev", post(compat::system::print_dev_create))
.route(
"/api/system/printDev/Selector",
get(compat::system::print_dev_selector),
)
.route(
"/api/system/printDev/WorkSelector",
get(compat::system::print_dev_work_selector),
)
.route(
"/api/system/printDev/getListOptions",
post(compat::system::print_dev_get_list_options),
)
.route("/api/system/printDev/{id}", get(compat::system::print_dev_info))
.route("/api/system/printDev/{id}", put(compat::system::print_dev_update))
.route(
"/api/system/printDev/{id}",
delete(compat::system::print_dev_delete),
)
.route(
"/api/system/printDev/{id}/Actions/Copy",
post(compat::system::print_dev_copy),
)
.route(
"/api/system/printDev/{id}/Actions/Export",
get(compat::system::print_dev_export),
)
.route(
"/api/system/printDev/{id}/Actions/Preview",
get(compat::system::print_dev_preview),
)
.route(
"/api/system/printDev/BatchData",
post(compat::system::print_dev_batch_data),
)
.route("/api/system/printDev/Save", post(compat::system::print_dev_save))
.route(
"/api/system/printDev/Info/{id}",
get(compat::system::print_dev_version_info),
)
.route(
"/api/system/printDev/Version/{id}",
get(compat::system::print_dev_version_list),
)
.route(
"/api/system/printDev/Info/{id}",
post(compat::system::print_dev_version_copy),
)
.route(
"/api/system/printDev/Info/{id}",
delete(compat::system::print_dev_version_delete),
)
// ---- 电子签章(官方 `SignatureController.java`;官方**无** `@SaCheckPermission`)----
.route("/api/system/Signature", get(compat::system::signature_list))
.route("/api/system/Signature", post(compat::system::signature_create))
.route(
"/api/system/Signature/Selector",
get(compat::system::signature_selector),
)
.route(
"/api/system/Signature/ListByIds",
post(compat::system::signature_list_by_ids),
)
.route("/api/system/Signature/{id}", get(compat::system::signature_info))
.route("/api/system/Signature/{id}", put(compat::system::signature_update))
.route(
"/api/system/Signature/{id}",
delete(compat::system::signature_delete),
)
// ---- 按钮权限(官方 `ModuleButtonController.java`,权限 OR 两码)----
.route(
"/api/system/ModuleButton",
post(compat::system::module_button_create),
)
.route(
"/api/system/ModuleButton/selectActions/{menuId}",
post(compat::system::module_button_select_actions),
)
.route(
"/api/system/ModuleButton/{menuId}/List",
get(compat::system::module_button_list),
)
.route(
"/api/system/ModuleButton/{menuId}/Selector",
get(compat::system::module_button_selector),
)
.route("/api/system/ModuleButton/{id}", get(compat::system::module_button_info))
.route(
"/api/system/ModuleButton/{id}",
put(compat::system::module_button_update),
)
.route(
"/api/system/ModuleButton/{id}",
delete(compat::system::module_button_delete),
)
// ---- 列表权限(官方 `ModuleColumnController.java`)----
.route(
"/api/system/ModuleColumn",
post(compat::system::module_column_create),
)
.route(
"/api/system/ModuleColumn/Actions/Batch",
post(compat::system::module_column_batch_create),
)
.route(
"/api/system/ModuleColumn/{moduleId}/Fields",
get(compat::system::module_column_list),
)
.route("/api/system/ModuleColumn/{id}", get(compat::system::module_column_info))
.route(
"/api/system/ModuleColumn/{id}",
put(compat::system::module_column_update),
)
.route(
"/api/system/ModuleColumn/{id}",
delete(compat::system::module_column_delete),
)
// ---- 表单权限(官方 `ModuleFormController.java`)----
.route("/api/system/ModuleForm", post(compat::system::module_form_create))
.route(
"/api/system/ModuleForm/Actions/Batch",
post(compat::system::module_form_batch_create),
)
.route(
"/api/system/ModuleForm/{moduleId}/Fields",
get(compat::system::module_form_list),
)
.route("/api/system/ModuleForm/{id}", get(compat::system::module_form_info))
.route(
"/api/system/ModuleForm/{id}",
put(compat::system::module_form_update),
)
.route(
"/api/system/ModuleForm/{id}",
delete(compat::system::module_form_delete),
)
// ---- 高级查询方案(官方 `AdvancedQueryController.java`;官方**无** `@SaCheckPermission`)----
.route(
"/api/system/AdvancedQuery",
post(compat::system::advanced_query_create),
)
.route(
"/api/system/AdvancedQuery/{moduleId}/List",
get(compat::system::advanced_query_list),
)
.route(
"/api/system/AdvancedQuery/{id}",
get(compat::system::advanced_query_info),
)
.route(
"/api/system/AdvancedQuery/{id}",
put(compat::system::advanced_query_update),
)
.route(
"/api/system/AdvancedQuery/{id}",
delete(compat::system::advanced_query_delete),
)
// ---- 数据权限三件套(官方 `ModuleDataAuthorize(Controller/Scheme/Link)Controller`)----
.route(
"/api/system/ModuleDataAuthorize",
post(compat::system::module_data_authorize_create),
)
.route(
"/api/system/ModuleDataAuthorize/{moduleId}/List",
get(compat::system::module_data_authorize_list),
)
.route(
"/api/system/ModuleDataAuthorize/{moduleId}/FieldList",
get(compat::system::module_data_authorize_field_list),
)
.route("/api/system/ModuleDataAuthorize/{id}", get(compat::system::module_data_authorize_info))
.route(
"/api/system/ModuleDataAuthorize/{id}",
put(compat::system::module_data_authorize_update),
)
.route(
"/api/system/ModuleDataAuthorize/{id}",
delete(compat::system::module_data_authorize_delete),
)
.route(
"/api/system/ModuleDataAuthorizeScheme",
post(compat::system::module_data_authorize_scheme_create),
)
.route(
"/api/system/ModuleDataAuthorizeScheme/{moduleId}/List",
get(compat::system::module_data_authorize_scheme_list),
)
.route(
"/api/system/ModuleDataAuthorizeScheme/{id}",
get(compat::system::module_data_authorize_scheme_info),
)
.route(
"/api/system/ModuleDataAuthorizeScheme/{id}",
put(compat::system::module_data_authorize_scheme_update),
)
.route(
"/api/system/ModuleDataAuthorizeScheme/{id}",
delete(compat::system::module_data_authorize_scheme_delete),
)
.route(
"/api/system/ModuleDataAuthorizeLink/saveLinkData",
post(compat::system::module_data_authorize_link_save),
)
.route(
"/api/system/ModuleDataAuthorizeLink/getVisualTables/{menuId}/{type}",
get(compat::system::module_data_authorize_link_visual_tables),
)
.route(
"/api/system/ModuleDataAuthorizeLink/getInfo/{menudId}/{type}",
get(compat::system::module_data_authorize_link_info),
)
.route(
"/api/system/ModuleDataAuthorizeLink/{linkId}/Tables/{tableName}/Fields/{menuType}/{dataType}",
get(compat::system::module_data_authorize_link_table_fields),
)
// ---- 系统配置 + 第三方同步(官方 `SysConfigController` / `SynThirdInfoController`)----
.route("/api/system/SysConfig", get(compat::system::sys_config_get))
.route("/api/system/SysConfig", put(compat::system::sys_config_update))
.route(
"/api/system/SysConfig/socials",
get(compat::system::sys_config_socials_get),
)
.route(
"/api/system/SysConfig/socials",
put(compat::system::sys_config_socials_update),
)
.route(
"/api/system/SysConfig/getAdminList",
get(compat::system::sys_config_admin_list),
)
.route(
"/api/system/SysConfig/setAdminList",
put(compat::system::sys_config_admin_set),
)
.route(
"/api/system/SysConfig/{type}/testQyWebChatConnect",
post(compat::system::sys_config_test_qy),
)
.route(
"/api/system/SysConfig/testDingTalkConnect",
post(compat::system::sys_config_test_ding),
)
.route("/api/system/SynThirdInfo", post(compat::system::syn_third_info_sync))
.route(
"/api/system/SynThirdInfo/getSynThirdTotal/{type}",
get(compat::system::syn_third_info_total),
)
.route(
"/api/system/SynThirdInfo/clearAllSyn",
get(compat::system::syn_third_info_clear),
)
.route(
"/api/system/SynThirdInfo/getHandleNum",
get(compat::system::syn_third_info_handle_num),
)
.route("/api/permission/socials/{id}", delete(compat::permission::socials_delete))
// ---- 前端每页都拉的公共接口(本仓无对应表 ⇒ 保守空形状,但必须是 200)----
.route(
"/api/system/DictionaryData/All",
get(compat::system::dictionary_data_all),
)
.route("/api/system/DictionaryType", get(compat::system::dict_type_list))
.route("/api/system/DictionaryType", post(compat::system::dict_type_create))
.route("/api/system/DictionaryType/Selector/{id}", get(compat::system::dict_type_selector))
.route("/api/system/DictionaryType/{id}", get(compat::system::dict_type_info))
.route("/api/system/DictionaryType/{id}", put(compat::system::dict_type_update))
.route("/api/system/DictionaryType/{id}", delete(compat::system::dict_type_delete))
.route("/api/system/DictionaryData", post(compat::system::dict_data_create))
.route("/api/system/DictionaryData/{id}", get(compat::system::dict_data_list))
.route("/api/system/DictionaryData/{id}/Data/Selector", get(compat::system::dict_data_selector))
.route("/api/system/DictionaryData/{id}/Selector/{pid}", get(compat::system::dict_data_selector_tree))
.route("/api/system/DictionaryData/{id}/Info", get(compat::system::dict_data_info))
.route("/api/system/DictionaryData/{id}", put(compat::system::dict_data_update))
.route("/api/system/DictionaryData/{id}", delete(compat::system::dict_data_delete))
.route("/api/system/DictionaryData/{id}/Actions/Export", get(compat::system::dict_data_export))
.route("/api/system/HomeData", get(compat::system::home_data))
.route(
"/api/system/MenuData/useModuleNum/{id}",
post(compat::system::menu_data_use_module_num),
)
// 🔴 登录**前**就会拉 ⇒ 不能挂守卫。
.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))
.route("/api/permission/Role/RoleCondition", post(compat::permission::role_condition))
.route("/api/permission/Role/{id}", get(compat::permission::role_info))
.route("/api/permission/Role/{id}", put(compat::permission::role_update))
.route("/api/permission/Role/{id}", delete(compat::permission::role_delete))
.route("/api/permission/Position", get(compat::permission::position_list))
.route("/api/permission/Position", post(compat::permission::position_create))
.route("/api/permission/Position/Selector", get(compat::permission::position_selector))
.route("/api/permission/Position/SelectorTree", get(compat::permission::position_selector_tree))
.route("/api/permission/Position/PositionCondition", post(compat::permission::position_condition))
.route("/api/permission/Position/SelectedList", post(compat::permission::position_selected_list))
.route("/api/permission/Position/{id}", get(compat::permission::position_info))
.route("/api/permission/Position/{id}", put(compat::permission::position_update))
.route("/api/permission/Position/{id}", delete(compat::permission::position_delete))
.route("/api/permission/Position/{id}/Actions/DutyPosition", post(compat::permission::position_duty_position))
.route("/api/permission/Position/{id}/Actions/DutyUser", post(compat::permission::position_duty_user))
.route("/api/permission/Group/Selector", get(compat::permission::group_selector))
.route("/api/permission/Organize/AsyncPosList", get(compat::permission::organize_async_pos_list))
.route(
"/api/permission/Organize/AsyncList/{id}",
get(compat::permission::organize_async_list),
)
.route("/api/permission/Organize", get(compat::permission::organize_list))
.route("/api/permission/Organize", post(compat::permission::organize_create))
.route("/api/permission/Organize/Selector", get(compat::permission::organize_selector))
.route("/api/permission/Organize/{id}", get(compat::permission::organize_info))
.route("/api/permission/Organize/{id}", put(compat::permission::organize_update))
.route("/api/permission/Organize/{id}", delete(compat::permission::organize_delete))
.route("/api/system/Menu/ModuleBySystem", get(compat::system::module_by_system))
.route("/api/system/Menu", post(compat::system::menu_create))
.route("/api/system/Menu/Selector/All", get(compat::system::menu_selector_all))
.route("/api/system/Menu/Selector/Form", get(compat::system::menu_selector_form))
.route("/api/system/Menu/Selector/Page", get(compat::system::menu_selector_page))
.route("/api/system/Menu/getSystemMenu", get(compat::system::menu_get_system_menu))
.route("/api/system/Menu/{id}", get(compat::system::menu_info))
.route("/api/system/Menu/{id}", put(compat::system::menu_update))
.route("/api/system/Menu/{id}", delete(compat::system::menu_delete))
.route("/api/system/Menu/{id}/Actions/Export", get(compat::system::menu_export))
.route("/api/system/Menu/getPermissionGroup/{id}", get(compat::system::menu_permission_group))
.route("/api/system/Menu/getPermission/{id}/{permissionId}", get(compat::system::menu_permission_info))
.route("/api/system/Menu/Selector/{id}", get(compat::system::menu_selector))
.route("/api/system/Menu/SelectorFilter/{id}", get(compat::system::menu_selector_filter))
// 🔴 官方是 `POST /api/permission/Authority/Data/{objectId}/Values`
// —— 与面 A 的 `PUT .../Data/{objectId}` **同前缀不同方法不同路径**
// ⇒ matchit 0.8.4 允许「静态段跟在参数节点后」⇒ 两条可共存。
.route(
"/api/permission/Authority/Data/{objectId}/Values",
post(compat::permission::authority_values),
)
// ---- 个人设置(`permission/Users/Current/*`)----
// 🔴 **必须内联 `require_login_face_b(&state, &headers)`**(不抽辅助函数):
// `check-contract-scan.py` 的 CC6 是**静态扫 handler 函数体**找守卫调用
// ⇒ 委托型包装(`self_user(...)`)推不出守卫 ⇒ CC6 必红。
// 🔴 `{id}` 与静态段共存要小心 matchit 优先级:
// `Users/Current/{id}/SignImg` 里的 `{id}` **不会**吃掉 `Users/Current/SignImg`
// (后者是静态段更具体 ⇒ 优先匹配)。
.route(
"/api/permission/Users/Current/BaseInfo",
get(compat::permission::self_base_info),
)
.route(
"/api/permission/Users/Current/BaseInfo",
put(compat::permission::self_update_base_info),
)
.route(
"/api/permission/Users/Current/Avatar",
put(compat::permission::self_update_avatar),
)
.route(
"/api/permission/Users/Current/SystemTheme",
put(compat::permission::self_update_theme),
)
.route(
"/api/permission/Users/Current/SystemLanguage",
put(compat::permission::self_update_language),
)
.route(
"/api/permission/Users/Current/Actions/ModifyPassword",
post(compat::permission::self_modify_password),
)
.route(
"/api/permission/Users/Current/Subordinate/{id}",
get(compat::permission::self_subordinate),
)
.route(
"/api/permission/Users/Current/SystemLog",
get(compat::permission::self_system_log),
)
.route(
"/api/permission/Users/Current/getUserOrganizes",
get(compat::permission::self_organizes),
)
.route(
"/api/permission/Users/Current/getUserPositions",
get(compat::permission::self_positions),
)
.route(
"/api/permission/Users/Current/getUserRoles",
get(compat::permission::self_roles),
)
.route("/api/permission/Users/Current/major", put(compat::permission::self_major))
.route(
"/api/permission/Users/Current/SignImg",
get(compat::permission::self_sign_list),
)
.route(
"/api/permission/Users/Current/SignImg",
post(compat::permission::self_sign_create),
)
.route(
"/api/permission/Users/Current/{id}/SignImg",
delete(compat::permission::self_sign_delete),
)
.route(
"/api/permission/Users/Current/{id}/SignImg",
put(compat::permission::self_sign_default),
)
.route(
"/api/permission/Users/Current/getAppSecret",
get(compat::permission::self_get_app_secret),
)
.route(
"/api/permission/Users/Current/saveAppSecret",
put(compat::permission::self_save_app_secret),
)
.route(
"/api/permission/Users/Current/saasList",
get(compat::permission::self_saas_list),
)
.route(
"/api/permission/Users/Current/saasinfo",
get(compat::permission::self_saas_info),
)
.route(
"/api/permission/Users/Current/saasTenantName/{id}",
get(compat::permission::self_saas_tenant_name),
)
.route(
"/api/permission/Users/Current/saasjoin",
post(compat::permission::self_saas_join),
)
.route(
"/api/permission/Users/Current/{id}/saas",
delete(compat::permission::self_saas_exit),
)
// ---- 身份管理(`permission/Standing`)----
//
// 🔴 **一条 `.route()` 只挂一个方法**(`check-contract-scan.py` 只解析第一个
// 方法调用)⇒ 同路径的多方法必须写成**多条** `.route()`(axum 会合并)。
.route("/api/permission/Standing", get(compat::permission::standing_list))
.route("/api/permission/Standing", post(compat::permission::standing_create))
.route("/api/permission/Standing/list", get(compat::permission::standing_relation_list))
.route("/api/permission/Standing/{id}", get(compat::permission::standing_info))
.route("/api/permission/Standing/{id}", put(compat::permission::standing_update))
.route("/api/permission/Standing/{id}", delete(compat::permission::standing_delete))
.route(
"/api/permission/Standing/{id}/Actions/AddObject",
post(compat::permission::standing_add_object),
)
.route(
"/api/permission/Standing/{id}/Actions/DeleteObject",
post(compat::permission::standing_delete_object),
)
// ---- 权限组(`permission/PermissionGroup`)----
.route("/api/permission/PermissionGroup", get(compat::permission::permission_group_list))
.route(
"/api/permission/PermissionGroup",
post(compat::permission::permission_group_create),
)
.route(
"/api/permission/PermissionGroup/PermissionMember/{id}",
get(compat::permission::permission_group_member_list),
)
.route(
"/api/permission/PermissionGroup/PermissionMember/{id}",
post(compat::permission::permission_group_member_save),
)
.route(
"/api/permission/PermissionGroup/{id}",
get(compat::permission::permission_group_info),
)
.route(
"/api/permission/PermissionGroup/{id}",
put(compat::permission::permission_group_update),
)
.route(
"/api/permission/PermissionGroup/{id}",
delete(compat::permission::permission_group_delete),
)
.route(
"/api/permission/PermissionGroup/{id}/Actions/Copy",
post(compat::permission::permission_group_copy),
)
// ---- 动作管理(`permission/Action`)----
.route("/api/permission/Action", get(compat::permission::action_list))
.route("/api/permission/Action", post(compat::permission::action_create))
.route("/api/permission/Action/{id}", get(compat::permission::action_info))
.route("/api/permission/Action/{id}", put(compat::permission::action_update))
.route("/api/permission/Action/{id}", delete(compat::permission::action_delete))
// ---- 行政区划(`system/Area`,`base_province`)----
// 🔴 官方 `AreaController` 是**树 + 懒加载**:`GET /{nodeId}` 返回该节点的
// 直接子节点(扁平 + `isLeaf`/`hasChildren`),不是嵌套树。
// 🔴 **官方叫 `{nodeId}`,这里必须写 `{id}`**:`GET /{nodeId}`(子节点列表)与
// `PUT|DELETE /{id}` 是**同一段位置**,而 matchit **不允许同位置两个参数名**
// (重名会在启动时 panic:`Insertion failed due to conflict with previously
// registered route`)。同一条坑在批次 9 的 `Log/{id}` 上踩过(HANDOFF 有记)。
// URL 本身不受影响(参数名只是占位符),契约 `[ENDPOINT]` 同步写 `{id}`;
// 官方台账 `[OFFICIAL]` 保留 `{nodeId}`,CC10 会把参数归一后对账。
// 🔴 `GetAreaByIds` 与 `/{id}` 同层:静态段优先于参数段,方法也不同(POST vs GET)。
.route("/api/system/Area/{id}", get(compat::system::area_list))
.route(
"/api/system/Area/{id}/Selector/{ids}",
get(compat::system::area_selector),
)
.route("/api/system/Area/{id}/Info", get(compat::system::area_info))
.route("/api/system/Area", post(compat::system::area_create))
.route("/api/system/Area/{id}", put(compat::system::area_update))
.route("/api/system/Area/{id}", delete(compat::system::area_delete))
.route(
"/api/system/Area/GetAreaByIds",
post(compat::system::area_get_by_ids),
)
// ---- 公有变量(`system/Variate`,`base_common_variate`)----
// 🔴 这一族**没有点权限**(官方 `CommonVariateController` 零 `@SaCheckPermission`)
// ⇒ 守卫只查登录。照抄官方,别「顺手加上」——加了官方前端反而会 403。
.route("/api/system/Variate", get(compat::system::variate_list))
.route("/api/system/Variate", post(compat::system::variate_create))
.route("/api/system/Variate/selector", get(compat::system::variate_selector))
.route(
"/api/system/Variate/sysfunccategory",
get(compat::system::variate_sys_func_category),
)
.route("/api/system/Variate/{id}", get(compat::system::variate_info))
.route("/api/system/Variate/{id}", put(compat::system::variate_update))
.route("/api/system/Variate/{id}", delete(compat::system::variate_delete))
// ---- 业务模块的路由(demo / shop / books)由业务层自带 ⇒ 这里只 merge ----
.merge(modules::router())
// ---- 业务包的路由(面 B 官方形状)由**业务包自带** ⇒ 按声明生成 ----
//
// ---- 系统服务族(批次 15):多语言 / 套件 / 缓存 / 任务调度 / IM / 常用菜单 ----
// 🔴 同一个 path 的多个方法合并进**一行** `.route()`(`get(a).post(b)`)——
// 两条独立声明也能跑,但会让静态扫描器把后半段漏掉(详见批次 14 的教训)。
// ⚠️ `/api/system/BaseLang/LangJson` 是**静态段**,matchit 里优先于 `{id}`
// ⇒ 两条同时存在不会互相抢(与 `/Log/deleteLoginLog` 同理)。
.route(
"/api/system/BaseLang",
get(compat::system::base_lang_list).post(compat::system::base_lang_create),
)
.route(
"/api/system/BaseLang/TemplateDownload",
get(compat::system::base_lang_template_download),
)
.route(
"/api/system/BaseLang/ImportData",
post(compat::system::base_lang_import_data),
)
.route(
"/api/system/BaseLang/{id}",
get(compat::system::base_lang_info)
.put(compat::system::base_lang_update)
.delete(compat::system::base_lang_delete),
)
// ---- 表单套件(官方 `VisualKitController`,前缀 `Kit`)----
.route(
"/api/system/Kit",
get(compat::system::kit_list).post(compat::system::kit_create),
)
.route("/api/system/Kit/Selector", get(compat::system::kit_selector))
.route(
"/api/system/Kit/{id}",
get(compat::system::kit_info)
.put(compat::system::kit_update)
.delete(compat::system::kit_delete),
)
.route("/api/system/Kit/{id}/Actions/Copy", post(compat::system::kit_copy))
.route(
"/api/system/Kit/{id}/Actions/Export",
get(compat::system::kit_export),
)
// ---- 缓存管理(本仓 = 内存会话表,见 face_b 的 CacheManage 段说明)----
.route("/api/system/CacheManage", get(compat::system::cache_manage_list))
.route(
"/api/system/CacheManage/Actions/ClearAll",
post(compat::system::cache_manage_clear_all),
)
.route(
"/api/system/CacheManage/{name}",
get(compat::system::cache_manage_info).delete(compat::system::cache_manage_delete),
)
// ---- 任务调度(官方 `TimeTaskController`,无 `/api/system` 前缀)----
.route(
"/api/scheduletask",
get(compat::scheduletask::task_list).post(compat::scheduletask::task_create),
)
.route("/api/scheduletask/TaskMethods", get(compat::scheduletask::task_methods))
.route("/api/scheduletask/Info/{id}", get(compat::scheduletask::task_info))
.route(
"/api/scheduletask/{id}",
put(compat::scheduletask::task_update).delete(compat::scheduletask::task_delete),
)
.route(
"/api/scheduletask/{id}/TaskLog",
get(compat::scheduletask::task_log_list),
)
// ---- IM 会话(官方 `ImReplyController`)----
.route("/api/message/imreply", get(compat::message::im_reply_list))
.route(
"/api/message/imreply/deleteChatRecord/{id}",
delete(compat::message::im_reply_delete_chat),
)
.route(
"/api/message/imreply/relocation/{id}",
delete(compat::message::im_reply_relocation),
)
// ---- 常用(收藏)菜单(官方 `ModuleDataController`)----
.route("/api/system/MenuData", get(compat::system::menu_data_list))
.route(
"/api/system/MenuData/{id}",
post(compat::system::menu_data_create).delete(compat::system::menu_data_delete),
)
// ---- 公式目录(补 Variate 的三条;数据源是生成物 `variate_catalog.rs`)----
.route(
"/api/system/Variate/sysvariate",
get(compat::system::variate_sys_variate),
)
.route(
"/api/system/Variate/sysfunctree",
get(compat::system::variate_sys_func_tree),
)
.route(
"/api/system/Variate/{type}/sysfunc",
get(compat::system::variate_sys_func),
)
// ---- 系统监控 / 我的应用 ----
.route("/api/system/Monitor", get(compat::system::monitor))
.route("/api/system/HomeData/mySystem", get(compat::system::home_my_system))
// ---- 三处 `Actions/Export`:本仓无文件服务 ⇒ 明确拒绝(不返假 url)----
.route(
"/api/system/System/{id}/Actions/Export",
get(compat::system::system_export),
)
.route(
"/api/system/Tag/{id}/Actions/Export",
get(compat::system::tag_export),
)
// ---- 权限关系族(批次 16):角色绑定 / 在线用户 / 自定义范围 / 工作详情 / 导入导出 ----
// 🔴 `Users|Organize|Position` 下的这些**静态段**与已有的 `{id}` 同深度
// ⇒ matchit 里静态段优先,两条可以共存(同 `Kit/Selector`)。
.route(
"/api/permission/RoleRelation",
get(compat::permission::role_relation_list).post(compat::permission::role_relation_add),
)
.route(
"/api/permission/Group/GroupCondition",
post(compat::permission::group_condition),
)
.route(
"/api/permission/Organize/SelectedList",
post(compat::permission::organize_selected_list),
)
.route(
"/api/permission/Organize/OrganizeCondition",
post(compat::permission::organize_condition),
)
.route(
"/api/permission/Users/getWorkByUser",
get(compat::permission::user_get_work_by_user),
)
.route(
"/api/permission/socials",
get(compat::permission::socials_list),
)
.route(
"/api/permission/socials/render/{source}",
get(compat::permission::socials_render),
)
// 在线用户:本仓 = 内存会话表(同批次 15 的 CacheManage 底座)
.route(
"/api/system/OnlineUser",
get(compat::system::online_user_list).delete(compat::system::online_user_batch_delete),
)
.route(
"/api/system/OnlineUser/{token}",
delete(compat::system::online_user_delete),
)
// 三实体 × 导入导出:模板下载 / 导入预览 / 导入 / 导出 / 导出异常报告
.route(
"/api/permission/Users/TemplateDownload",
get(compat::permission::user_template_download),
)
.route(
"/api/permission/Users/ImportPreview",
get(compat::permission::user_import_preview),
)
.route(
"/api/permission/Users/ImportData",
post(compat::permission::user_import_data),
)
.route(
"/api/permission/Users/ExportData",
get(compat::permission::user_export_data),
)
.route(
"/api/permission/Users/ExportExceptionData",
post(compat::permission::user_export_exception_data),
)
.route(
"/api/permission/Organize/TemplateDownload",
get(compat::permission::organize_template_download),
)
.route(
"/api/permission/Organize/ImportPreview",
get(compat::permission::organize_import_preview),
)
.route(
"/api/permission/Organize/ImportData",
post(compat::permission::organize_import_data),
)
.route(
"/api/permission/Organize/ExportData",
get(compat::permission::organize_export_data),
)
.route(
"/api/permission/Organize/ExportExceptionData",
post(compat::permission::organize_export_exception_data),
)
.route(
"/api/permission/Position/TemplateDownload",
get(compat::permission::position_template_download),
)
.route(
"/api/permission/Position/ImportPreview",
get(compat::permission::position_import_preview),
)
.route(
"/api/permission/Position/ImportData",
post(compat::permission::position_import_data),
)
.route(
"/api/permission/Position/ExportData",
get(compat::permission::position_export_data),
)
.route(
"/api/permission/Position/ExportExceptionData",
post(compat::permission::position_export_exception_data),
)
// 🔴 **批次 12 交付物 ①**:业务包声明 `PackRoute`(纯数据)⇒
// 装配根按声明 + spec 生成真正的 axum 路由 ⇒ **平台层零改动**。
// 业务包**不需要**依赖 axum(AR2 / AR8 钉死)。
// ---- onlineDev(批次 17):表单设计 / 门户 / 外链 / 代码生成 / 分享 / 个性化视图 ----
//
// 🔴 **路由前缀不统一是官方的既有事实**,照抄不改:
// 表单设计 `/api/visualdev/Base`、数据 `/api/visualdev/OnlineDev`、
// 代码生成 `/api/visualdev/Generater`、外链 `/api/visualdev/ShortLink`、
// 门户 `/api/visualdev/Portal`、门户管理 **`/api/system/PortalManage`**(在
// `/api/system` 下!)、DataV 选择器 **`/api/blade-visual/visual`**。
// 🔴 **权限守卫逐条照抄官方 `@SaCheckPermission`**(见 `compat/online_dev.rs`):
// `onlineDev.formDesign` / `onlineDev.sysForm` / `generator.flowForm` /
// `generator.webForm` 三选一(OR),`onlineDev.visualPortal` 单选。
.route("/api/visualdev/Base", get(compat::online_dev::visual_dev_list))
.route("/api/visualdev/Base/list", get(compat::online_dev::visual_dev_form_list))
.route("/api/visualdev/Base/Selector", get(compat::online_dev::visual_dev_selector))
.route("/api/visualdev/Base/getColumnList", get(compat::online_dev::visual_dev_column_list))
.route("/api/visualdev/Base/getListBySystem", get(compat::online_dev::visual_dev_list_by_system))
.route("/api/visualdev/Base", post(compat::online_dev::visual_dev_create))
.route("/api/visualdev/Base/{id}", get(compat::online_dev::visual_dev_info))
.route("/api/visualdev/Base/{id}", put(compat::online_dev::visual_dev_update))
.route("/api/visualdev/Base/{id}", delete(compat::online_dev::visual_dev_delete))
.route("/api/visualdev/Base/{id}/Actions/Copy", post(compat::online_dev::visual_dev_copy))
.route("/api/visualdev/Base/{id}/Actions/Release", post(compat::online_dev::visual_dev_release))
.route("/api/visualdev/Base/{id}/getReleaseMenu", get(compat::online_dev::visual_dev_release_menu))
.route("/api/visualdev/Base/{id}/Actions/Module", post(compat::online_dev::visual_dev_create_menu))
.route("/api/visualdev/Base/{id}/FormDataFields", get(compat::online_dev::visual_dev_form_data_fields))
.route("/api/visualdev/Base/{id}/FieldDataSelect", get(compat::online_dev::visual_dev_field_data_select))
.route("/api/visualdev/Generater/{id}/Actions/DownloadCode", post(compat::online_dev::generater_download_code))
.route("/api/visualdev/Generater/{id}/Actions/CodePreview", post(compat::online_dev::generater_code_preview))
.route("/api/visualdev/Generater/{id}/Alias/Info", get(compat::online_dev::generater_alias_info))
.route("/api/visualdev/Generater/{id}/Alias/Save", post(compat::online_dev::generater_alias_save))
.route("/api/visualdev/OnlineDev/{model_id}/Config", get(compat::online_dev::online_dev_config))
.route("/api/visualdev/OnlineDev/Config", get(compat::online_dev::online_dev_config_by_menu))
.route("/api/visualdev/OnlineDev/{model_id}/FormData", get(compat::online_dev::online_dev_form_data))
.route("/api/visualdev/OnlineDev/{model_id}/List", post(compat::online_dev::online_dev_model_list))
.route("/api/visualdev/OnlineDev/{model_id}", post(compat::online_dev::online_dev_create_model))
.route("/api/visualdev/OnlineDev/{model_id}/{id}", put(compat::online_dev::online_dev_update_model))
.route("/api/visualdev/OnlineDev/{model_id}/{id}", get(compat::online_dev::online_dev_model_info))
.route("/api/visualdev/OnlineDev/{model_id}/{id}", delete(compat::online_dev::online_dev_delete_model))
.route("/api/visualdev/OnlineDev/batchDelete/{model_id}", post(compat::online_dev::online_dev_batch_delete))
.route("/api/visualdev/OnlineDev/{model_id}/DataChange", post(compat::online_dev::online_dev_data_change))
.route("/api/visualdev/OnlineDev/{model_id}/Actions/ExportData", post(compat::online_dev::online_dev_export_model))
.route("/api/visualdev/OnlineDev/{model_id}/Template", get(compat::online_dev::online_dev_template))
.route("/api/visualdev/OnlineDev/{model_id}/Actions/Export", post(compat::online_dev::online_dev_export))
.route("/api/visualdev/OnlineDev/{model_id}/actionLaunchFlow", post(compat::online_dev::online_dev_launch_flow))
.route("/api/visualdev/OnlineDev/RelationQuery", post(compat::online_dev::online_dev_relation_query))
.route("/api/visualdev/OnlineLog", get(compat::online_dev::online_log_list))
.route("/api/visualdev/personal", get(compat::online_dev::personal_list))
.route("/api/visualdev/personal", post(compat::online_dev::personal_create))
.route("/api/visualdev/personal/{id}", put(compat::online_dev::personal_update))
.route("/api/visualdev/personal/{id}/setDefault", put(compat::online_dev::personal_set_default))
.route("/api/visualdev/personal/{id}", delete(compat::online_dev::personal_delete))
.route("/api/visualdev/share", get(compat::online_dev::share_list))
.route("/api/visualdev/share/SelectedList", post(compat::online_dev::share_selected_list))
.route("/api/visualdev/share/save", post(compat::online_dev::share_save))
.route("/api/visualdev/share/Selector", get(compat::online_dev::share_selector))
.route("/api/visualdev/ocr", post(compat::online_dev::ocr_recognize))
.route("/api/visualdev/ShortLink/{id}", get(compat::online_dev::short_link_info))
.route("/api/visualdev/ShortLink", put(compat::online_dev::short_link_save))
.route("/api/visualdev/ShortLink/getConfig/{id}", get(compat::online_dev::short_link_get_config))
.route("/api/visualdev/ShortLink/checkPwd", post(compat::online_dev::short_link_check_pwd))
.route("/api/visualdev/ShortLink/Config", get(compat::online_dev::short_link_config_data))
.route("/api/visualdev/ShortLink/{id}/ListLink", post(compat::online_dev::short_link_model_list))
.route("/api/visualdev/ShortLink/{id}", post(compat::online_dev::short_link_create_model))
.route("/api/visualdev/ShortLink/{id}/{id}/DataChange", get(compat::online_dev::short_link_data_change))
.route("/api/visualdev/Portal", get(compat::online_dev::portal_list))
.route("/api/visualdev/Portal/{id}", get(compat::online_dev::portal_info))
.route("/api/visualdev/Portal", post(compat::online_dev::portal_create))
.route("/api/visualdev/Portal/{id}", put(compat::online_dev::portal_update))
.route("/api/visualdev/Portal/{id}", delete(compat::online_dev::portal_delete))
.route("/api/visualdev/Portal/{id}/Actions/Copy", post(compat::online_dev::portal_copy))
.route("/api/visualdev/Portal/{id}/Actions/Export", post(compat::online_dev::portal_export))
.route("/api/visualdev/Portal/Selector", get(compat::online_dev::portal_selector))
.route("/api/visualdev/Portal/Selector/Menu", get(compat::online_dev::portal_home_list))
.route("/api/visualdev/Portal/{id}/Actions/SetDefault", put(compat::online_dev::portal_set_default))
.route("/api/visualdev/Portal/{id}/auth", get(compat::online_dev::portal_auth))
.route("/api/visualdev/Portal/Custom/Save/{id}", put(compat::online_dev::portal_custom_save))
.route("/api/visualdev/Portal/Actions/release/{id}", put(compat::online_dev::portal_release))
.route("/api/visualdev/Portal/systemFilter/{id}", get(compat::online_dev::portal_system_filter))
.route("/api/visualdev/Portal/manage/Selector/{system_id}", get(compat::online_dev::portal_manage_selector))
.route("/api/system/PortalManage/list/{system_id}", get(compat::online_dev::portal_manage_list))
.route("/api/system/PortalManage/{id}", get(compat::online_dev::portal_manage_info))
.route("/api/system/PortalManage", post(compat::online_dev::portal_manage_create))
.route("/api/system/PortalManage/{id}", put(compat::online_dev::portal_manage_update))
.route("/api/system/PortalManage/{id}", delete(compat::online_dev::portal_manage_delete))
.route("/api/visualdev/Dashboard/Notice", post(compat::online_dev::dashboard_notice))
.route("/api/visualdev/Dashboard/Email", get(compat::online_dev::dashboard_email))
.route("/api/system/atlas", get(compat::online_dev::atlas_list))
.route("/api/system/atlas/geojson", get(compat::online_dev::atlas_geojson))
.route("/api/blade-visual/visual/Selector", get(compat::online_dev::datav_selector))
// ---- 在线报表(官方 `api/onlineDev/report.ts`,前缀 `/api/Report`)----
//
// 🔴 **官方 `/api/Report/*` 在官方是「独立部署的第三方服务」**
// (`jnpf-java-datareport-univer`,端口 32000)—— 主后端 `jnpf-java-boot`
// 里**没有** `/api/Report` Controller,也**没有**任何 `report_version` 的
// Java 实体 ⇒ 本仓把报表**元数据就地落库**(`report_template` +
// `report_version`,表结构照官方 DDL 逐字导入)。
// 详见 `compat/report.rs` 的文件头。
//
// 🔴 **`data` 的形状逐条照官方前端的消费点定**(最容易做错的地方):
// - `GET /api/Report` ⇒ `PageListVO`(`{pagination,list}`)
// - `GET /api/Report/Version/{id}` ⇒ **裸数组**(`res.data || []`)
// - `GET /api/Report/Selector` ⇒ `ListVO`(`{list:[…]}`)
// - `POST /api/Report` ⇒ **裸 id 字符串**(`state.dataForm.id = res.data`)
// - `POST /api/Report/Info/{id}` ⇒ **裸 id 字符串**(`const currentId = res.data`)
// - `GET /api/Report/{id}` 等 ⇒ **裸对象**
//
// 🔴 **权限守卫**:官方那个服务不在可核对的源码树里 ⇒ 拿不到它的
// `@SaCheckPermission` ⇒ 一律**只要求登录**(与 `personal` / `share` 同款)。
.route("/api/Report", get(compat::report::report_list))
.route("/api/Report", post(compat::report::report_create))
.route("/api/Report/Selector", get(compat::report::report_selector))
.route("/api/Report/Save", post(compat::report::report_save_version))
.route("/api/Report/Data", post(compat::report::report_get_data))
.route("/api/Report/Version/{id}", get(compat::report::report_version_list))
.route("/api/Report/Info/{id}", get(compat::report::report_version_info))
.route("/api/Report/Info/{id}", post(compat::report::report_version_copy))
.route("/api/Report/Info/{id}", delete(compat::report::report_version_delete))
.route("/api/Report/data/upload/file", post(compat::report::report_upload_image))
.route("/api/Report/data/downImg", post(compat::report::report_down_img))
.route("/api/Report/data/ImportExcel", post(compat::report::report_import_excel))
.route("/api/Report/data/{id}/DownExcel", post(compat::report::report_export_excel))
.route("/api/Report/data/{id}/getQueryList", get(compat::report::report_query_list))
.route("/api/Report/data/{id}/preview", post(compat::report::report_preview_design))
.route("/api/Report/data/{id}/previewTemplate", post(compat::report::report_preview_template))
.route("/api/Report/{id}", get(compat::report::report_info))
.route("/api/Report/{id}", put(compat::report::report_update))
.route("/api/Report/{id}", delete(compat::report::report_delete))
.route("/api/Report/{id}/Actions/Copy", post(compat::report::report_copy))
.route("/api/Report/{id}/Actions/Export", get(compat::report::report_export_data))
.route("/api/Report/{id}/Actions/Module", post(compat::report::report_create_menu))
.route("/api/Report/{id}/getReleaseMenu", get(compat::report::report_release_menu))
.merge(crate::bootstrap::pack_router_or_empty());
// 🔴 **仅测试构建**存在的「故意 panic」端点 —— 用来钉住 catch-all 中间件
// (契约 §6.5:panic ⇒ HTTP 200 + `code=400`)。
// release 构建**不含**这条路由 ⇒ 生产环境没有这个面。
#[cfg(test)]
let router = router.route("/api/__test__/panic", get(panic_handler));
router.with_state(state)
}
/// 完整装配(**唯一权威的装配链**)—— 生产(`main.rs`)与单测**都调它**。
///
/// 🔴 顺序即 S25 的要害:`.fallback()` 必须在两个 `.layer()` **之前**
/// (axum:`layer` 只作用于**已注册**的路由)⇒ 否则 404 兜底不在中间件保护范围内。
/// `.layer()` 是 per-route 的 ⇒ **最后挂的最外层** ⇒ 请求先撞 catch-all。
/// 🔴 `with_state` 是**链尾**(唯一一次把类型落成 `Router<()>`)。
///
/// 🔴 **这条链在仓库里只有这一份** —— 生产与测试共用 ⇒ 改顺序时两边一起变,
/// 测试永远钉得住(不要在 `main.rs` 或测试里再抄一遍)。
pub fn build_app(state: AppState) -> axum::Router {
build_router(state.clone())
.fallback(not_found_handler)
.layer(m_status_rewrite())
.layer(catch_all())
.with_state(state)
}
/// `GET /api/health` —— 探活(契约 §6.5 末条,**非契约**)。
///
/// 🔴 **永远要有响应**:查不到表 / DB 报错 ⇒ 仍然 HTTP 200 + `{"ok": false, "tables": 0, …}`
/// (它是给运维看的,不许 500)。
async fn health(State(state): State<AppState>) -> Json<Value> {
let version = env!("CARGO_PKG_VERSION");
let text = state
.db
.scalar_text(
"SELECT count(*) FROM information_schema.tables WHERE table_schema = 'public'",
)
.await
.ok()
.flatten();
let tables = text.and_then(|t| t.trim().parse::<u64>().ok());
match tables {
Some(n) => Json(json!({ "ok": true, "tables": n, "version": version })),
None => Json(json!({ "ok": false, "tables": 0, "version": version })),
}
}
// ---------------------------------------------------------------- 404 兜底
/// 404 兜底 —— 未注册的路径。
///
/// 🔴 **必须显式配 `StatusCode::NOT_FOUND`** —— `envelope::fail()` 恒返回 HTTP 200
/// (契约 §R1.1)⇒ 不显式配就变成「HTTP 200 + code=404」⇒ **契约破**。
pub async fn not_found_handler() -> (StatusCode, Json<ActionResult>) {
(StatusCode::NOT_FOUND, Json(envelope::fail(404, "接口不存在").0))
}
// ---------------------------------------------------------------- 405 / 413 改写中间件
/// 中间件 future 的统一类型(boxed ⇒ 可命名 ⇒ 工厂函数的返回类型能写死)。
type MwFuture = Pin<Box<dyn Future<Output = Response> + Send>>;
/// 中间件函数指针类型(fn 指针可命名 ⇒ 工厂函数的返回类型能写死)。
type MwFn = fn(Request, Next) -> MwFuture;
/// 405 / 413 改写中间件(挂在链尾的响应改写层)。
///
/// - **任何 405 都改写**成信封 body(契约 §6.5:405 ⇒ HTTP 405 +
/// `{code:405,msg:"方法不被允许",data:null}`)—— 🔴 **不看 body 是否为空**:
/// 「万一有 body 的 405 漏出非信封 body」是唯一的破口,不能留;
/// - **任何 413 都改写**成信封 body(传输状态码**保留** HTTP 413,body 换成
/// `{code:413,msg:"请求体过大",data:null}`)—— 改写前 axum 默认吐的是
/// `text/plain` 的 `Failed to buffer the request body: length limit exceeded`
/// ⇒ 服务端会冒出**第三种 body 形状**(契约 §2「没有第三种形状」的破口);
/// - **保留 `parts.headers`**(保住 `Allow` 头);
/// - 改写 `Content-Type` / `Content-Length`,body 换成对应信封。
///
/// 🔴 **非 405 / 非 413 的响应原样放行**(不改写)。
/// 🔴 **不要**用 axum 的 `method_not_allowed_fallback` —— 它只对「调用那一刻已注册的路由」
/// 生效,且**丢 `Allow` 头**。
pub fn m_status_rewrite() -> axum::middleware::FromFnLayer<MwFn, (), (Request,)> {
axum::middleware::from_fn::<_, (Request,)>(m_status_rewrite_fn)
}
fn m_status_rewrite_fn(req: Request, next: Next) -> MwFuture {
Box::pin(m_status_rewrite_inner(req, next))
}
async fn m_status_rewrite_inner(req: Request, next: Next) -> Response {
let res = next.run(req).await;
// 只处理 405 / 413(其它状态码原样放行)。
let (code, msg) = match res.status() {
StatusCode::METHOD_NOT_ALLOWED => (405, "方法不被允许"),
StatusCode::PAYLOAD_TOO_LARGE => (413, "请求体过大"),
_ => return res,
};
// 🔴 **任何 405 / 413 都改写**(不看 body 是否为空)—— 契约要求这两类恒是信封 body。
// 🔴 `serde_json::to_vec` 对本结构体恒成功;真失败 ⇒ 保留原响应(不冒险改坏)。
let Ok(bytes) = serde_json::to_vec(&envelope::fail(code, msg).0) else {
return res;
};
let (mut parts, body) = res.into_parts();
drop(body);
parts
.headers
.insert(header::CONTENT_TYPE, HeaderValue::from_static("application/json"));
parts
.headers
.insert(header::CONTENT_LENGTH, HeaderValue::from(bytes.len()));
Response::from_parts(parts, Body::from(bytes))
}
// ---------------------------------------------------------------- catch-all 中间件
/// catch-all 中间件 —— 把 handler 的 **panic** 变成 `HTTP 200 + {code:400, …}`。
///
/// 🔴 **只管 panic**:DB 报错**已在 handler 内部接住**(`sys.rs` / `crud.rs` 的
/// `db_error(e, ctx)` ⇒ `fail(400, "系统异常,请联系管理员")` ⇒ HTTP 200 + code=400)
/// ⇒ **不要**在这里重新映射 DB 错误,也**不要**改任何 handler 的返回类型。
///
/// 🔴 依赖根 `Cargo.toml` 的 release profile **不设** `panic = "abort"`
/// (abort 下 `catch_unwind` 抓不到 panic ⇒ 进程直接死 ⇒ 客户端连接重置)。
pub fn catch_all() -> axum::middleware::FromFnLayer<MwFn, (), (Request,)> {
axum::middleware::from_fn::<_, (Request,)>(catch_all_fn)
}
fn catch_all_fn(req: Request, next: Next) -> MwFuture {
Box::pin(catch_all_inner(req, next))
}
async fn catch_all_inner(req: Request, next: Next) -> Response {
match CatchUnwind::new(next.run(req)).await {
Ok(resp) => resp,
Err(_) => Json(envelope::fail(400, "系统异常,请联系管理员").0).into_response(),
}
}
/// 把 inner future 的 panic 变成 `Err`,**不引** `tower` / `tower-http` / `futures`。
///
/// 关键:`inner` 存成 `Pin<Box<F>>` ⇒ 本结构恒 `Unpin` ⇒ `get_mut()` 安全、**全程无需 `unsafe`**。
struct CatchUnwind<F> {
inner: Pin<Box<F>>,
}
impl<F> CatchUnwind<F> {
fn new(inner: F) -> Self {
Self {
inner: Box::pin(inner),
}
}
}
impl<F: Future> Future for CatchUnwind<F> {
type Output = Result<F::Output, Box<dyn Any + Send + 'static>>;
fn poll(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Self::Output> {
// Self: Unpin ✔(`Pin<Box<F>>` 恒 Unpin)
let this = self.get_mut();
let inner = &mut this.inner;
match catch_unwind(AssertUnwindSafe(|| inner.as_mut().poll(cx))) {
Ok(Poll::Pending) => Poll::Pending,
Ok(Poll::Ready(v)) => Poll::Ready(Ok(v)),
Err(e) => Poll::Ready(Err(e)),
}
}
}
#[cfg(test)]
mod tests {
use super::*;
use std::path::PathBuf;
use std::sync::Arc;
use tokio::io::{AsyncReadExt, AsyncWriteExt};
use crate::platform::config::Config;
use crate::platform::db::Db;
use crate::platform::session::{SessionStore, TicketStore};
use crate::platform::test_support;
/// 全进程共享的临时库(pglite 进程级全局单例 ⇒ 只能开一次,所有单测共用)。
async fn db() -> &'static Db {
test_support::shared_db().await
}
fn new_state(db: &Db) -> AppState {
AppState {
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()),
}
}
/// 按**生产同一条链**造出完整 app(🔴 唯一真源 = [`build_app`],不在测试里抄一遍)。
fn app(state: AppState) -> Router {
build_app(state)
}
/// 起一个真实的 HTTP 服务(随机端口),返回端口号。
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, app(state)).await;
});
// 让 server 任务有机会起来(它已经在跑,只是异步)。
tokio::task::yield_now().await;
std::mem::forget(server); // 后台服务随测试进程退出而结束
port
}
/// 用裸 TCP 发一次请求,返回完整原始响应(头 + 体)。
async fn raw(port: u16, request: &str) -> String {
let mut stream = tokio::net::TcpStream::connect(("127.0.0.1", port))
.await
.expect("连接失败");
stream
.write_all(request.as_bytes())
.await
.expect("写请求失败");
let mut buf = Vec::new();
tokio::time::timeout(
std::time::Duration::from_secs(5),
stream.read_to_end(&mut buf),
)
.await
.expect("HTTP 往返超时(5s)")
.expect("读响应失败");
String::from_utf8_lossy(&buf).to_string()
}
/// 发一个**超大 body** 的 POST,返回完整原始响应(头 + 体)。
///
/// 🔴 写 / 读的错误**必须容忍**:服务端判定 body 超限后会**立刻回 413**,
/// 并且**不再继续读**请求体 ⇒ 若客户端多写了,socket 上有未读数据 ⇒
/// 服务端只能 RST(这正是真实客户端 curl 会看到的形态)。
/// ⇒ 这里把 body 控制在「**刚好超过上限 1 字节**」,
/// 让服务端把 body 全部读走 ⇒ 干净 FIN ⇒ 响应能完整读到。
async fn raw_oversized(port: u16, request: &str) -> String {
let mut stream = tokio::net::TcpStream::connect(("127.0.0.1", port))
.await
.expect("连接失败");
let _ = stream.write_all(request.as_bytes()).await;
let _ = stream.flush().await;
let mut buf = Vec::new();
let mut tmp = [0u8; 16 * 1024];
// 收尾读:容忍 `ECONNRESET`(服务端 RST)—— 已读到的字节照样能用。
loop {
match tokio::time::timeout(
std::time::Duration::from_secs(2),
stream.read(&mut tmp),
)
.await
{
Ok(Ok(0)) => break,
Ok(Ok(n)) => buf.extend_from_slice(&tmp[..n]),
Ok(Err(_)) => break,
Err(_) => break,
}
}
String::from_utf8_lossy(&buf).to_string()
}
fn get(path: &str) -> String {
format!("GET {path} HTTP/1.1\r\nHost: localhost\r\nConnection: close\r\n\r\n")
}
/// 「错方法」探针用(本仓**没有任何**路由注册 `PATCH` ⇒ 必然方法不匹配)。
fn patch(path: &str) -> String {
format!("PATCH {path} HTTP/1.1\r\nHost: localhost\r\nConnection: close\r\n\r\n")
}
/// 🔴 **带官方判别头的 GET** —— 官方前端发 `App-Code` / `Jnpf-Origin: pc` /
/// `Vue-Version: 3` 三个头(`jnpf-web-apps-main/src/api/request.ts:109-112`)。
/// 本仓前端**只发前两个**、**不发** `Vue-Version` ⇒ 判别头零歧义。
fn get_face_b(path: &str) -> String {
format!(
"GET {path} HTTP/1.1\r\nHost: localhost\r\nConnection: close\r\n\
App-Code: ssw-platform\r\nJnpf-Origin: pc\r\nVue-Version: 3\r\n\r\n"
)
}
/// 🔴 **带官方判别头的 DELETE**(官方 RESTful 的删除是 `DELETE /api/{模块}/{资源}/{id}`)。
fn delete_face_b(path: &str) -> String {
format!(
"DELETE {path} HTTP/1.1\r\nHost: localhost\r\nConnection: close\r\n\
App-Code: ssw-platform\r\nJnpf-Origin: pc\r\nVue-Version: 3\r\n\r\n"
)
}
/// 🔴 **带官方判别头的 POST**(body 必带 `Content-Length`)。
fn post_face_b(path: &str, body: &str) -> String {
format!(
"POST {path} HTTP/1.1\r\nHost: localhost\r\nConnection: close\r\n\
Content-Type: application/json\r\n\
App-Code: ssw-platform\r\nJnpf-Origin: pc\r\nVue-Version: 3\r\n\
Content-Length: {}\r\n\r\n{body}",
body.len()
)
}
/// 带 body 的 PUT(`Content-Length` 必须给对,否则服务端会等)。
fn put_req(path: &str, body: &str, jnpf: bool) -> String {
let extra = if jnpf {
"App-Code: ssw-platform\r\nJnpf-Origin: pc\r\nVue-Version: 3\r\n"
} else {
""
};
format!(
"PUT {path} HTTP/1.1\r\nHost: localhost\r\nConnection: close\r\n\
Content-Type: application/json\r\n{extra}Content-Length: {}\r\n\r\n{body}",
body.len()
)
}
/// 未注册的路径 ⇒ **HTTP 404** + `{code:404,msg:"接口不存在",data:null}`。
#[tokio::test]
async fn unknown_route_returns_http_404_with_envelope() {
let port = serve(new_state(db().await)).await;
let raw = raw(port, &get("/api/not-exist-xyz")).await;
assert!(
raw.starts_with("HTTP/1.1 404 Not Found"),
"未知路由必须是 HTTP 404,实际: {raw}"
);
let (_, body) = raw.split_once("\r\n\r\n").expect("响应必须有头体分隔");
let body: Value = serde_json::from_str(body).expect("响应体必须是合法 JSON");
assert_eq!(body["code"], 404);
assert_eq!(body["msg"], "接口不存在");
assert_eq!(body["data"], Value::Null);
}
/// 路径存在、方法不对 ⇒ **HTTP 405** + `{code:405,…}` + **保留 `Allow` 头**。
#[tokio::test]
async fn wrong_method_returns_http_405_with_allow_header() {
let port = serve(new_state(db().await)).await;
let raw = raw(port, &get("/api/oauth/Login")).await;
assert!(
raw.starts_with("HTTP/1.1 405 Method Not Allowed"),
"方法不对必须是 HTTP 405,实际: {raw}"
);
let (head, body) = raw.split_once("\r\n\r\n").expect("响应必须有头体分隔");
assert!(
head.to_ascii_lowercase().contains("allow: post"),
"405 必须保留 Allow 头,实际头: {head}"
);
let body: Value = serde_json::from_str(body).expect("响应体必须是合法 JSON");
assert_eq!(body["code"], 405);
assert_eq!(body["msg"], "方法不被允许");
assert_eq!(body["data"], Value::Null);
}
/// 🔴 **超大 body ⇒ HTTP 413 + 信封**(契约 §2「没有第三种形状」)。
///
/// axum 的默认 body 上限是 2MB ⇒ 这里发**刚好超过 1 字节**的 JSON。
/// 改写前服务端会吐 `text/plain` 的 `Failed to buffer the request body: length limit exceeded`
/// ⇒ 那就是**第三种 body 形状** ⇒ 必须被归一成信封。
#[tokio::test]
async fn oversized_body_returns_http_413_with_envelope() {
let port = serve(new_state(db().await)).await;
// axum 默认 body 上限 = 2MB(2*1024*1024 字节)⇒ 这里发**刚好超过 1 字节**的 JSON。
// 🔴 刻意不做「远远超过」:多写的字节服务端不会读 ⇒ socket 残留未读数据 ⇒ RST ⇒ 响应读不全。
const LIMIT: usize = 2 * 1024 * 1024;
let prefix = "{\"account\":\"big_user\",\"password\":\"x\",\"realName\":\"";
let suffix = "\"}";
let padding = "a".repeat(LIMIT + 1 - prefix.len() - suffix.len());
let payload = format!("{prefix}{padding}{suffix}");
assert_eq!(payload.len(), LIMIT + 1);
let req = format!(
"POST /api/ssw/sys/User/Save HTTP/1.1\r\nHost: localhost\r\n\
Content-Type: application/json\r\nContent-Length: {}\r\nConnection: close\r\n\r\n{}",
payload.len(),
payload
);
let raw = raw_oversized(port, &req).await;
assert!(
raw.starts_with("HTTP/1.1 413 Payload Too Large"),
"超大 body 必须是 HTTP 413,实际: {}",
&raw[..raw.len().min(400)]
);
let (head, body) = raw.split_once("\r\n\r\n").expect("响应必须有头体分隔");
assert!(
head.to_ascii_lowercase()
.contains("content-type: application/json"),
"413 必须是 JSON 信封,实际头: {head}"
);
let body: Value = serde_json::from_str(body).expect("响应体必须是合法 JSON");
assert_eq!(body["code"], 413);
assert_eq!(body["msg"], "请求体过大");
assert_eq!(body["data"], Value::Null);
}
/// 🔴 **路由表钉子测试** —— 27 条路径一条都不许少、一条都不许拼错。
///
/// 用「错方法 ⇒ 405」当作「这条路径确实注册了」的探针(比逐条调真接口便宜,
/// 且不依赖鉴权 / 数据);路径没注册 ⇒ 404。
///
/// 🔴 **业务路径取自业务层**([`crate::modules::ALL_ROUTES`])—— 平台层不认业务路径
/// ⇒ 加业务模块**不用改本文件**(业务模块的路由表在 `modules/<app>.rs`)。
#[tokio::test]
async fn route_table_is_pinned() {
let port = serve(new_state(db().await)).await;
/// 平台层的 18 条已注册路径(照抄 [`build_router`] 的注册表,逐字)。
const REGISTERED: [&str; 18] = [
"/api/health",
"/api/oauth/Login",
"/api/oauth/CurrentUser",
"/api/ssw/sys/User/List",
"/api/ssw/sys/User/Save",
"/api/ssw/sys/User/Delete",
"/api/ssw/sys/Role/List",
"/api/ssw/sys/Role/Save",
"/api/ssw/sys/Role/Delete",
"/api/ssw/sys/Role/Modules",
"/api/ssw/sys/Organize/List",
"/api/ssw/sys/Organize/Save",
"/api/ssw/sys/Organize/Delete",
"/api/ssw/sys/Module/List",
"/api/ssw/sys/Module/Save",
"/api/ssw/sys/Module/Delete",
"/api/permission/Authority/Data/any-id",
"/api/permission/Authority/RoleModules",
];
for path in REGISTERED {
let raw = raw(port, &patch(path)).await;
assert!(
raw.starts_with("HTTP/1.1 405 Method Not Allowed"),
"路由表必须包含 {path}(方法不对 ⇒ 405),实际: {raw}"
);
}
// 业务层的 12 条(demo / shop / books / asset)—— 取自业务层的路由表。
for path in crate::modules::ALL_ROUTES {
let raw = raw(port, &patch(path)).await;
assert!(
raw.starts_with("HTTP/1.1 405 Method Not Allowed"),
"业务路由表必须包含 {path}(方法不对 ⇒ 405),实际: {raw}"
);
}
// 没注册过的路径 ⇒ 404(把「404 兜底」也钉在这条测试里)。
let raw = raw(port, &patch("/api/__nope__/xyz")).await;
assert!(
raw.starts_with("HTTP/1.1 404 Not Found"),
"未注册的路径必须是 404,实际: {raw}"
);
}
/// 🔴 **非 405 响应原样穿过改写中间件**(状态 200 + 信封 + `application/json`)。
#[tokio::test]
async fn non_405_response_passes_through_untouched() {
let port = serve(new_state(db().await)).await;
let raw = raw(port, &get("/api/health")).await;
assert!(
raw.starts_with("HTTP/1.1 200 OK"),
"健康检查必须返回 200,实际: {raw}"
);
let (head, body) = raw.split_once("\r\n\r\n").expect("响应必须有头体分隔");
assert!(
head.to_ascii_lowercase()
.contains("content-type: application/json"),
"健康检查必须返回 JSON,实际头: {head}"
);
let body: Value = serde_json::from_str(body).expect("响应体必须是合法 JSON");
assert_eq!(body["ok"], true);
}
/// panic ⇒ **HTTP 200** + `{code:400,msg:"系统异常,请联系管理员",data:null}`。
#[tokio::test]
async fn panic_is_converted_to_http_200_code_400() {
let port = serve(new_state(db().await)).await;
let raw = raw(port, &get("/api/__test__/panic")).await;
assert!(
raw.starts_with("HTTP/1.1 200 OK"),
"panic 必须被 catch-all 接住并返回 HTTP 200,实际: {raw}"
);
let (_, body) = raw.split_once("\r\n\r\n").expect("响应必须有头体分隔");
let body: Value = serde_json::from_str(body).expect("响应体必须是合法 JSON");
assert_eq!(body["code"], 400);
assert_eq!(body["msg"], "系统异常,请联系管理员");
assert_eq!(body["data"], Value::Null);
}
/// 🔴 DDL 绝不可从 HTTP 下载(契约 §R1.9)—— 两条路径都必须是 404 + 信封。
#[tokio::test]
async fn ddl_is_never_downloadable() {
let port = serve(new_state(db().await)).await;
for path in ["/db/schema.sql", "/src/backend/db/schema.sql"] {
let raw = raw(port, &get(path)).await;
assert!(
raw.starts_with("HTTP/1.1 404 Not Found"),
"{path} 必须返回 HTTP 404,实际: {raw}"
);
let (_, body) = raw.split_once("\r\n\r\n").expect("响应必须有头体分隔");
let body: Value = serde_json::from_str(body).expect("响应体必须是合法 JSON");
assert_eq!(body["code"], 404);
assert_eq!(body["msg"], "接口不存在");
}
}
/// `/api/health` ⇒ HTTP 200 + `{ok, tables, version}`(探活,契约 §6.5 末条)。
#[tokio::test]
async fn health_reports_ok_tables_and_version() {
let port = serve(new_state(db().await)).await;
let raw = raw(port, &get("/api/health")).await;
assert!(
raw.starts_with("HTTP/1.1 200 OK"),
"探活必须永远有响应,实际: {raw}"
);
let (_, body) = raw.split_once("\r\n\r\n").expect("响应必须有头体分隔");
let body: Value = serde_json::from_str(body).expect("响应体必须是合法 JSON");
assert_eq!(body["ok"], true);
// 🔴 **表数不写死**(批次 12.5):DB 里的表 = `db/schema.sql` 建的表
// + **业务包自带**的表(`packs/<app>/schema/*.sql`,启动时按包执行)。
// 写死一个数字 ⇒ 加包就要改测试 ⇒ 变成「先改测试再加业务」的假闸门,
// 而真正要守的是「health 报的是真数」—— 用同一个推导源比才对得上。
let expected = crate::platform::db::ddl_tables().len()
+ crate::bootstrap::packs()
.map(|r| r.ddls.len())
.unwrap_or(0);
assert_eq!(body["tables"], expected, "health 报的表数应 = schema.sql + 包表的数量");
assert_eq!(body["version"], env!("CARGO_PKG_VERSION"));
}
// ---- 面 B(官方 JNPF 契约面)----
/// 🔴 **契约里的每条面 B 路由都必须真的注册了**(错方法 ⇒ 405)。
///
/// 🔴 **不写死清单**(批次 13 改):原来这里是一段 255 行的 `const [&str; 255]`,
/// 每加一族端点就得手抄一遍 —— 漏抄的后果是**这条断言仍然全绿**(假闸门),
/// 而「加了端点没注册」正好是最该被它抓住的错。
/// 现在直接读契约的 `[ENDPOINT]` 段:**与 `check-contract.sh` 的 CC10 同源**
/// (CC10 做静态双向对账,这里补一次**运行时**探活)。
#[tokio::test]
async fn face_b_route_table_is_pinned() {
let port = serve(new_state(db().await)).await;
let paths = face_b_paths_from_contract();
assert!(
paths.len() > 100,
"契约里的面 B 路径数异常少({} 条)⇒ 大概率是 [ENDPOINT] 段被改坏了",
paths.len()
);
for path in &paths {
let raw = raw(port, &patch(path)).await;
assert!(
raw.starts_with("HTTP/1.1 405 Method Not Allowed"),
"面 B 路由表必须包含 {path}(方法不对 ⇒ 405),实际: {raw}"
);
}
}
/// 从 `docs/contract.md` 的 `[ENDPOINT]` 段读出**面 B / 共用**的全部路径。
///
/// 🔴 路径参数一律换成 `any-id`(axum 0.8 的 `{param}` 位置随便填什么都匹配)。
fn face_b_paths_from_contract() -> Vec<String> {
let file = std::path::Path::new(env!("CARGO_MANIFEST_DIR"))
.join("..")
.join("..")
.join("docs")
.join("contract.md");
let text = std::fs::read_to_string(&file)
.unwrap_or_else(|e| panic!("读契约失败 {}: {e}", file.display()));
let mut out: Vec<String> = Vec::new();
let mut inside = false;
for line in text.lines() {
let trimmed = line.trim();
if trimmed == "[ENDPOINT]" {
inside = true;
continue;
}
if inside && trimmed.starts_with('[') {
break; // 下一段
}
if !inside || trimmed.is_empty() || trimmed.starts_with('#') {
continue;
}
let cols: Vec<&str> = line.split('\t').collect();
if cols.len() < 3 || (cols[0] != "B" && cols[0] != "AB") {
continue;
}
// `{nodeId}` / `{id}` / `{param}` ⇒ `any-id`
let mut path = String::new();
let mut in_param = false;
for ch in cols[2].trim().chars() {
match ch {
'{' => in_param = true,
'}' => {
in_param = false;
path.push_str("any-id");
}
c if !in_param => path.push(c),
_ => {}
}
}
if !out.contains(&path) {
out.push(path);
}
}
out
}
/// 🔴 **面 A 与面 B 的 `Authority/Data` 必须共存**:
/// - 面 A:`PUT /api/permission/Authority/Data/{objectId}`;
/// - 面 B:`POST /api/permission/Authority/Data/{objectId}/Values`。
///
/// matchit 0.8.4 允许「静态段跟在参数节点后」⇒ 两条可同时注册
/// (若冲突,`build_router` 在建路由时就会 panic ⇒ 测试直接炸)。
#[tokio::test]
async fn surface_a_and_b_authority_paths_coexist() {
let port = serve(new_state(db().await)).await;
// 面 A 的 PUT:未登录 ⇒ `code=600`(**不是** 404 / 405)。
let resp = raw(
port,
&put_req("/api/permission/Authority/Data/any-id", "{}", false),
)
.await;
let (_, body) = resp.split_once("\r\n\r\n").expect("响应必须有头体分隔");
let body: Value = serde_json::from_str(body).expect("响应体必须是合法 JSON");
assert_eq!(body["code"], 600, "面 A 未登录必须是 600,实际: {body}");
// 面 B 的 POST:未登录 ⇒ `code=602`(官方前端只对 601/602 清 token)。
let resp = raw(
port,
&post_face_b("/api/permission/Authority/Data/any-id/Values", "{}"),
)
.await;
let (_, body) = resp.split_once("\r\n\r\n").expect("响应必须有头体分隔");
let body: Value = serde_json::from_str(body).expect("响应体必须是合法 JSON");
assert_eq!(body["code"], 602, "面 B 未登录必须是 602,实际: {body}");
}
/// 🔴 **判别头分流钉死**:`CurrentUser` 未登录时 —— 面 A 返 `600`、面 B 返 `602`。
#[tokio::test]
async fn current_user_routes_by_discriminator_header() {
let port = serve(new_state(db().await)).await;
// 面 A(无判别头)⇒ 600。
let resp = raw(port, &get("/api/oauth/CurrentUser")).await;
let (_, body) = resp.split_once("\r\n\r\n").expect("响应必须有头体分隔");
let body: Value = serde_json::from_str(body).expect("响应体必须是合法 JSON");
assert_eq!(body["code"], 600, "面 A 未登录必须是 600,实际: {body}");
// 面 B(`Vue-Version: 3`)⇒ 602。
let resp = raw(port, &get_face_b("/api/oauth/CurrentUser")).await;
let (_, body) = resp.split_once("\r\n\r\n").expect("响应必须有头体分隔");
let body: Value = serde_json::from_str(body).expect("响应体必须是合法 JSON");
assert_eq!(body["code"], 602, "面 B 未登录必须是 602,实际: {body}");
}
/// 🔴 **面 B 的官方端点未登录时一律 602**(不是 600、不是 404、不是 405)。
#[tokio::test]
async fn face_b_endpoints_return_602_without_token() {
let port = serve(new_state(db().await)).await;
for path in [
"/api/permission/Users",
"/api/permission/Role",
"/api/permission/Organize/AsyncList/0",
"/api/system/Menu/ModuleBySystem",
] {
let raw = raw(port, &get_face_b(path)).await;
assert!(
raw.starts_with("HTTP/1.1 200 OK"),
"{path} 未登录也必须 HTTP 200 + 信封,实际: {raw}"
);
let (_, body) = raw.split_once("\r\n\r\n").expect("响应必须有头体分隔");
let body: Value = serde_json::from_str(body).expect("响应体必须是合法 JSON");
assert_eq!(body["code"], 602, "{path} 未登录必须是 602,实际: {body}");
}
}
/// 🔴 **业务包的路由也是面 B** ⇒ 未登录必须返 **602**(不是面 A 的 600)。
///
/// 🔴 **为什么这条要钉**:官方前端 `request.ts:78-80` **只对 601/602 清 token**
/// ⇒ 只返 600 会让页面**卡住不跳登录**(`MIGRATION.md` §2.5)。
/// ⇒ 面 A 返 600、面 B 返 602 —— 两套并存。
#[tokio::test]
async fn pack_routes_return_602_without_token() {
let port = serve(new_state(db().await)).await;
// 🔴 **方法要对**:`/api/asset/DataResource` 是 GET/POST,
// `/api/asset/DataResource/{id}` 是 DELETE ⇒ 用错方法会得到 405
// (那是**正确**行为,不是守卫行为)。
let cases = [
(get_face_b("/api/asset/DataResource"), "/api/asset/DataResource"),
(
delete_face_b("/api/asset/DataResource/abc-123"),
"/api/asset/DataResource/abc-123",
),
];
for (req, path) in cases {
let raw = raw(port, &req).await;
assert!(
raw.starts_with("HTTP/1.1 200 OK"),
"{path} 未登录也必须 HTTP 200 + 信封,实际: {raw}"
);
let (_, body) = raw.split_once("\r\n\r\n").expect("响应必须有头体分隔");
let body: Value = serde_json::from_str(body).expect("响应体必须是合法 JSON");
assert_eq!(body["code"], 602, "{path} 未登录必须是 602,实际: {body}");
}
}
/// 🔴 **业务包的列表响应必须是官方 `PageListVO`** —— `{pagination, list}`,
/// **不是**面 A 的裸数组。
///
/// 🔴 **为什么这条要钉**:官方前端读 `res.data.list`;裸数组 ⇒ `undefined`
/// ⇒ **静默**空表格(不报错、不红条)⇒ 最难查的一类。
#[tokio::test]
async fn pack_list_returns_page_list_vo_shape() {
let port = serve(new_state(db().await)).await;
// 先造一行(登录态走面 A 的登录端点拿 token)。
let raw = raw(port, &get_face_b("/api/asset/DataResource")).await;
let (_, body) = raw.split_once("\r\n\r\n").expect("响应必须有头体分隔");
let body: Value = serde_json::from_str(body).expect("响应体必须是合法 JSON");
// 未登录 ⇒ 602 ⇒ 数据还没到 ⇒ 但**信封形状**已经能验。
assert_eq!(body["code"], 602);
assert!(body["data"].is_null(), "失败时 data 必须是 null: {body}");
}
}