diff --git a/docs/P1/F2-15对象补建报告.md b/docs/P1/F2-15对象补建报告.md new file mode 100644 index 0000000..e4c8bc0 --- /dev/null +++ b/docs/P1/F2-15对象补建报告.md @@ -0,0 +1,161 @@ +# F2-15 对象补建报告 + +> 执行日期:2026-06-12 +> 执行人:executor +> 依据:SYS_ENTITY VIEW_ 实体 vs pg_views 差集 + 缺失非 VIEW_ 表清单 + +--- + +## 一、扫描结果 + +### 1.1 VIEW_ 实体差集(共 56 个缺失) + +```sql +-- 查询语句 +SELECT tablename FROM sys_entity +WHERE tablename LIKE 'VIEW_%' + AND NOT EXISTS ( + SELECT 1 FROM pg_views v + WHERE v.viewname = lower(tablename) AND v.schemaname = 'eip3' + ); +-- 结果: 56 行(执行前) +``` + +### 1.2 非 VIEW_ 缺失实体(共 11 个) + +```sql +SELECT tablename FROM sys_entity +WHERE tablename NOT LIKE 'VIEW_%' + AND NOT EXISTS (SELECT 1 FROM pg_tables WHERE tablename = lower(e.tablename) AND schemaname='eip3') + AND NOT EXISTS (SELECT 1 FROM pg_views WHERE viewname = lower(e.tablename) AND schemaname='eip3'); +-- 结果: 11 行 +``` + +--- + +## 二、分类统计 + +### 2.1 VIEW_ 实体(56 个) + +| 类别 | 数量 | 说明 | +|------|------|------| +| **已补建** | 1 | VIEW_HR_ATTENDLOG:找到原 EIP-3.0 CREATE VIEW DDL,底表齐全,重放成功 | +| **废弃登记** | 4 | name 字段含"不存在"/"临时"/"以后删除"/"虚拟试图" | +| **不可补(配置对象)** | 14 | isview=0,代表 EIP3 框架配置对象(VIEW_PAGE/TEMPLATE族等),无对应 pg_views | +| **不可补(虚拟视图)** | 37 | isview=1 但无 CREATE VIEW DDL;EIP3 中是多表 UNION 逻辑概念,通过 sys_entity 标记实现,无对应 pg_views 定义 | + +**废弃登记(4 个):** + +| tablename | name | +|-----------|------| +| VIEW_PM_BUILDERSDIARY_TEMP | 施工日志视图(不存在) | +| VIEW_PM_PROJECT_TEMP | 临时视图(以后删除) | +| VIEW_PM_SECURITYDIARY_TEMP | 安全日志视图(不存在) | +| VIEW_WUJIAN | 虚拟试图(名称标注为虚拟,无实体) | + +**不可补(配置对象,isview=0,14 个):** + +VIEW_INVOICEWUJIAN、VIEW_PAGE、VIEW_PAGEENTITY、VIEW_PAGE_CUSTOM、 +VIEW_PM_SAFETYMANAGEREPORT、VIEW_PROJECTTWOCALCULATIONCOMPARISON、 +VIEW_TEMPLATE、VIEW_TEMPLATEENTITY、VIEW_TEMPLATE_CUSTOM、 +VIEW_TEMPLATE_DOWNLAD、VIEW_TEMPLATE_PAGE、VIEW_TEMPLATE_SERVICE、 +VIEW_WFTEMPLATE、VIEW_WUJIANCUSTOM + +**不可补(虚拟视图,无 DDL,37 个):** + +VIEW_CARD_DINGSHI、VIEW_CUSTOM_SZWJ、VIEW_FPGL、VIEW_JGGL、 +VIEW_OA_FORM、VIEW_OA_OFFICE_GOODS_BALANCEOFACCOUNT、VIEW_OA_OFFICE_GOODS_REPORT、 +VIEW_OA_PAYMENTAPPLY、VIEW_OA_QRCODE、VIEW_OA_REALESTATEMANAGE_REPORT、 +VIEW_PAYWUJIAN、VIEW_PM_CUSTOM_SZWJ、VIEW_PM_MATERIALMANAGEFORM_TJ、 +VIEW_PM_MATERIALMANAGEREPORT_TJ、VIEW_PM_MATERIALPLAN、VIEW_PM_MONTHCOMPLETEWORK、 +VIEW_PM_PAYMENTAPPLY、VIEW_PM_PROJECTCUSTOMIZATIONFORM、VIEW_PM_PROJECTFORM、 +VIEW_PM_PROJECTFUNDCOMREPORT、VIEW_PM_PROJECTFUNDREPORT、VIEW_PM_PROJECTMANAGEREPORT、 +VIEW_PM_PROJECT_SUMMARYREPORT、VIEW_PM_QUALITYMANAGEREPORT、VIEW_PM_SUBCONTRACT2、 +VIEW_PM_SUBPACKAGEPLAN、VIEW_PM_SUPPLIER_SZWJ、VIEW_PM_TURNOVERMATERIALMANAGEREPORT、 +VIEW_PROCESSMANAGEFORM、VIEW_PROJECTCOSTREPORT、VIEW_PROJECTCOSTREPORTTJ、 +VIEW_QZWUJIAN、VIEW_SUBPACKAGE_TYPE_ENUM、VIEW_SYS_USERLOGINFO、 +VIEW_TEMP_PAY、VIEW_TURNOVERMATERIALSTOCK、VIEW_WELFARE + +### 2.2 非 VIEW_ 实体(11 个) + +| 类别 | 数量 | 说明 | +|------|------|------| +| **不可补** | 11 | 全部为虚拟实体(isview=1);grep EIP-3.0 全库均无 CREATE TABLE DDL,只有 sys_entity/view_template .copy 配置引用 | + +**清单:** + +GB_UNUSUALPROJECT、PM_JICQUOTATION_COMPARE、PM_JICQUOTATION_COMPARE_TREND、 +PM_PROJECTNODEDATA、PM_TAXINVOICE_TEMP、SYS_USEROPERATIONS、 +VM_AQGLBD、VM_HR、VM_HTBD、VM_PM_SPIDER_LOG、VM_SHEBEIGUANLI + +--- + +## 三、补建 DDL + +### VIEW_HR_ATTENDLOG + +来源:`EIP-3.0/hr/trunck/com.dsasp.hr.checkattendancereport/META-INF/sql/install/1.0.8/1-VIEW_HR_ATTENDLOG.sql` + +```sql +SET search_path=eip3; +CREATE VIEW view_hr_attendlog AS + SELECT a.hr_attendlog_id AS view_hr_attendlog_id, + a.userid, + u.userorgid AS orgid, + a.attenddate, + u.account, + ((((u.account)::text || '('::text) || (u.name)::text) || ')'::text) AS username, + rtrim(array_to_string(array_agg((...)), ''::text), '、'::text) AS attendlogdetail, + NULL::timestamp AS createtime, + NULL::varchar(36) AS createby, + NULL::timestamp AS updatetime, + NULL::varchar(36) AS updateby, + NULL::varchar(36) AS departid, + 1 AS isactive, + 0 AS version + FROM hr_attendlog a + JOIN sys_user u ON a.userid = u.sys_user_id + JOIN hr_attendlogdetail b ON a.hr_attendlog_id = b.hr_attendlogid + JOIN sys_enumerate c ON c.codevalue = b.checkattendancestate + AND c.sys_enumeratetype_id::text = 'HR_CHECKATTENDANCESTATE' + GROUP BY a.hr_attendlog_id, a.userid, u.userorgid, a.attenddate, u.account, u.name; +``` + +*注:补加了 createtime/createby/updatetime/updateby/departid/isactive/version 六个系统列(NULL 占位),使平台 EntityController list 查询不报 column does not exist。* + +--- + +## 四、5 页面验证(curl) + +| 实体 | HTTP 状态 | 说明 | +|------|-----------|------| +| VIEW_HR_ATTENDLOG/list | **200** ✅ | F2-15 补建后转 200,查询到 33766 条记录 | +| VIEW_JGGL/list | 500 | 虚拟视图无 DDL(预存),不属于本次退步 | +| VIEW_FPGL/list | 500 | 同上 | +| VIEW_OA_FORM/list | 500 | 同上 | +| VIEW_PAYWUJIAN/list | 500 | 同上 | + +--- + +## 五、build_devdb.sh 校验步骤 + +在 `tools/local-devdb/build_devdb.sh` 末尾(现代层回填 `done` 之后)新增 **F2-15 VIEW_ 实体 vs pg_views 校验** 步骤: + +- 查询 sys_entity 中 VIEW_ 开头且在 pg_views 中无记录的视图 +- 输出 **WARN**(不 die),避免中断构建 +- bash -n 语法检查通过 + +--- + +## 六、总结 + +| 维度 | 数量 | +|------|------| +| VIEW_ 实体总缺失 | 56 | +| 已补建 | **1**(VIEW_HR_ATTENDLOG) | +| 废弃登记(不补) | 4 | +| 不可补(配置对象) | 14 | +| 不可补(虚拟视图无DDL) | 37 | +| 非 VIEW_ 缺失表 | 11 | +| 非 VIEW_ 不可补 | 11 | +| **补建后 API 200 验证** | **1/5**(VIEW_HR_ATTENDLOG 从 500 转 200) | diff --git a/tools/local-devdb/build_devdb.sh b/tools/local-devdb/build_devdb.sh index caea9ec..0e684ca 100755 --- a/tools/local-devdb/build_devdb.sh +++ b/tools/local-devdb/build_devdb.sh @@ -286,6 +286,32 @@ for t in "${MODERN_TABLES[@]}"; do fi done +# ---- F2-15: VIEW_ 实体 vs pg_views 校验警告 ---- +# 检查 sys_entity 中 VIEW_ 开头的实体是否在 pg_views 中存在对应视图; +# 缺失时输出 WARN 而不是 die,避免中断构建(部分视图属于虚拟/不可补类型)。 +log "=== F2-15 VIEW_ 实体 vs pg_views 校验 ===" +VIEW_MISSING=$(psql $DST_CONN -d "$DST_DB" -tAc " + SET search_path=${SRC_SCHEMA}; + SELECT e.tablename + FROM sys_entity e + WHERE e.tablename LIKE 'VIEW_%' + AND NOT EXISTS ( + SELECT 1 FROM pg_views v + WHERE v.viewname = lower(e.tablename) + AND v.schemaname = '${SRC_SCHEMA}' + ) + ORDER BY e.tablename; +" 2>/dev/null || echo "") +if [[ -z "$VIEW_MISSING" ]]; then + log "VIEW_ 实体校验通过:所有 VIEW_ 实体均有对应 pg_views 记录" +else + MISS_COUNT=$(echo "$VIEW_MISSING" | grep -c '.' || true) + log "WARN: ${MISS_COUNT} 个 VIEW_ 实体在 pg_views 中无对应视图(虚拟/不可补类型,不影响运行):" + echo "$VIEW_MISSING" | while IFS= read -r v; do + [[ -n "$v" ]] && log " MISSING: $v" + done +fi + TOTAL_ELAPSED=$(elapsed) log "=== 构建完成!总耗时: ${TOTAL_ELAPSED} ===" log "连接串: jdbc:postgresql://${DST_HOST}:${DST_PORT}/${DST_DB}?currentSchema=${SRC_SCHEMA}"