> ⚠️ **已归档(2026-06-17)**:本文是 2026-06-13 快照,早于「engineclass delta」重定性与 06-14~17 全部工作,**不再是权威状态视图**。当前状态以 `docs/README.md` 为准。 # EIP4 架构与缺口现状(2026-06-13) > 本文档是对 EIP4 当前**技术状态**的权威快照,基于对当前代码 HEAD 的实测核对(非台账转述)。 > ⚠️ 取代 `docs/未完成工作清单.md` 作为技术状态视图——那份是 2026-06-12 修复**之前**的快照,其"列表不过滤/按钮死桩/弹窗嵌整页"等项**均已修复**(详见 §4)。 > 商务/人工依赖见 §8;架构总纲仍以 `eip4-platform/docs/架构设计.md` 为准。 > > 对齐 HEAD:eip4-platform `f4b6e37`(2026-06-13 夜写路径主线后) / eip4-web `693a857`。 > **【2026-06-13 夜·写路径主线进展(本文档增量,§7 路线对应推进)】** > 经 5-agent 对代码核验 workflow 拍板后,落地写路径全部前置 + 平台前置,**6+1 原子提交**(eip4-platform main): > - **A0** `06dd127` UiTypeMapper 补 PasswordField→input-password / SingleFileUploadField→input-file / DateField→input-date(default 三控件)。 > - **A1** `b28bff2` EditGrid/FormEditGrid 子表列递归 mapField→quickEdit(子表内 Select/Combo/Number/Date 不再退化文本)。 > - **A2** `3735a9b` convertForm 解析 `` 多 ``→amis tabs(72 页多页签原塌平;正则提 `
` 归位;width/colspan 像素版面后置)。 > - **A3** `9ee3ef2` **遗留②编辑表单迁移**:view_page(1241)→sys_page_schema(dispatcher 加 `case "page"`/key=raw view_page_id PK 冲突实测 0/resolveEditFormTemplateId 命中返 pageId)。全量重转上线(2757 产物,view_page 1241 入库 1238 为 form),运行时实证 `/api/page/schema/{view_page_id}` 返真实表单——**「查看」点亮**。 > - **B1** `72e4c6d` **遗留① JUEL**:platform-app 接 jakarta.el JSR-223 "juel" 引擎(惰性注册接缝,零改保真层 com.dsasp.*,不引 activiti)。 > - **B2** `c721bde` JUEL 跨流回归:153 真实 conditionExpression × 9 场景=1377 次新旧引擎差分,**完全等价 1376/真实偏移 0/良性差异 1**(null-base 方法调用)。 > - **C1** `f4b6e37` 补读 requirederror→validationErrors.required / minlength→minLength。 > - **运行时激活**:8093 重启为含 B1 的新 jar;**添加端到端实证落库**(OA_NOTICEMANAGE_ADD status:0,服务流设拟稿人/部门/时间)。 > - **依赖链现状**:删除✅ / 查看✅ / 添加·修改 表单+引擎+语义+端到端落库 均实证✅(余逐流写 QA)。**§4.2 中 projectRoleType、深链接 两条经代码核验已证伪,见下表更新。** --- ## 一、架构全景:双层制元数据引擎 EIP4 把老系统(EIP3:OSGi/Vaadin7/Activiti5 低代码平台)重构为 **amis + Spring Boot 3 + Flowable**。 **核心决策:"保真层供奉,现代层生长"** —— 1956 行 SQL 引擎**原样回迁不重写**(包名 `com.dsasp.*` 不动)。理由:它的价值就是和老系统逐字节一致,是逐行对拍的基线、业务数据零搬迁的载体、老员工认知的延续。新能力在外面长(`com.eip4.*`)。ArchUnit 固化纪律:`com.eip4.*` 可调 `com.dsasp.*`,反向禁止。 **单客户交付 = 4 进程**:`nginx + eip4-platform.jar + flowable-service.jar + postgres`。不上 Redis/MQ/ES(每多一个中间件 = 每个私有化客户终身多一份运维负担),元数据缓存用进程内 Caffeine。 ### 模块全景(8 模块,Maven 单体) | 模块 | 职责 | 状态 | 规模/测试 | |---|---|---|---| | **platform-legacy-core** | 保真层:回迁引擎(POJOCRUDService/服务流引擎/脚本引擎/数据权限) | ✅ 核心全通 | 21.4K LOC / 132 测试 | | **platform-metadata** | 现代层:amis schema 端点、实体 CRUD、写流派发、picker、引用列解析 | ✅ P1 完成 | 7.3K LOC / 239 测试 | | **platform-converter** | view_template.xml → amis schema 转换器 + CLI 跑批 | ✅ 核心通,缺高级模板 | 1.9K LOC / 58 测试 | | **platform-auth** | JWT 无状态认证 + 角色/数据权限网关 | ✅ 真实现(非桩) | 1.2K LOC / 34 测试 | | **platform-flow-gateway** | Flowable 客户端 + 待办/已办聚合 + 状态回写 | ✅ P3 可用 | 1.2K LOC / 34 测试 | | **platform-parity** | 逐行对拍框架(C1 一级交付物) | ✅ 生产就绪 | 3.4K LOC | | **platform-app** | Spring Boot 装配 + ArchUnit 边界纪律 | ✅ | 扫 `com.eip4.*`+`com.dsasp.*` | | **platform-ai** | P5:MCP Server | 🔴 纯占位 | 0 LOC | 全工程 ~36K LOC,496 测试全过。脚本引擎有个小保留:`FlowScriptBindings`/`GeneralPOJOBindings` 各 9 个容器方法是 `UnsupportedOperationException`,但 get/put 可用,不阻断脚本执行。 前端 **eip4-web**(React 18 + amis 6.13.0):4 业务页 + 设计器入口;15 个 e2e spec / ~252 用例,7 个强断言(真渲染+DB校验)。**amis-fork 纯上游 6.13.0 零定制**,所有定制在 eip4-web(自定义 fetcher / orgId 注入 / 脚本重放)。 ### 核心数据流(已打通) ``` view_template.xml ──BatchConvertCli──▶ amis schema ──入库──▶ sys_page_schema │ (overlay 优先) 浏览器 /page/:id ──▶ PageRenderPage ──GET /api/page/schema/{id}──┘ 列表查询 ──▶ GET /api/flow/{TABLE}_SEARCH (合成搜索流, 过滤+分页) 选人 ──▶ GET /api/picker/{dialogid}/list (搜索+分页+权限隔离) 写/动作 ──▶ POST /api/flow/{servicename} (服务流引擎: 拟稿人/时间戳/审批/级联) 脚本 ──▶ onEvent → /api/script/execute-template → 前端重放 facade 指令 ``` 写路径已正确接回服务流(不再绕过引擎裸存),读写门按 contentxml 真实方法分类(写流仅 POST + 真实用户上下文)。这是整个迁移最关键的架构正确性,已经立住。 --- ## 二、已实现(按层) - **后端引擎**:CRUD / 服务流 / 脚本引擎 / 数据权限全回迁生效;对拍 21 实体逐行 100% 一致 - **认证授权**:JWT 登录、行级数据权限(读端 `DataPrivilegeService` WHERE 下推 + 写端 `WritePrivilegeChecker` 逐行)、picker 权限隔离——都是真实现 - **元数据驱动 UI**:list/form/tree/report/group 五类模板转换;分页/排序/搜索/金额列/枚举映射(F2-16 `type:mapping`)/日期格式/人员列 id→姓名(运行时 `UserColumnResolver`,568 列) - **编辑表单**(本会话修):显式行布局、富文本满行、单层标题、弹窗剥壳、`{ids}` 批量删除/审批扇出 - **Flowable**:待办/已办/发起/审批/trace 可用,独立 8089 服务 - **设计器**:amis-editor 三屏 + overlay 双层(标准层=转换器产物升级整体替换;overlay=管理员手调,优先级更高) --- ## 三、本会话已修(2026-06-12 ~ 06-13) 针对"添加界面不可用"截图(富文本塌成竖条 + 三层标题嵌套),已提交 4 个原子提交: | 提交 | 内容 | 根因 | |---|---|---| | `52c7397` (converter) | 编辑表单显式行布局:废 `columnCount`/`colSize`,窄字段两两成 `group` 行、宽控件独占整行;去 `form.title` 重复;弹窗 `size:lg` | amis 6.13 的 `columnCount` 是纯 CSS 等宽列,`colSize` 在该模式下被整体忽略 → 富文本被塞半栏,TinyMCE 菜单挤成竖条 | | `a021f33` (metadata) | `format=amis` 剥 page 壳:弹窗只渲表单本体 | 弹窗经 service 加载整页 schema,page.title 叠 dialog 标题 = 三层重复(D4 运行时修复) | | `e2c5d43` (metadata) | amis `{ids}` 批量形态适配:按流 `` 必填 `*_ID` 逐 id 扇出执行 | bulkActions 只送 `ids=主键逗号串`,而老服务流 `` 声明单条必填主键 → 透传 ids 必填缺失 500、行未删(API 实证)。这是删除/提交审批/文件归档全链断裂的根因 | | `aeecaac` (eip4-web) | 删除 e2e 断言对齐老系统软删语义(`ISDEL=1`,不动 `ISACTIVE`) | 删除已走服务流 `OA_NOTICEMANAGE_DELETE`(start 脚本 `map.put("ISDEL",1)`) | | `662828c` (converter+metadata) | **列表引用列 id→显示名通用化**:resolver 推广到任意引用实体 + 产出 `_DISPLAY__` 平行字段保留原始 id;转换器引用列绑 `_DISPLAY__`;虚拟显示列兜底物理 NAME | 老引擎给每列算 `_DISPLAY__`、Vaadin grid 绑显示值;amis 后只补了用户列+枚举/日期,通用引用列显示裸 id(根因见 §5) | 验证:converter 60 测试 + metadata resolver 9 测试全过;e2e f2-17 5/5 绿;`{ids}` 删除 API 实证 status 0 + `isdel=1` 落库;浏览器真渲染确认弹窗单层标题/富文本满行,以及 OA_OFFICE_COLLARAPPLY 申请人=系统管理员[admin]/申请部门=法务合约部/用品仓=lll办公用品0412(原始 id 全保留,表单安全)。 --- ## 四、已知缺口(与当前 HEAD 对齐) ### 4.1 已修复(核对确认,不在缺口内) `未完成工作清单.md` 列为"待修"但实际已修:A1 列表过滤(`f5850a8`)、A2/A4 按钮死桩→EDITFORM 映射(`29199e6`/`34c2928`)、B1 弹窗嵌整页(`a021f33`)、E8 页面标题「测试」、E9 报表 500(`maven.compiler.release=21` 已设)、E12 登录跳转、A5 人员列裸 id(`UserColumnResolver`)、A6 富文本错配(`37db794`)。 ### 4.2 真·剩余缺口 | 缺口 | 类别 | 影响面 | 状态 | |---|---|---|---| | ~~通用引用列 id→显示名~~ | 元数据机制 | 广(凡引用列) | ✅ **已修**(`662828c`+`2a6c1d0`,2026-06-13):resolver 推广到任意引用实体 + 产出 `_DISPLAY__` 保留原始 id;转换器引用列绑 `_DISPLAY__`;虚拟显示列(如 SYS_DEPART.FULLNAME)兜底物理 NAME。实证申请人/部门/仓库均出名称。(注:`662828c` 当时仅提交了通用化测试,resolver/converter 实现漏入暂存区,`2a6c1d0` 补齐使 HEAD 自洽) | | ~~**SelectDialog 弹窗形态降级成下拉搜索**~~ | 控件走样 | 150 dialogId / 911 页 | ✅ **已修**(`9d92df2`,2026-06-13):SelectDialog/MultiSelectDialog → amis picker 多列对照弹窗(搜索+分页)。降级注释「6.13 schema 未纳入 picker」核实**失实**——picker 表单项过得了闸一(已加测固化)。列由运行时 `/api/picker` 随 `data.columns` 提供(转换器不解析跨模板 dialog XML,§6 对齐);PickerController 每行补 `_label` + 返回多列(displayname 友好标签)。浏览器实证:加班登记 USERID 弹窗多列(显示名称+帐号)、186 页分页、选中回填 `_id`(36 位 UUID)、chip 显显示名 | | ~~initvalue/defaultvalue 两阶段求值未迁移~~ | 元数据机制 | 全库依赖初值的页(1288 模板) | ✅ **已修**(`009ddf8`+web`d823264`,2026-06-13):UiTypeMapper 相一字面进 `value`、相二动态 token({CURRENTUSER}→${currentUser}/{CURRENTORG}→${orgId}/{CURRENTTIME}→${now}/{CURRENTPROJECT}→${currentProject})由 AmisRenderer 注入数据域求值;AUTOGENERATECODE(6 模板)+未识别 token 诚实降级。实证外部邮件收件箱搜索携 FOLDER=0。 | | **onselectedscript / filterscript 未挂回** | 脚本 hook | 行选中控按钮、选择框过滤 | ⏸️ **未做(依赖前置)**:核查发现 `full_auto_index.json`(507 条)只记 `{template_id,seq,rules}`,**不保留脚本来源事件类型**(onload/onselected/filter);现有 `attachScriptOnEvent` 把所有 seq 一律挂 `inited`+`change`。要把 onselected→CRUD 行选事件、filter→选项动态过滤分别接对,需先让 s3_rewriter 在索引里标注脚本来源事件类型 + 转换器按类型映射 amis 事件——属 rewriter 管线改造(跨 Python+Java+amis 事件语义),非纯接线,且本 dev 环境脚本管线未激活(index 路径错位致 onload/onchange 也未挂),无法端到端验。留待 rewriter 管线专项。 | | ~~**高级模板类型缺失**~~ | 模板覆盖 | 子表/树表/日历/审批表单 | ✅ **数据判定不做**(`ba34487`,2026-06-13):频次审计精确口径下 EditGrid/MasterSubGrid/TreeGrid/Calendar/Wf 在本客户库 1489 模板**全 0 存量**;转换器既有 `EditGrid/FormEditGrid → input-table` 子表分支足以兜底任何未来出现。跨模板引用(group)仍为占位,但 group 根仅 20 模板,低优先 | | ~~**真丢失控件**~~ | 控件覆盖 | TwinColSelect/PasswordField | ✅ **数据判定不做**(`ba34487`):TwinColSelect=0、PasswordField=0,零存量 | | **LIKE 搜索裸拼 SQL** | 安全 | picker/list 查询端点 | 🟡 **风险已澄清(2026-06-13 实测)**:引擎 GeneralPO 对 String LIKE 条件**自动双写单引号**(实测 `TITLE=x'` → SQL `like '%x''%'`,注入不可逃逸),故 _SEARCH/list **非可注入**;picker 端另有 escapeLikeValue 兜底。残余仅「通配符 `%`/`_` 未中和」(list 端)——属搜索语义/性能,非注入,低优先。P2 渐进参数化仍可做防御纵深,但非开放漏洞 | | ~~projectRoleType 候选人解析 ~91%~~ | Flowable | 528 处表达式 | ✅ **核实已闭环**(2026-06-13,`OrgDirectoryJdbc.java:33-46/116-144` 按 PROJECTID 直查 + 单测,非降级)。原描述失实;真正残留=`scriptUser`(26 处≈0.5%,仅 `System.out` 告警→宜升 `log.warn`) | | **报表 B 图表 / C 类 JOR** | 报表 | 45 个 JOR 模板 | A 类 333✅;C 类待 univer 替换方案 | | ~~深链接被 Tab 吞~~ | UX | 直开 /page/:id | ✅ **已修**(F2-13,`AppShell.tsx:80-95` 直开 /page/:id 自动建 Tab + 标题回填) | ### 4.3 静态审计"失明"项(运行时已修,审计数字不降) `schema_reality_audit.py` 扫的是静态产物,以下项**已在运行时修复但审计数字不变**——这是审计工具盲区,不是真缺口,后续要改用 e2e 验: - D1 人员列裸 id(603 页)→ `UserColumnResolver` 运行时解析 - D4 弹窗嵌整页(108 页)→ `format=amis` 剥 page 壳 - D6 不分页(1293 页)→ FlowController 分页翻译 > ~~**行动项**:审计脚本需升级~~ ✅ **已做**(`41eb339`,2026-06-13):`schema_reality_audit.py` 把 D1/D4/D5/D6 标「运行时已修(审计盲区)」、`--db` 加 **uitype × 模板根类型 × 频次**统计(扫 `view_template.xml` 存量真实用量)。真实基线见 `docs/F2-17-审计基线-2026-06-13-升级.md`。**关键发现**:SelectDialog 涉 940 模板(印证 picker 单点回报最大);**高级模板结构(EditGrid/MasterSubGrid/TreeGrid/Calendar/Wf)精确口径下全 0**(早期子串口径把脚本注释文本「addButton到EditGrid」虚计为 55,已修正);**真丢失控件 TwinColSelect=0、PasswordField=0**。即 §7-4 全部子项在本客户库零存量。picker 上线后 SelectDialog 降级 1783→225,分级 SUCCESS 114→283(+169 页)。 --- ## 五、根因专题:列表显示 id vs 老系统显示名称 **结论:老系统的"id→名称"是引擎自带能力(给每列额外算显示值);EIP4 复用同一引擎,但换掉了消费这个显示值的前端层(Vaadin grid → amis),换的时候只补了部分列的解析,通用引用列漏了。** ### 老系统机制(代码实证) 老引擎每行经 `GeneralPO.toMap()`(`GeneralPO.java:2411`)给**每一列**输出两个键: ```java map.put(key + "_DISPLAY__", po.get_DisplayValue(...)); // 显示值(名称) map.put(key, po.get_Value(i)); // 原始值(id) ``` `get_DisplayValue`(`GeneralPO.java:1311-1313`)对引用列: ```java } else if (dt.length() == 36) { // DisplayType 是 36 位 UUID = 引用了另一实体 return m_custom.get(columnName); // 返回预解析的目标实体显示名 } ``` 即:列若引用别的实体(DisplayType = referenceid UUID),引擎按 `referenceid → SYS_REFERENCE → 目标实体显示列`,在查询时用 `LEFT JOIN lateral`(`POInfo.java:442-457`)把 id 解析成名称存进 `m_custom`。**Vaadin grid 列绑定的是 `_DISPLAY__` 值,不是原始 id**。所以老系统引用列/枚举/日期/金额全自动显示成人类可读值,前端零代码——这是元数据驱动引擎的内建红利。 ### EIP4 为什么显示 id EIP4 **回迁同一引擎**,这套能力其实还在,但链路两处断: 1. **序列化层不带显示值** —— 实测 `/api/flow/OA_NOTICEMANAGE_SEARCH` 返回 23 字段,`_DISPLAY__` 键数 = **0**,`USER_ID`/`ORGID` 全裸 id。合成搜索流 → FlowController → JSON 这条路没走 `toMap`,只吐原始值。 2. **amis 列绑原始列名** —— 转换器生成 `{name:"USER_ID"}`,amis 显示原始 id。 老系统的显示解析本在 Vaadin grid 层,被 amis 替换时只重新实现了部分列:枚举/状态(F2-16 `type:mapping`)✅、日期(`type:date`)✅、**用户引用列**(补丁 `UserColumnResolver` 运行时,只认 SYS_USER)✅、**其它引用列(项目/部门/单位/任意实体)→ 无人管,显示裸 id** ❌。 ### 修复成本低(引擎已会算,缺的是接回前端) - **首选**:把 `UserColumnResolver` 从"只认 SYS_USER"推广成"按 `referenceid` 解析任意引用实体的显示列"(复用 picker 已有的 `displayColumn` 逻辑)——一处改动覆盖全部引用列。 - 备选:让搜索流序列化带 `_DISPLAY__` + 转换器把引用列绑显示变体——更贴近老系统原生,但改序列化契约+转换器两处。 → 采首选。它和"选择器统一"是**同一套 `displayColumn` 机制**,一起做最省(见 §7)。 --- ## 六、新增功能架构(待拍板) **问题:目前整套机器是迁移/兼容引擎(读老 XML → 转 amis → 渲染)。迁移完,新系统怎么加老系统没有的新功能?** ### 关键认知:系统里有两种"元数据",未来命运不同 | | 是什么 | 未来 | |---|---|---| | **数据/行为元数据** | `SYS_ENTITY`/`SYS_ENTITYATTRIBUTE`(实体模型)、`SYS_SERVICEFLOW`(业务逻辑)、引用/权限 | **保留,作为正向 authoring 模型** | | **视图元数据** | `view_template.xml`/`view_page.xml`(Vaadin 时代 XML)→ 转换器 → amis | **冻结,只用于迁移,最终退役** | 因为后端引擎**本身就是元数据驱动**:往 `SYS_ENTITY` 插实体 → 引擎自动动态建表 + CRUD(`/api/entity`)+ 标识符白名单 + 类型强制 + 数据权限,全免费;往 `SYS_SERVICEFLOW` 写流 → 引擎自动跑默认值/校验/级联/审批。这套是平台真正可持续的价值。而 XML→amis 那条链是**为搬老页面才存在的翻译层**,新功能从没需要过翻译。 ### 目标姿势:新增一个业务功能 1. **定义数据** → `SYS_ENTITY`/`SYS_ENTITYATTRIBUTE` 建实体 → 引擎自动给 CRUD/权限/建表 2. **定义行为**(若需要)→ 写服务流 contentxml(默认值/校验/审批触发)→ 引擎执行 3. **画页面** → amis 设计器**直接写 amis schema** 进 `sys_page_schema`,**不经过 XML、不经过转换器**;列表指向 `/api/flow/{TABLE}_SEARCH` 或 `/api/entity/{table}/list`,表单指向 `/api/flow/{servicename}` 或 `/api/entity/{table}/save` 4. **挂菜单** → templateId 一句话:**引擎 + amis 是运行时,XML 转换器是一次性导入工具,迁移完退役。新功能永远不碰 XML。** ### 要让它成真,缺三个工具 + 一个设计决策 **三个 authoring 工具(现在都没有):** - **实体建模器**(计划 F4-L2):可视化建 `SYS_ENTITY`,不裸写 SQL - **设计器"新建空白页"**:现在 `DesignerPage` 只能 overlay 已转换的存量页(templateId 必须已存在),不能从零建页 - **服务流设计器**(F4-L3)或至少 contentxml 编辑助手 **一个必须明确的设计决策——新页面的 source of truth 放哪:** 现在 `sys_page_schema` 是"标准层(转换器产物,重迁移整体替换)+ overlay(手调)",**假设底下永远有转换器基线**。但新建页没有 XML 基线——它本身就是基线。建议加来源标记 `source = 'converted' | 'authored'`:converted 页可被重转覆盖;authored 页是手写的、永不被转换器碰。这样重跑迁移不清掉新功能,新功能也有干净的家。 **逃生口:** 真正低代码表达不了的(自定义看板、第三方集成、复杂交互)→ 直接手写 Spring REST + React 路由,与 amis 页并存。别强行什么都塞进引擎。 ### 时序建议 - **近期**:迁移收尾(§7),让存量可用。这期间**不再加深转换器对 XML 的耦合**,新机制一律按"amis 原生"形态做,为退役转换器铺路。 - **中期**:迁移到"大部分页能用 + overlay 兜底"水位后,启动 F4-L2 实体建模器 + 设计器新建空白页 + `sys_page_schema` 加 `source` 标记。这三件到位,新功能彻底脱离老系统,转换器降级成纯导入工具。 --- ## 七、下一步路线 整个项目的架构骨架已立住(双层制 + 写回服务流 + 对拍守护),现在是 **P4 收尾期**——从"跑通"到"生产级可用"。按回报排序: 1. ✅ **通用引用列 id→显示名 + 选择器弹窗化(同源,已完成)** —— 单点回报最大。两者都用同一套 `displayColumn`(按 `referenceid` 找显示列)机制。 - ✅ **引用列"列表显示 id"已修**(`662828c`+`2a6c1d0`,2026-06-13,见 §3) - ✅ **选择器弹窗化已修**(`9d92df2`,2026-06-13):SelectDialog/MultiSelectDialog → amis picker 多列对照弹窗。半小时复核结论:降级注释「6.13 schema 未纳入 picker」**失实**,picker 过得了闸一(已加测 `schemaGate_picker表单项过闸一`),无需改 amis-fork。列由运行时 PickerController 随 `data.columns` 提供(转换器零跨模板 XML 耦合,§6 对齐),浏览器端到端实证通过(多列+搜索+分页+回填 `_id`) 2. ✅ **审计工具升级 + 真实基线已做**(`41eb339`,2026-06-13)—— D1/D4/D5/D6 标运行时项改 e2e 验;`--db` 加 uitype/模板/频次统计。基线数据见 §4.3。 3. **initvalue 两阶段求值 + onselectedscript/filterscript 挂回** —— - ✅ **initvalue 已修**(`009ddf8`+web`d823264`,2026-06-13,全库 1288 模板):字面进 value + 动态 token 前端数据域求值。见 §4.2。 - ⏸️ **onselectedscript/filterscript 未做**:核查发现非纯接线——`full_auto_index` 不保留脚本来源事件类型,需先改 s3_rewriter 管线标注事件类型再按类型映射 amis 事件,且本环境脚本管线未激活无法验。详见 §4.2 该行。 4. ✅ **高级模板类型 / 真丢失控件 —— 数据判定全部不做**(`ba34487`,见 §4.3 基线):精确口径下高级模板结构(EditGrid/MasterSubGrid/TreeGrid/Calendar/Wf)与真丢失控件(TwinColSelect/PasswordField)在本客户库**零存量**;转换器既有 EditGrid→input-table 分支兜底。§7-4 由数据判定关闭。 **本会话上线状态(2026-06-13)**:§7-1/§7-3 的转换器改进(picker / 引用列 _DISPLAY__ / initvalue)**已正式部署到服务层** —— 用正确 rewriter 路径(`output/`,保留 onEvent 380 模板)重跑 BatchConvertCli 生成 1489 产物,经 `SchemaImportCli` 导入 `sys_page_schema`,实证加班登记标准层无 overlay 直出 picker 多列选择窗 + onEvent。overlay 手调层不动。故这些改进对全部存量页生效,非仅代码。 **本会话 QA 巡检(2026-06-13,运行时 dogfooding 找成类 bug)**:静态扫全 1489 schema + 运行时 API 分层抽样,修复 5 类缺陷,均已重转+重导入上线: - **空结果集列表崩**(凡 0 行列表页报「data.items 必须是数组」)→ FlowController.normalize 空集也拍平 {items:[],total:0}(`ea0b68d`)。 - **ComboBox 枚举下拉空数据**(51 模板,comboboxid 空+itemisenumerate)→ 取列 enumeratetype 作字典源(`ea0b68d`)。 - **YEAR/MONTH 下拉空**(27 字段)→ 转换器内建生成年/月静态选项(`012ab21`)。 - **report 无 selectservice 兜底端点 404**(12 报表页)→ 改兜合成 _SEARCH(`e6054a3`)。 - **引擎异常裸 500**(实体登记但物理视图缺失)→ FlowController 兜成 200+status:1 友好提示(`e6054a3`)。 - 剩余:静态 group「跨模板子模板」占位 87(架构项,§6 跨模板);5 个 itemisenumerate=false 无源 select(老系统本无源,诚实降级);运行时 ~10 个 `VIEW_*/VM_*` 报表视图在 dev 副本物理缺失(生产存在,现优雅降级,**非产品缺陷,属 dev 数据缺口**)。 **全量运行时巡检(2026-06-13,1489 页 list+499 去重 source 并发打端点)——最大发现是环境问题:** - 🔴 **【关键环境】dev 平台须跑 JDK 21,不可用 JDK 26**:实测 JDK 26(class major 70)下,老引擎服务流的 **Groovy 4.0.27 脚本编译崩**(`AsmDecompiler: Unsupported class file major version 70`,`GroovyBugError`),致 **35+ 个带 Groovy 脚本的命名查询流(`*_SEARCH_LISTINFO`/`*_SZWJ` 等)直接 500**。换 JDK 21(项目 `maven.compiler.release=21` 目标、生产口径)后**全部恢复**(如 PM_LABORCOMPANY_SEARCH_LISTINFO 返 57 行、PM_SPECIALTY_SUBPACKAGE 1305 行)。已 `brew install openjdk@21` 并把平台切到 21。**启动命令须 `JAVA_HOME=/opt/homebrew/opt/openjdk@21`**(flowable-service 建议同切)。生产用 21 故无此问题。 - 巡检剩余分类(JDK 21 下):`LIST_DEVDATA_GRACEFUL` 289 + `VIEW_*_SEARCH` 404 共 ~320 = **dev 库缺视图/缺实体登记**(生产存在,非缺陷;404 类实体在 dev 连 SYS_ENTITY 都没登记);`LIST_ITEMS_NOT_ARRAY` 6 = 并发巡检假阳性(直连返正常 items);`SOURCE_EMPTY` 66 = 半为空 picker(dev 数据)半为 ComboBox 的 comboboxid 指向查询服务而非枚举(错配 /api/poc/dict)。 - ~~**真·剩余代码缺口**:`/api/template/{id}/tree|list` 占位端点 83 处 = TreeGrid 树模板渲染~~ ✅ **已修**(`4337720`,2026-06-13):新增 `TemplateTreeController` 运行时构树端点(`GET /api/template/{ref}/tree`,解析 `/` 按各级 parentid 链父,支持自嵌套+跨实体);转换器 convertTreeGrid 改:左树走该端点 + onEvent 重载右表,右表复用 `/api/flow/{gridTable}_SEARCH?{rcol}=${tree}`(原 /api/template/list 不存在),右表列取自 gridtemplate 引用模板 display;并修 flex→grid 布局。浏览器实证「查看大事记管理」左树分类层级渲染 + 点节点右表 reload 携 EVENTID。重转分级 SUCCESS 283→328。 - ⚠️ **TreeGrid 二次 QA 发现 `4337720` 只做通 happy path,两处运行时缺陷已补修**(2026-06-13,浏览器 dogfooding): 1. **左树只显示一半**(全 45 个 treegrid 页):amis `.cxd-Tree--outline` 默认 `max-height:300px`,多级分类树露一半、下方大片留白。修法(终版):转换器给 input-tree 挂 `className=eip4-treegrid-tree`,eip4-web `amis-theme.css` 把该类内 `.cxd-Tree` max-height 抬到 `calc(100vh-230px)`+内部滚动(填满视口、超出树内滚)。注:先试过 `heightAuto`(随内容无限撑高,大树拉爆页面,用户否)与内联 `style`(只落外层 form-item、压不到内层滚动容器,无效),均弃用。浏览器实证树高 615px、底部 783<视口 845。 2. **点父/中间节点右表「暂无数据」**(29 个多级 type-4 树):右表按 `{rcol}=${tree}` 精确匹配点中节点自身 id,而业务行常只挂叶子(文件挂「技术部」非父级「技术中心」),点父级 0 行。**老系统点父级聚合整棵子树**。修法:新增 `GET /api/template/treegrid` 子树聚合端点——解析「点中节点+全部后代」id 列表,以 `List` 值委托合成 `_SEARCH`,引擎 `GeneralPO.get_SearchWhereClause` 见 List 即构 `rcol IN (...)`(已转义,无注入面,**无需改保真层**),复用 _DISPLAY__/数据权限/分页;转换器右表 api 改指该端点(`treeRef`/`gridTable`/`rcol`/`node=${tree}`)。`TemplateTreeController` 补 7 个单测(构树/子树/IDENT 守卫/委托),转换器 60 测全过。浏览器实证:资料库点父级「技术中心」现出子级「技术部」文件(修前空);单级树「通知收藏」点叶子仍正确过滤(无回归)。已重转 1489 产物 + SchemaImportCli 导入(445 更新)上线。 - ✅ **TreeGrid 三次 QA 补「操作」(2026-06-13,用户追问「列表上面的按钮都有了吗」)**:`convertTreeGrid` 此前只做「看」,45/45 页左树+右表操作按钮全丢。已补: 1. **树高度终版**改 className+CSS(见上,撤回 heightAuto)。 2. **右表工具栏**(添加/修改/删除/查看):读 gridtemplate 引用模板 `