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

133 lines
4.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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` 追加章节。