- 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>
4.4 KiB
4.4 KiB
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 追加章节。