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,运行时业务数据页差异源于参考库额外演示数据。
This commit is contained in:
1 parent
8af5b901b5
commit
d8a9d16d2c
37 files changed
+79350
-36
No files matched your search
+70
-1
@@ -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 "=================================================="
|
||||
Reference in new issue
Block a user