F2-15: VIEW_HR_ATTENDLOG 补建 + build_devdb 校验步骤 + 补建报告

VIEW_HR_ATTENDLOG:
- 从 EIP-3.0 提取原始 CREATE VIEW DDL(1-VIEW_HR_ATTENDLOG.sql)
- 补加 createtime/createby/updatetime/updateby/departid/isactive/version
  六个 NULL 占位列,使平台 EntityController list 查询不报
  "column does not exist"(已验证: /api/entity/VIEW_HR_ATTENDLOG/list → 200)

build_devdb.sh:
- 末尾新增 F2-15 VIEW_ 实体 vs pg_views 校验警告步骤
- 缺失时输出 WARN 不 die,bash -n 语法检查通过

docs/P1/F2-15对象补建报告.md:
- 56 个 VIEW_ 缺失:补建 1 / 废弃 4 / 不可补 51
- 11 个非 VIEW_ 缺失表:全部不可补(无 CREATE TABLE DDL)
- 5 页面验证:VIEW_HR_ATTENDLOG 200 ✅,其余 4 个为预存虚拟视图 500

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-06-12 05:42:58 +08:00
parent f620fb23f6
commit 4519f6a0e5
2 changed files with 187 additions and 0 deletions

View File

@@ -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) |

View File

@@ -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}"