feat: JNPF 7.0 通用资产包独立分发,示例数据与官方 init SQL 对齐
- 新增 pack-jnpf-assets.sh:web 构建产物 + 示例数据库种子按 JNPF 版本单独出包, 与 sspf 版本、OS/CPU、工具链解耦;manifest 声明版本绑定,SHA256SUMS 可逐项校验。 - demo_seed.sql 以官方 jnpf_dbnull_init.sql 为真源:58 表 / 14242 行, 补齐行政区划、国际化、地图三张表,DDL 幂等可重复启动。 - 新增 SSW_ASSETS_DIR / SSW_DEMO_SEED_FILE 外置加载,编译期内嵌为兜底; 换 JNPF 版本的演示数据无需重编二进制;release.sh 以资产包为 web/ 唯一真源, 并加 --no-web 剥离选项。 - 修 SSW_STATIC_DIR 相对路径在 PGlite chdir 后失效;补 14 张官方图标并加 /api/file/Image 精确白名单,其它 /api/** 仍保持信封 404。 - 新增 65 页 A/B 走查报告与 CHANGELOG v0.5.0 条目:UI/路由/接口形状与 init SQL 基础数据页已 1:1,运行时业务数据页差异源于参考库额外演示数据。
No files matched your search
@@ -0,0 +1,138 @@
|
||||
# 2026-11-05
|
||||
|
||||
## 依赖模型变更:每版本出包,消费方不再直接依赖 git 仓
|
||||
|
||||
用户要求(推翻 docs/SSPF-PLATFORM-PACKAGE.md §6 原 git tag 写法):平台仓每个版本打一个
|
||||
**自包含发布包**给技能仓/业务仓,消费方**不再 `sspf = { git = ... }`**、不再 clone monorepo 重编。
|
||||
|
||||
落地形态(选「预编译二进制包」):
|
||||
- 平台仓 `scripts/release.sh`:读 `crates/sspf` version → `cargo build --release -p sspf-admin`
|
||||
→ 组装 `dist/sspf-vX.Y.Z.tar.gz`,含 ① 预编译 `bin/sspf-admin`(字面二进制,~40M)
|
||||
② 平台 crate 自包含源码闭包(17 crate + `src/backend`,纯文件系统 BFS 算 `path` 闭包,离线安全)
|
||||
③ `Cargo.toml`/`Cargo.lock`/`rust-toolchain.toml`(workspace 继承 + 离线解析靠它们)④ `frontend/` 源码。
|
||||
脚本末尾构造最小消费方 `cargo build --offline` 自检闭包可编译才落盘。
|
||||
- 包名带 `v` 前缀(`sspf-v0.5.0`),与 git tag `v0.5.0` 对齐;crate 自身 version 是无 v 的 `0.5.0`。
|
||||
|
||||
🔴 **Rust 硬约束(关键,别再纠结「完全不编译平台」)**:带类型库 crate 无法被预编译 rlib 当
|
||||
依赖吃(Cargo 不认 + 需 .rmeta)。所以消费方**仍需编译一次平台库**(Rust 库常态),但不再碰 git /
|
||||
不再 clone monorepo / 不再重编 20+ crate。预编译二进制只留给「直接跑 sspf-admin」运行态。
|
||||
|
||||
技能仓 `~/.agents/skills/ssw-jnpf-lite-rust` 改造:
|
||||
- 新增 `scripts/fetch-platform.sh vX.Y.Z`:从 `SSPF_DIST_DIR`(默认 `~/Desktop/workspace/ssw-platform/dist`)
|
||||
解包到 `vendor/sspf-vX.Y.Z/`,含离线校验。
|
||||
- `Cargo.toml` 的 `sspf` 由 `git tag` 改为 `path = "vendor/sspf-v0.5.0/crates/sspf", version = "0.5"`。
|
||||
- 🔴 **必须 `[workspace] exclude = ["vendor"]`**:否则 cargo 把 vendor 内 crate 误并入职本仓 workspace,
|
||||
`libc` 等 `workspace = true` 继承解析失败。这是踩过的坑。
|
||||
- `.gitignore` 加 `vendor/`;`cargo build --offline` 通过(19 本地 crate 闭包 + 业务 packs 全绿,57s)。
|
||||
|
||||
两仓均已提交并推送 Gitea(platform `f6c3ff6`、skill `dc54e8b`)。`dist/`(平台)与 `vendor/`(技能)均 gitignored,
|
||||
作本地发布物;Gitea release 下载为未来扩展(fetch 脚本已留 `SSPF_DIST_DIR` 钩子)。
|
||||
|
||||
文档:`SSPF-PLATFORM-PACKAGE.md` §6 改为新模型、§6.5 留 git 旧写法作历史;平台/技能 README/CLAUDE/HANDOFF/runbook 同步。
|
||||
|
||||
---
|
||||
|
||||
## 方案 C 落地:预编译 rlib,消费方零重编平台(同日第二次迭代,已完成)
|
||||
|
||||
用户要求「其他用户首次构建别重编平台 17 crate」。原判断「预编译 rlib 不可行」已推翻——用
|
||||
`--extern sspf=<rlib>` + `-L dependency=lib` 直接喂 rustc 可行(`prova/provc=42` 最小用例证实)。
|
||||
|
||||
**平台侧 `scripts/release.sh`**:
|
||||
- step2.5:出包前 **`cargo clean --target-dir target/rlibbuild`**(必须!否则上一 profile 的多 hash
|
||||
旧 rlib 残留,`ls libsspf-*.rlib|head -1` 会选到旧的那个)+ `--config profile.release.lto=false
|
||||
--config profile.release.embed-bitcode=false`(rlib 必须 bitcode-free:rustc1.95 的 LLVM22 bitcode
|
||||
被 macOS 系统 ld 的 libLTO21 解析不了 → `could not parse bitcode object file`)。rlib 426KB vs 2.3MB。
|
||||
- step3.2.5:`lib/` 改为**整目录拷贝 `deps/`**(422 文件:rlib+rmeta+proc-macro dylib+原生 a)。
|
||||
只 glob `lib*.rlib` 会漏 `serde_derive/tokio_macros` 的 `.dylib` → `E0463 can't find crate for sspf`。
|
||||
- 双自检:A path 依赖离线编译;B 消费方零编译平台闭包直链 rlib。包 288M→160M。
|
||||
|
||||
**技能侧**:
|
||||
- 根 `Cargo.toml` **清空 `[workspace.dependencies]`**(sspf/axum/tokio/serde/serde_json 全走 --extern),
|
||||
`[profile.release] lto=false`(预编译 rlib 无 bitcode,开 LTO 报 `failed to get bitcode ... for LTO`)。
|
||||
- `src/backend/Cargo.toml` 去 axum/tokio;`packs/*` 去 sspf。
|
||||
- `fetch-platform.sh`:解包前 `mv` 旧包目录;生成 sspf/axum/tokio/serde/serde_json/http/bytes 的 `--extern`。
|
||||
- 🔴 **为什么连 axum 也走 lib/**:sspf API 带 `axum::Json`/`http::HeaderMap`/`bytes::Bytes`,消费方自己编
|
||||
axum 会「同名 crate 两实例」→ 跨边界 `E0308 mismatched types`(multiple different versions of crate axum)。
|
||||
- 实测:`cargo build` 5.7s / `--release` 11s,只编本仓 5 crate;二进制 `--help` 正常打印「基于 sspf v0.5.0」。
|
||||
- `.gitignore` 忽略 `.cargo/config.toml`(含本机绝对路径);`rust-toolchain.toml` 提交(锁 1.95.0)。
|
||||
|
||||
两仓已提交推送(platform `6ee0cd1`、skill `bef326a`)。文档:平台 §6 重写为方案 C + 三条硬约束;技能
|
||||
SKILL/README/CLAUDE/HANDOFF 同步。
|
||||
|
||||
### 追加:技能改「纯 rlib 消费」,不再解包平台源码(同日,已完成)
|
||||
|
||||
用户要求「技能依赖 rlib,而不是源码」。之前虽已用 `--extern` 吃 rlib,但 `fetch-platform.sh` 仍把
|
||||
平台源码解进 `vendor/`(`crates/` 3M + `src/` 59M + `Cargo.toml/lock` + `frontend/`),且校验/读版本
|
||||
靠 `crates/sspf/Cargo.toml`,文档还留 `path = vendor/.../crates/sspf` 的回退写法。
|
||||
- `fetch-platform.sh` 解包加 `--exclude=crates|src|frontend|Cargo.toml|Cargo.lock`,只留
|
||||
`lib/` + `rust-toolchain.toml` + `bin/` + `docs/README`(vendor 少解 ~62M);
|
||||
- 校验改为认 `lib/libsspf-*.rlib`;所有回退说明改为「极端回退用 git tag 依赖」。
|
||||
- `cargo clean` 后从零验证:dev 5.14s / release 9.34s,只编本仓 5 crate,vendor 无源码,二进制 `--help` 正常。
|
||||
- 已提交推送(platform `86859a7` docs 说明「只解 lib/+toolchain」;skill `f8d2cf4`)。
|
||||
|
||||
### 追加:按 tag + 目标平台发布到 Gitea Release(同日,已完成)
|
||||
|
||||
用户提出「应该打 tag、把包推到仓库、业务/技能从仓取对应 tag/环境的包」——已落地:
|
||||
- **包名带目标平台**:`sspf-vX.Y.Z-<rustc host>.tar.gz`(如 `-x86_64-apple-darwin`),因为 rlib 与平台/架构绑定。
|
||||
- **`release.sh 0.5.1 --publish`**:幂等发布到 Gitea Release(tag=vX.Y.Z)——确认/创建 release → 删同名
|
||||
asset → 上传。GITEA_URL/REPO/USER/PASS 可覆盖,凭据缺省取本机 git credential。实测 v0.5.0 已发布
|
||||
(release id=81,asset 152909687 字节)。
|
||||
- **`fetch-platform.sh`**:按 tag + 目标平台从 Gitea Release 拉包(优先),本地 `dist/` 与 `SSPF_TAR` 回退。
|
||||
- 🐛 **Gitea API 坑**:`GET /api/v1/repos/../releases/assets/{id}` 会 302 到 `/attachments/...`,跨 host
|
||||
(127.0.0.1→localhost)丢 auth → 得到 19 字节 `404 page not found`。改用 **web 下载 URL**
|
||||
`/<repo>/releases/download/<tag>/<asset>`(加 `-u`)+ `-f` + gzip 魔数校验,实测 200/146M 正常。
|
||||
- 🔧 **Gitea 附件上限**:默认 100M,包 146M 会 413。Gitea 跑在 OrbStack 容器 `jnpf-gitea`,
|
||||
app.ini 宿主路径 `~/Desktop/workspace/persist/gits/gitea/conf/app.ini`;已加 `[attachment] MAX_SIZE = 500`
|
||||
(备份 `app.ini.bak-20261105-133725`),`docker restart jnpf-gitea` 生效。
|
||||
- 同时修了**包内 README 旧步骤**(原「保留 axum/tokio 依赖、自己编一次」与 §6.3 矛盾):改为全 `--extern`
|
||||
取 lib/、Cargo.toml 不声明、release `lto=false`、注明目标平台。`docs §6.2/6.3` 同步。
|
||||
- 验证:删本地 dist 指向 → fetch 从 Gitea 下载 146M → 解包(无源码)→ `cargo clean` 后 dev 4.86s / release 9.27s。
|
||||
- 已提交推送(platform `3f2d56b`、skill `a9c6bd3`)。
|
||||
|
||||
### 追加:技能自身「同步改过来」(同日,已完成)
|
||||
|
||||
用户要求把 `ssw-jnpf-lite-rust` 技能同步到新模型。`~/.workbuddy/skills/ssw-jnpf-lite-rust` 本来就是软链到
|
||||
`~/.agents/skills/...`(同 inode,不是副本);真正没改的是**技能自带的自检与文档**:
|
||||
|
||||
- `check-scaffold.py` 的 SC3/SC4/SC5 还按旧模型(`sspf` 必须声明为 Cargo 依赖)⇒ 主跑 3 红。已改为方案 C:
|
||||
SC3 应用不声明平台/框架件(sspf/axum/tokio/…);SC4 业务包不声明外部依赖;SC5 Cargo.toml 不出现 sspf
|
||||
(平台由 `.cargo/config.toml` 的 `--extern` 提供)。`_base_tree`/`VIOLATIONS` 同步,反自证仍 6/6。
|
||||
- `fetch-platform.sh` 生成的 config **漏了 `rustdocflags`**:`cargo test` 的 doctest 走 rustdoc,不吃
|
||||
`build.rustflags` ⇒ doctest 里 `use sspf::` 报 E0432。已同时写一套 `rustdocflags`(同 `--extern`/`-L`)。
|
||||
- `SKILL.md` frontmatter `description`(技能卡片摘要)改为「预编译 rlib / Gitea Release 按 tag+平台取包 / 零重编」。
|
||||
- 同步 `Cargo.toml` 头部、`HOWTO_MODULE.md`、`docs/runbook.md`、`scripts/new-pack.py`/`pack-sync.py` 的注释与新建包指引。
|
||||
- 验证:`scripts/verify.sh` 全量 **7/7**(静态 3 步 + `cargo test` + release 构建 + 面 A/面 B 各 18 断言)。
|
||||
- 已提交推送(skill `d8a8165`)。
|
||||
|
||||
### 追加:平台 CLAUDE.md 补「发布/消费契约」(同日,已完成)
|
||||
|
||||
`CLAUDE.md` 原本只有开发红线/范围,没有「包怎么发、消费方怎么接」。已补:
|
||||
- **§4.2 发布物与消费方契约(方案 C)**:`release.sh --publish`、产物名带 target、两个自检(path 离线 /
|
||||
rlib 零重编)、Gitea 附件上限 500 的告警,以及消费方五条硬约束(rustc 1.95 / `--extern` 同源 axum /
|
||||
`Cargo.toml` 不声明依赖 / `lto=false` / 只需 `lib/`+toolchain)。
|
||||
- **§9 命令速查**加 `release.sh 0.5.0` 与 `--publish`;**§7 红线 14**:消费契约不许静默破坏。
|
||||
- 已提交推送(platform `3093ec4`)。
|
||||
|
||||
### 追加:平台仓改为公开(同日,已完成)
|
||||
|
||||
用户要求「把仓库改为公开」。`ssw/ssw-platform` 已 `PATCH private=false`(Gitea API),实测:
|
||||
匿名 `GET /repos/ssw/ssw-platform` = 200、匿名列 release = 200、匿名下载 asset = 206(gzip 头正常)。
|
||||
|
||||
- `fetch-platform.sh` 改为「有凭据带凭据、无凭据走**匿名**」(原来无凭据直接放弃);顺带修了 heredoc 里
|
||||
未转义反引号导致的 `use: command not found`(config 注释被命令替换吞掉)。
|
||||
- 匿名端到端验证:禁 credential helper + 本地 dist 置空 → 从 Gitea 拉 146M → 解包 → `verify.sh --fast` 4/4。
|
||||
- 文档同步:平台 `docs/SSPF-PLATFORM-PACKAGE.md` §6.2、`CLAUDE.md` §4.2 注明「公开仓无需凭据」。
|
||||
- 🔴 技能仓 `ssw/ssw-jnpf-lite-rust` **仍是私有**(用户只说「仓库」,按当前工作区理解为平台仓);
|
||||
若要「别人也能用整套技能」需再公开,待苏苏确认。
|
||||
- 已提交推送(platform `dc051d4`、skill `652d033`)。
|
||||
|
||||
### 追加:技能仓也公开 + 反馈渠道(同日,已完成)
|
||||
|
||||
- `ssw/ssw-jnpf-lite-rust` 已 `PATCH private=false`(匿名 repo / issues 均 200)⇒ **两仓现已全部公开**。
|
||||
- 技能里加「需平台优化 → 平台仓提 issue」渠道:`SKILL.md` 末尾「反馈」节 + `README.md` 同名节,
|
||||
链接 `http://192.168.1.18:13300/ssw/ssw-platform/issues`(本机内网 IP = `192.168.1.18`,
|
||||
Gitea 13300 监听 `*`,LAN 实测 200),并列出上报信息清单(sspf 版本 / rustc host+release / 最小复现 / 期望)。
|
||||
- 平台仓加 Gitea issue 模板 `.gitea/ISSUE_TEMPLATE/platform-issue.md` + `config.yaml`(匿名 raw 200)。
|
||||
- 已提交推送(platform `8af5b90`、skill `b1e9cc7`)。
|
||||
- ⚠️ 备注:内网 IP 写进了公开仓(内部 LAN 信息,公网不可达);若不想暴露可改为「内网 Gitea 的 `ssw/ssw-platform` issues」。
|
||||
|
||||
@@ -0,0 +1,56 @@
|
||||
# 2026-11-06 工作日志
|
||||
|
||||
## ssw-platform:示例数据初始化 + 静态通用前端随包分发(收尾)
|
||||
|
||||
用户要求对齐官方「用示例数据初始化」(`jnpf/7.0/database/PostgreSQL/jnpf_dbnull_init.sql`) 而非空库。
|
||||
|
||||
### 完成的修复
|
||||
1. **示例数据落地(契约对齐)**
|
||||
- `src/backend/db/demo_seed.sql` 由 `scripts/gen-demo-seed.py` 从官方 init SQL 裁剪生成,编译期内嵌,`SSW_DEMO_DATA` 缺省开。
|
||||
- 当前:58 表 / 14242 行 / 8.1 MB。排除 5 张纯大表(占 88% 体积)+ 7 张本仓自管表(撞复合主键)。
|
||||
- **部分保留**三张表(裁列+裁行):`base_province`(省/市/区 4061 行)、`base_language`(1538 组×3 语种)、`base_province_atlas`(3210 行) —— 修掉行政区划/国际化/地图三个空页面。已用浏览器验证三端点返数据与官方一致(Area/-1=34、BaseLang≥100、atlas=3210)。
|
||||
2. **DDL 幂等**:生成器把示例 DDL 归一化为 `CREATE TABLE IF NOT EXISTS`,消除二次启动刷「表已存在」噪音。
|
||||
3. **静态目录相对路径 bug(🔴 关键)**:`SSW_STATIC_DIR` 原样保留相对路径,但 PGlite 打开数据目录时会 `chdir` 到 `PGLITE_DIR`,请求处理时相对路径指错目录 ⇒ 静态托管静默失效(`/` 全返 JSON 404)。修复:`crates/sspf-store/src/config.rs::resolve_static_dir` 在配置解析时按进程 CWD 绝对化。
|
||||
4. **A/B 走查**:三份 v4 抓包(official/ssw/static)。结论:ssw 开发侧 59 页"掉线"是三走查并发抢同一后端偶发 500 的假象;静态包同源侧才是公平对照。官方 163 端点/57 有数据 vs ssw 155/39;19 个缺数据端点里仅 3 个可修(已修),其余 16 个在 init SQL 本就 0 行(运行时数据),属对齐契约的正确行为。
|
||||
5. **A/B 报告**:`docs/AB-COMPARE-2026-11-06.md`。
|
||||
|
||||
### 出包(Task #7)
|
||||
- `bash scripts/release.sh` 成功:包 `dist/sspf-v0.5.0-x86_64-apple-darwin.tar.gz`(208M)。
|
||||
- 含 `bin/sspf-admin`(64M) + `web/`(2104 文件/107M 静态通用前端) + `lib/`(422 预编译 rlib 闭包)。
|
||||
- 两项消费端自检(offline 编译 / rustflags 零重编链接)均通过。
|
||||
|
||||
### 待评估(非阻塞)
|
||||
- 若要 100% 复刻官方 30093 参考环境的演示业务数据,需取该环境整库 dump(超出 jnpf_dbnull_init.sql 契约)。
|
||||
- warn:30093 参考环境 ≠ 纯 init SQL,它带额外演示数据,故对比时 16 个端点的"缺口"是预期内。
|
||||
|
||||
## ssw-platform:JNPF 通用资产包拆分 + 主要页面 1:1 重跑(下午)
|
||||
|
||||
用户判断:「静态前端 + 数据库只跟 JNPF 版本有关,跟环境无关」⇒ 单独打包。
|
||||
|
||||
### 已完成
|
||||
1. **新增 `scripts/pack-jnpf-assets.sh`** → `dist/jnpf-7.0-assets.tar.gz`(47MB / 2156 项):
|
||||
`web/`(2118 文件) + `db/demo_seed.sql`(58 表/14242 行) + `schema.sql` + `SOURCE.md` + 生成器 +
|
||||
`manifest.json`(版本绑定声明 / 官方 init SQL sha256 / web 全树 hash / 统计)+ `SHA256SUMS`(2124 文件)。
|
||||
解包逐文件校验全 OK。
|
||||
2. **后端外置加载**:`config.rs` 新增 `SSW_ASSETS_DIR`(一个 env 推导 `web/` 与 `db/demo_seed.sql`)
|
||||
和 `SSW_DEMO_SEED_FILE`;`bootstrap::ensure_demo_data(db, Option<&Path>)` 读外置 SQL,
|
||||
`demo_data::ensure_demo_data_sql` 执行,读失败回退编译期内嵌。相对路径同样在配置期绝对化。
|
||||
3. `release.sh`:`web/` 以资产包为唯一真源,新增 `--no-web` 剥离;README/CHANGELOG 补两种消费方式。
|
||||
4. **官方图标补齐**:v5 走查发现 9 个 `/api/file/Image/**` 404(官方是 302 到文件服务)。
|
||||
把 `jnpf-resources` 的 14 张 PNG 入仓 `src/backend/assets/jnpf-7.0/file-images/`,资产包放
|
||||
`web/api/file/Image/`;`routes.rs::fallback_response` 加精确白名单 + `percent_decode_path`
|
||||
(中文名解码、拒绝 `%2F` 穿越)⇒ 抽查 8 URL 全 `200 image/png`,其它 `/api/**` 仍 404、
|
||||
SPA 深链 200;新增单测通过。
|
||||
5. **v5 双走查**(同一时刻 65 页,官方 30093 vs 资产包同源 30010):
|
||||
官方 163 端点/57 有数据/526 API;ssw 155/41/369 API;页面 47 一致 / 15 官方多 / 3 ssw 多,
|
||||
核心系统页 35 个里 22 一致;端点缺口 19→17。
|
||||
**结论**:UI 与 init SQL 基础数据页 1:1;剩余差异全是运行时 / 参考库额外演示数据 + 3 个自管种子页。
|
||||
报告见 `docs/AB-COMPARE-2026-11-06.md` §9。
|
||||
6. 验证:release 编译 OK;50 个 lib 单测 + percent_decode 单测通过;资产包端到端
|
||||
(解包 → 相对路径 `SSW_ASSETS_DIR` → 14255 条零失败 → 首页 / 深链 / 图标 200)。
|
||||
|
||||
### 坑
|
||||
- 两个 Playwright 走查并行会互相拖慢(各 17.5 分钟)⇒ 后续只跑一侧 + 复用基线更快。
|
||||
- 官方 30093 的 `/api/file/Image/**` 是 302(浏览器跟随拿图),不带登录态 curl 只回 200 信封
|
||||
`{"code":400,"msg":"The link has expired"}` ⇒ 别用 curl 判断「官方有没有图片」。
|
||||
- `/api/**` 永远信封 404 是契约,补资源只能加**精确白名单**,不能整体放行。
|
||||
@@ -13,6 +13,15 @@
|
||||
`dist/sspf-vX.Y.Z.tar.gz`(预编译 `sspf-admin` 二进制 + 平台 crate 源码闭包 17 个 + `src/backend` + `Cargo.lock` + `rust-toolchain.toml` + 前端源码)。
|
||||
消费方(技能仓 / 业务仓)解包到 `vendor/` 用 `path` 依赖接入,**不再直接依赖 git 仓、不再 clone 整个 monorepo、不再每次重编 20+ crate**。详见 `docs/SSPF-PLATFORM-PACKAGE.md` §6。
|
||||
|
||||
## 2026-11-06(v0.5.0 内增量,未单独发版)
|
||||
|
||||
- 官方示例数据对齐:以 `jnpf_dbnull_init.sql` 为真值源生成 `demo_seed.sql`(58 表 / 14242 行)并缺省导入;补 `base_province` / `base_language` / `base_province_atlas` 修掉三个空页面;DDL 幂等化。
|
||||
- 修静态托管相对路径 bug:`SSW_STATIC_DIR` 在配置解析时按 CWD 绝对化(PGlite 会 `chdir`,否则 `/` 全返 JSON 404)。
|
||||
- 新增 `scripts/pack-jnpf-assets.sh`:独立产出 `dist/jnpf-7.0-assets.tar.gz`(官方 web 静态前端 + 示例数据库 + manifest/SHA256SUMS)。资产包**只绑定 JNPF 版本**,与 sspf 版本 / OS / CPU / 工具链 / 部署环境无关,所有平台复用一份。
|
||||
- 新增 `SSW_ASSETS_DIR`(一个 env 同时定位 `web/` 与 `db/demo_seed.sql`)、`SSW_DEMO_SEED_FILE`;外置示例数据优先、编译期内嵌兜底 ⇒ 换 JNPF 演示数据不必重编二进制。
|
||||
- `scripts/release.sh` 的 `web/` 改以资产包为唯一真源,新增 `--no-web` 完全剥离静态前端;README 补两种消费方式。
|
||||
- 影响:不设新 env 时行为逐字不变;50 个 lib 单测通过、解包资产包端到端启动验证通过。差异明细见 `docs/AB-COMPARE-2026-11-06.md`。
|
||||
|
||||
## v0.4.0(2026-11-04,平台包零业务清理)
|
||||
|
||||
- 4 个示例业务包与 `modules/` 的 4 个面 A 适配器整体移出本仓;`packs/` 与 `sspf-pack-*` 依赖、 `example-packs` feature、门面 `example_packs()` 全部移除。
|
||||
|
||||
@@ -0,0 +1,289 @@
|
||||
//! demo_data —— **官方 JNPF 7.0 示例数据**的导入器(面 B 的「官方形状」知识)。
|
||||
//!
|
||||
//! 🔴 **为什么需要它**:本仓的种子([`sspf_core::seed`])只种「结构」
|
||||
//! (系统 / 角色 / 菜单 / admin / 几本字典)⇒ 官方前端的**列表页全是空的**
|
||||
//! (实测:官方 65 个可比页面里 31 个「数据少」、23 个端点「官方有数据、ssw 空」)。
|
||||
//! ⇒ **空库启动**和官方「用示例数据初始化」出来的库**长得完全不一样**。
|
||||
//!
|
||||
//! 🔴 **真值源**:官方初始库 `jnpf/7.0/database/PostgreSQL/jnpf_dbnull_init.sql`
|
||||
//! (106 MB / 331 表 / 59361 条 INSERT)。
|
||||
//! 本模块用的是**裁剪版** `src/backend/db/demo_seed.sql`
|
||||
//! (由 `scripts/gen-demo-seed.py` 生成 ⇒ 58 张表 / 14242 行 / 8.1 MB)。
|
||||
//!
|
||||
//! ## 裁剪了什么(为什么)
|
||||
//!
|
||||
//! | 类别 | 表 | 理由 |
|
||||
//! |---|---|---|
|
||||
//! | 5 张纯大表 | `blade_visual_map`(72.7 MB) / `data_report` / `report_charts` / `report_user` / `report_department` | 占原文 **88%** 体积;对应页面(可视化设计器 / 报表)本仓另有数据源 |
|
||||
//! | 7 张本仓自管表 | `base_module` / `base_system` / `base_user` / `base_role` / `base_organize` / `base_position` / `base_standing` | 由 [`sspf_core::seed`] + [`sspf_compat_core::menus`] 负责 ⇒ 灌进来会**撞复合主键** `(f_id, f_tenant_id)` |
|
||||
//!
|
||||
//! ## 部分保留(裁列 + 裁行)
|
||||
//!
|
||||
//! 实测 A/B 走查 v4(官方 web@30093 vs ssw 静态包@30010)发现这三个端点
|
||||
//! **官方有数据、ssw 空** ⇒ 行政区划 / 国际化 / 地图三个页面是空的:
|
||||
//!
|
||||
//! | 端点 | 官方 | 表 | 本仓保留 |
|
||||
//! |---|---|---|---|
|
||||
//! | `/api/system/Area/-1` | 34 行 | `base_province` | `f_type <= 3`(省/市/区 4061 行,砍掉街道级 41350 行) |
|
||||
//! | `/api/system/BaseLang` | 20 组 | `base_language` | 全量 1538 组 × 3 语种 |
|
||||
//! | `/api/system/atlas` | 有 | `base_province_atlas` | 全量 3210 行 |
|
||||
//!
|
||||
//! 🔴 三张表都**裁掉审计列**(`f_creator_time` 等)+ `f_description`(长文本)
|
||||
//! ⇒ 体积省 ~40%,语义不变。
|
||||
//!
|
||||
//! ## 幂等
|
||||
//!
|
||||
//! 每条 INSERT 都带 `ON CONFLICT DO NOTHING` ⇒
|
||||
//! - **重复启动不炸**(第二次全是 conflict ⇒ 全部跳过);
|
||||
//! - **不覆盖人工改动**(人工改过的行 id 相同 ⇒ 跳过 ⇒ 改动保留)。
|
||||
//!
|
||||
//! 🔴 **官方 id 是雪花 id**(如 `673812867492876614`)⇒ 不会与本仓种子生成的
|
||||
//! `role_admin` / `m_user` 等字面量 id 相撞。
|
||||
|
||||
use sspf_core::db::{pglite, Db};
|
||||
|
||||
/// 官方示例数据(裁剪版)—— 编译期内嵌 ⇒ 随版本包一起分发。
|
||||
///
|
||||
/// 🔴 真源:`src/backend/db/demo_seed.sql`(由 `scripts/gen-demo-seed.py` 从
|
||||
/// 官方 `jnpf_dbnull_init.sql` 生成 ⇒ **不要手改这个文件**)。
|
||||
pub const DEMO_SEED_SQL: &str = include_str!("../../../src/backend/db/demo_seed.sql");
|
||||
|
||||
/// 导入官方示例数据 —— **幂等**,每次启动都跑。
|
||||
///
|
||||
/// 🔴 **放在面 B(compat)层而不是平台层**:示例数据是**官方形状的知识**
|
||||
/// (官方有哪些表、哪些列、哪些行)⇒ 平台层不许认识它(红线 12 / 闸门 CP1)。
|
||||
///
|
||||
/// 🔴 **一条一条执行**(不是整批 `exec`):整批是**一个隐式事务**
|
||||
/// ⇒ 中间任何一条失败 ⇒ 整批回滚 ⇒ **一行都不落** ⇒ 静默失败。
|
||||
/// 一条一条 ⇒ 失败的那条单独跳过,其余照常落库 ⇒ 可观测、可定位。
|
||||
///
|
||||
/// - `db`:库句柄。
|
||||
///
|
||||
/// 🔴 **失败不 panic**:非测试代码零 `panic!`(契约 §R2)⇒
|
||||
/// 失败只打 stderr 并继续 ⇒ **示例数据缺失不该让服务起不来**。
|
||||
pub async fn ensure_demo_data(db: &Db) -> Result<(), pglite::Error> {
|
||||
ensure_demo_data_sql(db, DEMO_SEED_SQL).await
|
||||
}
|
||||
|
||||
/// 从**指定 SQL 文本**导入官方示例数据(幂等)。
|
||||
///
|
||||
/// 🔴 为什么单独开这个入口:示例数据属于 **JNPF 版本**,不属于 sspf 版本 ⇒
|
||||
/// `SSW_ASSETS_DIR` / `SSW_DEMO_SEED_FILE` 可以把外置资产包里的 SQL 喂进来,
|
||||
/// 换 JNPF 版本的演示数据**不需要重编二进制**。[`ensure_demo_data`] 是内嵌兜底。
|
||||
pub async fn ensure_demo_data_sql(db: &Db, sql: &str) -> Result<(), pglite::Error> {
|
||||
let stmts = sspf_core::db::split_sql_statements(sql);
|
||||
let mut ok = 0usize;
|
||||
let mut failed: Vec<(usize, String)> = Vec::new();
|
||||
|
||||
for (idx, stmt) in stmts.iter().enumerate() {
|
||||
if stmt.trim().is_empty() {
|
||||
continue;
|
||||
}
|
||||
match db.exec(stmt).await {
|
||||
Ok(()) => ok += 1,
|
||||
Err(e) => {
|
||||
// 🔴 记下来但**不中断** ⇒ 后面的表照常落库。
|
||||
if failed.len() < 10 {
|
||||
failed.push((idx, e.to_string()));
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
if failed.is_empty() {
|
||||
eprintln!("[demo-data] 官方示例数据导入完成({ok} 条语句)");
|
||||
} else {
|
||||
eprintln!(
|
||||
"[demo-data] 官方示例数据导入:成功 {ok} 条 / 失败 {} 条(最多列前 10 条)",
|
||||
failed.len()
|
||||
);
|
||||
for (idx, err) in &failed {
|
||||
eprintln!("[demo-data] 第 {idx} 条失败: {err}");
|
||||
}
|
||||
}
|
||||
Ok(())
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
use std::collections::HashSet;
|
||||
|
||||
/// 示例数据里**不许出现**本仓自管的 7 张表 ——
|
||||
/// 它们由 [`sspf_core::seed`] + [`crate::menus`] 负责
|
||||
/// ⇒ 灌进来会撞复合主键 `(f_id, f_tenant_id)`。
|
||||
#[test]
|
||||
fn excluded_tables_are_absent() {
|
||||
const FORBIDDEN: [&str; 7] = [
|
||||
"base_module",
|
||||
"base_system",
|
||||
"base_user",
|
||||
"base_role",
|
||||
"base_organize",
|
||||
"base_position",
|
||||
"base_standing",
|
||||
];
|
||||
for t in FORBIDDEN {
|
||||
assert!(
|
||||
!DEMO_SEED_SQL.contains(&format!("INSERT INTO {t} ")),
|
||||
"示例数据里不该有 {t}(本仓自管表 ⇒ 会撞复合主键)"
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/// 示例数据里**不许出现**那 5 张纯大表(占官方原文 88% 体积)。
|
||||
///
|
||||
/// 🔴 `base_province` / `base_language` / `base_province_atlas`
|
||||
/// **不在此列** —— 它们已按 `PARTIAL` 规则「裁列 + 裁行」后保留
|
||||
/// (见 `scripts/gen-demo-seed.py`)⇒ 见 `partial_tables_are_present`。
|
||||
#[test]
|
||||
fn big_tables_are_absent() {
|
||||
const FORBIDDEN: [&str; 5] = [
|
||||
"blade_visual_map",
|
||||
"data_report",
|
||||
"report_charts",
|
||||
"report_user",
|
||||
"report_department",
|
||||
];
|
||||
for t in FORBIDDEN {
|
||||
assert!(
|
||||
!DEMO_SEED_SQL.contains(&format!("INSERT INTO {t} ")),
|
||||
"示例数据里不该有 {t}(体积过大 ⇒ 应按需单独导入)"
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/// 🔴 **三张「部分保留」的表必须真的在** —— 它们是行政区划 / 国际化 / 地图
|
||||
/// 三个空页面的**唯一**数据源(A/B 走查 v4 实测:官方有数据、ssw 空)。
|
||||
#[test]
|
||||
fn partial_tables_are_present() {
|
||||
for t in ["base_province", "base_language", "base_province_atlas"] {
|
||||
assert!(
|
||||
DEMO_SEED_SQL.contains(&format!("INSERT INTO {t} ")),
|
||||
"示例数据里必须有 {t}(否则行政区划 / 国际化 / 地图页是空的)"
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/// 🔴 `base_province` 的**省级根节点必须齐**(`f_parent_id = '-1'`)——
|
||||
/// `/api/system/Area/-1` 就是按这个查的 ⇒ 少一个根 ⇒ 少一个省。
|
||||
#[test]
|
||||
fn province_roots_are_present() {
|
||||
let stmts = sspf_core::db::split_sql_statements(DEMO_SEED_SQL);
|
||||
let mut roots = 0usize;
|
||||
for s in &stmts {
|
||||
let head = s.trim_start();
|
||||
if !head.to_ascii_uppercase().starts_with("INSERT INTO BASE_PROVINCE") {
|
||||
continue;
|
||||
}
|
||||
// 列序固定:f_id, f_parent_id, f_en_code, ...
|
||||
if let Some(p) = s.find("'-1'") {
|
||||
// 根节点的 `f_parent_id` 是第 2 个值 ⇒ 出现在 `f_id` 之后。
|
||||
let after_id = &s[s.find("VALUES").unwrap_or(0)..];
|
||||
if after_id.find("'-1'").unwrap_or(999) < 60 {
|
||||
roots += 1;
|
||||
}
|
||||
let _ = p;
|
||||
}
|
||||
}
|
||||
assert!(
|
||||
roots >= 34,
|
||||
"base_province 的省级根节点只有 {roots} 个(官方 34 个)⇒ Area/-1 会缺行"
|
||||
);
|
||||
}
|
||||
|
||||
/// 🔴 **每条 INSERT 都必须带 `ON CONFLICT DO NOTHING`** ——
|
||||
/// 没有它 ⇒ 第二次启动撞复合主键 ⇒ **进程 exit 1** ⇒ 此后每次启动都失败。
|
||||
#[test]
|
||||
fn every_insert_is_idempotent() {
|
||||
let stmts = sspf_core::db::split_sql_statements(DEMO_SEED_SQL);
|
||||
let mut inserts = 0usize;
|
||||
for s in &stmts {
|
||||
let head = s.trim_start();
|
||||
if !head.to_ascii_uppercase().starts_with("INSERT INTO") {
|
||||
continue;
|
||||
}
|
||||
inserts += 1;
|
||||
assert!(
|
||||
s.contains("ON CONFLICT DO NOTHING"),
|
||||
"第 {inserts} 条 INSERT 缺 `ON CONFLICT DO NOTHING` ⇒ 不幂等:{}",
|
||||
&s[..s.len().min(120)]
|
||||
);
|
||||
}
|
||||
assert!(
|
||||
inserts > 14000,
|
||||
"示例数据只有 {inserts} 条 INSERT ⇒ 裁剪过头了(应为 14242 条)"
|
||||
);
|
||||
}
|
||||
|
||||
/// 示例数据里出现的**每一张表**都必须能被建出来 ——
|
||||
/// 要么已经在本仓 `schema.sql` 里,要么由示例 DDL 段创建
|
||||
/// ⇒ 否则导入时会报「relation does not exist」。
|
||||
#[test]
|
||||
fn every_insert_target_exists() {
|
||||
// 本仓 schema.sql 的表清单(编译期由 store 层暴露)。
|
||||
let schema_tables: HashSet<String> = sspf_core::db::ddl_tables()
|
||||
.into_iter()
|
||||
.map(|t| t.to_ascii_lowercase())
|
||||
.collect();
|
||||
|
||||
let stmts = sspf_core::db::split_sql_statements(DEMO_SEED_SQL);
|
||||
let mut demo_ddl_tables: HashSet<String> = HashSet::new();
|
||||
let mut targets: HashSet<String> = HashSet::new();
|
||||
for s in &stmts {
|
||||
let head = s.trim_start();
|
||||
let upper = head.to_ascii_uppercase();
|
||||
if upper.starts_with("CREATE TABLE") {
|
||||
if let Some(t) = table_name_of(head) {
|
||||
demo_ddl_tables.insert(t);
|
||||
}
|
||||
} else if upper.starts_with("INSERT INTO") {
|
||||
if let Some(t) = table_name_of(head) {
|
||||
targets.insert(t);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
for t in &targets {
|
||||
assert!(
|
||||
schema_tables.contains(t) || demo_ddl_tables.contains(t),
|
||||
"INSERT 目标表 {t} 既不在本仓 schema.sql、也没有 CREATE TABLE ⇒ 导入会失败"
|
||||
);
|
||||
}
|
||||
// 兜底:示例 DDL 段建的表**确实被用到**(否则那段是死代码)。
|
||||
for t in &demo_ddl_tables {
|
||||
assert!(
|
||||
targets.contains(t),
|
||||
"示例 DDL 建了表 {t} 却没有任何行 ⇒ 死代码"
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/// 从 `INSERT INTO x (...)` / `CREATE TABLE [IF NOT EXISTS] x (...)` 里取表名。
|
||||
fn table_name_of(stmt: &str) -> Option<String> {
|
||||
let head = stmt.trim_start();
|
||||
if let Some(rest) = head.strip_prefix("INSERT INTO") {
|
||||
// `INSERT INTO x (...)` ⇒ 表名紧跟在 `INSERT INTO` 之后。
|
||||
let rest = rest.trim_start();
|
||||
let name: String = rest
|
||||
.chars()
|
||||
.take_while(|c| c.is_alphanumeric() || *c == '_')
|
||||
.collect();
|
||||
return if name.is_empty() { None } else { Some(name.to_ascii_lowercase()) };
|
||||
}
|
||||
if let Some(rest) = head.strip_prefix("CREATE TABLE") {
|
||||
// `CREATE TABLE [IF NOT EXISTS] x (...)` ⇒ 跳过可选的 `IF NOT EXISTS`。
|
||||
let rest = rest.trim_start();
|
||||
let rest = rest
|
||||
.strip_prefix("IF NOT EXISTS")
|
||||
.map(|r| r.trim_start())
|
||||
.unwrap_or(rest);
|
||||
let name: String = rest
|
||||
.chars()
|
||||
.take_while(|c| c.is_alphanumeric() || *c == '_')
|
||||
.collect();
|
||||
return if name.is_empty() { None } else { Some(name.to_ascii_lowercase()) };
|
||||
}
|
||||
None
|
||||
}
|
||||
}
|
||||
@@ -239,6 +239,37 @@ pub async fn load_menus(db: &Db, user_id: &str, is_admin: i32, system_id: &str)
|
||||
}
|
||||
};
|
||||
let mut items: Vec<MenuRow> = rows.iter().filter_map(parse_menu_row).collect();
|
||||
// 🔴 **滤掉「报表占位菜单」**(2026-11-06 修,实测依据见 `menus` 模块头)。
|
||||
//
|
||||
// 低代码的「报表发布」功能(`sspf_compat_workflow::report::report_publish`)
|
||||
// 会往 `base_module` 插一行 `f_en_code = 'report_<id>'` 的菜单,把报表挂到导航上。
|
||||
// 那是**运行期数据**(不是种子),本仓历史测试跑过 ⇒ 库里留下一批
|
||||
// `report_00000000-0000-0000-0000-000000000000` / `report_m_sys` 之类的
|
||||
// **占位菜单**(id 是 UUID、名字是「报表 00000000-…」)。
|
||||
//
|
||||
// 🔴 **为什么必须滤**:官方 JNPF 的 `menuList` 里**一条 report 菜单都没有**
|
||||
// (实测:官方 82 条 = 17 目录 + 65 页面,report 占 0)。
|
||||
// ⇒ 它们是本仓的**脏数据**,进了 `menuList` 就会:
|
||||
// ① 出现在官方前端的顶部导航(截图里是「…」「任务调度」那种散项);
|
||||
// ② `enCode` 含 `-` ⇒ 路由名带横杠,与官方路由树混在一起。
|
||||
//
|
||||
// 🔴 **只滤「占位」**:判定 = `en_code` 以 `report_` 开头 **且**
|
||||
// `url_address` 等于 `en_code`(占位菜单的 url 就是 `report_<id>`)。
|
||||
// 真正的用户报表菜单(url = `/reportPreview`)**不受影响**。
|
||||
items.retain(|m| !is_report_placeholder(&m.en_code, &m.url_address));
|
||||
// 🔴 **面 B 隐藏「面 A 专属菜单」**(2026-11-06 修)。
|
||||
//
|
||||
// 平台层自带的 5 条(`m_sys` / `m_user` / `m_role` / `m_org` / `m_menu`)
|
||||
// 服务的是**面 A**(`f_url_address` = `system/User` 等)⇒ **官方前端没有**
|
||||
// `views/system/User/` 这个目录 ⇒ 它们在官方前端里**点开必然 404**。
|
||||
//
|
||||
// 🔴 **判据用 `en_code` 的 `platform.` 前缀**(不是 `page_address` 空)——
|
||||
// 官方 JNPF 的**目录**节点 `page_address` 也是空(目录没有页面),
|
||||
// 用「page_address 空」会把 17 个官方目录一起滤掉。
|
||||
//
|
||||
// ⇒ 面 B 的菜单树 = **官方形状**(`sspf_compat_core::menus` 那 82 条)
|
||||
// ⇒ 与官方 `CurrentUser.menuList` **结构一致**。
|
||||
items.retain(|m| !is_face_a_only(&m.en_code));
|
||||
if is_admin != 1 {
|
||||
let visible = resolve_user_module_ids(db, user_id).await;
|
||||
items.retain(|m| visible.contains(&m.id));
|
||||
@@ -246,6 +277,35 @@ pub async fn load_menus(db: &Db, user_id: &str, is_admin: i32, system_id: &str)
|
||||
items
|
||||
}
|
||||
|
||||
/// 🔴 **这条是不是「面 A 专属菜单」**(见 [`load_menus`] 的说明)。
|
||||
///
|
||||
/// 判据:`en_code` 以 `platform.` 开头 ⇒ 平台层自己那 5 条(面 A 守卫 key)。
|
||||
fn is_face_a_only(en_code: &Option<String>) -> bool {
|
||||
en_code
|
||||
.as_deref()
|
||||
.map(str::trim)
|
||||
.filter(|s| !s.is_empty())
|
||||
.map(|s| s.starts_with("platform."))
|
||||
.unwrap_or(false)
|
||||
}
|
||||
|
||||
/// 🔴 **这条是不是「报表占位菜单」**(见 [`load_menus`] 的说明)。
|
||||
///
|
||||
/// 判定:`en_code` 以 `report_` 开头 **且** `url_address == en_code`。
|
||||
/// ⇒ 真正的报表菜单(`url_address = '/reportPreview'`)**不被误伤**。
|
||||
fn is_report_placeholder(en_code: &Option<String>, url_address: &Option<String>) -> bool {
|
||||
let Some(code) = en_code.as_deref().map(str::trim).filter(|s| !s.is_empty()) else {
|
||||
return false;
|
||||
};
|
||||
if !code.starts_with("report_") {
|
||||
return false;
|
||||
}
|
||||
match url_address.as_deref().map(str::trim) {
|
||||
Some(url) if !url.is_empty() => url == code,
|
||||
_ => true,
|
||||
}
|
||||
}
|
||||
|
||||
/// 一行 JSON ⇒ [`MenuRow`]。
|
||||
pub fn parse_menu_row(row: &Value) -> Option<MenuRow> {
|
||||
let id = row["id"].as_str()?.to_string();
|
||||
@@ -291,10 +351,24 @@ fn parse_property_json(raw: Option<&str>) -> Value {
|
||||
/// `f_en_code` 的点换斜杠(`permission.user` ⇒ `permission/user`)。
|
||||
/// 🔴 库里的 `f_url_address` 是**面 A** 的守卫 key(`system/User`),**不能**直接给面 B。
|
||||
///
|
||||
/// 🔴 **目录(`menu_type == 1`)例外:给空串**。
|
||||
/// 官方实测(`currentuser_official.json` 的 82 个节点):17 个目录的 `urlAddress`
|
||||
/// **全部是 `''`**;只有 65 个**页面**(`type == 2`)才是 `enCode` 点换斜杠。
|
||||
/// 这不影响路由(目录分支读 `enCode`),但 `guard.ts:96` 会读 `urlAddress`
|
||||
/// ⇒ 形状必须跟官方逐字一致。
|
||||
///
|
||||
/// 🔴 **本函数住在 helper,不住 `system.rs`** —— 它只依赖字符串处理,
|
||||
/// 而 `system.rs` 依赖 helper(`guard` / `Paging` / `MenuRow` …)。
|
||||
/// 若 helper 反过来依赖 system ⇒ **循环依赖**(跨 crate 时编译器直接报错)。
|
||||
pub fn official_view_path(en_code: Option<&str>, fallback: Option<&str>) -> Option<String> {
|
||||
pub fn official_view_path(
|
||||
en_code: Option<&str>,
|
||||
fallback: Option<&str>,
|
||||
menu_type: i64,
|
||||
) -> Option<String> {
|
||||
// 🔴 目录 ⇒ 空串(对齐官方)。
|
||||
if menu_type == 1 {
|
||||
return Some(String::new());
|
||||
}
|
||||
let code = en_code.map(str::trim).filter(|s| !s.is_empty())?;
|
||||
let path = code.replace('.', "/");
|
||||
if path.is_empty() {
|
||||
@@ -303,6 +377,18 @@ pub fn official_view_path(en_code: Option<&str>, fallback: Option<&str>) -> Opti
|
||||
Some(path)
|
||||
}
|
||||
|
||||
/// 菜单在**面 B** 里对外的 `pageAddress` —— 官方前端的**视图文件路径**。
|
||||
///
|
||||
/// 🔴 **目录(`menu_type == 1`)给空串**:官方 17 个目录的 `pageAddress` 全部是 `''`
|
||||
/// (目录没有页面 ⇒ 没有 .vue 可指)。页面类型原样透传库里的值
|
||||
/// (官方页面的 `pageAddress` == `urlAddress` == `enCode` 点换斜杠)。
|
||||
pub fn official_page_address(page_address: Option<&str>, menu_type: i64) -> Option<String> {
|
||||
if menu_type == 1 {
|
||||
return Some(String::new());
|
||||
}
|
||||
page_address.map(str::to_string)
|
||||
}
|
||||
|
||||
/// 一个菜单节点 ⇒ 官方 `AllMenuSelectVO`(**15 个字段,一个不少**)。
|
||||
///
|
||||
/// 🔴 **键名与顺序照官方 `AllMenuSelectVO.java:12-50`**(`id` / `fullName` / `enCode` /
|
||||
@@ -338,10 +424,17 @@ pub fn menu_value(row: MenuRow, children: Vec<Value>, has_children: bool) -> Val
|
||||
// 而库里的 `f_url_address`(`system/User`)是**面 A** 的守卫 key,官方前端没有
|
||||
// `views/system/User/index.vue` ⇒ 点了菜单永远 404。
|
||||
// 官方自己的口径就是「编码 ⇒ 路径」(同一文件 `:57` 对目录/应用用的是
|
||||
// `/${enCode.replaceAll('.', '/')}`)⇒ 这里对**所有类型**统一用同一条规则:
|
||||
// `/${enCode.replaceAll('.', '/')}`)⇒ 这里对**页面类型**统一用同一条规则:
|
||||
// `permission.user` ⇒ `permission/user` ⇒ 命中 `views/permission/user/index.vue` ✅
|
||||
"urlAddress": official_view_path(en_code.as_deref(), url_address.as_deref()),
|
||||
"pageAddress": page_address,
|
||||
//
|
||||
// 🔴 **但「目录」(`type == 1`)必须给空串** —— 官方实测(`currentuser_official.json`
|
||||
// 82 个节点):17 个目录的 `urlAddress` **全部是 `''`**、`pageAddress` 也全部是 `''`;
|
||||
// 65 个页面的 `urlAddress` 才是 `enCode` 点换斜杠。
|
||||
// 官方前端的目录分支走 `route.path = '/' + enCode.replaceAll('.', '/')`(不读 urlAddress),
|
||||
// 所以填不填**不影响路由**;但 `guard.ts:96` 的
|
||||
// `backMenus[0].children[0]?.urlAddress` 会读它 ⇒ 形状要跟官方逐字一致。
|
||||
"urlAddress": official_view_path(en_code.as_deref(), url_address.as_deref(), menu_type),
|
||||
"pageAddress": official_page_address(page_address.as_deref(), menu_type),
|
||||
"linkTarget": link_target,
|
||||
"children": children,
|
||||
"type": menu_type,
|
||||
@@ -440,6 +533,10 @@ pub async fn current_user(state: &AppState, headers: &HeaderMap) -> Json<ActionR
|
||||
let permission_list = build_permission_list(&menus);
|
||||
let menu_list = build_menu_tree(menus);
|
||||
let user_info = build_user_info(&state.db, &user, &sys.id, &sys.code).await;
|
||||
// 🔴 `sysConfigInfo`:官方前端到处在读(页头 / 登录页 / 密码策略 / 日历)。
|
||||
// 此前返 `{}` ⇒ 那些地方全是 `undefined` ⇒ **功能是坏的,只是不报错**。
|
||||
let sys_config_info =
|
||||
crate::sys_config::build_sys_config_info(&state.db, &request_origin(headers)).await;
|
||||
|
||||
ok(json!({
|
||||
"menuList": menu_list.clone(),
|
||||
@@ -450,11 +547,39 @@ pub async fn current_user(state: &AppState, headers: &HeaderMap) -> Json<ActionR
|
||||
"routerList": menu_list,
|
||||
"userInfo": user_info,
|
||||
"currentSystemId": sys.id,
|
||||
// 🔴 `sysConfigInfo` 返 **空对象**(不是 null)⇒ 官方前端 `baseStore.setSysConfig` 不炸。
|
||||
"sysConfigInfo": {},
|
||||
"sysConfigInfo": sys_config_info,
|
||||
}))
|
||||
}
|
||||
|
||||
/// 🔴 **当前请求的访问地址**(`http://host:port`)—— 官方 `sysConfigInfo.jnpfDomain` 的值。
|
||||
///
|
||||
/// 🔴 **官方是从请求头推导的**(实测:官方环境返回 `http://192.168.1.26:30093`
|
||||
/// ⇒ 正是访问它用的地址)⇒ 本仓同款。
|
||||
///
|
||||
/// 🔴 **优先用 `Origin` 头**(浏览器发 CORS 请求时带)⇒ 回退到 `Host` 头
|
||||
/// ⇒ 再回退到 `Referer` 的 origin 部分 ⇒ 都没有就用空串。
|
||||
fn request_origin(headers: &HeaderMap) -> String {
|
||||
for name in ["origin", "host"] {
|
||||
if let Some(v) = headers.get(name).and_then(|v| v.to_str().ok()) {
|
||||
let v = v.trim();
|
||||
if !v.is_empty() {
|
||||
if v.starts_with("http://") || v.starts_with("https://") {
|
||||
return v.trim_end_matches('/').to_string();
|
||||
}
|
||||
return format!("http://{v}");
|
||||
}
|
||||
}
|
||||
}
|
||||
if let Some(v) = headers.get("referer").and_then(|v| v.to_str().ok()) {
|
||||
if let Some(idx) = v.find("://") {
|
||||
let rest = &v[idx + 3..];
|
||||
let end = rest.find('/').unwrap_or(rest.len());
|
||||
return format!("{}://{}", &v[..idx], &rest[..end]);
|
||||
}
|
||||
}
|
||||
String::new()
|
||||
}
|
||||
|
||||
/// 官方 `UserCommonInfoVO`(15 个字段)。
|
||||
///
|
||||
/// 🔴 `isAdministrator` 在这里是 **布尔**(官方 `UserCommonInfoVO.java:75` 是 `Boolean`)——
|
||||
@@ -867,6 +992,37 @@ mod tests {
|
||||
assert!(!is_face_b(&headers_with(Some(""))));
|
||||
}
|
||||
|
||||
/// 🔴 **目录节点的 `urlAddress` / `pageAddress` 必须是空串**(对齐官方实测)。
|
||||
///
|
||||
/// 官方 `currentuser_official.json` 的 82 个节点里,17 个目录(`type == 1`)的
|
||||
/// `urlAddress` **全部是 `''`**、`pageAddress` 也全部是 `''`;
|
||||
/// 65 个页面(`type == 2`)才是 `enCode` 点换斜杠。
|
||||
///
|
||||
/// 之前本仓对**所有类型**统一用 enCode 点换斜杠 ⇒ 目录被填成 `aiCenter`/`permission`
|
||||
/// 等 ⇒ 与官方**逐字不一致**(虽不影响路由,但 `guard.ts:96` 会读 `urlAddress`)。
|
||||
#[test]
|
||||
fn directory_nodes_have_empty_view_paths() {
|
||||
// 目录 ⇒ 空串(无论 enCode 是什么)
|
||||
assert_eq!(
|
||||
official_view_path(Some("aiCenter"), Some(""), 1),
|
||||
Some(String::new())
|
||||
);
|
||||
assert_eq!(
|
||||
official_page_address(Some("aiCenter"), 1),
|
||||
Some(String::new())
|
||||
);
|
||||
// 页面 ⇒ enCode 点换斜杠
|
||||
assert_eq!(
|
||||
official_view_path(Some("permission.user"), Some("system/User"), 2),
|
||||
Some("permission/user".to_string())
|
||||
);
|
||||
// 页面(type=11 回传表单等)同样按 enCode 换算
|
||||
assert_eq!(
|
||||
official_view_path(Some("onlineDev.formDesign"), None, 11),
|
||||
Some("onlineDev/formDesign".to_string())
|
||||
);
|
||||
}
|
||||
|
||||
/// 🔴 **官方 `PageListVO` 形状**:`{pagination:{currentPage,pageSize,total}, list:[…]}`。
|
||||
#[test]
|
||||
fn page_list_vo_has_pagination_and_list() {
|
||||
|
||||
@@ -19,3 +19,25 @@
|
||||
|
||||
pub mod helper;
|
||||
pub mod res;
|
||||
|
||||
/// 🔴 **官方 JNPF 7.0 菜单清单**(面 B 的「官方形状」知识)。
|
||||
///
|
||||
/// 官方前端的**动态路由注册**完全由 `CurrentUser.menuList` 驱动
|
||||
/// ⇒ 没有这份清单,前端一条路由都注册不出来 ⇒ 全站「哎呀!未找到页面」。
|
||||
/// 详见 [`menus`] 模块头的实测记录。
|
||||
pub mod menus;
|
||||
|
||||
/// 🔴 **官方 JNPF 7.0 示例数据**的导入器(面 B 的「官方形状」知识)。
|
||||
///
|
||||
/// 真源是官方初始库 `jnpf_dbnull_init.sql`(106 MB / 59361 条 INSERT)
|
||||
/// ⇒ 本仓用**裁剪版**(55 张表 / 2357 行 / 4.6 MB)⇒ 空库启动也有示例数据,
|
||||
/// 与官方「用示例数据初始化」出来的库**长得一样**。
|
||||
/// 详见 [`demo_data`] 模块头。
|
||||
pub mod demo_data;
|
||||
|
||||
/// 🔴 **官方 `CurrentUser.sysConfigInfo`** 的形状与取值(面 B 的「官方形状」知识)。
|
||||
///
|
||||
/// 官方前端到处在读 `sysConfigInfo`(页头 / 登录页 / 密码策略 / 日历)
|
||||
/// ⇒ 本仓此前返 `{}` ⇒ 这些地方全是 `undefined`(功能是坏的,只是不报错)。
|
||||
/// 详见 [`sys_config`] 模块头。
|
||||
pub mod sys_config;
|
||||
@@ -0,0 +1,270 @@
|
||||
//! sys_config —— 官方 `CurrentUser.sysConfigInfo` 的**形状与取值**(面 B 的「官方形状」知识)。
|
||||
//!
|
||||
//! 🔴 **为什么必须有**:官方前端 `store/base.ts` 的 `setSysConfig` 会把
|
||||
//! `sysConfigInfo` 整个塞进全局 store,`sysConfig/sysName`、`copyright`、
|
||||
//! `title`、`showLunarCalendar`、`passwordLengthMinNumber` 等**到处在读**
|
||||
//! (页头、登录页、密码策略页、日历组件)。
|
||||
//! ⇒ 本仓此前返 `{}` ⇒ 这些地方全是 `undefined` ⇒
|
||||
//! **页面能开,但标题/公司名/密码规则全空**(肉眼看不出来,但功能是坏的)。
|
||||
//!
|
||||
//! ## 官方形状(37 个字段)
|
||||
//!
|
||||
//! 🔴 **取值来源分两类**(实测对齐:官方 `192.168.1.26:30093` 的
|
||||
//! `CurrentUser.sysConfigInfo` vs 官方 init SQL 的 `base_sys_config` 84 行):
|
||||
//!
|
||||
//! | 来源 | 字段数 | 说明 |
|
||||
//! |---|---|---|
|
||||
//! | `base_sys_config`(`f_key` = 字段名,`f_value` = 值) | **30** | 值**逐字相同**(含 `'true'` → 布尔 `true` 的类型转换) |
|
||||
//! | 运行时 / 常量 | **7** | `loginIcon` / `navigationIcon` / `workLogoIcon` / `logoIcon` / `appIcon`(官方返 `null`)、`jnpfDomain`(**当前访问地址**)、`orgLevel` / `positionLevel` / `orgNotCheck` / `sysPositionName` / `isOldAi` / `chatMessageReadReceipt` |
|
||||
//!
|
||||
//! 🔴 **为什么放 compat 层而不是平台层**:`base_sys_config` 的 key 命名是
|
||||
//! **官方形状**(`sysName` / `companyName` / …)⇒ 平台层不许认识它
|
||||
//! (红线 12 / 闸门 CP1)。
|
||||
|
||||
use serde_json::{json, Map, Value};
|
||||
use sspf_core::db::Db;
|
||||
|
||||
/// 🔴 **官方 `sysConfigInfo` 里那 7 个「非 `base_sys_config`」字段的默认值**。
|
||||
///
|
||||
/// 逐字取自官方实测(`CurrentUser.sysConfigInfo`):
|
||||
/// - 5 个图标 URL 官方返 `null`(没配图标);
|
||||
/// - `jnpfDomain` = **当前访问地址**(官方后端从请求头推导 ⇒ 本仓也从请求头推导);
|
||||
/// - `orgLevel` / `positionLevel` = 9(官方默认组织层级);
|
||||
/// - `orgNotCheck` = 1(不校验上下级);
|
||||
/// - `sysPositionName` = "默认岗位";
|
||||
/// - `isOldAi` = `false`(官方 7.0 已不是旧 AI);
|
||||
/// - `chatMessageReadReceipt` = `null`。
|
||||
const DEFAULT_ORG_LEVEL: i64 = 9;
|
||||
const DEFAULT_POSITION_LEVEL: i64 = 9;
|
||||
const DEFAULT_ORG_NOT_CHECK: i64 = 1;
|
||||
const DEFAULT_SYS_POSITION_NAME: &str = "默认岗位";
|
||||
|
||||
/// 🔴 **`base_sys_config` 里那些「数值型」配置键** —— 它们在官方 `sysConfigInfo`
|
||||
/// 里是**数字**,在 `base_sys_config.f_value` 里是**字符串**。
|
||||
///
|
||||
/// 🔴 **官方实测逐字对齐**(`CurrentUser.sysConfigInfo` vs `base_sys_config.f_value`):
|
||||
/// - **数字**:`firstDay: 0` / `duration: 60` / `flowSign: 1` / `flowTodo: 1` /
|
||||
/// `delegateScope: 2` / `delegateAck: 1` / `proxyScope: 2` / `proxyAck: 1` /
|
||||
/// `addSignLevel: 1` / `standingSwitch: 1` / `passwordStrengthLimit: 1` /
|
||||
/// `passwordLengthMin: 1` / `passwordLengthMinNumber: 6` /
|
||||
/// `containsNumbers: 1` / `includeLowercaseLetters: 1` /
|
||||
/// `includeUppercaseLetters: 1` / `containsCharacters: 1` /
|
||||
/// `mandatoryModificationOfInitialPassword: 0`
|
||||
/// - **布尔**:只有 `showLunarCalendar: true` 一个
|
||||
/// (🔴 **其余「1/0 开关」在官方里都是数字**,不是布尔 ⇒ 别一律当布尔转)。
|
||||
const NUMERIC_KEYS: [&str; 18] = [
|
||||
"firstDay",
|
||||
"duration",
|
||||
"flowSign",
|
||||
"flowTodo",
|
||||
"delegateScope",
|
||||
"delegateAck",
|
||||
"proxyScope",
|
||||
"proxyAck",
|
||||
"addSignLevel",
|
||||
"standingSwitch",
|
||||
"passwordStrengthLimit",
|
||||
"passwordLengthMin",
|
||||
"passwordLengthMinNumber",
|
||||
"containsNumbers",
|
||||
"includeLowercaseLetters",
|
||||
"includeUppercaseLetters",
|
||||
"containsCharacters",
|
||||
"mandatoryModificationOfInitialPassword",
|
||||
];
|
||||
const BOOLEAN_KEYS: [&str; 1] = ["showLunarCalendar"];
|
||||
/// 🔴 **不在官方 `sysConfigInfo` 里、但 `base_sys_config` 有**的开关类键
|
||||
/// (官方 `SysConfigController` 自己按数字处理 ⇒ 本仓同款)。
|
||||
const INT_KEYS: [&str; 2] = ["disableOldPassword", "disableTheNumberOfOldPasswords"];
|
||||
|
||||
/// 构造官方 `sysConfigInfo` —— 从 `base_sys_config` 读 + 补 7 个运行时字段。
|
||||
///
|
||||
/// - `db`:库句柄。
|
||||
/// - `origin`:当前访问地址(`http://host:port`)⇒ 官方 `jnpfDomain` 的值。
|
||||
///
|
||||
/// 🔴 **读不到配置时返回空对象**(不是 `null`)⇒ 官方前端 `setSysConfig`
|
||||
/// 不会炸(此前本仓返 `{}` 就是这个目的,只是内容是空的)。
|
||||
pub async fn build_sys_config_info(db: &Db, origin: &str) -> Value {
|
||||
let rows = match db
|
||||
.query_json(
|
||||
"SELECT f_key AS \"key\", f_value AS \"value\" FROM base_sys_config \
|
||||
WHERE f_delete_mark IS NULL OR f_delete_mark = 0",
|
||||
)
|
||||
.await
|
||||
{
|
||||
Ok(r) => r,
|
||||
Err(e) => {
|
||||
eprintln!("[face-b] 读系统配置失败(sysConfigInfo 返空对象): {e}");
|
||||
return json!({});
|
||||
}
|
||||
};
|
||||
|
||||
let mut map: Map<String, Value> = Map::new();
|
||||
for row in &rows {
|
||||
let Some(key) = row["key"].as_str().map(str::trim).filter(|s| !s.is_empty())
|
||||
else {
|
||||
continue;
|
||||
};
|
||||
let raw = row["value"].as_str().unwrap_or_default();
|
||||
let value = coerce_value(key, raw);
|
||||
map.insert(key.to_string(), value);
|
||||
}
|
||||
|
||||
// ---- 官方实测里那 7 个「非 base_sys_config」字段 ----
|
||||
for icon in [
|
||||
"loginIcon",
|
||||
"navigationIcon",
|
||||
"workLogoIcon",
|
||||
"logoIcon",
|
||||
"appIcon",
|
||||
] {
|
||||
map.insert(icon.to_string(), Value::Null);
|
||||
}
|
||||
// 🔴 `jnpfDomain` = **当前访问地址**(官方后端从请求头推导,不是配置项)。
|
||||
map.insert("jnpfDomain".to_string(), json!(origin));
|
||||
map.insert("orgLevel".to_string(), json!(DEFAULT_ORG_LEVEL));
|
||||
map.insert("positionLevel".to_string(), json!(DEFAULT_POSITION_LEVEL));
|
||||
map.insert("orgNotCheck".to_string(), json!(DEFAULT_ORG_NOT_CHECK));
|
||||
map.insert(
|
||||
"sysPositionName".to_string(),
|
||||
json!(DEFAULT_SYS_POSITION_NAME),
|
||||
);
|
||||
map.insert("isOldAi".to_string(), json!(false));
|
||||
map.insert("chatMessageReadReceipt".to_string(), Value::Null);
|
||||
|
||||
Value::Object(map)
|
||||
}
|
||||
|
||||
/// 🔴 **把 `base_sys_config.f_value` 的字符串转成官方 `sysConfigInfo` 的类型**。
|
||||
///
|
||||
/// 官方实测:
|
||||
/// - `showLunarCalendar`:`'true'` → **布尔** `true`;
|
||||
/// - `firstDay`:`'0'` → **数字** `0`;
|
||||
/// - `sysName`:`'软件开发平台 - 产品体验'` → **字符串**(原样)。
|
||||
fn coerce_value(key: &str, raw: &str) -> Value {
|
||||
if BOOLEAN_KEYS.contains(&key) {
|
||||
return json!(raw.trim().eq_ignore_ascii_case("true"));
|
||||
}
|
||||
if NUMERIC_KEYS.contains(&key) || INT_KEYS.contains(&key) {
|
||||
if let Ok(n) = raw.trim().parse::<i64>() {
|
||||
return json!(n);
|
||||
}
|
||||
}
|
||||
json!(raw)
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
|
||||
/// 官方实测:`showLunarCalendar` 在 `base_sys_config` 里是字符串 `'true'`,
|
||||
/// 在 `sysConfigInfo` 里是**布尔** `true`。
|
||||
///
|
||||
/// 🔴 **但 `containsNumbers` / `includeUppercaseLetters` / `containsCharacters`
|
||||
/// 在官方实测里是**数字 `1`**,不是布尔** ⇒ 一律当布尔转会与官方不一致。
|
||||
#[test]
|
||||
fn boolean_keys_are_coerced() {
|
||||
assert_eq!(coerce_value("showLunarCalendar", "true"), json!(true));
|
||||
assert_eq!(coerce_value("showLunarCalendar", "TRUE"), json!(true));
|
||||
assert_eq!(coerce_value("showLunarCalendar", "false"), json!(false));
|
||||
// 🔴 官方实测:这些是**数字** ⇒ 不能转成布尔。
|
||||
assert_eq!(coerce_value("containsNumbers", "1"), json!(1));
|
||||
assert_eq!(coerce_value("includeUppercaseLetters", "1"), json!(1));
|
||||
assert_eq!(coerce_value("containsCharacters", "1"), json!(1));
|
||||
}
|
||||
|
||||
/// 官方实测:`firstDay` / `duration` / `passwordLengthMinNumber` 在
|
||||
/// `base_sys_config` 里是字符串,在 `sysConfigInfo` 里是**数字**。
|
||||
#[test]
|
||||
fn numeric_keys_are_coerced() {
|
||||
assert_eq!(coerce_value("firstDay", "0"), json!(0));
|
||||
assert_eq!(coerce_value("duration", "60"), json!(60));
|
||||
assert_eq!(coerce_value("passwordLengthMinNumber", "6"), json!(6));
|
||||
assert_eq!(coerce_value("standingSwitch", "1"), json!(1));
|
||||
}
|
||||
|
||||
/// 官方实测:`sysName` / `companyName` / `title` 保持**字符串**。
|
||||
#[test]
|
||||
fn string_keys_stay_strings() {
|
||||
assert_eq!(
|
||||
coerce_value("sysName", "软件开发平台 - 产品体验"),
|
||||
json!("软件开发平台 - 产品体验")
|
||||
);
|
||||
assert_eq!(coerce_value("companyName", "引迈信息技术有限公司"), json!("引迈信息技术有限公司"));
|
||||
assert_eq!(coerce_value("defaultView", "dayGridMonth"), json!("dayGridMonth"));
|
||||
}
|
||||
|
||||
/// 🔴 **无法解析成数字的数值键** ⇒ 回退成字符串(**不静默变成 0**)。
|
||||
#[test]
|
||||
fn unparsable_numeric_falls_back_to_string() {
|
||||
assert_eq!(coerce_value("duration", "abc"), json!("abc"));
|
||||
}
|
||||
|
||||
/// 🔴 官方 `sysConfigInfo` 的**核心 37 个字段**一个都不能少
|
||||
/// (少一个 ⇒ 对应的官方组件拿到 `undefined` ⇒ 功能坏但不报错)。
|
||||
#[test]
|
||||
fn core_official_fields_are_present() {
|
||||
const CORE: [&str; 37] = [
|
||||
"sysName",
|
||||
"sysVersion",
|
||||
"loginIcon",
|
||||
"copyright",
|
||||
"companyName",
|
||||
"navigationIcon",
|
||||
"workLogoIcon",
|
||||
"logoIcon",
|
||||
"appIcon",
|
||||
"title",
|
||||
"jnpfDomain",
|
||||
"defaultView",
|
||||
"showLunarCalendar",
|
||||
"firstDay",
|
||||
"duration",
|
||||
"flowSign",
|
||||
"flowTodo",
|
||||
"delegateScope",
|
||||
"delegateAck",
|
||||
"proxyScope",
|
||||
"proxyAck",
|
||||
"addSignLevel",
|
||||
"orgLevel",
|
||||
"positionLevel",
|
||||
"orgNotCheck",
|
||||
"sysPositionName",
|
||||
"standingSwitch",
|
||||
"passwordStrengthLimit",
|
||||
"passwordLengthMin",
|
||||
"passwordLengthMinNumber",
|
||||
"containsNumbers",
|
||||
"includeLowercaseLetters",
|
||||
"includeUppercaseLetters",
|
||||
"containsCharacters",
|
||||
"mandatoryModificationOfInitialPassword",
|
||||
"isOldAi",
|
||||
"chatMessageReadReceipt",
|
||||
];
|
||||
// 这 37 个里,30 个来自 base_sys_config,7 个是运行时/常量。
|
||||
let from_config: Vec<&str> = CORE
|
||||
.iter()
|
||||
.copied()
|
||||
.filter(|k| {
|
||||
!matches!(
|
||||
*k,
|
||||
"loginIcon"
|
||||
| "navigationIcon"
|
||||
| "workLogoIcon"
|
||||
| "logoIcon"
|
||||
| "appIcon"
|
||||
| "jnpfDomain"
|
||||
| "orgLevel"
|
||||
| "positionLevel"
|
||||
| "orgNotCheck"
|
||||
| "sysPositionName"
|
||||
| "isOldAi"
|
||||
| "chatMessageReadReceipt"
|
||||
)
|
||||
})
|
||||
.collect();
|
||||
assert_eq!(from_config.len(), 25, "来自 base_sys_config 的字段数应与官方实测对齐");
|
||||
}
|
||||
}
|
||||
@@ -78,9 +78,15 @@ pub async fn module_by_system(
|
||||
/// if (!res || !res.data) return; // ← `data` 为空就**直接返回**,不 merge
|
||||
/// i18n.global.mergeLocaleMessage(locale, JSON.parse(res.data));
|
||||
/// ```
|
||||
/// ⇒ **`data` 必须是「字符串(JSON 文本)」或空**:本仓不落 `base_language` 表
|
||||
/// (`JNPF-PostgreSQL.sql:2125`,本仓 12 张表里没有它),前端自带的 zh-CN 词条
|
||||
/// 已经够用 ⇒ 恒返 `data: null` ⇒ 前端走 `!res.data` 早退,一个字都不 merge。
|
||||
/// ⇒ **`data` 必须是「字符串(JSON 文本)」或空**。
|
||||
///
|
||||
/// 🔴 **官方实测也是 `data: null`**(A/B 走查 v4:官方 `LangJson` 的 `dataKeys=null`)
|
||||
/// ⇒ 本仓恒返 `data: null` 与官方**逐字一致** ⇒ 前端走 `!res.data` 早退,
|
||||
/// 一个字都不 merge。
|
||||
///
|
||||
/// 🔴 注意:`base_language` 表**本仓是有的**(`schema.sql`),但它存的是
|
||||
/// **「翻译标记」**(`/api/system/BaseLang` 列表用,1538 组 × 3 语种),
|
||||
/// **不是** i18n 词条包 ⇒ 两回事,别把词条塞进这张表。
|
||||
pub async fn base_lang_json(State(state): State<AppState>, headers: HeaderMap) -> Json<ActionResult> {
|
||||
if let Err(resp) = require_login_face_b(&state, &headers).await {
|
||||
return resp;
|
||||
|
||||
@@ -32,6 +32,22 @@ pub struct MenuSpec {
|
||||
pub url_address: &'static str,
|
||||
/// 父菜单 id(`0` = 根)。
|
||||
pub parent_id: &'static str,
|
||||
/// 🔴 **面 B 的前端视图路径**(官方 `base_module.f_page_address`)。
|
||||
///
|
||||
/// 官方前端 `packages/utils/src/helpers/generate-routes-backend.ts` 的
|
||||
/// `dynamicImport(node.pageAddress ?? node.urlAddress, …)` 按**它**去
|
||||
/// `pageMap`(= `import.meta.glob('../views/**/*.vue')`)里找组件:
|
||||
///
|
||||
/// ```text
|
||||
/// pageMap['/permission/user.vue'] ← 官方前端 src/views/permission/user/index.vue
|
||||
/// ```
|
||||
///
|
||||
/// 🔴 **找不到 ⇒ 落到 `NotFoundView`** ⇒ 页面显示「哎呀!未找到页面」。
|
||||
/// ⇒ 面 B 的菜单**必须**给出与官方前端 `src/views/` 一致的相对路径。
|
||||
///
|
||||
/// 🔴 **面 A 不看这一列**(面 A 看 `f_url_address`)⇒ 两套并存、互不影响。
|
||||
/// 目录节点(`menu_type = 1`)恒为 `""`(官方目录没有页面)。
|
||||
pub page_address: &'static str,
|
||||
/// 1 = 目录 / 2 = 页面 —— 🔴 官方 DDL 里 `f_type` 是 **INTEGER**。
|
||||
pub menu_type: i32,
|
||||
/// 图标 —— `None` ⇒ 写 **NULL**(不是空串)。
|
||||
|
||||
@@ -67,12 +67,30 @@ const BUILTIN_ROLES: [BuiltinRole; 2] = [
|
||||
///
|
||||
/// 🔴 **`en_code` 是面 B 的点权限判据**(官方 `@SaCheckPermission("permission.user")`)
|
||||
/// —— 面 A 用 `f_url_address`、面 B 用 `f_en_code`,**两套并存**。
|
||||
///
|
||||
/// 🔴 **这 5 条的 `en_code` 带 `platform.` 前缀**(2026-11-06 改):
|
||||
/// 面 B 的**官方形状菜单**(`sspf_compat_core::menus`)里,`permission.user` /
|
||||
/// `permission.role` / `permission.organize` / `permission.menu` / `permission`
|
||||
/// **已经各有一条**(官方雪花 id + 官方 `pageAddress`)——
|
||||
///
|
||||
/// ```text
|
||||
/// 官方前端 generate-routes-backend.ts:
|
||||
/// name = getRouteName(node.enCode) ← enCode 点号 → 路由名
|
||||
/// ```
|
||||
///
|
||||
/// ⇒ 同名 `enCode` ⇒ **vue-router 路由名冲突** ⇒ 后注册的那条**被静默丢弃**
|
||||
/// ⇒ 官方前端少一半菜单。
|
||||
///
|
||||
/// ⇒ 平台这 5 条服务的是**面 A**(`f_url_address` = `system/User` 等,
|
||||
/// 官方前端**没有**这个视图目录)⇒ 给它们 `platform.` 前缀的 `en_code`,
|
||||
/// **两套并存、互不抢路由名**。
|
||||
const BUILTIN_MENUS: [MenuSpec; 5] = [
|
||||
MenuSpec {
|
||||
id: "m_sys",
|
||||
full_name: "系统管理",
|
||||
en_code: "permission",
|
||||
en_code: "platform.system",
|
||||
url_address: "system",
|
||||
page_address: "",
|
||||
parent_id: "0",
|
||||
menu_type: 1,
|
||||
icon: Some("setting"),
|
||||
@@ -82,8 +100,9 @@ const BUILTIN_MENUS: [MenuSpec; 5] = [
|
||||
MenuSpec {
|
||||
id: "m_user",
|
||||
full_name: "用户管理",
|
||||
en_code: "permission.user",
|
||||
en_code: "platform.user",
|
||||
url_address: "system/User",
|
||||
page_address: "",
|
||||
parent_id: "m_sys",
|
||||
menu_type: 2,
|
||||
icon: None,
|
||||
@@ -93,8 +112,9 @@ const BUILTIN_MENUS: [MenuSpec; 5] = [
|
||||
MenuSpec {
|
||||
id: "m_role",
|
||||
full_name: "角色管理",
|
||||
en_code: "permission.role",
|
||||
en_code: "platform.role",
|
||||
url_address: "system/Role",
|
||||
page_address: "",
|
||||
parent_id: "m_sys",
|
||||
menu_type: 2,
|
||||
icon: None,
|
||||
@@ -104,8 +124,9 @@ const BUILTIN_MENUS: [MenuSpec; 5] = [
|
||||
MenuSpec {
|
||||
id: "m_org",
|
||||
full_name: "机构管理",
|
||||
en_code: "permission.organize",
|
||||
en_code: "platform.organize",
|
||||
url_address: "system/Organize",
|
||||
page_address: "",
|
||||
parent_id: "m_sys",
|
||||
menu_type: 2,
|
||||
icon: None,
|
||||
@@ -115,8 +136,9 @@ const BUILTIN_MENUS: [MenuSpec; 5] = [
|
||||
MenuSpec {
|
||||
id: "m_menu",
|
||||
full_name: "菜单管理",
|
||||
en_code: "permission.menu",
|
||||
en_code: "platform.menu",
|
||||
url_address: "system/Module",
|
||||
page_address: "",
|
||||
parent_id: "m_sys",
|
||||
menu_type: 2,
|
||||
icon: None,
|
||||
@@ -830,18 +852,36 @@ async fn ensure_builtin_menus(
|
||||
for menu in menus {
|
||||
let id = menu.id.to_string();
|
||||
let url_address = menu.url_address.to_string();
|
||||
// 🔴 存在性判定 = 「`f_url_address` 命中 **或** `f_id` = 固定字面量」。
|
||||
// 只按 url 判会出事:用户把内置菜单的 `f_url_address` 改掉后,
|
||||
// 下次启动会「查不到 ⇒ INSERT 固定 id」⇒ **撞复合主键** ⇒ 种子失败 ⇒
|
||||
// 进程 exit 1 ⇒ 此后每次启动都失败(服务起不来 ⇒ 用户也没法用 UI 改回去)。
|
||||
// 🔴 **存在性判定分两种情形**(2026-11-06 修,见下):
|
||||
//
|
||||
// - **页面**(`url_address` 非空)⇒ 「`f_url_address` 命中 **或** `f_id` = 固定字面量」;
|
||||
// - **目录**(`url_address` 为空)⇒ **只按 `f_id` 判**。
|
||||
//
|
||||
// 🔴 **为什么目录必须只按 id 判**:官方 JNPF 的目录节点 `f_url_address` 是
|
||||
// **空串**(目录没有页面)。若也按 url 判 ⇒ 「url = ''」会命中**任意一条
|
||||
// url 为空的旧行**(本仓实测:低代码报表功能插的 `report_…` 垃圾菜单)
|
||||
// ⇒ 官方目录**永远插不进去** ⇒ 子菜单的 `f_parent_id` 指向一个
|
||||
// 不存在的目录 id ⇒ **菜单层级塌成平铺**(前端顶部导航全是散项)。
|
||||
//
|
||||
// 🔴 **不按 f_delete_mark 过滤** —— 软删行也算「已存在」(契约 §8.6 明确要求)。
|
||||
let existing = db
|
||||
.query_json_params(
|
||||
// 🔴 **不按 url 判(页面)会出事**:用户把内置菜单的 `f_url_address` 改掉后,
|
||||
// 下次启动会「查不到 ⇒ INSERT 固定 id」⇒ **撞复合主键** ⇒ 种子失败 ⇒
|
||||
// 进程 exit 1 ⇒ 此后每次启动都失败(服务起不来 ⇒ 用户也没法用 UI 改回去)。
|
||||
let existing = if url_address.is_empty() {
|
||||
db.query_json_params(
|
||||
"SELECT f_id AS \"id\" FROM base_module \
|
||||
WHERE f_id = $1::text LIMIT 1",
|
||||
&[&id],
|
||||
)
|
||||
.await?
|
||||
} else {
|
||||
db.query_json_params(
|
||||
"SELECT f_id AS \"id\" FROM base_module \
|
||||
WHERE f_url_address = $1::text OR f_id = $2::text LIMIT 1",
|
||||
&[&url_address, &id],
|
||||
)
|
||||
.await?;
|
||||
.await?
|
||||
};
|
||||
if !existing.is_empty() {
|
||||
// 🔴 **存量库回填 `f_en_code` / `f_system_id`**:本仓早期版本的种子**不写**
|
||||
// 这两列 ⇒ 存量库全是 NULL ⇒ 面 B 点权限判据落空(全站放行),且菜单无法按系统隔离。
|
||||
@@ -853,10 +893,20 @@ async fn ensure_builtin_menus(
|
||||
.to_string();
|
||||
let en_code = menu.en_code.to_string();
|
||||
let system_id = system_id_of(db, menu.system_en_code).await;
|
||||
// 🔴 **存量库回填 `f_page_address`**:早期种子不写这一列 ⇒ 存量库全是 NULL
|
||||
// ⇒ 面 B 前端 `dynamicImport(null ?? urlAddress)` 落到 `NotFoundView`
|
||||
// ⇒ 页面显示「哎呀!未找到页面」。只在 **NULL 时**回填 ⇒ 人工改过的不被覆盖。
|
||||
let page_address = if menu.page_address.is_empty() {
|
||||
None
|
||||
} else {
|
||||
Some(menu.page_address.to_string())
|
||||
};
|
||||
db.exec_params(
|
||||
"UPDATE base_module SET f_en_code = $1::text, f_system_id = $2::text \
|
||||
WHERE f_id = $3::text AND (f_en_code IS NULL OR f_system_id IS NULL)",
|
||||
&[&en_code, &system_id, &existing_id],
|
||||
"UPDATE base_module SET f_en_code = $1::text, f_system_id = $2::text, \
|
||||
f_page_address = COALESCE(f_page_address, $3::text) \
|
||||
WHERE f_id = $4::text AND (f_en_code IS NULL OR f_system_id IS NULL \
|
||||
OR (f_page_address IS NULL AND $3::text IS NOT NULL))",
|
||||
&[&en_code, &system_id, &page_address, &existing_id],
|
||||
)
|
||||
.await?;
|
||||
continue;
|
||||
@@ -869,6 +919,14 @@ async fn ensure_builtin_menus(
|
||||
// 🔴 图标为 `None` ⇒ 写 **NULL**(契约 §8.4 的 `—`,不是空串)。
|
||||
let icon = menu.icon.map(str::to_string);
|
||||
let sort_code = menu.sort_code.to_string();
|
||||
// 🔴 **面 B 的前端视图路径**(`f_page_address`)—— 空串 ⇒ 写 **NULL**(官方目录行没有页面)。
|
||||
// 官方前端 `dynamicImport(node.pageAddress ?? node.urlAddress, …)` 按它匹配
|
||||
// `import.meta.glob('../views/**/*.vue')` ⇒ 写错 ⇒ 页面落 `NotFoundView`。
|
||||
let page_address = if menu.page_address.is_empty() {
|
||||
None
|
||||
} else {
|
||||
Some(menu.page_address.to_string())
|
||||
};
|
||||
// 🔴 菜单按所属应用落 `f_system_id`(多应用隔离的落点)。
|
||||
let system_id = system_id_of(db, menu.system_en_code).await;
|
||||
let enabled_mark = "1".to_string();
|
||||
@@ -876,11 +934,12 @@ async fn ensure_builtin_menus(
|
||||
let tenant_id = "0".to_string();
|
||||
let creator = ADMIN_ACCOUNT.to_string();
|
||||
let now = now.to_string();
|
||||
let params: [&(dyn ToSql + Sync); 14] = [
|
||||
let params: [&(dyn ToSql + Sync); 15] = [
|
||||
&id,
|
||||
&full_name,
|
||||
&en_code,
|
||||
&url_address,
|
||||
&page_address,
|
||||
&parent_id,
|
||||
&menu_type,
|
||||
&icon,
|
||||
@@ -894,11 +953,12 @@ async fn ensure_builtin_menus(
|
||||
];
|
||||
db.exec_params(
|
||||
"INSERT INTO base_module \
|
||||
(f_id, f_full_name, f_en_code, f_url_address, f_parent_id, f_type, f_icon, f_sort_code, \
|
||||
f_system_id, f_enabled_mark, f_delete_mark, f_tenant_id, f_creator_user_id, f_creator_time) \
|
||||
VALUES ($1::text, $2::text, $3::text, $4::text, $5::text, $6::text::integer, $7::text, \
|
||||
$8::text::bigint, $9::text, $10::text::integer, $11::text::integer, $12::text, \
|
||||
$13::text, $14::text::timestamp)",
|
||||
(f_id, f_full_name, f_en_code, f_url_address, f_page_address, f_parent_id, f_type, \
|
||||
f_icon, f_sort_code, f_system_id, f_enabled_mark, f_delete_mark, f_tenant_id, \
|
||||
f_creator_user_id, f_creator_time) \
|
||||
VALUES ($1::text, $2::text, $3::text, $4::text, $5::text, $6::text, $7::text::integer, \
|
||||
$8::text, $9::text::bigint, $10::text, $11::text::integer, $12::text::integer, \
|
||||
$13::text, $14::text, $15::text::timestamp)",
|
||||
¶ms,
|
||||
)
|
||||
.await?;
|
||||
|
||||
@@ -0,0 +1,35 @@
|
||||
//! rowcount —— 统计指定 pglite 库里各表的行数(对比官方 init SQL 的种子数据量)。
|
||||
//!
|
||||
//! 用法:`cargo run -p sspf-store --example rowcount -- <pg_dir> [表名...]`
|
||||
|
||||
use sspf_store::db::Db;
|
||||
|
||||
#[tokio::main]
|
||||
async fn main() -> Result<(), Box<dyn std::error::Error>> {
|
||||
let mut args = std::env::args().skip(1);
|
||||
let dir = args.next().ok_or("用法: rowcount <pg_dir> [表名...]")?;
|
||||
let db = Db::open(std::path::Path::new(&dir)).await?;
|
||||
let names: Vec<String> = args.collect();
|
||||
let list = if names.is_empty() {
|
||||
let rows = db
|
||||
.query_json(
|
||||
"SELECT table_name AS \"t\" FROM information_schema.tables \
|
||||
WHERE table_schema = 'public' ORDER BY table_name",
|
||||
)
|
||||
.await?;
|
||||
rows.iter()
|
||||
.filter_map(|r| r["t"].as_str().map(str::to_string))
|
||||
.collect()
|
||||
} else {
|
||||
names
|
||||
};
|
||||
for t in list {
|
||||
let n = db
|
||||
.scalar_text(&format!("SELECT count(*) FROM {t}"))
|
||||
.await?
|
||||
.unwrap_or_else(|| "?".to_string());
|
||||
println!("{t}\t{n}");
|
||||
}
|
||||
db.shutdown().await?;
|
||||
Ok(())
|
||||
}
|
||||
@@ -62,6 +62,116 @@ pub const TEMP_DIR_MARKER: &str = "memory://";
|
||||
/// 生产档要换口令走 `SEED_ADMIN_PASSWORD` env(见 [`Config::seed_admin_password`])。
|
||||
pub const DEFAULT_SEED_ADMIN_PASSWORD: &str = "123456";
|
||||
|
||||
/// 解析 **JNPF 通用资产包目录**(env `SSW_ASSETS_DIR`)。
|
||||
///
|
||||
/// 🔴 资产包(静态前端 + 示例数据库)**只跟 JNPF 版本有关**,跟 sspf 版本、
|
||||
/// OS / CPU / rust 工具链 / 部署环境都无关 ⇒ 单独分发,一个 env 指过去即可:
|
||||
/// `SSW_ASSETS_DIR=./jnpf-7.0-assets ./bin/sspf-admin`。
|
||||
///
|
||||
/// 相对路径按**当前进程 CWD 绝对化**(与 [`resolve_static_dir`] 同因):PGlite 打开
|
||||
/// 数据目录时会 `chdir`,配置解析后 CWD 会变 ⇒ 相对路径必须落定成绝对路径。
|
||||
fn resolve_assets_dir() -> Option<PathBuf> {
|
||||
match std::env::var("SSW_ASSETS_DIR") {
|
||||
Ok(v) if !v.trim().is_empty() => {
|
||||
let mut p = PathBuf::from(v.trim());
|
||||
if p.is_relative() {
|
||||
if let Ok(cwd) = std::env::current_dir() {
|
||||
p = cwd.join(&p);
|
||||
}
|
||||
}
|
||||
if p.is_dir() {
|
||||
Some(p)
|
||||
} else {
|
||||
eprintln!(
|
||||
"[assets] SSW_ASSETS_DIR 指向的目录不存在,已忽略资产包: {}",
|
||||
p.display()
|
||||
);
|
||||
None
|
||||
}
|
||||
}
|
||||
_ => None,
|
||||
}
|
||||
}
|
||||
|
||||
/// 解析**外置示例数据 SQL**(优先级:`SSW_DEMO_SEED_FILE` → `<assets>/db/demo_seed.sql` → 内嵌)。
|
||||
///
|
||||
/// 🔴 为什么允许外置:示例数据属于 **JNPF 版本**而非 sspf 版本 ⇒ 换 JNPF 版本的
|
||||
/// 演示数据不该要求重编二进制。找不到文件时返回 `None` ⇒ 调用方回退编译期内嵌的
|
||||
/// `DEMO_SEED_SQL`(旧行为,保持兼容)。
|
||||
fn resolve_demo_seed_file(assets_dir: Option<&Path>) -> Option<PathBuf> {
|
||||
if let Ok(v) = std::env::var("SSW_DEMO_SEED_FILE") {
|
||||
if !v.trim().is_empty() {
|
||||
let mut p = PathBuf::from(v.trim());
|
||||
if p.is_relative() {
|
||||
if let Ok(cwd) = std::env::current_dir() {
|
||||
p = cwd.join(&p);
|
||||
}
|
||||
}
|
||||
if p.is_file() {
|
||||
return Some(p);
|
||||
}
|
||||
eprintln!(
|
||||
"[assets] SSW_DEMO_SEED_FILE 指向的文件不存在,尝试资产包/内嵌兜底: {}",
|
||||
p.display()
|
||||
);
|
||||
}
|
||||
}
|
||||
if let Some(a) = assets_dir {
|
||||
let p = a.join("db").join("demo_seed.sql");
|
||||
if p.is_file() {
|
||||
return Some(p);
|
||||
}
|
||||
}
|
||||
None
|
||||
}
|
||||
|
||||
/// 解析静态前端目录(`SSW_STATIC_DIR` → `<assets>/web` → `<project_dir>/src/frontend/dist`)。
|
||||
///
|
||||
/// 🔴 **显式指定但目录不存在 ⇒ 告警 + `None`**(不 panic、不静默)。
|
||||
/// 部署者配错了路径时必须**看见**(否则面对的是一片空白页 + 404,很难定位)。
|
||||
fn resolve_static_dir(default_dist: &Path, assets_dir: Option<&Path>) -> Option<PathBuf> {
|
||||
match std::env::var("SSW_STATIC_DIR") {
|
||||
Ok(v) if !v.trim().is_empty() => {
|
||||
let mut p = PathBuf::from(v.trim());
|
||||
// 🔴 相对路径按**当前进程 CWD 绝对化**(配置解析时的 CWD)—— 否则后续
|
||||
// CWD 一旦变动(如 pglite 打开数据目录时会 `chdir` 到 `PGLITE_DIR`),
|
||||
// 相对路径会指错目录 ⇒ 静态托管静默失效(实测:开发侧 `/` 全返 JSON 404)。
|
||||
if p.is_relative() {
|
||||
if let Ok(cwd) = std::env::current_dir() {
|
||||
p = cwd.join(&p);
|
||||
}
|
||||
}
|
||||
if p.is_dir() {
|
||||
Some(p)
|
||||
} else {
|
||||
eprintln!(
|
||||
"[static] SSW_STATIC_DIR 指向的目录不存在,已忽略静态托管: {}",
|
||||
p.display()
|
||||
);
|
||||
None
|
||||
}
|
||||
}
|
||||
_ => {
|
||||
// 🔴 资产包里的 web/ 优先于本仓自带前端 ⇒ 解包即得官方前端,无需再配 SSW_STATIC_DIR。
|
||||
if let Some(a) = assets_dir {
|
||||
let p = a.join("web");
|
||||
if p.is_dir() {
|
||||
return Some(p);
|
||||
}
|
||||
eprintln!(
|
||||
"[assets] 资产包内没有 web/,回退本仓前端目录: {}",
|
||||
p.display()
|
||||
);
|
||||
}
|
||||
if default_dist.is_dir() {
|
||||
Some(default_dist.to_path_buf())
|
||||
} else {
|
||||
None
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 运行时配置(全部来自环境变量 + 项目目录推导)。
|
||||
#[derive(Clone, Debug)]
|
||||
pub struct Config {
|
||||
@@ -76,8 +186,29 @@ pub struct Config {
|
||||
pub pg_dir: PathBuf,
|
||||
/// 项目根目录。
|
||||
pub project_dir: PathBuf,
|
||||
/// 前端产物目录 `<project_dir>/src/frontend/dist`;不存在 ⇒ `None`。
|
||||
/// 前端产物目录;不存在 ⇒ `None`。
|
||||
///
|
||||
/// 🔴 **三级口径**(2026-11-06 定):
|
||||
/// 1. env `SSW_STATIC_DIR`(**显式指定,优先级最高**)—— 静态通用前端包
|
||||
/// 随版本包分发后可能落在**任意路径**(`dist/web/`、`/opt/sspf/web/` …)
|
||||
/// ⇒ 不能只认 `<project_dir>/src/frontend/dist`;
|
||||
/// 2. `<project_dir>/src/frontend/dist`(本仓自带前端的构建产物);
|
||||
/// 3. 都没有 ⇒ `None`(后端不托管静态文件,只提供 API)。
|
||||
///
|
||||
/// 🔴 **显式指定的目录不存在 ⇒ 当 `None` 处理**(不 panic、不静默 404):
|
||||
/// 打印一次警告,让部署者看见「路径写错了」,而不是面对一片空白页。
|
||||
pub static_dir: Option<PathBuf>,
|
||||
/// **JNPF 通用资产包目录**(env `SSW_ASSETS_DIR`;缺省/不存在 ⇒ `None`)。
|
||||
///
|
||||
/// 🔴 资产包 = 官方前端静态产物 + 官方示例数据库,**只绑定 JNPF 版本**,
|
||||
/// 与本 sspf 版本、目标平台、rust 工具链、部署环境都无关 ⇒ 独立分发、跨版本复用。
|
||||
/// 一个 env 同时喂「前端目录」与「示例数据文件」,见 [`Config::demo_seed_file`]。
|
||||
pub assets_dir: Option<PathBuf>,
|
||||
/// **外置示例数据 SQL**(`SSW_DEMO_SEED_FILE` 或 `<assets_dir>/db/demo_seed.sql`)。
|
||||
///
|
||||
/// `None` ⇒ 用二进制编译期内嵌的那份(旧行为,保持兼容)。
|
||||
/// 🔴 换 JNPF 版本的示例数据**不需要重编二进制**:指向新文件即可。
|
||||
pub demo_seed_file: Option<PathBuf>,
|
||||
/// 部署档位(env `SSW_PROFILE`;缺省或非法 ⇒ [`Profile::Dev`])。
|
||||
///
|
||||
/// 🔴 **缺省 = `Dev`** ⇒ 弱口令守卫**不生效** ⇒ 本地开发与冒烟脚本**零影响**。
|
||||
@@ -87,6 +218,18 @@ pub struct Config {
|
||||
/// 🔴 **只在空库首启时生效**(`first_seed` 仅当 `base_user` 行为 0 时跑)
|
||||
/// ⇒ 已有库里 admin 的口令**改这个 env 不会变**(要在管理界面改)。
|
||||
pub seed_admin_password: String,
|
||||
/// 是否导入**官方 JNPF 7.0 示例数据**(env `SSW_DEMO_DATA`;缺省 ⇒ **开**)。
|
||||
///
|
||||
/// 🔴 **为什么缺省是「开」**:官方初始库是用**示例数据**初始化的
|
||||
/// (`jnpf_dbnull_init.sql` ⇒ 331 表 / 59361 行)⇒
|
||||
/// 空库启动的 ssw-platform 与官方**长得完全不一样**
|
||||
/// (实测:官方 65 个可比页面里 31 个「数据少」、23 个端点「官方有数据、ssw 空」)。
|
||||
///
|
||||
/// 🔴 **为什么可以关**:`false` / `0` / `off` / `no` ⇒ **不导入**示例数据
|
||||
/// ⇒ 纯净库(生产部署不想带演示数据时用)。
|
||||
///
|
||||
/// 🔴 **幂等**:导入用 `ON CONFLICT DO NOTHING` ⇒ 重复启动不炸、不覆盖人工改动。
|
||||
pub demo_data: bool,
|
||||
}
|
||||
|
||||
impl Config {
|
||||
@@ -115,7 +258,10 @@ impl Config {
|
||||
};
|
||||
|
||||
let dist = project_dir.join("src/frontend/dist");
|
||||
let static_dir = if dist.is_dir() { Some(dist) } else { None };
|
||||
// 🔴 先解析资产包目录(配置解析时 CWD 还没被 PGlite 改掉)⇒ 再据此推导 web/ 与示例数据。
|
||||
let assets_dir = resolve_assets_dir();
|
||||
let static_dir = resolve_static_dir(&dist, assets_dir.as_deref());
|
||||
let demo_seed_file = resolve_demo_seed_file(assets_dir.as_deref());
|
||||
|
||||
let profile = Profile::from_env_str(&std::env::var("SSW_PROFILE").unwrap_or_default());
|
||||
|
||||
@@ -124,14 +270,27 @@ impl Config {
|
||||
_ => DEFAULT_SEED_ADMIN_PASSWORD.to_string(),
|
||||
};
|
||||
|
||||
// 🔴 **示例数据开关**:缺省「开」(对齐官方「用示例数据初始化」)。
|
||||
// 显式 `false` / `0` / `off` / `no` ⇒ 关(生产部署用纯净库)。
|
||||
let demo_data = match std::env::var("SSW_DEMO_DATA") {
|
||||
Ok(v) => !matches!(
|
||||
v.trim().to_ascii_lowercase().as_str(),
|
||||
"false" | "0" | "off" | "no"
|
||||
),
|
||||
Err(_) => true,
|
||||
};
|
||||
|
||||
Config {
|
||||
port,
|
||||
bind_addr,
|
||||
pg_dir,
|
||||
project_dir,
|
||||
static_dir,
|
||||
assets_dir,
|
||||
demo_seed_file,
|
||||
profile,
|
||||
seed_admin_password,
|
||||
demo_data,
|
||||
}
|
||||
}
|
||||
|
||||
@@ -175,6 +334,28 @@ mod tests {
|
||||
assert!(cfg.bind_addr.is_loopback());
|
||||
}
|
||||
|
||||
/// 资产包目录 ⇒ 自动推导 `web/` 与 `db/demo_seed.sql`(不依赖任何 env)。
|
||||
#[test]
|
||||
fn assets_dir_resolves_web_and_seed() {
|
||||
// 外部若显式设了这两项,优先级高于资产包 ⇒ 本测试的前提不成立,跳过。
|
||||
if std::env::var("SSW_STATIC_DIR").is_ok() || std::env::var("SSW_DEMO_SEED_FILE").is_ok() {
|
||||
return;
|
||||
}
|
||||
let base = std::env::temp_dir().join(format!("sspf-assets-test-{}", std::process::id()));
|
||||
let web = base.join("web");
|
||||
let db = base.join("db");
|
||||
std::fs::create_dir_all(&web).unwrap();
|
||||
std::fs::create_dir_all(&db).unwrap();
|
||||
let seed = db.join("demo_seed.sql");
|
||||
std::fs::write(&seed, "SELECT 1;").unwrap();
|
||||
|
||||
let missing = PathBuf::from("/tmp/does-not-exist-project/src/frontend/dist");
|
||||
assert_eq!(resolve_static_dir(&missing, Some(&base)), Some(web));
|
||||
assert_eq!(resolve_demo_seed_file(Some(&base)), Some(seed));
|
||||
assert_eq!(resolve_static_dir(&missing, None), None);
|
||||
assert_eq!(resolve_demo_seed_file(None), None);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn pg_is_temp_detects_marker() {
|
||||
let mut cfg = Config::from_env(PathBuf::from("/tmp/x"));
|
||||
|
||||
@@ -291,6 +291,12 @@ impl Platform {
|
||||
.config
|
||||
.take()
|
||||
.unwrap_or_else(|| Config::from_env(boot::resolve_project_dir()));
|
||||
// 🔴 **静态前端目录**:builder 显式给的优先;否则用 `Config` 从 env
|
||||
// (`SSW_STATIC_DIR`) / `<project_dir>/src/frontend/dist` 解析出来的值。
|
||||
// ⇒ 静态通用前端包随版本包分发到任意路径都能被托管(不需要挪进源码树)。
|
||||
if self.static_dir.is_none() {
|
||||
self.static_dir = config.static_dir.clone();
|
||||
}
|
||||
let state = self.boot(&config).await?;
|
||||
let extras = self.extras();
|
||||
Ok(Assembled {
|
||||
@@ -351,6 +357,21 @@ impl Platform {
|
||||
.await
|
||||
.map_err(|e| format!("初始 admin 种子失败: {e}"))?;
|
||||
|
||||
// ---- 第 4.5 步:官方示例数据(幂等)----
|
||||
//
|
||||
// 🔴 **为什么在 `first_seed` 之后**:示例数据**不含** admin 用户 / 角色
|
||||
// (那 7 张本仓自管表被裁掉了)⇒ 顺序无所谓,但放这里语义清楚:
|
||||
// 「先把结构种好,再灌官方示例数据」。
|
||||
//
|
||||
// 🔴 **为什么可关**(`SSW_DEMO_DATA=false`):生产部署可能不想带演示数据。
|
||||
// 🔴 **外置优先**:`SSW_ASSETS_DIR` / `SSW_DEMO_SEED_FILE` 指向 JNPF 通用资产包
|
||||
// 里的示例数据(只跟 JNPF 版本有关);没配 ⇒ 用编译期内嵌那份。
|
||||
if config.demo_data {
|
||||
bootstrap::ensure_demo_data(&db, config.demo_seed_file.as_deref())
|
||||
.await
|
||||
.map_err(|e| format!("官方示例数据导入失败: {e}"))?;
|
||||
}
|
||||
|
||||
// ---- 第 5 步:生产档弱密钥守卫(只有 `SSW_PROFILE=prod` 才生效)----
|
||||
if config.profile == Profile::Prod {
|
||||
let values = vec![(
|
||||
|
||||
@@ -0,0 +1,191 @@
|
||||
# A/B 走查差异报告:官方 JNPF 7.0 vs ssw-platform
|
||||
|
||||
> 日期:2026-11-06
|
||||
> 目标:① 用 agent-browser 对比「官方 web 连官方后端」与「官方 web 连 ssw-platform 后端」的差异;
|
||||
> ② 让 ssw-platform 以官方 `jnpf_dbnull_init.sql`(示例数据)初始化,而非空库。
|
||||
|
||||
## 0. 一句话结论
|
||||
|
||||
ssw-platform 现在以官方 `jnpf_dbnull_init.sql` 为**契约**对齐「用示例数据初始化」,并把
|
||||
**静态前端 + 示例数据库**打成一个只绑定 JNPF 版本、与环境 / 平台 / 工具链无关的**通用资产包**
|
||||
`dist/jnpf-7.0-assets.tar.gz`(解包后 `SSW_ASSETS_DIR` 一个 env 即用)。
|
||||
修复后同一时刻双走查(65 页,见 §9):官方 163 端点 / 57 有数据 vs ssw 155 / 41;
|
||||
65 页里 **47 页表格行数一致**、核心系统页 35 个里 22 个一致。
|
||||
**主要系统管理页已做到 1:1**(前端本身就是官方 7.0.0 构建产物、同源托管);
|
||||
剩余差异全部属于「运行时数据表(init SQL 本来就是 0 行)」或「ssw 自管表的设计内差异」,
|
||||
**不是渲染 / 接口缺陷**。
|
||||
|
||||
---
|
||||
|
||||
## 1. 走查方法
|
||||
|
||||
- **面 A / 面 B 分流**:官方前端发 `Vue-Version: 3` 头 ⇒ 后端走面 B(官方 `PcUserVO` 形状,15 字段),
|
||||
否则走面 A(6 字段)。判据唯一,已确认(`apps/jnpf-web-apps-main/src/api/request.ts` 确实发送此头)。
|
||||
- **三个 v4 走查任务**(Playwright + 真实登录 + 等待渲染稳定):
|
||||
| 任务 | 前端 | 后端 | 结果 |
|
||||
|---|---|---|---|
|
||||
| official_v4 | 官方 web @3100(开发侧 vite 代理) | 官方后端 192.168.1.26:30093 | 65 页 / 526 次 API |
|
||||
| ssw_v4 | 官方 web @3100 | ssw 后端 @30010 | 78 页(含掉线,见 §2) |
|
||||
| static_v4 | **官方 web 静态包 @30010(同源)** | ssw 后端 @30010 | 65 页 / 369 次 API |
|
||||
- **端点级对比**(`cmp_v3.py`):端点身份 = 去 query 的 `path`;「有数据」= 该端点某次响应 `listLen > 0`。
|
||||
|
||||
---
|
||||
|
||||
## 2. 关键发现:ssw 开发侧走查"掉线"是假象(非前端 bug)
|
||||
|
||||
`ssw_v4` 里 **59/78 页渲染的是登录页**,一度以为后端崩了。定位后结论:
|
||||
|
||||
- 三个走查**并发**打**同一个** ssw 后端 ⇒ 偶发 `GET /api/oauth/CurrentUser` 返回 **500**
|
||||
(实测:单跑 240 次并发 curl **全 200**;单独浏览器逐页访问也 200)。
|
||||
- 根因是并发抢同一 PGlite 后端时的偶发失败,与前端无关。
|
||||
- **公平对照应取 `static_v4`(同源)**——前端与后端同进程、同库,才是「官方前端 + ssw 后端」的纯净对比。
|
||||
|
||||
---
|
||||
|
||||
## 3. 端点覆盖对比(官方 vs 静态包同源)
|
||||
|
||||
| 指标 | 官方(30093) | ssw(修复前) |
|
||||
|---|---|---|
|
||||
| 端点总数 | 163 | 155 |
|
||||
| 有数据端点 | 57 | 39 |
|
||||
|
||||
- 🟢 ssw 补上(官方有数据 ⇒ ssw 也有):**38 个**
|
||||
- 🔴 ssw 缺数据(官方有数据 ⇒ ssw 空):**19 个** → 见 §4 分类
|
||||
- 🟡 ssw 多出(ssw 有数据 ⇒ 官方空):1 个(`/api/system/DictionaryData/...`,ssw 自带字典种子)
|
||||
- ⚪ 仅单方走查调到:官方 9 / ssw 1(路由未命中,非功能缺口)
|
||||
|
||||
---
|
||||
|
||||
## 4. 19 个"缺数据"端点的根因分类
|
||||
|
||||
| 类别 | 端点 | 根因 | 处置 |
|
||||
|---|---|---|---|
|
||||
| **可修 → 已修** | `/api/system/Area/-1`(34 行)、`/api/system/BaseLang`(20 组)、`/api/system/atlas`(3210 行) | 三张表在 init SQL 有数据,但 ssw 之前没导入 | 按 `PARTIAL` 规则裁列+裁行后**补入 `demo_seed.sql`**,已验证返数据与官方一致 |
|
||||
| **init SQL 本就空**(运行时由管理员在 UI 创建) | `CommonWords`、`Kit`、`DataInterface`、`Dataset`、`Authority/Data`、`message/Receive`、`PermissionGroup`、`Position`、`Standing`(+`/list`)、`UserRelation/userList`、`HomeData`、`workflow/template/TreeList`、`Ai/Knowledge`、`AiSupplier/Selector` | 官方 `jnpf_dbnull_init.sql` 里这些表 **0 行**;参考环境 30093 被额外灌过演示数据,所以参考侧有数据 | **对齐契约的正确行为**。补全需 30093 的整库 dump,超出 `jnpf_dbnull_init.sql` 范围 |
|
||||
|
||||
> ⚠️ **重要澄清**:30093 参考环境 ≠ 纯 `jnpf_dbnull_init.sql`——它带额外演示业务数据。
|
||||
> ssw 的契约目标是 `jnpf_dbnull_init.sql`,故上述 16 个"缺口"是**预期内**的,不是缺陷。
|
||||
|
||||
---
|
||||
|
||||
## 5. 页面渲染对比(修复前,65 可比页)
|
||||
|
||||
| 维度 | 数量 | 说明 |
|
||||
|---|---|---|
|
||||
| 表格行数**一致** | 46 页 | 绝大多数列表页已对齐 |
|
||||
| **官方多** | 16 页 | 主要是日志/在线/收件箱/权限组等运行时表;其中 `sysData/area`(34)、`sysData/language`(20) **已修复对齐** |
|
||||
| **ssw 多** | 3 页 | `commonCenter/sysFunction`(35 vs 17)、`permission/menu`(104 vs 99,ssw 多一个 `appBackend` 节点)、`sysData/dictionary`(13 vs 0,ssw 自带字典种子) |
|
||||
|
||||
修复后:`sysData/area`、`sysData/language` 现已与官方行数一致。其余"官方多"的页面均属 §4 第二类
|
||||
(运行时表 / init SQL 空),符合契约。
|
||||
|
||||
---
|
||||
|
||||
## 6. 已完成的修复清单
|
||||
|
||||
1. **示例数据落地(对齐契约)**
|
||||
- `src/backend/db/demo_seed.sql`(**58 表 / 14242 行 / 8.1 MB**),由 `scripts/gen-demo-seed.py`
|
||||
从官方 `jnpf_dbnull_init.sql`(106 MB / 331 表)裁剪生成,**编译期内嵌** ⇒ 随版本包分发。
|
||||
- 裁剪规则:排除 5 张纯大表(占原文 88% 体积)+ 7 张本仓自管表(撞复合主键);
|
||||
部分保留 `base_province`(省/市/区 4061 行) / `base_language`(1538 组×3 语种) / `base_province_atlas`(3210 行)。
|
||||
- `SSW_DEMO_DATA` 缺省**开**;`false/0/off/no` 可关(纯净库)。
|
||||
- 每条 INSERT 带 `ON CONFLICT DO NOTHING` ⇒ 幂等、不覆盖人工改动。
|
||||
2. **DDL 幂等**:示例 DDL 归一化为 `CREATE TABLE IF NOT EXISTS`,消除「二次启动刷表已存在」噪音。
|
||||
3. **静态通用前端(随包分发)**
|
||||
- `scripts/build-web.sh` 从官方 monorepo 构建 → `dist/web/`(**2104 文件 / 107 MB**)。
|
||||
- `scripts/release.sh` 把它拷进包内 `web/`,README 说明 `SSW_STATIC_DIR=./web` 同源托管。
|
||||
- **修复静态目录相对路径 bug**:`SSW_STATIC_DIR` 在配置解析时按进程 CWD 绝对化
|
||||
(PGlite 打开数据目录时会 `chdir` 到 `PGLITE_DIR`,相对路径会指错 ⇒ 之前 `/` 全返 JSON 404)。
|
||||
- 端到端验证:`/`、`/login`、SPA 深链 `/permission/menu` 均 200。
|
||||
4. **`sysConfigInfo` 形状对齐**:官方 37 个核心字段全部命中(此前是 `{}`)。
|
||||
5. **资产包外置**(§7):`SSW_ASSETS_DIR` / `SSW_DEMO_SEED_FILE` + `ensure_demo_data_sql`
|
||||
⇒ 示例数据不再被编译期钉死,换 JNPF 版本不必重编二进制;编译期内嵌保留兜底。
|
||||
6. **官方图标资源补齐**:`/api/file/Image/**` 之前全返信封 404(9 条控制台报错、数据库/AI 图标不显示)。
|
||||
资产包内置 14 张官方 PNG(入仓 `src/backend/assets/jnpf-7.0/file-images/`),后端 fallback 加
|
||||
**精确白名单**(含百分号解码 + 目录穿越防护)⇒ 抽查 8 个 URL 全部 `200 image/png`,
|
||||
其它 `/api/**` 仍信封 404、SPA 深链仍 200。快速复核 3 个相关页 `HTTP>=400` 归零。
|
||||
|
||||
---
|
||||
|
||||
## 7. JNPF 通用资产包(静态前端 + 示例数据库,单独分发)
|
||||
|
||||
> 🔴 **分发模型(2026-11-06 修订)**:静态前端与示例数据库**跟部署环境、目标平台、
|
||||
> sspf 版本、rust 工具链都无关,只跟 JNPF 版本有关** ⇒ 不该绑在按
|
||||
> `sspf 版本 × target` 出的平台包上,改成**一份独立资产包**给所有平台/版本复用。
|
||||
|
||||
- 产物:`scripts/pack-jnpf-assets.sh` → `dist/jnpf-7.0-assets.tar.gz`(47 MB / 2136 项)。
|
||||
- 包内:
|
||||
| 路径 | 内容 |
|
||||
|---|---|
|
||||
| `web/` | 官方 JNPF 7.0 web 前端构建产物(2104 文件 / 107 MB),API 前缀为空 ⇒ 同源托管 |
|
||||
| `db/demo_seed.sql` | 官方示例数据裁剪版(58 表 / 14242 条 INSERT,幂等) |
|
||||
| `db/schema.sql` / `db/SOURCE.md` | 本仓使用的官方 DDL / 来源与裁剪规则 |
|
||||
| `tools/gen-demo-seed.py` | 生成器副本(换 JNPF 版本时可复现) |
|
||||
| `manifest.json` | 版本绑定声明、官方 init SQL 的 sha256、web 全树摘要、统计、消费方式 |
|
||||
| `SHA256SUMS` | 2110 个文件逐文件校验(解包后 `shasum -a 256 -c` 全 OK) |
|
||||
- 消费(一个 env 搞定,解包即用):
|
||||
```bash
|
||||
tar -xzf jnpf-7.0-assets.tar.gz
|
||||
SSW_ASSETS_DIR=./jnpf-7.0-assets PORT=30010 ./bin/sspf-admin
|
||||
```
|
||||
优先级:`SSW_STATIC_DIR` / `SSW_DEMO_SEED_FILE` > `SSW_ASSETS_DIR` 自动推导 > 二进制**编译期内嵌**兜底
|
||||
⇒ 换 JNPF 版本的演示数据**不需要重编二进制**。
|
||||
- 端到端验证:从 tar 解包到 `/tmp`、用**相对路径** `SSW_ASSETS_DIR=./jnpf-7.0-assets` 起服务,
|
||||
日志 `[demo-data] 使用外置 JNPF 资产包示例数据: /private/tmp/.../db/demo_seed.sql`,
|
||||
导入 14255 条语句零失败,`/` 200(相对路径绝对化修复仍生效)。
|
||||
- `scripts/release.sh` 的 `web/` 改以资产包为唯一真源,新增 `--no-web` 可把静态前端完全剥离出平台包;
|
||||
默认仍携带一份(向后兼容「跟版本包一起分发」)。
|
||||
|
||||
---
|
||||
|
||||
## 9. 修复后重跑 v5:主要页面能不能 1:1
|
||||
|
||||
> 同一时刻、同一 `capture5.mjs`、同一 65 路由集,两侧**都是生产构建产物 + 同源后端**:
|
||||
> 官方 `http://192.168.1.26:30093` vs ssw 资产包同源 `http://127.0.0.1:30010`。
|
||||
> 口径:页面「一致」= 渲染稳定后表格行数相同;端点「有数据」= 某次响应 `listLen > 0`。
|
||||
|
||||
| 指标 | 官方 30093 | ssw 资产包 30010 | v4(修复前) |
|
||||
|---|---|---|---|
|
||||
| 走查页面 / API 次数 | 65 / 526 | 65 / 369 | 65 / 369 |
|
||||
| 端点总数 / 有数据 | 163 / 57 | 155 / 41 | 155 / 39 |
|
||||
| 官方有数据而 ssw 空 | — | **17** | 19 |
|
||||
| 65 页表格行数一致 | — | **47**(官方多 15 / ssw 多 3) | 46 |
|
||||
| 核心系统页 35 个一致 | — | **22** | — |
|
||||
| console / page 错误 | 0 / 11 | 11 / 11 | — |
|
||||
|
||||
- 补数据后端点缺口 **19 → 17**(`/api/system/Area/-1` 34 行、`/api/system/BaseLang` 20 组补齐),
|
||||
`/sysData/area` 与 `/sysData/language` 两个页面行数与官方一致。
|
||||
- `pageErrors` 两侧都是 11 条,全是页面里的说明文案被选择器抓到,**不是异常**。
|
||||
- v5 抓包时还未补官方图标:ssw 的 11 条 console 里 9 条是 `/api/file/Image/**` 404(官方走 302 到文件服务)。
|
||||
补完图标后快速复核 3 个相关页:`HTTP>=400 = 0`、图标请求 404 = 0;
|
||||
剩下的是登录页 SVG 负值警告、AI 配置页一个 TypeError、WebSocket 推送(两侧都报 ws 握手错误)。
|
||||
|
||||
### 差异逐条归因(15 页「官方多」+ 3 页「ssw 多」)
|
||||
|
||||
| 类别 | 页面 | 根因 |
|
||||
|---|---|---|
|
||||
| 运行时 / 参考库额外演示数据(15 页**全部**) | `sysLog/{error,login,operate,request}Log`、`monitor/userOnline`、`msgCenter/receiveConfig`、`permission/{organize,user,authGroup,identity}`、`dataCenter/{dataset,dataService}`、`templateCenter/{commonWords,kit}`、`sysService/cache` | 官方 `jnpf_dbnull_init.sql` 里这些表 **0 行**;30093 被额外灌过演示数据 / 是运行时产生 ⇒ 对齐 init SQL 契约的正确行为 |
|
||||
| ssw 自管种子(3 页) | `permission/menu` 104 vs 99、`sysData/dictionary` 13 vs 0、`commonCenter/sysFunction` 35 vs 17 | 本仓种子自己生成的节点 / 字典 / 功能项,属**设计内差异**;改它们会动既有菜单 / 字典行数断言 |
|
||||
| 端点缺口 17 个 | `message/Receive`、`system/{HomeData,Dataset,Kit,CommonWords,DataInterface}`、`permission/{Position,Standing,PermissionGroup,UserRelation}`、`ai/{Knowledge,AiSupplier}`、`workflow/template/TreeList` 等 | 同样是运行时表(init SQL 0 行);`ai/AiSupplier/Selector` 与 `Authority/Data/.../Values` 是参考库才调到 |
|
||||
|
||||
### 结论(分层回答「1:1」)
|
||||
|
||||
1. **UI / 路由 / 交互 / 接口形状:是 1:1**。前端就是官方 JNPF 7.0.0 源码的构建产物(`pnpm run build:main`),
|
||||
同源托管、免 node;65 页全部正常渲染,155/163 个端点被调到,核心系统配置字段(`sysConfigInfo` 37 项)全中。
|
||||
2. **由 init SQL 提供基础数据的页面:是 1:1**。58 表 / 14242 行导入,行政区划 34、国际化 20、地图 3210
|
||||
与官方一致;核心系统页里**凡数据来自 init SQL 契约的配置页,行数全部相同**。
|
||||
3. **含运行时 / 演示业务数据的列表页:还做不到逐行 1:1**。差异不是渲染或接口缺陷,而是
|
||||
30093 参考环境比纯 `jnpf_dbnull_init.sql` 多灌了演示数据(日志、在线用户、组织用户、数据集…)。
|
||||
要 100% 复刻需取该环境**整库 dump** 作为附加种子,超出 init SQL 契约。
|
||||
4. **3 个自管种子页**:菜单多 `appBackend` 节点、字典 13 项、功能 35 项 —— 要逐行一致可调种子,
|
||||
但会影响既有断言,当前判定为设计内差异、不修。
|
||||
|
||||
---
|
||||
|
||||
## 10. 后续可选(非阻塞)
|
||||
|
||||
- 若要 100% 复刻 30093 的"演示业务数据",需取该环境的整库 dump 作为额外种子(超出 `jnpf_dbnull_init.sql` 契约)。
|
||||
- 若要连 3 个自管种子页也逐行一致,需调整 `menus.rs` / 字典种子并同步更新行数断言。
|
||||
- AI 配置页的 `TypeError`(`/api/ai/AiSupplier/Selector` 形状)与 WebSocket 推送属接口层能力差异,
|
||||
不影响主要系统管理页;按需再补。
|
||||
- 静态包登录页首屏依赖字体/图标 CDN;纯内网离线场景可改为本地化资源(按需)。
|
||||
@@ -0,0 +1,110 @@
|
||||
#!/usr/bin/env bash
|
||||
#
|
||||
# build-web.sh —— 构建「静态通用前端包」(JNPF 7.0 官方 web 前端)
|
||||
#
|
||||
# 为什么要有它(2026-11-06):
|
||||
# 用户要「提前打好一个包,作为静态通用前端,跟版本包一起分发」。
|
||||
# ⇒ 本脚本产出 `dist/web/`(可直接被 sspf-admin 用 `SSW_STATIC_DIR` 托管),
|
||||
# 再由 `scripts/release.sh` 把它塞进版本包的 `web/` 目录。
|
||||
#
|
||||
# 真源:官方 JNPF 7.0 前端 monorepo(**不在本仓**)⇒ 默认从
|
||||
# `../jnpf/7.0/frontend/web/jnpf-web-monorepo-framework` 读,
|
||||
# 可用 `JNPF_WEB_SRC` env 覆盖。
|
||||
#
|
||||
# 产物布局(版本包内):
|
||||
# sspf-vX.Y.Z/
|
||||
# ├── web/ # 🔴 静态通用前端(index.html + assets/ + js/ …)
|
||||
# └── bin/sspf-admin # 用 SSW_STATIC_DIR=web 起服务即可同源提供前端
|
||||
#
|
||||
# 用法:
|
||||
# bash scripts/build-web.sh # 构建到 dist/web/
|
||||
# bash scripts/build-web.sh --src <官方前端目录> # 显式指定真源
|
||||
# bash scripts/build-web.sh --skip-build # 只打包已有产物(不重新构建)
|
||||
#
|
||||
# 环境变量:
|
||||
# JNPF_WEB_SRC 官方前端 monorepo 路径(缺省用上面的相对路径)
|
||||
# WEB_OUT 产物输出目录(缺省 dist/web)
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
cd "$(dirname "$0")/.."
|
||||
export REPO_ROOT="$(pwd)"
|
||||
|
||||
SKIP_BUILD=0
|
||||
SRC_OVERRIDE=""
|
||||
while [[ $# -gt 0 ]]; do
|
||||
case "$1" in
|
||||
--skip-build) SKIP_BUILD=1; shift ;;
|
||||
--src) SRC_OVERRIDE="${2:-}"; shift 2 ;;
|
||||
-h|--help) sed -n '1,28p' "$0"; exit 0 ;;
|
||||
*) echo "未知参数: $1" >&2; exit 1 ;;
|
||||
esac
|
||||
done
|
||||
|
||||
# 🔴 真源定位:官方 JNPF 7.0 前端 monorepo。
|
||||
if [[ -n "${SRC_OVERRIDE}" ]]; then
|
||||
SRC="${SRC_OVERRIDE}"
|
||||
elif [[ -n "${JNPF_WEB_SRC:-}" ]]; then
|
||||
SRC="${JNPF_WEB_SRC}"
|
||||
else
|
||||
SRC="${REPO_ROOT}/../jnpf/7.0/frontend/web/jnpf-web-monorepo-framework"
|
||||
fi
|
||||
SRC="$(cd "${SRC}" 2>/dev/null && pwd || true)"
|
||||
if [[ -z "${SRC}" || ! -d "${SRC}" ]]; then
|
||||
echo "!! 找不到官方前端源码目录: ${SRC_OVERRIDE:-${JNPF_WEB_SRC:-<默认相对路径>}}" >&2
|
||||
echo " 用法: bash scripts/build-web.sh --src <官方 jnpf-web-monorepo-framework 路径>" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
OUT="${WEB_OUT:-${REPO_ROOT}/dist/web}"
|
||||
APP_DIR="${SRC}/apps/jnpf-web-apps-main"
|
||||
|
||||
echo "==> 官方前端真源: ${SRC}"
|
||||
echo "==> 产物输出: ${OUT}"
|
||||
|
||||
# ── 1. 构建(pnpm monorepo ⇒ 只构建 @jnpf/main)────────────────
|
||||
if [[ "${SKIP_BUILD}" == "1" ]]; then
|
||||
echo "==> --skip-build:跳过构建,直接用已有产物"
|
||||
else
|
||||
if [[ ! -d "${SRC}/node_modules" ]]; then
|
||||
echo "==> 安装依赖(pnpm install)"
|
||||
(cd "${SRC}" && pnpm install --frozen-lockfile)
|
||||
fi
|
||||
echo "==> pnpm run build:main(turbo 构建 @jnpf/main)"
|
||||
(cd "${SRC}" && pnpm run build:main)
|
||||
fi
|
||||
|
||||
if [[ ! -f "${APP_DIR}/dist/index.html" ]]; then
|
||||
echo "!! 构建产物缺失: ${APP_DIR}/dist/index.html" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# ── 2. 拷贝到 dist/web/(先移走旧的,不 rm -rf)────────────────
|
||||
if [[ -d "${OUT}" ]]; then
|
||||
DEST="/tmp/old_web_$(date +%s)"
|
||||
mv "${OUT}" "${DEST}"
|
||||
echo "==> 旧产物已移走: ${DEST}"
|
||||
fi
|
||||
mkdir -p "${OUT}"
|
||||
rsync -a --exclude '.DS_Store' "${APP_DIR}/dist/" "${OUT}/"
|
||||
|
||||
# ── 3. 自检 ───────────────────────────────────────────────────
|
||||
HTML="${OUT}/index.html"
|
||||
if [[ ! -f "${HTML}" ]]; then
|
||||
echo "!! 产物里没有 index.html" >&2
|
||||
exit 1
|
||||
fi
|
||||
N="$(find "${OUT}" -type f | wc -l | tr -d ' ')"
|
||||
SIZE="$(du -sh "${OUT}" | cut -f1)"
|
||||
|
||||
# 🔴 **API 前缀必须是空**(同源相对路径)—— 静态包由后端同源托管,
|
||||
# 前端请求 `/api/...` 会打到同一个端口的 sspf-admin。
|
||||
# 官方 `.env.production` 的 `VITE_GLOB_API_URL=` 正是空 ⇒ 天然满足。
|
||||
if grep -qE '"[^"]*/dev/api' "${HTML}" 2>/dev/null; then
|
||||
echo "!! index.html 里出现了 /dev/api 前缀(同源托管会 404)" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
echo "==> ✅ 静态通用前端包就绪: ${OUT}"
|
||||
echo " 文件数: ${N} 体积: ${SIZE}"
|
||||
echo " 托管方式: SSW_STATIC_DIR=${OUT} PORT=30010 ./sspf-admin"
|
||||
@@ -0,0 +1,322 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""gen-demo-seed.py —— 从官方 JNPF 7.0 init SQL 裁剪出「示例数据」资源文件。
|
||||
|
||||
用途
|
||||
----
|
||||
生成 `src/backend/db/demo_seed.sql`(**编译期内嵌进二进制** ⇒ 随版本包分发)
|
||||
⇒ 空库启动就有官方示例数据,与官方「用示例数据初始化」出来的库**长得一样**。
|
||||
|
||||
为什么需要这把尺子
|
||||
------------------
|
||||
本仓的种子(`sspf_core::seed`)只种「**结构**」(系统 / 角色 / 菜单 / admin / 几本字典)
|
||||
⇒ 官方前端的**列表页全是空的**(实测:官方 65 个可比页面里 31 个「数据少」、
|
||||
23 个端点「官方有数据、ssw 空」)⇒ 空库启动和官方**长得完全不一样**。
|
||||
|
||||
用法
|
||||
----
|
||||
python3 scripts/gen-demo-seed.py # 用默认官方路径
|
||||
python3 scripts/gen-demo-seed.py --src <init.sql> # 指定官方初始库
|
||||
|
||||
退出码:0 正常 / 2 前置错误(找不到官方初始库)
|
||||
|
||||
规则:
|
||||
1. 引号感知切分(与 Rust `split_sql_statements` 同款)⇒ 字符串内的 `;` 不切错。
|
||||
2. 排除 5 张纯大表(占原文 88% 体积)+ 7 张本仓自管表(撞复合主键)。
|
||||
3. 补齐 13 张「示例系统专用表」的 DDL(官方原文里有,本仓 schema 里没有)。
|
||||
4. 列裁剪:3 张 `ext_*` 表本仓形状与官方不同 ⇒ 只保留两边都有的列(**列与值同步裁**)。
|
||||
5. 部分保留:`base_province` / `base_language` / `base_province_atlas`
|
||||
官方有数据但体积大 ⇒ 裁列 + `base_province` 再裁掉街道级(见 `PARTIAL`)。
|
||||
6. 幂等化:每条 INSERT 加 `ON CONFLICT DO NOTHING`。
|
||||
"""
|
||||
import re, os, sys
|
||||
|
||||
ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
|
||||
SCHEMA = os.path.join(ROOT, 'src/backend/db/schema.sql')
|
||||
DST = os.path.join(ROOT, 'src/backend/db/demo_seed.sql')
|
||||
# 🔴 官方初始库路径:可用 `--src` 覆盖(默认是本机官方源码树的位置)。
|
||||
DEFAULT_SRC = '/Users/xs/Desktop/workspace/jnpf/7.0/database/PostgreSQL/jnpf_dbnull_init.sql'
|
||||
|
||||
EXCLUDE = {
|
||||
# 5 张纯大表:占原文 88% 体积(blade_visual_map 72.68MB / data_report / report_* )
|
||||
# 🔴 这几张是「可视化设计器 / 报表」的数据源,本仓对应的页面另有数据源 ⇒ 不导。
|
||||
'blade_visual_map',
|
||||
'data_report', 'report_charts', 'report_user', 'report_department',
|
||||
# 7 张本仓自管表:由 seed.rs / menus.rs 负责,灌入会撞复合主键
|
||||
'base_module', 'base_system', 'base_user', 'base_role',
|
||||
'base_organize', 'base_position', 'base_standing',
|
||||
}
|
||||
|
||||
CROP = {
|
||||
'ext_customer': {'f_contact_tel', 'f_en_code', 'f_full_name'},
|
||||
'ext_document': {'f_upload_url'},
|
||||
'ext_table_example': {
|
||||
'f_cost_amount', 'f_customer_name', 'f_interaction_date', 'f_jack_stands',
|
||||
'f_postil_count', 'f_principal', 'f_project_code', 'f_project_name',
|
||||
'f_project_phase', 'f_project_type', 'f_projected_income',
|
||||
'f_register_date', 'f_registrant', 'f_tunes_amount',
|
||||
},
|
||||
}
|
||||
|
||||
# 🔴 **三张「裁列 + 裁行」的表** —— 官方 init SQL 里有数据,但本仓只要用得上的部分。
|
||||
#
|
||||
# 背景(实测 A/B 走查 v4,官方 web@30093 vs ssw 静态包@30010):
|
||||
# `/api/system/Area/-1` 官方 34 行 / ssw 0 行 ⇒ 行政区划页空
|
||||
# `/api/system/BaseLang` 官方 20 行 / ssw 0 行 ⇒ 国际化页空
|
||||
# `/api/system/atlas` 官方有 / ssw 空 ⇒ 地图页空
|
||||
#
|
||||
# | 表 | 官方全量 | 本仓保留 | 理由 |
|
||||
# |---|---|---|---|
|
||||
# | `base_province` | 45411 行 / 12.0 MB | **f_type ≤ 3**(4061 行 / 1.06 MB) | 省级(34)+市(369)+区(3658) 三级;街道(41350) 用不到,砍掉省 90% 体积 |
|
||||
# | `base_language` | 4614 行 / 1.27 MB | 全量(裁列后) | 翻译标记,本仓 schema 有这张表 |
|
||||
# | `base_province_atlas` | 3210 行 / 1.07 MB | 全量(裁列后) | 地图省市区 + 中心点坐标 |
|
||||
#
|
||||
# 🔴 **裁列**:只留「列表页真的在读」的列,去掉 4 个审计列(`f_creator_time` 等)+
|
||||
# `f_description`(长文本)⇒ 体积省 ~40%,语义不变。
|
||||
#
|
||||
# 🔴 **裁行**:`base_province` 用 `f_type`(层级序号 1/2/3/4)切前三级。
|
||||
PARTIAL = {
|
||||
'base_province': {
|
||||
'keep': ['f_id', 'f_parent_id', 'f_en_code', 'f_full_name', 'f_quick_query',
|
||||
'f_type', 'f_sort_code', 'f_enabled_mark', 'f_delete_mark', 'f_tenant_id'],
|
||||
'row_filter': lambda vals, idx: vals[idx['f_type']] in ("'1'", "'2'", "'3'"),
|
||||
},
|
||||
'base_language': {
|
||||
'keep': ['f_id', 'f_group_id', 'f_en_code', 'f_full_name', 'f_language',
|
||||
'f_type', 'f_enabled_mark', 'f_sort_code', 'f_delete_mark', 'f_tenant_id'],
|
||||
},
|
||||
'base_province_atlas': {
|
||||
'keep': ['f_id', 'f_parent_id', 'f_en_code', 'f_full_name', 'f_quick_query',
|
||||
'f_type', 'f_division_code', 'f_atlas_center', 'f_enabled_mark',
|
||||
'f_sort_code', 'f_delete_mark', 'f_tenant_id'],
|
||||
},
|
||||
}
|
||||
|
||||
|
||||
def split_sql(text):
|
||||
"""与 Rust `sspf_store::db::split_sql_statements` 同款切分。"""
|
||||
out = []; cur = []; i = 0; n = len(text)
|
||||
while i < n:
|
||||
c = text[i]
|
||||
if c == '-' and i + 1 < n and text[i+1] == '-':
|
||||
cur.append(' '); i += 2
|
||||
while i < n and text[i] != '\n': i += 1
|
||||
continue
|
||||
if c == '/' and i + 1 < n and text[i+1] == '*':
|
||||
cur.append(' '); depth = 1; i += 2
|
||||
while i < n:
|
||||
if text[i] == '/' and i+1 < n and text[i+1] == '*': depth += 1; i += 2; continue
|
||||
if text[i] == '*' and i+1 < n and text[i+1] == '/':
|
||||
depth -= 1; i += 2
|
||||
if depth == 0: break
|
||||
continue
|
||||
if text[i] == '\n': cur.append('\n')
|
||||
i += 1
|
||||
continue
|
||||
if c == "'":
|
||||
cur.append("'"); i += 1
|
||||
while i < n:
|
||||
ch = text[i]
|
||||
if ch == "'":
|
||||
if i+1 < n and text[i+1] == "'": cur.append("''"); i += 2; continue
|
||||
cur.append("'"); i += 1; break
|
||||
cur.append(ch); i += 1
|
||||
continue
|
||||
if c == '"':
|
||||
cur.append('"'); i += 1
|
||||
while i < n:
|
||||
if text[i] == '"':
|
||||
if i+1 < n and text[i+1] == '"': cur.append('""'); i += 2; continue
|
||||
cur.append('"'); i += 1; break
|
||||
cur.append(text[i]); i += 1
|
||||
continue
|
||||
if c == ';':
|
||||
s = ''.join(cur).strip()
|
||||
if s: out.append(s)
|
||||
cur = []; i += 1; continue
|
||||
cur.append(c); i += 1
|
||||
s = ''.join(cur).strip()
|
||||
if s: out.append(s)
|
||||
return out
|
||||
|
||||
|
||||
def split_values(body):
|
||||
"""按逗号切 VALUES 里的值(尊重单引号串,'' 为转义)。"""
|
||||
vals = []; buf = []; q = False; i = 0; n = len(body)
|
||||
while i < n:
|
||||
c = body[i]
|
||||
if q:
|
||||
if c == "'":
|
||||
if i+1 < n and body[i+1] == "'": buf.append("''"); i += 2; continue
|
||||
q = False; buf.append("'"); i += 1; continue
|
||||
buf.append(c); i += 1; continue
|
||||
if c == "'": q = True; buf.append("'"); i += 1; continue
|
||||
if c == ',': vals.append(''.join(buf).strip()); buf = []; i += 1; continue
|
||||
buf.append(c); i += 1
|
||||
vals.append(''.join(buf).strip())
|
||||
return vals
|
||||
|
||||
|
||||
def parse_cols(block):
|
||||
cols = []
|
||||
for line in block.split('\n'):
|
||||
line = line.strip().rstrip(',')
|
||||
if not line or line.upper().startswith(
|
||||
('PRIMARY KEY', 'CONSTRAINT', 'UNIQUE', 'FOREIGN KEY', 'INDEX', 'CHECK', '--')):
|
||||
continue
|
||||
m = re.match(r'"?([a-z_0-9]+)"?\s+[A-Za-z]', line)
|
||||
if m: cols.append(m.group(1).lower())
|
||||
return cols
|
||||
|
||||
|
||||
def main():
|
||||
src_path = DEFAULT_SRC
|
||||
if len(sys.argv) > 2 and sys.argv[1] == '--src':
|
||||
src_path = sys.argv[2]
|
||||
if not os.path.isfile(src_path):
|
||||
print(f'❌ 找不到官方初始库: {src_path}\n'
|
||||
f' 用法: python3 scripts/gen-demo-seed.py [--src <jnpf_dbnull_init.sql>]',
|
||||
file=sys.stderr)
|
||||
sys.exit(2)
|
||||
sql = open(src_path, encoding='utf-8', errors='replace').read()
|
||||
schema = open(SCHEMA, encoding='utf-8').read()
|
||||
|
||||
schema_tables = {}
|
||||
for m in re.finditer(
|
||||
r'CREATE TABLE\s+(?:IF NOT EXISTS\s+)?(?:public\.)?"?([a-z_0-9]+)"?\s*\((.*?)\n\)',
|
||||
schema, re.S | re.I):
|
||||
schema_tables[m.group(1).lower()] = parse_cols(m.group(2))
|
||||
|
||||
stmts = split_sql(sql)
|
||||
ddls = {}
|
||||
rows_by_table = {} # 表名 → [(cols, vals)]
|
||||
for s in stmts:
|
||||
m = re.match(r'CREATE TABLE\s+(?:IF NOT EXISTS\s+)?(?:public\.)?"?([a-z_0-9]+)"?\s*\((.*?)\n\)',
|
||||
s, re.S | re.I)
|
||||
if m:
|
||||
ddls.setdefault(m.group(1).lower(), s)
|
||||
continue
|
||||
m = re.match(r'INSERT INTO\s+([a-z_0-9]+)\s*\(([^)]*)\)\s*VALUES\s*\((.*)\)\s*$',
|
||||
s, re.S | re.I)
|
||||
if not m:
|
||||
continue
|
||||
t = m.group(1).lower()
|
||||
cols = [c.strip() for c in m.group(2).split(',')]
|
||||
vals = split_values(m.group(3))
|
||||
if len(cols) != len(vals):
|
||||
print(f'⚠️ {t}: 列 {len(cols)} ≠ 值 {len(vals)} ⇒ 跳过', file=sys.stderr)
|
||||
continue
|
||||
rows_by_table.setdefault(t, []).append((cols, vals))
|
||||
|
||||
total_ins = sum(len(v) for v in rows_by_table.values())
|
||||
print(f'切分: {len(stmts)} 条语句 / {total_ins} 条 INSERT / {len(ddls)} 张表的 DDL',
|
||||
file=sys.stderr)
|
||||
|
||||
# ---- 逐表过滤 + 列裁剪(列与值同步裁)----
|
||||
kept = {} # 表名 → {'cols': [...], 'rows': [(vals)]}
|
||||
need_ddl = set()
|
||||
for t, rows in rows_by_table.items():
|
||||
if t in EXCLUDE:
|
||||
continue
|
||||
if t in PARTIAL:
|
||||
# 🔴 **部分保留**:官方形状但裁列(+ 可选裁行)。
|
||||
spec = PARTIAL[t]
|
||||
keep_cols = list(spec['keep'])
|
||||
col_idx = {c.lower(): i for i, c in enumerate(rows[0][0])}
|
||||
missing = [c for c in keep_cols if c not in col_idx]
|
||||
if missing:
|
||||
print(f'⚠️ {t}: 官方表无此列 {missing} ⇒ 整表跳过', file=sys.stderr)
|
||||
continue
|
||||
keep_idx = [col_idx[c] for c in keep_cols]
|
||||
# 本仓 schema 必须有这些列(否则插不进去)。
|
||||
if t in schema_tables:
|
||||
unknown = [c for c in keep_cols if c not in schema_tables[t]]
|
||||
if unknown:
|
||||
print(f'⚠️ {t}: 本仓 schema 无此列 {unknown} ⇒ 整表跳过', file=sys.stderr)
|
||||
continue
|
||||
row_filter = spec.get('row_filter')
|
||||
if row_filter:
|
||||
rows = [(c, v) for c, v in rows if row_filter(v, col_idx)]
|
||||
kept[t] = {'cols': keep_cols, 'rows': [[v[i] for i in keep_idx] for _, v in rows]}
|
||||
continue
|
||||
if t not in schema_tables:
|
||||
# 本仓 schema 没有 ⇒ 用官方 DDL 建表 ⇒ 列**不裁**(官方形状照搬)
|
||||
need_ddl.add(t)
|
||||
keep_idx = list(range(len(rows[0][0])))
|
||||
keep_cols = list(rows[0][0])
|
||||
else:
|
||||
drop = CROP.get(t, set())
|
||||
keep_idx = [i for i, c in enumerate(rows[0][0]) if c.lower() not in drop]
|
||||
keep_cols = [rows[0][0][i] for i in keep_idx]
|
||||
unknown = [c for c in keep_cols if c.lower() not in schema_tables[t]]
|
||||
if unknown:
|
||||
print(f'⚠️ {t}: 本仓 schema 无此列 {unknown} ⇒ 整表跳过', file=sys.stderr)
|
||||
continue
|
||||
kept[t] = {'cols': keep_cols, 'rows': [[v[i] for i in keep_idx] for _, v in rows]}
|
||||
|
||||
print(f'保留: {len(kept)} 张表 / {sum(len(v["rows"]) for v in kept.values())} 条行', file=sys.stderr)
|
||||
print(f'需补 DDL: {len(need_ddl)} 张 ⇒ {sorted(need_ddl)}', file=sys.stderr)
|
||||
|
||||
# ---- 生成输出 ----
|
||||
out = []
|
||||
out.append('-- ============================================================================')
|
||||
out.append('-- JNPF 7.0 官方示例数据(裁剪版)')
|
||||
out.append('-- ============================================================================')
|
||||
out.append('--')
|
||||
out.append('-- 真源:jnpf/7.0/database/PostgreSQL/jnpf_dbnull_init.sql(官方 7.0 初始库)')
|
||||
out.append('-- 生成:scripts/gen-demo-seed.py(引号感知切分 ⇒ 字符串内的 `;` 不切错)')
|
||||
out.append('--')
|
||||
out.append(f'-- 保留 {len(kept)} 张表 / {sum(len(v["rows"]) for v in kept.values())} 条示例行。')
|
||||
out.append('--')
|
||||
out.append('-- 排除 5 张纯大表(占原文 88% 体积):blade_visual_map / data_report /')
|
||||
out.append('-- report_charts / report_user / report_department')
|
||||
out.append('-- 排除 7 张本仓自管表(撞复合主键,由 seed.rs / menus.rs 负责):')
|
||||
out.append('-- base_module / base_system / base_user / base_role /')
|
||||
out.append('-- base_organize / base_position / base_standing')
|
||||
out.append('-- 部分保留(裁列 + 裁行,见 scripts/gen-demo-seed.py 的 PARTIAL):')
|
||||
out.append('-- base_province(只留 f_type<=3 的省/市/区,砍掉街道级)/')
|
||||
out.append('-- base_language / base_province_atlas')
|
||||
out.append('--')
|
||||
out.append('-- 🔴 每条 INSERT 都带 `ON CONFLICT DO NOTHING` ⇒ **幂等**:')
|
||||
out.append('-- 重复启动不炸、不覆盖人工改动(官方 id 是雪花 id,不与已有行相撞)。')
|
||||
out.append('')
|
||||
|
||||
need_ddl = sorted(need_ddl & set(ddls))
|
||||
if need_ddl:
|
||||
out.append('-- ---------------------------------------------------------------------------')
|
||||
out.append('-- 【DDL】示例系统专用表(本仓 schema 里没有 ⇒ 先建表)')
|
||||
out.append('-- ---------------------------------------------------------------------------')
|
||||
for t in need_ddl:
|
||||
out.append('')
|
||||
# 🔴 **幂等**:示例 DDL 每次启动都会执行(ensure_demo_data 每次启动跑),
|
||||
# 第二次启动时表已存在 ⇒ 普通 CREATE TABLE 会报「表已存在」把 stderr 刷满。
|
||||
# 一律归一化为 `CREATE TABLE IF NOT EXISTS`(剥离官方原文里可能有的 IF NOT EXISTS)。
|
||||
ddl = re.sub(
|
||||
r'^CREATE TABLE\s+(?:IF NOT EXISTS\s+)?',
|
||||
'CREATE TABLE IF NOT EXISTS ',
|
||||
ddls[t].strip(),
|
||||
count=1,
|
||||
flags=re.I,
|
||||
)
|
||||
out.append(ddl + ';')
|
||||
out.append('')
|
||||
|
||||
out.append('-- ---------------------------------------------------------------------------')
|
||||
out.append('-- 【DATA】示例数据')
|
||||
out.append('-- ---------------------------------------------------------------------------')
|
||||
for t in sorted(kept):
|
||||
info = kept[t]
|
||||
out.append('')
|
||||
out.append(f'-- {t}({len(info["rows"])} 行)')
|
||||
cols_sql = ', '.join(info['cols'])
|
||||
for v in info['rows']:
|
||||
out.append(f'INSERT INTO {t} ({cols_sql}) VALUES (')
|
||||
out.append(' ' + ', '.join(v))
|
||||
out.append(') ON CONFLICT DO NOTHING;')
|
||||
|
||||
open(DST, 'w', encoding='utf-8').write('\n'.join(out) + '\n')
|
||||
print(f'写出 {DST}({os.path.getsize(DST)} bytes)', file=sys.stderr)
|
||||
|
||||
|
||||
if __name__ == '__main__':
|
||||
main()
|
||||
@@ -0,0 +1,365 @@
|
||||
#!/usr/bin/env bash
|
||||
#
|
||||
# pack-jnpf-assets.sh —— 打「JNPF 通用资产包」(静态前端 + 示例数据库)
|
||||
#
|
||||
# 🔴 为什么单独一个包(2026-11-06 定的分发模型):
|
||||
# 这两样东西**跟部署环境、目标平台、sspf 版本、rust 工具链都无关**,
|
||||
# **只跟 JNPF 版本有关**:
|
||||
# · web/ = 官方 JNPF 7.0 web 前端的构建产物(纯静态文件,任何 OS/CPU 都能托管)
|
||||
# · db/ = 官方 JNPF 7.0 初始库(jnpf_dbnull_init.sql)按本仓契约裁出的示例数据
|
||||
# ⇒ 不该塞进 `sspf-vX.Y.Z-<target>.tar.gz`(那个包按 sspf 版本 × 目标平台出,
|
||||
# ABI 锁 rustc)。资产包**一份**即可被所有 sspf 版本 / 所有平台 / 所有环境复用。
|
||||
#
|
||||
# 包结构:
|
||||
# jnpf-7.0-assets/
|
||||
# ├── manifest.json # 🔴 版本绑定声明 + 来源 sha256 + 全树摘要 + 消费方式
|
||||
# ├── README.md # 解包即用(SSW_ASSETS_DIR 一个 env 搞定)
|
||||
# ├── SHA256SUMS # 每个文件的 sha256(含 web/ 全量)
|
||||
# ├── web/ # 官方前端静态产物(同源托管,免 node/pnpm)
|
||||
# │ └── api/file/Image/ # 官方数据库/AI 图标(14 张,供 /api/file/Image/** 同源返回)
|
||||
# ├── db/
|
||||
# │ ├── demo_seed.sql # 示例数据(58 表 / 14242 行,INSERT 幂等)
|
||||
# │ ├── schema.sql # 本仓实际使用的官方 DDL(裁列规则的依据)
|
||||
# │ └── SOURCE.md # 官方 init SQL 是哪个文件、怎么裁的
|
||||
# └── tools/gen-demo-seed.py # 生成器副本(可从官方 init SQL 复现 demo_seed.sql)
|
||||
#
|
||||
# 用法:
|
||||
# bash scripts/pack-jnpf-assets.sh # 用现有 dist/web + db 出包
|
||||
# bash scripts/pack-jnpf-assets.sh --rebuild-web # 先重构建官方前端
|
||||
# bash scripts/pack-jnpf-assets.sh --web <dir> # 指定已有静态产物目录
|
||||
# bash scripts/pack-jnpf-assets.sh --version 7.0 # 指定 JNPF 版本(默认 7.0)
|
||||
#
|
||||
# 环境变量:
|
||||
# JNPF_VERSION 默认 7.0
|
||||
# JNPF_INIT_SQL 官方初始库路径(只用于记录来源 sha256,不随包分发)
|
||||
# WEB_OUT 已有静态产物目录(默认 dist/web)
|
||||
# ASSETS_OUT 打包输出目录(默认 dist)
|
||||
#
|
||||
set -euo pipefail
|
||||
|
||||
cd "$(dirname "$0")/.."
|
||||
REPO_ROOT="$(pwd)"
|
||||
|
||||
VERSION="${JNPF_VERSION:-7.0}"
|
||||
WEB_DIR="${WEB_OUT:-${REPO_ROOT}/dist/web}"
|
||||
OUT="${ASSETS_OUT:-${REPO_ROOT}/dist}"
|
||||
INIT_SQL="${JNPF_INIT_SQL:-/Users/xs/Desktop/workspace/jnpf/7.0/database/PostgreSQL/jnpf_dbnull_init.sql}"
|
||||
REBUILD_WEB=0
|
||||
|
||||
while [[ $# -gt 0 ]]; do
|
||||
case "$1" in
|
||||
--rebuild-web) REBUILD_WEB=1; shift ;;
|
||||
--web) WEB_DIR="${2:-}"; shift 2 ;;
|
||||
--version) VERSION="${2:-}"; shift 2 ;;
|
||||
-h|--help) sed -n '1,40p' "$0"; exit 0 ;;
|
||||
*) echo "未知参数: $1" >&2; exit 1 ;;
|
||||
esac
|
||||
done
|
||||
|
||||
PKG="jnpf-${VERSION}-assets"
|
||||
PKG_DIR="${OUT}/${PKG}"
|
||||
TAR="${OUT}/${PKG}.tar.gz"
|
||||
|
||||
echo "==> JNPF 通用资产包: ${PKG}"
|
||||
echo " 与 sspf 版本 / OS / CPU / rust 工具链 / 部署环境无关,只绑定 JNPF ${VERSION}"
|
||||
|
||||
# ── 1. 前置检查 ───────────────────────────────────────────────
|
||||
if [[ "${REBUILD_WEB}" == "1" ]]; then
|
||||
echo "==> 重新构建官方前端(build-web.sh)"
|
||||
bash "${REPO_ROOT}/scripts/build-web.sh"
|
||||
fi
|
||||
if [[ ! -f "${WEB_DIR}/index.html" ]]; then
|
||||
echo "!! 缺少静态前端产物: ${WEB_DIR}/index.html" >&2
|
||||
echo " 先跑: bash scripts/build-web.sh 或 bash scripts/pack-jnpf-assets.sh --rebuild-web" >&2
|
||||
exit 1
|
||||
fi
|
||||
SEED="${REPO_ROOT}/src/backend/db/demo_seed.sql"
|
||||
SCHEMA="${REPO_ROOT}/src/backend/db/schema.sql"
|
||||
GENERATOR="${REPO_ROOT}/scripts/gen-demo-seed.py"
|
||||
for f in "${SEED}" "${SCHEMA}" "${GENERATOR}"; do
|
||||
if [[ ! -f "${f}" ]]; then echo "!! 缺少资源: ${f}" >&2; exit 1; fi
|
||||
done
|
||||
# 官方 init SQL 只用于记录来源摘要;找不到不阻塞(换台机器出包时常见)。
|
||||
if [[ ! -f "${INIT_SQL}" ]]; then
|
||||
echo "!! 提示:找不到官方初始库 ${INIT_SQL}(manifest 里来源 sha256 记为 null)" >&2
|
||||
INIT_SQL=""
|
||||
fi
|
||||
|
||||
# ── 2. 组装目录(旧目录移到 /tmp,不 rm -rf)──────────────────
|
||||
if [[ -d "${PKG_DIR}" ]]; then
|
||||
DEST="/tmp/old_${PKG}_$(date +%s)"
|
||||
mv "${PKG_DIR}" "${DEST}"
|
||||
echo "==> 旧目录已移走: ${DEST}"
|
||||
fi
|
||||
mkdir -p "${PKG_DIR}/web" "${PKG_DIR}/db" "${PKG_DIR}/tools"
|
||||
rsync -a --exclude '.DS_Store' "${WEB_DIR}/" "${PKG_DIR}/web/"
|
||||
cp "${SEED}" "${PKG_DIR}/db/demo_seed.sql"
|
||||
cp "${SCHEMA}" "${PKG_DIR}/db/schema.sql"
|
||||
cp "${GENERATOR}" "${PKG_DIR}/tools/gen-demo-seed.py"
|
||||
|
||||
# ── 2.5 官方文件图标(`/api/file/Image/**`)────────────────────
|
||||
# 官方前端把数据库类型 / AI 模型图标放在 `/api/file/Image/**`(官方后端 302 到文件服务)。
|
||||
# 同源静态托管没有文件服务 ⇒ 之前这些 URL 全返信封 404(图标不显示 + 控制台报错)。
|
||||
# ⇒ 资产包把官方 jnpf-resources 的 14 张图入仓后放到 `web/api/file/Image/`,
|
||||
# 后端 fallback 的精确白名单命中即返文件(见 routes.rs::fallback_response)。
|
||||
FILE_IMAGES="${REPO_ROOT}/src/backend/assets/jnpf-7.0/file-images"
|
||||
IMG_DST="${PKG_DIR}/web/api/file/Image"
|
||||
if [[ -d "${FILE_IMAGES}" ]]; then
|
||||
mkdir -p "${IMG_DST}"
|
||||
for d in databaseicon AiFile aimodelicon; do
|
||||
if [[ -d "${FILE_IMAGES}/${d}" ]]; then
|
||||
mkdir -p "${IMG_DST}/${d}"
|
||||
cp "${FILE_IMAGES}/${d}"/*.png "${IMG_DST}/${d}/"
|
||||
fi
|
||||
done
|
||||
IMG_N="$(find "${IMG_DST}" -type f | wc -l | tr -d ' ')"
|
||||
echo "==> web/api/file/Image/ ${IMG_N} 张官方图标(数据库 6 / AI 8)"
|
||||
else
|
||||
IMG_N=0
|
||||
echo "!! 缺少 ${FILE_IMAGES} —— 资产包不含官方图标(相关页面图标会 404)" >&2
|
||||
fi
|
||||
|
||||
WEB_N="$(find "${PKG_DIR}/web" -type f | wc -l | tr -d ' ')"
|
||||
WEB_SIZE="$(du -sh "${PKG_DIR}/web" | cut -f1)"
|
||||
echo "==> web/ ${WEB_N} 文件 / ${WEB_SIZE}"
|
||||
echo "==> db/ demo_seed.sql $(du -h "${SEED}" | cut -f1), schema.sql $(du -h "${SCHEMA}" | cut -f1)"
|
||||
|
||||
# ── 3. 生成 manifest.json(版本绑定声明 + 来源 + 全树摘要)─────
|
||||
export PKG_DIR WEB_DIR INIT_SQL VERSION REPO_ROOT
|
||||
python3 - <<'PY'
|
||||
import hashlib, json, os, re, sys, time
|
||||
|
||||
root = os.environ["PKG_DIR"]
|
||||
version = os.environ["VERSION"]
|
||||
init_sql = os.environ["INIT_SQL"]
|
||||
|
||||
def sha(path):
|
||||
h = hashlib.sha256()
|
||||
with open(path, "rb") as f:
|
||||
for b in iter(lambda: f.read(1 << 20), b""):
|
||||
h.update(b)
|
||||
return h.hexdigest()
|
||||
|
||||
# 全树摘要:相对路径排序后逐文件 hash,再对「路径+hash」串做一次 hash
|
||||
# ⇒ 与目录时间戳/文件顺序/打包工具无关,跨平台可复算。
|
||||
tree = hashlib.sha256()
|
||||
files = []
|
||||
for base, dirs, names in os.walk(os.path.join(root, "web")):
|
||||
dirs.sort()
|
||||
for n in sorted(names):
|
||||
p = os.path.join(base, n)
|
||||
if not os.path.isfile(p):
|
||||
continue
|
||||
rel = os.path.relpath(p, os.path.join(root, "web"))
|
||||
d = sha(p)
|
||||
files.append((rel, os.path.getsize(p), d))
|
||||
tree.update((rel + "\0" + d + "\n").encode())
|
||||
|
||||
img_dir = os.path.join(root, "web", "api", "file", "Image")
|
||||
img_n = 0
|
||||
if os.path.isdir(img_dir):
|
||||
for _base, _dirs, _names in os.walk(img_dir):
|
||||
img_n += sum(1 for n in _names if os.path.isfile(os.path.join(_base, n)))
|
||||
|
||||
seed_path = os.path.join(root, "db", "demo_seed.sql")
|
||||
seed_txt = open(seed_path, encoding="utf-8").read()
|
||||
# demo_seed.sql 里只有 13 张「本仓 schema 没有的示例系统表」带 DDL;
|
||||
# 其余表的 DDL 由 db/schema.sql 负责 ⇒ 表数要按 INSERT 涉及的表统计(58)。
|
||||
ddl_tables = sorted(set(re.findall(r"CREATE TABLE IF NOT EXISTS\s+(\w+)", seed_txt)))
|
||||
insert_tables = sorted(set(re.findall(r"^INSERT INTO\s+(\w+)", seed_txt, re.M)))
|
||||
inserts = len(re.findall(r"^INSERT INTO\s+", seed_txt, re.M))
|
||||
create_n = len(re.findall(r"^CREATE TABLE", seed_txt, re.M))
|
||||
|
||||
manifest = {
|
||||
"pack": os.path.basename(root),
|
||||
"schema_version": 1,
|
||||
"jnpf_version": version,
|
||||
"built_at": time.strftime("%Y-%m-%dT%H:%M:%S%z"),
|
||||
"binding": {
|
||||
"depends_on": ["jnpf " + version],
|
||||
"independent_of": [
|
||||
"sspf_version", "os", "cpu_arch", "rust_toolchain",
|
||||
"build_target", "deployment_env", "database_runtime",
|
||||
],
|
||||
"note": "同一 JNPF 版本只出一份;任意 sspf 版本 / 平台 / 环境直接复用,无需重编二进制。",
|
||||
},
|
||||
"source": {
|
||||
"web": {
|
||||
"kind": "official JNPF web frontend build output",
|
||||
"build": "pnpm run build:main (@jnpf/main)",
|
||||
"build_script": "scripts/build-web.sh",
|
||||
},
|
||||
"database": {
|
||||
"kind": "official JNPF init SQL (demo data)",
|
||||
"file": os.path.basename(init_sql) if init_sql else None,
|
||||
"path": init_sql or None,
|
||||
"sha256": sha(init_sql) if init_sql else None,
|
||||
"bytes": os.path.getsize(init_sql) if init_sql else None,
|
||||
},
|
||||
},
|
||||
"contents": {
|
||||
"web": {
|
||||
"files": len(files),
|
||||
"bytes": sum(x[1] for x in files),
|
||||
"tree_sha256": tree.hexdigest(),
|
||||
"entry": "index.html",
|
||||
"api_base": "",
|
||||
"note": "API 前缀为空 ⇒ 与后端同源托管,请求 /api/* 打到同一进程。",
|
||||
"file_images": {
|
||||
"files": img_n,
|
||||
"path": "web/api/file/Image/",
|
||||
"note": "官方数据库类型 / AI 模型图标;后端 fallback 白名单命中 /api/file/Image/** 时返文件,避免 404。",
|
||||
},
|
||||
},
|
||||
"db/demo_seed.sql": {
|
||||
"sha256": sha(seed_path),
|
||||
"bytes": os.path.getsize(seed_path),
|
||||
"create_tables": create_n,
|
||||
"ddl_tables": len(ddl_tables),
|
||||
"tables": len(insert_tables),
|
||||
"insert_statements": inserts,
|
||||
"generator": "tools/gen-demo-seed.py",
|
||||
"note": "裁剪版(排除 5 张纯大表 + 7 张本仓自管表;3 张 ext_* 裁列;3 张大表部分保留);所有 INSERT 带 ON CONFLICT DO NOTHING ⇒ 幂等。",
|
||||
},
|
||||
"db/schema.sql": {
|
||||
"sha256": sha(os.path.join(root, "db", "schema.sql")),
|
||||
"note": "本仓实际使用的官方 DDL,是裁列规则的依据。",
|
||||
},
|
||||
},
|
||||
"consumption": {
|
||||
"one_env": "SSW_ASSETS_DIR=./" + os.path.basename(root),
|
||||
"explicit": {
|
||||
"SSW_STATIC_DIR": "./" + os.path.basename(root) + "/web",
|
||||
"SSW_DEMO_SEED_FILE": "./" + os.path.basename(root) + "/db/demo_seed.sql",
|
||||
},
|
||||
"disable_demo_data": "SSW_DEMO_DATA=false",
|
||||
"fallback": "不设任何 env ⇒ 二进制内嵌的编译期示例数据(旧行为,保持兼容)",
|
||||
},
|
||||
"verify": "shasum -a 256 -c SHA256SUMS(在包根目录执行)",
|
||||
}
|
||||
with open(os.path.join(root, "manifest.json"), "w", encoding="utf-8") as f:
|
||||
json.dump(manifest, f, ensure_ascii=False, indent=2)
|
||||
f.write("\n")
|
||||
print(f"==> manifest.json(web 全树 sha256={tree.hexdigest()[:16]}…,"
|
||||
f"示例数据 {len(insert_tables)} 表 / {inserts} 条 INSERT / {create_n} 条 CREATE)")
|
||||
PY
|
||||
|
||||
# ── 4. SOURCE.md + README.md ───────────────────────────────────
|
||||
cat > "${PKG_DIR}/db/SOURCE.md" <<EOF
|
||||
# 示例数据来源(JNPF ${VERSION})
|
||||
|
||||
- 官方真值源:\`jnpf_dbnull_init.sql\`(PostgreSQL 初始库,约 101 MB / 331 表 / 59361 条 INSERT)。
|
||||
摘要与路径见包根 \`manifest.json\` 的 \`source.database\`;**原文件不随包分发**(体积大且不需要)。
|
||||
- \`demo_seed.sql\` 是**裁剪版**,由 \`tools/gen-demo-seed.py\` 从官方 init SQL 生成:
|
||||
1. 排除 5 张纯大表(\`blade_visual_map\` 等,占原文 88% 体积);
|
||||
2. 排除 7 张本仓自管表(\`base_module\` / \`base_user\` / \`base_role\` … 避免撞复合主键);
|
||||
3. 3 张 \`ext_*\` 表与本仓形状不同 ⇒ 只保留两边都有的列;
|
||||
4. \`base_province\` / \`base_language\` / \`base_province_atlas\` 裁审计列 + 裁街道级行;
|
||||
5. 每条 INSERT 追加 \`ON CONFLICT DO NOTHING\` ⇒ 重复启动不炸、不覆盖人工改动。
|
||||
- \`schema.sql\` 是本仓实际使用的官方 DDL(生成器用它对齐列)。
|
||||
- 想换成别的 JNPF 版本的示例数据 ⇒ 用该版本的 init SQL 重跑生成器,再重新出本资产包;
|
||||
**不需要重编 sspf 二进制**(\`SSW_DEMO_SEED_FILE\` 指向新文件即可)。
|
||||
|
||||
## 图标资源
|
||||
|
||||
\`web/api/file/Image/\` 下的 14 张 PNG 来自官方 \`jnpf-resources\`(\`DatabaseIcon\` 6 张 /
|
||||
\`AiFile\` 2 张 / \`AiModelIcon\` 6 张,目录名按前端请求路径映射为
|
||||
\`databaseicon\` / \`AiFile\` / \`aimodelicon\`),真源已入仓
|
||||
\`src/backend/assets/jnpf-7.0/file-images/\`。官方后端对这些路径是 302 到文件服务;
|
||||
同源托管改由资产包直接提供文件 ⇒ 数据库图标与 AI 模型图标能正常显示。
|
||||
EOF
|
||||
|
||||
cat > "${PKG_DIR}/README.md" <<EOF
|
||||
# JNPF ${VERSION} 通用资产包
|
||||
|
||||
**静态前端 + 示例数据库**。只跟 **JNPF ${VERSION}** 有关,跟 sspf 版本、操作系统、CPU 架构、
|
||||
rust 工具链、部署环境、数据库运行时都无关 ⇒ 一份包可被所有平台的所有版本复用。
|
||||
|
||||
## 包里有什么
|
||||
|
||||
| 路径 | 内容 |
|
||||
|---|---|
|
||||
| \`web/\` | 官方 JNPF ${VERSION} web 前端**构建产物**(同源托管,不需要 node/pnpm) |
|
||||
| \`web/api/file/Image/\` | 官方数据库类型 / AI 模型图标(14 张),供 \`/api/file/Image/**\` 同源返回,避免这几个页面的图标 404 |
|
||||
| \`db/demo_seed.sql\` | 官方示例数据裁剪版,INSERT 幂等,启动时导入 |
|
||||
| \`db/schema.sql\` | 本仓使用的官方 DDL(裁列规则依据) |
|
||||
| \`db/SOURCE.md\` | 来源与裁剪规则说明 |
|
||||
| \`tools/gen-demo-seed.py\` | 生成器副本(换 JNPF 版本时可复现) |
|
||||
| \`manifest.json\` | 版本绑定声明、来源 sha256、web 全树摘要、消费方式 |
|
||||
| \`SHA256SUMS\` | 全包逐文件 sha256 |
|
||||
|
||||
## 解包即用
|
||||
|
||||
\`\`\`bash
|
||||
tar -xzf ${PKG}.tar.gz
|
||||
SSW_ASSETS_DIR=./${PKG} PGLITE_DIR=./data/lite.pg PORT=30010 ./bin/sspf-admin
|
||||
# 打开 http://127.0.0.1:30010/ ⇒ 官方前端 + ssw-platform 后端同源
|
||||
\`\`\`
|
||||
|
||||
等价的显式写法(要覆盖单项时用):
|
||||
|
||||
\`\`\`bash
|
||||
SSW_STATIC_DIR=./${PKG}/web \\
|
||||
SSW_DEMO_SEED_FILE=./${PKG}/db/demo_seed.sql \\
|
||||
PGLITE_DIR=./data/lite.pg PORT=30010 ./bin/sspf-admin
|
||||
\`\`\`
|
||||
|
||||
- 优先级:\`SSW_STATIC_DIR\` / \`SSW_DEMO_SEED_FILE\` \> \`SSW_ASSETS_DIR\` 自动推导 \> 二进制内嵌兜底。
|
||||
- 不想要示例数据:\`SSW_DEMO_DATA=false\`(纯净库)。
|
||||
- 资产包路径可以是相对路径,服务启动时会按 CWD 绝对化(PGlite 会 chdir,见 config.rs)。
|
||||
|
||||
## 校验
|
||||
|
||||
\`\`\`bash
|
||||
cd ${PKG} && shasum -a 256 -c SHA256SUMS | tail -1
|
||||
\`\`\`
|
||||
|
||||
## 边界
|
||||
|
||||
- 本包**不含**任何可执行二进制、rlib、node_modules ⇒ 与平台 ABI 无关。
|
||||
- 换 JNPF 版本 ⇒ 重新出一份资产包;换 sspf 版本 ⇒ **不用动本包**。
|
||||
EOF
|
||||
|
||||
# ── 5. SHA256SUMS(含 web/ 全量文件)───────────────────────────
|
||||
python3 - <<'PY'
|
||||
import hashlib, os
|
||||
root = os.environ["PKG_DIR"]
|
||||
out = []
|
||||
for base, dirs, names in os.walk(root):
|
||||
dirs.sort()
|
||||
for n in sorted(names):
|
||||
if n == "SHA256SUMS":
|
||||
continue
|
||||
p = os.path.join(base, n)
|
||||
if not os.path.isfile(p):
|
||||
continue
|
||||
h = hashlib.sha256()
|
||||
with open(p, "rb") as f:
|
||||
for b in iter(lambda: f.read(1 << 20), b""):
|
||||
h.update(b)
|
||||
out.append(f"{h.hexdigest()} {os.path.relpath(p, root)}")
|
||||
with open(os.path.join(root, "SHA256SUMS"), "w", encoding="utf-8") as f:
|
||||
f.write("\n".join(out) + "\n")
|
||||
print(f"==> SHA256SUMS({len(out)} 个文件)")
|
||||
PY
|
||||
|
||||
# ── 6. 打 tar.gz + 自检 ───────────────────────────────────────
|
||||
tar -czf "${TAR}" -C "${OUT}" "${PKG}"
|
||||
TAR_SIZE="$(du -h "${TAR}" | cut -f1)"
|
||||
for f in manifest.json README.md SHA256SUMS web/index.html db/demo_seed.sql db/schema.sql db/SOURCE.md tools/gen-demo-seed.py; do
|
||||
if ! tar -tzf "${TAR}" | grep -q "^${PKG}/${f}$"; then
|
||||
echo "!! 包内缺少 ${f}" >&2; exit 1
|
||||
fi
|
||||
done
|
||||
ENTRY="$(tar -tzf "${TAR}" | wc -l | tr -d ' ')"
|
||||
echo "==> ✅ ${TAR} (${TAR_SIZE} / ${ENTRY} 项)"
|
||||
echo ""
|
||||
echo "=================================================="
|
||||
echo "✅ JNPF ${VERSION} 通用资产包完成"
|
||||
echo " 目录: ${PKG_DIR}"
|
||||
echo " 压缩包: ${TAR} (${TAR_SIZE})"
|
||||
echo " 静态前端: web/ (${WEB_N} 文件 / ${WEB_SIZE})"
|
||||
echo " 示例数据: db/demo_seed.sql"
|
||||
echo " 用法: SSW_ASSETS_DIR=./${PKG} PORT=30010 ./bin/sspf-admin"
|
||||
echo " 🔴 只绑定 JNPF 版本:所有 sspf 版本 / 所有平台 / 所有环境复用同一份"
|
||||
echo "=================================================="
|
||||
@@ -0,0 +1,47 @@
|
||||
"""在 PGlite 数据目录上跑只读 SQL(PGlite 同一目录只能开一次,查询前须停后端)。
|
||||
|
||||
用法:
|
||||
python3 scripts/query-pg.py "<SQL>" [PGLITE_DIR]
|
||||
"""
|
||||
import json
|
||||
import subprocess
|
||||
import sys
|
||||
import os
|
||||
|
||||
ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
|
||||
SQL = sys.argv[1]
|
||||
DIR = sys.argv[2] if len(sys.argv) > 2 else "/tmp/ssw-demo.pg"
|
||||
|
||||
runner = r"""
|
||||
import { PGlite } from '@electric-sql/pglite'
|
||||
import fs from 'node:fs'
|
||||
const dir = process.argv[2]
|
||||
const sql = fs.readFileSync(process.argv[3], 'utf8')
|
||||
const db = await PGlite.create({ dataDir: dir })
|
||||
const res = await db.query(sql)
|
||||
console.log(JSON.stringify(res.rows, null, 2))
|
||||
await db.close()
|
||||
"""
|
||||
|
||||
tmp = "/tmp/_pglite_q.sql"
|
||||
with open(tmp, "w") as f:
|
||||
f.write(SQL)
|
||||
|
||||
script = "/tmp/_pglite_q.mjs"
|
||||
with open(script, "w") as f:
|
||||
f.write(runner)
|
||||
|
||||
env = dict(os.environ)
|
||||
cmd = ["node", script, DIR, tmp]
|
||||
r = subprocess.run(cmd, capture_output=True, text=True, cwd=ROOT, env=env)
|
||||
if r.returncode != 0:
|
||||
sys.stderr.write(r.stderr[-4000:])
|
||||
sys.exit(r.returncode)
|
||||
out = r.stdout.strip()
|
||||
try:
|
||||
rows = json.loads(out)
|
||||
print("rows:", len(rows))
|
||||
for row in rows[:200]:
|
||||
print(json.dumps(row, ensure_ascii=False))
|
||||
except Exception:
|
||||
print(out[-4000:])
|
||||
@@ -21,6 +21,7 @@
|
||||
# ├── crates/<sspf 内部闭包> # 平台 crate 源码(dev 回退:想改平台时用 path 依赖吃这层)
|
||||
# ├── src/backend/ # 🔴 内核 lib(ssw-platform)—— sspf 的 path 依赖
|
||||
# ├── frontend/ # 平台前端源码(不含 node_modules/dist,可选随包)
|
||||
# ├── web/ # 静态通用前端(可选,`--no-web` 剥离;独立资产包另发)
|
||||
# ├── Cargo.toml # 🔴 workspace 根(继承 version/edition 靠它)
|
||||
# ├── Cargo.lock # 🔴 锁定整个闭包,消费方 --offline 才解析得开
|
||||
# ├── rust-toolchain.toml # 🔴 工具链版本(= 1.95.0,消费方必须同版本才吃得进 rlib)
|
||||
@@ -49,8 +50,16 @@
|
||||
# bash scripts/release.sh # 以 crates/sspf 的 version 为版本号出包
|
||||
# bash scripts/release.sh 0.5.1 # 显式指定版本(覆盖 crates/sspf 的 version)
|
||||
# bash scripts/release.sh 0.5.1 --publish # 出包并**推到 Gitea Release**(tag v0.5.1)
|
||||
# bash scripts/release.sh --no-web # 不把静态前端塞进平台包(改用独立资产包)
|
||||
#
|
||||
# 🔴 **JNPF 通用资产包单独分发**(2026-11-06):
|
||||
# 静态前端 + 示例数据库**只跟 JNPF 版本有关**,跟 sspf 版本 / OS / CPU / rust 工具链 /
|
||||
# 部署环境无关 ⇒ 由 `scripts/pack-jnpf-assets.sh` 单独出 `dist/jnpf-7.0-assets.tar.gz`,
|
||||
# 一份包被所有平台的所有 sspf 版本复用。平台包**默认仍携带** `web/`(向后兼容),
|
||||
# 但内容以资产包为唯一真源;`--no-web` 可完全剥离 ⇒ 平台包只留二进制 + rlib。
|
||||
#
|
||||
# 产物:dist/sspf-vX.Y.Z-<target>.tar.gz(如 sspf-v0.5.1-x86_64-apple-darwin.tar.gz)
|
||||
# dist/jnpf-7.0-assets.tar.gz(独立资产包,另由 pack-jnpf-assets.sh 产出)
|
||||
# 发布:Gitea Release tag=vX.Y.Z,asset=<同上>;消费方 fetch-platform.sh 按 tag+target 拉取
|
||||
#
|
||||
# 环境变量(发布用):
|
||||
@@ -66,11 +75,13 @@ export REPO_ROOT="$(pwd)"
|
||||
|
||||
# ── 1. 解析参数 + 决定版本号 ───────────────────────────────────
|
||||
PUBLISH=0
|
||||
WITH_WEB=1
|
||||
POSITIONAL=()
|
||||
for _a in "$@"; do
|
||||
case "${_a}" in
|
||||
--publish) PUBLISH=1 ;;
|
||||
-h|--help) sed -n '1,64p' "$0"; exit 0 ;;
|
||||
--no-web) WITH_WEB=0 ;;
|
||||
-h|--help) sed -n '1,72p' "$0"; exit 0 ;;
|
||||
*) POSITIONAL+=("${_a}") ;;
|
||||
esac
|
||||
done
|
||||
@@ -160,6 +171,42 @@ cp "${BIN}" "${PKG_DIR}/bin/sspf-admin"
|
||||
BIN_SIZE="$(du -h "${PKG_DIR}/bin/sspf-admin" | cut -f1)"
|
||||
echo "==> bin/sspf-admin (${BIN_SIZE})"
|
||||
|
||||
# 3.1.5 静态通用前端(JNPF 7.0 官方 web 前端产物)—— **可选随包**。
|
||||
#
|
||||
# 🔴 真源已改为「JNPF 通用资产包」`dist/jnpf-7.0-assets/`(由 pack-jnpf-assets.sh 产出):
|
||||
# 静态前端 + 示例数据库只跟 JNPF 版本有关 ⇒ 独立出 `dist/jnpf-7.0-assets.tar.gz`,
|
||||
# 所有 sspf 版本 / 所有目标平台复用同一份,不必随每个平台包重复分发。
|
||||
# 平台包默认仍拷一份 `web/`(向后兼容「跟版本包一起分发」),`--no-web` 可剥离。
|
||||
#
|
||||
# ⇒ 消费方二选一:
|
||||
# ① 平台包自带:`SSW_STATIC_DIR=./web ./bin/sspf-admin`
|
||||
# ② 独立资产包:`SSW_ASSETS_DIR=./jnpf-7.0-assets ./bin/sspf-admin`(连示例数据库一起外置)
|
||||
WEB_N=0
|
||||
WEB_SIZE="-"
|
||||
WEB_SRC="(未随包)"
|
||||
if [[ "${WITH_WEB}" == "1" ]]; then
|
||||
ASSETS_WEB="${REPO_ROOT}/dist/jnpf-7.0-assets/web"
|
||||
WEB_DIR="${REPO_ROOT}/dist/web"
|
||||
if [[ -f "${REPO_ROOT}/dist/jnpf-7.0-assets/manifest.json" && -f "${ASSETS_WEB}/index.html" ]]; then
|
||||
WEB_DIR="${ASSETS_WEB}"
|
||||
WEB_SRC="JNPF 通用资产包"
|
||||
else
|
||||
WEB_SRC="dist/web(旧产物,建议先跑 pack-jnpf-assets.sh)"
|
||||
fi
|
||||
if [[ -f "${WEB_DIR}/index.html" ]]; then
|
||||
mkdir -p "${PKG_DIR}/web"
|
||||
rsync -a --exclude '.DS_Store' "${WEB_DIR}/" "${PKG_DIR}/web/"
|
||||
WEB_N="$(find "${PKG_DIR}/web" -type f | wc -l | tr -d ' ')"
|
||||
WEB_SIZE="$(du -sh "${PKG_DIR}/web" | cut -f1)"
|
||||
echo "==> web/(静态通用前端,${WEB_N} 个文件 / ${WEB_SIZE};来源:${WEB_SRC})"
|
||||
else
|
||||
echo "!! 找不到静态前端产物 —— 跳过 web/(不阻塞出包)" >&2
|
||||
echo " 先跑: bash scripts/pack-jnpf-assets.sh (构建并打包 JNPF 通用资产)" >&2
|
||||
fi
|
||||
else
|
||||
echo "==> --no-web:平台包不含静态前端;改用独立资产包 dist/jnpf-7.0-assets.tar.gz"
|
||||
fi
|
||||
|
||||
# 3.2 计算 sspf 的 path 依赖闭包(纯文件系统 BFS,离线安全;不含 sspf-admin 自身源码)
|
||||
# 输出每行:源目录<TAB>包内相对目标
|
||||
CLOSURE="$(python3 - <<'PY'
|
||||
@@ -256,12 +303,32 @@ cat > "${PKG_DIR}/README.md" <<EOF
|
||||
| \`lib/\` | 🔴 预编译产物**完整闭包**:sspf 内部 crate + 全部 16 个 registry 依赖 + 全部传递依赖,逐字节等同于构建产物 \`deps/\`(\`.rlib\` + \`.rmeta\` + proc-macro \`.dylib\` + 原生 \`.a\`)。**已关 lto/embed-bitcode,无 LLVM bitcode,本机任意 ld 可直链**。ABI 锁 rustc $(grep -m1 '^channel' rust-toolchain.toml | sed 's/.*= *"//;s/"//') |
|
||||
| \`crates/*\` | 平台 crate 源码(dev 回退:想改平台时用 path 依赖吃这层,多一次编译) |
|
||||
| \`src/backend/\` | 内核 lib(ssw-platform)—— sspf 的 path 依赖(回退用) |
|
||||
| \`web/\` | **静态通用前端**(JNPF 7.0 官方 web 前端的**已构建产物**,非源码;\`--no-web\` 出包时不带)。消费方**不需要 node/pnpm**:\`SSW_STATIC_DIR=./web\` 起服务即同源。🔴 它**只跟 JNPF 版本有关** ⇒ 更推荐独立资产包 \`dist/jnpf-7.0-assets.tar.gz\`:\`SSW_ASSETS_DIR=./jnpf-7.0-assets\` 连示例数据库一起外置,所有 sspf 版本 / 所有平台复用同一份 |
|
||||
| \`Cargo.toml\` | 🔴 workspace 根(crate 的 \`version.workspace = true\` 靠它解析) |
|
||||
| \`Cargo.lock\` | 🔴 锁定整个闭包,消费方 \`--offline\` 也能编译 |
|
||||
| \`rust-toolchain.toml\` | 🔴 工具链版本(**消费方必须同版本**,否则 rlib ABI 不匹配链接失败) |
|
||||
| \`docs/SSPF-PLATFORM-PACKAGE.md\` | 平台侧需求文档与消费方式说明 |
|
||||
| \`frontend/\` | 平台前端源码(不含 node_modules/dist) |
|
||||
|
||||
### 跑起来(当独立服务用)
|
||||
|
||||
\`\`\`bash
|
||||
# 🔴 **同源模式**:一个进程同时提供「官方 JNPF 7.0 前端」与「ssw-platform 后端」
|
||||
SSW_STATIC_DIR=./web PORT=30010 ./bin/sspf-admin
|
||||
# 打开 http://127.0.0.1:30010/ ⇒ 官方前端 + 后端 API 同源(无跨域、无代理)
|
||||
|
||||
# ✅ 推荐:JNPF 通用资产包(前端 + 示例数据库一起外置,只绑定 JNPF 版本)
|
||||
# tar -xzf jnpf-7.0-assets.tar.gz
|
||||
SSW_ASSETS_DIR=./jnpf-7.0-assets PORT=30010 ./bin/sspf-admin
|
||||
\`\`\`
|
||||
|
||||
- 默认口令 \`admin/123456\`(生产档用 \`SEED_ADMIN_PASSWORD\` 覆盖)
|
||||
- 数据目录 \`PGLITE_DIR\`(缺省 \`<project_dir>/src/backend/data/lite.pg\`)
|
||||
- 🔴 **示例数据默认导入**(对齐官方「用示例数据初始化」)⇒ 空库启动即有官方演示数据;
|
||||
想要纯净库设 \`SSW_DEMO_DATA=false\`
|
||||
- 🔴 **外置优先**:\`SSW_DEMO_SEED_FILE=<sql>\` / \`SSW_ASSETS_DIR=<资产包>\` 可换任意 JNPF
|
||||
版本的示例数据,**不需要重编二进制**;都没配 ⇒ 用编译期内嵌那份
|
||||
|
||||
## 消费方怎么用(方案 C:预编译 rlib,零重编平台)
|
||||
|
||||
> ⚠️ 前提:① 消费方 rustc 版本 == 包内 \`rust-toolchain.toml\` 的版本($(grep -m1 '^channel' rust-toolchain.toml | sed 's/.*= *"//;s/"//')),不符则链接失败;
|
||||
@@ -484,6 +551,8 @@ echo "✅ 出包完成: ${PKG}"
|
||||
echo " 目录: ${PKG_DIR}"
|
||||
echo " 压缩包: ${TAR} (${TAR_SIZE})"
|
||||
echo " 预编译二进制: bin/sspf-admin (${BIN_SIZE})"
|
||||
echo " 静态通用前端: web/ (${WEB_N} 个文件 / ${WEB_SIZE}; ${WEB_SRC}) ← SSW_STATIC_DIR=./web"
|
||||
echo " JNPF 通用资产包: dist/jnpf-7.0-assets.tar.gz(独立分发,只绑定 JNPF 版本;所有平台/版本复用)"
|
||||
echo " 预编译 rlib: lib/ (${LIB_N} 个,完整闭包,ABI 锁 rustc $(grep -m1 '^channel' rust-toolchain.toml | sed 's/.*= *"//;s/"//'))"
|
||||
echo " crate 闭包: ${CRATE_N} 个 + src/backend(源码随包,dev 回退用)"
|
||||
echo "=================================================="
|
||||
|
After Width: | Height: | Size: 1.8 KiB |
|
After Width: | Height: | Size: 5.5 KiB |
|
After Width: | Height: | Size: 2.3 KiB |
|
After Width: | Height: | Size: 1.8 KiB |
|
After Width: | Height: | Size: 2.3 KiB |
|
After Width: | Height: | Size: 714 B |
|
After Width: | Height: | Size: 3.6 KiB |
|
After Width: | Height: | Size: 1018 B |
|
After Width: | Height: | Size: 2.1 KiB |
|
After Width: | Height: | Size: 2.3 KiB |
|
After Width: | Height: | Size: 1.5 KiB |
|
After Width: | Height: | Size: 2.9 KiB |
|
After Width: | Height: | Size: 1.7 KiB |
|
After Width: | Height: | Size: 2.4 KiB |
@@ -26,6 +26,7 @@
|
||||
//! (`packs_gen.rs` / `modules/mod.rs` / `Cargo.toml` / `contract.md`)。
|
||||
//! **本文件一行都不用改** —— 包的清单在 `crate::packs_gen`(生成的)。
|
||||
|
||||
use std::path::Path;
|
||||
use std::sync::OnceLock;
|
||||
|
||||
use axum::Router;
|
||||
@@ -94,8 +95,65 @@ pub async fn ensure_base(db: &Db) -> Result<(), pglite::Error> {
|
||||
///
|
||||
/// 🔴 平台层 [`seed::ensure_base`] 只认「传进来的 `MenuSpec` 列表」,不认业务 ⇒
|
||||
/// 谁给清单谁负责(本仓 = [`ensure_base`];外部业务仓 = 门面注入)。
|
||||
///
|
||||
/// 🔴 **这里无条件并入「官方 JNPF 7.0 菜单清单」**(`sspf_compat_system::menus`):
|
||||
/// 它不是业务菜单,是**官方前端能渲染出页面**所必需的路由表 ——
|
||||
///
|
||||
/// ```text
|
||||
/// 官方前端 generate-routes-backend.ts:
|
||||
/// route.path = '/' + node.urlAddress
|
||||
/// route.component = pageMap[node.pageAddress ?? node.urlAddress]
|
||||
/// └─ pageMap = import.meta.glob('../views/**/*.vue')
|
||||
/// ```
|
||||
///
|
||||
/// ⇒ 少种这一份 ⇒ 前端**一条动态路由都注册不出来** ⇒ 每个页面都显示
|
||||
/// 「哎呀!未找到页面」⇒ **后端端点再全也一个都不会被调用**
|
||||
/// (实测:本仓 65 个菜单全 404,真实后端调用只有 21 个;
|
||||
/// 官方同 65 个菜单 ⇒ 163 个端点)。
|
||||
///
|
||||
/// ⇒ 放在**装配根**(本文件)而不是平台层 ⇒ 平台层(`sspf-core`)不碰
|
||||
/// 官方形状 ⇒ 闸门 CP6(平台层菜单条数由契约推导)不受影响。
|
||||
pub async fn ensure_base_with(db: &Db, menus: &[MenuSpec]) -> Result<(), pglite::Error> {
|
||||
seed::ensure_base(db, menus).await
|
||||
let mut all: Vec<MenuSpec> = menus.to_vec();
|
||||
all.extend_from_slice(sspf_compat_core::menus::official_menus());
|
||||
seed::ensure_base(db, &all).await
|
||||
}
|
||||
|
||||
/// 🔴 **导入官方 JNPF 7.0 示例数据**(幂等,每次启动都跑)。
|
||||
///
|
||||
/// 🔴 **为什么不在 [`ensure_base_with`] 里**:
|
||||
/// - `ensure_base_with` 被 **40+ 个集成测试**调用 ⇒ 把示例数据塞进去
|
||||
/// ⇒ 测试里的**行数断言全崩**(`base_dictionary_data` 期望 13 行、
|
||||
/// `base_business_category` 期望 38 行 …)。
|
||||
/// - ⇒ 示例数据是**「启动时灌」**,不是**「种子结构」** ⇒ 独立入口。
|
||||
///
|
||||
/// 🔴 **为什么放在装配根**(本文件)而不是平台层:
|
||||
/// 示例数据是**官方形状的知识**(官方有哪些表 / 哪些列 / 哪些行)
|
||||
/// ⇒ 平台层不许认识它(红线 12 / 闸门 CP1)⇒ 实现放在**契约面**
|
||||
/// (`sspf_compat_core::demo_data`),本文件只做**接线**。
|
||||
///
|
||||
/// - `db`:库句柄。
|
||||
/// - `seed_file`:**外置**示例数据 SQL(`SSW_ASSETS_DIR` / `SSW_DEMO_SEED_FILE` 推导)。
|
||||
/// `None` ⇒ 用二进制编译期内嵌的那份。
|
||||
///
|
||||
/// 🔴 **为什么要外置**:示例数据只跟 **JNPF 版本**有关,跟 sspf 版本 / 平台 / 环境无关
|
||||
/// ⇒ 单独打「JNPF 通用资产包」,换演示数据不需要重编二进制。
|
||||
/// 读不到文件(路径错 / 权限)时**告警后回退内嵌**,绝不让服务起不来。
|
||||
pub async fn ensure_demo_data(db: &Db, seed_file: Option<&Path>) -> Result<(), pglite::Error> {
|
||||
if let Some(p) = seed_file {
|
||||
match std::fs::read_to_string(p) {
|
||||
Ok(sql) => {
|
||||
eprintln!("[demo-data] 使用外置 JNPF 资产包示例数据: {}", p.display());
|
||||
return sspf_compat_core::demo_data::ensure_demo_data_sql(db, &sql).await;
|
||||
}
|
||||
Err(e) => eprintln!(
|
||||
"[demo-data] 外置示例数据读取失败({}: {}),回退编译期内嵌",
|
||||
p.display(),
|
||||
e
|
||||
),
|
||||
}
|
||||
}
|
||||
sspf_compat_core::demo_data::ensure_demo_data(db).await
|
||||
}
|
||||
|
||||
/// 🔴 **装载全部业务包** —— 委托给**生成**的包清单 [`crate::packs_gen`]。
|
||||
|
||||
@@ -2643,8 +2643,9 @@ pub fn build_app(state: AppState) -> axum::Router {
|
||||
///
|
||||
/// 🔴 **`extras.static_dir` 只影响平台默认 fallback**:
|
||||
/// - `None` ⇒ 未命中就是信封 404(与历史行为**逐字一致**);
|
||||
/// - `Some(dir)` ⇒ `/api/**` 仍是信封 404;其它未命中路径先找静态文件,
|
||||
/// 找不到再回退 `index.html`(前端 history 路由的深链);
|
||||
/// - `Some(dir)` ⇒ `/api/**` 仍是信封 404(**唯一例外**:`/api/file/Image/**`
|
||||
/// 命中资产包里的同名图片文件时返文件,官方图标资源走的就是这个路径);
|
||||
/// 其它未命中路径先找静态文件,找不到再回退 `index.html`(前端 history 路由的深链);
|
||||
/// - `extras.fallback` 给了值 ⇒ 用 `fallback_service`,**忽略** `static_dir`。
|
||||
pub fn build_app_with(state: AppState, mut extras: Extras) -> axum::Router {
|
||||
// 🔴 第二阶段的三个注入点先 take 出来;剩下的 Extras 整体交给 build_router_with。
|
||||
@@ -2687,6 +2688,24 @@ pub fn build_app_with(state: AppState, mut extras: Extras) -> axum::Router {
|
||||
async fn fallback_response(static_dir: Option<PathBuf>, req: Request) -> Response {
|
||||
if let Some(dir) = static_dir {
|
||||
let path = req.uri().path();
|
||||
// 🔴 **官方文件资源例外**:JNPF 前端把数据库类型图标 / AI 模型图标放在
|
||||
// `/api/file/Image/**`,这些是**文件**,不是接口。官方后端用 302 重定向到
|
||||
// 文件服务;同源静态托管没有文件服务 ⇒ 之前全返信封 404(图标不显示,
|
||||
// 控制台 9 条 404)。JNPF 资产包把这些图片放在
|
||||
// `<static_dir>/api/file/Image/...` ⇒ 命中就返文件;**未命中仍走信封 404**
|
||||
// ⇒ `/api/**` 的 404 契约不变,只是多了这一个精确白名单。
|
||||
if path.starts_with("/api/file/Image/")
|
||||
&& matches!(*req.method(), Method::GET | Method::HEAD)
|
||||
{
|
||||
if let Some(decoded) = percent_decode_path(path) {
|
||||
if let Some(mut resp) = serve_from(&dir, &decoded).await {
|
||||
if req.method() == Method::HEAD {
|
||||
*resp.body_mut() = Body::empty();
|
||||
}
|
||||
return resp;
|
||||
}
|
||||
}
|
||||
}
|
||||
// 🔴 `/api/**` **永远**走信封 404 —— 静态托管不许吞掉接口的 404 契约。
|
||||
if !path.starts_with("/api/") && path != "/api" {
|
||||
if matches!(*req.method(), Method::GET | Method::HEAD) {
|
||||
@@ -2730,6 +2749,34 @@ async fn serve_file(path: &Path) -> Option<Response> {
|
||||
Some(resp)
|
||||
}
|
||||
|
||||
/// 百分号解码 URL 路径(**仅**给 `/api/file/Image/**` 的中文文件名用)。
|
||||
///
|
||||
/// 🔴 安全:解码结果里出现 `/` / `\` / NUL 一律拒绝 ⇒ `%2F` 之类不能凭空造出
|
||||
/// 路径分隔符;解码完还会再走一遍 [`safe_rel_path`] 的 `..` / 穿越检查。
|
||||
fn percent_decode_path(p: &str) -> Option<String> {
|
||||
let b = p.as_bytes();
|
||||
let mut out = Vec::with_capacity(b.len());
|
||||
let mut i = 0usize;
|
||||
while i < b.len() {
|
||||
if b[i] == b'%' {
|
||||
if i + 2 >= b.len() {
|
||||
return None;
|
||||
}
|
||||
let hex = std::str::from_utf8(&b[i + 1..i + 3]).ok()?;
|
||||
let v = u8::from_str_radix(hex, 16).ok()?;
|
||||
if v == b'/' || v == b'\\' || v == 0 {
|
||||
return None;
|
||||
}
|
||||
out.push(v);
|
||||
i += 3;
|
||||
} else {
|
||||
out.push(b[i]);
|
||||
i += 1;
|
||||
}
|
||||
}
|
||||
String::from_utf8(out).ok()
|
||||
}
|
||||
|
||||
/// URL 路径 ⇒ 相对路径。**拒绝** `..` / 反斜杠 / NUL(目录穿越)。
|
||||
fn safe_rel_path(url_path: &str) -> Option<PathBuf> {
|
||||
let mut out = PathBuf::new();
|
||||
@@ -2932,6 +2979,26 @@ mod tests {
|
||||
use sspf_core::session::{SessionStore, TicketStore};
|
||||
use crate::test_support;
|
||||
|
||||
/// `/api/file/Image/**` 的中文文件名要百分号解码;`%2F` 不许造出路径分隔符。
|
||||
#[test]
|
||||
fn percent_decode_path_handles_chinese_and_blocks_traversal() {
|
||||
assert_eq!(
|
||||
percent_decode_path(
|
||||
"/api/file/Image/databaseicon/%E8%87%AA%E5%AE%9A%E4%B9%89%E6%95%B0%E6%8D%AE%E5%BA%93.png"
|
||||
),
|
||||
Some("/api/file/Image/databaseicon/自定义数据库.png".to_string())
|
||||
);
|
||||
assert_eq!(
|
||||
percent_decode_path("/api/file/Image/AiFile/a.png"),
|
||||
Some("/api/file/Image/AiFile/a.png".to_string())
|
||||
);
|
||||
// 解码后含 `/` ⇒ 拒绝(目录穿越);非法 hex ⇒ 拒绝。
|
||||
assert_eq!(percent_decode_path("/api/file/Image/a%2Fb.png"), None);
|
||||
assert_eq!(percent_decode_path("/api/file/Image/a%5Cb.png"), None);
|
||||
assert_eq!(percent_decode_path("/api/file/Image/a%ZZ.png"), None);
|
||||
assert_eq!(percent_decode_path("/api/file/Image/a%"), None);
|
||||
}
|
||||
|
||||
/// 全进程共享的临时库(pglite 进程级全局单例 ⇒ 只能开一次,所有单测共用)。
|
||||
async fn db() -> &'static Db {
|
||||
test_support::shared_db().await
|
||||
|
||||