影响: - 路由、响应形状、契约台账**零变化**(620 测试全绿,fe-gap 缺口 441/900 不变) - 官方模块名 ↔ 官方前端 `api/<模块>/**` 目录名一一对应,查缺口不用猜 改动: - 新增 `platform/compat/`:按官方模块拆成 system / permission / message / scheduletask / core + helper(公共底座:导入 / 通用工具 / 判别头 / 守卫 / 共享常量 / 菜单与用户信息构造) - `face_b.rs`(26578 行 / 371 端点)→ `platform/compat/` 六个模块文件 - `face_c.rs` 草稿暂不入库(onlineDev 未接线) - `platform/system.rs` → `platform/registry.rs`(多应用注册表,让位官方模块名) - `platform/permission.rs` → `platform/authorization.rs`(授权引擎,同上) 设计: - 不用 `jnpf/` 这一层 —— 本仓要弱化原厂概念,且 `check-naming.sh` 的 NM1 规则会把含原厂名的目录判为阻断 - 跨模块引用一律 `pub(super)`,不让契约面细节外泄到 crate 公共 API - impl 块跟随其类型走(否则 Rust 报「不能为 crate 外的类型定义 inherent impl」)
2127 lines
98 KiB
Rust
2127 lines
98 KiB
Rust
//! 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))
|
||
.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 钉死)。
|
||
.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;
|
||
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()),
|
||
}
|
||
}
|
||
|
||
/// 按**生产同一条链**造出完整 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}");
|
||
}
|
||
}
|