Files
ssw-mvp/docs/db

数据库结构导出

存放 SSW 三子系统(SSWFLOW / TDS / TDC)的数据库结构备份,以及 JNPF 平台库 j7 中 "按应用配置"导出的部分。

目录布局

docs/db/
└── 0809/                                # 2026-08-09 快照(按需增量)
    ├── summary.json                     # 总览
    ├── j7/                            # JNPF 平台库(仅 SSW 应用相关)
    │   ├── schema.sql                   # 123 张 base_* 表结构
    │   ├── overview.json                # 表清单 + 列 + 注释
    │   └── data/                        # 仅 SSW 应用配置数据
    │       ├── base_system.sql          # 3 条(sswflow/tds/tdc)
    │       ├── base_module.sql          # 131 条菜单
    │       ├── base_visual_dev.sql      # 11 条功能设计
    │       ├── base_visual_release.sql  # 11 条历史版本
    │       └── ...                      # 11 张 0 行表占位(base_module_button 等)
    ├── sswflow/                         # SSW 隐私计算业务库
    │   ├── schema.sql                   # 13 张表
    │   └── overview.json
    ├── tdc/                             # TDC 数据接入连接器业务库
    │   ├── schema.sql                   # 24 张表(33 张其中 9 张已迁出)
    │   └── overview.json
    └── tds/                             # TDS 可信数据空间业务库
        ├── schema.sql                   # 34 张表(44 张其中 10 张已迁出)
        └── overview.json

设计原则

应用库(sswflow / tdc / tds)= 只导出结构

三个业务库都是 SSW 自己管理的表(命名 ssw_* / tds_* / tdc_* / 公共表名)。 代码仓库只关心 schema 是否最新 + 是否与 V*.sql 迁移脚本一致, 业务数据(合约、订单、样本、审计等)不应该被打包进 git:

  • schema.sql = CREATE TABLE + 索引 + 注释
  • overview.json = 列清单 + 行数(当前快照的运行时行数,方便核对)
  • 不导出 data/(0809 时已删除)

JNPF 平台库 j7 = 按应用配置导出

JNPF 是开源低代码平台,主库 j7 共 123 张 base_* 表(组织/权限/账号/AI/AI Agent/ 门户/打印/流程模板/功能设计/...),绝大部分数据与 SSW 应用无关(如 base_user / base_role / base_organize 是平台自带的 demo 数据)。

绝对不能全量备份(会包含:

  • JNPF 自带的 5 个示例应用(系统平台/流程中心/协同办公/业务示例/开发示例)
  • AI 模型、第三方账号、消息中心等模板数据
  • 平台内置账号 admin 等敏感凭据(即使已 hash)

JNPF 平台提供官方"应用导入导出"功能(后端 SystemController#exportFile, VO 类 jnpf.base.model.export.SystemExportVo),导出 JSON 中包含:

SystemExportVo {
    SystemEntity        systemEntity;        // → base_system
    List<VisualExportVo> visualList;          // → base_visual_dev
    List<PortalExportDataVo> portalList;      // → base_portal
    List<Object>        reportList;           // → flowable.xtable
    List<Object>        oldReportList;        // → flowable.xtable_old
    List<PrintExportVo>  printList;           // → base_print_template + base_print_version
    VisualScreenExportVo visualScreen;        // → base_visual_screen
    List<TemplateExportVo> templateList;      // → flowable.template
}

每个 export 子对象内部还会带相关子表(如 visual_dev 内部有 base_module_button / base_module_column / base_module_form / base_module_data / base_module_authorize / base_module_scheme / base_module_link 通过 f_module_id 关联)。

本仓库按相同语义,把过滤条件设为 SSW 三个应用 systemId:

应用 systemId
SSWFlow 853028206192623813
可信数据空间 TDS 855102009768939909
数据接入连接器 TDC 855102050973782405

具体导出(j7/data/ 下 15 个文件):

表 过滤条件 说明
base_system f_id IN (...) 应用主表
base_module f_system_id IN (...) 131 个 SSW 菜单
base_module_data f_system_id IN (...) 0 行
base_module_button/column/form/authorize/scheme/link f_module_id IN (SELECT ... base_module WHERE f_system_id IN (...)) 0 行
base_visual_dev f_system_id IN (...) 11 条功能设计
base_visual_release f_system_id IN (...) 11 条历史版本
base_visual_alias f_visual_id IN (SELECT ... base_visual_dev WHERE f_system_id IN (...)) 0 行
base_portal / base_print_template / base_print_version 同上 0 行

注:JNPF 平台表大多是 (f_id, f_tenant_id) 复合主键,所有 SSW 应用属于默认租户 0。

导出工具

scripts/export_ss_db.py(应用库结构导出)

应用库结构导出脚本(之前版本,导出 schema + data)。 0809 之后只跑 schema-only 模式(不导出 data/)。

scripts/export_j7_platform.py(j7 平台库按应用导出)

新加脚本,专为 j7 设计:

# 默认导出到 docs/db/<YYYY-MM-DD>/j7/
python3 scripts/export_j7_platform.py

可调参数(脚本顶部):

  • DB_CONFIG —— 目标 Postgres 连接(默认 127.0.0.1:15432/dacli/j7)
  • SSW_SYSTEM_IDS —— 三个应用的 systemId
  • APP_TABLES_BY_SYSTEM_ID —— 按 systemId 直接过滤的表
  • APP_TABLES_BY_MODULE_ID —— 通过 base_module 关联的子表

重建顺序

如果某天 j7 库被重建,恢复顺序:

  1. 重建 j7 库(CREATE DATABASE j7)
  2. 应用 docs/db/0809/j7/schema.sql —— 还原 123 张表结构
  3. 应用 docs/db/0809/j7/data/base_system.sql —— 创建 3 个 SSW 应用记录
  4. 应用 docs/db/0809/j7/data/base_module.sql —— 还原 131 个菜单
  5. 应用 docs/db/0809/j7/data/base_visual_dev.sql —— 还原 11 个功能设计
  6. 应用 docs/db/0809/j7/data/base_visual_release.sql —— 还原 11 个历史版本
  7. 重新创建 sswflow / tds / tdc 库并应用各自的 schema.sql + 业务迁移 SQL
  8. 启动 ssw-admin,运行 boot/db/ 下的 V*__*.sql 迁移脚本