Files
eip4-platform/docs/P1/F2-15对象补建报告.md
zhengwr 4519f6a0e5 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>
2026-06-12 05:42:58 +08:00

162 lines
5.9 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.
# 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) |