- 新增 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,运行时业务数据页差异源于参考库额外演示数据。
366 lines
17 KiB
Bash
Executable File
366 lines
17 KiB
Bash
Executable File
#!/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 "=================================================="
|