# 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。**完全本地开发成立** ✅ --- ## 五、刷新流程 ```bash # 幂等重建(约 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` 追加章节。