Files
eip4-platform/docs/归档/EIP4-架构与缺口现状-2026-06-13.md
zhengwr 1b69f8b481
Some checks failed
ci / build-test-parity (push) Has been cancelled
docs: 统一项目文档进 eip4-platform/docs + 新增进度路线总览
- 从工作区根 docs/(非 git,未版本化)合并全部文档进版本控制,消除文档两头分裂
- 新增 README(状态总览+模块完成度+全文档索引)、项目进度与路线-总览-2026-06-17(A兼容/B新功能+关键路径+待拍板决策)
- 被取代的冲突状态/审计快照归入 归档/;对最易误导的两份("16视图已交付"实现交付报告、06-13架构快照)加"已归档"横幅
- 现行权威:engineclass移植backlog(46视图) + 用户管理Delta移植(方法论/交接) + 组件设计体系 + 通用模板收口 + 客户沟通
- 诚实口径:纵向模块仅用户管理 parity,横向引擎地基较全,余 153 定制视图(47 framework+106 业务)多为通用页已产·delta 未移植

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 14:53:29 +08:00

34 KiB
Raw Permalink Blame History

⚠️ 已归档(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 解析 <layout> 多 <tab>→amis tabs(72 页多页签原塌平;正则提 <div location> 归位;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} 批量形态适配:按流 <input> 必填 *_ID 逐 id 扇出执行 bulkActions 只送 ids=主键逗号串,而老服务流 <input> 声明单条必填主键 → 透传 ids 必填缺失 500、行未删(API 实证)。这是删除/提交审批/文件归档全链断裂的根因
aeecaac (eip4-web) 删除 e2e 断言对齐老系统软删语义(ISDEL=1,不动 ISACTIVE) 删除已走服务流 OA_NOTICEMANAGE_DELETE(start 脚本 map.put("ISDEL",1))
662828c (converter+metadata) 列表引用列 id→显示名通用化:resolver 推广到任意引用实体 + 产出 <COL>_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+webd823264,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)给每一列输出两个键:

map.put(key + "_DISPLAY__", po.get_DisplayValue(...));  // 显示值(名称)
map.put(key,               po.get_Value(i));            // 原始值(id)

get_DisplayValue(GeneralPO.java:1311-1313)对引用列:

} 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+webd823264,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,解析 <node>/<levelnode> 按各级 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 引用模板 <button>,复用 collectButtons/buildToolbar(与普通 list 同源,含 EDITFORM 映射 + 删除走 bulkActions ${ids})。
      3. 左树分类节点增删改:treetemplate 引用模板 <node><buttons> → amis InputTree 原生 creatable/editable/removable/rootCreatable + addApi/editApi/deleteApi(配 source 自动重拉刷新);add 送 {名称列:${label},父列:${parent.value}}、del 送 {主键:${value}},名称列/父列由元数据(isentitydisplay/levelnode parentid)解析。转换器 60 测全过。浏览器实证:树高视口填满、右表 4 按钮渲染、左树 ➕添加一级节点+悬停节点 +−✎、删除端到端 status:0 通。
      • 🔴 遗留①(写流引擎缺口,非接线问题):左树添加/修改(及右表文件新增等任何走 EL 表达式求值的写流)被引擎 Can't find scripting engine for 'juel' 阻断 → status:1。juel 字面在 4983 流 contentxml 中出现 0 次,是引擎对 EL 的默认引擎名——本运行时未注册 JUEL JSR-223 引擎。影响面=所有 EL 写流,非仅 treegrid;属保真层相邻平台任务:platform-legacy-core/装配层注册 JUEL ScriptEngineFactory + 跨流回归。删除流不走 EL 故正常。(用户拍板:登记为独立平台任务,本轮不动)
      • 🔴 遗留②(编辑表单迁移缺口,全系统级):按钮「添加/修改/查看」弹窗提示「该单据未配编辑表单」的根因——编辑表单是 view_page(全库 1241 个,带完整 <fields>),而 BatchConvertCli 只遍历 view_template(1516),这 1241 个编辑表单从没转换/导入 sys_page_schema;弹窗解析器 resolveEditFormTemplateId 只在 type=7 包壳模板(全库仅 70 个)里按 pageid/entityId 找,指向独立 view_page 的按钮(绝大多数)全部命中不到 → 降级占位。这是 F2 写路径「编辑表单迁移」一直未做的步骤,非 treegrid 特有(treegrid 右表按钮只是把它暴露出来)。修法:遍历 view_page→amis form(复用现有 convertForm/view_page 解析器字段逻辑)入 sys_page_schema,解析器命中已转 view_page 时直接返回 pageId。补完后**「查看」立即全可用**、添加/修改表单可显示(提交仍待 juel)。(用户拍板:登记为独立任务,本轮不做)
      • 即:真实「添加/修改」端到端可用 = 编辑表单迁移(遗留②,表单界面) + JUEL 引擎(遗留①,提交执行) 两个前置都补齐;「查看」只需遗留②;「删除」已可用。
  • 次要待办:ComboBox comboboxid=查询服务(非枚举)时应路由 /api/flow 或 /api/picker 而非 /api/poc/dict(SOURCE_EMPTY 约半数);group「跨模板子模板」占位 87(§6 跨模板,架构项)。TreeGrid 仍后置:type=3 声明式多级树 53 页仍走 selectservice+deferApi 占位未接 /api/template/{ref}/tree 端点。

先不碰:platform-ai(MCP,P5);转换器对 XML 的深度精度(已死格式,低 ROI)。


七·补、主动覆盖度审计缺口地图(2026-06-13)

前述缺口多是浏览器 dogfooding 被动撞出的;本节是主动盘点结论——按模板 type、编辑表单 uitype、编辑表单结构、运行时端点四维,把源数据存量对照转换器分支+运行时可达性扫出的缺口。 完整证据与计数见 docs/转换器覆盖度审计-2026-06-13.md(4 并行审计 agent + curl/浏览器抽验 + 代码核对);此处仅列按优先级排序的清单。

P1 — 正确性/安全(小量必修)

  • 🔴 type=5 日历视图(2:单个员工排班/查看会议室调度)转成普通 crud 表格 → 班次/日历语义全丢(浏览器实证渲染成查询表单+空网格)。应映射 amis calendar/fullcalendar。
  • 🔴 编辑表单 default 控件:PasswordField(明文,安全)/SingleFileUploadField(41,丢上传含证件照)/DateField(1,丢日期)落 default→input-text。各 1 行/复用即修,迁移编辑表单前先补 UiTypeMapper。
  • 🔴 VIEW_/VM_ 报表端点 ~46 个/影响 ~277 页:dev 缺聚合视图,需 DBA 确认生产视图存在性(生产有=dev 数据缺口;无=真建视图+注册服务流)。

P2 — 编辑表单迁移(遗留②)必须连带做的质量项

  • ⚠️ EditGrid/FormEditGrid 子表列硬写 input-text 不递归 UiTypeMapper → 637 子表里 SelectDialog/ComboBox/NumberField/Date 全退化文本、178 子表联动丢失 → buildEditGridColumns 改为对子表字段递归 mapField。
  • ⚠️ 多页签 <tab> 布局(72 页) + width/colspan 精确布局(875+) 丢失(convertForm 跳过 <layout>,平铺等宽两列)。
  • ⚠️ requirederror(1237)/minlength(1219) 未读取。
  • ⚠️ 编辑表单 SelectDialog/MultiSelectDialog ~97% 无 dialogid 降级 select、ComboBox 339 查询服务源 SOURCE_EMPTY(需运行时按字段/实体元数据补数据源,列表页 picker 同源机制延伸)。
  • ⚠️ 页面级 <scripts> 联动(601 页) part-handled,依赖脚本改写器管线(与 §4.2 onselected/filter 不同管线、不同阻塞点)。

P3 — 决策/低成本/已知后置

  • type=6 group(20):子模板 62/62 已各有产物,前端 tabs 按 tempid 拉 /api/page/schema/{tempid} 即可激活(前端路由活,非转换器缺口)。
  • type=100/101(130)选择窗死页:无菜单关联、运行时由 /api/picker 承接、不读这些 schema → 决策停转 or 留 F4 弹窗预览。
  • report B 图表(4,ischart=true) 降级纯表格、C 类 JOR 套打版式丢失(另案 amis chart/univer)。
  • type=3 声明式多级树(53) 未接 /api/template/{ref}/tree 端点。

端点引用实况(修正并行 agent 误判):产物 /api/flow *_SEARCH 1345 页、/api/picker 911 页(1948 次)、/api/poc/dict 728 页(1683 次)、/api/template/treegrid|tree 45、/api/page/schema 109(多指向未迁移 view_page→「未配」)。_SEARCH 抽样(N=300):有数据 55% / 空(dev 缺口)42% / status:1 降级 2.3% / 错 0.7%。

写功能依赖链(一句话):真实「添加/修改」端到端 = 遗留②编辑表单迁移(连带 P2 全部)+ 遗留① JUEL 引擎;「查看」只需遗留②(+P2 部分);「删除」已可用;P1 与之并行(小修+报表数据源确认)。


八、外部 / 人工依赖(技术线推不动)

阻塞 卡住什么
S1 止损评审会(153 定制视图 7.56 人月三选一:分期/第三方组件/扩预算) 卡 F3 主线启动
11 个引擎读路径缺陷待旧系统同病验证 同病=保真不改,独病=移植 bug 要修——优先级定不了
检查点①/② 商务闭环 + 客户签字矩阵 卡首批切流
1854 账号无盐 MD5 弱口令 安全建议书,切流后推升级
PG 9.4→15 / Flowable 5→6 生产升级窗口 Runbook 就位,待客户隔离准生产环境演练

维护:本文档随 §7 路线推进滚动更新;§6 新增功能架构待拍板后,转为正式架构决策回写 eip4-platform/docs/架构设计.md。