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>
This commit is contained in:
2026-06-11 18:19:01 +08:00
parent b9ad18f147
commit d137577759
7 changed files with 580 additions and 6 deletions

View File

@@ -0,0 +1,132 @@
# 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` 追加章节。