- 从工作区根 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>
34 KiB
⚠️ 已归档(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-web693a857。
【2026-06-13 夜·写路径主线进展(本文档增量,§7 路线对应推进)】 经 5-agent 对代码核验 workflow 拍板后,落地写路径全部前置 + 平台前置,6+1 原子提交(eip4-platform main):
- A0
06dd127UiTypeMapper 补 PasswordField→input-password / SingleFileUploadField→input-file / DateField→input-date(default 三控件)。- A1
b28bff2EditGrid/FormEditGrid 子表列递归 mapField→quickEdit(子表内 Select/Combo/Number/Date 不再退化文本)。- A2
3735a9bconvertForm 解析<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
c721bdeJUEL 跨流回归: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 登录、行级数据权限(读端
DataPrivilegeServiceWHERE 下推 + 写端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 真·剩余缺口
| 缺口 | 类别 | 影响面 | 状态 |
|---|---|---|---|
| 元数据机制 | 广(凡引用列) | ✅ 已修(662828c+2a6c1d0,2026-06-13):resolver 推广到任意引用实体 + 产出 _DISPLAY__ 保留原始 id;转换器引用列绑 _DISPLAY__;虚拟显示列(如 SYS_DEPART.FULLNAME)兜底物理 NAME。实证申请人/部门/仓库均出名称。(注:662828c 当时仅提交了通用化测试,resolver/converter 实现漏入暂存区,2a6c1d0 补齐使 HEAD 自洽) |
|
| 控件走样 | 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 显显示名 |
|
| 元数据机制 | 全库依赖初值的页(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 渐进参数化仍可做防御纵深,但非开放漏洞 |
| ~ |
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 替换方案 |
| 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 回迁同一引擎,这套能力其实还在,但链路两处断:
- 序列化层不带显示值 —— 实测
/api/flow/OA_NOTICEMANAGE_SEARCH返回 23 字段,_DISPLAY__键数 = 0,USER_ID/ORGID全裸 id。合成搜索流 → FlowController → JSON 这条路没走toMap,只吐原始值。 - 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 那条链是为搬老页面才存在的翻译层,新功能从没需要过翻译。
目标姿势:新增一个业务功能
- 定义数据 →
SYS_ENTITY/SYS_ENTITYATTRIBUTE建实体 → 引擎自动给 CRUD/权限/建表 - 定义行为(若需要)→ 写服务流 contentxml(默认值/校验/审批触发)→ 引擎执行
- 画页面 → amis 设计器直接写 amis schema 进
sys_page_schema,不经过 XML、不经过转换器;列表指向/api/flow/{TABLE}_SEARCH或/api/entity/{table}/list,表单指向/api/flow/{servicename}或/api/entity/{table}/save - 挂菜单 → 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 收尾期——从"跑通"到"生产级可用"。按回报排序:
- ✅ 通用引用列 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)
- ✅ 引用列"列表显示 id"已修(
- ✅ 审计工具升级 + 真实基线已做(
41eb339,2026-06-13)—— D1/D4/D5/D6 标运行时项改 e2e 验;--db加 uitype/模板/频次统计。基线数据见 §4.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 该行。
- ✅ initvalue 已修(
- ✅ 高级模板类型 / 真丢失控件 —— 数据判定全部不做(
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_GRACEFUL289 +VIEW_*_SEARCH404 共 ~320 = dev 库缺视图/缺实体登记(生产存在,非缺陷;404 类实体在 dev 连 SYS_ENTITY 都没登记);LIST_ITEMS_NOT_ARRAY6 = 并发巡检假阳性(直连返正常 items);SOURCE_EMPTY66 = 半为空 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):- 左树只显示一半(全 45 个 treegrid 页):amis
.cxd-Tree--outline默认max-height:300px,多级分类树露一半、下方大片留白。修法(终版):转换器给 input-tree 挂className=eip4-treegrid-tree,eip4-webamis-theme.css把该类内.cxd-Treemax-height 抬到calc(100vh-230px)+内部滚动(填满视口、超出树内滚)。注:先试过heightAuto(随内容无限撑高,大树拉爆页面,用户否)与内联style(只落外层 form-item、压不到内层滚动容器,无效),均弃用。浏览器实证树高 615px、底部 783<视口 845。 - 点父/中间节点右表「暂无数据」(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 更新)上线。
- 左树只显示一半(全 45 个 treegrid 页):amis
- ✅ TreeGrid 三次 QA 补「操作」(2026-06-13,用户追问「列表上面的按钮都有了吗」):
convertTreeGrid此前只做「看」,45/45 页左树+右表操作按钮全丢。已补:- 树高度终版改 className+CSS(见上,撤回 heightAuto)。
- 右表工具栏(添加/修改/删除/查看):读 gridtemplate 引用模板
<button>,复用collectButtons/buildToolbar(与普通 list 同源,含 EDITFORM 映射 + 删除走 bulkActions${ids})。 - 左树分类节点增删改: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 引擎(遗留①,提交执行) 两个前置都补齐;「查看」只需遗留②;「删除」已可用。
- ⚠️ TreeGrid 二次 QA 发现
- 次要待办: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。