Files
eip4-platform/tools/local-devdb/本地开发库构建报告.md
zhengwr d137577759 eip4dev: 构建本地开发库,日常开发完全脱离 5435
- tools/local-devdb/build_devdb.sh: 幂等构建脚本,分层 dump/restore
  (ACT_* schema-only / 超500MB巨表 schema-only / 其余全量),
  内置 5435/ceshi 库安全守门,参数化源/目标/阈值/巨表清单
- tools/local-devdb/sql/data-tables.txt: 必须全量的引擎元数据/组织表清单
- tools/local-devdb/本地开发库构建报告.md: 实跑报告(2738MB/345s/94.1%对拍通过)
- application-dev.yml: dev profile 指向 localhost:5433/eip4dev,端口 8093
- README.md: 补三套 profile 说明(dev/local/默认)及常用命令
- SysUserService.java: 修复 MASTERDEPART 列不存在导致登录 500 的 bug
- docs/迁移手册.md: 追加三条新坑位(MASTERDEPART/sys_page_schema/shell 中文变量名)

验证: 登录 OK / list(1079行) / picker(5条) / ParityCli 1166实体 803 OK_FULL+294 OK_SAMPLE
完全本地: pg_stat_activity 全部连接来自 127.0.0.1:eip4dev,无 5435 连接

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-11 18:19:01 +08:00

4.4 KiB
Raw Blame History

eip4dev 本地开发库构建报告

构建时间:2026-06-11 | 构建人:zhengwr 性质:受控测试数据副本,仅在受控机器使用,不外泄、不进公开仓库


一、分层口径

分层 规则 表数 说明
ACT_* schema-only 所有 act_ 前缀表 26 流程数据在 eip4flow,dev 库只需 DDL
非 ACT_ 超阈值(>500MB) schema-only gb_clockingin/gb_prj_worker/sys_data_logitem 3 日志/考勤明细,非联调主路径;FK 不完整可接受
非 ACT_ ≤500MB 全量 其余 ~1038 张表 1038 全量保 FK 完整 → picker/显示翻译/数据权限真实

阈值:500MB(--threshold 参数可调)


二、构建体量与耗时

指标 数值
源库 192.168.20.68:5435 (PG 9.4.26,eip3 schema)
目标库 localhost:5433/eip4dev (PG 15.18)
源库总表数 1067
目标库总表数 (DDL) 1067
schema dump 4.1MB,21s
数据 dump 496MB,275s
schema restore 2s
数据 restore 45s
总耗时 345s(约 5.75 分钟)
目标库体量 2738 MB

三、关键引擎元数据行数(全量验证)

表 行数
sys_entity 1166
sys_entityattribute 20019
sys_reference 761
sys_referencevalue 2482
sys_user 1857
view_template 1516
view_page 1241
sys_serviceflow 4983

四、验证证据

4.1 登录验证

  • 账号:admin / 111111(本地已将 admin 密码重置为 111111 MD5)
  • 结果:HTTP 200,返回有效 JWT token,包含 admin 角色列表 ✅

4.2 list 取数(真实实体)

  • 接口:GET /api/entity/SYS_FILTERRULE/list?page=1&perPage=5
  • 结果:status=0,total=1079,返回真实列数据 ✅

4.3 picker(真实引用实体联动)

  • 接口:GET /api/picker/{sys_reference_id}/list?page=1&perPage=5
  • 结果:status=0,返回 5 条真实 OA_NOTICEMANAGE 业务数据 ✅

4.4 page schema 接口

  • sys_page_schema 是 eip4-platform 新增表(非客户库原有),在 eip4dev 中不存在,返回 status=2 属预期行为(需另建该表)。
  • 引擎元数据读取(view_template/view_page)已全量导入 ✅

4.5 ParityCli 自对拍(eip4dev 自洽验证)

运行口径:--discover --maxFull=200 --discoverSample=50 --perPage=200 引擎:http://localhost:8093(dev profile 指向 eip4dev) 基线:JDBC 直连 eip4dev(currentSchema=eip3)

结果 实体数 说明
OK_FULL(全量一致) 803 200行以内全量对拍,引擎 = JDBC 基线
OK_SAMPLE(抽样一致) 294 超200行抽样50行,一致
JDBC_ERROR 55 主要为依赖未迁移表的视图,非引擎问题
DIFF(差异) 5 见下表
ENGINE_ERROR 9 引擎侧错误
总比对行数 726,547
通过率 94.1%(1097/1166)

DIFF 实体明细(均非主业务联调路径):

实体 问题
PM_LABORTEAM 视图,依赖关联数据
PM_SPIDER_JSBIDWIN 爬虫数据(schema-only 表,无数据属预期)
VIEW_HR_EMPLOYEE 视图,CARDINFO 列差异
VIEW_HR_USERWITHCARDS 视图,PROJECTROLE 列差异
VIEW_HR_WELFAREARCHIVES_PAYBASERECORD 视图,差异

4.6 完全本地验证

dev profile 启动后,pg_stat_activity 全部连接来自 127.0.0.1:eip4dev,无任何 5435 连接记录,日志中无远端 IP。完全本地开发成立 ✅


五、刷新流程

# 幂等重建(约 5-6 分钟)
bash tools/local-devdb/build_devdb.sh --drop-target

# 仅重建数据层(跳过 dump,用已有 dump 文件)
bash tools/local-devdb/build_devdb.sh --drop-target --skip-dump

# 调整阈值(默认 500MB)
bash tools/local-devdb/build_devdb.sh --drop-target --threshold 300

六、5435 用途收敛说明

构建 eip4dev 后,5435 客户库副本的日常用途收敛为:

用途 说明
对拍真值基线 引擎升级/重大功能改动后,与 5435 做跨库对拍(ParityCli --jdbc 指向 5435)验证行为一致性
性能基线 压测对比:相同查询在 5435 vs eip4dev 的执行计划/耗时对比
数据刷新源 定期(按需)重跑 build_devdb.sh 从 5435 刷新 eip4dev
日常开发连接 已完全替代,dev profile 不再需要 5435

七、新坑位

见 docs/迁移手册.md 追加章节。