Files
ssw-platform/scripts/pack-jnpf-assets.sh
T
admin d8a9d16d2c 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,运行时业务数据页差异源于参考库额外演示数据。
2026-11-06 15:50:15 +08:00

366 lines
17 KiB
Bash
Executable File
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/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 "=================================================="