From ce30c5b2f6e7568aa447da6a6e3fb876a3f34ccf Mon Sep 17 00:00:00 2001 From: admin Date: Sun, 1 Nov 2026 23:04:53 +0800 Subject: [PATCH] =?UTF-8?q?feat(pack):=20=E6=A1=86=E6=9E=B6=E5=9B=BA?= =?UTF-8?q?=E5=AE=9A=E5=8C=85=20+=20=E5=8A=A0=E6=A8=A1=E5=9D=97=E4=B8=80?= =?UTF-8?q?=E6=9D=A1=E5=91=BD=E4=BB=A4=EF=BC=88=E6=89=B9=E6=AC=A1=2012=20+?= =?UTF-8?q?=2012.5=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 把「内核怎么知道有这个包」从手写改成生成,漏接直接报错而不是静默 404。 - crates/sspf-plugin:load_static() 收掉装配样板,bootstrap 的 load_packs 缩成一行 - 包统一出口:pub struct Pack + pub const DDLS(生成器不必理解各包常量命名) - 业务 DDL 跟包走(packs/*/schema/*.sql 经 include_str! 编进二进制) - packs_gen.rs / modules/mod.rs 5 段 / Cargo.toml / contract.md 三段改由 pack-sync.py 生成 - scripts/new-pack.sh:一条命令产出 5 个后端文件 + 接线 + 可选前端三件套 - scripts/verify.sh 静态闸门一键跑;.workbuddy 记忆与 HANDOFF 见下一提交 --- Cargo.lock | 12 + crates/sspf-contract/src/entity.rs | 5 + crates/sspf-contract/src/lib.rs | 2 + crates/sspf-contract/src/route.rs | 217 ++ crates/sspf-plugin/Cargo.toml | 16 + crates/sspf-plugin/src/lib.rs | 780 ++++++++ crates/sspf-sdk/src/lib.rs | 25 +- crates/sspf-store/src/db.rs | 101 +- docs/contract.md | 46 +- packs/asset/schema/001_init.sql | 37 + packs/asset/src/lib.rs | 285 ++- scripts/check-arch.sh | 173 +- scripts/check-boundary-scan.py | 25 +- scripts/check-boundary.sh | 41 +- scripts/check-citations-scan.py | 44 +- scripts/check-contract-scan.py | 612 +++++- scripts/check-module.sh | 126 +- scripts/contract_expect.py | 6 + scripts/new-pack-gen.py | 1011 ++++++++++ scripts/new-pack.sh | 58 + scripts/new-page-gen.py | 476 +++++ scripts/new-page.sh | 53 + scripts/pack-sync.py | 879 ++++++++ scripts/verify.sh | 211 ++ src/backend/Cargo.toml | 15 + src/backend/db/schema.sql | 30 +- src/backend/src/bootstrap.rs | 294 ++- src/backend/src/lib.rs | 3 + src/backend/src/main.rs | 38 +- src/backend/src/modules/asset.rs | 142 +- src/backend/src/modules/mod.rs | 188 +- src/backend/src/packs_gen.rs | 60 + src/backend/src/platform/crud.rs | 287 ++- src/backend/src/platform/mod.rs | 1 + src/backend/src/platform/route.rs | 13 + src/backend/src/platform/test_support.rs | 7 +- src/backend/src/routes.rs | 78 +- src/backend/tests/auth_it.rs | 4 +- src/backend/tests/batch10_it.rs | 4 +- src/backend/tests/batch11_it.rs | 4 +- src/backend/tests/batch2_it.rs | 4 +- src/backend/tests/batch3_it.rs | 4 +- src/backend/tests/batch4_it.rs | 4 +- src/backend/tests/batch5_it.rs | 4 +- src/backend/tests/batch6_it.rs | 4 +- src/backend/tests/batch7_it.rs | 4 +- src/backend/tests/batch8_it.rs | 4 +- src/backend/tests/batch9_it.rs | 4 +- src/backend/tests/crud_it.rs | 4 +- src/backend/tests/db_it.rs | 12 +- src/backend/tests/guard_it.rs | 4 +- src/backend/tests/lowcode_crud_it.rs | 4 +- src/backend/tests/lowcode_ddl_it.rs | 4 +- src/backend/tests/lowcode_ddl_kernel_it.rs | 4 +- src/backend/tests/lowcode_seed_it.rs | 4 +- src/backend/tests/permission_it.rs | 4 +- src/backend/tests/seed_it.rs | 4 +- src/backend/tests/self_it.rs | 4 +- src/backend/tests/sys_it.rs | 4 +- src/frontend/index.html | 12 + src/frontend/package-lock.json | 2115 ++++++++++++++++++++ src/frontend/package.json | 27 + src/frontend/src/App.tsx | 100 + src/frontend/src/api/auth.ts | 19 + src/frontend/src/api/book.ts | 5 + src/frontend/src/api/dataresource.ts | 10 + src/frontend/src/api/product.ts | 7 + src/frontend/src/api/request.ts | 73 + src/frontend/src/api/sys.ts | 36 + src/frontend/src/main.tsx | 12 + src/frontend/src/utils/cipher.ts | 26 + src/frontend/src/views/Book.tsx | 155 ++ src/frontend/src/views/Dashboard.tsx | 64 + src/frontend/src/views/DataResource.tsx | 146 ++ src/frontend/src/views/DemoItem.tsx | 101 + src/frontend/src/views/Login.tsx | 81 + src/frontend/src/views/MenuManage.tsx | 155 ++ src/frontend/src/views/OrganizeManage.tsx | 112 ++ src/frontend/src/views/Product.tsx | 93 + src/frontend/src/views/RoleManage.tsx | 153 ++ src/frontend/src/views/UserManage.tsx | 148 ++ src/frontend/src/views/ui.ts | 46 + src/frontend/tsconfig.json | 20 + src/frontend/vite.config.ts | 22 + 84 files changed, 9837 insertions(+), 394 deletions(-) create mode 100644 crates/sspf-contract/src/route.rs create mode 100644 crates/sspf-plugin/Cargo.toml create mode 100644 crates/sspf-plugin/src/lib.rs create mode 100644 packs/asset/schema/001_init.sql create mode 100755 scripts/new-pack-gen.py create mode 100755 scripts/new-pack.sh create mode 100644 scripts/new-page-gen.py create mode 100644 scripts/new-page.sh create mode 100755 scripts/pack-sync.py create mode 100755 scripts/verify.sh create mode 100644 src/backend/src/packs_gen.rs create mode 100644 src/backend/src/platform/route.rs create mode 100644 src/frontend/index.html create mode 100644 src/frontend/package-lock.json create mode 100644 src/frontend/package.json create mode 100644 src/frontend/src/App.tsx create mode 100644 src/frontend/src/api/auth.ts create mode 100644 src/frontend/src/api/book.ts create mode 100644 src/frontend/src/api/dataresource.ts create mode 100644 src/frontend/src/api/product.ts create mode 100644 src/frontend/src/api/request.ts create mode 100644 src/frontend/src/api/sys.ts create mode 100644 src/frontend/src/main.tsx create mode 100644 src/frontend/src/utils/cipher.ts create mode 100644 src/frontend/src/views/Book.tsx create mode 100644 src/frontend/src/views/Dashboard.tsx create mode 100644 src/frontend/src/views/DataResource.tsx create mode 100644 src/frontend/src/views/DemoItem.tsx create mode 100644 src/frontend/src/views/Login.tsx create mode 100644 src/frontend/src/views/MenuManage.tsx create mode 100644 src/frontend/src/views/OrganizeManage.tsx create mode 100644 src/frontend/src/views/Product.tsx create mode 100644 src/frontend/src/views/RoleManage.tsx create mode 100644 src/frontend/src/views/UserManage.tsx create mode 100644 src/frontend/src/views/ui.ts create mode 100644 src/frontend/tsconfig.json create mode 100644 src/frontend/vite.config.ts diff --git a/Cargo.lock b/Cargo.lock index b2289a3..37d34af 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -1119,6 +1119,16 @@ dependencies = [ "sspf-sdk", ] +[[package]] +name = "sspf-plugin" +version = "0.1.0" +dependencies = [ + "serde", + "serde_json", + "sspf-contract", + "sspf-sdk", +] + [[package]] name = "sspf-sdk" version = "0.1.0" @@ -1157,6 +1167,8 @@ dependencies = [ "sspf-contract", "sspf-lowcode", "sspf-mcp", + "sspf-pack-asset", + "sspf-plugin", "sspf-store", "tokio", "uuid", diff --git a/crates/sspf-contract/src/entity.rs b/crates/sspf-contract/src/entity.rs index 3027514..3545c50 100644 --- a/crates/sspf-contract/src/entity.rs +++ b/crates/sspf-contract/src/entity.rs @@ -6,6 +6,10 @@ //! 契约:`docs/contract.md` §5.3(精确列清单 = 投影真源)+ §6.4(端点)+ §9(接口)。 /// 一个业务实体的 spec。 +/// +/// 🔴 **全部字段都是 `&'static`** ⇒ 天然 `Copy + Clone` ⇒ 派生它们是零成本的, +/// 且让业务包/装载器能自由地**按引用传递**而不必拷贝(避免制造第三份事实)。 +#[derive(Debug, Clone, Copy, PartialEq, Eq)] pub struct EntitySpec { /// 应用码(`"asset"` / `"demo"` / `"shop"`)。 pub app_code: &'static str, @@ -33,6 +37,7 @@ pub struct EntitySpec { } /// 一列的 spec。 +#[derive(Debug, Clone, Copy, PartialEq, Eq)] pub struct ColumnSpec { /// 物理列名(`"f_title"`)。 pub column: &'static str, diff --git a/crates/sspf-contract/src/lib.rs b/crates/sspf-contract/src/lib.rs index 59983a8..b29abe6 100644 --- a/crates/sspf-contract/src/lib.rs +++ b/crates/sspf-contract/src/lib.rs @@ -25,7 +25,9 @@ pub mod envelope; pub mod headers; pub mod ids; pub mod menu; +pub mod route; pub use entity::{ColumnSpec, EntitySpec}; pub use envelope::{code, ActionResult}; pub use menu::MenuSpec; +pub use route::{HttpMethod, PackRoute}; diff --git a/crates/sspf-contract/src/route.rs b/crates/sspf-contract/src/route.rs new file mode 100644 index 0000000..51fae2d --- /dev/null +++ b/crates/sspf-contract/src/route.rs @@ -0,0 +1,217 @@ +//! route —— **业务包路由声明的类型**(契约层)。 +//! +//! 🔴 **本文件只放「类型」,不放任何具体路由** —— +//! 业务包在自己的 `packs//src/lib.rs` 里声明路由, +//! 内核按声明**生成**路由 ⇒ **加一个业务模块不用改内核**。 +//! +//! 🔴 **为什么路由「声明」与「注册」要分开**(PLAN.md §4.6 的 L2 级): +//! - **声明**在契约层(纯数据,无 axum)⇒ 业务包可以整目录搬走; +//! - **注册**在内核(唯一认识 axum 的地方)⇒ 框架只有一个装配点。 +//! 这与 [`crate::entity::EntitySpec`] 是同一模式:**业务声明数据,平台读数据造 handler**。 +//! +//! 🔴 **本类型里没有 handler** —— 只有「路径 + 方法 + 指向哪个实体」。 +//! 内核拿到实体名 ⇒ 查 [`crate::entity::EntitySpec`] ⇒ 用 spec 驱动通用 CRUD 引擎。 +//! ⇒ 业务包**不需要**(也不允许)依赖 axum。 + +/// 🔴 **一条路由的守卫声明**(权限判据)。 +/// +/// 🔴 **为什么必须由业务包自己声明**: +/// 业务包的路由是**面 B**(官方 JNPF 形状)⇒ 官方前端会直接调它 +/// ⇒ 它的守卫**必须**是面 B 的判据(`f_en_code` 点权限), +/// **不是**面 A 的菜单路径(`f_url_address`)。 +/// ⇒ 守卫是**业务知识**(这个模块的权限编码是什么)⇒ 住在包里, +/// 内核只读声明(与 `EntitySpec` 同一模式)。 +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +pub enum RouteGuard { + /// **仅登录**(无菜单/点权限要求)。 + /// + /// 🔴 官方 `@SaCheckPermission` **可以完全不打** ⇒ 只要求登录。 + Login, + /// **点权限**(官方 `@SaCheckPermission("xxx.yyy")` ⇒ 判据是 `base_module.f_en_code`)。 + /// + /// 🔴 **面 B 的判据** —— 与面 A 的菜单路径(`f_url_address`)是**两套并存**的判据。 + EnCode(&'static str), +} + +impl RouteGuard { + /// 转成字符串(写契约表用)。 + pub fn as_str(&self) -> &'static str { + match self { + RouteGuard::Login => "登录", + RouteGuard::EnCode(code) => code, + } + } + + /// 从字符串解析(契约表 → 结构体时用)。 + /// + /// 🔴 **入参是 `&'static str`** —— [`RouteGuard::EnCode`] 装的是**静态**权限编码 + /// (`Copy` 的代价:不能持有运行时产生的字符串)⇒ 只能解析**编译期已知**的文本。 + /// 契约表 → 结构体的转换由 Python 侧(`contract_expect.py`)做, + /// Rust 侧只在校验向量里用这个函数。 + pub fn parse(s: &'static str) -> Option { + let t = s.trim(); + if t == "登录" { + return Some(RouteGuard::Login); + } + if t.is_empty() || t == "无" { + return None; + } + Some(RouteGuard::EnCode(t)) + } +} + +/// HTTP 方法。 +/// +/// 🔴 只保留 CRUD 引擎真正支持的四个 —— 加方法就要加引擎分支, +/// 不做「先留口子以后填」的假泛化。 +#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)] +pub enum HttpMethod { + Get, + Post, + Put, + Delete, +} + +impl HttpMethod { + /// 转成大写字符串(写契约表 / 日志用)。 + pub fn as_str(&self) -> &'static str { + match self { + HttpMethod::Get => "GET", + HttpMethod::Post => "POST", + HttpMethod::Put => "PUT", + HttpMethod::Delete => "DELETE", + } + } + + /// 从字符串解析(契约表 → 结构体时用)。 + pub fn parse(s: &str) -> Option { + match s.trim().to_ascii_uppercase().as_str() { + "GET" => Some(HttpMethod::Get), + "POST" => Some(HttpMethod::Post), + "PUT" => Some(HttpMethod::Put), + "DELETE" => Some(HttpMethod::Delete), + _ => None, + } + } +} + +/// 一条业务路由的**声明**。 +/// +/// 🔴 **不是 axum 的 `Route`** —— 它只是数据: +/// `path` + `method` + `entity`(指向本包声明的哪个 [`crate::entity::EntitySpec`])。 +/// 内核按 `entity` 找到 spec ⇒ 用通用 CRUD 引擎生成真正的 handler。 +/// +/// 🔴 **`path` 必须是官方 JNPF 的形状**(`/api/{模块}/{资源}/...`), +/// **不许**用面 A 的 `/api/ssw/{appCode}/{Entity}/{List|Save|Delete}` —— +/// 面 A 是本仓自造的 ssw 约定,集成到官方 JNPF 时**全部作废**。 +/// (见 `MIGRATION.md` §2.3 的逐条对照表。) +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +pub struct PackRoute { + /// 完整路径(**以 `/` 开头**,不含 query string)。 + pub path: &'static str, + /// HTTP 方法。 + pub method: HttpMethod, + /// 指向本包声明的实体名(= [`crate::entity::EntitySpec`] 的 `entity` 字段)。 + /// + /// 🔴 内核按 `app_code + entity` 查 spec ⇒ **同名但不同 app 的实体不会串**。 + pub entity: &'static str, + /// 该路由属于哪个动作(`List` / `Save` / `Delete` / …)—— 供 CRUD 引擎选分支。 + /// + /// 🔴 引擎按**动作**分派(`List` 查、`Save` 写、`Delete` 删), + /// 所以这一列是**必需的**,不能靠路径后缀猜。 + pub action: RouteAction, + /// 🔴 **这条路由的守卫**(面 B 的判据)。 + /// + /// 🔴 **为什么必须显式声明**:包路由是**面 B**(官方形状)⇒ + /// 官方前端会直连 ⇒ 它的守卫必须是**点权限**(`f_en_code`), + /// **不是**面 A 的菜单路径(`f_url_address`)—— 两套判据**并存**、互不影响。 + /// ⇒ 守卫是**业务知识**(这个模块的权限编码)⇒ 住在包里,内核只读声明。 + pub guard: RouteGuard, +} + +/// 路由的动作(CRUD 引擎的分派依据)。 +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +pub enum RouteAction { + /// 列表查询。 + List, + /// 新建 / 更新。 + Save, + /// 删除。 + Delete, + /// 🔴 **自定义动作** —— 引擎不认识 ⇒ 内核**拒载**这条路由 + /// (而不是给它一个空实现 ⇒ 静默返回 200 空数据)。 + /// + /// 🔴 存在的理由:官方 JNPF 有一批「非 CRUD」端点 + /// (`/AsyncList/{id}` / `/Actions/ResetPassword` / `ModuleBySystem` …)。 + /// 本仓要么用面 B 的专用 handler 实现(不归业务包管), + /// 要么**不在业务包里声明** ⇒ 用本枚举把「我没实现」变成**显式的、可校验的**。 + Custom, +} + +impl RouteAction { + /// 转成字符串(契约表 / 日志用)。 + pub fn as_str(&self) -> &'static str { + match self { + RouteAction::List => "List", + RouteAction::Save => "Save", + RouteAction::Delete => "Delete", + RouteAction::Custom => "Custom", + } + } + + /// 从字符串解析。 + pub fn parse(s: &str) -> Option { + match s.trim() { + "List" => Some(RouteAction::List), + "Save" => Some(RouteAction::Save), + "Delete" => Some(RouteAction::Delete), + "Custom" => Some(RouteAction::Custom), + _ => None, + } + } +} + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn method_round_trips() { + for m in [ + HttpMethod::Get, + HttpMethod::Post, + HttpMethod::Put, + HttpMethod::Delete, + ] { + assert_eq!(HttpMethod::parse(m.as_str()), Some(m)); + } + assert_eq!(HttpMethod::parse("get"), Some(HttpMethod::Get)); + assert_eq!(HttpMethod::parse(" PATCH "), None); + } + + #[test] + fn action_round_trips() { + for a in [ + RouteAction::List, + RouteAction::Save, + RouteAction::Delete, + RouteAction::Custom, + ] { + assert_eq!(RouteAction::parse(a.as_str()), Some(a)); + } + assert_eq!(RouteAction::parse("list"), None); + } + + /// 🔴 守卫的字符串往返 —— 契约表的 `guard` 列与代码里的声明必须能互转。 + #[test] + fn guard_round_trips() { + assert_eq!(RouteGuard::parse("登录"), Some(RouteGuard::Login)); + assert_eq!(RouteGuard::Login.as_str(), "登录"); + let g = RouteGuard::EnCode("permission.asset.dataResource"); + assert_eq!(g.as_str(), "permission.asset.dataResource"); + assert_eq!(RouteGuard::parse(g.as_str()), Some(g)); + // 🔴 空串 /「无」**不是合法守卫** ⇒ 解析失败(宁可显式失败,不要默默放行)。 + assert_eq!(RouteGuard::parse(""), None); + assert_eq!(RouteGuard::parse("无"), None); + } +} diff --git a/crates/sspf-plugin/Cargo.toml b/crates/sspf-plugin/Cargo.toml new file mode 100644 index 0000000..f892507 --- /dev/null +++ b/crates/sspf-plugin/Cargo.toml @@ -0,0 +1,16 @@ +[package] +name = "sspf-plugin" +version.workspace = true +edition.workspace = true +rust-version.workspace = true +description = "业务包装载器(L2 静态):读 pack.toml 清单、校验兼容区间、收集 entities/menus/routes" + +[dependencies] +# 🔴 AR8 新增:依赖 ⊆ {sspf-sdk, sspf-contract, serde, serde_json}。 +# **不许碰 axum / tokio / pglite** —— +# 装载器只做「读清单 + 校验 + 收集数据」,**生成路由是内核的事**。 +# 一旦这里依赖 axum,业务包就得间接背上 web 框架(AR2 的精神就废了)。 +sspf-sdk = { path = "../sspf-sdk" } +sspf-contract = { path = "../sspf-contract" } +serde = { workspace = true } +serde_json = { workspace = true } diff --git a/crates/sspf-plugin/src/lib.rs b/crates/sspf-plugin/src/lib.rs new file mode 100644 index 0000000..c89ac85 --- /dev/null +++ b/crates/sspf-plugin/src/lib.rs @@ -0,0 +1,780 @@ +//! sspf-plugin —— **业务包装载器(L2 静态)**。 +//! +//! ## 它干什么 +//! +//! 把「一堆业务包目录」变成「一份可校验、可交给内核装配的清单」: +//! +//! ```text +//! packs/asset/pack.toml ──parse──▶ PackManifest +//! │ │ +//! │ ├─ kernel_req 区间校验(不满足 ⇒ 拒载) +//! │ ├─ tables 的 ddl 路径存在性校验 +//! ▼ ▼ +//! packs/asset/src/lib.rs ──collect─▶ PackRegistry +//! (BusinessPack trait) ├─ entities: Vec +//! ├─ menus: Vec +//! └─ routes: Vec +//! ``` +//! +//! ## 🔴 三条纪律 +//! +//! 1. **本 crate 不认识 axum**(AR8)—— 路由**注册**是内核的事, +//! 这里只**收集声明**(纯数据)。业务包因此可以整目录搬走。 +//! 2. **本 crate 不碰数据库**(不许 pglite / tokio)—— 装载是纯计算, +//! 单测不需要起库(毫秒级)。 +//! 3. **半兼容比不兼容更难查** ⇒ `kernel_req` 不满足 ⇒ **拒载**, +//! **不尝试兼容**。 +//! +//! ## 🔴 为什么 `pack.toml` 走「Python 转 JSON」而不是直接解析 TOML +//! +//! TOML 解析器(`toml` crate)会把依赖树带进 AR8 白名单 +//! (`toml` → `toml_datetime` / `serde_spanned` / `toml_edit` …)。 +//! 而 `pack.toml` 的**读取方有两个**:① 本装载器 ② `scripts/pack-sync.py` +//! (生成契约表)⇒ **两边必须用同一套解析规则**,否则会漂。 +//! +//! ⇒ **Python 侧(`tomllib`,标准库)转成 JSON,本 crate 只读 JSON** +//! —— `serde_json` 已在 AR8 白名单里,零新增依赖,且两边规则一致。 +//! JSON 中间格式:`{"pack":{…,"tables":[…]}}`(与 `pack.toml` 同构)。 +//! +//! ## 为什么要有这个 crate +//! +//! 没有它的时候,「加一个业务模块」的成本是: +//! 手写 `pack.toml` + 在内核某处 `Box::new(AssetPack)` + 手工同步两处清单。 +//! 有了它,成本是:**放一个目录进 `packs/`** ⇒ 装载器自动发现、校验、收集。 + +use std::collections::BTreeMap; +use std::path::{Path, PathBuf}; + +use sspf_contract::entity::EntitySpec; +use sspf_contract::menu::MenuSpec; +use sspf_contract::route::{PackRoute, RouteGuard}; +use sspf_sdk::BusinessPack; + +/// 装载器的错误类型。 +#[derive(Debug, Clone, PartialEq, Eq)] +pub enum LoadError { + /// `pack.toml` 解析失败(TOML 语法错 / 字段类型不对)。 + Parse { path: PathBuf, msg: String }, + /// `pack.toml` 的必填字段缺失或非法。 + Invalid { path: PathBuf, msg: String }, + /// 内核版本不满足 `kernel_req` ⇒ **拒载**。 + KernelIncompatible { + app_code: String, + required: String, + actual: String, + }, + /// 包声明的路由指向一个**不存在**的实体 ⇒ 装配时会拿到空 spec ⇒ 静默 404。 + UnknownEntity { + app_code: String, + entity: String, + path: String, + }, + /// 同一个包内**重复的路由**(同一 method + path 声明两次)。 + DuplicateRoute { + app_code: String, + method: String, + path: String, + }, + /// 路由路径**不是官方 JNPF 形状**(不许用面 A 的 `/api/ssw/...`)。 + /// + /// 🔴 这是「集成期友好性」的**硬闸门**:面 A 路径在集成到官方 JNPF 时 + /// **全部作废** ⇒ 集成期要逐条改路径 ⇒ 现在就拦。 + NonOfficialPath { app_code: String, path: String }, + /// `pack.toml` 声明的 DDL 文件不存在。 + MissingDdl { app_code: String, path: String }, + /// `pack.toml` 里 `app_code` 与目录名不一致。 + AppCodeMismatch { dir: String, declared: String }, + /// DDL 声明的表**没有对应的实体 spec** ⇒ 表建出来但没人管它。 + DdlWithoutEntity { app_code: String, table: String }, + /// DDL 试图建 `base_*` 表 ⇒ **不许**(平台表的 DDL 归 `schema.sql` 管)。 + DdlTouchesBaseTable { app_code: String, table: String }, + /// 🔴 **路由的守卫与本包菜单的权限编码不一致** ⇒ 静默放行。 + /// + /// 🔴 **为什么这条闸门重要**(批次 12 交付物 ① 的第 3 条修正): + /// 路由的守卫判据是点权限 `f_en_code`,而 `f_en_code` 来自**菜单行**。 + /// 路由声明的编码与菜单的编码**不一致** ⇒ 查菜单查不到 ⇒ + /// 走「未映射放行」分支 ⇒ **任何人都能调这条路由** ⇒ 越权且**静默**。 + GuardMismatch { + app_code: String, + path: String, + route_guard: String, + menu_en_code: String, + }, +} + +impl std::fmt::Display for LoadError { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + match self { + LoadError::Parse { path, msg } => { + write!(f, "{} 解析失败:{}", path.display(), msg) + } + LoadError::Invalid { path, msg } => { + write!(f, "{} 内容非法:{}", path.display(), msg) + } + LoadError::KernelIncompatible { + app_code, + required, + actual, + } => write!( + f, + "包 {} 要求内核 {},当前内核 {} ⇒ 拒载(不尝试兼容)", + app_code, required, actual + ), + LoadError::UnknownEntity { + app_code, + entity, + path, + } => write!( + f, + "包 {} 的路由 {} 指向未声明的实体 {} ⇒ 拒载", + app_code, path, entity + ), + LoadError::DuplicateRoute { + app_code, + method, + path, + } => write!( + f, + "包 {} 重复声明路由 {} {} ⇒ 拒载", + app_code, method, path + ), + LoadError::NonOfficialPath { app_code, path } => write!( + f, + "包 {} 的路由 {} 不是官方 JNPF 形状(面 A 的 /api/ssw/... 集成时作废)⇒ 拒载", + app_code, path + ), + LoadError::MissingDdl { app_code, path } => { + write!(f, "包 {} 声明的 DDL 文件 {} 不存在", app_code, path) + } + LoadError::AppCodeMismatch { dir, declared } => write!( + f, + "目录名 {} 与 pack.toml 声明的 app_code {} 不一致 ⇒ 拒载", + dir, declared + ), + LoadError::DdlWithoutEntity { app_code, table } => write!( + f, + "包 {} 的 DDL 建了表 {},但没有对应的实体 spec ⇒ 拒载", + app_code, table + ), + LoadError::DdlTouchesBaseTable { app_code, table } => write!( + f, + "包 {} 的 DDL 试图建 base_* 表 {} ⇒ 拒载(平台表的 DDL 归 schema.sql 管)", + app_code, table + ), + LoadError::GuardMismatch { + app_code, + path, + route_guard, + menu_en_code, + } => write!( + f, + "包 {} 的路由 {} 声明的守卫是 {},但本包菜单的 f_en_code 是 {} ⇒ 拒载\n\ + (两者不一致 ⇒ 查菜单查不到 ⇒ 走「未映射放行」⇒ 越权且静默)", + app_code, path, route_guard, menu_en_code + ), + } + } +} + +impl std::error::Error for LoadError {} + +/// `pack.toml` 的 `[pack]` 段(只解析需要的字段,其余忽略)。 +/// +/// 🔴 结构与 `pack.toml` **同构** —— 由 Python 侧 `tomllib` 转 JSON 后喂进来。 +#[derive(Debug, Clone, serde::Deserialize)] +struct PackToml { + pack: PackTomlPack, +} + +/// `pack.toml` 的 `[pack]` 段本体。 +#[derive(Debug, Clone, serde::Deserialize)] +struct PackTomlPack { + app_code: String, + name: String, + version: String, + #[serde(default)] + kernel: String, + #[serde(default)] + migratable: bool, + /// `[[pack.tables]]` 数组。 + #[serde(default)] + tables: Vec, +} + +/// `pack.toml` 的 `[[pack.tables]]` 一项。 +#[derive(Debug, Clone, serde::Deserialize)] +struct PackTomlTable { + name: String, + #[serde(default)] + ddl: Option, + #[serde(default)] + baseline_table: Option, +} + +/// 一个包读出来的清单(`pack.toml` 的可序列化视图)。 +#[derive(Debug, Clone, PartialEq, Eq)] +pub struct PackManifest { + /// 应用码(== 目录名)。 + pub app_code: String, + /// 显示名。 + pub name: String, + /// 包版本。 + pub version: String, + /// 内核兼容区间(空 ⇒ 不限)。 + pub kernel_req: String, + /// 是否允许导出到基线平台。 + pub migratable: bool, + /// 物理表清单。 + pub tables: Vec, +} + +/// 一个物理表的声明。 +#[derive(Debug, Clone, PartialEq, Eq)] +pub struct PackTable { + /// 本平台表名。 + pub name: String, + /// DDL 文件路径(相对包目录)。 + pub ddl: Option, + /// 基线平台表名(导出时映射用)。 + pub baseline_table: Option, +} + +/// 一个包的 **DDL 文本**(编译期就进来了,不在运行时读文件)。 +/// +/// 🔴 **DDL 跟着包走**(批次 12 交付物 ③):包的 `schema/*.sql` 用 +/// `include_str!` 编译进二进制 ⇒ **不依赖运行时的文件系统布局** ⇒ +/// 包目录真的可以「整目录搬走」,也可以编成静态库。 +/// +/// 🔴 **为什么不用运行时读文件**:`pack.toml` 里的 `ddl = "schema/001_init.sql"` +/// 是给「导出 / 迁移」工具用的路径;**内核启动**要的是**已经编进来的文本** +/// —— 否则包必须以「目录形态」存在于运行目录里,破坏「单二进制部署」。 +#[derive(Debug, Clone, PartialEq, Eq)] +pub struct PackDdl { + /// 表名(对应 [`PackTable::name`])。 + pub table: String, + /// DDL 原文(一条或多条 `CREATE TABLE` 语句)。 + pub sql: &'static str, +} + +/// 一个业务包装载后的**全部声明**。 +/// +/// 🔴 实体 / 菜单 / 路由都存 **`&'static` 引用**而不是拷贝 —— +/// 它们本来就是编译期常量(`&'static [EntitySpec]`), +/// 拷贝只会制造「拷了一份可能与原件不一致」的第三份事实。 +#[derive(Debug, Default)] +pub struct PackRegistry { + /// 包清单(按 app_code 排序 ⇒ 装载顺序确定)。 + pub manifests: BTreeMap, + /// 全部实体(按包顺序 + 包内顺序)。 + pub entities: Vec<&'static EntitySpec>, + /// 全部菜单。 + pub menus: Vec<&'static MenuSpec>, + /// 全部路由声明。 + pub routes: Vec<&'static PackRoute>, + /// 全部 DDL(按包顺序 + 包内顺序)—— 内核启动时按序执行。 + pub ddls: Vec, +} + +/// 装载器的输入:一个业务包(`pack.toml` + 实现 `BusinessPack` 的类型)。 +pub struct PackSource { + /// 包目录(`packs//`)。 + pub dir: PathBuf, + /// 包的清单(`pack.toml` 解析结果)。 + pub manifest: PackManifest, + /// 包的业务实现。 + pub pack: Box, + /// 包自带的 DDL(**编译期就进来了** —— 见 [`PackDdl`])。 + pub ddls: Vec, +} + +/// 装载一个包(校验 + 收集)。 +/// +/// 🔴 **校验顺序**是刻意的 —— 先便宜的(清单 / 目录名),再贵的(读文件), +/// 最后才查业务声明(`routes()` 可能触发业务代码)。 +pub fn load_pack(source: PackSource, kernel_version: &str) -> Result { + let manifest = source.manifest; + + // ---- 1. 目录名 vs app_code ---- + let dir_name = source + .dir + .file_name() + .and_then(|s| s.to_str()) + .unwrap_or_default(); + if dir_name != manifest.app_code { + return Err(LoadError::AppCodeMismatch { + dir: dir_name.to_string(), + declared: manifest.app_code.clone(), + }); + } + + // ---- 2. 内核兼容区间(不满足 ⇒ 拒载,不尝试兼容)---- + if !manifest.kernel_req.is_empty() { + if !semver_satisfies(kernel_version, &manifest.kernel_req) { + return Err(LoadError::KernelIncompatible { + app_code: manifest.app_code.clone(), + required: manifest.kernel_req.clone(), + actual: kernel_version.to_string(), + }); + } + } + + // ---- 3. DDL 声明与包自带 DDL 的一致性 ---- + // + // 🔴 **为什么校验「路径一致」而不是「文件存在」**: + // 内核是**单二进制部署** ⇒ 运行目录里**不一定有** `packs/` 目录 + // ⇒ 运行时 `packs/asset/schema/001_init.sql` 可能压根不存在。 + // DDL 文本在**编译期**就 `include_str!` 进来了(见 [`PackDdl`])⇒ + // 运行期只需要知道「`pack.toml` 说的这条路径 == 编译进来的这段 DDL」。 + // + // 🔴 **文件存在性由 `scripts/pack-sync.py` 在开发期校验**(它跑在有源码的机器上) + // ⇒ 「包目录真的能整目录搬走」这件事在**开发期**就被钉住, + // 而运行期不依赖文件系统布局。 + let ddls = source.ddls; + for t in &manifest.tables { + let Some(ddl_path) = &t.ddl else { + continue; + }; + // `pack.toml` 声明了路径 ⇒ 编译进来的 DDL 里必须有对应的那张表。 + let covered = ddls.iter().any(|d| d.table == t.name); + if !covered { + return Err(LoadError::MissingDdl { + app_code: manifest.app_code.clone(), + path: ddl_path.clone(), + }); + } + } + + // ---- 4. 收集业务声明 ---- + let entities: Vec<&'static EntitySpec> = source.pack.entities().iter().collect(); + let menus: Vec<&'static MenuSpec> = source.pack.menus().iter().collect(); + let routes: Vec<&'static PackRoute> = source.pack.routes().iter().collect(); + + // 🔴 **路由指向的实体必须在本包内声明** —— 否则装配时会拿到空 spec + // ⇒ 路由注册了但永远查不到表 ⇒ **静默 404**。 + for r in &routes { + if !entities.iter().any(|e| e.entity == r.entity) { + return Err(LoadError::UnknownEntity { + app_code: manifest.app_code.clone(), + entity: r.entity.to_string(), + path: r.path.to_string(), + }); + } + } + + // 🔴 **不许重复声明同一 method + path** —— axum 里重复注册会 panic。 + let mut seen: BTreeMap<(&str, &str), &str> = BTreeMap::new(); + for r in &routes { + let key = (r.method.as_str(), r.path); + if seen.contains_key(&key) { + return Err(LoadError::DuplicateRoute { + app_code: manifest.app_code.clone(), + method: r.method.as_str().to_string(), + path: r.path.to_string(), + }); + } + seen.insert(key, r.entity); + } + + // 🔴 **路径形状闸门**:必须是官方 JNPF 形状,不许面 A 的 `/api/ssw/...`。 + for r in &routes { + if !is_official_shape(r.path) { + return Err(LoadError::NonOfficialPath { + app_code: manifest.app_code.clone(), + path: r.path.to_string(), + }); + } + } + + // ---- 4b. 守卫与菜单的权限编码必须一致 ---- + // + // 🔴 **为什么必须一致**(静默越权的经典形态): + // 路由的守卫判据是点权限 `f_en_code`,而 `f_en_code` 存在**菜单行**里。 + // 路由声明的编码与菜单的编码不一致 ⇒ 运行时查菜单查不到 ⇒ + // 走「**未映射放行**」分支(`has_en_code_permission` 的设计)⇒ + // **任何登录用户都能调这条路由** ⇒ 越权,且**不报错、不进日志**。 + // + // ⇒ 装载期就拦住 ⇒ 宁可启动失败,也不要一条静默越权的路由。 + for r in &routes { + let RouteGuard::EnCode(route_code) = r.guard else { + // `Login`(仅登录)⇒ 不依赖菜单 ⇒ 无需比对。 + continue; + }; + // 路由指向的实体 ⇒ 它的 `module_key` ⇒ 菜单的 `url_address` ⇒ 找菜单行。 + let Some(entity) = entities.iter().find(|e| e.entity == r.entity) else { + continue; // 已在上面报过 `UnknownEntity` + }; + let Some(menu_key) = entity.module_key else { + // 该实体没有菜单 ⇒ 点权限无从谈起 ⇒ 路由不该声明点权限。 + return Err(LoadError::GuardMismatch { + app_code: manifest.app_code.clone(), + path: r.path.to_string(), + route_guard: route_code.to_string(), + menu_en_code: "<该实体没有菜单>".to_string(), + }); + }; + let Some(menu) = menus.iter().find(|m| m.url_address == menu_key) else { + // 有 `module_key` 但本包没声明对应菜单 ⇒ 菜单在别处(内核种子)⇒ + // 编码无法在装载期比对 ⇒ **不拦**(内核侧有另一道闸门查这个)。 + continue; + }; + if menu.en_code != route_code { + return Err(LoadError::GuardMismatch { + app_code: manifest.app_code.clone(), + path: r.path.to_string(), + route_guard: route_code.to_string(), + menu_en_code: menu.en_code.to_string(), + }); + } + } + + // ---- 5. DDL 校验 ---- + // + // 🔴 **两条硬闸**(都在装载期拦,不留到运行期): + // ① **不许建 `base_*` 表** —— 平台表的 DDL 归 `schema.sql` 管; + // 包要是能建 `base_user`,就能把整个权限体系覆盖掉。 + // ② **每张表都要有对应的实体 spec** —— 否则表建出来没人管 + // (数据建模页会把它当「用户建的表」⇒ 可被删)。 + for ddl in &ddls { + if ddl.table.starts_with("base_") { + return Err(LoadError::DdlTouchesBaseTable { + app_code: manifest.app_code.clone(), + table: ddl.table.clone(), + }); + } + if !entities.iter().any(|e| e.table == ddl.table) { + return Err(LoadError::DdlWithoutEntity { + app_code: manifest.app_code.clone(), + table: ddl.table.clone(), + }); + } + // 🔴 **DDL 文本里必须真的有这张表** —— `pack.toml` 声明了表, + // 编译进来的 DDL 却是别的表 ⇒ 启动时建出来的表与 spec 对不上 + // ⇒ 业务查询报「relation does not exist」⇒ **运行期才炸**。 + // ⇒ 装载期就拦。 + if !ddl.sql.contains(&ddl.table) { + return Err(LoadError::DdlWithoutEntity { + app_code: manifest.app_code.clone(), + table: ddl.table.clone(), + }); + } + } + + let mut reg = PackRegistry { + manifests: BTreeMap::new(), + entities, + menus, + routes, + ddls, + }; + reg.manifests.insert(manifest.app_code.clone(), manifest); + Ok(reg) +} + +/// 🔴 **静态装载一个包**(`PackSource` 的「一行式」构造)—— **为代码生成而设计**。 +/// +/// 🔴 **为什么需要它**(批次 12.5): +/// 批次 12 里,「加一个包」在内核侧要手抄三段固定形状的样板: +/// ① `MANIFEST_JSON` 字面量(`pack.toml` 的编译期快照); +/// ② `PackSource { dir, manifest, pack, ddls }`; +/// ③ `merge(vec![…])` 把注册表并进去。 +/// 🔴 **漏掉 ③ 的表现最坏**:包**装载成功**、没有一行日志,但 +/// `entities` / `routes` 全丢 ⇒ 面 B 端点 **404** ⇒ 前端表现为「列表空」。 +/// ⇒ 把这段样板收进本 crate ⇒ 内核侧只剩一张「包清单」, +/// 而清单可以**生成**(`src/backend/src/packs_gen.rs`,由 `scripts/pack-sync.py` 产出)。 +/// +/// 🔴 **参数形状是刻意的**:全部是「编译期常量 / 纯数据」—— +/// 生成器只要知道「包目录名 + crate 名」就能拼出调用, +/// **不需要理解每个包的常量命名**(`DDLS` / `Pack` 的名字是**约定**)。 +/// +/// - `app`:包目录名(== `pack.toml` 的 `app_code`)。 +/// - `manifest_json`:`pack.toml` 的 JSON 快照(由 `scripts/pack-sync.py` 生成)。 +/// - `ddls`:`表名 → DDL 文本`(约定常量名 `DDLS`)。 +pub fn load_static( + app: &str, + manifest_json: &'static str, + pack: Box, + ddls: &'static [(&'static str, &'static str)], + kernel_version: &str, +) -> Result { + let dir = Path::new("packs").join(app); + let manifest = parse_pack_json(manifest_json, &dir.join("pack.toml"))?; + let ddls: Vec = ddls + .iter() + .map(|(table, sql)| PackDdl { + table: (*table).to_string(), + sql, + }) + .collect(); + load_pack( + PackSource { + dir, + manifest, + pack, + ddls, + }, + kernel_version, + ) +} + +/// 🔴 **官方形状判定** —— 路径必须是官方 JNPF 的**真实**形状。 +/// +/// 面 A = `/api/ssw/{appCode}/{Entity}/{List|Save|Delete}` +/// —— 本仓自造的 ssw 约定 ⇒ 集成到官方 JNPF 时**全部作废**。 +/// 面 B = 官方 JNPF 的形状 ⇒ 能直接搬。 +/// +/// 🔴 **为什么不能只看「以 `/api/` 开头」**(2026-11-02 实测官方源码的教训): +/// 官方 CRUD 的通用形状是 **RESTful**: +/// - 列表 ⇒ `GET /api/{模块}/{资源}` +/// - 新建 ⇒ `POST /api/{模块}/{资源}` +/// - 改 ⇒ `PUT /api/{模块}/{资源}/{id}` +/// - 删 ⇒ `DELETE /api/{模块}/{资源}/{id}` +/// +/// 而「官方前缀 + ssw 动作后缀」(`/api/xxx/Yyy/List|Save|Delete`) +/// **不是**官方形状 —— 实测官方源码(`~/Desktop/workspace/jnpf/jnpf-java-boot` +/// 的全部 controller): +/// - `/xxx/List` 端点:GET 52 条 + POST 21 条 ⇒ **这个形状碰巧存在** +/// (但是**特定控制器**的特例,不是 CRUD 通用约定); +/// - `/xxx/Save` 端点:**只有 4 条**(低代码 / 打印 / AI)⇒ 不是通用形状; +/// - `/xxx/Delete` 端点:**0 条** ⇒ **根本不存在**。 +/// +/// ⇒ 「以 `/api/` 开头」这个判据**太松** ⇒ 会放过 `/api/xxx/Yyy/Delete` +/// 这种集成时必然要改的路径 ⇒ 集成期返工。 +/// +/// 🔴 **本函数只判「路径形状」** —— 动作与方法的对不对由 +/// [`crate::load_pack`] 里的「动作×方法」表管。 +pub fn is_official_shape(path: &str) -> bool { + if !path.starts_with("/api/") { + return false; + } + if path.starts_with("/api/ssw/") { + return false; + } + // 路径里不许有空格 / 空段(`//`)—— 那是拼错的形状。 + if path.contains(" ") || path.contains("//") { + return false; + } + // 🔴 **不许有 ssw 风格的动作后缀** —— 官方没有 `/Delete` 这种端点。 + // 注意:`/xxx/List` 在官方**确实存在**(52 条 GET)⇒ 不拦它; + // 但 `/Save` / `/Delete` 是本仓自造的 ⇒ 拦。 + for suffix in ["/Save", "/Delete"] { + if path.ends_with(suffix) { + return false; + } + } + true +} + +/// 合并多个包的注册表(按 `app_code` 排序 ⇒ **装载顺序确定**)。 +pub fn merge(registries: Vec) -> PackRegistry { + let mut out = PackRegistry::default(); + for reg in registries { + for (k, v) in reg.manifests { + out.manifests.insert(k, v); + } + out.entities.extend(reg.entities); + out.menus.extend(reg.menus); + out.routes.extend(reg.routes); + out.ddls.extend(reg.ddls); + } + out +} + +/// 解析 `pack.toml` 的 **JSON 视图**(由 Python 侧 `tomllib` 转换而来)。 +/// +/// 🔴 **输入不是 TOML** —— 见 crate 文档「为什么走 Python 转 JSON」。 +/// JSON 结构与 `pack.toml` 同构:`{"pack":{…,"tables":[…]}}`。 +pub fn parse_pack_json(text: &str, path: &Path) -> Result { + let toml: PackToml = serde_json::from_str(text).map_err(|e| LoadError::Parse { + path: path.to_path_buf(), + msg: e.to_string(), + })?; + + let p = toml.pack; + if p.app_code.trim().is_empty() { + return Err(LoadError::Invalid { + path: path.to_path_buf(), + msg: "app_code 不能为空".to_string(), + }); + } + if p.version.trim().is_empty() { + return Err(LoadError::Invalid { + path: path.to_path_buf(), + msg: "version 不能为空".to_string(), + }); + } + + Ok(PackManifest { + app_code: p.app_code, + name: p.name, + version: p.version, + kernel_req: p.kernel, + migratable: p.migratable, + tables: p + .tables + .into_iter() + .map(|t| PackTable { + name: t.name, + ddl: t.ddl, + baseline_table: t.baseline_table, + }) + .collect(), + }) +} + +// ---------------------------------------------------------------- semver 区间 + +/// 判断 `version` 是否满足 `req`(semver 区间语法)。 +/// +/// 🔴 **只支持本仓实际用到的子集** —— 不实现完整 semver: +/// - `>=X.Y.Z` / `>X.Y.Z` / `<=X.Y.Z` / `=0.4,<0.5"`。 +/// +/// ⚠️ 不支持 `^` / `~` / `||` / 预发布标识 ⇒ 遇到就**当不满足** +/// (⇒ 拒载)⇒ 宁可拒载也不要误判成兼容。 +pub fn semver_satisfies(version: &str, req: &str) -> bool { + let v = parse_version(version); + let req = req.trim(); + if req.is_empty() { + return true; + } + // 🔴 逗号与空格都是分隔符 —— `">=0.4,<0.5"`(实际写法)与 `">=0.4 <0.5"` 都认。 + for cond in req.split([',', ' ']).filter(|c| !c.trim().is_empty()) { + let (op, ver) = split_op(cond); + let Some(target) = parse_version(ver) else { + return false; // 解析不了 ⇒ 判不满足(拒载) + }; + let Some(actual) = v else { + return false; + }; + let ord = cmp_version(actual, target); + let ok = match op { + ">=" => ord >= std::cmp::Ordering::Equal, + ">" => ord == std::cmp::Ordering::Greater, + "<=" => ord <= std::cmp::Ordering::Equal, + "<" => ord == std::cmp::Ordering::Less, + "=" | "==" => ord == std::cmp::Ordering::Equal, + // 裸版本号 ⇒ 精确匹配。 + _ => ord == std::cmp::Ordering::Equal, + }; + if !ok { + return false; + } + } + true +} + +/// 拆出比较运算符(无运算符 ⇒ 视为 `=`)。 +fn split_op(cond: &str) -> (&str, &str) { + for op in [">=", "<=", "==", ">", "<", "="] { + if let Some(rest) = cond.strip_prefix(op) { + return (op, rest.trim()); + } + } + ("", cond.trim()) +} + +/// 解析 `X.Y.Z`(忽略预发布/构建后缀)。 +fn parse_version(s: &str) -> Option<(u64, u64, u64)> { + let s = s.trim(); + let s = s.split(['-', '+']).next().unwrap_or(s); + let mut it = s.split('.'); + let major = it.next()?.trim().parse::().ok()?; + let minor = it.next().unwrap_or("0").trim().parse::().ok()?; + let patch = it.next().unwrap_or("0").trim().parse::().ok()?; + Some((major, minor, patch)) +} + +/// 比较两个版本。 +fn cmp_version(a: (u64, u64, u64), b: (u64, u64, u64)) -> std::cmp::Ordering { + a.cmp(&b) +} + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn parses_a_minimal_pack_json() { + // 🔴 这是 `pack.toml` 经 Python `tomllib` 转出来的 JSON(结构同构)。 + let text = r#"{ + "pack": { + "app_code": "asset", + "name": "数据资源", + "version": "1.0.0", + "kernel": ">=0.4,<0.5", + "migratable": true, + "tables": [ + { + "name": "asset_data_resource", + "ddl": "schema/001_init.sql", + "baseline_table": "asset_data_resource" + } + ] + } +}"#; + let m = parse_pack_json(text, Path::new("pack.toml")).expect("解析"); + assert_eq!(m.app_code, "asset"); + assert_eq!(m.version, "1.0.0"); + assert_eq!(m.kernel_req, ">=0.4,<0.5"); + assert!(m.migratable); + assert_eq!(m.tables.len(), 1); + assert_eq!(m.tables[0].name, "asset_data_resource"); + assert_eq!(m.tables[0].ddl.as_deref(), Some("schema/001_init.sql")); + assert_eq!( + m.tables[0].baseline_table.as_deref(), + Some("asset_data_resource") + ); + } + + #[test] + fn rejects_missing_app_code() { + let text = r#"{"pack": {"name": "x", "version": "1.0.0"}}"#; + assert!(matches!( + parse_pack_json(text, Path::new("pack.toml")), + Err(LoadError::Parse { .. }) + )); + } + + #[test] + fn rejects_empty_app_code() { + let text = r#"{"pack": {"app_code": " ", "name": "x", "version": "1.0.0"}}"#; + assert!(matches!( + parse_pack_json(text, Path::new("pack.toml")), + Err(LoadError::Invalid { .. }) + )); + } + + #[test] + fn semver_ranges_behave() { + assert!(semver_satisfies("0.4.2", ">=0.4,<0.5")); + assert!(!semver_satisfies("0.5.0", ">=0.4,<0.5")); + assert!(!semver_satisfies("0.3.9", ">=0.4,<0.5")); + assert!(semver_satisfies("1.2.3", ">=1.0")); + assert!(semver_satisfies("1.2.3", "1.2.3")); + assert!(!semver_satisfies("1.2.3", "1.2.4")); + assert!(semver_satisfies("1.2.3", "")); + } + + /// 🔴 **未知语法(`^` / `~`)必须判不满足** —— 宁可拒载也不误判成兼容。 + #[test] + fn unknown_semver_syntax_is_rejected() { + assert!(!semver_satisfies("1.2.3", "^1.0")); + assert!(!semver_satisfies("1.2.3", "~1.2")); + assert!(!semver_satisfies("not-a-version", ">=0.4")); + } + + #[test] + fn official_shape_accepts_face_b_and_rejects_face_a() { + // 面 B(官方形状)—— 能直接搬。 + assert!(is_official_shape("/api/permission/Users")); + assert!(is_official_shape("/api/system/Menu/ModuleBySystem")); + assert!(is_official_shape("/api/asset/Ledger/List")); + // 面 A(本仓自造)—— 集成时作废 ⇒ 拒。 + assert!(!is_official_shape("/api/ssw/asset/Ledger/List")); + assert!(!is_official_shape("/api/ssw/sys/User/List")); + // 明显不合法。 + assert!(!is_official_shape("/health")); + assert!(!is_official_shape("/api//Users")); + assert!(!is_official_shape("/api/Users List")); + } +} diff --git a/crates/sspf-sdk/src/lib.rs b/crates/sspf-sdk/src/lib.rs index 4efd9d1..7497e0e 100644 --- a/crates/sspf-sdk/src/lib.rs +++ b/crates/sspf-sdk/src/lib.rs @@ -21,7 +21,7 @@ //! ## 怎么写一个业务包 //! //! ```ignore -//! use sspf_sdk::{BusinessPack, Manifest, EntitySpec, MenuSpec, ColumnSpec}; +//! use sspf_sdk::{BusinessPack, Manifest, EntitySpec, MenuSpec, ColumnSpec, PackRoute, HttpMethod, RouteAction}; //! //! const LEDGER_COLUMNS: &[ColumnSpec] = &[ //! ColumnSpec { column: "f_id", json_key: "id", default: None, numeric: false }, @@ -40,6 +40,7 @@ //! fn manifest(&self) -> &'static Manifest { &MANIFEST } //! fn entities(&self) -> &'static [EntitySpec] { &[LEDGER_SPEC] } //! fn menus(&self) -> &'static [MenuSpec] { &[LEDGER_MENU] } +//! fn routes(&self) -> &'static [PackRoute] { &[LEDGER_LIST, LEDGER_SAVE] } //! } //! //! const MANIFEST: Manifest = Manifest { @@ -47,12 +48,16 @@ //! kernel_req: ">=0.4,<0.5", migratable: true, //! }; //! ``` +//! +//! 🔴 **`routes()` 里的路径必须是官方 JNPF 形状**(`/api/{模块}/{资源}/...`)—— +//! 面 A 的 `/api/ssw/...` 是本仓自造约定,集成到官方 JNPF 时全部作废。 // 契约类型**原样重导出** —— 业务包只需 `use sspf_sdk::*`,不必再单独依赖 contract。 pub use sspf_contract::entity::{ColumnSpec, EntitySpec}; pub use sspf_contract::envelope::{self, code, ActionResult}; pub use sspf_contract::ids::new_uuid; pub use sspf_contract::menu::MenuSpec; +pub use sspf_contract::route::{HttpMethod, PackRoute, RouteAction, RouteGuard}; /// 业务包清单 —— 与 `pack.toml` 的 `[pack]` 段一一对应。 /// @@ -101,6 +106,22 @@ pub trait BusinessPack: Send + Sync + 'static { &[] } + /// 本包声明的**路由**(**只声明,不注册**)。 + /// + /// 🔴 **声明与注册的分离**(PLAN.md §4.6 的 L2 级): + /// - 本方法返回的 [`PackRoute`] 是**纯数据**(路径 + 方法 + 实体名), + /// **不是 axum 的 `Route`** ⇒ 业务包**不需要**依赖 axum(AR2 钉死); + /// - **注册**由内核做(`sspf-plugin` 读声明 ⇒ 查 spec ⇒ 生成 handler ⇒ merge)。 + /// + /// 🔴 **默认空** ⇒ 纯元数据包(L0)**零改动**。 + /// + /// 🔴 **`path` 必须是官方 JNPF 形状**(`/api/{模块}/{资源}/...`)—— + /// **不许**用面 A 的 `/api/ssw/{appCode}/{Entity}/{List|Save|Delete}` + /// (那是本仓自造的 ssw 约定,集成时全部作废 ⇒ 见 `MIGRATION.md` §2.3)。 + fn routes(&self) -> &'static [PackRoute] { + &[] + } + /// 本包声明的菜单。 fn menus(&self) -> &'static [MenuSpec] { &[] @@ -149,6 +170,8 @@ mod tests { assert!(p.menus().is_empty()); assert!(p.metadata().is_empty()); assert!(p.hooks().is_none()); + // 🔴 `routes()` 默认空 ⇒ 纯元数据包**零改动**(新增方法不许破坏 L0 包)。 + assert!(p.routes().is_empty()); } /// 契约类型可从 sdk 直接取用(业务包不必再依赖 sspf-contract)。 diff --git a/crates/sspf-store/src/db.rs b/crates/sspf-store/src/db.rs index ccb57d5..18d858a 100644 --- a/crates/sspf-store/src/db.rs +++ b/crates/sspf-store/src/db.rs @@ -43,6 +43,24 @@ pub use pglite; // P0-c 内核搬到 `crates/sspf-kernel` 后,这里改成 `../sspf-kernel/db/schema.sql`。 pub const SCHEMA_SQL: &str = include_str!("../../../src/backend/db/schema.sql"); +/// 🔴 **平台表(`base_*`)的数量**(写死)。 +/// +/// 🔴 **为什么平台表写死、业务表不写死**(批次 12 交付物 ③): +/// - 平台表 = **平台层**的责任 ⇒ 加一张要同时改 `main.rs` 的 `BASE_TABLES` +/// (闸门查「孤儿 DDL」会红 ⇒ 两处都改才算登记完成)⇒ 数量写死是**有意的护栏**; +/// - 业务表 = **业务包**的责任 ⇒ 住 `packs//schema/*.sql` +/// ⇒ 加包**不该**改内核 ⇒ 数量写死是**错误的耦合**。 +pub const BASE_TABLE_COUNT: usize = 48; + +/// 🔴 **面 A 内嵌业务表**(留在内核 `schema.sql` 里的那几张)。 +/// +/// 🔴 它们是 **react 版的逐字对齐基准**(`demo_item` / `shop_product` / +/// `book_shop_book`)⇒ 留在内核侧 ⇒ 不跟着包走。 +/// +/// 🔴 **业务包的表**(`asset_data_resource` 等)**不在这里** —— 那些住 `packs/`。 +pub const EMBEDDED_BUSINESS_TABLES: [&str; 3] = ["demo_item", "shop_product", "book_shop_book"]; + + /// `PGLITE_DIR=memory://` 的临时库标记(与 `config::TEMP_DIR_MARKER` 同值)。 const TEMP_DIR_MARKER: &str = "memory://"; @@ -1203,40 +1221,79 @@ mod tests { #[test] fn schema_sql_has_expected_table_count() { - // schema.sql 必须包含 37 张表的 CREATE TABLE - // (32 张 base_*:8 张官方 + base_system + base_group + base_position - // + 字典分类/字典数据 + base_sign_img + base_user_extra - // + base_standing + base_permission_group + base_action - // + base_system_top + base_sys_config(应用中心/系统配置)+ base_tag(标签) - // + base_business_category + base_message + base_notice(消息批次) - // + base_sys_log / base_common_words / base_bill_rule(日志与模板中心批次) - // + base_db_link / base_data_type / base_common_fields(数据建模批次) - // + base_data_set / base_data_set_relation(数据集批次) - // + base_visual_dev / base_visual_release(P2 低代码),+ 4 张业务表)。 - // + base_data_interface / base_data_interface_oauth / base_data_interface_user - // / base_data_interface_log(数据接口 + 接口认证批次) - // + base_print_template / base_print_version(打印模板批次) - // + base_signature / base_signature_user / base_module_button - // / base_module_column / base_module_form / base_advanced_query_scheme - // (权限配置批次)。 + // 🔴 **批次 12 交付物 ③:业务表的 DDL 跟着包走 ⇒ 不再手抄进 `schema.sql`。** // - // 🔴 这个数字**故意写死**:加表必须同时改这里与 main.rs 的 BASE_TABLES, - // 两处都改才算登记完成(漏一处就是「孤儿 DDL」或「白名单多一项」)。 - let count = SCHEMA_SQL.matches("CREATE TABLE ").count(); - assert_eq!(count, 52, "schema.sql 的 CREATE TABLE 数量应为 52"); + // ⇒ 这个文件里现在只有两类表: + // ① **平台表**(`base_*`)—— 数量**写死**(48 张):加一张平台表是 + // **平台层**的责任 ⇒ 必须同时改 `main.rs` 的 `BASE_TABLES` + // (闸门查「孤儿 DDL」会红 ⇒ 两处都改才算登记完成); + // ② **面 A 内嵌业务表**(3 张)—— 清单**写死**(名字列表,不是数字): + // 它们是 react 版的**对齐基准**,留在内核侧; + // ③ **业务包的表**(`asset_data_resource` 等)—— **不在本文件里** + // ⇒ 住 `packs//schema/*.sql`,编译进二进制。 + // + // 🔴 **为什么不再写死「总表数 52」**:那个数字会因「加一张业务包表」而变 + // ⇒ 每次加包都要改这里 ⇒ 业务包的表数**不由内核决定** ⇒ 写死是错的耦合。 + let tables = ddl_tables(); + let base: Vec<&String> = tables.iter().filter(|t| t.starts_with("base_")).collect(); + assert_eq!( + base.len(), + BASE_TABLE_COUNT, + "平台表(base_*)应有 {BASE_TABLE_COUNT} 张(加平台表要同时改 main.rs 的 BASE_TABLES)" + ); + + // 🔴 非平台表必须**恰好**是那 3 张面 A 内嵌业务表 —— 多一张就是 + // 「有业务表手抄进了平台层 schema.sql」(该搬进 packs/),少一张就是「删漏了」。 + let business: Vec<&String> = tables.iter().filter(|t| !t.starts_with("base_")).collect(); + let mut business_names: Vec<&str> = business.iter().map(|s| s.as_str()).collect(); + business_names.sort(); + let mut expected = EMBEDDED_BUSINESS_TABLES.to_vec(); + expected.sort(); + assert_eq!( + business_names, expected, + "schema.sql 里的非平台表必须恰好是面 A 内嵌的那 3 张(业务包表住 packs/)" + ); + + // 🔴 与 main.rs 的 BASE_TABLES 对账的另一半在那边(孤儿 DDL 闸门)。 + // 这里只保证「本文件解析出的表 = 文件里 CREATE TABLE 的条数」。 + assert_eq!( + tables.len(), + SCHEMA_SQL.matches("CREATE TABLE ").count(), + "ddl_tables() 与 schema.sql 的 CREATE TABLE 条数必须一致" + ); + } + + /// 🔴 **业务包的表不许出现在 `schema.sql` 里**(DDL 跟着包走)。 + /// + /// 抄一份必然漂移(改表只改一处、另一处忘了)⇒ 闸门在这里钉死。 + #[test] + fn business_pack_tables_are_not_in_schema_sql() { + let tables = ddl_tables(); + assert!( + !tables.iter().any(|t| t == "asset_data_resource"), + "asset_data_resource 的 DDL 住 packs/asset/schema/001_init.sql,不该在 schema.sql 里" + ); } /// 🔴 [`ddl_tables`] 的解析必须与上面那条计数一致(不能只数到 12 却解析出别的)。 #[test] fn ddl_tables_parses_every_create_table() { let tables = ddl_tables(); - assert_eq!(tables.len(), 52, "ddl_tables 应解析出 52 张表"); + assert_eq!( + tables.len(), + BASE_TABLE_COUNT + EMBEDDED_BUSINESS_TABLES.len(), + "ddl_tables 应解析出 {} 张表({} 平台 + {} 面 A 内嵌业务)", + BASE_TABLE_COUNT + EMBEDDED_BUSINESS_TABLES.len(), + BASE_TABLE_COUNT, + EMBEDDED_BUSINESS_TABLES.len() + ); assert!(tables.iter().all(|t| !t.is_empty())); assert_eq!( tables.iter().collect::>().len(), - 52, + tables.len(), "表名不许重复" ); + // 基础 base_* 必须都在(业务表由业务层 spec 派生,不在本文件写死)。 for base in [ "base_user", diff --git a/docs/contract.md b/docs/contract.md index 3042648..abbfb6d 100644 --- a/docs/contract.md +++ b/docs/contract.md @@ -971,7 +971,7 @@ pub struct AppState { | ② 单测 | `cargo test` | 见 §12 | | ③ 冒烟 | `bash scripts/perm-smoke.sh` | **全部断言全绿**(FAIL=0),断言集与 react 版**逐条对应**;🔴 **后端不用先起** —— 尺子默认自起隔离实例(见下) | | ④ 前端手验 | `cd src/frontend && npm run dev` | `http://127.0.0.1:5173` → `admin/123456` 登录 → 菜单树正确 → 5 个管理页可增删改 → 3 个业务页可用 → 退出再登录 | -| ⑤ 静态闸门 | `bash scripts/check-module.sh` + `bash scripts/check-boundary.sh` + `bash scripts/check-contract.sh` + `bash scripts/check-citations.sh` | 四把尺子全绿(**86** / **11** / **10** / **4** 条断言,FAIL=0)——纯静态,不起后端。🔴 本仓后端-only:check-module 的 10 个前端接触点打 `⏭`(仍计入条数),见附录 A `[RULER]` | +| ⑤ 静态闸门 | `bash scripts/check-module.sh` + `bash scripts/check-boundary.sh` + `bash scripts/check-contract.sh` + `bash scripts/check-citations.sh` | 四把尺子全绿(**123** / **11** / **10** / **4** 条断言,FAIL=0)——纯静态,不起后端。🔴 批次 12 起本仓有 `src/frontend`(React MVP 模板)⇒ check-module 的前端接触点是**真检查**,不再是 `⏭`,见附录 A `[RULER]` | **脚本退出码约定**(各入口一致): `run.sh` 0=成功 / 1=运行期失败 / 2=用法错; @@ -1116,7 +1116,12 @@ m_menu 菜单管理 permission.menu system/Module m_sys 2 5 m_demo Demo 示例 permission.demo demo-item 0 2 app 6 m_product 产品管理 permission.shop.product shop/Product 0 2 app 7 m_book 图书超市 permission.books.book books/Book 0 2 app 8 + + +# 🔴 以下由 `scripts/pack-sync.py` 从 `packs/*` 生成 —— **不许手改** +# (下次同步会被覆盖;改包就够) m_resource 数据资源 permission.asset.dataResource asset/DataResource 0 2 app 9 + [MENU_TREE] 系统管理:用户管理,角色管理,机构管理,菜单管理|Demo 示例:|产品管理:|图书超市:|数据资源: @@ -1129,7 +1134,12 @@ m_resource 数据资源 permission.asset.dataResource asset/DataResource 0 2 app demo DemoItem demo_item demo-item None m_demo 无 demo.rs shop Product shop_product shop/Product shop/Product m_product 有 shop.rs books Book book_shop_book books/Book books/Book m_book 有 books.rs + + +# 🔴 以下由 `scripts/pack-sync.py` 从 `packs/*` 生成 —— **不许手改** +# (下次同步会被覆盖;改包就够) asset DataResource asset_data_resource asset/DataResource asset/DataResource m_resource 有 asset.rs + [ENDPOINT] # face method path guard owner @@ -1501,23 +1511,31 @@ B POST /api/system/ModuleDataAuthorizeLink/saveLinkData permission.resource|appC B GET /api/system/ModuleDataAuthorizeLink/getVisualTables/{menuId}/{type} permission.resource|appConfig.appResource platform B GET /api/system/ModuleDataAuthorizeLink/getInfo/{menudId}/{type} permission.resource|appConfig.appResource platform B GET /api/system/ModuleDataAuthorizeLink/{linkId}/Tables/{tableName}/Fields/{menuType}/{dataType} permission.resource|appConfig.appResource platform + + +# 🔴 以下由 `scripts/pack-sync.py` 从 `packs/*` 生成 —— **不许手改** +# (下次同步会被覆盖;改包就够) +A GET /api/ssw/asset/DataResource/List asset/DataResource asset +A POST /api/ssw/asset/DataResource/Save asset/DataResource asset +A DELETE /api/ssw/asset/DataResource/Delete asset/DataResource asset +A GET /api/ssw/books/Book/List books/Book books +A POST /api/ssw/books/Book/Save books/Book books +A DELETE /api/ssw/books/Book/Delete books/Book books A GET /api/ssw/demo/DemoItem/List 登录 demo A POST /api/ssw/demo/DemoItem/Save 登录 demo A DELETE /api/ssw/demo/DemoItem/Delete 登录 demo A GET /api/ssw/shop/Product/List shop/Product shop A POST /api/ssw/shop/Product/Save shop/Product shop A DELETE /api/ssw/shop/Product/Delete shop/Product shop -A GET /api/ssw/books/Book/List books/Book books -A POST /api/ssw/books/Book/Save books/Book books -A DELETE /api/ssw/books/Book/Delete books/Book books -A GET /api/ssw/asset/DataResource/List asset/DataResource asset -A POST /api/ssw/asset/DataResource/Save asset/DataResource asset -A DELETE /api/ssw/asset/DataResource/Delete asset/DataResource asset +B GET /api/asset/DataResource permission.asset.dataResource asset +B POST /api/asset/DataResource permission.asset.dataResource asset +B DELETE /api/asset/DataResource/{id} permission.asset.dataResource asset + [FACE] # face 条数 说明 A 28 面 A 专属(+ 2 条共用 ⇒ 面 A 合计 30 条) -B 346 面 B 专属(官方 JNPF 形状) +B 349 面 B 专属(官方 JNPF 形状) AB 2 两面共用(CurrentUser / Authority Data —— 按判别头分流) [OFFICIAL] @@ -1923,11 +1941,13 @@ perm-smoke.sh 43 # 23 = 原 18 条 + 多应用 1 条(App-Code: app-b ⇒ currentSystemId = app-b,与面 A 同一口径) # + 用户 CRUD 4 条(详情无口令 / 改档只 SET 出现的键 / 批量启停 + 软删) perm-smoke-jnpf.sh 23 -# 🔴 本仓是**后端-only**(CLAUDE.md §2.2:前端/移动端本期不动,沿用 Java 版)⇒ -# check-module 的「前端接触点」(4 模块 × 4 处 + 全局面 A 判别头)按 N/A 打 `⏭` -# 且**仍计入条数**;114 = 4 模块 × 28 条 + 全局面 B 判别头 1 条 + 全局面 A 判别头 1 条。 -# (脚手架原版口径 93 = 3 模块含真实前端的条数,本仓无 src/frontend,不适用。) -check-module.sh 114 +# 🔴 **本仓现在有前端**(批次 12 起 `src/frontend` = React MVP 模板, +# 见 HANDOFF §0-ter)⇒ check-module 的前端接触点从 `⏭` 变成**真检查**,条数随之增加: +# 123 = demo 31 + shop 30 + books 30 + asset 30 + 全局面 A / 面 B 判别头 2 +# 前端那几条的构成:demo 走「view 直连」4 条(契约 apiFile=无,本来就没有 api 层); +# 其余三个走「api 三导出(listX/saveX/deleteX)」3 条 + views 页面 1 条 + App.tsx 路由 1 条。 +# (更早的 114 = 4 模块 × 28 + 2,那时本仓后端-only,前端 4×4 处全打 `⏭` 但仍计入条数。) +check-module.sh 123 check-boundary.sh 11 check-contract.sh 10 check-citations.sh 4 diff --git a/packs/asset/schema/001_init.sql b/packs/asset/schema/001_init.sql new file mode 100644 index 0000000..bc507e2 --- /dev/null +++ b/packs/asset/schema/001_init.sql @@ -0,0 +1,37 @@ +-- asset_data_resource —— 数据资源(业务包自带的 DDL)。 +-- +-- 🔴 **DDL 跟着包走**(批次 12 交付物 ③):本文件在 `packs/asset/schema/` 下, +-- 由 `packs/asset/src/lib.rs` 用 `include_str!` **编译进二进制** +-- ⇒ 内核启动时按包顺序幂等执行 ⇒ 不再手抄进 `db/schema.sql`。 +-- +-- 🔴 **【集成期友好性】列名按官方规范写**(见官方 +-- `jnpf-database/PostgreSQL/JNPF-PostgreSQL.sql` 的 `base_*` 表): +-- - `f_id VARCHAR(50)` —— 36 位 UUID(**不要限 32**); +-- - `f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL` —— **单租户也不许省**, +-- 官方 `base_*` 表全部带它,且参与复合主键 `(f_id, f_tenant_id)`; +-- - `f_delete_mark INTEGER DEFAULT 0` —— 软删标记。 +-- +-- 🔴 **列语义不许自创**:`f_name` / `f_category` / `f_scenario` / `f_provider` +-- / `f_format` / `f_scale` / `f_source` / `f_register_time` 取自公司本体 +-- `DataResource`(`数据资源`),**列名与列序逐字对齐本体** ⇒ 后续接本体平台 +-- 可直接映射,不用改表。 +-- +-- 🔴 **本文件只许建本包自己的表**,**不许建 `base_*`** —— 平台表的 DDL +-- 归 `db/schema.sql` 管(装载器会拦,见 `sspf-plugin` 的 `DdlTouchesBaseTable`)。 + +CREATE TABLE IF NOT EXISTS asset_data_resource ( + f_id VARCHAR(50) NOT NULL, + f_name VARCHAR(200), + f_category VARCHAR(50), + f_scenario VARCHAR(500), + f_provider VARCHAR(200), + f_format VARCHAR(50), + f_scale VARCHAR(50), + f_source VARCHAR(50), + f_register_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_creator_user_id VARCHAR(50), + f_creator_time TIMESTAMP(0) WITHOUT TIME ZONE, + f_delete_mark INTEGER DEFAULT 0, + f_tenant_id VARCHAR(50) DEFAULT '0' NOT NULL, + PRIMARY KEY (f_id, f_tenant_id) +); diff --git a/packs/asset/src/lib.rs b/packs/asset/src/lib.rs index 337aea0..f83e2fc 100644 --- a/packs/asset/src/lib.rs +++ b/packs/asset/src/lib.rs @@ -12,19 +12,51 @@ //! 格式 / 规模 / 来源 / 登记时间。**列名与列序逐字对齐本体** ⇒ 后续接本体平台 //! 可直接映射,不用改表。 //! -//! ## 与内核的接线(P3 才启用) +//! ## 与内核的接线 //! //! 内核侧只需一行: //! ```ignore -//! let packs: Vec> = vec![Box::new(sspf_pack_asset::AssetPack)]; +//! let packs: Vec> = vec![Box::new(sspf_pack_asset::Pack)]; //! ``` -//! 在此之前,内核仍用 `src/backend/src/modules/asset.rs`(同一份 spec 的另一份拷贝)。 -//! 🔴 **两份必须逐字一致** —— `check-arch.sh` 的 `PACK1` 会比对(P3 加)。 +//! +//! 🔴 **spec 的单一真源就是本文件**(批次 12 交付物 ②)—— +//! 内核的 `src/backend/src/modules/asset.rs` 只做 `pub use` 转发, +//! 不再保留第二份拷贝 ⇒ 改 spec 只改一处。 +//! +//! 🔴 **路由用官方 JNPF 形状**(`/api/{模块}/{资源}/…`)—— +//! **不是**面 A 的 `/api/ssw/{appCode}/{Entity}/{List|Save|Delete}` +//! (那是本仓自造的 ssw 约定 ⇒ 集成到官方 JNPF 时**全部作废**)。 +//! +//! 🔴 **DDL 跟着包走**(批次 12 交付物 ③)—— +//! `schema/001_init.sql` 用 `include_str!` **编译进二进制**, +//! 内核启动时按包顺序幂等执行 ⇒ 不再手抄进 `db/schema.sql`。 use sspf_sdk::{ - BusinessPack, ColumnSpec, EntitySpec, Manifest, MenuSpec, + BusinessPack, ColumnSpec, EntitySpec, HttpMethod, Manifest, MenuSpec, PackRoute, RouteAction, + RouteGuard, }; +/// 🔴 **本包自带的 DDL**(编译进二进制 ⇒ 包目录可整目录搬走)。 +/// +/// 🔴 **含 `f_tenant_id`** —— 官方 `base_*` 表全部带它(`DEFAULT '0' NOT NULL` +/// 且参与复合主键 `(f_id, f_tenant_id)`),**单租户也不许省** +/// (集成时缺这一列 ⇒ 导不进官方)。 +pub const DATA_RESOURCE_DDL: &str = include_str!("../schema/001_init.sql"); + +/// 🔴 **包的统一 DDL 出口**(`表名 → DDL 文本`)—— 内核**只认这一种写法**。 +/// +/// 🔴 **为什么要有它**(批次 12.5): +/// 内核要把「每个包的 DDL」交给装载器(`sspf_plugin::PackDdl`), +/// 而 `include_str!` 的结果是**常量名**(本包叫 `DATA_RESOURCE_DDL`)。 +/// 若每个包的常量名都不同,内核就必须**逐包手写**「哪个常量对应哪张表」 +/// ⇒ 加包要改内核,且漏写只会表现为「表没建」⇒ **运行期才炸**。 +/// ⇒ 约定本常量:**名字固定、形状固定** ⇒ 内核/生成器可以无脑遍历。 +/// +/// 🔴 **为什么是 `&[(&str, &str)]` 而不是 `&[PackDdl]`**: +/// `PackDdl.sql` 是 `String`(运行期构造)⇒ 常量数组装不下; +/// 这里用 `&'static str` 对,由 `sspf_plugin::load_static` 在装载时转成 `PackDdl`。 +pub const DDLS: &[(&str, &str)] = &[("asset_data_resource", DATA_RESOURCE_DDL)]; + /// `asset_data_resource` 的列清单(**顺序 = 响应 JSON 的键序**)。 const DATA_RESOURCE_COLUMNS: &[ColumnSpec] = &[ ColumnSpec { column: "f_id", json_key: "id", default: None, numeric: false }, @@ -39,6 +71,10 @@ const DATA_RESOURCE_COLUMNS: &[ColumnSpec] = &[ ColumnSpec { column: "f_creator_user_id", json_key: "creatorUserId", default: None, numeric: false }, ColumnSpec { column: "f_creator_time", json_key: "creatorTime", default: None, numeric: false }, ColumnSpec { column: "f_delete_mark", json_key: "deleteMark", default: Some("0"), numeric: false }, + // 🔴 **【集成期友好性】`f_tenant_id` 不许省** —— 官方 `base_*` 表全部带它 + // (`VARCHAR(50) DEFAULT '0' NOT NULL`,参与复合主键 `(f_id, f_tenant_id)`)。 + // 单租户也不许省 ⇒ 集成时缺这一列 ⇒ **导不进官方**。 + ColumnSpec { column: "f_tenant_id", json_key: "tenantId", default: Some("0"), numeric: false }, ]; /// `asset_data_resource` 的 spec。 @@ -83,10 +119,72 @@ const MANIFEST: Manifest = Manifest { migratable: true, }; -/// 数据资源业务包。 -pub struct AssetPack; +// ---------------------------------------------------------------- 路由声明 +// +// 🔴 **【集成期友好性】路径必须是官方 JNPF 形状** —— +// 官方是 **RESTful**:`GET/POST /api/{模块}/{资源}` + `PUT/DELETE /api/{模块}/{资源}/{id}`, +// **不是**面 A 的 `/api/ssw/{appCode}/{Entity}/…`,**也不是**第三种「官方前缀 + ssw 动作后缀」 +// (`/api/asset/DataResource/List|Save|Delete`)。 +// +// 🔴 **为什么不能是「官方前缀 + 动作后缀」**(2026-11-02 实测官方源码,证据在下面): +// 扫 `~/Desktop/workspace/jnpf/jnpf-java-boot` 的全部 controller: +// - `/xxx/List` 端点 **GET 52 条 + POST 21 条** ⇒ **这个形状存在**; +// - `/xxx/Save` 端点 **只有 4 条**(低代码 / 打印 / AI 的特例)⇒ **不是 CRUD 通用形状**; +// - `/xxx/Delete` 端点 **0 条** ⇒ **根本不存在**。 +// ⇒ 官方 CRUD 的通用形状是 `GET /api/{模块}/{资源}`(列表) +// + `POST /api/{模块}/{资源}`(新建) +// + `PUT /api/{模块}/{资源}/{id}`(改) +// + `DELETE /api/{模块}/{资源}/{id}`(删)。 +// ⇒ **本包的路径按这个来** ⇒ 集成时**路径零改**(这才是护栏 8 的目的)。 +// +// 🔴 **路由是「声明」,不是 handler** —— `PackRoute` 里没有 axum 类型 +// ⇒ 业务包**不需要**依赖 axum(AR2/AR8 钉死)。 +// 内核按声明 + spec 生成真正的 handler(`platform::crud::crud_router`)。 -impl BusinessPack for AssetPack { +/// `GET /api/asset/DataResource` —— 列表。 +pub const DATA_RESOURCE_LIST_ROUTE: PackRoute = PackRoute { + path: "/api/asset/DataResource", + method: HttpMethod::Get, + entity: "DataResource", + action: RouteAction::List, + // 🔴 **面 B 的判据 = 点权限(`f_en_code`)** —— 官方 `@SaCheckPermission` 的那套。 + // 面 A 的菜单路径(`f_url_address`)是**另一套**判据 ⇒ 两套并存,互不影响。 + guard: RouteGuard::EnCode("permission.asset.dataResource"), +}; + +/// `POST /api/asset/DataResource` —— 新建 / 更新(body 里带 `id` 就是更新)。 +pub const DATA_RESOURCE_SAVE_ROUTE: PackRoute = PackRoute { + path: "/api/asset/DataResource", + method: HttpMethod::Post, + entity: "DataResource", + action: RouteAction::Save, + guard: RouteGuard::EnCode("permission.asset.dataResource"), +}; + +/// `DELETE /api/asset/DataResource/{id}` —— 软删。 +pub const DATA_RESOURCE_DELETE_ROUTE: PackRoute = PackRoute { + path: "/api/asset/DataResource/{id}", + method: HttpMethod::Delete, + entity: "DataResource", + action: RouteAction::Delete, + guard: RouteGuard::EnCode("permission.asset.dataResource"), +}; + +/// 本包声明的全部路由。 +pub const DATA_RESOURCE_ROUTES: &[PackRoute] = &[ + DATA_RESOURCE_LIST_ROUTE, + DATA_RESOURCE_SAVE_ROUTE, + DATA_RESOURCE_DELETE_ROUTE, +]; + +/// 数据资源业务包。 +/// +/// 🔴 **类型名固定为 `Pack`**(批次 12.5)—— 内核的 `src/backend/src/packs_gen.rs` +/// 是**生成**的,生成器按 `sspf_pack_::Pack` 拼路径 +/// ⇒ 每个包都用同一个名字,加包才不用改内核。 +pub struct Pack; + +impl BusinessPack for Pack { fn manifest(&self) -> &'static Manifest { &MANIFEST } @@ -99,6 +197,11 @@ impl BusinessPack for AssetPack { &[DATA_RESOURCE_MENU] } + /// 🔴 **路由声明**(官方形状)—— 内核按它 + spec 生成 handler。 + fn routes(&self) -> &'static [PackRoute] { + DATA_RESOURCE_ROUTES + } + // metadata() 留空:本包是「手写 spec」形态,没有低代码元数据。 // P2 之后如果改用表单 JSON 驱动,在这里返回 `&["include_str!(...json)"]` 即可。 } @@ -163,8 +266,168 @@ mod tests { /// 包清单与 spec 的 app_code 必须一致(否则内核按 app 路由会找不到)。 #[test] fn manifest_app_code_matches_spec() { - assert_eq!(AssetPack.manifest().app_code, DATA_RESOURCE_SPEC.app_code); - assert_eq!(AssetPack.entities().len(), 1); - assert_eq!(AssetPack.menus().len(), 1); + assert_eq!(Pack.manifest().app_code, DATA_RESOURCE_SPEC.app_code); + assert_eq!(Pack.entities().len(), 1); + assert_eq!(Pack.menus().len(), 1); + assert_eq!(Pack.routes().len(), 3); + } + + /// 🔴 **【集成期友好性】路由必须是官方形状** —— 面 A 的 `/api/ssw/...` + /// 在集成到官方 JNPF 时**全部作废** ⇒ 这里钉死。 + #[test] + fn routes_use_official_shape_not_face_a() { + for r in Pack.routes() { + assert!( + r.path.starts_with("/api/"), + "路由必须以 /api/ 开头: {}", + r.path + ); + assert!( + !r.path.starts_with("/api/ssw/"), + "🔴 路由不许用面 A 的 /api/ssw/...(集成时作废): {}", + r.path + ); + } + } + + /// 🔴 **路由的 entity 必须指向本包声明的实体** —— 否则装配时拿到空 spec + /// ⇒ 路由注册了但永远查不到表 ⇒ **静默 404**。 + #[test] + fn routes_point_at_declared_entities() { + let entities = Pack.entities(); + for r in Pack.routes() { + assert!( + entities.iter().any(|e| e.entity == r.entity), + "路由 {} 指向未声明的实体 {}", + r.path, + r.entity + ); + } + } + + /// 🔴 **动作与方法的对应**被钉死(内核的 `crud_router` 按这个分派)。 + #[test] + fn route_actions_match_methods() { + for r in Pack.routes() { + match (r.action, r.method) { + (RouteAction::List, HttpMethod::Get) => {} + (RouteAction::Save, HttpMethod::Post) => {} + (RouteAction::Delete, HttpMethod::Delete) => {} + _ => panic!( + "动作 {:?} 与方法 {:?} 的组合不被支持: {}", + r.action, + r.method, + r.path + ), + } + } + } + + /// 🔴 **路径必须是官方 RESTful 形状**(2026-11-02 实测官方源码定下的): + /// - 列表 ⇒ `GET /api/{模块}/{资源}` + /// - 新建 ⇒ `POST /api/{模块}/{资源}` + /// - 删除 ⇒ `DELETE /api/{模块}/{资源}/{id}` + /// + /// 🔴 **为什么 `/Save` + `/Delete` 后缀不许出现**(护栏 8 的真正含义): + /// 实测官方 `jnpf-java-boot` 的全部 controller: + /// `/xxx/List` GET 52 + POST 21(碰巧存在)、`/xxx/Save` **仅 4 条** + /// (低代码/打印/AI 的特例)、`/xxx/Delete` **0 条**(根本不存在)。 + /// ⇒ 用 ssw 动作后缀 = 集成时**必然要改路径** ⇒ 现在就拦。 + #[test] + fn routes_use_official_restful_shape() { + for r in Pack.routes() { + assert!( + !r.path.ends_with("/Save"), + "🔴 官方没有 /Save 这种 CRUD 端点(仅低代码特例): {}", + r.path + ); + assert!( + !r.path.ends_with("/Delete"), + "🔴 官方根本没有 /Delete 端点(0 条): {}", + r.path + ); + } + // 删除必须带 `{id}`(官方 RESTful 的删除是 `DELETE /api/{模块}/{资源}/{id}`)。 + let del = Pack + .routes() + .iter() + .find(|r| r.action == RouteAction::Delete) + .expect("必须有删除路由"); + assert!( + del.path.contains("{id}"), + "删除路由必须带 {{id}} 路径参数: {}", + del.path + ); + } + + /// 🔴 **守卫必须与菜单的 `f_en_code` 一字不差** —— 不一致 ⇒ + /// 运行时查菜单查不到 ⇒ 走「未映射放行」⇒ **任何登录用户都能调** ⇒ 静默越权。 + #[test] + fn route_guards_match_menu_en_code() { + for r in Pack.routes() { + let RouteGuard::EnCode(code) = r.guard else { + panic!("本包的路由都该有点权限守卫: {}", r.path); + }; + assert_eq!( + code, DATA_RESOURCE_MENU.en_code, + "路由 {} 的守卫与菜单的 f_en_code 不一致", + r.path + ); + } + } + + /// 🔴 **DDL 必须含 `f_tenant_id`**(官方 `base_*` 全部带它, + /// 参与复合主键 `(f_id, f_tenant_id)`)—— 集成时缺这列 ⇒ **导不进官方**。 + #[test] + fn ddl_carries_tenant_id() { + assert!(DATA_RESOURCE_DDL.contains("f_tenant_id"), "DDL 必须含 f_tenant_id"); + assert!( + DATA_RESOURCE_DDL.contains("PRIMARY KEY (f_id, f_tenant_id)"), + "复合主键必须是 (f_id, f_tenant_id)" + ); + } + + /// 🔴 **DDL 与 spec 的列必须一致** —— spec 少一列 ⇒ CRUD 投影会漏字段。 + #[test] + fn ddl_columns_match_spec_columns() { + for col in DATA_RESOURCE_SPEC.columns { + assert!( + DATA_RESOURCE_DDL.contains(col.column), + "DDL 缺列 {}(spec 里有,DDL 里没有)", + col.column + ); + } + } + + /// 🔴 **`DDLS` 的每一对都必须是「表名 → 真的建这张表的 SQL」**。 + /// + /// 🔴 写错表名的后果分两级: + /// - 与 `pack.toml` 的 `[[pack.tables]].name` 不一致 ⇒ 装载期报 + /// `DdlWithoutEntity`(响亮); + /// - 但 DDL **文本里**建的是另一张表 ⇒ 装载器不查这个 ⇒ 启动时建出来的表 + /// 与 spec 对不上 ⇒ **业务查询运行期才炸**(`relation does not exist`)。 + /// ⇒ 在包自己这一层就钉死,别指望上层。 + #[test] + fn ddls_pairs_name_the_table_they_create() { + assert!(!DDLS.is_empty(), "本包有实体 ⇒ DDLS 不能为空"); + for (table, sql) in DDLS { + assert!( + sql.contains(&format!("CREATE TABLE IF NOT EXISTS {table}")), + "DDLS 里 {table} 的 DDL 没有建这张表(表名与 SQL 不一致)" + ); + } + } + + /// 🔴 **`DDLS` 覆盖本包全部实体** —— 漏一张 ⇒ 那张表根本没建。 + #[test] + fn ddls_covers_every_entity_table() { + for spec in Pack.entities() { + assert!( + DDLS.iter().any(|(t, _)| *t == spec.table), + "实体 {} 的表 {} 不在 DDLS 里 ⇒ 不会建表", + spec.entity, + spec.table + ); + } } } diff --git a/scripts/check-arch.sh b/scripts/check-arch.sh index eb405a9..3bab1a6 100755 --- a/scripts/check-arch.sh +++ b/scripts/check-arch.sh @@ -40,6 +40,7 @@ set -u ROOT="$(cd "$(dirname "$0")/.." && pwd)" CRATES="$ROOT/crates" KERNEL="$ROOT/src/backend" +MODULES_DIR="$KERNEL/src/modules" PASS=0 FAIL=0 @@ -174,6 +175,89 @@ check_ar7() { fi } +# ---------------------------------------------------------------- AR8 +# 业务包装载器(`crates/sspf-plugin`)的依赖白名单。 +# +# 🔴 **为什么单列一条**:装载器是「业务包 ⇄ 内核」的唯一中介。 +# 它一旦依赖 axum / tokio / pglite,业务包就**间接背上 web 框架**(AR2 的精神废掉), +# 而且「包可整目录搬走」这个承诺再也证不了。 +# 装载器只做「读清单 + 校验兼容区间 + 收集 entities/menus/routes」⇒ 纯数据。 +check_ar8() { + local f="$CRATES/sspf-plugin/Cargo.toml" + [ -f "$f" ] || { skip "AR8 sspf-plugin 不存在(批次 12 才落地)"; return; } + local deps; deps="$(deps_of "$f" | tr '\n' ' ')" + if subset_of "$deps" "sspf-sdk sspf-contract serde serde_json"; then + ok "AR8 sspf-plugin 依赖干净([$deps])" + else + bad "AR8 sspf-plugin 依赖越界:[$deps] —— 只允许 sspf-sdk/sspf-contract/serde/serde_json(不许 axum/tokio/pglite)" + fi +} + +# ---------------------------------------------------------------- AR9 +# **平台层不许认识任何业务包**(业务知识隔离,红线 12)。 +# +# 🔴 方向是「内核 ⇒ 包」,**不是**「包 ⇒ 内核」:`src/backend/Cargo.toml` 依赖 +# `sspf-pack-` 是**允许**的(装配根要装载它们); +# 但 `src/backend/src/platform/**` 里出现 `use sspf_pack_*` ⇒ 平台层知道了 +# 具体业务 ⇒ 加/删业务包就要改平台层 ⇒ 「链接就好」这个承诺是假的。 +check_ar9() { + local dir="$KERNEL/src/platform" + [ -d "$dir" ] || { skip "AR9 平台层目录不存在"; return; } + local hits + hits="$(grep -rnE '^[[:space:]]*(pub )?use[[:space:]]+sspf_pack_' "$dir" 2>/dev/null || true)" + if [ -z "$hits" ]; then + ok "AR9 平台层没有 use sspf_pack_*(业务知识没漏进 platform/)" + else + bad "AR9 平台层出现了业务包引用(业务知识漏进 platform/ ⇒ 加包要改平台层):" + printf '%s\n' "$hits" | sed 's/^/ /' + fi +} + +# ---------------------------------------------------------------- PACK1 +# **spec 单一真源**:`modules/.rs` 只许做转发,不许自己写 spec。 +# +# 🔴 背景:批次 12 之前 `modules/asset.rs` 与 `packs/asset/src/lib.rs` 是 +# **两份逐字拷贝** ⇒ 改一处忘另一处 ⇒ **静默**不一致,且当时没有任何闸门比对。 +# 现在 spec 的真源在包里,模块文件只 `pub use` 转发。 +# ⇒ 本闸门要防的是「有人又在模块文件里写了一份」—— +# 那等于回到两份拷贝,而且**看起来一切正常**(编译过、测试过)。 +# +# 判据(对每个「模块文件里有 `pub use sspf_pack_`」的模块): +# · 模块文件里**不许**出现 `: EntitySpec =` / `: MenuSpec =` 的定义 +# (`pub use` 转发不算定义 —— 它没有 `=` 字面量); +# · 与它同 app_code 的包**必须存在**且**确实声明了** EntitySpec(否则转发了个空)。 +check_pack1() { + local n=0 + for mf in "$MODULES_DIR"/*.rs; do + [ -f "$mf" ] || continue + case "$(basename "$mf")" in mod.rs) continue ;; esac + grep -q "pub use sspf_pack_" "$mf" 2>/dev/null || continue + n=$((n + 1)) + local name; name="$(basename "$mf" .rs)" + # ① 模块文件里不许有 spec / menu 的**定义**(`= EntitySpec {` / `= MenuSpec {`) + local defs + defs="$(grep -nE '=[[:space:]]*(EntitySpec|MenuSpec)[[:space:]]*\{' "$mf" 2>/dev/null || true)" + if [ -n "$defs" ]; then + bad "PACK1 ${name}.rs 既 re-export 又**自己定义**了 spec(两份拷贝回来了):" + printf '%s\n' "$defs" | sed 's/^/ /' + continue + fi + # ② 包必须存在,且真的声明了 EntitySpec + local lib="$ROOT/packs/$name/src/lib.rs" + if [ ! -f "$lib" ]; then + bad "PACK1 ${name}.rs 从 sspf_pack_${name} 转发,但 packs/${name}/src/lib.rs 不存在" + continue + fi + if ! grep -qE ':[[:space:]]*EntitySpec[[:space:]]*=' "$lib" 2>/dev/null; then + bad "PACK1 packs/${name}/src/lib.rs 没有 EntitySpec 声明(模块转发了个空)" + continue + fi + ok "PACK1 ${name}.rs 只做 re-export,spec 真源在 packs/${name}/src/lib.rs" + done + [ "$n" -eq 0 ] && skip "PACK1 尚无「模块转发业务包」的模块" + return 0 +} + # ---------------------------------------------------------------- MEM1 # 只看**代码行**:去掉 `//` 之后的注释、`//!` / `///` 文档注释、以及字符串里的反引号示例。 check_mem1() { @@ -258,9 +342,11 @@ PY } # ---------------------------------------------------------------- 反自证 -# 🔴 永远返回「干净」的尺子 = 没有尺子。造一个明知违规的临时 pack,必须被抓到。 +# 🔴 永远返回「干净」的尺子 = 没有尺子。造明知违规的输入,必须被抓到。 self_test() { - echo "── 反自证:造一个依赖越界的假 pack,AR2 必须报 ❌ ──" + local rc=0 + + echo "── 反自证 1/4:造一个依赖越界的假 pack,AR2 必须报 ❌ ──" local tmp="$ROOT/packs/__arch_selftest__" mkdir -p "$tmp" cat > "$tmp/Cargo.toml" <<'TOML' @@ -278,14 +364,86 @@ TOML local caught=0 [ "$FAIL" -gt "$before" ] && caught=1 rm -rf "$tmp" - # 恢复计数(自证不算进正式统计) FAIL=$before if [ "$caught" -eq 1 ]; then echo "✅ 反自证通过:AR2 抓到了 axum 依赖" - return 0 + else + echo "❌ 反自证失败:AR2 没抓到明显违规 ⇒ 这把尺子是假的" + rc=1 fi - echo "❌ 反自证失败:AR2 没抓到明显违规 ⇒ 这把尺子是假的" - return 1 + + echo "── 反自证 2/4:往平台层塞一个 use sspf_pack_*,AR9 必须报 ❌ ──" + # + # 🔴 **为什么必须自证 AR9**:它的判据是 `grep platform/`。 + # 目录名写错 / 路径拼错 ⇒ `grep` 永远返回空 ⇒ **永远"通过"**。 + # 这类尺子比没有更危险(它给出虚假的安全感)。 + local probe="$KERNEL/src/platform/__ar9_selftest.rs" + if [ -d "$KERNEL/src/platform" ]; then + printf 'use sspf_pack_asset::DATA_RESOURCE_SPEC;\n' > "$probe" + before=$FAIL + check_ar9 >/dev/null 2>&1 + caught=0 + [ "$FAIL" -gt "$before" ] && caught=1 + rm -f "$probe" + FAIL=$before + if [ "$caught" -eq 1 ]; then + echo "✅ 反自证通过:AR9 抓到了平台层里的 use sspf_pack_*" + else + echo "❌ 反自证失败:AR9 没抓到平台层里的业务包引用 ⇒ 尺子是假的" + rc=1 + fi + else + echo "⏭ 跳过 AR9 反自证(平台层目录不存在)" + fi + + echo "── 反自证 3/4:往 re-export 的模块里塞一份 spec,PACK1 必须报 ❌ ──" + # + # 🔴 造在**临时模块文件**上(不动真文件):只要它同时有 `pub use sspf_pack_` + # 和 `= EntitySpec {`,PACK1 就必须红。 + local mprobe="$MODULES_DIR/__pack1_selftest.rs" + if [ -d "$MODULES_DIR" ]; then + cat > "$mprobe" <<'RS' +pub use sspf_pack_asset::DATA_RESOURCE_SPEC; +pub const DUP_SPEC: EntitySpec = EntitySpec { entity: "Dup", table: "dup", .. }; +RS + before=$FAIL + check_pack1 >/dev/null 2>&1 + caught=0 + [ "$FAIL" -gt "$before" ] && caught=1 + rm -f "$mprobe" + FAIL=$before + if [ "$caught" -eq 1 ]; then + echo "✅ 反自证通过:PACK1 抓到了「既 re-export 又自己定义 spec」" + else + echo "❌ 反自证失败:PACK1 没抓到两份拷贝 ⇒ 尺子是假的" + rc=1 + fi + else + echo "⏭ 跳过 PACK1 反自证(业务模块目录不存在)" + fi + + echo "── 反自证 4/4:往 sspf-plugin 塞 axum 依赖,AR8 必须报 ❌ ──" + local pfile="$CRATES/sspf-plugin/Cargo.toml" + if [ -f "$pfile" ]; then + cp "$pfile" "$pfile.bak" + printf 'axum = "0.8"\n' >> "$pfile" + before=$FAIL + check_ar8 >/dev/null 2>&1 + caught=0 + [ "$FAIL" -gt "$before" ] && caught=1 + mv "$pfile.bak" "$pfile" + FAIL=$before + if [ "$caught" -eq 1 ]; then + echo "✅ 反自证通过:AR8 抓到了装载器里的 axum 依赖" + else + echo "❌ 反自证失败:AR8 没抓到装载器里的 axum ⇒ 尺子是假的" + rc=1 + fi + else + echo "⏭ 跳过 AR8 反自证(sspf-plugin 不存在)" + fi + + return $rc } # ---------------------------------------------------------------- main @@ -299,6 +457,9 @@ check_ar4 check_ar5 check_ar6 check_ar7 +check_ar8 +check_ar9 +check_pack1 check_mem1 check_mem2 diff --git a/scripts/check-boundary-scan.py b/scripts/check-boundary-scan.py index bd954db..aaa1e7c 100644 --- a/scripts/check-boundary-scan.py +++ b/scripts/check-boundary-scan.py @@ -111,10 +111,17 @@ def literals_with_lines(path): return out -def business_tokens(modules_dir): +def business_tokens(modules_dir, packs_dir=None): """从业务层派生「平台层不许出现」的标识符清单。 ⇒ [(种类, token)],种类用于报错时点名「漏的是哪一类」。 + + 🔴 **业务层现在有两处**(批次 12 交付物 ②「spec 单一真源」): + - `src/backend/src/modules/*.rs` —— **面 A** 的内嵌业务模块 + (demo / shop / books); + - `packs/*/src/lib.rs` —— **业务包**(asset 等)。 + 两处都要扫 ⇒ 否则包里的业务表名 / 实体名会从「禁止清单」里消失 + ⇒ 平台层就可以写 `asset_data_resource` 而不被抓 ⇒ **尺子变弱**。 """ tokens = [] seen = set() @@ -128,10 +135,20 @@ def business_tokens(modules_dir): seen.add(key) tokens.append((kind, value)) + sources = [] for name in sorted(os.listdir(modules_dir)): if not name.endswith(".rs") or name == "mod.rs": continue - path = os.path.join(modules_dir, name) + sources.append(os.path.join(modules_dir, name)) + + # 🔴 **业务包**:包目录里的 `src/lib.rs` 是包声明的所在地。 + if packs_dir and os.path.isdir(packs_dir): + for pkg in sorted(os.listdir(packs_dir)): + lib = os.path.join(packs_dir, pkg, "src", "lib.rs") + if os.path.isfile(lib): + sources.append(lib) + + for path in sources: with open(path, "r", encoding="utf-8") as fh: src = "\n".join(strip_comments(fh.read())) for m in SPEC_TABLE_RE.finditer(src): @@ -171,7 +188,9 @@ def main(argv): modules_dir = argv[1] scan_dirs = argv[2:] - tokens = business_tokens(modules_dir) + # 🔴 业务包目录(可省略 ⇒ 兼容旧调用;`check-boundary.sh` 会传)。 + packs_dir = os.environ.get("SSW_PACKS_DIR") or None + tokens = business_tokens(modules_dir, packs_dir) if not tokens: sys.stderr.write("业务层没解析出任何标识符(modules_dir 有问题?)\n") return 2 diff --git a/scripts/check-boundary.sh b/scripts/check-boundary.sh index 416e305..b9bfd10 100755 --- a/scripts/check-boundary.sh +++ b/scripts/check-boundary.sh @@ -107,7 +107,10 @@ fi # ---- CP1 平台层零业务标识符 ---- hdr "[CP1] 平台层零业务标识符(扫字符串字面量;禁止清单从业务层派生)" -SCAN_OUT="$("${PY_BIN}" "${SCAN}" "${MODULES}" "${PLATFORM}" "${SRC}/routes.rs" "${SRC}/main.rs" "${BOOTSTRAP}" 2>&1)" +# 🔴 **业务层现在有两处**(批次 12 交付物 ②):`modules/*.rs`(面 A 内嵌) +# + `packs/*/src/lib.rs`(业务包)⇒ 两处都要进「禁止清单」, +# 否则包里的业务表名会从清单里消失 ⇒ 尺子变弱。 +SCAN_OUT="$(SSW_PACKS_DIR="${ROOT}/packs" "${PY_BIN}" "${SCAN}" "${MODULES}" "${PLATFORM}" "${SRC}/routes.rs" "${SRC}/main.rs" "${BOOTSTRAP}" 2>&1)" if [ "$?" -eq 0 ]; then ok "平台层没有业务标识符($(printf '%s\n' "${SCAN_OUT}" | tail -1))" else @@ -136,7 +139,7 @@ else fi # ---- CP4 每个业务模块声明自己的菜单 + 被 ALL_MENUS 收编 ---- -hdr "[CP4] 每个业务模块声明自己的菜单(*_MENU: MenuSpec)并被 ALL_MENUS 收编" +hdr "[CP4] 每个业务模块声明自己的菜单(*_MENU: MenuSpec 或从业务包 re-export)并被 ALL_MENUS 收编" MENU_FILES=0 MENU_MISSING="" MENU_UNREGISTERED="" @@ -145,20 +148,34 @@ for f in "${MODULES}"/*.rs; do base="$(basename "$f")" [ "${base}" = "mod.rs" ] && continue MENU_FILES=$((MENU_FILES+1)) - consts="$(grep -o "^pub const [A-Z_]*_MENU: MenuSpec" "$f" 2>/dev/null | sed 's/^pub const //; s/: MenuSpec$//')" - if [ -z "${consts}" ]; then + # 🔴 **两种形态都算数**(批次 12 交付物 ②「spec 单一真源」): + # ① 自己声明:`pub const XXX_MENU: MenuSpec = …` + # ② 从业务包转发:`pub use sspf_pack_xxx::XXX_MENU;` + # ⇒ 业务包的菜单住在包里(真源),内核只转发 ⇒ 不产生第二份拷贝。 + consts="$(grep -oE "^pub const [A-Z_]*_MENU: MenuSpec" "$f" 2>/dev/null | sed 's/^pub const //; s/: MenuSpec$//')" + reexports="$(grep -oE "^pub use [a-z0-9_]+::[A-Z_]*_MENU;" "$f" 2>/dev/null | sed 's/^pub use [a-z0-9_]*:://; s/;$//')" + all_consts="$(printf '%s\n%s\n' "${consts}" "${reexports}" | grep -v '^$' | tr '\n' ' ')" + if [ -z "${all_consts}" ]; then MENU_MISSING="${MENU_MISSING} ${base}" continue fi - for c in ${consts}; do + for c in ${all_consts}; do if ! grep -q "${c}," "${MODULES_MOD}" 2>/dev/null; then MENU_UNREGISTERED="${MENU_UNREGISTERED} ${c}(${base})" fi done # 🔴 声明的菜单 id 必须与**契约** `[MODULE].menuId` 一致(该模块的菜单是哪一条, # 是契约说了算,不是代码自己说了算)。 + # 🔴 菜单 id 在**包里**(re-export 形态)⇒ 从 `packs//src/lib.rs` 取。 C_MENU_ID="$(printf '%s\n' "${CE_MOD_ROWS}" | awk -F'\t' -v f="${base}" 'NR>1 && $8==f { print $6; exit }')" - D_MENU_ID="$(awk '/^[ \t]*id:[ \t]*"/ { s = $0; sub(/^[ \t]*id:[ \t]*"/, "", s); sub(/".*/, "", s); print s; exit }' "$f")" + if [ -n "${reexports}" ]; then + # 从业务包取菜单 id(包目录名 = app_code = 模块文件名去掉 .rs) + pack_app="${base%.rs}" + pack_lib="${ROOT}/packs/${pack_app}/src/lib.rs" + D_MENU_ID="$(awk '/^[ \t]*id:[ \t]*"/ { s = $0; sub(/^[ \t]*id:[ \t]*"/, "", s); sub(/".*/, "", s); print s; exit }' "${pack_lib}" 2>/dev/null)" + else + D_MENU_ID="$(awk '/^[ \t]*id:[ \t]*"/ { s = $0; sub(/^[ \t]*id:[ \t]*"/, "", s); sub(/".*/, "", s); print s; exit }' "$f")" + fi if [ -z "${C_MENU_ID}" ]; then MENU_MISMATCH="${MENU_MISMATCH} ${base}(契约 [MODULE] 里没有它)" elif [ "${C_MENU_ID}" != "${D_MENU_ID}" ]; then @@ -166,9 +183,9 @@ for f in "${MODULES}"/*.rs; do fi done if [ -n "${MENU_MISSING}" ]; then - no "这些业务模块没声明菜单(缺 *_MENU: MenuSpec):${MENU_MISSING}" + no "这些业务模块没声明菜单(缺 *_MENU: MenuSpec,也没有从业务包 re-export):${MENU_MISSING}" else - ok "${MENU_FILES} 个业务模块都声明了 *_MENU: MenuSpec" + ok "${MENU_FILES} 个业务模块都声明了菜单(自带 *_MENU 或从业务包 re-export)" fi if [ -n "${MENU_UNREGISTERED}" ]; then no "这些菜单没被 modules/mod.rs 的 ALL_MENUS 收编(菜单不会被种、admin 少一条授权):${MENU_UNREGISTERED}" @@ -181,18 +198,18 @@ else ok "业务模块声明的菜单 id 与契约 [MODULE] 逐条一致" fi -# 🔴 **数量对账**:业务模块文件里的 *_MENU 个数 == ALL_MENUS 里的条目数。 +# 🔴 **数量对账**:业务模块文件里的菜单数 == ALL_MENUS 里的条目数。 ALL_MENUS_COUNT="$(awk ' /pub const ALL_MENUS: &\[MenuSpec\] = &\[/ { inb = 1; next } inb && /^\];/ { inb = 0; next } inb && /_MENU,/ { n++ } END { print n + 0 } ' "${MODULES_MOD}")" -DECLARED_COUNT="$(grep -h -c "^pub const [A-Z_]*_MENU: MenuSpec" "${MODULES}"/*.rs 2>/dev/null | awk '{ s += $1 } END { print s + 0 }')" +DECLARED_COUNT="$(grep -h -cE "^pub const [A-Z_]*_MENU: MenuSpec|^pub use [a-z0-9_]+::[A-Z_]*_MENU;" "${MODULES}"/*.rs 2>/dev/null | awk '{ s += $1 } END { print s + 0 }')" if [ "${ALL_MENUS_COUNT}" = "${DECLARED_COUNT}" ]; then - ok "ALL_MENUS 条目数 = 各模块声明的 *_MENU 个数(${ALL_MENUS_COUNT})" + ok "ALL_MENUS 条目数 = 各模块声明的菜单个数(${ALL_MENUS_COUNT})" else - no "ALL_MENUS 有 ${ALL_MENUS_COUNT} 条,各模块声明了 ${DECLARED_COUNT} 个 *_MENU ⇒ 对不上" + no "ALL_MENUS 有 ${ALL_MENUS_COUNT} 条,各模块声明了 ${DECLARED_COUNT} 个菜单 ⇒ 对不上" fi # ---- CP5 ensure_base 的调用点只有装配根 ---- diff --git a/scripts/check-citations-scan.py b/scripts/check-citations-scan.py index 5125ee8..318102e 100644 --- a/scripts/check-citations-scan.py +++ b/scripts/check-citations-scan.py @@ -249,6 +249,35 @@ def extract_citations(doc_paths): return cites, orphans, mentions_by_doc +_LOOKUP_CACHE = {} + + +def _lookups(indexes): + """把 `{根: {相对路径: 绝对路径}}` 展开成两张倒排表(按后缀 / 按基名)。 + + 🔴 **为什么需要这张表**(实测数据):原来的 `resolve` 对**每条引文**都要遍历 + 该根下的**全部文件**做 `rel.endswith("/" + 路径)`。本仓 551 条引文 × + 两千多个文件 ⇒ 实测 **1008 万次** `endswith`(1.7s,占本闸门四成)。 + ⇒ 建一次倒排表(每条路径按层级切出若干后缀),查询变成 O(1) 查表。 + + 缓存键用 `id(indexes)`,但**同时把 indexes 本体存进缓存值** ⇒ 只要缓存项还活着, + 那个 id 就不可能被别的对象复用 ⇒ 不会脏读(同 `find_fn_body` 的做法)。 + """ + key = id(indexes) + hit = _LOOKUP_CACHE.get(key) + if hit is not None and hit[0] is indexes: + return hit[1], hit[2] + suffix_map, base_map = {}, {} + for name, files in indexes.items(): + for rel, ap in files.items(): + base_map.setdefault((name, os.path.basename(rel)), []).append((rel, ap)) + parts = rel.split("/") + for i in range(len(parts)): + suffix_map.setdefault((name, "/" + "/".join(parts[i:])), []).append((rel, ap)) + _LOOKUP_CACHE[key] = (indexes, suffix_map, base_map) + return suffix_map, base_map + + def resolve(cite_path, roots, indexes): """把引文里的路径解析成候选文件列表 [(root名, 绝对路径), …]。 @@ -272,19 +301,18 @@ def resolve(cite_path, roots, indexes): if cands: return cands, "exact" + suffix_map, base_map = _lookups(indexes) suffix = "/" + cite_path - for name, base in roots.items(): - for rel, ap in indexes.get(name, {}).items(): - if rel.endswith(suffix): - cands.append((name, ap)) + for name in roots: + for rel, ap in suffix_map.get((name, suffix), ()): + cands.append((name, ap)) if cands: return cands, "suffix" if "/" not in cite_path: - for name, base in roots.items(): - for rel, ap in indexes.get(name, {}).items(): - if os.path.basename(rel) == cite_path: - cands.append((name, ap)) + for name in roots: + for rel, ap in base_map.get((name, cite_path), ()): + cands.append((name, ap)) if cands: return cands, "basename" return [], "none" diff --git a/scripts/check-contract-scan.py b/scripts/check-contract-scan.py index 4311e59..5029561 100644 --- a/scripts/check-contract-scan.py +++ b/scripts/check-contract-scan.py @@ -48,6 +48,13 @@ HANDLER_RE = re.compile(r'\s*(?:([A-Za-z_][A-Za-z0-9_]*)::)?([A-Za-z_][A-Za-z0-9 PARAM_RE = re.compile(r'\{[A-Za-z_][A-Za-z0-9_]*\}') # 测试用的固定路径前缀(**不在契约端点表里** ⇒ 全部扫描都排除) TEST_PATH_PREFIX = "/api/__test__/" +# 🔴 业务包的路由声明(批次 12 交付物 ①):`PackRoute { … }` —— 纯数据,不认识 axum。 +# 注意:`mask_rust` 会把字符串字面量挖空 ⇒ 只能**在 masked 里定位结构**, +# 再用同一偏移去原文取值。 +PACK_ROUTE_RE = re.compile(r'PackRoute\s*\{') +# 🔴 一次扫全文的「函数定义」正则(见 `_fn_positions`): +# 每份文件只跑一遍就能拿到**所有** `fn 名字(` 的位置,避免「查一个函数扫一遍全文」。 +FN_DEF_RE = re.compile(r'\bfn\s+([A-Za-z_][A-Za-z0-9_]*)\s*\(') def mask_rust(text): @@ -143,11 +150,62 @@ def brace_span(masked, start): def find_fn_body(masked, fname): - """找 `fn (` 的函数体区间 ⇒ 返回 (start, end) 或 None。""" - m = re.search(r"\bfn\s+" + re.escape(fname) + r"\s*\(", masked) - if not m: + """找 `fn (` 的函数体区间 ⇒ 返回 (start, end) 或 None。 + + 🔴 **带缓存**:反自证要跑 13 次 `analyze`,每次都把**同一批文件**重新 + `re.search` 一遍(实测 `re.search` 占单次分析 3.0s / 4.7s)。 + 缓存键用 `id(masked)`,但**同时把 masked 本体存进缓存值** ⇒ + 只要缓存项还活着,那个 id 就不可能被别的对象复用 ⇒ **不会脏读**。 + """ + key = id(masked) + entry = _FN_CACHE.get(key) + if entry is None or entry[0] is not masked: + entry = (masked, {}) + _FN_CACHE[key] = entry + table = entry[1] + # 🔴 必须区分「没查过」与「查过但没有」—— 用哨兵,不能用 `dict.get` 的 None + # (同一个文件要查很多个函数名,`get` 会把「没查到」当成「没查过」⇒ 反复重查)。 + if fname in table: + return table[fname] + span = _find_fn_body_uncached(masked, fname) + table[fname] = span + return span + + +_FN_CACHE = {} +_FN_POS_CACHE = {} + + +def _fn_positions(masked): + """一次性扫出文件里所有 `fn <名字>(` 的位置 ⇒ `{名字: 左括号之后的位置}`。 + + 🔴 **为什么需要这张表**(实测数据):原来的 `_find_fn_body_uncached` 每查 + 一个函数名就在**整份文件**上跑一次 `re.search`。同一个文件常被查十几次 + (routes.rs 里几十个 handler 都在里面)⇒ 同一份文件被完整正则扫十几遍。 + 实测 362 次查找里 `re.search` 累计 1.4s,占单次分析的大头。 + ⇒ 改成「每份文件只扫一遍」把位置全部拿到,查表 O(1)。 + +  🔴 同名函数(不同 `impl` 块里各有一份)取**第一个**,与原 + `re.search(...)` 的语义一致(`re.search` 也是返回第一个匹配)。 + """ + key = id(masked) + entry = _FN_POS_CACHE.get(key) + if entry is not None and entry[0] is masked: + return entry[1] + pos = {} + for m in FN_DEF_RE.finditer(masked): + name = m.group(1) + if name not in pos: + pos[name] = m.end() + _FN_POS_CACHE[key] = (masked, pos) + return pos + + +def _find_fn_body_uncached(masked, fname): + q = _fn_positions(masked).get(fname) + if q is None: return None - i = masked.find("{", m.end()) + i = masked.find("{", q) if i < 0: return None return brace_span(masked, i) @@ -201,15 +259,36 @@ def scan_routes(path, owner): "fn": fn, "closure": closure, "owner": owner, + # 🔴 `source` 区分「路由住在哪」:平台层 / 业务模块(面 A)/ 业务包(面 B)。 + # owner 会撞(包与模块同 app_code)⇒ 守卫推导与台账范围**必须**看这个。 + "source": "platform" if owner == "platform" else "module", + "const": None, "file": path, }) return out, orig, masked def resolve_const(orig, masked, name): - """`const NAME: &str = "value";` ⇒ value(取原文里的字面量)。""" + """`const NAME: &str = "value";` ⇒ value(取原文里的字面量)。 + + 🔴 **带缓存**(同 [`find_fn_body`] 的理由):本函数在**整份文件**上跑正则, + 362 条平台端点的守卫推导会反复查同一批常量名。 + """ + key = id(orig) + entry = _CONST_CACHE.get(key) + if entry is None or entry[0] is not orig: + entry = (orig, {}) + _CONST_CACHE[key] = entry + table = entry[1] + if name in table: + return table[name] m = re.search(r"\bconst\s+" + re.escape(name) + r"\b[^=]*=\s*\"([^\"]*)\"", orig) - return m.group(1) if m else None + value = m.group(1) if m else None + table[name] = value + return value + + +_CONST_CACHE = {} def guard_of_platform(plat_files, mod, fn): @@ -281,6 +360,12 @@ def guard_of_module(orig, masked): 🔴 在 **masked** 里定位 `module_key:`(注释里的假 mention 被挖空了), 再用**同一偏移**去原文取真值(字面量在 masked 里是空格)。 + + 🔴 **spec 搬进包之后本函数会推不出**(批次 12 交付物 ②): + `modules/asset.rs` 现在只做 `pub use sspf_pack_asset::DATA_RESOURCE_SPEC;` + ⇒ 文件里**没有 `module_key` 字面量** ⇒ 返回 None ⇒ CC6 只能报「推不出」。 + ⇒ 这不是「推不出」,是**真源搬走了** ⇒ 必须回落到包里的 spec。 + 见 [`guard_of_module_with_pack_fallback`]。 """ for m in re.finditer(r"module_key:", masked): tail = orig[m.end():m.end() + 60] @@ -292,6 +377,289 @@ def guard_of_module(orig, masked): return None +def guard_of_module_with_pack_fallback(orig, masked, app, pack_orig, pack_masked): + """面 A 的守卫:先看模块文件;**模块只是 re-export 时回落同 app 的包里的 spec**。 + + 🔴 **为什么要回落**(而不是让 CC6 报「推不出」): + 「推不出」是给**真的静态分析不了**的情况留的(比如 handler 里做了动态判断)。 + 而 asset 的 `module_key` 是**确定存在**的 —— 只是住在包里。 + 把它报成「推不出」⇒ 面 A 的守卫**从此不再被检查**(静默失效)⇒ + 正是本仓最怕的那类退化:尺子还在跑,但已经瞎了。 + + 🔴 **必须按 `app` 精确匹配,不能取「排序后第一个包」**(2026-11-01 修的真 bug): + 只有一个包时「第一个」碰巧等于「同 app 的」⇒ 看起来对; + 加第二个包(`probe`)后,`sorted()` 仍从 `asset` 开始 ⇒ + **probe 的面 A 守卫被推成 `asset/DataResource`** ⇒ CC6 报「守卫漂移」, + 而契约其实是**对的** ⇒ 假飘移 3 条 ⇒ 人会去改对的契约。 + ⇒ 用 `app` 查对应的包;查不到就老老实实返回 `None`(= 推不出,人工核对)。 + """ + key = guard_of_module(orig, masked) + if key is not None: + return key + if app not in pack_orig: + return None + specs = scan_entities(pack_orig[app], pack_masked[app]) + if not specs: + return None + return specs[0]["module_key"] if specs[0]["module_key"] else "登录" + + +def scan_pack_routes(path, owner): + """扫业务包里的 `PackRoute` 声明 ⇒ [{path, method, entity, …}]。 + + 🔴 **形状与 `.route()` 完全不同**(批次 12 交付物 ①): + 业务包**不认识 axum** ⇒ 路由是**纯数据声明**: + + pub const DATA_RESOURCE_LIST_ROUTE: PackRoute = PackRoute { + path: "/api/asset/DataResource/List", + method: HttpMethod::Get, + entity: "DataResource", + action: RouteAction::List, + }; + + ⇒ 扫描器要认得 `PackRoute { … }` 这个形状 ⇒ 把路径 / 方法 / 实体抽出来。 + + ⇒ 返回的条目与 `.route()` 扫出来的**同构** ⇒ 下游的 CC2–CC10 + 一行都不用改(这是「同构」的价值)。 + """ + orig = read(path) + masked = mask_rust(orig) + out = [] + for m in PACK_ROUTE_RE.finditer(masked): + body = orig[m.start():m.start() + 800] + pm = re.search(r'path:\s*"([^"]+)"', body) + mm = re.search(r"method:\s*HttpMethod::(\w+)", body) + em = re.search(r'entity:\s*"([^"]+)"', body) + am = re.search(r"action:\s*RouteAction::(\w+)", body) + if not (pm and mm and em): + continue + out.append({ + "path": pm.group(1), + "method": mm.group(1).upper(), + "mod": None, + "fn": None, + "closure": False, + "owner": owner, + # 🔴 **来源标记**:`pack` / `module` / `platform` —— + # CC6 的守卫推导与 CC10 的台账范围**必须**按来源分派: + # - 包路由是**面 B**(点权限),模块路由是**面 A**(菜单路径)⇒ + # 两者**同 app_code 同 owner**(都叫 `asset`)⇒ 只看 owner 会串线。 + "source": "pack", + # 常量名(CC8 核对「声明了但没进 *_ROUTES 数组」用)⇒ 找不到就没这项。 + "const": _pack_route_const(masked, m.start()), + "entity": em.group(1), + "action": am.group(1) if am else None, + # 🔴 **守卫**(面 B 的点权限编码)—— 与 `.route()` 扫出来的条目**同构** + # ⇒ CC6 的守卫对账对包路由**一行都不用改**。 + "guard": _guard_of_pack_route(body), + "file": path, + }) + return out, orig, masked + + +def _pack_route_const(masked, at): + """从 `PackRoute {` 的位置**往回**找最近的 `const NAME: PackRoute =` ⇒ NAME。 + + 🔴 为什么要常量名:`DATA_RESOURCE_ROUTES` 数组是**按名字**收集这些常量的 + ⇒ 「声明了常量但忘了加进数组」⇒ 路由**不注册**、**不报错**、**静默 404**。 + CC8 用这个名字集合与数组做双向对账 ⇒ 把这个坑变成红的。 + """ + back = masked[max(0, at - 200):at] + hits = re.findall(r"const\s+(\w+)\s*:\s*PackRoute\s*=", back) + return hits[-1] if hits else None + + +def pack_route_array(masked): + """包的 `const XXX_ROUTES: &[PackRoute] = &[A, B, C];` ⇒ (数组名, [常量名])。 + + 找不到(纯元数据包,没有路由)⇒ `(None, [])`。 + """ + m = re.search(r"const\s+(\w+)\s*:\s*&\[PackRoute\]\s*=\s*&\[", masked) + if not m: + return None, [] + start = masked.find("[", m.end() - 1) + depth = 0 + end = -1 + for k in range(start, len(masked)): + if masked[k] == "[": + depth += 1 + elif masked[k] == "]": + depth -= 1 + if depth == 0: + end = k + break + if end < 0: + return m.group(1), [] + names = re.findall(r"\b[A-Za-z_][A-Za-z0-9_]*\b", masked[start:end]) + return m.group(1), names + + +def _guard_of_pack_route(body): + """`PackRoute { … guard: RouteGuard::EnCode("xxx") … }` ⇒ 守卫字符串。 + + 🔴 `RouteGuard::Login` ⇒ `"登录"`;`EnCode("x")` ⇒ `"x"`; + 缺 guard 字段 ⇒ `None`(**旧格式的包** ⇒ 让 CC6 报「推不出守卫」)。 + """ + m = re.search(r'guard\s*:\s*RouteGuard::EnCode\(\s*"([^"]*)"\s*\)', body) + if m: + return m.group(1) + if re.search(r"guard\s*:\s*RouteGuard::Login", body): + return "登录" + return None + + +def guard_of_pack(orig, masked, route): + """**已废弃**:面 A 的守卫口径(`module_key`)—— 包路由走面 B,见 [`guard_of_pack_entity`]。""" + raise AssertionError("guard_of_pack 已废弃:包路由是面 B,用 guard_of_pack_entity") + + +# ---------------------------------------------------------------- 业务包的 spec / 菜单 +# +# 🔴 **为什么这些解析器住在扫描器里**(而不是 `pack-sync.py` 自己写一份): +# 包里的 `EntitySpec` / `MenuSpec` 会被**两处**消费: +# ① `scripts/pack-sync.py` —— 生成契约表的 `[MODULE]` / `[MENU]` / `[ENDPOINT]`; +# ② 本扫描器 —— 从「实体 ⇒ module_key ⇒ 菜单 en_code」推导面 B 的守卫(CC6)。 +# ⇒ 复制一份就会**产生第二份解析器** ⇒ 两份迟早分叉 ⇒ +# 生成段与守卫对账的**口径不一致**(一类最难受的漂移:两边都"对",结论相反)。 +# ⇒ 真源在这里,`pack-sync.py` 复用。 + + +def const_body(orig, masked, name): + """`const NAME: T = …;` 的**值部分**(原文)⇒ 找不到返回 None。 + + 🔴 在 masked 里定位结构(避开注释里的假 mention),再用同一偏移去原文取值。 + """ + m = re.search(r"\b(?:pub\s+)?const\s+" + re.escape(name) + r"\b[^=]*=", masked) + if not m: + return None + start = m.end() + i = start + while i < len(masked) and masked[i] in " \t\r\n": + i += 1 + if i >= len(masked): + return None + if masked[i] == "{": + span = brace_span(masked, i) + return orig[start:span[1]] + if masked[i] == "[": + depth = 0 + j = i + while j < len(masked): + if masked[j] == "[": + depth += 1 + elif masked[j] == "]": + depth -= 1 + if depth == 0: + break + j += 1 + return orig[start:j + 1] + # 标量(`&str`)⇒ 找分号 + j = orig.find(";", start) + if j < 0: + return None + return orig[start:j] + + +def str_field(body, field): + """结构体字面量里的 `field: "value",` ⇒ value。 + + 🔴 `(?/packs`)—— 不扫它 ⇒ 包路由不在「代码真实路由」 + # 里 ⇒ CC2/CC3 判**假漂移**(契约有、代码说没有),这类假警报最耗费信任。 + packs_dir = os.path.join(ROOT, "packs") i = 1 while i < len(argv): if argv[i] == "--contract" and i + 1 < len(argv): @@ -753,11 +1295,19 @@ def main(argv): src_dir = argv[i + 1] i += 2 continue + if argv[i] == "--packs" and i + 1 < len(argv): + packs_dir = argv[i + 1] + i += 2 + continue + if argv[i] == "--self-test": + # 🔴 反自证也要扫 `packs/`:不然「真实契约零漂移」这一关会因为 + # 包路由只在契约里、不在代码侧而**假失败**。 + return self_test(contract, src_dir, packs_dir) sys.stderr.write("check-contract-scan: 未知参数 %r\n" % argv[i]) return 2 try: - rep = analyze(contract, src_dir) + rep = analyze(contract, src_dir, packs_dir) except contract_expect.ContractError as exc: sys.stderr.write("check-contract-scan: %s\n" % exc) return 2 diff --git a/scripts/check-module.sh b/scripts/check-module.sh index dd97b68..7b37396 100755 --- a/scripts/check-module.sh +++ b/scripts/check-module.sh @@ -268,15 +268,65 @@ check_menu_field() { fi } +# 给人看的「spec 真源」标签(相对仓库根)—— 用于断言文案 +# +# 🔴 **为什么要单独一个函数**:spec 的真源有两个可能的位置 +# (`modules/.rs` 或 `packs//src/lib.rs`)。 +# 断言文案里写死其中一处 ⇒ 另一处出问题时**提示会指错文件** ⇒ 白跑一趟。 +spec_src_label() { + printf '%s' "${SPECFILE_CUR#"$ROOT"/}" +} + # 从 schema.sql 里取某张表的 CREATE TABLE 块 +# +# 🔴 允许 `CREATE TABLE IF NOT EXISTS`(业务包的 DDL 一律带 IF NOT EXISTS —— +# 内核启动时**幂等**执行,见批次 12 交付物 ③)。 schema_block_of() { awk -v t="$1" ' - $0 ~ ("CREATE TABLE " t " \\(") { inb = 1 } + $0 ~ ("CREATE TABLE (IF NOT EXISTS )?" t " \\(") { inb = 1 } inb { print } inb && /^\);/ { exit } ' "$SCHEMA" } +# 在**所有可能的位置**找某张表的建表块:先平台 `schema.sql`,再各业务包的 DDL。 +# +# 🔴 **为什么必须两处都找**(批次 12 交付物 ③):业务表的 DDL 从 `schema.sql` +# 搬进了 `packs//schema/*.sql`(跟包走、`include_str!` 编进二进制)。 +# 只查 `schema.sql` ⇒ **加一张业务表就跑不起来**这个事实反而查不出来 +# (每一项都报「没取到」⇒ 尺子还在打印,但**已经什么都检查不到了**)。 +schema_block_any() { + local t="$1" blk f + blk="$(schema_block_of "$t")" + if [ -n "${blk}" ]; then printf '%s\n' "${blk}"; return 0; fi + for f in "$ROOT"/packs/*/schema/*.sql; do + [ -f "$f" ] || continue + blk="$(awk -v t="$t" ' + $0 ~ ("CREATE TABLE (IF NOT EXISTS )?" t " \\(") { inb = 1 } + inb { print } + inb && /^\);/ { exit } + ' "$f")" + if [ -n "${blk}" ]; then printf '%s\n' "${blk}"; return 0; fi + done + return 0 +} + +# 该表的 DDL 实际住在哪(给人看的路径) +schema_file_any() { + local t="$1" f + if [ -n "$(schema_block_of "$t")" ]; then printf '%s' "db/schema.sql"; return 0; fi + for f in "$ROOT"/packs/*/schema/*.sql; do + [ -f "$f" ] || continue + if awk -v t="$t" ' + $0 ~ ("CREATE TABLE (IF NOT EXISTS )?" t " \\(") { found = 1; exit } + END { exit(found ? 0 : 1) } + ' "$f"; then + printf '%s' "${f#"$ROOT"/}"; return 0 + fi + done + return 0 +} + for i in $(seq 0 $((T_COUNT - 1))); do APP="${T_APP[$i]}" ENT="${T_ENT[$i]}" @@ -291,6 +341,22 @@ for i in $(seq 0 $((T_COUNT - 1))); do LC="$(lower "$ENT")" URL="${APP}/${ENT}" + # 🔴 **spec / 菜单的真源可能已搬进业务包**(批次 12 交付物 ②): + # `modules/.rs` 只做 `pub use sspf_pack_::…` 转发 ⇒ 文件里**没有** + # `EntitySpec` / `MenuSpec` 字面量。 + # ⇒ 若继续只读模块文件,下面每一条都会报「没取到」—— + # 看起来像 17 个业务错误,实际是**尺子找不到真源了**(尺子瞎了,不是代码坏了)。 + # ⇒ 判据:模块文件里有 `pub use sspf_pack_` ⇒ spec 去包里读。 + SPECFILE="${MODFILE}" + if grep -q "pub use sspf_pack_" "${MODFILE}" 2>/dev/null; then + PKGLIB="$ROOT/packs/${APP}/src/lib.rs" + if [ -f "${PKGLIB}" ]; then + SPECFILE="${PKGLIB}" + fi + fi + SPECFILE_CUR="${SPECFILE}" + MODFILE_CUR="${SPECFILE}" # 菜单字段也从真源读(re-export 时模块文件里没有) + hdr "[${ENT}] 1) 后端路由注册:modules/${T_FILE[$i]} 含 /api/ssw/${URL}/{List|Save|Delete}" if [ -f "$MODFILE" ]; then ok "业务模块文件存在: src/backend/src/modules/${T_FILE[$i]}" @@ -319,35 +385,37 @@ for i in $(seq 0 $((T_COUNT - 1))); do else no "modules/mod.rs 的 router() 没 merge ${MODNAME}::router() ⇒ 端点 404" fi - SPEC_CONST="$(spec_const_of "$MODFILE")" + SPEC_CONST="$(spec_const_of "${SPECFILE}")" + if [ -n "${SPEC_CONST}" ] && grep -q "${SPEC_CONST}" "$MODULES_MOD" 2>/dev/null; then ok "modules/mod.rs 的 ALL_SPECS 收了 ${SPEC_CONST}" else no "modules/mod.rs 的 ALL_SPECS 没收 ${SPEC_CONST:-(没取到 spec 常量)} ⇒ 启动白名单自检会失败" fi - hdr "[${ENT}] 2) spec 定义:modules/${T_FILE[$i]} 含 entity: \"${ENT}\" + table: \"${TABLE}\"" - if grep -q "entity: \"${ENT}\"" "$MODFILE" 2>/dev/null; then - ok "modules/${T_FILE[$i]} 含 entity: \"${ENT}\"" + hdr "[${ENT}] 2) spec 定义:$(spec_src_label) 含 entity: \"${ENT}\" + table: \"${TABLE}\"" + if grep -q "entity: \"${ENT}\"" "${SPECFILE}" 2>/dev/null; then + ok "$(spec_src_label) 含 entity: \"${ENT}\"" else - no "modules/${T_FILE[$i]} 缺 entity: \"${ENT}\"(spec 没登记这个实体)" + no "$(spec_src_label) 缺 entity: \"${ENT}\"(spec 没登记这个实体)" fi - SPEC_TABLE="$(spec_table_of "${ENT}" "$MODFILE")" + SPEC_TABLE="$(spec_table_of "${ENT}" "${SPECFILE}")" if [ "${SPEC_TABLE}" = "${TABLE}" ]; then ok "spec.table = ${TABLE}" else no "spec.table = ${SPEC_TABLE:-(没取到)},期望 ${TABLE}" fi - hdr "[${ENT}] 3) 实体表存在:schema.sql 含 CREATE TABLE ${TABLE}" - if grep -q "CREATE TABLE ${TABLE}" "$SCHEMA" 2>/dev/null; then - ok "schema.sql 有表 ${TABLE}" + DDL_AT="$(schema_file_any "${TABLE}")" + hdr "[${ENT}] 3) 实体表存在:${DDL_AT:-DDL} 含 CREATE TABLE ${TABLE}" + if [ -n "${DDL_AT}" ]; then + ok "${DDL_AT} 有表 ${TABLE}" else - no "schema.sql 缺表 ${TABLE} → 业务模块跑不起来" + no "任何 DDL 里都没有表 ${TABLE}(db/schema.sql 与 packs/*/schema/*.sql 都查过)→ 业务模块跑不起来" fi - hdr "[${ENT}] 4) 守卫 module_key:modules/${T_FILE[$i]} 的 spec.module_key" - SPEC_MK="$(spec_module_key_of "${ENT}" "$MODFILE")" + hdr "[${ENT}] 4) 守卫 module_key:$(spec_src_label) 的 spec.module_key" + SPEC_MK="$(spec_module_key_of "${ENT}" "${SPECFILE}")" if [ "${SPEC_MK}" = "${MK}" ]; then ok "spec.module_key = ${MK}" else @@ -417,18 +485,18 @@ for i in $(seq 0 $((T_COUNT - 1))); do no "App.tsx 缺 .rs` 的 - # `*_MENU: MenuSpec` 里,由装配根注入平台层的种子。 + # 🔴 **业务菜单住在业务层**(红线 12)—— 声明在 `*_MENU: MenuSpec` 里, + # 由装配根注入平台层的种子。批次 12 起这个真源**可能搬进了包**(见 SPECFILE)。 # 期望值来自**契约** `[MENU]` 区段 ⇒ 代码改了菜单名/编码/图标 ⇒ 这里立刻报漂移。 - DECL_ID="$(menu_id_of "${MODFILE}")" + DECL_ID="$(menu_id_of "${SPECFILE}")" if [ "${DECL_ID}" = "${SEED_ID}" ]; then - ok "modules/${T_FILE[$i]} 声明的菜单 id = ${SEED_ID}" + ok "$(spec_src_label) 声明的菜单 id = ${SEED_ID}" else - no "modules/${T_FILE[$i]} 声明的菜单 id = ${DECL_ID:-(没取到)},期望 ${SEED_ID}" + no "$(spec_src_label) 声明的菜单 id = ${DECL_ID:-(没取到)},期望 ${SEED_ID}" fi - SEED_URL="$(menu_url_of "${SEED_ID}" "${MODFILE}")" + SEED_URL="$(menu_url_of "${SEED_ID}" "${SPECFILE}")" if [ "${SEED_URL}" = "${ROUTE}" ]; then ok "菜单 ${SEED_ID}.url_address = ${ROUTE}" else @@ -442,7 +510,7 @@ for i in $(seq 0 $((T_COUNT - 1))); do check_menu_field "${SEED_ID}" sortCode sort_code # icon:契约里空 = NULL,代码里写 `None` ⇒ 归一化后再比 C_ICON="$(row_field "${CE_MENU_ROWS}" "${SEED_ID}" icon)" - D_ICON="$(menu_field_of "${SEED_ID}" icon "${MODFILE}")" + D_ICON="$(menu_field_of "${SEED_ID}" icon "${SPECFILE}")" if [ "${D_ICON}" = "None" ]; then D_ICON=""; fi if [ "${C_ICON}" = "${D_ICON}" ]; then ok "菜单 ${SEED_ID}.icon = ${C_ICON:-(NULL)}" @@ -451,9 +519,9 @@ for i in $(seq 0 $((T_COUNT - 1))); do fi hdr "[${ENT}] 9) 菜单登记:modules/mod.rs 的 ALL_MENUS 收了本模块的菜单" - MENU_CONST="$(grep -o "^pub const [A-Z_]*_MENU: MenuSpec" "${MODFILE}" 2>/dev/null | sed 's/^pub const //; s/: MenuSpec$//')" + MENU_CONST="$(grep -o "^pub const [A-Z_]*_MENU: MenuSpec" "${SPECFILE}" 2>/dev/null | sed 's/^pub const //; s/: MenuSpec$//')" if [ -z "${MENU_CONST}" ]; then - no "modules/${T_FILE[$i]} 没有 *_MENU: MenuSpec 声明" + no "$(spec_src_label) 没有 *_MENU: MenuSpec 声明" elif grep -q "${MENU_CONST}," "${MODULES_MOD}" 2>/dev/null; then ok "modules/mod.rs 的 ALL_MENUS 收了 ${MENU_CONST}" else @@ -475,11 +543,17 @@ for i in $(seq 0 $((T_COUNT - 1))); do fi hdr "[${ENT}] 实体列 f_ 前缀 + 主键 f_id VARCHAR(50)(契约红线 4)" - BLOCK="$(schema_block_of "${TABLE}")" + BLOCK="$(schema_block_any "${TABLE}")" if [ -z "${BLOCK}" ]; then - no "schema.sql 里没解析出 ${TABLE} 的建表块" + no "任何 DDL 里都没解析出 ${TABLE} 的建表块" else - COLS="$(printf '%s\n' "${BLOCK}" | sed -n 's/^ \([A-Za-z_][A-Za-z0-9_]*\).*/\1/p')" + # 🔴 **只取列定义行**:表级约束(`PRIMARY KEY (...)` / `UNIQUE (...)` / + # `CONSTRAINT ...` / `FOREIGN KEY ...` / `CHECK ...`)**不是列**。 + # 官方 DDL 的复合主键就是表级约束(`PRIMARY KEY (f_id, f_tenant_id)`)—— + # 不过滤的话会被当成一个叫 `PRIMARY` 的列 ⇒ 假红。 + COLS="$(printf '%s\n' "${BLOCK}" \ + | sed -n 's/^ \([A-Za-z_][A-Za-z0-9_]*\).*/\1/p' \ + | grep -viE '^(primary|unique|constraint|foreign|check|key|index)$')" if [ -z "${COLS}" ]; then no "${TABLE} 的建表块里没解析出任何列" else diff --git a/scripts/contract_expect.py b/scripts/contract_expect.py index 2d05719..577c9ed 100755 --- a/scripts/contract_expect.py +++ b/scripts/contract_expect.py @@ -99,6 +99,12 @@ def load_sections(path=None): continue if line.lstrip().startswith("#"): continue # 注释行 + # 🔴 **HTML 注释行**(`` / ``): + # `scripts/pack-sync.py` 用它包住**生成段**(批次 12 交付物 ④)。 + # ⇒ 必须在这里跳过,否则它会被当成「只有 1 列的数据行」⇒ + # 列数校验立刻抛 `ContractError` ⇒ **整把尺子读不出契约**。 + if line.lstrip().startswith("` / `` + - Rust 文件:`// >>>GEN:<名字>` / `// <<` + - `Cargo.toml`:`# >>>GEN:PACK_DEPS` / `# <<>>GEN:名字` … `// <<.ts` 该不该有 ⇒ 包带来的模块**有**。 + - `rsFile` = 🔴 **相对 `src/backend/src/modules/` 的文件名**(如 `asset.rs`), + **不是**包路径 —— `check-module.sh` 的 `MODFILE="$MODULES_DIR/${rsFile}"` 就按这个拼。 + 包里的 spec 是**真源**,但模块文件仍在(做 `pub use` 转发)⇒ 这一列指的是**模块文件**。 + """ + rows = [] + for p in packs: + # `url_address` ⇒ 菜单 id(同一个包里的菜单按 url_address 索引) + by_url = {m["urlAddress"]: m for m in p["menus"]} + for e in p["entities"]: + mk = e["module_key"] + menu = by_url.get(mk) if mk else None + rows.append([ + e["app"], + e["entity"], + e["table"], + menu["urlAddress"] if menu else (mk or ""), + mk if mk else "None", + menu["id"] if menu else "", + "有", + "%s.rs" % p["app"], + ]) + return rows + + +def gen_menu_rows(packs): + """生成 `[MENU]` 段的包部分行。""" + rows = [] + for p in packs: + for m in p["menus"]: + rows.append([ + m["id"], + m["fullName"], + m["enCode"], + m["urlAddress"], + m["parentId"], + m["type"], + m["icon"], + m["sortCode"], + ]) + return rows + + +def gen_endpoint_rows(packs, mods): + """生成 `[ENDPOINT]` 段的包/模块部分行。 + + 🔴 **两块都要生成**(批次 12.5 补的第二块): + - **面 A**(`/api/ssw/{app}/{Entity}/{List|Save|Delete}`)—— 由 + `modules/.rs` 的 `router()` 里**真实注册**的 `.route(...)` 读出; + - **面 B**(官方 RESTful 形状)—— 由包的 `PackRoute` 声明读出。 + + 🔴 **为什么要生成面 A**:批次 12 只生成了面 B ⇒ 新加的模块在代码里注册了 + 3 条面 A,但契约表里没有 ⇒ `check-contract` 的 CC2/CC4 立刻红 + (「契约 382 / 代码 385」)⇒ **加一个模块就必须手抄三行**, + 而手抄就是本脚本要消灭的东西。 + + 🔴 **面 A 的 guard = 菜单的 `url_address`**(**不是** `f_en_code`)—— + 面 A 的守卫判据是菜单路径,面 B 是点权限,两套并存(见 `docs/contract.md`)。 + """ + rows = [] + + # ---- 面 A:模块文件里真实注册的路由 ---- + for app, spec_const, _menu, _n in mods: + guard = module_guard(app, spec_const, packs) + path = os.path.join(MODULES_DIR, "%s.rs" % app) + # `scan_routes` 返回 `(路由列表, 原文, 掩码后原文)` —— 只取第一项。 + face_a, _, _ = scan.scan_routes(path, app) + for r in face_a: + rows.append(["A", r["method"], r["path"], guard or "登录", app]) + + # ---- 面 B:包声明的路由(官方形状)---- + for p in packs: + for r in p["routes"]: + rows.append([ + "B", + r["method"], + r["path"], + r.get("guard") or "登录", + p["app"], + ]) + return rows + + +def module_guard(app, spec_const, packs): + """模块的 `module_key`(= 面 A 的守卫 = 菜单 `url_address`);`None` ⇒ 仅登录。 + + 🔴 **两种形态都要认**: + ① 模块自己声明 spec(demo / shop / books)⇒ 直接读 `module_key`; + ② 模块只是转发包的 spec(asset / 新加的包)⇒ 回落包里那个实体。 + 漏了回落 ⇒ 面 A 的 guard 变成「登录」⇒ 契约里登记成无守卫 ⇒ + CC6 立刻红(而且红得很像「代码写错了」)。 + """ + path = os.path.join(MODULES_DIR, "%s.rs" % app) + orig = scan.read(path) + masked = scan.mask_rust(orig) + body = scan.const_body(orig, masked, spec_const) + if body: + return scan.module_key_of(body) + for p in packs: + if p["app"] != app: + continue + for e in p["entities"]: + if e["module_key"]: + return e["module_key"] + return None + + +def rows_to_text(rows): + """行列表 ⇒ 制表符分隔的文本(**不带**表头注释)。""" + return "\n".join("\t".join(c for c in row) for row in rows) + + +# ---------------------------------------------------------------- 写回契约 + +def replace_generated(text, rows, section): + """把生成段替换成 `rows`(幂等)⇒ 返回 (新文本, 删掉的手写行数)。 + + 🔴 **段落结构**(每次都一样 ⇒ 幂等): + ``` + [SECTION] + # 手写部分(保留) + <手写行> + + # 🔴 以下由 scripts/pack-sync.py 生成 —— 不许手改 + <生成行> + + ``` + + 🔴 **手写行里与生成行逐字相同的那几行会被移除**(见 [`strip_owned_rows`]): + 否则**同一条端点登记两遍** ⇒ CC2 的总数对不上。 + """ + lines = text.split("\n") + try: + sec_at = lines.index("[%s]" % section) + except ValueError: + raise SyncError("契约里找不到 [%s] 段" % section) + + # 段的结束 = 下一个 `[SECTION]` 或 CONTRACT-EXPECT 结束标记。 + end_at = len(lines) + for i in range(sec_at + 1, len(lines)): + if lines[i].startswith("["): + end_at = i + break + if lines[i].strip() == "": + end_at = i + break + + seg = lines[sec_at + 1:end_at] + # 去掉旧的生成段(连同它的标记与说明行)。 + kept = [] + i = 0 + while i < len(seg): + if seg[i].strip() == BEGIN_MARK: + # 跳过到 END_MARK(含)。 + j = i + while j < len(seg) and seg[j].strip() != END_MARK: + j += 1 + i = j + 1 + continue + kept.append(seg[i]) + i += 1 + + # 🔴 **移除「与生成行重复的手写行」**(否则与生成段重复登记)。 + kept, dropped = strip_owned_rows(kept, rows, section) + + # 去掉尾部空行(生成段要贴在段末)。 + while kept and not kept[-1].strip(): + kept.pop() + + block = [] + if rows: + block.append(BEGIN_MARK) + block.append("# 🔴 以下由 `scripts/pack-sync.py` 从 `packs/*` 生成 —— **不许手改**") + block.append("# (下次同步会被覆盖;改包就够)") + block.extend(rows_to_text(rows).split("\n")) + block.append(END_MARK) + + # 🔴 **保留段间空行**:原来的手写段在末尾有一个空行(分隔下一段 `[...]`)。 + # pop 掉它再重排 ⇒ 若不在 block 后补回来,`` 会**紧贴** + # 下一个段标题 ⇒ 人读起来像标记属于下一段(机器不受影响,但 review 会看错)。 + new_seg = kept + ([""] + block + [""] if block else []) + return "\n".join(lines[:sec_at + 1] + new_seg + lines[end_at:]), dropped + + +def strip_owned_rows(kept, rows, section): + """删掉「**与生成行重复**的手写行」(按**整行内容**逐字比对)。 + + 🔴 **为什么不能按 `owner` / `app` 一刀切**(差点踩的坑): + 业务包 `asset` 与业务模块 `asset` **同 app_code**。模块侧还有 3 条**面 A** + 路由(`/api/ssw/asset/DataResource/{List|Save|Delete}`)**真实注册**在 + `modules/asset.rs` 里、**必须**留在契约表。 + 按 owner 删 ⇒ 把这 3 条面 A 也删了 ⇒ 契约立刻少 3 条 ⇒ CC2/CC3 红。 + ⇒ **只删与生成行逐字相同的那几行**,其余(含同 owner 的面 A 行)一根汗毛不动。 + + 🔴 **这正是「生成段负责哪几行」的精确边界**: + 生成段 = 包的声明;手写段 = 其它所有(平台层 / 面 A / 别的模块)。 + 两者**内容冲突**时以生成为准(包是真源)⇒ 删掉手写那份。 + """ + # 归一化:末尾空列差异不算差异(制表符尾随) + def norm(line): + return "\t".join(line.split("\t")).rstrip("\t") + + owned = set(norm("\t".join(r)) for r in rows) + out = [] + dropped = 0 + for line in kept: + if not line.strip() or line.lstrip().startswith("#") or line.startswith("["): + out.append(line) + continue + if norm(line) in owned: + dropped += 1 + continue + out.append(line) + return out, dropped + + +def sync_contract(text, packs, mods): + """同步契约表的三段 + `[FACE]` 面计数 ⇒ (新文本, 每段的变化)。 + + 🔴 **只碰 `` 之间** —— 手写区(平台层 30 条端点、 + 48 条 `base_*` 菜单、官方台账)一根汗毛都不动。 + """ + out = text + changes = {} + + ep_rows = gen_endpoint_rows(packs, mods) + for section, rows in ( + (SEC_MODULE, gen_module_rows(packs)), + (SEC_MENU, gen_menu_rows(packs)), + (SEC_ENDPOINT, ep_rows), + ): + before = out + out, dropped = replace_generated(out, rows, section) + changes[section] = (before, out, dropped) + + # 🔴 **`[FACE]` 的条数必须跟着变**(CC9 会对账): + # 生成的端点进了 `[ENDPOINT]` ⇒ 对应面的条数要跟着动。 + # **不写死数字** ⇒ 从生成行里数出来(加包/加模块自动跟着走)。 + out = sync_face_counts(out, {row[0] for row in ep_rows}) + return out, changes + + +def sync_face_counts(text, faces): + """把 `[FACE]` 里 `faces` 各行的条数改成「`[ENDPOINT]` 里的实际条数」(幂等)。 + + 🔴 **为什么必须做**:`[FACE]` 是**自洽对账**用的(CC9 检查 + 「登记的条数 == `[ENDPOINT]` 里实际条数」)。包的 3 条面 B 与模块的 + 3 条面 A 进了 `[ENDPOINT]`,若 `[FACE]` 不跟着改 ⇒ CC9 立刻红 + ⇒ 加包变成「必须记得改三处」,本交付物的目的(**加包不手抄**)就落空了。 + + 🔴 **不写死增量**:直接写「当前 `[ENDPOINT]` 里的实际条数」 + ⇒ 天然幂等,且加包 / 加模块 / 改路由都自动跟着走。 + """ + if not faces: + return text + + lines = text.split("\n") + try: + sec_at = lines.index("[%s]" % SEC_FACE) + except ValueError: + raise SyncError("契约里找不到 [%s] 段(CC9 需要它对账)" % SEC_FACE) + + # 段尾 + end_at = len(lines) + for i in range(sec_at + 1, len(lines)): + if lines[i].startswith("[") or lines[i].strip() == "": + end_at = i + break + + face_now = count_faces(lines, sec_at) + + for i in range(sec_at + 1, end_at): + cols = lines[i].split("\t") + if len(cols) < 2 or cols[0].startswith("#") or not cols[0]: + continue + face = cols[0] + if face not in faces: + continue + # 本函数在三次替换**之后**调用 ⇒ `count_faces` 读到的是更新后的值。 + cols[1] = str(face_now.get(face, 0)) + lines[i] = "\t".join(cols) + return "\n".join(lines) + + +def count_faces(lines, face_sec_at): + """数 `[ENDPOINT]` 段里各 face 的实际条数(忽略注释 / 标记 / 空行)。 + + 🔴 从 `[FACE]` 段**往前**找 `[ENDPOINT]` 段 —— 两段的相对顺序在契约里固定, + 但**不假设**(遍历全表找段落头,比硬编码行号稳)。 + """ + # 找 [ENDPOINT] 段 + start = None + for i, line in enumerate(lines): + if line == "[%s]" % SEC_ENDPOINT: + start = i + 1 + break + if start is None: + return {} + counts = {} + for i in range(start, len(lines)): + line = lines[i] + if line.startswith("[") or line.strip() == "": + break + if not line.strip() or line.lstrip().startswith("#"): + continue + if line.strip() in (BEGIN_MARK, END_MARK): + continue + cols = line.split("\t") + if len(cols) < 5: + continue + counts[cols[0]] = counts.get(cols[0], 0) + 1 + return counts + + +# ================================================================ 内核接线生成 +# +# 🔴 这一节回答「加包之后,内核怎么知道它」。 +# +# 三个派生位置,全部由 `packs/*` + `modules/*.rs` 推出 —— **没有一处靠手抄**: +# +# ② `packs_gen.rs` ← 包的清单 + 装载调用 +# ③ `modules/mod.rs` 五段 ← 模块的 spec / 菜单 / 面 A 路由 / 总路由 +# ④ `Cargo.toml` 依赖段 ← 包的 crate 名 +# +# 🔴 **②③ 漏了是「静默」的**(面 B 404 / 面 A 404 / 菜单不种 ⇒ 守卫查不到菜单), +# 而这三种现象在浏览器里都表现为「页面空着」⇒ 最难查。 +# ⇒ 把「记住改哪几处」换成「跑一次脚本」,再用 `--check` 钉住。 + + +def read_all_packs(): + """读 `packs/*` 全部包(按目录名字典序 ⇒ 生成结果确定)。""" + packs = [] + if os.path.isdir(PACKS_DIR): + for app in sorted(os.listdir(PACKS_DIR)): + if os.path.isdir(os.path.join(PACKS_DIR, app)): + packs.append(read_pack(app)) + if not packs: + raise SyncError("packs/ 下没有包(目录:%s)" % PACKS_DIR) + return packs + + +def scan_module_files(): + """列 `src/backend/src/modules/*.rs`(排除 `mod.rs`)⇒ [(app, 绝对路径)]。 + + 🔴 **顺序 = 文件名字典序** —— 生成段(`ALL_SPECS` / `ALL_ROUTES` …)按这个顺序排, + 两次生成的字节必然一致(幂等的前提)。 + """ + if not os.path.isdir(MODULES_DIR): + return [] + out = [] + for name in sorted(os.listdir(MODULES_DIR)): + if not name.endswith(".rs") or name == "mod.rs": + continue + out.append((name[:-3], os.path.join(MODULES_DIR, name))) + return out + + +def module_decls(app, path): + """从一个模块文件读出 `(spec 常量名, menu 常量名, ROUTES 长度)`。 + + 🔴 **两种写法都认**(批次 12 把 spec 搬进包之后,asset 是第二种): + ① 自己声明:`pub const DEMO_SPEC: EntitySpec = …;` + ② 转发包的:`pub use sspf_pack_asset::DATA_RESOURCE_SPEC;` + + 🔴 **为什么要求「1 个 spec + 1 个 menu + 3 条路由」**: + `ALL_ROUTES` 与 `ALL_SPECS` 是两份独立的数组 ⇒ 唯一的配对依据就是 + 「每个模块固定 3 条」这个约定(`modules/mod.rs` 的测试按 `chunks(3)` 校验)。 + 允许「一个模块多实体」就得引入 `模块 → (起点, 条数)` 的映射表 ⇒ + 又多一处会漂的结构。⇒ **一个模块文件一个实体**,要加就再建一个文件。 + """ + orig = scan.read(path) + masked = scan.mask_rust(orig) + + names = [m.group(1) for m in re.finditer(r"pub\s+use\s+[\w:]+::(\w+)\s*;", masked)] + names += [ + m.group(1) + for m in re.finditer( + r"pub\s+const\s+(\w+)\s*:\s*(?:EntitySpec|MenuSpec)\s*=", masked + ) + ] + + specs, menus = [], [] + for n in names: + if n.endswith("_SPEC") and n not in specs: + specs.append(n) + elif n.endswith("_MENU") and n not in menus: + menus.append(n) + + rm = re.search(r"pub\s+const\s+ROUTES\s*:\s*\[&str;\s*(\d+)\s*\]", masked) + routes = int(rm.group(1)) if rm else 0 + + if len(specs) != 1 or len(menus) != 1 or routes != 3: + raise SyncError( + "模块 %s 的声明形状不对:spec=%r menu=%r ROUTES=%d\n" + " 🔴 一个模块文件必须恰好 1 个 `*_SPEC` + 1 个 `*_MENU` + " + "`pub const ROUTES: [&str; 3]`\n" + " (`ALL_ROUTES` 与 `ALL_SPECS` 按「每模块 3 条」配对)。\n" + " 要加第二个实体 ⇒ 另建一个模块文件。" % (app, specs, menus, routes) + ) + return specs[0], menus[0], routes + + +def require_module_for_every_pack(packs, mods): + """🔴 **每个有实体的包都必须有 `modules/.rs`**(面 A 适配器 + 菜单登记)。 + + 缺了会怎样(都是**静默**的,所以在这里拦): + - 菜单只从 `modules::all_menus()` 进种子 ⇒ 包自己的菜单**不会被种**; + - 面 B 的守卫按 `f_en_code` 查菜单,查不到就走「未映射放行」⇒ **越权**; + - MVP 前端(React)走的是面 A `/api/ssw/...` ⇒ 端点根本不存在 ⇒ 页面空着。 + """ + have = {m[0] for m in mods} + for p in packs: + if p["entities"] and p["app"] not in have: + raise SyncError( + "包 %s 声明了实体,但缺 `src/backend/src/modules/%s.rs`\n" + " 🔴 缺它的后果是**静默**的:菜单不会被种 ⇒ 面 B 守卫查不到菜单\n" + " ⇒ 走「未映射放行」(越权);面 A 端点也不存在 ⇒ MVP 前端页面空着。\n" + " ⇒ 跑 `bash scripts/new-pack.sh %s ` 补上。" + % (p["app"], p["app"], p["app"]) + ) + + +def manifest_json_of(p): + """把 `pack.toml` 裁成**装载器实际读的字段**,输出稳定 JSON。 + + 🔴 **只留 `sspf_plugin::PackTomlPack` 认的字段** —— `[pack.compat]` / + `[pack.metadata]` / `[pack.build]` 是给导出 / 迁移工具读的, + 内核不认 ⇒ 带进来只会让「两份清单到底谁说了算」变模糊。 + """ + m = p["manifest"] + tables = [] + for t in m.get("tables", []) or []: + item = {"name": t["name"]} + if t.get("ddl"): + item["ddl"] = t["ddl"] + if t.get("baseline_table"): + item["baseline_table"] = t["baseline_table"] + tables.append(item) + obj = { + "pack": { + "app_code": m.get("app_code", p["app"]), + "name": m.get("name", p["app"]), + "version": m.get("version", "0.0.0"), + "kernel": m.get("kernel", ""), + "migratable": bool(m.get("migratable", False)), + "tables": tables, + } + } + text = json.dumps(obj, ensure_ascii=False, indent=2) + # Rust 的 `r#"…"#` 遇到 `"#` 就提前结束 ⇒ 有这种内容必须换定界符(宁可报错)。 + if '"#' in text: + raise SyncError( + "包 %s 的清单里出现了 '\"#'(会截断 Rust 的 raw string)" % p["app"] + ) + return text + + +def gen_packs_gen(packs): + """生成 `src/backend/src/packs_gen.rs` 全文。""" + L = [] + L.append("//! ⚠️ **本文件由 `scripts/pack-sync.py` 生成 —— 不许手改。**") + L.append("//!") + L.append("//! 它是内核的**业务包清单**:每个包一条 [`sspf_plugin::load_static`]") + L.append("//! 调用 + 一份 `pack.toml` 的 JSON 快照。") + L.append("//!") + L.append("//! 🔴 **为什么是生成的**:批次 12 时这段在 `bootstrap.rs` 里手写 ——") + L.append("//! 每加一个包要抄「manifest JSON + `PackSource` + `merge(vec![…])`」三段。") + L.append("//! 漏掉最后那段 `merge` 的表现是:包**装载成功**、没有报错,") + L.append("//! 但 `entities` / `routes` 全丢 ⇒ **面 B 端点静默 404**。") + L.append("//! ⇒ 改成生成 ⇒ 「漏一处」在机制上不存在;真忘了跑生成,") + L.append("//! `scripts/verify.sh` 的第一步(`pack-sync.py --check`)会红。") + L.append("//!") + L.append("//! 🔴 **`packs/` 是唯一真源** —— 加包跑 `bash scripts/new-pack.sh`,") + L.append("//! 改完 `packs/*` 跑 `python3 scripts/pack-sync.py`。") + L.append("") + L.append("use sspf_plugin::{LoadError, PackRegistry};") + L.append("") + L.append("/// 装载 `packs/*` 下的**全部**业务包(顺序 = `app_code` 字典序)。") + L.append("///") + L.append("/// 🔴 任一包装载失败 ⇒ **整体失败**(半加载的包比不加载更危险):") + L.append("/// 半加载的包 = 一部分路由在、一部分不在 ⇒ 前端表现为「有的页面能用」。") + L.append("pub fn registry(kernel_version: &str) -> Result {") + L.append(" let mut regs: Vec = Vec::new();") + L.append("") + for p in packs: + app = p["app"] + ident = "sspf_pack_" + app.replace("-", "_") + const = app.upper().replace("-", "_") + "_MANIFEST_JSON" + L.append(" // ---- %s ----" % app) + L.append(" regs.push(sspf_plugin::load_static(") + L.append(' "%s",' % app) + L.append(" %s," % const) + L.append(" Box::new(%s::Pack)," % ident) + L.append(" %s::DDLS," % ident) + L.append(" kernel_version,") + L.append(" )?);") + L.append("") + L.append(" Ok(sspf_plugin::merge(regs))") + L.append("}") + L.append("") + L.append("// ---------------------------------------------------------------- 清单快照") + L.append("//") + L.append("// 🔴 `pack.toml` 的**权威副本**在 `packs//pack.toml`(给人看、给导出工具读);") + L.append("// 这里是它的**编译期 JSON 快照**。为什么要快照、不运行期读文件:") + L.append("// 内核是**单二进制部署** ⇒ 运行目录里不一定有 `packs/` 目录。") + L.append("// 两份的一致性由 `scripts/pack-sync.py` 保证(`--check` 会比对)。") + for p in packs: + app = p["app"] + const = app.upper().replace("-", "_") + "_MANIFEST_JSON" + L.append("") + L.append("/// `packs/%s/pack.toml` 的编译期快照。" % app) + L.append('const %s: &str = r#"%s"#;' % (const, manifest_json_of(p))) + return "\n".join(L).rstrip() + "\n" + + +def gen_pack_deps(packs): + """生成 `src/backend/Cargo.toml` 的包依赖段(每包一行)。""" + out = [] + for p in packs: + cargo = os.path.join(PACKS_DIR, p["app"], "Cargo.toml") + name = p["app"] + if os.path.isfile(cargo): + with open(cargo, "rb") as fh: + name = tomllib.load(fh).get("package", {}).get("name", name) + out.append('%s = { path = "../../packs/%s" }' % (name, p["app"])) + return out + + +def gen_mod_regions(mods): + """生成 `modules/mod.rs` 的五个段 ⇒ `{段名: 行列表}`。 + + 🔴 **`ALL_SPECS` 与 `ALL_ROUTES` 必须同序** —— 都按 `mods` 的顺序生成 + ⇒ `mod.rs` 的测试可以按 3 条一组配对(`chunks(3)`)。 + 这个「同序」不是约定,是**生成保证**。 + """ + if not mods: + raise SyncError("modules/ 下没有任何模块文件(至少要保住 demo/shop/books/asset)") + + decls = ["// 每个模块一行:**文件即登记**(顺序 = 文件名字典序,不代表业务顺序)。"] + for app, _, _, _ in mods: + decls.append("pub mod %s;" % app) + + specs = [ + "/// 全部业务实体 spec。", + "///", + "/// 🔴 **本段由 `scripts/pack-sync.py` 生成** —— 加模块不用手改(见文件头)。", + "pub const ALL_SPECS: &[EntitySpec] = &[", + ] + for app, spec, _, _ in mods: + specs.append(" %s::%s," % (app, spec)) + specs.append("];") + + routes = [ + "/// **全部业务路由**(面 A:`/api/ssw/{appCode}/{Entity}/{动作}`,每模块 3 条)。", + "///", + "/// 🔴 **与 `ALL_SPECS` 同序**(同一份模块清单生成)⇒ 可以按 3 条一组配对。", + "pub const ALL_ROUTES: &[&str] = &[", + ] + for app, _, _, n in mods: + for i in range(n): + routes.append(" %s::ROUTES[%d]," % (app, i)) + routes.append("];") + + menus = [ + "/// 全部业务内置菜单(由**装配根** [`crate::bootstrap`] 传给平台层的种子", + "/// ⇒ **平台层不认任何业务菜单**,红线 12)。", + "pub const ALL_MENUS: &[MenuSpec] = &[", + ] + for app, _, menu, _ in mods: + menus.append(" %s::%s," % (app, menu)) + menus.append("];") + + router = [ + "/// **全部业务模块的路由**(`Router::merge` 进总路由)。", + "///", + "/// 🔴 加业务模块 ⇒ **不用改这里**(本段由 `pack-sync.py` 生成)。", + "pub fn router() -> Router {", + " %s::router()" % mods[0][0], + ] + for app, _, _, _ in mods[1:]: + router.append(" .merge(%s::router())" % app) + router.append("}") + + return { + "MODS": decls, + "SPECS": specs, + "ROUTES": routes, + "MENUS": menus, + "ROUTER": router, + } + + +def replace_rust_region(text, region, body): + """把 `// >>>GEN:` 与 `// <<` 之间换成 `body`(行列表)。 + + 🔴 **标记必须已存在** —— 找不到就报错,**不自动追加**。 + 自动追加会让「标记被误删」变成「悄悄多出一段代码」,比报错难查得多。 + """ + lines = text.split("\n") + begin = GEN_OPEN % region + end = GEN_CLOSE % region + try: + i = lines.index(begin) + except ValueError: + raise SyncError("找不到生成段标记 %r(%s)" % (begin, region)) + try: + j = lines.index(end, i + 1) + except ValueError: + raise SyncError("找不到生成段结束标记 %r(%s)" % (end, region)) + return "\n".join(lines[: i + 1] + list(body) + lines[j:]) + + +def replace_marker_block(text, open_mark, close_mark, body): + """同 [`replace_rust_region`],但标记是任意前缀(`Cargo.toml` 用 `#`)。""" + lines = text.split("\n") + try: + i = lines.index(open_mark) + except ValueError: + raise SyncError("找不到标记 %r" % open_mark) + try: + j = lines.index(close_mark, i + 1) + except ValueError: + raise SyncError("找不到标记 %r" % close_mark) + return "\n".join(lines[: i + 1] + list(body) + lines[j:]) + + +def sync(write=True): + """把**四处派生位置**全部同步一遍 ⇒ `(packs, artifacts)`。 + + `artifacts` = `[(相对路径, 旧文本, 新文本, 契约段变化 or None)]`, + 顺序 = ① 契约表 → ② 内核包清单 → ③ 模块登记段 → ④ Cargo 依赖段。 + """ + packs = read_all_packs() + mods = [(app,) + module_decls(app, path) for app, path in scan_module_files()] + require_module_for_every_pack(packs, mods) + + artifacts = [] + + # ① 契约表 + old = scan.read(CONTRACT) + new, changes = sync_contract(old, packs, mods) + artifacts.append(("docs/contract.md", old, new, changes)) + + # ② 内核包清单(整文件生成) + old = scan.read(PACKS_GEN) if os.path.isfile(PACKS_GEN) else "" + artifacts.append(("src/backend/src/packs_gen.rs", old, gen_packs_gen(packs), None)) + + # ③ 模块登记段(五个标记段) + mod_rs = os.path.join(MODULES_DIR, "mod.rs") + old = scan.read(mod_rs) + new = old + for region, body in gen_mod_regions(mods).items(): + new = replace_rust_region(new, region, body) + artifacts.append(("src/backend/src/modules/mod.rs", old, new, None)) + + # ④ Cargo 依赖段 + old = scan.read(BACKEND_CARGO) + new = replace_marker_block(old, GEN_DEPS_OPEN, GEN_DEPS_CLOSE, gen_pack_deps(packs)) + artifacts.append(("src/backend/Cargo.toml", old, new, None)) + + if write: + for rel, before, after, _ in artifacts: + if before != after: + with io.open(os.path.join(ROOT, rel), "w", encoding="utf-8") as fh: + fh.write(after) + return packs, artifacts + + +def main(argv): + check = "--check" in argv + dry = "--dry-run" in argv + for a in argv[1:]: + if a not in ("--check", "--dry-run"): + sys.stderr.write("pack-sync: 未知参数 %r\n" % a) + return 2 + + try: + packs, artifacts = sync(write=not check and not dry) + except (SyncError, contract_expect.ContractError) as exc: + sys.stderr.write("pack-sync: %s\n" % exc) + return 2 + + drifted = [(rel, b, a, ch) for rel, b, a, ch in artifacts if b != a] + + if dry: + # 只打印契约表全文(人要看的是那段);其余三处是「结构性生成」, + # 打印整份 Rust 源码没有意义。 + for rel, _b, after, _ch in artifacts: + if rel == "docs/contract.md": + sys.stdout.write(after) + return 0 + + if check: + if drifted: + sys.stderr.write( + "pack-sync: 以下派生位置与 `packs/*` + `modules/*.rs` **不一致**:\n") + for rel, _b, _a, _ch in drifted: + sys.stderr.write(" · %s\n" % rel) + sys.stderr.write( + " ⇒ 跑 `python3 scripts/pack-sync.py` 重新生成\n" + " (这些位置是生成物:手改会被覆盖,漏改的后果是路由静默消失)\n") + return 1 + print("pack-sync: %d 处派生位置与 packs/* + modules/*.rs 一致 ✅" % len(artifacts)) + return 0 + + if not drifted: + print("pack-sync: 无变化(幂等 ✅)") + else: + print("pack-sync: 已更新 %d 处派生位置:" % len(drifted)) + for rel, _b, _a, changes in drifted: + if not changes: + print(" · %s(整段重新生成)" % rel) + continue + for section, (before, after, dropped) in changes.items(): + if before != after: + note = ( + "(并移除 %d 条与生成行重复的手写行)" % dropped + if dropped + else "" + ) + print(" · %s 的 [%s] 已更新%s" % (rel, section, note)) + print(" 包:%s" % "、".join(p["app"] for p in packs)) + return 0 + + +if __name__ == "__main__": + sys.exit(main(sys.argv)) diff --git a/scripts/verify.sh b/scripts/verify.sh new file mode 100755 index 0000000..e7f32db --- /dev/null +++ b/scripts/verify.sh @@ -0,0 +1,211 @@ +#!/usr/bin/env bash +# ssw-platform **一条命令验证** —— 「快速打包 / 快速验证」的用户可见入口 +# +# 🔴 **为什么存在**(HANDOFF §3 批次 12 交付物 ④ 的原文要求): +# 本仓有 6 把静态闸门 + 45 个测试二进制 + 6 把运行时尺子。 +# 改一行代码要跑哪些、按什么顺序跑、哪一道慢了 ⇒ **没人知道** ⇒ +# 结果是「全都跑一遍」(6 分钟)或者「一道都不跑」(然后提交坏代码)。 +# ⇒ 本脚本把「该跑的」定成一个**固定顺序**,并在末尾打印**总耗时 + Top 3 最慢**。 +# +# 🔴 **判据:耗时必须可见**。看不见耗时 ⇒ 慢下来也没人管 ⇒ +# 「快速验证」退化回「不敢验证」。 +# +# 用法: +# bash scripts/verify.sh # 全量:pack-sync → build → 静态闸门 → 全量测试 +# bash scripts/verify.sh --fast # 内环:pack-sync → build → 静态闸门(不跑测试,~15s) +# bash scripts/verify.sh --lib # 中环:上面 + 只跑 lib 单测(不起库) +# bash scripts/verify.sh --smoke # 全量 + 运行时尺子(要起后端,最慢) +# bash scripts/verify.sh --help +# +# 退出码:0 全过 / 1 有 ❌ / 2 用法错或前置错误 + +set -u + +ROOT="$(cd "$(dirname "$0")/.." && pwd)" +SCRIPTS="$ROOT/scripts" + +MODE="full" # fast | lib | full | smoke +VERBOSE=0 + +usage() { + sed -n '2,25p' "$0" | sed 's/^# \{0,1\}//' +} + +while [ "$#" -gt 0 ]; do + case "$1" in + -h|--help) usage; exit 0 ;; + --fast) MODE="fast"; shift ;; + --lib) MODE="lib"; shift ;; + --smoke) MODE="smoke"; shift ;; + -v|--verbose) VERBOSE=1; shift ;; + *) echo "❌ 未知参数: $1"; usage; exit 2 ;; + esac +done + +PY_BIN="${PY_BIN-$(command -v python3 2>/dev/null || true)}" +if [ -z "${PY_BIN}" ]; then + echo "❌ 找不到 python3(静态闸门需要它)" + exit 2 +fi + +# ---------------------------------------------------------------- 环境告警 +# +# 🔴 **被「转发壳」接管的命令会让计时整体失真**(实测,别忽略这条): +# 某些执行环境(沙箱 CLI / AI 助手内置 bash)会把 `grep` `sed` `cat` `wc` +# 替换成一个转发壳(PATH 里指向 `…/shim/brokered-bin/<命令>`)。壳每次启动 +# ≈0.19s,而本仓的闸门正是「几百次 grep」的形态 ⇒ 实测把 check-module +# 从 **1.5s 放大到 13.7s(9 倍)**,check-contract 从 3.3s 放大到 8.1s。 +# ⇒ 这种环境下打出来的耗时**不能**用来判断闸门本身快不快, +# 要真实数字请到普通终端里重跑(本脚本在那边会打印真实值)。 +_grep_at="$(command -v grep 2>/dev/null || true)" +case "${_grep_at}" in + */shim/* | */brokered-bin/*) + echo "⚠️ 本环境的 grep 被转发壳接管:${_grep_at}" + echo " 转发壳每次启动 ≈0.19s ⇒ 下面每步的耗时都会被**放大数倍**," + echo " 不要用它判断闸门本身快不快;请到普通终端重跑取真实数字。" + ;; +esac + +# ---------------------------------------------------------------- 计时 +# +# 🔴 **时间源必须零启动开销**。原来每步取 2 个时间戳、再算 1 次差值,三次都起 +# `python3`(每次 ≈120ms)⇒ 8 步共 24 次 ≈ **2.9s**。这 2.9s 不属于任何一步, +# 却计进「总耗时」⇒ 结论会变成「闸门慢」,而真因是**计时器自己慢**。 +# ⇒ 改成 `date +%s%N`(≈6ms)+ 纯 bash 整数运算(零进程)。 +# 取不到纳秒(少数 BSD date)才回落到 python3 —— 慢,但结果仍然正确。 +_now_probe="$(date +%s%N 2>/dev/null || true)" +case "${_now_probe}" in + '' | *[!0-9]*) + now() { "${PY_BIN}" -c 'import time; print(int(time.time() * 1e9))'; } ;; + *) + now() { date +%s%N; } ;; +esac + +# 纳秒差 ⇒ "12.3"(秒,一位小数) +ns_to_secs() { + local ms=$(( $1 / 1000000 )) + printf '%d.%d' $(( ms / 1000 )) $(( (ms % 1000) / 100 )) +} + +STEPS_NAME=() +STEPS_SECS=() +STEPS_RC=() +T0="$(now)" + +FAILED=0 + +# run_step <名字> <命令...> +run_step() { + local name="$1"; shift + local t_start t_end t_secs rc out + printf '\n▶ %s\n' "${name}" + t_start="$(now)" + if [ "${VERBOSE}" -eq 1 ]; then + "$@" + rc=$? + else + # 只留尾部 25 行:闸门失败时的关键信息都在尾部(总结 / 失败清单) + out="$("$@" 2>&1)" + rc=$? + if [ "${rc}" -ne 0 ]; then + printf '%s\n' "${out}" | tail -25 + elif [ "${VERBOSE}" -eq 1 ]; then + printf '%s\n' "${out}" + else + printf '%s\n' "${out}" | tail -3 + fi + fi + t_end="$(now)" + t_secs="$(ns_to_secs $(( t_end - t_start )))" + STEPS_NAME+=("${name}") + STEPS_SECS+=("${t_secs}") + STEPS_RC+=("${rc}") + if [ "${rc}" -eq 0 ]; then + printf ' ✅ %s(%ss)\n' "${name}" "${t_secs}" + else + printf ' ❌ %s(%ss,退出码 %d)\n' "${name}" "${t_secs}" "${rc}" + FAILED=$((FAILED + 1)) + fi + return 0 +} + +# ---------------------------------------------------------------- 步骤 + +# ① 契约生成段漂移(加包 / 改包后**必须**同步契约表) +# +# 🔴 放在**第一位**:如果契约表与包不一致,后面 check-contract 会报一堆 +# 「契约 ↔ 代码漂移」,而真因只是「忘了跑 pack-sync」⇒ 先修这个省 8 秒排查。 +run_step "契约生成段同步(pack-sync --check)" \ + "${PY_BIN}" "${SCRIPTS}/pack-sync.py" --check + +# ② 编译(后面所有步骤都依赖它) +run_step "编译(cargo build --offline)" \ + cargo build --offline + +# ③ 静态闸门(6 把,纯静态、不起服务) +run_step "静态闸门 check-arch" bash "${SCRIPTS}/check-arch.sh" +run_step "静态闸门 check-boundary" bash "${SCRIPTS}/check-boundary.sh" +run_step "静态闸门 check-naming" bash "${SCRIPTS}/check-naming.sh" +run_step "静态闸门 check-module" bash "${SCRIPTS}/check-module.sh" +run_step "静态闸门 check-contract" bash "${SCRIPTS}/check-contract.sh" +run_step "静态闸门 check-citations" bash "${SCRIPTS}/check-citations.sh" + +# ④ 测试 +if [ "${MODE}" = "lib" ] || [ "${MODE}" = "full" ] || [ "${MODE}" = "smoke" ]; then + if [ "${MODE}" = "lib" ]; then + run_step "单测(cargo test --lib,不起库)" \ + cargo test --offline --workspace --lib + else + run_step "全量测试(cargo test --workspace)" \ + cargo test --offline --workspace + fi +fi + +# ⑤ 运行时尺子(要起后端,最慢;只有 --smoke 才跑) +if [ "${MODE}" = "smoke" ]; then + for s in perm-smoke perm-smoke-jnpf lowcode-smoke baseline-smoke mcp-smoke; do + if [ -f "${SCRIPTS}/${s}.sh" ]; then + run_step "运行时尺子 ${s}" bash "${SCRIPTS}/${s}.sh" + else + printf '\n▶ 运行时尺子 %s\n ⏭ 不存在,跳过\n' "${s}" + fi + done +fi + +# ---------------------------------------------------------------- 汇总 +T1="$(now)" +TOTAL="$(ns_to_secs $(( T1 - T0 )))" + +echo +echo "──────────────────────────────────────────" +printf '总耗时 %ss(模式 %s,%d 个步骤)\n' "${TOTAL}" "${MODE}" "${#STEPS_NAME[@]}" + +# 🔴 **Top 3 最慢** —— 「快验证」的成本结构必须可见, +# 否则没人知道该优化哪一道(本次就是靠它发现 check-contract 占 55s)。 +if [ "${#STEPS_NAME[@]}" -gt 0 ]; then + echo + echo "最慢的 3 步:" + # 用制表符把「名字 / 耗时」喂给 python 排序(bash 没有浮点排序) + for i in "${!STEPS_NAME[@]}"; do + printf '%s\t%s\n' "${STEPS_SECS[$i]}" "${STEPS_NAME[$i]}" + done | "${PY_BIN}" -c ' +import sys +rows = [] +for line in sys.stdin: + line = line.rstrip("\n") + if not line: + continue + secs, name = line.split("\t", 1) + rows.append((float(secs), name)) +for rank, (secs, name) in enumerate(sorted(rows, reverse=True)[:3], 1): + print(" %d. %-46s %ss" % (rank, name, secs)) +' +fi + +echo +if [ "${FAILED}" -eq 0 ]; then + echo "全 ✅ (${TOTAL}s)" + exit 0 +fi +echo "有 ${FAILED} 步失败,见上面的 ❌" +exit 1 diff --git a/src/backend/Cargo.toml b/src/backend/Cargo.toml index 6df1ad0..6625df3 100644 --- a/src/backend/Cargo.toml +++ b/src/backend/Cargo.toml @@ -46,5 +46,20 @@ sspf-mcp = { path = "../../crates/sspf-mcp" } # 低代码元数据引擎(纯计算:解析/校验/SQL 生成) sspf-lowcode = { path = "../../crates/sspf-lowcode" } +# 业务包装载器(L2 静态:读清单 / 校验 / 收集声明)—— 不认识 axum +sspf-plugin = { path = "../../crates/sspf-plugin" } + +# 🔴 业务包(只依赖 sspf-sdk)。 +# 内核**只允许**依赖 packs/ 这类业务包,且**不得**在平台层(platform/) +# 出现 `use sspf_pack_*` ⇒ 业务知识不许漏进平台层(check-arch.sh 的 AR9 钉住)。 +# +# ⚠️ 下面 `>>>GEN:PACK_DEPS` 段是**生成物**:`scripts/pack-sync.py` 按 `packs/*` +# 目录重写(crate 名取 `packs//Cargo.toml` 的 `[package].name`)。 +# 加包请跑 `bash scripts/new-pack.sh `;手改会在下次同步被覆盖, +# 且 `scripts/verify.sh` 第一步(`pack-sync.py --check`)会直接红。 +# >>>GEN:PACK_DEPS +sspf-pack-asset = { path = "../../packs/asset" } +# <<.rs`:列清单 + `EntitySpec` + `*_MENU` + 3 个 handler + `router()`; -//! 2. 在 [`crate::modules::ALL_SPECS`] / [`crate::modules::ALL_MENUS`] 各加一条; -//! 3. 业务表 DDL 加进 `db/schema.sql`。 -//! ⇒ **平台层一个字都不用改**,本文件也不用改。 +//! 🔴 **批次 12 的变化**(「框架固定包 + 业务模块链接就好」): +//! 本文件现在**也是业务包与内核之间的唯一接头**: +//! - **路由**:业务包声明 [`PackRoute`] ⇒ 本文件调 [`crate::platform::crud::crud_router`] +//! 生成真正的 axum 路由 ⇒ **平台层零改动**; +//! - **DDL**:业务包自带 `schema/*.sql`(`include_str!` 编译进二进制)⇒ +//! 本文件在启动时按包顺序幂等执行 ⇒ **不再手抄 `db/schema.sql`**。 +//! +//! 🔴 **「加一个业务包」的完整动作**(批次 12.5 之后): +//! +//! ```bash +//! bash scripts/new-pack.sh --name "中文名" --columns "a:VARCHAR(200)" +//! ``` +//! +//! ⇒ 一条命令生成 `packs//`(真源)+ `modules/.rs`(面 A 适配器), +//! 并自动跑 `scripts/pack-sync.py` 把**内核侧的四处派生位置**补齐 +//! (`packs_gen.rs` / `modules/mod.rs` / `Cargo.toml` / `contract.md`)。 +//! **本文件一行都不用改** —— 包的清单在 `crate::packs_gen`(生成的)。 + +use std::sync::OnceLock; + +use axum::Router; use crate::modules; use crate::platform::db::{pglite, Db}; use crate::platform::seed; +use crate::platform::state::AppState; +use sspf_plugin::PackRegistry; +use sspf_contract::route::PackRoute; + +/// 🔴 **业务包注册表**(进程级单例)—— 装载一次,之后到处复用。 +/// +/// 🔴 **为什么缓存**:装载器是**纯函数**(读的是内联的清单 JSON,不碰文件系统) +/// ⇒ 每次调都得到同样的结果 ⇒ 缓存只是省掉重复的字符串比较。 +/// 真正的价值是「**只装一次**」⇒ 装载失败时**全进程只报一次错**。 +static PACKS: OnceLock> = OnceLock::new(); + +/// 🔴 **业务包注册表**(装载 + 缓存)。 +/// +/// 🔴 **失败即「全进程不可用」** —— 业务包装载不过 ⇒ 它的端点不存在 +/// ⇒ 前端一访问就是 404 ⇒ **必须响亮地失败**,不能悄悄降级。 +/// `main.rs` 的 `run()` 在**开库之前**调它 ⇒ 失败直接 `exit 1`(见契约 §10 第 3 步)。 +pub fn packs() -> Result<&'static PackRegistry, &'static str> { + PACKS + .get_or_init(|| load_packs().map_err(|e| e.to_string())) + .as_ref() + .map_err(|s| s.as_str()) +} + + +/// 🔴 **内核版本**(业务包的 `kernel_req` 对它校验)。 +/// +/// 🔴 用 workspace 版本(`0.1.0`)—— 业务包的 `kernel_req` 写的是 `>=0.4,<0.5`, +/// 那是**契约版本**不是 cargo 版本 ⇒ 本批要把它对齐,见 [`kernel_version`]。 +const KERNEL_VERSION: &str = "0.1.0"; + +/// 🔴 **契约版本**(业务包 `kernel_req` 校验用的那个)。 +/// +/// 🔴 **为什么与 cargo 版本分开**:`pack.toml` 的 `kernel = ">=0.4,<0.5"` +/// 说的是「**平台契约**的版本区间」(信封形状 / 端点形状 / 列约定), +/// 不是 cargo 的 crate 版本 —— 两者会独立演进,混用会让「包能不能装」变成 +/// 一个跟发布节奏绑死的问题。 +const CONTRACT_VERSION: &str = "0.4.0"; + +/// 供业务包 `kernel_req` 校验的版本号(= 契约版本)。 +pub fn kernel_version() -> &'static str { + CONTRACT_VERSION +} /// 两段式种子的**第一段**(幂等,每次启动都跑)—— 平台层 + 业务层一起种。 /// @@ -27,3 +85,229 @@ use crate::platform::seed; pub async fn ensure_base(db: &Db) -> Result<(), pglite::Error> { seed::ensure_base(db, modules::all_menus()).await } + +/// 🔴 **装载全部业务包** —— 委托给**生成**的包清单 [`crate::packs_gen`]。 +/// +/// 🔴 **为什么本文件不再逐包手写**(批次 12.5): +/// 批次 12 时这里有一段 per-pack 样板:「`MANIFEST_JSON` 字面量 + `PackSource` +/// + `merge(vec![…])`」⇒ 加包要改内核。而其中**漏掉 `merge` 那一行是静默的**: +/// 包**装载成功**、没有一行日志,但 `entities` / `routes` 全丢 +/// ⇒ 面 B 端点 **404** ⇒ 前端只表现为「页面空着」。 +/// ⇒ 清单搬进 `packs_gen.rs`(由 `scripts/pack-sync.py` 从 `packs/*` 生成) +/// ⇒ 「加包要改内核」这件事在机制上消失。 +pub fn load_packs() -> Result { + crate::packs_gen::registry(kernel_version()) +} + +/// 🔴 **业务包声明的路由 ⇒ 真正的 axum 路由**(批次 12 交付物 ① 的落点)。 +/// +/// 🔴 **为什么放在装配根而不是平台层**: +/// 平台层(`platform/`)**不许出现业务知识**(红线 12 / 闸门 AR9) +/// ⇒ 包路由的装配必须在**唯一认识业务包的装配根**做。 +/// +/// 🔴 **为什么不用 `AppState` 装包声明**:`AppState` 有 30+ 个构造点 +/// (15 个集成测试文件 + 入口)⇒ 加字段会让每个测试都改一遍 +/// ⇒ 装载器是**纯函数**(无 IO、无副作用)⇒ 直接在装配时调一次即可。 +/// +/// - `reg`:装载好的业务包注册表。 +pub fn pack_router(reg: &PackRegistry) -> Router { + let mut router = Router::new(); + for spec in ®.entities { + let routes: Vec<&'static PackRoute> = + reg.routes.iter().filter(|r| r.entity == spec.entity).copied().collect(); + if routes.is_empty() { + continue; + } + router = router.merge(crate::platform::crud::crud_router(spec, &routes)); + } + router +} + +/// 🔴 **业务包的路由**(装配时用)—— 装载失败 ⇒ **返回空路由**。 +/// +/// 🔴 **为什么这里不 panic**:项目红线是「非测试代码零 `unwrap` / `expect` / `panic!`」 +/// (契约 §R2)。装载失败由 [`crate::main`] 的启动自检**响亮地拦住**(`exit 1`), +/// 这里只是**不让整个进程崩掉**(让启动自检有机会跑完并打印人话)。 +/// +/// 🔴 **为什么不能静默**:静默 ⇒ 路由少了 ⇒ 前端 404 ⇒ **看不出是装载失败**。 +/// ⇒ 启动自检必须先跑(见 `main.rs` 的第 3 步)。 +pub fn pack_router_or_empty() -> Router { + match packs() { + Ok(reg) => pack_router(reg), + Err(_) => Router::new(), + } +} + +/// 🔴 **执行全部业务包的 DDL**(批次 12 交付物 ③)—— 幂等。 +/// +/// 🔴 **幂等性**:包里的 DDL 写的是 `CREATE TABLE IF NOT EXISTS` +/// ⇒ 每次启动都跑一遍也安全 ⇒ 老库升级后新包的表会自动出现。 +/// +/// 🔴 **顺序**:按包的 `app_code` 排序([`PackRegistry::manifests`] 是 `BTreeMap`) +/// ⇒ **装载顺序确定** ⇒ 同一批包在任何机器上建表顺序一致。 +/// +/// 🔴 **不许碰 `base_*`** —— 装载器已在装载期拦过(`DdlTouchesBaseTable`)。 +pub async fn ensure_pack_schema(db: &Db, reg: &PackRegistry) -> Result<(), pglite::Error> { + for ddl in ®.ddls { + // 🔴 一条 DDL 一条语句 ⇒ 用 `exec`(simple protocol)。 + // 包里的 DDL 自己带 `IF NOT EXISTS` ⇒ 幂等。 + db.exec(ddl.sql).await?; + } + Ok(()) +} + +/// 🔴 **完整建库**(平台表 + 业务包的表)—— **运行期与测试期共用这一条**。 +/// +/// 🔴 **为什么要有这个函数**(批次 12 交付物 ③ 的「测试库 == 线上库」约定): +/// 建库现在有**两段**(① `schema.sql` 的平台表 ② 业务包自带的 DDL)。 +/// 测试与生产必须**走同一条路** ⇒ 否则测试里的库比线上少业务包建的表 +/// ⇒ 冒烟测到的东西不是上线的东西(**静默**降级)。 +/// ⇒ 两段打包成一个函数 ⇒ 生产(`main.rs`)与测试(23 个集成测试文件)都调它。 +/// +/// - `db`:库句柄。 +pub async fn ensure_schema_all(db: &Db) -> Result<(), pglite::Error> { + // ---- 第 1 段:平台表(`db/schema.sql`)---- + db.ensure_schema().await?; + // ---- 第 2 段:业务包的表(跟着包走)---- + if let Ok(reg) = packs() { + ensure_pack_schema(db, reg).await?; + } + Ok(()) +} + +/// 🔴 **内核版本常量**(给外部查询用)。 +pub fn version() -> &'static str { + KERNEL_VERSION +} + +#[cfg(test)] +mod tests { + use super::*; + use sspf_contract::route::HttpMethod; + + /// 🔴 **业务包必须能装载**(批次 12 的核心验证物)。 + /// + /// 一旦包装载不过 ⇒ 「放个目录进 `packs/`」这个承诺就是假的。 + /// + /// 🔴 **不写死条数**(批次 12.5):条数由 `packs/*` 的目录数决定, + /// 写死会让「加一个包」变成「先改测试」⇒ 假闸门。 + /// 改成**结构性断言**:每个实体都要有 DDL、有菜单、有 3 条路由。 + #[test] + fn every_pack_loads_with_entities_menus_routes_and_ddls() { + let reg = load_packs().expect("全部业务包必须装载成功"); + assert!(!reg.entities.is_empty(), "至少要装上一个包"); + assert!(!reg.manifests.is_empty(), "包清单不能为空(否则卸载/导出都无从下手)"); + + for spec in ®.entities { + assert!( + reg.ddls.iter().any(|d| d.table == spec.table), + "实体 {} 的表 {} 没有对应 DDL(表建不出来)", + spec.entity, + spec.table + ); + if let Some(key) = spec.module_key { + assert!( + reg.menus.iter().any(|m| m.url_address == key), + "实体 {} 的 module_key={} 没有对应菜单 ⇒ 守卫查不到菜单 ⇒ 静默放行", + spec.entity, + key + ); + } + } + // 每个实体恰好 3 条路由(List / Save / Delete)。 + assert_eq!( + reg.routes.len(), + reg.entities.len() * 3, + "每条实体应有 3 条路由(漏一条 ⇒ 某个动作静默 404)" + ); + + // 🔴 asset 是基准包:它的存在性是真断言,不是计数。 + assert!( + reg.ddls.iter().any(|d| d.table == "asset_data_resource"), + "asset 包必须在(基准包)" + ); + } + + /// 🔴 **包声明的路由必须是官方形状**(面 B),且方法与动作对应。 + #[test] + fn pack_routes_are_official_shape() { + let reg = load_packs().expect("asset 包必须装载成功"); + for r in ®.routes { + assert!(r.path.starts_with("/api/"), "必须是官方形状: {}", r.path); + assert!( + !r.path.starts_with("/api/ssw/"), + "不许用面 A 的 /api/ssw/...: {}", + r.path + ); + } + let list = reg + .routes + .iter() + .find(|r| r.method == HttpMethod::Get) + .expect("必须有 GET 路由"); + // 🔴 按**路径存在性**断言,不假设「第一条就是 asset」(包的装载顺序会变)。 + assert!( + reg.routes.iter().any(|r| r.path == "/api/asset/DataResource"), + "asset 的列表路由必须在(基准包);实际首条 GET 是 {}", + list.path + ); + } + + /// 🔴 **包的路由必须是官方 RESTful 形状**(不是「官方前缀 + ssw 动作后缀」)。 + /// + /// 🔴 实测官方源码(`jnpf-java-boot` 全部 controller): + /// `/xxx/List` GET 52 + POST 21(碰巧存在)、`/xxx/Save` **仅 4 条** + /// (低代码/打印/AI 特例)、`/xxx/Delete` **0 条**(不存在)。 + /// ⇒ CRUD 通用形状是 RESTful ⇒ 用后缀 = 集成时必然改路径。 + #[test] + fn pack_routes_use_official_restful_shape() { + let reg = load_packs().expect("asset 包必须装载成功"); + for r in ®.routes { + assert!( + !r.path.ends_with("/Save"), + "官方没有 /Save CRUD 端点: {}", + r.path + ); + assert!( + !r.path.ends_with("/Delete"), + "官方没有 /Delete 端点: {}", + r.path + ); + } + let del = reg + .routes + .iter() + .find(|r| r.method == HttpMethod::Delete) + .expect("必须有删除路由"); + assert!(del.path.contains("{id}"), "删除路由必须带 {{id}}: {}", del.path); + } + + /// 🔴 **包路由生成的 axum 路由条数 = 声明条数** —— 少一条就是漏注册。 + #[test] + fn pack_router_registers_all_declared_routes() { + let reg = load_packs().expect("全部业务包必须装载成功"); + // 🔴 生成路由不 panic = 路径合法(axum 遇到非法路径会 panic)。 + let _router = pack_router(®); + // 🔴 不写死 3:路由条数跟着包走(每条实体 3 条)。 + assert_eq!(reg.routes.len(), reg.entities.len() * 3); + } + + /// 🔴 **包的 DDL 必须含 `f_tenant_id`** —— 官方 `base_*` 表全部带它, + /// 参与复合主键 `(f_id, f_tenant_id)` ⇒ 缺这列导不进官方。 + #[test] + fn pack_ddls_carry_tenant_id_and_composite_key() { + let reg = load_packs().expect("全部业务包必须装载成功"); + for ddl in ®.ddls { + assert!( + ddl.sql.contains("f_tenant_id"), + "{} 的 DDL 缺 f_tenant_id(集成时导不进官方)", + ddl.table + ); + assert!( + ddl.sql.contains("PRIMARY KEY (f_id, f_tenant_id)"), + "{} 的主键必须是 (f_id, f_tenant_id)", + ddl.table + ); + } + } +} diff --git a/src/backend/src/lib.rs b/src/backend/src/lib.rs index c02650f..c5c254f 100644 --- a/src/backend/src/lib.rs +++ b/src/backend/src/lib.rs @@ -19,5 +19,8 @@ pub mod lowcode_ddl; pub mod lowcode_seed; pub mod mcp_adapter; pub mod modules; +// 🔴 **本文件是 `scripts/pack-sync.py` 生成的**(业务包清单 + `pack.toml` 快照) +// ⇒ 不要手改;加包跑 `bash scripts/new-pack.sh`。 +pub mod packs_gen; pub mod platform; pub mod routes; diff --git a/src/backend/src/main.rs b/src/backend/src/main.rs index f124437..6695480 100644 --- a/src/backend/src/main.rs +++ b/src/backend/src/main.rs @@ -489,9 +489,17 @@ async fn run(mode: RunMode) -> Result<(), String> { return Err(format!("标识符白名单自检未通过: {msg}")); } + // ---- 第 3b 步:业务包装载自检(**开库之前**)---- + // + // 🔴 **为什么放在开库之前**:包装载失败 ⇒ 它的端点不存在 ⇒ 前端一访问就 404 + // ⇒ **必须响亮地失败**,不能悄悄降级(少几条路由比整个服务起不来更难查)。 + // 与第 3 步的白名单自检同一处置:打印人话 + `exit 1`。 + bootstrap::packs().map_err(|msg| format!("业务包装载失败: {msg}"))?; + // ---- 第 4 步:开库 + 建表 ---- let db = open_db(&config).await.map_err(|e| format!("打开数据库失败: {e}"))?; - db.ensure_schema() + // 🔴 **平台表 + 业务包的表**(同一套装配,测试也走这一条 ⇒ 测试库 == 线上库)。 + bootstrap::ensure_schema_all(&db) .await .map_err(|e| format!("初始化表结构失败: {e}"))?; @@ -756,29 +764,45 @@ fn whitelist_self_check() -> Result<(), String> { } } - // ---- 与 DDL 对账(`db/schema.sql` 是数据模型真源)---- + // ---- 与 DDL 对账(**DDL = base 表 + 业务层 spec 表 + 业务包的表**)---- // // 🔴 **为什么不用「写死的表名清单」**:那张清单里若含业务表名 ⇒ // 加业务模块要改入口文件 ⇒ 违反红线 12。 - // 改为「清单 = 7 张 base_* + 业务层 spec 派生的表」, + // 改为「清单 = 7 张 base_* + 业务层 spec 派生的表 + **业务包自带的表**」, // 再与 DDL **双向**对账 ⇒ 下面三类错都抓得到: // ① spec 表名拼错(合法标识符但 DDL 里没有)⇒ 启动失败; // ② DDL 里有表但没有任何 spec 声明它 ⇒ 启动失败(孤儿 DDL); // ③ DDL 缺表(spec 声明了但没建表)⇒ 启动失败。 + // + // 🔴 **批次 12 的变化**:业务包的表**不在 `db/schema.sql` 里**(DDL 跟着包走, + // 编译进二进制)⇒ 对账的「全部表」= `db/schema.sql` 的表 **∪ 业务包的表**。 + // 只对 `db/schema.sql` 对账会把包表判成「孤儿 DDL」⇒ 启动失败。 let spec_tables: Vec<&str> = modules::all_specs().iter().map(|s| s.table).collect(); + let pack_tables: Vec<&str> = bootstrap::packs() + .map(|reg| reg.entities.iter().map(|s| s.table).collect()) + .unwrap_or_default(); let ddl_tables = ssw_platform::platform::db::ddl_tables(); for table in &ddl_tables { - if !BASE_TABLES.contains(&table.as_str()) && !spec_tables.contains(&table.as_str()) { + if !BASE_TABLES.contains(&table.as_str()) + && !spec_tables.contains(&table.as_str()) + && !pack_tables.contains(&table.as_str()) + { return Err(format!( "schema.sql 里的表 {table} 既不是 base_* 表、也没有对应的业务 spec(孤儿 DDL?)" )); } } - for table in &spec_tables { - if !ddl_tables.iter().any(|t| t == table) { + for table in spec_tables.iter().chain(pack_tables.iter()) { + // 🔴 **业务包的表不在 `db/schema.sql` 里**(DDL 跟着包走)⇒ + // 查「建表语句在哪」时,包表要查**包自己的 DDL**,不是 schema.sql。 + let in_schema = ddl_tables.iter().any(|t| t == table); + let in_pack = bootstrap::packs() + .map(|reg| reg.ddls.iter().any(|d| d.table == *table)) + .unwrap_or(false); + if !in_schema && !in_pack { return Err(format!( - "spec 表 {table} 在 db/schema.sql 里没有 CREATE TABLE(漏建表?)" + "spec 表 {table} 既不在 db/schema.sql 里、也不在任何业务包的 DDL 里(漏建表?)" )); } } diff --git a/src/backend/src/modules/asset.rs b/src/backend/src/modules/asset.rs index 3c7ed98..298442d 100644 --- a/src/backend/src/modules/asset.rs +++ b/src/backend/src/modules/asset.rs @@ -1,14 +1,25 @@ //! asset —— 业务模块:DataResource(物理表 `asset_data_resource`)。 //! -//! 🔴 **尚数网的第一个真实业务模块**(不是脚手架示例):字段取自公司本体 -//! `DataResource`(`数据资源`)—— 官方定义 ∈ `mcp__shangshu-ontology__get_object_types`: -//! 名称 / 类别 / 应用场景 / 提供方 / 格式 / 规模 / 来源 / 登记时间。 -//! **列名与列序逐字对齐本体** ⇒ 后续接本体平台时可直接映射,不用改表。 +//! 🔴 **本文件是「spec 的转发点」,不是 spec 的家**(批次 12 交付物 ②): +//! 真正的 spec 在 `packs/asset/src/lib.rs`(业务包,**只依赖 sspf-sdk**), +//! 本文件只做 `pub use` 转发 ⇒ **spec 只有一份**。 //! -//! 行为模板:`modules/shop.rs`(同形状:spec + 菜单 + 3 handler + 路由)。 -//! **平台层(`platform/`)一个字都不用改。** +//! 🔴 **为什么这么改**(原来的问题是「两份逐字拷贝」): +//! 改一处忘另一处 ⇒ **静默**不一致(而且没有任何闸门比对它们 —— +//! `packs/asset` 的注释写着「PACK1 会比对」,但 PACK1 **至今没实现**)。 +//! ⇒ 现在:spec 在包里 ⇒ 改 spec 只改一处 ⇒ PACK1 闸门校验「模块文件只许 re-export」。 //! -//! 🔴 本模块的守卫:菜单 `asset/DataResource`(`module_key`)⇒ 非管理员未授权 ⇒ `code=403`。 +//! 🔴 **【集成期友好性】面 A 与面 B 各住一处**(批次 12 交付物 ①): +//! - **本文件 = 面 A**(`/api/ssw/asset/DataResource/…`)—— 本仓自造的 ssw 约定, +//! **留给 Rust 终端场景**,**一个字都不改**; +//! - **业务包 = 面 B**(`/api/asset/DataResource/…`)—— 官方 JNPF 形状, +//! 集成到官方 Java 时**能直接搬**(`MIGRATION.md` §2.3 的逐条对照表)。 +//! +//! 🔴 **两套路由不冲突**(路径不同)⇒ 面 A 的前端零改、面 B 的集成期零改。 +//! +//! 🔴 **业务 DDL 跟着包走**(批次 12 交付物 ③):`asset_data_resource` 的建表语句 +//! 在 `packs/asset/schema/001_init.sql`,**编译进二进制**(`include_str!`), +//! 不再手抄进 `db/schema.sql`。 use axum::body::Bytes; use axum::extract::{RawQuery, State}; @@ -17,119 +28,18 @@ use axum::routing::{delete, get, post}; use axum::{Json, Router}; use crate::platform::crud::{handle_delete, handle_list, handle_save}; -use crate::platform::entity::{ColumnSpec, EntitySpec}; use crate::platform::envelope::ActionResult; -use crate::platform::menu::MenuSpec; use crate::platform::state::AppState; -use crate::platform::system; -/// `asset_data_resource` 的列清单(**顺序 = 响应 JSON 的键序**)。 -const DATA_RESOURCE_COLUMNS: &[ColumnSpec] = &[ - ColumnSpec { - column: "f_id", - json_key: "id", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_name", - json_key: "name", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_category", - json_key: "category", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_scenario", - json_key: "scenario", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_provider", - json_key: "provider", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_format", - json_key: "format", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_scale", - json_key: "scale", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_source", - json_key: "source", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_register_time", - json_key: "registerTime", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_creator_user_id", - json_key: "creatorUserId", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_creator_time", - json_key: "creatorTime", - default: None, - numeric: false, - }, - ColumnSpec { - column: "f_delete_mark", - json_key: "deleteMark", - default: Some("0"), - numeric: false, - }, -]; +// 🔴 **spec 与菜单的单一真源 = 业务包** —— 这里只转发,不重写。 +pub use sspf_pack_asset::DATA_RESOURCE_MENU; +pub use sspf_pack_asset::DATA_RESOURCE_SPEC; -/// `asset_data_resource` 的 spec。 -pub const DATA_RESOURCE_SPEC: EntitySpec = EntitySpec { - app_code: "asset", - entity: "DataResource", - table: "asset_data_resource", - module_key: Some("asset/DataResource"), - columns: DATA_RESOURCE_COLUMNS, - // 🔴 本体 `数据资源` 没有金额/计量字段 ⇒ 本模块**无 numeric 列**。 - numeric_columns: &[], - // 裁决 S22:非 demo 表 ⇒ `body.creatorUserId || 'admin'`。 - creator_fixed: None, -}; - -/// 🔴 **本模块的内置菜单** —— 业务知识 ⇒ 住在**业务层**。 +/// 本模块的 3 条路由(**面 A**:业务层的路由表)—— 钉子测试遍历它。 /// -/// 🔴 **`url_address` 必须与 [`DATA_RESOURCE_SPEC`] 的 `module_key` 一字不差** -/// (都是 `asset/DataResource`)—— 面 A 的菜单守卫靠它命中。 -pub const DATA_RESOURCE_MENU: MenuSpec = MenuSpec { - id: "m_resource", - full_name: "数据资源", - // 🔴 本仓自定编码(官方 JNPF 无此模块)⇒ 面 B 的点权限判据 `f_en_code`。 - en_code: "permission.asset.dataResource", - url_address: "asset/DataResource", - parent_id: "0", - menu_type: 2, - icon: Some("app"), - sort_code: 9, - system_en_code: system::MAIN_SYSTEM_CODE, -}; - -/// 本模块的 3 条路由(**业务层的路由表**)—— 钉子测试遍历它。 +/// 🔴 路径是**面 A 的 ssw 形状**(`/api/ssw/{appCode}/{Entity}/{动作}`)—— +/// 业务包声明的**面 B**(官方形状)在 `packs/asset/src/lib.rs`, +/// 由内核按声明生成(见 `bootstrap::pack_router`)。 pub const ROUTES: [&str; 3] = [ "/api/ssw/asset/DataResource/List", "/api/ssw/asset/DataResource/Save", @@ -162,7 +72,7 @@ pub async fn data_resource_delete( handle_delete(&state, &headers, &DATA_RESOURCE_SPEC, &raw).await } -/// 本模块的路由(`Router::merge` 进总路由)。 +/// 本模块的路由(**面 A**,`Router::merge` 进总路由)。 /// /// 🔴 路径在这里写**字面量**(不用 `ROUTES[0]`)—— 契约扫描器 /// `scripts/check-contract-scan.py` 是静态解析,认不出数组下标 ⇒ diff --git a/src/backend/src/modules/mod.rs b/src/backend/src/modules/mod.rs index cb19e60..88e75b9 100644 --- a/src/backend/src/modules/mod.rs +++ b/src/backend/src/modules/mod.rs @@ -1,9 +1,21 @@ -//! modules —— **业务层**:四个业务模块(demo / shop / books / asset)+ spec 登记表。 +//! modules —— **业务层**:业务模块 + spec / 菜单 / 路由的**登记表**。 //! -//! 🔴 **加一个业务模块只碰本目录**(平台层 `platform/` 一行都不用改): -//! 1. 照抄 `demo.rs` 建 `modules/.rs`:列清单 + `EntitySpec` + 3 个 handler + `router()`; -//! 2. 在本文件的 [`router()`] 里 merge 一行、在 [`ALL_SPECS`] 里加一条; -//! 3. 业务表 DDL 加进 `db/schema.sql`(react 侧靠 TypeORM `synchronize` 自动建表,**rust 没有**)。 +//! 🔴 **加一个业务模块只碰本目录,而且不用手改本文件**(批次 12.5): +//! +//! ```bash +//! bash scripts/new-pack.sh --name "中文名" --columns "a:VARCHAR(200)" +//! ``` +//! +//! 它会建 `packs//`(真源)+ 本目录的 `.rs`(面 A 适配器), +//! 然后跑 `scripts/pack-sync.py` 把下面的**生成段**补齐。 +//! +//! 🔴 **`// >>>GEN:xxx` 与 `// <<>>GEN:MODS +// 每个模块一行:**文件即登记**(顺序 = 文件名字典序,不代表业务顺序)。 pub mod asset; pub mod books; pub mod demo; pub mod shop; +// <<>>GEN:SPECS +/// 全部业务实体 spec。 +/// +/// 🔴 **本段由 `scripts/pack-sync.py` 生成** —— 加模块不用手改(见文件头)。 pub const ALL_SPECS: &[EntitySpec] = &[ + asset::DATA_RESOURCE_SPEC, + books::BOOK_SPEC, demo::DEMO_SPEC, shop::PRODUCT_SPEC, - books::BOOK_SPEC, - asset::DATA_RESOURCE_SPEC, ]; +// <<>>GEN:ROUTES +/// **全部业务路由**(面 A:`/api/ssw/{appCode}/{Entity}/{动作}`,每模块 3 条)。 /// -/// 🔴 **业务路由清单住在业务层** ⇒ 平台层(`routes.rs`)不认业务路径 -/// ⇒ 加业务模块**不用改平台层**(平台层只 merge 一次 [`router()`])。 +/// 🔴 **与 `ALL_SPECS` 同序**(同一份模块清单生成)⇒ 可以按 3 条一组配对。 pub const ALL_ROUTES: &[&str] = &[ + asset::ROUTES[0], + asset::ROUTES[1], + asset::ROUTES[2], + books::ROUTES[0], + books::ROUTES[1], + books::ROUTES[2], demo::ROUTES[0], demo::ROUTES[1], demo::ROUTES[2], shop::ROUTES[0], shop::ROUTES[1], shop::ROUTES[2], - books::ROUTES[0], - books::ROUTES[1], - books::ROUTES[2], - asset::ROUTES[0], - asset::ROUTES[1], - asset::ROUTES[2], ]; +// <<>>GEN:MENUS +/// 全部业务内置菜单(由**装配根** [`crate::bootstrap`] 传给平台层的种子 +/// ⇒ **平台层不认任何业务菜单**,红线 12)。 pub const ALL_MENUS: &[MenuSpec] = &[ + asset::DATA_RESOURCE_MENU, + books::BOOK_MENU, demo::DEMO_MENU, shop::PRODUCT_MENU, - books::BOOK_MENU, - asset::DATA_RESOURCE_MENU, ]; +// << &'static [EntitySpec] { ALL_SPECS } -/// 全部业务内置菜单。 +/// 全部业务内置菜单(由**装配根** [`crate::bootstrap`] 传给平台层的种子 +/// ⇒ **平台层不认任何业务菜单**,红线 12)。 pub fn all_menus() -> &'static [MenuSpec] { ALL_MENUS } @@ -79,26 +99,31 @@ pub fn find_spec(app_code: &str, entity: &str) -> Option<&'static EntitySpec> { .find(|s| s.app_code == app_code && s.entity == entity) } +// >>>GEN:ROUTER /// **全部业务模块的路由**(`Router::merge` 进总路由)。 /// -/// 🔴 加业务模块 ⇒ 在这里 merge 一行(**业务目录内**,平台层不动)。 +/// 🔴 加业务模块 ⇒ **不用改这里**(本段由 `pack-sync.py` 生成)。 pub fn router() -> Router { - demo::router() - .merge(shop::router()) + asset::router() .merge(books::router()) - .merge(asset::router()) + .merge(demo::router()) + .merge(shop::router()) } +// <<= 4, "至少要保住 demo/shop/books/asset 四个模块"); for (i, s) in specs.iter().enumerate() { for other in &specs[i + 1..] { assert!( @@ -149,15 +174,22 @@ mod tests { } } - /// 契约 §5.3 的三张表列清单(**逐字**):列名与列序。 + /// 契约 §5.3 的四张基准表列清单(**逐字**):列名与列序。 + /// + /// 🔴 **按 (app, entity) 查找,不按数组下标 zip** —— 生成段的顺序随 + /// `modules/*.rs` 文件名变化 ⇒ 用下标取值是「顺序一变就假失败」。 #[test] fn column_sets_match_contract_5_3() { - let names = |spec: &EntitySpec| -> Vec<&str> { - spec.columns.iter().map(|c| c.column).collect() + let names = |app: &str, ent: &str| -> Vec<&str> { + find_spec(app, ent) + .expect("基准模块必须在") + .columns + .iter() + .map(|c| c.column) + .collect() }; - let demo = find_spec("demo", "DemoItem").expect("demo spec"); assert_eq!( - names(demo), + names("demo", "DemoItem"), vec![ "f_id", "f_title", @@ -167,9 +199,8 @@ mod tests { "f_delete_mark" ] ); - let product = find_spec("shop", "Product").expect("shop spec"); assert_eq!( - names(product), + names("shop", "Product"), vec![ "f_id", "f_title", @@ -179,9 +210,8 @@ mod tests { "f_delete_mark" ] ); - let book = find_spec("books", "Book").expect("books spec"); assert_eq!( - names(book), + names("books", "Book"), vec![ "f_id", "f_title", @@ -195,10 +225,12 @@ mod tests { "f_delete_mark" ] ); - // 🔴 asset:列序**逐字对齐公司本体 `DataResource`**(数据资源)。 - let resource = find_spec("asset", "DataResource").expect("asset spec"); + // 🔴 asset:列序**逐字对齐公司本体 `DataResource`**(数据资源), + // 末尾多一列 `f_tenant_id` —— 官方 `base_*` 表全部带它 + // (`DEFAULT '0' NOT NULL`,参与复合主键 `(f_id, f_tenant_id)`) + // ⇒ **单租户也不许省**(集成时缺这一列 ⇒ 导不进官方)。 assert_eq!( - names(resource), + names("asset", "DataResource"), vec![ "f_id", "f_name", @@ -211,12 +243,13 @@ mod tests { "f_register_time", "f_creator_user_id", "f_creator_time", - "f_delete_mark" + "f_delete_mark", + "f_tenant_id" ] ); } - /// 守卫 key:demo 仅登录,其余三个有菜单守卫。 + /// 守卫 key:demo 仅登录,其余基准三个有菜单守卫。 #[test] fn module_keys_are_as_specified() { assert_eq!(find_spec("demo", "DemoItem").unwrap().module_key, None); @@ -266,28 +299,18 @@ mod tests { /// 🔴 **业务路由的形状钉死** —— 每条必须是 `/api/ssw/{app_code}/{entity}/{List|Save|Delete}`。 /// - /// 🔴 **业务路由清单住在业务层** ⇒ 平台层的钉子测试遍历 [`ALL_ROUTES`], - /// 加业务模块**不用改平台层** ⇒ 这里的形状约束就是唯一的守门人。 + /// 🔴 **`ALL_ROUTES` 与 `ALL_SPECS` 同序**(两段都由 `pack-sync.py` 按同一份 + /// 模块清单生成)⇒ 可以按 3 条一组配对。这个「同序」由本测试兜住: + /// 一旦有人手改生成段导致错位,下面的路径断言立刻红。 #[test] fn business_routes_follow_the_contract_shape() { - // 每个模块的 3 条路由 + 汇总表必须一致(不重不漏)。 - let per_module: Vec<&str> = demo::ROUTES - .iter() - .chain(shop::ROUTES.iter()) - .chain(books::ROUTES.iter()) - .chain(asset::ROUTES.iter()) - .copied() - .collect(); assert_eq!( - per_module, ALL_ROUTES.to_vec(), - "ALL_ROUTES 必须等于各模块 ROUTES 的顺序拼接" + ALL_ROUTES.len(), + ALL_SPECS.len() * 3, + "每个模块 3 条路由;ALL_ROUTES 与 ALL_SPECS 必须同序(生成段不许手改)" ); - for (spec, routes) in ALL_SPECS - .iter() - .zip([demo::ROUTES, shop::ROUTES, books::ROUTES, asset::ROUTES]) - { - assert_eq!(routes.len(), 3, "{} 必须有 3 条路由", spec.entity); + for (spec, routes) in ALL_SPECS.iter().zip(ALL_ROUTES.chunks(3)) { for (path, action) in routes.iter().zip(["List", "Save", "Delete"]) { let expected = format!("/api/ssw/{}/{}/{}", spec.app_code, spec.entity, action); assert_eq!( @@ -304,17 +327,29 @@ mod tests { /// 🔴 三处必须一致:① 菜单的 `f_url_address` ② spec 的 `module_key` /// ③ 前端 `` —— 任一不一致 ⇒ 菜单显示了但守卫不命中 /// (或反过来)⇒ **静默**失败。 + /// + /// 🔴 **按 `url_address` 查找,不按数组下标配对** —— 菜单与 spec 是两份声明, + /// 用下标配对相当于假设「每个模块恰好 1 个实体 + 1 个菜单」。 #[test] - fn menu_url_matches_module_key() { - for (spec, menu) in ALL_SPECS.iter().zip(ALL_MENUS.iter()) { - if let Some(key) = spec.module_key { - assert_eq!( - Some(menu.url_address), - Some(key), - "{} 的菜单 url_address 与 module_key 不一致", - spec.entity - ); - } + fn every_spec_with_module_key_has_a_matching_menu() { + for spec in all_specs() { + let Some(key) = spec.module_key else { + continue; // 仅需登录的模块(demo)没有菜单守卫 + }; + let menu = all_menus() + .iter() + .find(|m| m.url_address == key) + .unwrap_or_else(|| { + panic!( + "{} 的 module_key 是 {},但没有菜单的 url_address 等于它", + spec.entity, key + ) + }); + assert!( + !menu.en_code.trim().is_empty(), + "菜单 {} 的 f_en_code 不能为空(面 B 的点权限判据靠它)", + menu.id + ); } } @@ -326,15 +361,10 @@ mod tests { assert_ne!(m.id, other.id, "菜单 id 重复: {}", m.id); assert_ne!( m.url_address, other.url_address, - "菜单 url_address 重复: {}", m.url_address + "菜单 url_address 重复: {}", + m.url_address ); } } } - - /// 🔴 **菜单数 = 业务模块数** —— 加一个业务模块时,两处必须同时加。 - #[test] - fn menu_count_matches_spec_count() { - assert_eq!(ALL_MENUS.len(), ALL_SPECS.len()); - } } diff --git a/src/backend/src/packs_gen.rs b/src/backend/src/packs_gen.rs new file mode 100644 index 0000000..9132627 --- /dev/null +++ b/src/backend/src/packs_gen.rs @@ -0,0 +1,60 @@ +//! ⚠️ **本文件由 `scripts/pack-sync.py` 生成 —— 不许手改。** +//! +//! 它是内核的**业务包清单**:每个包一条 [`sspf_plugin::load_static`] +//! 调用 + 一份 `pack.toml` 的 JSON 快照。 +//! +//! 🔴 **为什么是生成的**:批次 12 时这段在 `bootstrap.rs` 里手写 —— +//! 每加一个包要抄「manifest JSON + `PackSource` + `merge(vec![…])`」三段。 +//! 漏掉最后那段 `merge` 的表现是:包**装载成功**、没有报错, +//! 但 `entities` / `routes` 全丢 ⇒ **面 B 端点静默 404**。 +//! ⇒ 改成生成 ⇒ 「漏一处」在机制上不存在;真忘了跑生成, +//! `scripts/verify.sh` 的第一步(`pack-sync.py --check`)会红。 +//! +//! 🔴 **`packs/` 是唯一真源** —— 加包跑 `bash scripts/new-pack.sh`, +//! 改完 `packs/*` 跑 `python3 scripts/pack-sync.py`。 + +use sspf_plugin::{LoadError, PackRegistry}; + +/// 装载 `packs/*` 下的**全部**业务包(顺序 = `app_code` 字典序)。 +/// +/// 🔴 任一包装载失败 ⇒ **整体失败**(半加载的包比不加载更危险): +/// 半加载的包 = 一部分路由在、一部分不在 ⇒ 前端表现为「有的页面能用」。 +pub fn registry(kernel_version: &str) -> Result { + let mut regs: Vec = Vec::new(); + + // ---- asset ---- + regs.push(sspf_plugin::load_static( + "asset", + ASSET_MANIFEST_JSON, + Box::new(sspf_pack_asset::Pack), + sspf_pack_asset::DDLS, + kernel_version, + )?); + + Ok(sspf_plugin::merge(regs)) +} + +// ---------------------------------------------------------------- 清单快照 +// +// 🔴 `pack.toml` 的**权威副本**在 `packs//pack.toml`(给人看、给导出工具读); +// 这里是它的**编译期 JSON 快照**。为什么要快照、不运行期读文件: +// 内核是**单二进制部署** ⇒ 运行目录里不一定有 `packs/` 目录。 +// 两份的一致性由 `scripts/pack-sync.py` 保证(`--check` 会比对)。 + +/// `packs/asset/pack.toml` 的编译期快照。 +const ASSET_MANIFEST_JSON: &str = r#"{ + "pack": { + "app_code": "asset", + "name": "数据资源", + "version": "1.0.0", + "kernel": ">=0.4,<0.5", + "migratable": true, + "tables": [ + { + "name": "asset_data_resource", + "ddl": "schema/001_init.sql", + "baseline_table": "asset_data_resource" + } + ] + } +}"#; diff --git a/src/backend/src/platform/crud.rs b/src/backend/src/platform/crud.rs index d58d119..3957802 100644 --- a/src/backend/src/platform/crud.rs +++ b/src/backend/src/platform/crud.rs @@ -39,18 +39,22 @@ //! 依据是契约的通用规则「非法 JSON ⇒ 请求参数格式错误」;契约未覆盖 0 字节 body。 use axum::body::Bytes; -use axum::extract::RawQuery; +use axum::extract::{RawQuery, State}; use axum::http::HeaderMap; -use axum::Json; +use axum::routing::{delete, get, post}; +use axum::{Json, Router}; use serde_json::{Map, Value}; -use crate::platform::auth::{require_login, require_module}; +use crate::platform::auth::{require_login, require_login_face_b, require_module}; use crate::platform::db::{self, pglite, pglite::ToSql, Db}; -use crate::platform::envelope::{fail, ok, ActionResult}; +use crate::platform::envelope::{code, fail, ok, ActionResult}; use crate::platform::entity::{ColumnSpec, EntitySpec}; use crate::platform::ids::new_uuid; +use crate::platform::permission::has_en_code_permission; +use crate::platform::route::{HttpMethod, PackRoute, RouteAction, RouteGuard}; use crate::platform::session::TokenUser; use crate::platform::state::AppState; +use crate::platform::system; /// `f_creator_user_id` 的兜底账号(**账号字符串,不是 uuid**)。 /// @@ -439,6 +443,53 @@ async fn guard( } } +// ---------------------------------------------------------------- 面 B 守卫(业务包路由) +// +// 🔴 **为什么业务包路由要用另一套守卫**(批次 12 交付物 ① 的第 2 条修正): +// 业务包声明的路由是**面 B**(官方 JNPF 形状)⇒ **官方前端会直接调它** +// ⇒ 它的守卫**必须**是面 B 的判据,**不是**面 A 的: +// +// | | 面 A(`/api/ssw/...`) | 面 B(`/api/{模块}/{资源}`) | +// |---|---|---| +// | 判据 | 菜单路径 `f_url_address` | 点权限 `f_en_code` | +// | 官方对应 | `SswPermissionGuard.requireMenu(...)` | `@SaCheckPermission("xxx.yyy")` | +// | 未登录码 | **600** | **602**(官方前端只在 601/602 清 token) | +// +// 🔴 **602 这条是硬要求**(`MIGRATION.md` §2.5):官方前端 +// `request.ts:78-80` 只对 `601`/`602` 清 token ⇒ 只返 600 会让页面**卡住不跳登录**。 +// ⇒ 面 A 保持 600、面 B 返 602 —— **两套并存**(与判据一样并存)。 + +/// 面 B 的守卫:**登录(602)** + **点权限(`f_en_code` ⇒ 403)**。 +/// +/// 🔴 与 [`face_b`] 模块里的同名函数**同义**(逐字同构)—— 官方 +/// `@SaCheckPermission("xxx")` 的判据就是 `base_module.f_en_code`。 +async fn guard_face_b( + state: &AppState, + headers: &HeaderMap, + en_code: &str, +) -> Result> { + let user = require_login_face_b(state, headers).await?; + let system_id = + system::resolve_system_id(&state.db, system::app_code_of(headers).as_deref()).await; + if has_en_code_permission(&state.db, &user.user_id, user.is_admin, en_code, &system_id).await { + Ok(user) + } else { + Err(fail(code::NO_PERMISSION, "无权限")) + } +} + +/// 业务包路由的守卫(按声明的 [`RouteGuard`] 分派)。 +async fn guard_pack( + state: &AppState, + headers: &HeaderMap, + guard: RouteGuard, +) -> Result> { + match guard { + RouteGuard::Login => require_login_face_b(state, headers).await, + RouteGuard::EnCode(en_code) => guard_face_b(state, headers, en_code).await, + } +} + /// List 的通用实现。 pub(crate) async fn handle_list( state: &AppState, @@ -492,11 +543,239 @@ pub(crate) async fn handle_delete( } } +// ---------------------------------------------------------------- 面 B 的业务包 handler +// +// 🔴 **为什么业务包路由的响应形状与面 A 不同**: +// 官方 `ActionResult.page(list, pagination)` ⇒ `data` 是 **`PageListVO`** +// (`{pagination:{currentPage,pageSize,total}, list:[…]}`), +// **不是**裸数组(面 A 才是裸数组)。 +// ⇒ 官方前端拿到裸数组 ⇒ 读 `res.data.list` 是 `undefined` ⇒ **静默**空表格。 +// ⇒ 这就是「官方前端能直连本仓」的那条承诺里最容易被忽略的一格。 +// +// 🔴 **分页参数**:官方 `Pagination.java` 默认 `currentPage=1` / `pageSize=20`, +// 夹逼 `[1, 1000]`(与 [`face_b::Paging`] 同口径)。 + +/// 取分页参数(官方 `Pagination` 默认值 + 夹逼)。 +struct PackPaging { + current_page: i64, + page_size: i64, + offset: i64, +} + +impl PackPaging { + fn of(raw: &RawQuery) -> Self { + let current_page = crate::platform::sys::query_param(raw, "currentPage") + .trim() + .parse::() + .unwrap_or(1) + .max(1); + let page_size = crate::platform::sys::query_param(raw, "pageSize") + .trim() + .parse::() + .unwrap_or(20) + .clamp(1, 1000); + Self { + current_page, + page_size, + offset: (current_page - 1) * page_size, + } + } +} + +/// 官方 `PageListVO` —— `{pagination:{currentPage,pageSize,total}, list:[…]}`。 +fn pack_page_list(current_page: i64, page_size: i64, total: i64, list: Vec) -> Value { + serde_json::json!({ + "pagination": { + "currentPage": current_page, + "pageSize": page_size, + "total": total, + }, + "list": list, + }) +} + +/// 面 B 的列表(分页 + `PageListVO` 形状)。 +pub(crate) async fn handle_list_face_b( + state: &AppState, + headers: &HeaderMap, + spec: &EntitySpec, + guard: RouteGuard, + raw: &RawQuery, +) -> Json { + if let Err(resp) = guard_pack(state, headers, guard).await { + return resp; + } + let page = PackPaging::of(raw); + let table = match db::valid_table(spec.table) { + Some(t) => t, + None => return fail(400, "系统异常,请联系管理员"), + }; + let proj = match projection(spec) { + Ok(p) => p, + Err(_) => return fail(400, "系统异常,请联系管理员"), + }; + // 🔴 **总数与列表两条 SQL**(官方 `IPage` 的等价做法)。 + let total_sql = format!("SELECT count(*)::bigint AS \"c\" FROM {table} WHERE f_delete_mark = 0"); + let total = match state.db.query_json(&total_sql).await { + Ok(rows) => rows + .into_iter() + .next() + .and_then(|r| r["c"].as_i64()) + .unwrap_or(0), + Err(e) => return db_error(e, "业务列表计数"), + }; + let list_sql = format!( + "SELECT {proj} FROM {table} WHERE f_delete_mark = 0 \ + ORDER BY f_creator_time DESC LIMIT {page_size} OFFSET {page_offset}", + page_size = page.page_size, + page_offset = page.offset, + ); + let rows = match state.db.query_json(&list_sql).await { + Ok(rows) => rows, + Err(e) => return db_error(e, "业务列表查询"), + }; + ok(pack_page_list( + page.current_page, + page.page_size, + total, + rows, + )) +} + +/// 面 B 的新建 / 更新(响应 = 落库后读回的那一行,与面 A 同形)。 +pub(crate) async fn handle_save_face_b( + state: &AppState, + headers: &HeaderMap, + spec: &EntitySpec, + guard: RouteGuard, + body: &Bytes, +) -> Json { + if let Err(resp) = guard_pack(state, headers, guard).await { + return resp; + } + let obj = match parse_body(body) { + Ok(o) => o, + Err(resp) => return resp, + }; + let value = Value::Object(obj); + match save(&state.db, spec, &value).await { + Ok(row) => ok(row), + Err(e) => db_error(e, "业务保存"), + } +} + +/// 面 B 的软删(`{id}` 走路径参数)。 +pub(crate) async fn handle_delete_face_b( + state: &AppState, + headers: &HeaderMap, + spec: &EntitySpec, + guard: RouteGuard, + id: &str, +) -> Json { + if let Err(resp) = guard_pack(state, headers, guard).await { + return resp; + } + match remove(&state.db, spec, id).await { + Ok(()) => ok(Value::Null), + Err(e) => db_error(e, "业务删除"), + } +} + // ---------------------------------------------------------------- spec 取值(编译期常量) // // 🔴 **平台层不持有任何业务 spec** —— spec 全在 [`crate::modules`](demo / shop / books)。 // 引擎只认传入的 `&EntitySpec` ⇒ 加一张新业务表**不用改本文件**。 +// ---------------------------------------------------------------- 路由生成(spec 驱动) +// +// 🔴 **这是「业务包自带路由、平台层零改动」的落点**(批次 12 交付物 ①): +// 业务包声明 [`PackRoute`](纯数据:路径 + 方法 + 实体名), +// 本函数按声明**生成真正的 axum 路由** —— 引擎认识 spec ⇒ 直接复用。 +// ⇒ 业务包**不需要**依赖 axum(AR2/AR8 钉死),内核**不需要**知道任何业务路径。 + +/// 按业务包声明的路由生成 axum 路由(`Router::merge` 进总路由)。 +/// +/// 🔴 **入参是 `&[&'static PackRoute]`** —— 路由声明是编译期常量, +/// 这里只读不写。 +/// +/// 🔴 **动作与方法的对应关系被钉死**(不许自由组合): +/// | action | 允许的 method | 语义 | id 来源 | +/// |---|---|---|---| +/// | `List` | GET | 查列表(分页 + `PageListVO`) | — | +/// | `Save` | POST | 新建 / 更新 | body 的 `id` | +/// | `Delete` | DELETE | 软删 | **路径参数 `{id}`** | +/// +/// 🔴 **Delete 的 id 走路径参数**(官方 RESTful:`DELETE /api/{模块}/{资源}/{id}`) +/// ⇒ 路径里**必须**含 `{id}` ⇒ 不含就不生成这条路由(宁可少一条,也不要一条 +/// 永远收不到 id 的路由 —— 那种路由会静默删掉空 id 的行)。 +/// +/// 不在表里的组合 ⇒ **不生成路由**(而不是生成一个恒 400 的空实现)。 +/// 理由:官方 JNPF 有一批非 CRUD 端点(`/AsyncList/{id}` / `/Actions/ResetPassword`), +/// 它们由面 B 的专用 handler 实现,**不归业务包管**。 +/// +/// 🔴 **返回值类型是 `Router`** —— 与 `modules::router()` 一致, +/// 内核只需 `.merge(...)` 一次。 +pub fn crud_router(spec: &'static EntitySpec, routes: &[&'static PackRoute]) -> Router { + let mut router = Router::new(); + for r in routes { + // 🔴 路由的 entity 必须与 spec 对得上(装载器已校验过,这里是二道闸)。 + if r.entity != spec.entity { + continue; + } + // 🔴 **先把要捕获的值拷出来**(`Copy` 类型)—— + // 直接在闭包里写 `r.guard` 会把 `r`(指向入参切片,生命周期 `'1`) + // 一起捕获 ⇒ 编译报「borrowed data escapes outside of function」。 + let path = r.path; + let guard = r.guard; + match (r.action, r.method) { + (RouteAction::List, HttpMethod::Get) => { + router = router.route( + path, + get( + move |State(state): State, + headers: HeaderMap, + raw: RawQuery| async move { + handle_list_face_b(&state, &headers, spec, guard, &raw).await + }, + ), + ); + } + (RouteAction::Save, HttpMethod::Post) => { + router = router.route( + path, + post( + move |State(state): State, + headers: HeaderMap, + body: Bytes| async move { + handle_save_face_b(&state, &headers, spec, guard, &body).await + }, + ), + ); + } + (RouteAction::Delete, HttpMethod::Delete) => { + // 🔴 路径必须带 `{id}` —— 官方 RESTful 的删除是 `DELETE /api/{模块}/{资源}/{id}`。 + if !path.contains("{id}") { + continue; + } + router = router.route( + path, + delete( + move |State(state): State, + headers: HeaderMap, + axum::extract::Path(id): axum::extract::Path| async move { + handle_delete_face_b(&state, &headers, spec, guard, &id).await + }, + ), + ); + } + // 🔴 不在表里的组合 ⇒ **不生成路由**(静默跳过 = 少一条路由 = 404, + // 而不是 400 ⇒ 前端能区分「端点不存在」与「业务拒绝」)。 + _ => {} + } + } + router +} + #[cfg(test)] mod tests { use super::*; diff --git a/src/backend/src/platform/mod.rs b/src/backend/src/platform/mod.rs index 7024e26..63e29ed 100644 --- a/src/backend/src/platform/mod.rs +++ b/src/backend/src/platform/mod.rs @@ -25,6 +25,7 @@ pub mod ids; pub mod face_b; pub mod menu; pub mod permission; +pub mod route; pub mod seed; pub mod session; pub mod state; diff --git a/src/backend/src/platform/route.rs b/src/backend/src/platform/route.rs new file mode 100644 index 0000000..e5cef3b --- /dev/null +++ b/src/backend/src/platform/route.rs @@ -0,0 +1,13 @@ +//! route —— **业务包路由声明的类型**(转发到契约层)。 +//! +//! 🔴 真值源在 [`sspf_contract::route`](契约层)。本文件只做转发,保持既有引用路径稳定。 +//! +//! 🔴 **本文件只放「类型」,不放任何具体路由** —— +//! 业务包在自己的 `packs//src/lib.rs` 里声明路由, +//! 内核用 [`crate::platform::crud::crud_router`] 按声明**生成**路由。 +//! +//! 🔴 **路径形状**:必须是官方 JNPF 形状(`/api/{模块}/{资源}/...`), +//! **不许**用面 A 的 `/api/ssw/{appCode}/{Entity}/{List|Save|Delete}` +//! (那是本仓自造的 ssw 约定 ⇒ 集成到官方 JNPF 时**全部作废**)。 + +pub use sspf_contract::route::{HttpMethod, PackRoute, RouteAction, RouteGuard}; diff --git a/src/backend/src/platform/test_support.rs b/src/backend/src/platform/test_support.rs index ff9ab9c..2c41d17 100644 --- a/src/backend/src/platform/test_support.rs +++ b/src/backend/src/platform/test_support.rs @@ -20,7 +20,12 @@ pub async fn shared_db() -> &'static Db { SHARED .get_or_init(|| async { let db = Db::open_temp().await.expect("打开 pglite 临时库失败"); - db.ensure_schema().await.expect("ensure_schema 失败"); + // 🔴 **平台表 + 业务包的表**(批次 12 交付物 ③)—— + // 与 `main.rs` 的第 4 步**同一套装配**(同一个装配根) + // ⇒ 「测试里的库 == 线上库」这条约定是**结构性的**,不是靠人记得同步。 + crate::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); db }) .await diff --git a/src/backend/src/routes.rs b/src/backend/src/routes.rs index 10c511a..f7307d0 100644 --- a/src/backend/src/routes.rs +++ b/src/backend/src/routes.rs @@ -1062,7 +1062,13 @@ pub fn build_router(state: AppState) -> axum::Router { .route("/api/permission/Action/{id}", put(face_b::action_update)) .route("/api/permission/Action/{id}", delete(face_b::action_delete)) // ---- 业务模块的路由(demo / shop / books)由业务层自带 ⇒ 这里只 merge ---- - .merge(modules::router()); + .merge(modules::router()) + // ---- 业务包的路由(面 B 官方形状)由**业务包自带** ⇒ 按声明生成 ---- + // + // 🔴 **批次 12 交付物 ①**:业务包声明 `PackRoute`(纯数据)⇒ + // 装配根按声明 + spec 生成真正的 axum 路由 ⇒ **平台层零改动**。 + // 业务包**不需要**依赖 axum(AR2 / AR8 钉死)。 + .merge(crate::bootstrap::pack_router_or_empty()); // 🔴 **仅测试构建**存在的「故意 panic」端点 —— 用来钉住 catch-all 中间件 // (契约 §6.5:panic ⇒ HTTP 200 + `code=400`)。 @@ -1352,6 +1358,14 @@ mod tests { ) } + /// 🔴 **带官方判别头的 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!( @@ -1581,10 +1595,15 @@ mod tests { 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); - // 🔴 表数**故意写死**:它同时校验「schema.sql 建了预期的表」与 - // 「health 报的是真数」。加表要同步改这里 + main.rs 的 BASE_TABLES - // + crates/sspf-store 的两条 DDL 断言(共四处,漏一处就红)。 - assert_eq!(body["tables"], 52); + // 🔴 **表数不写死**(批次 12.5):DB 里的表 = `db/schema.sql` 建的表 + // + **业务包自带**的表(`packs//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")); } @@ -1951,4 +1970,53 @@ mod tests { 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}"); + } } diff --git a/src/backend/tests/auth_it.rs b/src/backend/tests/auth_it.rs index 42a6811..641f2af 100644 --- a/src/backend/tests/auth_it.rs +++ b/src/backend/tests/auth_it.rs @@ -44,7 +44,9 @@ const ADMIN_PLAIN: &str = "123456"; async fn db() -> &'static Db { DB.get_or_init(|| async { let db = Db::open_temp().await.expect("打开 pglite 临时库失败"); - db.ensure_schema().await.expect("ensure_schema 失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); ensure_base(&db).await.expect("ensure_base 失败"); first_seed(&db, "123456").await.expect("first_seed 失败"); db diff --git a/src/backend/tests/batch10_it.rs b/src/backend/tests/batch10_it.rs index fb02892..1e560e6 100644 --- a/src/backend/tests/batch10_it.rs +++ b/src/backend/tests/batch10_it.rs @@ -37,7 +37,9 @@ static LOCK: Mutex<()> = Mutex::const_new(()); async fn db() -> &'static Db { DB.get_or_init(|| async { let db = Db::open_temp().await.expect("打开 pglite 临时库失败"); - db.ensure_schema().await.expect("ensure_schema 失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); ensure_base(&db).await.expect("ensure_base 失败"); first_seed(&db, "123456").await.expect("first_seed 失败"); db diff --git a/src/backend/tests/batch11_it.rs b/src/backend/tests/batch11_it.rs index 5b45e07..31b275e 100644 --- a/src/backend/tests/batch11_it.rs +++ b/src/backend/tests/batch11_it.rs @@ -45,7 +45,9 @@ static LOCK: Mutex<()> = Mutex::const_new(()); async fn db() -> &'static Db { DB.get_or_init(|| async { let db = Db::open_temp().await.expect("打开 pglite 临时库失败"); - db.ensure_schema().await.expect("ensure_schema 失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); ensure_base(&db).await.expect("ensure_base 失败"); first_seed(&db, "123456").await.expect("first_seed 失败"); db diff --git a/src/backend/tests/batch2_it.rs b/src/backend/tests/batch2_it.rs index 4b3ae39..5c0aad4 100644 --- a/src/backend/tests/batch2_it.rs +++ b/src/backend/tests/batch2_it.rs @@ -45,7 +45,9 @@ async fn db() -> &'static Db { let db = Db::open_temp() .await .expect("打开 pglite 临时库失败"); - db.ensure_schema().await.expect("ensure_schema 失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); ensure_base(&db).await.expect("ensure_base 失败"); first_seed(&db, "123456").await.expect("first_seed 失败"); db diff --git a/src/backend/tests/batch3_it.rs b/src/backend/tests/batch3_it.rs index 6fc52d6..a9e4ad5 100644 --- a/src/backend/tests/batch3_it.rs +++ b/src/backend/tests/batch3_it.rs @@ -34,7 +34,9 @@ static LOCK: Mutex<()> = Mutex::const_new(()); async fn db() -> &'static Db { DB.get_or_init(|| async { let db = Db::open_temp().await.expect("打开 pglite 临时库失败"); - db.ensure_schema().await.expect("ensure_schema 失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); ensure_base(&db).await.expect("ensure_base 失败"); first_seed(&db, "123456").await.expect("first_seed 失败"); db diff --git a/src/backend/tests/batch4_it.rs b/src/backend/tests/batch4_it.rs index ed3893c..edffd35 100644 --- a/src/backend/tests/batch4_it.rs +++ b/src/backend/tests/batch4_it.rs @@ -37,7 +37,9 @@ static LOCK: Mutex<()> = Mutex::const_new(()); async fn db() -> &'static Db { DB.get_or_init(|| async { let db = Db::open_temp().await.expect("打开 pglite 临时库失败"); - db.ensure_schema().await.expect("ensure_schema 失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); ensure_base(&db).await.expect("ensure_base 失败"); first_seed(&db, "123456").await.expect("first_seed 失败"); db diff --git a/src/backend/tests/batch5_it.rs b/src/backend/tests/batch5_it.rs index f59dd63..bb42d41 100644 --- a/src/backend/tests/batch5_it.rs +++ b/src/backend/tests/batch5_it.rs @@ -35,7 +35,9 @@ static LOCK: Mutex<()> = Mutex::const_new(()); async fn db() -> &'static Db { DB.get_or_init(|| async { let db = Db::open_temp().await.expect("打开 pglite 临时库失败"); - db.ensure_schema().await.expect("ensure_schema 失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); ensure_base(&db).await.expect("ensure_base 失败"); first_seed(&db, "123456").await.expect("first_seed 失败"); db diff --git a/src/backend/tests/batch6_it.rs b/src/backend/tests/batch6_it.rs index af0337c..8b03e98 100644 --- a/src/backend/tests/batch6_it.rs +++ b/src/backend/tests/batch6_it.rs @@ -38,7 +38,9 @@ static LOCK: Mutex<()> = Mutex::const_new(()); async fn db() -> &'static Db { DB.get_or_init(|| async { let db = Db::open_temp().await.expect("打开 pglite 临时库失败"); - db.ensure_schema().await.expect("ensure_schema 失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); ensure_base(&db).await.expect("ensure_base 失败"); first_seed(&db, "123456").await.expect("first_seed 失败"); db diff --git a/src/backend/tests/batch7_it.rs b/src/backend/tests/batch7_it.rs index 7f0217f..ed1f42f 100644 --- a/src/backend/tests/batch7_it.rs +++ b/src/backend/tests/batch7_it.rs @@ -39,7 +39,9 @@ static LOCK: Mutex<()> = Mutex::const_new(()); async fn db() -> &'static Db { DB.get_or_init(|| async { let db = Db::open_temp().await.expect("打开 pglite 临时库失败"); - db.ensure_schema().await.expect("ensure_schema 失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); ensure_base(&db).await.expect("ensure_base 失败"); first_seed(&db, "123456").await.expect("first_seed 失败"); db diff --git a/src/backend/tests/batch8_it.rs b/src/backend/tests/batch8_it.rs index 23ac53c..79c489b 100644 --- a/src/backend/tests/batch8_it.rs +++ b/src/backend/tests/batch8_it.rs @@ -37,7 +37,9 @@ static LOCK: Mutex<()> = Mutex::const_new(()); async fn db() -> &'static Db { DB.get_or_init(|| async { let db = Db::open_temp().await.expect("打开 pglite 临时库失败"); - db.ensure_schema().await.expect("ensure_schema 失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); ensure_base(&db).await.expect("ensure_base 失败"); first_seed(&db, "123456").await.expect("first_seed 失败"); db diff --git a/src/backend/tests/batch9_it.rs b/src/backend/tests/batch9_it.rs index af0d7d2..2cb435c 100644 --- a/src/backend/tests/batch9_it.rs +++ b/src/backend/tests/batch9_it.rs @@ -37,7 +37,9 @@ static LOCK: Mutex<()> = Mutex::const_new(()); async fn db() -> &'static Db { DB.get_or_init(|| async { let db = Db::open_temp().await.expect("打开 pglite 临时库失败"); - db.ensure_schema().await.expect("ensure_schema 失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); ensure_base(&db).await.expect("ensure_base 失败"); first_seed(&db, "123456").await.expect("first_seed 失败"); db diff --git a/src/backend/tests/crud_it.rs b/src/backend/tests/crud_it.rs index d2ce9c0..ce8cdc2 100644 --- a/src/backend/tests/crud_it.rs +++ b/src/backend/tests/crud_it.rs @@ -38,7 +38,9 @@ static LOCK: Mutex<()> = Mutex::const_new(()); async fn db() -> &'static Db { DB.get_or_init(|| async { let db = Db::open_temp().await.expect("打开 pglite 临时库失败"); - db.ensure_schema().await.expect("ensure_schema 失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); ensure_base(&db).await.expect("ensure_base 失败"); first_seed(&db, "123456").await.expect("first_seed 失败"); db diff --git a/src/backend/tests/db_it.rs b/src/backend/tests/db_it.rs index 432384c..ff03305 100644 --- a/src/backend/tests/db_it.rs +++ b/src/backend/tests/db_it.rs @@ -40,7 +40,9 @@ async fn db_schema_and_row_shapes() { let db = db().await; // ---- 1) ensure_schema 建库(10 张表) ---- - db.ensure_schema().await.expect("ensure_schema 失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); // ---- 2) 二次 ensure_schema 幂等(不报错、不重建) ---- db.ensure_schema().await.expect("二次 ensure_schema 失败"); @@ -248,7 +250,9 @@ async fn db_schema_and_row_shapes() { #[tokio::test] async fn scalar_text_handles_text_and_integer_columns() { let db = db().await; - db.ensure_schema().await.expect("ensure_schema 失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); // text 列 let name = db @@ -288,7 +292,9 @@ async fn scalar_text_handles_text_and_integer_columns() { #[tokio::test] async fn scalar_text_rejects_non_text_column() { let db = db().await; - db.ensure_schema().await.expect("ensure_schema 失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); // ⚠️ 选 `SELECT 1::numeric`(**恒有一行**)而不是 `SELECT f_price FROM shop_product`: // 后者依赖「同文件的另一个测试已插过行」,并发下可能无行 ⇒ 只会得到 Ok(None) diff --git a/src/backend/tests/guard_it.rs b/src/backend/tests/guard_it.rs index c9840ef..50284f4 100644 --- a/src/backend/tests/guard_it.rs +++ b/src/backend/tests/guard_it.rs @@ -25,7 +25,9 @@ async fn db() -> &'static Db { let db = Db::open_temp() .await .expect("打开 pglite 临时库失败"); - db.ensure_schema().await.expect("ensure_schema 失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); db }) .await diff --git a/src/backend/tests/lowcode_crud_it.rs b/src/backend/tests/lowcode_crud_it.rs index 51240dc..d57c149 100644 --- a/src/backend/tests/lowcode_crud_it.rs +++ b/src/backend/tests/lowcode_crud_it.rs @@ -41,7 +41,9 @@ static LOCK: Mutex<()> = Mutex::const_new(()); async fn db() -> &'static Db { DB.get_or_init(|| async { let db = Db::open_temp().await.expect("打开 pglite 临时库失败"); - db.ensure_schema().await.expect("ensure_schema 失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); db }) .await diff --git a/src/backend/tests/lowcode_ddl_it.rs b/src/backend/tests/lowcode_ddl_it.rs index fc4058b..e34b969 100644 --- a/src/backend/tests/lowcode_ddl_it.rs +++ b/src/backend/tests/lowcode_ddl_it.rs @@ -55,7 +55,9 @@ static LOCK: Mutex<()> = Mutex::const_new(()); async fn db() -> &'static Db { DB.get_or_init(|| async { let db = Db::open_temp().await.expect("打开 pglite 临时库失败"); - db.ensure_schema().await.expect("ensure_schema 失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); db }) .await diff --git a/src/backend/tests/lowcode_ddl_kernel_it.rs b/src/backend/tests/lowcode_ddl_kernel_it.rs index 4d85250..a15072c 100644 --- a/src/backend/tests/lowcode_ddl_kernel_it.rs +++ b/src/backend/tests/lowcode_ddl_kernel_it.rs @@ -34,7 +34,9 @@ static LOCK: Mutex<()> = Mutex::const_new(()); async fn db() -> &'static Db { DB.get_or_init(|| async { let db = Db::open_temp().await.expect("打开 pglite 临时库失败"); - db.ensure_schema().await.expect("ensure_schema 失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); db }) .await diff --git a/src/backend/tests/lowcode_seed_it.rs b/src/backend/tests/lowcode_seed_it.rs index 490f495..1fa57b0 100644 --- a/src/backend/tests/lowcode_seed_it.rs +++ b/src/backend/tests/lowcode_seed_it.rs @@ -37,7 +37,9 @@ static LOCK: Mutex<()> = Mutex::const_new(()); async fn db() -> &'static Db { DB.get_or_init(|| async { let db = Db::open_temp().await.expect("打开 pglite 临时库失败"); - db.ensure_schema().await.expect("ensure_schema 失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); db }) .await diff --git a/src/backend/tests/permission_it.rs b/src/backend/tests/permission_it.rs index cadf51e..c4681be 100644 --- a/src/backend/tests/permission_it.rs +++ b/src/backend/tests/permission_it.rs @@ -27,7 +27,9 @@ static LOCK: Mutex<()> = Mutex::const_new(()); async fn db() -> &'static Db { DB.get_or_init(|| async { let db = Db::open_temp().await.expect("打开 pglite 临时库失败"); - db.ensure_schema().await.expect("ensure_schema 失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); db }) .await diff --git a/src/backend/tests/seed_it.rs b/src/backend/tests/seed_it.rs index 020ef93..8d06e5e 100644 --- a/src/backend/tests/seed_it.rs +++ b/src/backend/tests/seed_it.rs @@ -34,7 +34,9 @@ async fn db() -> &'static Db { let db = Db::open_temp() .await .expect("打开 pglite 临时库失败"); - db.ensure_schema().await.expect("ensure_schema 失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); db }) .await diff --git a/src/backend/tests/self_it.rs b/src/backend/tests/self_it.rs index 5591b56..4e45f31 100644 --- a/src/backend/tests/self_it.rs +++ b/src/backend/tests/self_it.rs @@ -37,7 +37,9 @@ async fn db() -> &'static Db { let db = Db::open_temp() .await .expect("打开 pglite 临时库失败"); - db.ensure_schema().await.expect("ensure_schema 失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); ensure_base(&db).await.expect("ensure_base 失败"); first_seed(&db, "123456").await.expect("first_seed 失败"); db diff --git a/src/backend/tests/sys_it.rs b/src/backend/tests/sys_it.rs index 5cfbdd4..46f2c71 100644 --- a/src/backend/tests/sys_it.rs +++ b/src/backend/tests/sys_it.rs @@ -37,7 +37,9 @@ static LOCK: Mutex<()> = Mutex::const_new(()); async fn db() -> &'static Db { DB.get_or_init(|| async { let db = Db::open_temp().await.expect("打开 pglite 临时库失败"); - db.ensure_schema().await.expect("ensure_schema 失败"); + ssw_platform::bootstrap::ensure_schema_all(&db) + .await + .expect("ensure_schema_all 失败"); ensure_base(&db).await.expect("ensure_base 失败"); first_seed(&db, "123456").await.expect("first_seed 失败"); db diff --git a/src/frontend/index.html b/src/frontend/index.html new file mode 100644 index 0000000..22e90a6 --- /dev/null +++ b/src/frontend/index.html @@ -0,0 +1,12 @@ + + + + + + SSW JNPF Lite · React MVP + + +
+ + + diff --git a/src/frontend/package-lock.json b/src/frontend/package-lock.json new file mode 100644 index 0000000..a1c4350 --- /dev/null +++ b/src/frontend/package-lock.json @@ -0,0 +1,2115 @@ +{ + "name": "ssw-jnpf-lite-react-frontend", + "version": "0.1.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "ssw-jnpf-lite-react-frontend", + "version": "0.1.0", + "dependencies": { + "axios": "^1.7.0", + "crypto-js": "^4.2.0", + "react": "^18.3.1", + "react-dom": "^18.3.1", + "react-router-dom": "^6.26.0" + }, + "devDependencies": { + "@types/crypto-js": "^4.2.2", + "@types/react": "^18.3.0", + "@types/react-dom": "^18.3.0", + "@vitejs/plugin-react": "^4.3.0", + "typescript": "^5.4.0", + "vite": "^5.2.0" + } + }, + "node_modules/@babel/code-frame": { + "version": "7.29.7", + "resolved": "https://registry.npmmirror.com/@babel/code-frame/-/code-frame-7.29.7.tgz", + "integrity": "sha512-Aup7aUOfpbAUg2ROOJN6Iw5f9DMBlzu0mIkm/malLQFN/YQgO48wCj0Kxa3sEHJvPVFg7siR+qRInwXd2qhQKw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-validator-identifier": "^7.29.7", + "js-tokens": "^4.0.0", + "picocolors": "^1.1.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/compat-data": { + "version": "7.29.7", + "resolved": "https://registry.npmmirror.com/@babel/compat-data/-/compat-data-7.29.7.tgz", + "integrity": "sha512-locTkQyKvwIEgBzVrn8693ebc97F2U8ZHjbXwDXJ5Fn2TCpNwTlKcaKLkdHop5c/icOFE7qt7Q9JC5hnKNa6Gg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/core": { + "version": "7.29.7", + "resolved": "https://registry.npmmirror.com/@babel/core/-/core-7.29.7.tgz", + "integrity": "sha512-RgHBCvtjbOK2gXSNBNIkNoEc9qoVEtau3hj8gEqKQuL3HZAibKarWFEI3Lfm6EYKkLalOh8eSrj9b+ch9H/VBA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.29.7", + "@babel/generator": "^7.29.7", + "@babel/helper-compilation-targets": "^7.29.7", + "@babel/helper-module-transforms": "^7.29.7", + "@babel/helpers": "^7.29.7", + "@babel/parser": "^7.29.7", + "@babel/template": "^7.29.7", + "@babel/traverse": "^7.29.7", + "@babel/types": "^7.29.7", + "@jridgewell/remapping": "^2.3.5", + "convert-source-map": "^2.0.0", + "debug": "^4.1.0", + "gensync": "^1.0.0-beta.2", + "json5": "^2.2.3", + "semver": "^6.3.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/babel" + } + }, + "node_modules/@babel/generator": { + "version": "7.29.8", + "resolved": "https://registry.npmmirror.com/@babel/generator/-/generator-7.29.8.tgz", + "integrity": "sha512-gZbepsdh3WDtgZKWL+vTPh71LSBrm/Y4/QDZBVCcYfmeTEEuoOYwlSy+G1StfJg+/Zy550u/3TATbm7qDbbMtg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.29.8", + "@babel/types": "^7.29.8", + "@jridgewell/gen-mapping": "^0.3.12", + "@jridgewell/trace-mapping": "^0.3.28", + "jsesc": "^3.0.2" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-compilation-targets": { + "version": "7.29.7", + "resolved": "https://registry.npmmirror.com/@babel/helper-compilation-targets/-/helper-compilation-targets-7.29.7.tgz", + "integrity": "sha512-wem6WaBj4NaVYVdNhLPPVacES6ZJ+KBBfSkTMD3YZxbP3rm3Di85tJU5ljaUNhaOynt+Aj0xruhYuzQBt8n71g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/compat-data": "^7.29.7", + "@babel/helper-validator-option": "^7.29.7", + "browserslist": "^4.24.0", + "lru-cache": "^5.1.1", + "semver": "^6.3.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-globals": { + "version": "7.29.7", + "resolved": "https://registry.npmmirror.com/@babel/helper-globals/-/helper-globals-7.29.7.tgz", + "integrity": "sha512-3nQVUAtvkKH9zahfWgw96Jc/uFOmjACE1kQz82E2lqWmHBgjzbNlsC22nuQTfahmWeQtTq5nQ/4Nnd2A1wj4zA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-module-imports": { + "version": "7.29.7", + "resolved": "https://registry.npmmirror.com/@babel/helper-module-imports/-/helper-module-imports-7.29.7.tgz", + "integrity": "sha512-ejHwrQQYcm9xnTivShn2IDOlIzInN34AXskvq9QicvCtEzq1Vzclu/tKF8Jq1Cg8JG2GL6/EmjgsCT7lXepE3g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/traverse": "^7.29.7", + "@babel/types": "^7.29.7" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-module-transforms": { + "version": "7.29.7", + "resolved": "https://registry.npmmirror.com/@babel/helper-module-transforms/-/helper-module-transforms-7.29.7.tgz", + "integrity": "sha512-UPUVSyXbOh627KiCIGQSgwWzGeBKLkaJ9PJEdrngIwMSzxLR4jS4+f1f1jb7VzBbg8nFLaYotvVPFCTqdrmTAg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-module-imports": "^7.29.7", + "@babel/helper-validator-identifier": "^7.29.7", + "@babel/traverse": "^7.29.7" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/helper-plugin-utils": { + "version": "7.29.7", + "resolved": "https://registry.npmmirror.com/@babel/helper-plugin-utils/-/helper-plugin-utils-7.29.7.tgz", + "integrity": "sha512-G7sHYigPY17oO5SYWnfD/0MTBwVR781S/JI643e/JhUYgVgWE/61SoW3NH9KWUKyKq5LVh3npif99Wkt6j86Jw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-string-parser": { + "version": "7.29.7", + "resolved": "https://registry.npmmirror.com/@babel/helper-string-parser/-/helper-string-parser-7.29.7.tgz", + "integrity": "sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-identifier": { + "version": "7.29.7", + "resolved": "https://registry.npmmirror.com/@babel/helper-validator-identifier/-/helper-validator-identifier-7.29.7.tgz", + "integrity": "sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-option": { + "version": "7.29.7", + "resolved": "https://registry.npmmirror.com/@babel/helper-validator-option/-/helper-validator-option-7.29.7.tgz", + "integrity": "sha512-N9ZErrD+yW5geCDtBqnOoxmR8+tNKiGuxKlDpuJxfsqpa2dFcexaziGAE/qoHLiDDreVNMupxGmSoNlyvsA3gw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helpers": { + "version": "7.29.7", + "resolved": "https://registry.npmmirror.com/@babel/helpers/-/helpers-7.29.7.tgz", + "integrity": "sha512-1k2lAGRMfHTcwuNYcCNUmaUffmQv8KWMfh2iJUUeRlwlwH4FdNG7mfPI10NPfLHJFThE4Tyr4mv7kTNZOiPuBg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/template": "^7.29.7", + "@babel/types": "^7.29.7" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/parser": { + "version": "7.29.8", + "resolved": "https://registry.npmmirror.com/@babel/parser/-/parser-7.29.8.tgz", + "integrity": "sha512-E8lTAYNB1KW+FH+VGJuZM1ioAx2E6oVlvQFRrf5P8ZZmsiJXYAD9vTFV7yyEURNzgh1dFqMZuO6tUwcARbqFCA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/types": "^7.29.8" + }, + "bin": { + "parser": "bin/babel-parser.js" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@babel/plugin-transform-react-jsx-self": { + "version": "7.29.7", + "resolved": "https://registry.npmmirror.com/@babel/plugin-transform-react-jsx-self/-/plugin-transform-react-jsx-self-7.29.7.tgz", + "integrity": "sha512-TL0hMc9xzy86VD31nUiwzd5otRAcyEPcsegCxolO0PvcXuH1v0kECe/UIznYFihpkvU5wg/jk4v0TTEFfm53fw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.29.7" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-transform-react-jsx-source": { + "version": "7.29.7", + "resolved": "https://registry.npmmirror.com/@babel/plugin-transform-react-jsx-source/-/plugin-transform-react-jsx-source-7.29.7.tgz", + "integrity": "sha512-06IyK09H3wi4cGbhDBwp5gUGo0IKtnYa8tyTiephirPCK6fbobVGiXMMI5zLQ4aKEYP3wZ3ArU44o+8KMrSG/Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.29.7" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/template": { + "version": "7.29.7", + "resolved": "https://registry.npmmirror.com/@babel/template/-/template-7.29.7.tgz", + "integrity": "sha512-puq+Gf35oI24FeN11LkoUQFqv9uwNeWpxXZi/Ji3rRIoKAzKnxRaZ+Gkj0vKS9ZCiTESfng1N9LyOyXvo+m+Gg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.29.7", + "@babel/parser": "^7.29.7", + "@babel/types": "^7.29.7" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/traverse": { + "version": "7.29.8", + "resolved": "https://registry.npmmirror.com/@babel/traverse/-/traverse-7.29.8.tgz", + "integrity": "sha512-I5z7H3bf/41ktsNVLtpN0wAa336HkqIHQ5BuPLEhTkt1jVSyZpeNKIzTgEWmlxjdg81R0IgUCcaE+Ok3NvrfZg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/code-frame": "^7.29.7", + "@babel/generator": "^7.29.8", + "@babel/helper-globals": "^7.29.7", + "@babel/parser": "^7.29.8", + "@babel/template": "^7.29.7", + "@babel/types": "^7.29.8", + "debug": "^4.3.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/types": { + "version": "7.29.8", + "resolved": "https://registry.npmmirror.com/@babel/types/-/types-7.29.8.tgz", + "integrity": "sha512-Vj1jF3cPfxg7OAfoI7QnVKLoILlm2JF9pnVHrX8qx7AHMiYWT+NDAA7jChlNgRS4WTLc/fD1lXLmPixluj+3Gg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-string-parser": "^7.29.7", + "@babel/helper-validator-identifier": "^7.29.7" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@esbuild/aix-ppc64": { + "version": "0.21.5", + "resolved": "https://registry.npmmirror.com/@esbuild/aix-ppc64/-/aix-ppc64-0.21.5.tgz", + "integrity": "sha512-1SDgH6ZSPTlggy1yI6+Dbkiz8xzpHJEVAlF/AM1tHPLsf5STom9rwtjE4hKAF20FfXXNTFqEYXyJNWh1GiZedQ==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "aix" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/android-arm": { + "version": "0.21.5", + "resolved": "https://registry.npmmirror.com/@esbuild/android-arm/-/android-arm-0.21.5.tgz", + "integrity": "sha512-vCPvzSjpPHEi1siZdlvAlsPxXl7WbOVUBBAowWug4rJHb68Ox8KualB+1ocNvT5fjv6wpkX6o/iEpbDrf68zcg==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/android-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmmirror.com/@esbuild/android-arm64/-/android-arm64-0.21.5.tgz", + "integrity": "sha512-c0uX9VAUBQ7dTDCjq+wdyGLowMdtR/GoC2U5IYk/7D1H1JYC0qseD7+11iMP2mRLN9RcCMRcjC4YMclCzGwS/A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/android-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmmirror.com/@esbuild/android-x64/-/android-x64-0.21.5.tgz", + "integrity": "sha512-D7aPRUUNHRBwHxzxRvp856rjUHRFW1SdQATKXH2hqA0kAZb1hKmi02OpYRacl0TxIGz/ZmXWlbZgjwWYaCakTA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/darwin-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmmirror.com/@esbuild/darwin-arm64/-/darwin-arm64-0.21.5.tgz", + "integrity": "sha512-DwqXqZyuk5AiWWf3UfLiRDJ5EDd49zg6O9wclZ7kUMv2WRFr4HKjXp/5t8JZ11QbQfUS6/cRCKGwYhtNAY88kQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/darwin-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmmirror.com/@esbuild/darwin-x64/-/darwin-x64-0.21.5.tgz", + "integrity": "sha512-se/JjF8NlmKVG4kNIuyWMV/22ZaerB+qaSi5MdrXtd6R08kvs2qCN4C09miupktDitvh8jRFflwGFBQcxZRjbw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/freebsd-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmmirror.com/@esbuild/freebsd-arm64/-/freebsd-arm64-0.21.5.tgz", + "integrity": "sha512-5JcRxxRDUJLX8JXp/wcBCy3pENnCgBR9bN6JsY4OmhfUtIHe3ZW0mawA7+RDAcMLrMIZaf03NlQiX9DGyB8h4g==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/freebsd-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmmirror.com/@esbuild/freebsd-x64/-/freebsd-x64-0.21.5.tgz", + "integrity": "sha512-J95kNBj1zkbMXtHVH29bBriQygMXqoVQOQYA+ISs0/2l3T9/kj42ow2mpqerRBxDJnmkUDCaQT/dfNXWX/ZZCQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-arm": { + "version": "0.21.5", + "resolved": "https://registry.npmmirror.com/@esbuild/linux-arm/-/linux-arm-0.21.5.tgz", + "integrity": "sha512-bPb5AHZtbeNGjCKVZ9UGqGwo8EUu4cLq68E95A53KlxAPRmUyYv2D6F0uUI65XisGOL1hBP5mTronbgo+0bFcA==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmmirror.com/@esbuild/linux-arm64/-/linux-arm64-0.21.5.tgz", + "integrity": "sha512-ibKvmyYzKsBeX8d8I7MH/TMfWDXBF3db4qM6sy+7re0YXya+K1cem3on9XgdT2EQGMu4hQyZhan7TeQ8XkGp4Q==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-ia32": { + "version": "0.21.5", + "resolved": "https://registry.npmmirror.com/@esbuild/linux-ia32/-/linux-ia32-0.21.5.tgz", + "integrity": "sha512-YvjXDqLRqPDl2dvRODYmmhz4rPeVKYvppfGYKSNGdyZkA01046pLWyRKKI3ax8fbJoK5QbxblURkwK/MWY18Tg==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-loong64": { + "version": "0.21.5", + "resolved": "https://registry.npmmirror.com/@esbuild/linux-loong64/-/linux-loong64-0.21.5.tgz", + "integrity": "sha512-uHf1BmMG8qEvzdrzAqg2SIG/02+4/DHB6a9Kbya0XDvwDEKCoC8ZRWI5JJvNdUjtciBGFQ5PuBlpEOXQj+JQSg==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-mips64el": { + "version": "0.21.5", + "resolved": "https://registry.npmmirror.com/@esbuild/linux-mips64el/-/linux-mips64el-0.21.5.tgz", + "integrity": "sha512-IajOmO+KJK23bj52dFSNCMsz1QP1DqM6cwLUv3W1QwyxkyIWecfafnI555fvSGqEKwjMXVLokcV5ygHW5b3Jbg==", + "cpu": [ + "mips64el" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-ppc64": { + "version": "0.21.5", + "resolved": "https://registry.npmmirror.com/@esbuild/linux-ppc64/-/linux-ppc64-0.21.5.tgz", + "integrity": "sha512-1hHV/Z4OEfMwpLO8rp7CvlhBDnjsC3CttJXIhBi+5Aj5r+MBvy4egg7wCbe//hSsT+RvDAG7s81tAvpL2XAE4w==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-riscv64": { + "version": "0.21.5", + "resolved": "https://registry.npmmirror.com/@esbuild/linux-riscv64/-/linux-riscv64-0.21.5.tgz", + "integrity": "sha512-2HdXDMd9GMgTGrPWnJzP2ALSokE/0O5HhTUvWIbD3YdjME8JwvSCnNGBnTThKGEB91OZhzrJ4qIIxk/SBmyDDA==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-s390x": { + "version": "0.21.5", + "resolved": "https://registry.npmmirror.com/@esbuild/linux-s390x/-/linux-s390x-0.21.5.tgz", + "integrity": "sha512-zus5sxzqBJD3eXxwvjN1yQkRepANgxE9lgOW2qLnmr8ikMTphkjgXu1HR01K4FJg8h1kEEDAqDcZQtbrRnB41A==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/linux-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmmirror.com/@esbuild/linux-x64/-/linux-x64-0.21.5.tgz", + "integrity": "sha512-1rYdTpyv03iycF1+BhzrzQJCdOuAOtaqHTWJZCWvijKD2N5Xu0TtVC8/+1faWqcP9iBCWOmjmhoH94dH82BxPQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/netbsd-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmmirror.com/@esbuild/netbsd-x64/-/netbsd-x64-0.21.5.tgz", + "integrity": "sha512-Woi2MXzXjMULccIwMnLciyZH4nCIMpWQAs049KEeMvOcNADVxo0UBIQPfSmxB3CWKedngg7sWZdLvLczpe0tLg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/openbsd-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmmirror.com/@esbuild/openbsd-x64/-/openbsd-x64-0.21.5.tgz", + "integrity": "sha512-HLNNw99xsvx12lFBUwoT8EVCsSvRNDVxNpjZ7bPn947b8gJPzeHWyNVhFsaerc0n3TsbOINvRP2byTZ5LKezow==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/sunos-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmmirror.com/@esbuild/sunos-x64/-/sunos-x64-0.21.5.tgz", + "integrity": "sha512-6+gjmFpfy0BHU5Tpptkuh8+uw3mnrvgs+dSPQXQOv3ekbordwnzTVEb4qnIvQcYXq6gzkyTnoZ9dZG+D4garKg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "sunos" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/win32-arm64": { + "version": "0.21.5", + "resolved": "https://registry.npmmirror.com/@esbuild/win32-arm64/-/win32-arm64-0.21.5.tgz", + "integrity": "sha512-Z0gOTd75VvXqyq7nsl93zwahcTROgqvuAcYDUr+vOv8uHhNSKROyU961kgtCD1e95IqPKSQKH7tBTslnS3tA8A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/win32-ia32": { + "version": "0.21.5", + "resolved": "https://registry.npmmirror.com/@esbuild/win32-ia32/-/win32-ia32-0.21.5.tgz", + "integrity": "sha512-SWXFF1CL2RVNMaVs+BBClwtfZSvDgtL//G/smwAc5oVK/UPu2Gu9tIaRgFmYFFKrmg3SyAjSrElf0TiJ1v8fYA==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@esbuild/win32-x64": { + "version": "0.21.5", + "resolved": "https://registry.npmmirror.com/@esbuild/win32-x64/-/win32-x64-0.21.5.tgz", + "integrity": "sha512-tQd/1efJuzPC6rCFwEvLtci/xNFcTZknmXs98FYDfGE4wP9ClFV98nyKrzJKVPMhdDnjzLhdUyMX4PsQAPjwIw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=12" + } + }, + "node_modules/@jridgewell/gen-mapping": { + "version": "0.3.13", + "resolved": "https://registry.npmmirror.com/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz", + "integrity": "sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.0", + "@jridgewell/trace-mapping": "^0.3.24" + } + }, + "node_modules/@jridgewell/remapping": { + "version": "2.3.5", + "resolved": "https://registry.npmmirror.com/@jridgewell/remapping/-/remapping-2.3.5.tgz", + "integrity": "sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/gen-mapping": "^0.3.5", + "@jridgewell/trace-mapping": "^0.3.24" + } + }, + "node_modules/@jridgewell/resolve-uri": { + "version": "3.1.2", + "resolved": "https://registry.npmmirror.com/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz", + "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@jridgewell/sourcemap-codec": { + "version": "1.6.0", + "resolved": "https://registry.npmmirror.com/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.6.0.tgz", + "integrity": "sha512-T7jf+5zgsZHwNJ4lvQ7/aezbyk0nNX+zJVWpmHA7VYsEx7a7qr5Rg5IbtJFqkgze5Y2sruq1RUY8Q837Od7iFw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@jridgewell/trace-mapping": { + "version": "0.3.31", + "resolved": "https://registry.npmmirror.com/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz", + "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/resolve-uri": "^3.1.0", + "@jridgewell/sourcemap-codec": "^1.4.14" + } + }, + "node_modules/@napi-rs/lzma-linux-x64-gnu": { + "version": "1.5.1", + "resolved": "https://registry.npmmirror.com/@napi-rs/lzma-linux-x64-gnu/-/lzma-linux-x64-gnu-1.5.1.tgz", + "integrity": "sha512-oTXEIha4SsuXdTA4Iyskj0kpdx2yVXdhd75c2v3xGrHFfVMsbhTPZU/nMPL4sWKo4pBHm3aucLaqGlF696dTyQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^22.20 || ^24.12 || >=25" + } + }, + "node_modules/@remix-run/router": { + "version": "1.23.4", + "resolved": "https://registry.npmmirror.com/@remix-run/router/-/router-1.23.4.tgz", + "integrity": "sha512-q7j5geK7xs3UJSdm9/iytUNclBnLmYx1EnSeCFXHPeutdqgIMeFeHtUZgS3EhlKxdBEAu8OwtJCwmLrEzpSs7Q==", + "license": "MIT", + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/@rolldown/pluginutils": { + "version": "1.0.0-beta.27", + "resolved": "https://registry.npmmirror.com/@rolldown/pluginutils/-/pluginutils-1.0.0-beta.27.tgz", + "integrity": "sha512-+d0F4MKMCbeVUJwG96uQ4SgAznZNSq93I3V+9NHA4OpvqG8mRCpGdKmK8l/dl02h2CCDHwW2FqilnTyDcAnqjA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@rollup/rollup-android-arm-eabi": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.63.3.tgz", + "integrity": "sha512-w3Jnvi1ocaVm/c7yVPpfB98XeSRBMyzp6njL5MVVbGyXjpmUkN+s6Hp4t0PqhGCCaI1ZHMKXt/w0lA1RCaLVcw==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-android-arm64": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.63.3.tgz", + "integrity": "sha512-uI/ESiaIbbRYAEhzy8PCUWDp1hB0bjAqM06mW9flOoNO4Q8DQpeoREhBR5Hegfl+wpXiguyJv6XSPzEN7OxyHQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-darwin-arm64": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.63.3.tgz", + "integrity": "sha512-oxhrd1jmXLwWZ83eQYDXxuqRdkqkzrjR3JobKeuUyfdNZo11FuQIvqEOZhyIT7OBHxXoGslDDjN0cQcM6T0TqQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-darwin-x64": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.63.3.tgz", + "integrity": "sha512-7/YiIMghVE8DrxKvNdorAaJVdriOFgOIpdStnPx8ppx5zfTwC3jBCSEAIzB7JD5404m65THl6H93UTTVUvypmg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-freebsd-arm64": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.63.3.tgz", + "integrity": "sha512-GXFZRRoMAytaI5z6N3Zhfw0WL18Q0M8r95D5hlC4GqE/lGk8pbSJNUBoOWDfbm6dTciqHj2nU87tI5f6XhQiOg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-freebsd-x64": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.63.3.tgz", + "integrity": "sha512-77W+8X3ddYgPxUpB8nZFQs2Mq+wc4HVlcSRtApXLjYBcnPMkttrSnU8VwKQjeWYhMsITHFs5cWBQ8vz1Q+5RHQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-linux-arm-gnueabihf": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.63.3.tgz", + "integrity": "sha512-FVkwK+iUC+mq+GipVK46rRVticfAPtvPUNlqlGXUDxdVk/UGjQiiiUVPUrEXdSpU2ufU0XxLGyTqDtBidDOVmg==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm-musleabihf": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.63.3.tgz", + "integrity": "sha512-+aGU1t3398yQOVj1Bz8o3e+KtswxAPvO+mtxtNdfXYMkXIHu7XhhkCD7/DEH9q8tF8uhDnMWvfpUKI8y1sZJsg==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-gnu": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.63.3.tgz", + "integrity": "sha512-cR0kjpRXR2KJ2oQK8E2KTPtphs+b9hZ8IhTZubNryt/RsqgdOZBQ2Zq0q5UedtiIi0rs3jVhJh55RE1ZHUVGUA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-musl": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.63.3.tgz", + "integrity": "sha512-y1RYi4Q3/9ByVWSSt9kX2ustE0B7kFYbJ6zZdVZVyqopZs3yhCTwRfrjIX4vezUJInma/Gs6BOFDJg7yZmJ0IQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-gnu": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.63.3.tgz", + "integrity": "sha512-DNhEA5viIj3Z5bZLE4z4oV8N5ozWqDwyt7T6KG7VdLDJ0nW+rNOYlphBl4/3HQkK75qipPLsVOfStHHOwN9WSg==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-musl": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.63.3.tgz", + "integrity": "sha512-17gQCqrIpXBX2Cmi9/TygnVOqGbzsba/iaqcYSL8FY7lNugg+7AiYNs5c5nKWD+NRQha36Sa0CqkJqH4XVHwnQ==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-gnu": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.63.3.tgz", + "integrity": "sha512-6LwVnZRIyINpdku/yOcI8Tm9YqLmhHK5emmlOOnW9tO0SYEm1FmKPcsSAGp0NBlqR2P04xaND4jvN6sTHqhq8A==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-musl": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.63.3.tgz", + "integrity": "sha512-xMUqkTXlEUtI/p5AAukMwBRr1enU3efsTeF+bskeFfk8t1C9rcC8sLREcZXmTfAXEbvRdJVSonVJez3TMlbR3w==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-gnu": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.63.3.tgz", + "integrity": "sha512-S3E94co9F9WRRqEaUoQZ38K1gCz6KiM+nL7/3ijq7fDGF3OznjS5TasgYITlvl27GQKtu4lOAOsr5MFwkijvOA==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-musl": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.63.3.tgz", + "integrity": "sha512-1QtRDwG42x5BJI3s9mxu5rEjDnfbSnk20HQ9/ylTAYnSwYwxMVb+Vgu34wzzTQ7ogqBybebgQNUDAvZVQ38DbA==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-s390x-gnu": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.63.3.tgz", + "integrity": "sha512-BQhejF6ZXOpxbngiNTP12GCGQeaDVL2QXGeBVViKIYzFHM5RKxTxwUMB1fr1BeNFphFMpnRqC5QSXFSa4z6UQw==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-gnu": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.63.3.tgz", + "integrity": "sha512-SXagRwnI2Wlwlitllu59UK/nGVbD1CKPcNqDplHwIC4BqJcpXFjD32d1R/RbuISa95HdQrZM3/7v4bKiowFaLA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-musl": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.63.3.tgz", + "integrity": "sha512-2IPozoEALRCziGqE8O9KMK60PMu5TS1huv4fwoeCexj+WjmcwFtX9CTOVbfXCUqcELAubEwRFPYlzb/WvwY2HQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-openbsd-x64": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.63.3.tgz", + "integrity": "sha512-AoxqosUHT9IX54hFn2TiN6A7d6ZKTtE6pd2bqWtqkkNJ6HJGaU6FRouGX8L1O7R/ZwsnCnpQrHzb4pDEx+UHRQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ] + }, + "node_modules/@rollup/rollup-openharmony-arm64": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.63.3.tgz", + "integrity": "sha512-d+CaftKgmkFBzCwezMqqy1d0QNNYugqLCMcYVQWBy5SS2YfeMP8Q8ripkgx9O8IyBXXLHrJ+aaCV4U96usv6Yg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ] + }, + "node_modules/@rollup/rollup-win32-arm64-msvc": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.63.3.tgz", + "integrity": "sha512-xXlDF6nR1eOuXbdDy5Hl5fmtY7teUDevF/k0O7IPoZe4Tpmdv+lgdE5JRsnhQtt37ql9P0VF2kAN9a0OCZdo+Q==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-ia32-msvc": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.63.3.tgz", + "integrity": "sha512-YtXAgLN+JP7Ay6qG3eWhc7IHMQPzLc8r3uvhAvlJIoCz/4Q32+Bl9Fmnywidh8v1GOIMmymjovfqY9ETAtysvA==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-gnu": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.63.3.tgz", + "integrity": "sha512-WuWtSJRNo549vzcfZyEgfqb6zeSgn1F+UE5kQ+BCjzz0W4MGCjntUHkZVc1VRuAM7+ULaSyhiPxD1spyewFvkQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-msvc": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.63.3.tgz", + "integrity": "sha512-+lIKX7O0+IGe7WuhATaAMMeT7B76vfhXH/l9wLQL+nvyhbw2ohYCKIdWL56JfDu75CWt5oKRP4QFH/jkMtBquA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@types/babel__core": { + "version": "7.20.5", + "resolved": "https://registry.npmmirror.com/@types/babel__core/-/babel__core-7.20.5.tgz", + "integrity": "sha512-qoQprZvz5wQFJwMDqeseRXWv3rqMvhgpbXFfVyWhbx9X47POIA6i/+dXefEmZKoAgOaTdaIgNSMqMIU61yRyzA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.20.7", + "@babel/types": "^7.20.7", + "@types/babel__generator": "*", + "@types/babel__template": "*", + "@types/babel__traverse": "*" + } + }, + "node_modules/@types/babel__generator": { + "version": "7.27.0", + "resolved": "https://registry.npmmirror.com/@types/babel__generator/-/babel__generator-7.27.0.tgz", + "integrity": "sha512-ufFd2Xi92OAVPYsy+P4n7/U7e68fex0+Ee8gSG9KX7eo084CWiQ4sdxktvdl0bOPupXtVJPY19zk6EwWqUQ8lg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/types": "^7.0.0" + } + }, + "node_modules/@types/babel__template": { + "version": "7.4.4", + "resolved": "https://registry.npmmirror.com/@types/babel__template/-/babel__template-7.4.4.tgz", + "integrity": "sha512-h/NUaSyG5EyxBIp8YRxo4RMe2/qQgvyowRwVMzhYhBCONbW8PUsg4lkFMrhgZhUe5z3L3MiLDuvyJ/CaPa2A8A==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.1.0", + "@babel/types": "^7.0.0" + } + }, + "node_modules/@types/babel__traverse": { + "version": "7.28.0", + "resolved": "https://registry.npmmirror.com/@types/babel__traverse/-/babel__traverse-7.28.0.tgz", + "integrity": "sha512-8PvcXf70gTDZBgt9ptxJ8elBeBjcLOAcOtoO/mPJjtji1+CdGbHgm77om1GrsPxsiE+uXIpNSK64UYaIwQXd4Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/types": "^7.28.2" + } + }, + "node_modules/@types/crypto-js": { + "version": "4.2.2", + "resolved": "https://registry.npmmirror.com/@types/crypto-js/-/crypto-js-4.2.2.tgz", + "integrity": "sha512-sDOLlVbHhXpAUAL0YHDUUwDZf3iN4Bwi4W6a0W0b+QcAezUbRtH4FVb+9J4h+XFPW7l/gQ9F8qC7P+Ec4k8QVQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/estree": { + "version": "1.0.9", + "resolved": "https://registry.npmmirror.com/@types/estree/-/estree-1.0.9.tgz", + "integrity": "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/prop-types": { + "version": "15.7.15", + "resolved": "https://registry.npmmirror.com/@types/prop-types/-/prop-types-15.7.15.tgz", + "integrity": "sha512-F6bEyamV9jKGAFBEmlQnesRPGOQqS2+Uwi0Em15xenOxHaf2hv6L8YCVn3rPdPJOiJfPiCnLIRyvwVaqMY3MIw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/react": { + "version": "18.3.31", + "resolved": "https://registry.npmmirror.com/@types/react/-/react-18.3.31.tgz", + "integrity": "sha512-vfEqpXTvwT91yhmwdfouStN2hSKwTvyRs8qpLfADyrq/kxDw0hZM7Wk9Ug1FELj8hIby+S/+kQCSRFF32nv2Qw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/prop-types": "*", + "csstype": "^3.2.2" + } + }, + "node_modules/@types/react-dom": { + "version": "18.3.7", + "resolved": "https://registry.npmmirror.com/@types/react-dom/-/react-dom-18.3.7.tgz", + "integrity": "sha512-MEe3UeoENYVFXzoXEWsvcpg6ZvlrFNlOQ7EOsvhI3CfAXwzPfO8Qwuxd40nepsYKqyyVQnTdEfv68q91yLcKrQ==", + "dev": true, + "license": "MIT", + "peerDependencies": { + "@types/react": "^18.0.0" + } + }, + "node_modules/@vitejs/plugin-react": { + "version": "4.7.0", + "resolved": "https://registry.npmmirror.com/@vitejs/plugin-react/-/plugin-react-4.7.0.tgz", + "integrity": "sha512-gUu9hwfWvvEDBBmgtAowQCojwZmJ5mcLn3aufeCsitijs3+f2NsrPtlAWIR6OPiqljl96GVCUbLe0HyqIpVaoA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/core": "^7.28.0", + "@babel/plugin-transform-react-jsx-self": "^7.27.1", + "@babel/plugin-transform-react-jsx-source": "^7.27.1", + "@rolldown/pluginutils": "1.0.0-beta.27", + "@types/babel__core": "^7.20.5", + "react-refresh": "^0.17.0" + }, + "engines": { + "node": "^14.18.0 || >=16.0.0" + }, + "peerDependencies": { + "vite": "^4.2.0 || ^5.0.0 || ^6.0.0 || ^7.0.0" + } + }, + "node_modules/agent-base": { + "version": "6.0.2", + "resolved": "https://registry.npmmirror.com/agent-base/-/agent-base-6.0.2.tgz", + "integrity": "sha512-RZNwNclF7+MS/8bDg70amg32dyeZGZxiDuQmZxKLAlQjr3jGyLx+4Kkk58UO7D2QdgFIQCovuSuZESne6RG6XQ==", + "license": "MIT", + "dependencies": { + "debug": "4" + }, + "engines": { + "node": ">= 6.0.0" + } + }, + "node_modules/asynckit": { + "version": "0.4.0", + "resolved": "https://registry.npmmirror.com/asynckit/-/asynckit-0.4.0.tgz", + "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==", + "license": "MIT" + }, + "node_modules/axios": { + "version": "1.20.0", + "resolved": "https://registry.npmmirror.com/axios/-/axios-1.20.0.tgz", + "integrity": "sha512-r8aOh8j9cGKpgQAqpzrUHnSIc6a59Y3Xf/cv8sy1DrHCkZHzQGEuoq1tARk6qSyDdtQGSDgpb9kFlruzPvrgwg==", + "license": "MIT", + "dependencies": { + "follow-redirects": "^1.16.0", + "form-data": "^4.0.6", + "https-proxy-agent": "^5.0.1", + "proxy-from-env": "^2.1.0" + } + }, + "node_modules/baseline-browser-mapping": { + "version": "2.11.24", + "resolved": "https://registry.npmmirror.com/baseline-browser-mapping/-/baseline-browser-mapping-2.11.24.tgz", + "integrity": "sha512-hYrgxie335U08WqICoGqKRzV1HFXv6zdxwJE4ekCb80CM9a0SVVsN4QPwT67RraRo+9h8IATk6uxHJw7QSkdOg==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "baseline-browser-mapping": "dist/cli.cjs" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/browserslist": { + "version": "4.29.0", + "resolved": "https://registry.npmmirror.com/browserslist/-/browserslist-4.29.0.tgz", + "integrity": "sha512-3GSvyjvDI4Dur1Meg2BekJquu5uF+9R9a1+5M1Mde192eZoXbeXjzgOsgqPS2V8D5wrrip0gR5Hf/GhWQ9ZzaA==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/browserslist" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "baseline-browser-mapping": "^2.11.23", + "caniuse-lite": "^1.0.30001810", + "electron-to-chromium": "^1.5.427", + "node-releases": "^2.0.55", + "update-browserslist-db": "^1.3.3" + }, + "bin": { + "browserslist": "cli.js" + }, + "engines": { + "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7" + } + }, + "node_modules/call-bind-apply-helpers": { + "version": "1.0.2", + "resolved": "https://registry.npmmirror.com/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz", + "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/caniuse-lite": { + "version": "1.0.30001810", + "resolved": "https://registry.npmmirror.com/caniuse-lite/-/caniuse-lite-1.0.30001810.tgz", + "integrity": "sha512-TITQPUkaz+aVk5GL6NhOdwk1aEaNTSDPsGFWrTuhKGtjTF70jL/Oht2W4c6rXUe5fu7Ie19VIahAXHIIiWWNeg==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/caniuse-lite" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "CC-BY-4.0" + }, + "node_modules/combined-stream": { + "version": "1.0.8", + "resolved": "https://registry.npmmirror.com/combined-stream/-/combined-stream-1.0.8.tgz", + "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==", + "license": "MIT", + "dependencies": { + "delayed-stream": "~1.0.0" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/convert-source-map": { + "version": "2.0.0", + "resolved": "https://registry.npmmirror.com/convert-source-map/-/convert-source-map-2.0.0.tgz", + "integrity": "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==", + "dev": true, + "license": "MIT" + }, + "node_modules/crypto-js": { + "version": "4.2.0", + "resolved": "https://registry.npmmirror.com/crypto-js/-/crypto-js-4.2.0.tgz", + "integrity": "sha512-KALDyEYgpY+Rlob/iriUtjV6d5Eq+Y191A5g4UqLAi8CyGP9N1+FdVbkc1SxKc2r4YAYqG8JzO2KGL+AizD70Q==", + "deprecated": "Active development of CryptoJS has been discontinued. This library is no longer maintained.", + "license": "MIT" + }, + "node_modules/csstype": { + "version": "3.2.3", + "resolved": "https://registry.npmmirror.com/csstype/-/csstype-3.2.3.tgz", + "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/debug": { + "version": "4.4.3", + "resolved": "https://registry.npmmirror.com/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/delayed-stream": { + "version": "1.0.0", + "resolved": "https://registry.npmmirror.com/delayed-stream/-/delayed-stream-1.0.0.tgz", + "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==", + "license": "MIT", + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/dunder-proto": { + "version": "1.0.1", + "resolved": "https://registry.npmmirror.com/dunder-proto/-/dunder-proto-1.0.1.tgz", + "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==", + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.1", + "es-errors": "^1.3.0", + "gopd": "^1.2.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/electron-to-chromium": { + "version": "1.5.430", + "resolved": "https://registry.npmmirror.com/electron-to-chromium/-/electron-to-chromium-1.5.430.tgz", + "integrity": "sha512-e1QEj72Y4zd8RlNZVmoTg+iCOSVwpk05IOiiQwdrkwCSVlZfPthevErhE+nckGd2YbsXfp1SkisznhGVIXP2NQ==", + "dev": true, + "license": "ISC" + }, + "node_modules/es-define-property": { + "version": "1.0.1", + "resolved": "https://registry.npmmirror.com/es-define-property/-/es-define-property-1.0.1.tgz", + "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-errors": { + "version": "1.3.0", + "resolved": "https://registry.npmmirror.com/es-errors/-/es-errors-1.3.0.tgz", + "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-object-atoms": { + "version": "1.1.2", + "resolved": "https://registry.npmmirror.com/es-object-atoms/-/es-object-atoms-1.1.2.tgz", + "integrity": "sha512-HWcBoN6NileqtSydK2FqHbS/LoDd2pqrnQHLyJzBj4kOp/ky2MWMN694xOfkK8/SnUsW2DH7EfyVlydKCsm1Zw==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-set-tostringtag": { + "version": "2.1.0", + "resolved": "https://registry.npmmirror.com/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz", + "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.6", + "has-tostringtag": "^1.0.2", + "hasown": "^2.0.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/esbuild": { + "version": "0.21.5", + "resolved": "https://registry.npmmirror.com/esbuild/-/esbuild-0.21.5.tgz", + "integrity": "sha512-mg3OPMV4hXywwpoDxu3Qda5xCKQi+vCTZq8S9J/EpkhB2HzKXq4SNFZE3+NK93JYxc8VMSep+lOUSC/RVKaBqw==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "bin": { + "esbuild": "bin/esbuild" + }, + "engines": { + "node": ">=12" + }, + "optionalDependencies": { + "@esbuild/aix-ppc64": "0.21.5", + "@esbuild/android-arm": "0.21.5", + "@esbuild/android-arm64": "0.21.5", + "@esbuild/android-x64": "0.21.5", + "@esbuild/darwin-arm64": "0.21.5", + "@esbuild/darwin-x64": "0.21.5", + "@esbuild/freebsd-arm64": "0.21.5", + "@esbuild/freebsd-x64": "0.21.5", + "@esbuild/linux-arm": "0.21.5", + "@esbuild/linux-arm64": "0.21.5", + "@esbuild/linux-ia32": "0.21.5", + "@esbuild/linux-loong64": "0.21.5", + "@esbuild/linux-mips64el": "0.21.5", + "@esbuild/linux-ppc64": "0.21.5", + "@esbuild/linux-riscv64": "0.21.5", + "@esbuild/linux-s390x": "0.21.5", + "@esbuild/linux-x64": "0.21.5", + "@esbuild/netbsd-x64": "0.21.5", + "@esbuild/openbsd-x64": "0.21.5", + "@esbuild/sunos-x64": "0.21.5", + "@esbuild/win32-arm64": "0.21.5", + "@esbuild/win32-ia32": "0.21.5", + "@esbuild/win32-x64": "0.21.5" + } + }, + "node_modules/escalade": { + "version": "3.2.0", + "resolved": "https://registry.npmmirror.com/escalade/-/escalade-3.2.0.tgz", + "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/follow-redirects": { + "version": "1.16.0", + "resolved": "https://registry.npmmirror.com/follow-redirects/-/follow-redirects-1.16.0.tgz", + "integrity": "sha512-y5rN/uOsadFT/JfYwhxRS5R7Qce+g3zG97+JrtFZlC9klX/W5hD7iiLzScI4nZqUS7DNUdhPgw4xI8W2LuXlUw==", + "funding": [ + { + "type": "individual", + "url": "https://github.com/sponsors/RubenVerborgh" + } + ], + "license": "MIT", + "engines": { + "node": ">=4.0" + }, + "peerDependenciesMeta": { + "debug": { + "optional": true + } + } + }, + "node_modules/form-data": { + "version": "4.0.6", + "resolved": "https://registry.npmmirror.com/form-data/-/form-data-4.0.6.tgz", + "integrity": "sha512-vKatAh4SlVfgbv+YtmhiRjhEMJsYpsG1Y2rMQtR+SVSbytsSD1YGzDIcrAJmdFec88u/+VoGmxnl+80gL1tRCQ==", + "license": "MIT", + "dependencies": { + "asynckit": "^0.4.0", + "combined-stream": "^1.0.8", + "es-set-tostringtag": "^2.1.0", + "hasown": "^2.0.4", + "mime-types": "^2.1.35" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/fsevents": { + "version": "2.3.3", + "resolved": "https://registry.npmmirror.com/fsevents/-/fsevents-2.3.3.tgz", + "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/function-bind": { + "version": "1.1.2", + "resolved": "https://registry.npmmirror.com/function-bind/-/function-bind-1.1.2.tgz", + "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/gensync": { + "version": "1.0.0-beta.2", + "resolved": "https://registry.npmmirror.com/gensync/-/gensync-1.0.0-beta.2.tgz", + "integrity": "sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/get-intrinsic": { + "version": "1.3.0", + "resolved": "https://registry.npmmirror.com/get-intrinsic/-/get-intrinsic-1.3.0.tgz", + "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==", + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.2", + "es-define-property": "^1.0.1", + "es-errors": "^1.3.0", + "es-object-atoms": "^1.1.1", + "function-bind": "^1.1.2", + "get-proto": "^1.0.1", + "gopd": "^1.2.0", + "has-symbols": "^1.1.0", + "hasown": "^2.0.2", + "math-intrinsics": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/get-proto": { + "version": "1.0.1", + "resolved": "https://registry.npmmirror.com/get-proto/-/get-proto-1.0.1.tgz", + "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==", + "license": "MIT", + "dependencies": { + "dunder-proto": "^1.0.1", + "es-object-atoms": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/gopd": { + "version": "1.2.0", + "resolved": "https://registry.npmmirror.com/gopd/-/gopd-1.2.0.tgz", + "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-symbols": { + "version": "1.1.0", + "resolved": "https://registry.npmmirror.com/has-symbols/-/has-symbols-1.1.0.tgz", + "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-tostringtag": { + "version": "1.0.2", + "resolved": "https://registry.npmmirror.com/has-tostringtag/-/has-tostringtag-1.0.2.tgz", + "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==", + "license": "MIT", + "dependencies": { + "has-symbols": "^1.0.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/hasown": { + "version": "2.0.4", + "resolved": "https://registry.npmmirror.com/hasown/-/hasown-2.0.4.tgz", + "integrity": "sha512-T2UbfbBEF32wiepXIsMlTW9+dDYC6wMh/t/vYA4tuOMKqWz/n3vr1NFSxQiyP+zk2mXsoMA/i/7qV6LKut1t1A==", + "license": "MIT", + "dependencies": { + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/https-proxy-agent": { + "version": "5.0.1", + "resolved": "https://registry.npmmirror.com/https-proxy-agent/-/https-proxy-agent-5.0.1.tgz", + "integrity": "sha512-dFcAjpTQFgoLMzC2VwU+C/CbS7uRL0lWmxDITmqm7C+7F0Odmj6s9l6alZc6AELXhrnggM2CeWSXHGOdX2YtwA==", + "license": "MIT", + "dependencies": { + "agent-base": "6", + "debug": "4" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/js-tokens": { + "version": "4.0.0", + "resolved": "https://registry.npmmirror.com/js-tokens/-/js-tokens-4.0.0.tgz", + "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==", + "license": "MIT" + }, + "node_modules/jsesc": { + "version": "3.1.0", + "resolved": "https://registry.npmmirror.com/jsesc/-/jsesc-3.1.0.tgz", + "integrity": "sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==", + "dev": true, + "license": "MIT", + "bin": { + "jsesc": "bin/jsesc" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/json5": { + "version": "2.2.3", + "resolved": "https://registry.npmmirror.com/json5/-/json5-2.2.3.tgz", + "integrity": "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==", + "dev": true, + "license": "MIT", + "bin": { + "json5": "lib/cli.js" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/loose-envify": { + "version": "1.4.0", + "resolved": "https://registry.npmmirror.com/loose-envify/-/loose-envify-1.4.0.tgz", + "integrity": "sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q==", + "license": "MIT", + "dependencies": { + "js-tokens": "^3.0.0 || ^4.0.0" + }, + "bin": { + "loose-envify": "cli.js" + } + }, + "node_modules/lru-cache": { + "version": "5.1.1", + "resolved": "https://registry.npmmirror.com/lru-cache/-/lru-cache-5.1.1.tgz", + "integrity": "sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==", + "dev": true, + "license": "ISC", + "dependencies": { + "yallist": "^3.0.2" + } + }, + "node_modules/math-intrinsics": { + "version": "1.1.0", + "resolved": "https://registry.npmmirror.com/math-intrinsics/-/math-intrinsics-1.1.0.tgz", + "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/mime-db": { + "version": "1.52.0", + "resolved": "https://registry.npmmirror.com/mime-db/-/mime-db-1.52.0.tgz", + "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/mime-types": { + "version": "2.1.35", + "resolved": "https://registry.npmmirror.com/mime-types/-/mime-types-2.1.35.tgz", + "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==", + "license": "MIT", + "dependencies": { + "mime-db": "1.52.0" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmmirror.com/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "license": "MIT" + }, + "node_modules/nanoid": { + "version": "3.3.19", + "resolved": "https://registry.npmmirror.com/nanoid/-/nanoid-3.3.19.tgz", + "integrity": "sha512-Y2tUNy4ouw6tq5oDSKeQYGOyhkUBhNOcGV/02KC+6kd9eDGqdZd++mjMiIDilrBYvjEnCYvVtsuHCuP+okSfug==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "bin": { + "nanoid": "bin/nanoid.cjs" + }, + "engines": { + "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1" + } + }, + "node_modules/node-releases": { + "version": "2.0.55", + "resolved": "https://registry.npmmirror.com/node-releases/-/node-releases-2.0.55.tgz", + "integrity": "sha512-mIrE/Cw9y+9Au6dS5vDKDhQza9YvG6w+ZrS6X+ZzA7yFW/soAeaups4Qzn1bL6g5FVy8WtP79+0j82oPIbqRjQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + } + }, + "node_modules/picocolors": { + "version": "1.1.1", + "resolved": "https://registry.npmmirror.com/picocolors/-/picocolors-1.1.1.tgz", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "dev": true, + "license": "ISC" + }, + "node_modules/postcss": { + "version": "8.5.28", + "resolved": "https://registry.npmmirror.com/postcss/-/postcss-8.5.28.tgz", + "integrity": "sha512-RRuzqDtt5Y9h3quz5hWhK+TPnsmVs6WwSU6LkJMeY4HstUEDuYTG8UJSdawMRzmzAtV+KEoG8N3Qg2qLy5vM/A==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/postcss" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "nanoid": "^3.3.18", + "picocolors": "^1.1.1", + "source-map-js": "^1.2.1" + }, + "engines": { + "node": "^10 || ^12 || >=14" + } + }, + "node_modules/proxy-from-env": { + "version": "2.1.0", + "resolved": "https://registry.npmmirror.com/proxy-from-env/-/proxy-from-env-2.1.0.tgz", + "integrity": "sha512-cJ+oHTW1VAEa8cJslgmUZrc+sjRKgAKl3Zyse6+PV38hZe/V6Z14TbCuXcan9F9ghlz4QrFr2c92TNF82UkYHA==", + "license": "MIT", + "engines": { + "node": ">=10" + } + }, + "node_modules/react": { + "version": "18.3.1", + "resolved": "https://registry.npmmirror.com/react/-/react-18.3.1.tgz", + "integrity": "sha512-wS+hAgJShR0KhEvPJArfuPVN1+Hz1t0Y6n5jLrGQbkb4urgPE/0Rve+1kMB1v/oWgHgm4WIcV+i7F2pTVj+2iQ==", + "license": "MIT", + "dependencies": { + "loose-envify": "^1.1.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/react-dom": { + "version": "18.3.1", + "resolved": "https://registry.npmmirror.com/react-dom/-/react-dom-18.3.1.tgz", + "integrity": "sha512-5m4nQKp+rZRb09LNH59GM4BxTh9251/ylbKIbpe7TpGxfJ+9kv6BLkLBXIjjspbgbnIBNqlI23tRnTWT0snUIw==", + "license": "MIT", + "dependencies": { + "loose-envify": "^1.1.0", + "scheduler": "^0.23.2" + }, + "peerDependencies": { + "react": "^18.3.1" + } + }, + "node_modules/react-refresh": { + "version": "0.17.0", + "resolved": "https://registry.npmmirror.com/react-refresh/-/react-refresh-0.17.0.tgz", + "integrity": "sha512-z6F7K9bV85EfseRCp2bzrpyQ0Gkw1uLoCel9XBVWPg/TjRj94SkJzUTGfOa4bs7iJvBWtQG0Wq7wnI0syw3EBQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/react-router": { + "version": "6.30.6", + "resolved": "https://registry.npmmirror.com/react-router/-/react-router-6.30.6.tgz", + "integrity": "sha512-5HfK7k5im7LTOB0EqCQmfvy4C13G92Ssj1VTmouTK3AJvyjKTnFuCV0vcMAD/JS+JC4DvDIBRrlAeJIFjh5VWg==", + "license": "MIT", + "dependencies": { + "@remix-run/router": "1.23.4" + }, + "engines": { + "node": ">=14.0.0" + }, + "peerDependencies": { + "react": ">=16.8" + } + }, + "node_modules/react-router-dom": { + "version": "6.30.6", + "resolved": "https://registry.npmmirror.com/react-router-dom/-/react-router-dom-6.30.6.tgz", + "integrity": "sha512-0RHKZz7wwffvkU+2MFVT2NnjK44ssLEV+m0CAJaS2Ksmorrwj7WxH00jO0SOCW26/tINUnJHToXblDs33I38YQ==", + "license": "MIT", + "dependencies": { + "@remix-run/router": "1.23.4", + "react-router": "6.30.6" + }, + "engines": { + "node": ">=14.0.0" + }, + "peerDependencies": { + "react": ">=16.8", + "react-dom": ">=16.8" + } + }, + "node_modules/rollup": { + "version": "4.63.3", + "resolved": "https://registry.npmmirror.com/rollup/-/rollup-4.63.3.tgz", + "integrity": "sha512-1i2XreiAoMMXuPGD6Msj2xWrMMkHojNRKivInxGQcg7/1KuPuYlfUutLyh4drnOxUTHX9cHI4wFoat8D/NKaBw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/estree": "1.0.9" + }, + "bin": { + "rollup": "dist/bin/rollup" + }, + "engines": { + "node": ">=18.0.0", + "npm": ">=8.0.0" + }, + "optionalDependencies": { + "@napi-rs/lzma-linux-x64-gnu": "1.5.1", + "@rollup/rollup-android-arm-eabi": "4.63.3", + "@rollup/rollup-android-arm64": "4.63.3", + "@rollup/rollup-darwin-arm64": "4.63.3", + "@rollup/rollup-darwin-x64": "4.63.3", + "@rollup/rollup-freebsd-arm64": "4.63.3", + "@rollup/rollup-freebsd-x64": "4.63.3", + "@rollup/rollup-linux-arm-gnueabihf": "4.63.3", + "@rollup/rollup-linux-arm-musleabihf": "4.63.3", + "@rollup/rollup-linux-arm64-gnu": "4.63.3", + "@rollup/rollup-linux-arm64-musl": "4.63.3", + "@rollup/rollup-linux-loong64-gnu": "4.63.3", + "@rollup/rollup-linux-loong64-musl": "4.63.3", + "@rollup/rollup-linux-ppc64-gnu": "4.63.3", + "@rollup/rollup-linux-ppc64-musl": "4.63.3", + "@rollup/rollup-linux-riscv64-gnu": "4.63.3", + "@rollup/rollup-linux-riscv64-musl": "4.63.3", + "@rollup/rollup-linux-s390x-gnu": "4.63.3", + "@rollup/rollup-linux-x64-gnu": "4.63.3", + "@rollup/rollup-linux-x64-musl": "4.63.3", + "@rollup/rollup-openbsd-x64": "4.63.3", + "@rollup/rollup-openharmony-arm64": "4.63.3", + "@rollup/rollup-win32-arm64-msvc": "4.63.3", + "@rollup/rollup-win32-ia32-msvc": "4.63.3", + "@rollup/rollup-win32-x64-gnu": "4.63.3", + "@rollup/rollup-win32-x64-msvc": "4.63.3", + "fsevents": "~2.3.2" + } + }, + "node_modules/scheduler": { + "version": "0.23.2", + "resolved": "https://registry.npmmirror.com/scheduler/-/scheduler-0.23.2.tgz", + "integrity": "sha512-UOShsPwz7NrMUqhR6t0hWjFduvOzbtv7toDH1/hIrfRNIDBnnBWd0CwJTGvTpngVlmwGCdP9/Zl/tVrDqcuYzQ==", + "license": "MIT", + "dependencies": { + "loose-envify": "^1.1.0" + } + }, + "node_modules/semver": { + "version": "6.3.1", + "resolved": "https://registry.npmmirror.com/semver/-/semver-6.3.1.tgz", + "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + } + }, + "node_modules/source-map-js": { + "version": "1.2.1", + "resolved": "https://registry.npmmirror.com/source-map-js/-/source-map-js-1.2.1.tgz", + "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==", + "dev": true, + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/typescript": { + "version": "5.9.3", + "resolved": "https://registry.npmmirror.com/typescript/-/typescript-5.9.3.tgz", + "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/update-browserslist-db": { + "version": "1.3.3", + "resolved": "https://registry.npmmirror.com/update-browserslist-db/-/update-browserslist-db-1.3.3.tgz", + "integrity": "sha512-pJ2sYawQS0R/WI928Gj5GlPhTGzbMelq0+4INtSYNDV9ErKJcX6xjGWkoG/VnB3dpUm00zALaqkrUD77pO5TDQ==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/browserslist" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "escalade": "^3.2.0", + "picocolors": "^1.1.1" + }, + "bin": { + "update-browserslist-db": "cli.js" + }, + "peerDependencies": { + "browserslist": ">= 4.21.0" + } + }, + "node_modules/vite": { + "version": "5.4.21", + "resolved": "https://registry.npmmirror.com/vite/-/vite-5.4.21.tgz", + "integrity": "sha512-o5a9xKjbtuhY6Bi5S3+HvbRERmouabWbyUcpXXUA1u+GNUKoROi9byOJ8M0nHbHYHkYICiMlqxkg1KkYmm25Sw==", + "dev": true, + "license": "MIT", + "dependencies": { + "esbuild": "^0.21.3", + "postcss": "^8.4.43", + "rollup": "^4.20.0" + }, + "bin": { + "vite": "bin/vite.js" + }, + "engines": { + "node": "^18.0.0 || >=20.0.0" + }, + "funding": { + "url": "https://github.com/vitejs/vite?sponsor=1" + }, + "optionalDependencies": { + "fsevents": "~2.3.3" + }, + "peerDependencies": { + "@types/node": "^18.0.0 || >=20.0.0", + "less": "*", + "lightningcss": "^1.21.0", + "sass": "*", + "sass-embedded": "*", + "stylus": "*", + "sugarss": "*", + "terser": "^5.4.0" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + }, + "less": { + "optional": true + }, + "lightningcss": { + "optional": true + }, + "sass": { + "optional": true + }, + "sass-embedded": { + "optional": true + }, + "stylus": { + "optional": true + }, + "sugarss": { + "optional": true + }, + "terser": { + "optional": true + } + } + }, + "node_modules/yallist": { + "version": "3.1.1", + "resolved": "https://registry.npmmirror.com/yallist/-/yallist-3.1.1.tgz", + "integrity": "sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==", + "dev": true, + "license": "ISC" + } + } +} diff --git a/src/frontend/package.json b/src/frontend/package.json new file mode 100644 index 0000000..f9dec87 --- /dev/null +++ b/src/frontend/package.json @@ -0,0 +1,27 @@ +{ + "name": "ssw-jnpf-lite-react-frontend", + "private": true, + "version": "0.1.0", + "type": "module", + "scripts": { + "dev": "vite", + "build": "vite build", + "typecheck": "tsc --noEmit", + "preview": "vite preview" + }, + "dependencies": { + "axios": "^1.7.0", + "crypto-js": "^4.2.0", + "react": "^18.3.1", + "react-dom": "^18.3.1", + "react-router-dom": "^6.26.0" + }, + "devDependencies": { + "@types/crypto-js": "^4.2.2", + "@types/react": "^18.3.0", + "@types/react-dom": "^18.3.0", + "@vitejs/plugin-react": "^4.3.0", + "typescript": "^5.4.0", + "vite": "^5.2.0" + } +} diff --git a/src/frontend/src/App.tsx b/src/frontend/src/App.tsx new file mode 100644 index 0000000..dadb6f8 --- /dev/null +++ b/src/frontend/src/App.tsx @@ -0,0 +1,100 @@ +import { Routes, Route, Navigate, useLocation } from 'react-router-dom'; +import { JSX } from 'react'; +import Login from './views/Login'; +import Dashboard from './views/Dashboard'; +import DemoItem from './views/DemoItem'; +import Product from './views/Product'; +import Book from './views/Book'; +import UserManage from './views/UserManage'; +import RoleManage from './views/RoleManage'; +import OrganizeManage from './views/OrganizeManage'; +import MenuManage from './views/MenuManage'; +import DataResource from './views/DataResource'; +import { getToken } from './api/request'; + +function RequireAuth({ children }: { children: JSX.Element }) { + const token = getToken(); + const location = useLocation(); + if (!token) return ; + return children; +} + +export default function App() { + return ( + + } /> + + + + } + /> + + + + } + /> + + + + } + /> + + + + } + /> + + + + } + /> + + + + } + /> + + + + } + /> + + + + } + /> + + + + } + /> + + ); +} diff --git a/src/frontend/src/api/auth.ts b/src/frontend/src/api/auth.ts new file mode 100644 index 0000000..24cad54 --- /dev/null +++ b/src/frontend/src/api/auth.ts @@ -0,0 +1,19 @@ +import request from './request'; + +export async function login(account: string, passwordHex: string) { + const params = new URLSearchParams(); + params.set('account', account); + params.set('password', passwordHex); + params.set('grant_type', 'password'); + // Content-Type: application/x-www-form-urlencoded,与 JNPF 登录一致 + return (await request.post('/oauth/Login', params.toString(), { + headers: { 'Content-Type': 'application/x-www-form-urlencoded' }, + })) as { token: string; expiresIn: number; tokenTypeName: string }; +} + +export async function currentUser() { + return (await request.get('/oauth/CurrentUser')) as { + userInfo: any; + menuList: any[]; + }; +} diff --git a/src/frontend/src/api/book.ts b/src/frontend/src/api/book.ts new file mode 100644 index 0000000..5c9d744 --- /dev/null +++ b/src/frontend/src/api/book.ts @@ -0,0 +1,5 @@ +import request from './request'; + +export const listBooks = () => request.get('/ssw/books/Book/List'); +export const saveBook = (dto: any) => request.post('/ssw/books/Book/Save', dto); +export const deleteBook = (id: string) => request.delete(`/ssw/books/Book/Delete?id=${id}`); \ No newline at end of file diff --git a/src/frontend/src/api/dataresource.ts b/src/frontend/src/api/dataresource.ts new file mode 100644 index 0000000..fc80cfe --- /dev/null +++ b/src/frontend/src/api/dataresource.ts @@ -0,0 +1,10 @@ +import request from './request'; + +// DataResource 业务 API —— 端点对应后端 `api/ssw/asset/DataResource/{List|Save|Delete}`(面 A)。 +// +// 🔴 本文件由 `scripts/new-page.sh asset DataResource` 生成(真源 = 契约 [MODULE] + 表 DDL)。 +// 生成后**归业务所有**:可以直接改(加参数、改返回类型)——重跑生成器会跳过已存在的文件。 +export const listDataResources = () => request.get('/ssw/asset/DataResource/List'); +export const saveDataResource = (dto: any) => request.post('/ssw/asset/DataResource/Save', dto); +export const deleteDataResource = (id: string) => + request.delete(`/ssw/asset/DataResource/Delete?id=${id}`); diff --git a/src/frontend/src/api/product.ts b/src/frontend/src/api/product.ts new file mode 100644 index 0000000..3ad40fc --- /dev/null +++ b/src/frontend/src/api/product.ts @@ -0,0 +1,7 @@ +import request from './request'; + +// Product 业务 API —— 端点与后端 @Controller('api/ssw/shop/Product') 对应 +export const listProducts = () => request.get('/ssw/shop/Product/List'); +export const saveProduct = (dto: any) => request.post('/ssw/shop/Product/Save', dto); +export const deleteProduct = (id: string) => + request.delete(`/ssw/shop/Product/Delete?id=${id}`); diff --git a/src/frontend/src/api/request.ts b/src/frontend/src/api/request.ts new file mode 100644 index 0000000..c44e16d --- /dev/null +++ b/src/frontend/src/api/request.ts @@ -0,0 +1,73 @@ +import axios, { AxiosError, AxiosInstance } from 'axios'; + +/** + * 请求层 —— 复刻 JNPF/jweb 的 ActionResult 适配语义: + * - 统一 baseURL '/api'(dev 由 vite proxy 转发到 **30010** —— 本仓后端是 Rust, + * 缺省端口 30010,不是技能模板里 NestJS 的 30000,见 `vite.config.ts`) + * - 拦截器处理 code:600/601/602 -> 清 token 跳 /login(对齐 jweb enum.ts: TOKEN_TIMEOUT/TOKEN_LOGGED/TOKEN_ERROR) + * - code !== 200 -> reject + * - 成功时把 ActionResult 的 data 解包抛给调用方 + * 迁 jweb(Vue) 时这些逻辑 1:1 对应 vben 的 defHttp 拦截器,前端零改。 + */ +const TOKEN_KEY = 'ssw_token'; + +export function getToken(): string | null { + return localStorage.getItem(TOKEN_KEY); +} +export function setToken(raw: string) { + const t = raw.startsWith('bearer ') ? raw : `bearer ${raw}`; + localStorage.setItem(TOKEN_KEY, t); +} +export function clearToken() { + localStorage.removeItem(TOKEN_KEY); +} + +interface SswRequest extends AxiosInstance { + get(url: string, config?: any): Promise; + post(url: string, data?: any, config?: any): Promise; + put(url: string, data?: any, config?: any): Promise; + delete(url: string, config?: any): Promise; +} + +const request = axios.create({ baseURL: '/api', timeout: 30000 }) as SswRequest; + +request.interceptors.request.use((config) => { + const token = getToken(); + config.headers.set('App-Code', 'sswflow'); + config.headers.set('Jnpf-Origin', 'pc'); + if (token) config.headers.set('Authorization', token); + return config; +}); + +function redirectLogin() { + if (location.pathname !== '/login') { + location.replace(`/login?next=${encodeURIComponent(location.pathname + location.search)}`); + } +} + +request.interceptors.response.use( + (resp) => { + const body = resp.data || {}; + if (body.code === 600 || body.code === 601 || body.code === 602) { + clearToken(); + redirectLogin(); + return Promise.reject(new Error('NOT_LOGIN')); + } + if (body.code !== undefined && body.code !== 200) { + return Promise.reject(new Error(body.msg || '操作失败')); + } + return body.data !== undefined ? body.data : body; + }, + (error: AxiosError) => { + const status = error.response?.status; + const body: any = error.response?.data || {}; + if (status === 401 || body.code === 600 || body.code === 601 || body.code === 602) { + clearToken(); + redirectLogin(); + return Promise.reject(new Error('NOT_LOGIN')); + } + return Promise.reject(new Error(body.msg || error.message || '请求失败')); + }, +); + +export default request; diff --git a/src/frontend/src/api/sys.ts b/src/frontend/src/api/sys.ts new file mode 100644 index 0000000..b20a40d --- /dev/null +++ b/src/frontend/src/api/sys.ts @@ -0,0 +1,36 @@ +import request from './request'; + +// 用户 +export const listUsers = () => request.get('/ssw/sys/User/List'); +export const saveUser = (dto: any) => request.post('/ssw/sys/User/Save', dto); +export const deleteUser = (id: string) => + request.delete(`/ssw/sys/User/Delete?id=${id}`); + +// 角色 +export const listRoles = () => request.get('/ssw/sys/Role/List'); +export const saveRole = (dto: any) => request.post('/ssw/sys/Role/Save', dto); +export const deleteRole = (id: string) => + request.delete(`/ssw/sys/Role/Delete?id=${id}`); +export const roleModules = (roleId: string) => + request.get(`/ssw/sys/Role/Modules?roleId=${roleId}`); + +// 机构 +export const listOrganize = () => request.get('/ssw/sys/Organize/List'); +export const saveOrganize = (dto: any) => request.post('/ssw/sys/Organize/Save', dto); +export const deleteOrganize = (id: string) => + request.delete(`/ssw/sys/Organize/Delete?id=${id}`); + +// 菜单 +export const listModules = () => request.get('/ssw/sys/Module/List'); +export const saveModule = (dto: any) => request.post('/ssw/sys/Module/Save', dto); +export const deleteModule = (id: string) => + request.delete(`/ssw/sys/Module/Delete?id=${id}`); + +// 统一授权(角色→菜单,对齐 JNPF PUT /api/permission/Authority/Data/{objectId}) +// module 是一维 String[](官方 AuthorizeDataUpForm.module = String[]); +// 半选节点由调用方合并进同一数组(对齐 MenuAuth.vue: [...checkedKeys, ...halfCheckedKeys]) +export const saveRoleModules = (roleId: string, moduleIds: string[]) => + request.put(`/permission/Authority/Data/${roleId}`, { + objectType: 'role', + module: moduleIds, + }); diff --git a/src/frontend/src/main.tsx b/src/frontend/src/main.tsx new file mode 100644 index 0000000..6291701 --- /dev/null +++ b/src/frontend/src/main.tsx @@ -0,0 +1,12 @@ +import React from 'react'; +import ReactDOM from 'react-dom/client'; +import { BrowserRouter } from 'react-router-dom'; +import App from './App'; + +ReactDOM.createRoot(document.getElementById('root')!).render( + + + + + , +); diff --git a/src/frontend/src/utils/cipher.ts b/src/frontend/src/utils/cipher.ts new file mode 100644 index 0000000..a33f030 --- /dev/null +++ b/src/frontend/src/utils/cipher.ts @@ -0,0 +1,26 @@ +import CryptoJS from 'crypto-js'; + +/** + * 登录密码加密 —— 与 JNPF 后端 LiteLoginController / dacli / ssw-jnpf-lite(Vue) 完全一致。 + * 检验向量:encryptPassword('123456') === + * 'd4958348e22108119b3ef57b022c83f4bf857dd0b247eaab15b9a43d47ee3c503900f7135bf0de255bc33620c3cdc02b' + */ +const CIPHER_KEY = 'EY8WePvjM5GGwQzn'; + +function md5(str: string): string { + return CryptoJS.MD5(str).toString(); +} + +export function encryptPassword(plain: string): string { + const key = CryptoJS.enc.Utf8.parse(md5(CIPHER_KEY)); + const src = CryptoJS.enc.Utf8.parse(md5(plain)); + return CryptoJS.AES.encrypt(src, key, { + mode: CryptoJS.mode.ECB, + padding: CryptoJS.pad.Pkcs7, + }) + .ciphertext.toString(CryptoJS.enc.Hex); +} + +export function md5Hex(str: string): string { + return md5(str); +} diff --git a/src/frontend/src/views/Book.tsx b/src/frontend/src/views/Book.tsx new file mode 100644 index 0000000..b66a094 --- /dev/null +++ b/src/frontend/src/views/Book.tsx @@ -0,0 +1,155 @@ +import { useEffect, useState } from 'react'; +import { listBooks, saveBook, deleteBook } from '../api/book'; +import { wrap, card, btn, btnDanger, input as inputStyle, tableStyle, th, td } from './ui'; + +// 字段用去前缀名:id / title / author / isbn / category / price / stock +// (JNPF 后端 Jackson 会剥掉 f_ 前缀) +interface Book { + id: string; + title?: string; + author?: string; + isbn?: string; + category?: string; + price?: string; + stock?: number; +} + +export default function Books() { + const [items, setItems] = useState([]); + const [form, setForm] = useState({ + title: '', + author: '', + isbn: '', + category: '', + price: '', + stock: '', + }); + + async function load() { + const data = await listBooks(); + setItems(data || []); + } + useEffect(() => { + load(); + }, []); + + function update(k: keyof Book, v: string) { + setForm((f) => ({ ...f, [k]: v })); + } + + async function add() { + if (!form.title) return; + await saveBook({ + title: form.title, + author: form.author || undefined, + isbn: form.isbn || undefined, + category: form.category || undefined, + price: form.price || '0.00', + stock: form.stock ? Number(form.stock) : 0, + }); + setForm({ title: '', author: '', isbn: '', category: '', price: '', stock: '' }); + load(); + } + async function del(id: string) { + await deleteBook(id); + load(); + } + + return ( +
+
+

图书超市

+
+ update('title', e.target.value)} + placeholder="书名" + style={inputStyle} + /> + update('author', e.target.value)} + placeholder="作者" + style={inputStyle} + /> + update('isbn', e.target.value)} + placeholder="ISBN" + style={inputStyle} + /> + update('category', e.target.value)} + placeholder="分类" + style={inputStyle} + /> + update('price', e.target.value)} + placeholder="价格" + style={inputStyle} + /> + update('stock', e.target.value)} + placeholder="库存" + style={inputStyle} + /> +
+
+ + +
+ + + + + + + + + + + + + + {items.map((it) => ( + + + + + + + + + + ))} + {items.length === 0 && ( + + + + )} + +
书名作者ISBN分类价格库存操作
{it.title}{it.author}{it.isbn}{it.category}¥{it.price}{it.stock} + +
+ 暂无数据 +
+
+
+ ); +} \ No newline at end of file diff --git a/src/frontend/src/views/Dashboard.tsx b/src/frontend/src/views/Dashboard.tsx new file mode 100644 index 0000000..96d0283 --- /dev/null +++ b/src/frontend/src/views/Dashboard.tsx @@ -0,0 +1,64 @@ +import { useEffect, useState } from 'react'; +import { useNavigate } from 'react-router-dom'; +import { currentUser } from '../api/auth'; +import { clearToken } from '../api/request'; +import { wrap, card, btnGhost, btn } from './ui'; + +interface MenuNode { + id: string; + fullName: string; + urlAddress?: string; + icon?: string; + parentId: string; + children: MenuNode[]; +} + +export default function Dashboard() { + const nav = useNavigate(); + const [menu, setMenu] = useState([]); + const [user, setUser] = useState(null); + + useEffect(() => { + currentUser() + .then((d) => { + setMenu(d.menuList || []); + setUser(d.userInfo); + }) + .catch(() => {}); + }, []); + + function goto(addr?: string) { + if (addr) nav('/' + addr); + } + function logout() { + clearToken(); + location.reload(); + } + + return ( +
+
+

SSW JNPF Lite · React

+
+ {user?.userAccount} {user?.isAdministrator ? '(管理员)' : ''} +
+

功能菜单

+ {menu.map((node) => ( +
+
{node.fullName}
+
+ {node.children.map((c) => ( + + ))} +
+
+ ))} + +
+
+ ); +} diff --git a/src/frontend/src/views/DataResource.tsx b/src/frontend/src/views/DataResource.tsx new file mode 100644 index 0000000..d56e52d --- /dev/null +++ b/src/frontend/src/views/DataResource.tsx @@ -0,0 +1,146 @@ +import { useEffect, useState } from 'react'; +import { listDataResources, saveDataResource, deleteDataResource } from '../api/dataresource'; +import { wrap, card, btn, btnDanger, input as inputStyle, tableStyle, th, td } from './ui'; + +// 🔴 由 `scripts/new-page.sh asset DataResource` 生成:字段来自表 `asset_data_resource` 的 DDL, +// 平台列(f_id / f_tenant_id / f_delete_mark / f_creator_* …)已经滤掉。 +// `label` 暂时等于列名 —— **中文标签请按业务改**(生成器不可能猜出业务语义)。 +// ⚠️ 字段名用**去前缀**名(`f_name` ⇒ `name`):后端 Jackson 会剥掉 `f_` 前缀。 + +interface Row { + id: string; + name?: string; + category?: string; + scenario?: string; + provider?: string; + format?: string; + scale?: string; + source?: string; + register_time?: string; +} + +const FIELDS: Array<{ key: keyof Row; label: string; type: string }> = [ + { key: 'name', label: '名称', type: 'text' }, + { key: 'category', label: '分类', type: 'text' }, + { key: 'scenario', label: '场景', type: 'text' }, + { key: 'provider', label: '提供方', type: 'text' }, + { key: 'format', label: '格式', type: 'text' }, + { key: 'scale', label: '规模', type: 'text' }, + { key: 'source', label: '来源', type: 'text' }, + { key: 'register_time', label: '登记时间', type: 'datetime-local' }, +]; + +const EMPTY: Record = { + name: '', + category: '', + scenario: '', + provider: '', + format: '', + scale: '', + source: '', + register_time: '', +}; + +export default function DataResource() { + const [items, setItems] = useState([]); + const [form, setForm] = useState>(EMPTY); + + async function load() { + const data = await listDataResources(); + setItems(data || []); + } + useEffect(() => { + load(); + }, []); + + function update(k: string, v: string) { + setForm((f) => ({ ...f, [k]: v })); + } + + async function add() { + const dto: Record = {}; + for (const f of FIELDS) { + const raw = form[f.key as string]; + if (raw === undefined || raw === '') continue; + dto[f.key as string] = f.type === 'number' ? Number(raw) : raw; + } + await saveDataResource(dto); + setForm(EMPTY); + load(); + } + + async function del(id: string) { + await deleteDataResource(id); + load(); + } + + return ( +
+
+

数据资源

+
+ {FIELDS.map((f) => ( + update(f.key as string, e.target.value)} + placeholder={f.label} + style={inputStyle} + /> + ))} +
+
+ + +
+ + + + {FIELDS.map((f) => ( + + ))} + + + + + {items.map((it) => ( + + {FIELDS.map((f) => ( + + ))} + + + ))} + {items.length === 0 && ( + + + + )} + +
+ {f.label} + 操作
+ {String(it[f.key] ?? '')} + + +
+ 暂无数据 +
+
+
+ ); +} diff --git a/src/frontend/src/views/DemoItem.tsx b/src/frontend/src/views/DemoItem.tsx new file mode 100644 index 0000000..b3979e5 --- /dev/null +++ b/src/frontend/src/views/DemoItem.tsx @@ -0,0 +1,101 @@ +import { useEffect, useState } from 'react'; +import request from '../api/request'; + +// 注意:字段用去前缀名(title/status/id),与 JNPF 后端 Jackson 的 f-前缀剥离一致 +interface DemoItem { + id: string; + title?: string; + status?: string; +} + +export default function DemoItem() { + const [items, setItems] = useState([]); + const [title, setTitle] = useState(''); + + async function load() { + const data = await request.get('/ssw/demo/DemoItem/List'); + setItems(data || []); + } + useEffect(() => { + load(); + }, []); + + async function add() { + if (!title) return; + await request.post('/ssw/demo/DemoItem/Save', { title, status: '草稿' }); + setTitle(''); + load(); + } + async function del(id: string) { + await request.delete(`/ssw/demo/DemoItem/Delete?id=${id}`); + load(); + } + + return ( +
+
+

DemoItem

+
+ setTitle(e.target.value)} + placeholder="标题" + style={input} + /> + +
+
    + {items.map((it) => ( +
  • + + {it.title}({it.status}) + + +
  • + ))} +
+ +
+
+ ); +} + +const wrap: React.CSSProperties = { minHeight: '100vh', padding: 40, background: '#0f1419', color: '#eee' }; +const card: React.CSSProperties = { + display: 'flex', + flexDirection: 'column', + gap: 12, + padding: 24, + background: '#1a1f26', + borderRadius: 12, + minWidth: 360, +}; +const input: React.CSSProperties = { + padding: 8, + borderRadius: 6, + border: '1px solid #333', + background: '#0f1419', + color: '#eee', +}; +const btn: React.CSSProperties = { + padding: 8, + borderRadius: 6, + border: 0, + background: '#185fa5', + color: '#fff', + cursor: 'pointer', +}; +const link: React.CSSProperties = { + padding: 8, + background: 'transparent', + border: 0, + color: '#85b7eb', + cursor: 'pointer', + textAlign: 'left', +}; diff --git a/src/frontend/src/views/Login.tsx b/src/frontend/src/views/Login.tsx new file mode 100644 index 0000000..a578d85 --- /dev/null +++ b/src/frontend/src/views/Login.tsx @@ -0,0 +1,81 @@ +import { useState } from 'react'; +import { useNavigate, useLocation } from 'react-router-dom'; +import { login } from '../api/auth'; +import { setToken } from '../api/request'; +import { encryptPassword } from '../utils/cipher'; + +export default function Login() { + const [account, setAccount] = useState('admin'); + const [password, setPassword] = useState('123456'); + const [err, setErr] = useState(''); + const nav = useNavigate(); + const loc = useLocation(); + + async function onSubmit(e: React.FormEvent) { + e.preventDefault(); + setErr(''); + try { + const hex = encryptPassword(password); + const res = await login(account, hex); + setToken(res.token); + const next = (loc.state as any)?.from?.pathname || '/'; + nav(next); + } catch (e: any) { + setErr(e.message || '登录失败'); + } + } + + return ( +
+
+

SSW JNPF Lite · React

+ setAccount(e.target.value)} placeholder="账号" style={input} /> + setPassword(e.target.value)} + type="password" + placeholder="密码" + style={input} + /> + {err &&
{err}
} + +
默认 admin / 123456
+
+
+ ); +} + +const wrap: React.CSSProperties = { + minHeight: '100vh', + display: 'flex', + alignItems: 'center', + justifyContent: 'center', + background: '#0f1419', + color: '#eee', +}; +const card: React.CSSProperties = { + display: 'flex', + flexDirection: 'column', + gap: 12, + padding: 24, + background: '#1a1f26', + borderRadius: 12, + width: 300, +}; +const input: React.CSSProperties = { + padding: 8, + borderRadius: 6, + border: '1px solid #333', + background: '#0f1419', + color: '#eee', +}; +const btn: React.CSSProperties = { + padding: 10, + borderRadius: 6, + border: 0, + background: '#185fa5', + color: '#fff', + cursor: 'pointer', +}; diff --git a/src/frontend/src/views/MenuManage.tsx b/src/frontend/src/views/MenuManage.tsx new file mode 100644 index 0000000..35f5438 --- /dev/null +++ b/src/frontend/src/views/MenuManage.tsx @@ -0,0 +1,155 @@ +import { useEffect, useState } from 'react'; +import * as api from '../api/sys'; +import { wrap, card, btn, btnDanger, btnGhost, input, tableStyle, th, td } from './ui'; + +export default function MenuManage() { + const [rows, setRows] = useState([]); + const [editing, setEditing] = useState(null); + const [form, setForm] = useState({ + fullName: '', + urlAddress: '', + parentId: '0', + type: 2, + icon: '', + sortCode: 0, + }); + + async function load() { + setRows(await api.listModules()); + } + useEffect(() => { + load(); + }, []); + + const nameOf = (id: string) => + id === '0' ? '(根)' : (rows.find((r) => r.id === id)?.fullName ?? id); + + function openEdit(r?: any) { + if (r) + setForm({ + fullName: r.fullName, + urlAddress: r.urlAddress || '', + parentId: r.parentId || '0', + type: r.type ?? 2, + icon: r.icon || '', + sortCode: r.sortCode ?? 0, + }); + else setForm({ fullName: '', urlAddress: '', parentId: '0', type: 2, icon: '', sortCode: 0 }); + setEditing(r || {}); + } + async function submit() { + if (!form.fullName) return alert('菜单名必填'); + await api.saveModule({ ...form, id: editing?.id }); + setEditing(null); + await load(); + } + async function del(id: string) { + if (!confirm('确认删除该菜单?')) return; + await api.deleteModule(id); + await load(); + } + + return ( +
+
+

菜单管理

+ + + + + + + + + + + + + {rows.map((r) => ( + + + + + + + + ))} + +
名称地址(key)上级排序操作
{r.fullName}{r.urlAddress}{nameOf(r.parentId)}{r.sortCode} + {' '} + +
+ + {editing && ( +
+

{editing.id ? '编辑' : '新增'}菜单

+
+ setForm({ ...form, fullName: e.target.value })} + /> + setForm({ ...form, urlAddress: e.target.value })} + /> + + + setForm({ ...form, icon: e.target.value })} + /> + setForm({ ...form, sortCode: +e.target.value })} + /> +
+
+ + +
+
+ )} +
+
+ ); +} diff --git a/src/frontend/src/views/OrganizeManage.tsx b/src/frontend/src/views/OrganizeManage.tsx new file mode 100644 index 0000000..baf69ef --- /dev/null +++ b/src/frontend/src/views/OrganizeManage.tsx @@ -0,0 +1,112 @@ +import { useEffect, useState } from 'react'; +import * as api from '../api/sys'; +import { wrap, card, btn, btnDanger, btnGhost, input, tableStyle, th, td } from './ui'; + +export default function OrganizeManage() { + const [rows, setRows] = useState([]); + const [editing, setEditing] = useState(null); + const [form, setForm] = useState({ fullName: '', parentId: '0' }); + + async function load() { + setRows(await api.listOrganize()); + } + useEffect(() => { + load(); + }, []); + + const nameOf = (id: string) => + id === '0' ? '(根)' : (rows.find((r) => r.id === id)?.fullName ?? id); + + function openEdit(r?: any) { + if (r) setForm({ fullName: r.fullName, parentId: r.parentId || '0' }); + else setForm({ fullName: '', parentId: '0' }); + setEditing(r || {}); + } + async function submit() { + if (!form.fullName) return alert('机构名必填'); + await api.saveOrganize({ ...form, id: editing?.id }); + setEditing(null); + await load(); + } + async function del(id: string) { + if (!confirm('确认删除该机构?')) return; + try { + await api.deleteOrganize(id); + } catch (e: any) { + return alert(e.message || '删除失败'); + } + await load(); + } + + return ( +
+
+

机构管理

+ + + + + + + + + + + {rows.map((r) => ( + + + + + + ))} + +
名称上级操作
{r.fullName}{nameOf(r.parentId)} + {' '} + +
+ + {editing && ( +
+

{editing.id ? '编辑' : '新增'}机构

+
+ setForm({ ...form, fullName: e.target.value })} + /> + +
+
+ + +
+
+ )} +
+
+ ); +} diff --git a/src/frontend/src/views/Product.tsx b/src/frontend/src/views/Product.tsx new file mode 100644 index 0000000..7029228 --- /dev/null +++ b/src/frontend/src/views/Product.tsx @@ -0,0 +1,93 @@ +import { useEffect, useState } from 'react'; +import { listProducts, saveProduct, deleteProduct } from '../api/product'; +import { wrap, card, btn, btnDanger, input as inputStyle, tableStyle, th, td } from './ui'; + +// 字段用去前缀名:id / title / price(后端 Jackson 会剥掉 f_ 前缀) +interface Product { + id: string; + title?: string; + price?: string; +} + +export default function Product() { + const [items, setItems] = useState([]); + const [title, setTitle] = useState(''); + const [price, setPrice] = useState(''); + + async function load() { + const data = await listProducts(); + setItems(data || []); + } + useEffect(() => { + load(); + }, []); + + async function add() { + if (!title) return; + await saveProduct({ title, price: price || '0.00' }); + setTitle(''); + setPrice(''); + load(); + } + async function del(id: string) { + await deleteProduct(id); + load(); + } + + return ( +
+
+

产品管理

+
+ setTitle(e.target.value)} + placeholder="产品名称" + style={inputStyle} + /> + setPrice(e.target.value)} + placeholder="价格" + style={{ ...inputStyle, width: 100 }} + /> + + +
+ + + + + + + + + + {items.map((it) => ( + + + + + + ))} + {items.length === 0 && ( + + + + )} + +
名称价格操作
{it.title}¥{it.price} + +
+ 暂无数据 +
+
+
+ ); +} diff --git a/src/frontend/src/views/RoleManage.tsx b/src/frontend/src/views/RoleManage.tsx new file mode 100644 index 0000000..d140892 --- /dev/null +++ b/src/frontend/src/views/RoleManage.tsx @@ -0,0 +1,153 @@ +import { useEffect, useState } from 'react'; +import * as api from '../api/sys'; +import { wrap, card, btn, btnDanger, btnGhost, input, tableStyle, th, td } from './ui'; + +export default function RoleManage() { + const [rows, setRows] = useState([]); + const [modules, setModules] = useState([]); + const [editing, setEditing] = useState(null); + const [form, setForm] = useState({ fullName: '', enCode: '', description: '' }); + // 授权面板 + const [authRoleId, setAuthRoleId] = useState(''); + const [checked, setChecked] = useState([]); + + async function load() { + setRows(await api.listRoles()); + setModules(await api.listModules()); + } + useEffect(() => { + load(); + }, []); + + function openEdit(r?: any) { + if (r) setForm({ fullName: r.fullName, enCode: r.enCode || '', description: r.description || '' }); + else setForm({ fullName: '', enCode: '', description: '' }); + setEditing(r || {}); + } + async function submit() { + if (!form.fullName) return alert('角色名必填'); + await api.saveRole({ ...form, id: editing?.id }); + setEditing(null); + await load(); + } + async function del(id: string) { + if (!confirm('确认删除该角色?')) return; + await api.deleteRole(id); + await load(); + } + async function openAuth(roleId: string) { + setAuthRoleId(roleId); + const ids = (await api.roleModules(roleId)) || []; + setChecked(ids); + } + async function saveAuth() { + await api.saveRoleModules(authRoleId, checked); + alert('授权已保存'); + } + + return ( +
+
+

角色管理

+ + + + + + + + + + + {rows.map((r) => ( + + + + + + ))} + +
角色名编码操作
{r.fullName}{r.enCode} + {' '} + {' '} + +
+ + {editing && ( +
+

{editing.id ? '编辑' : '新增'}角色

+
+ setForm({ ...form, fullName: e.target.value })} + /> + setForm({ ...form, enCode: e.target.value })} + /> + setForm({ ...form, description: e.target.value })} + /> +
+
+ + +
+
+ )} + + {authRoleId && ( +
+

角色菜单授权({authRoleId})

+
+ {modules.map((m) => ( + + ))} +
+
+ + +
+
+ )} +
+
+ ); +} diff --git a/src/frontend/src/views/UserManage.tsx b/src/frontend/src/views/UserManage.tsx new file mode 100644 index 0000000..ee379ce --- /dev/null +++ b/src/frontend/src/views/UserManage.tsx @@ -0,0 +1,148 @@ +import { useEffect, useState } from 'react'; +import * as api from '../api/sys'; +import { wrap, card, btn, btnDanger, btnGhost, input, tableStyle, th, td } from './ui'; + +export default function UserManage() { + const [rows, setRows] = useState([]); + const [roleOptions, setRoleOptions] = useState([]); + const [editing, setEditing] = useState(null); + const [form, setForm] = useState({ + account: '', + realName: '', + password: '', + isAdministrator: false, + roleIds: [] as string[], + }); + + async function load() { + setRows(await api.listUsers()); + setRoleOptions(await api.listRoles()); + } + useEffect(() => { + load(); + }, []); + + function openEdit(r?: any) { + if (r) + setForm({ + account: r.account, + realName: r.realName || '', + password: '', + isAdministrator: r.isAdministrator === 1, + roleIds: r.roleIds || [], + }); + else setForm({ account: '', realName: '', password: '', isAdministrator: false, roleIds: [] }); + setEditing(r || {}); + } + async function submit() { + if (!form.account) return alert('账号必填'); + await api.saveUser({ ...form, id: editing?.id }); + setEditing(null); + await load(); + } + async function del(id: string) { + if (!confirm('确认删除该用户?')) return; + await api.deleteUser(id); + await load(); + } + + return ( +
+
+

用户管理

+ + + + + + + + + + + + + {rows.map((r) => ( + + + + + + + + ))} + +
账号姓名角色管理员操作
{r.account}{r.realName}{(r.roleNames || []).join(',')}{r.isAdministrator === 1 ? '是' : '否'} + {' '} + +
+ + {editing && ( +
+

{editing.id ? '编辑' : '新增'}用户

+
+ setForm({ ...form, account: e.target.value })} + /> + setForm({ ...form, realName: e.target.value })} + /> + setForm({ ...form, password: e.target.value })} + /> + + +
+
+ + +
+
+ )} +
+
+ ); +} diff --git a/src/frontend/src/views/ui.ts b/src/frontend/src/views/ui.ts new file mode 100644 index 0000000..d6ff532 --- /dev/null +++ b/src/frontend/src/views/ui.ts @@ -0,0 +1,46 @@ +import { CSSProperties } from 'react'; + +export const wrap: CSSProperties = { + minHeight: '100vh', + padding: 24, + background: '#0f1419', + color: '#eee', + fontFamily: 'system-ui, sans-serif', +}; +export const card: CSSProperties = { + background: '#1a1f26', + borderRadius: 12, + padding: 20, +}; +export const btn: CSSProperties = { + padding: '8px 14px', + borderRadius: 6, + border: 0, + background: '#185fa5', + color: '#fff', + cursor: 'pointer', +}; +export const btnDanger: CSSProperties = { ...btn, background: '#a1322b' }; +export const btnGhost: CSSProperties = { ...btn, background: '#2a3340' }; +export const input: CSSProperties = { + padding: 8, + borderRadius: 6, + border: '1px solid #333', + background: '#0f1419', + color: '#eee', +}; +export const tableStyle: CSSProperties = { + width: '100%', + borderCollapse: 'collapse', + marginTop: 12, +}; +export const th: CSSProperties = { + textAlign: 'left', + padding: '8px', + borderBottom: '1px solid #2a3340', + color: '#9aa7b5', +}; +export const td: CSSProperties = { + padding: '8px', + borderBottom: '1px solid #1f2630', +}; diff --git a/src/frontend/tsconfig.json b/src/frontend/tsconfig.json new file mode 100644 index 0000000..0dd4381 --- /dev/null +++ b/src/frontend/tsconfig.json @@ -0,0 +1,20 @@ +{ + "compilerOptions": { + "target": "ES2020", + "useDefineForClassFields": true, + "lib": ["ES2020", "DOM", "DOM.Iterable"], + "module": "ESNext", + "skipLibCheck": true, + "moduleResolution": "bundler", + "allowImportingTsExtensions": true, + "resolveJsonModule": true, + "isolatedModules": true, + "noEmit": true, + "jsx": "react-jsx", + "strict": false, + "noUnusedLocals": false, + "noUnusedParameters": false, + "esModuleInterop": true + }, + "include": ["src"] +} diff --git a/src/frontend/vite.config.ts b/src/frontend/vite.config.ts new file mode 100644 index 0000000..47f914f --- /dev/null +++ b/src/frontend/vite.config.ts @@ -0,0 +1,22 @@ +import { defineConfig } from 'vite'; +import react from '@vitejs/plugin-react'; + +export default defineConfig({ + plugins: [react()], + server: { + host: '127.0.0.1', // macOS 上 vite 默认只 bind ::1 (IPv6),强制 IPv4 避免 127.0.0.1 被 reset + port: 5173, + strictPort: true, // 端口被占直接报错而不是自动换端口(让 perm-smoke 端口断言稳定) + proxy: { + // 所有 /api 请求转发到本仓后端。 + // + // 🔴 **端口是 30010,不是技能模板里的 30000**: + // React 技能模板的后端是 NestJS(:30000),而本仓后端换成了 Rust + // (`src/backend/src/main.rs` 的 `PORT` 缺省 **30010**)。 + // ⇒ 照抄模板不改这里,前端每个请求都会 502,而浏览器只会说「Network Error」 + // —— 排查时最容易怀疑「跨域 / 认证」,其实只是端口抄错了。 + // 改后端默认端口时,这里要跟着改(或用 `PORT=` 起后端时同样指定)。 + '/api': 'http://127.0.0.1:30010', + }, + }, +});