Files
eip4-platform/docs/研究/通知保存流程-老vs新-机制trace.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

278 lines
34 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.
# 通知管理「添加 → 保存」流程:老系统(EIP3) vs 新系统(EIP4) 机制 trace
> 只读研究产物。每条论断给 file:line 证据;推断处明确标注「推断」。
> 目标:为"保证功能正确迁移"建立机制参考,逐步对照标出缺口/风险。
## 路径约定(实际仓库布局,与任务描述略有出入,先纠正)
| 角色 | 实际路径 |
|---|---|
| EIP3 通知模块(零业务代码) | `/Users/zhengwr/workspace/EIP-3.0/oa/trunck/com.dsasp.oa.noticemanage/`(注意是 `EIP-3.0` 不是 `eip3`) |
| EIP3 通用引擎(运行时) | `/Users/zhengwr/workspace/eip3/framework/com.dsasp.client.viewFramework/src/com/dsasp/client/viewframework/` |
| EIP3 保存服务核心 | `/Users/zhengwr/workspace/eip3/framework/com.dsasp.server.dataDic/src/com/dsasp/server/dataDic/service/`(`POJOCRUDServiceImpl` / `POJOServiceImpl`) |
| EIP3 默认值/会话函数 | `/Users/zhengwr/workspace/eip3/framework/com.dsasp.server.common/src/com/dsasp/server/common/function/GetDefaultValueFunction.groovy` |
| EIP4 后端 | `/Users/zhengwr/workspace/eip3/eip4-platform/`(嵌套在 eip3 下;`platform-metadata` / `platform-converter` / `platform-legacy-core`) |
| EIP4 改写器产物 | `/Users/zhengwr/workspace/eip3/eip4-platform/tools/s3_rewriter/output/rewritten/{e732c4b0,20147656}/` |
| DB(eip3 元数据在 `eip3` schema) | `psql -h localhost -p 5433 -U zhengwr -d eip4dev` → `eip3.sys_entityattribute` 等 |
**任务背景里点名但实际不在运行时路径上的文件(避免误导后续):**
- `template/EditForm.java` 是 14 行**接口**(`EditForm.java:9-14`),不是 886 行渲染引擎。
- `template/editform/EditFormButton.java` 是按钮 **POJO**(`EditFormButton.java:5-78`),无添加逻辑。
- `component/FormEngineUtil.java` 整类 `@Deprecated`、CRUD 方法体全注释(`component/FormEngineUtil.java:78,751-756,833-839,870-881`)——**不参与运行时**,任务里"initvalue 在 :97"指的是这个废弃类。
- **真正的渲染引擎是 `template/form/FormEngineUtil.java`(1154 行,同名不同包)**,下文所有渲染结论均出自它。
- `template/form/{SelectDialog,RichTextArea,FieldFactory}.java` 是**设计期元数据描述类**,运行时控件是 `com.dsasp.viewframework.SingleSelectField` / `CKEditorTextField`。
**通知核心元数据(DB 实查,authoritative):**
- 实体 `OA_NOTICEMANAGE` = `9ecbdef6-7aef-44c8-a1c0-36ced81e7385`;主模板 `e732c4b0-...`;添加页 `7a1bbdaf-...`。
- 拟稿人 `USER_ID` = 属性 `9c9ca3ae-406d-4733-a2d4-1f57608c042d`:`ismandatory=1`、`iskey=0`、`isreadonly=0`、`referenceid=0236dbdc-...`(指向 SYS_USER 引用)、**`defaultvalue` 空、`func` 空、`ruleid` 空**(DB 实查,`eip3.sys_entityattribute` RECORD 21)。即元数据层对拟稿人**无任何默认值**。
- 添加页 `7a1bbdaf` 字段仅:`OA_NOTICEMANAGE_ID / NOTICEDRAFTPEOPLES / TITLE / NOTICECONTENT / IMPORTANT / DOCUMENT / APPROVALTYPE`——**不含 USER_ID**(view_page.copy:3)。
---
## 1. 打开「添加」:引擎如何从 view_template/view_page 构建 EditForm
### 老系统怎么做(file:line)
通知页是 grid 驱动,添加入口在 `GridTemplateComponent`,**不在** `EditFormButton`/`EditForm`:
1. **建添加按钮**:`GridTemplateComponent` 遍历 `crud/button` insert 节点生成按钮并挂 `buttonClick`(`grid/GridTemplateComponent.java:681-723`)。
2. **点击 → createInsertWindow**:`buttonClick` 调 `createInsertWindow(insertroot, crudUtil)`,再 `setCompositionRoot(...)` 把表单**整页换入**(非弹窗)(`:710-711`)。
3. **createInsertWindow**:先 `excuteLoadMethod(rootMap, null)` 跑后端 load 服务拿默认实体 → `entityMap`,再 `new GridTemplateInsertWindow(rootMap, crudUtil, entityMap)`(`:1229-1271`)。add 模式 `selectedItem==null`,load 服务取自 `crud/button/load/method/@servicename`(`CRUDUtil.java:841-848`)。
4. **GridTemplateInsertWindow 分叉**:`init()` → `buildMainLayout()` → 若 `rootMap.get("pageid")!=null` 走 `createFormPage()`(view_page XML 路径,**通知添加走这条**),否则 `bindFields()`(内联 field)(`grid/GridTemplateInsertWindow.java:89-112`,分叉 `:102-106`)。
5. **createFormPage**:`PageService.getTemplateXML(pageId)` 取 view_page XML → `new FormPageTemplateComponent(pageXml, entity, pageId)` → `getFieldGroup()`(`:181-206`)。
6. **真正建表单**:`FormPageTemplateComponent.init(xml)` → 解析 fields/layout → `FormEngineUtil.binderProperties(fields, layout, result, scripts)`(`page/FormPageTemplateComponent.java:129-216`,调用 `:192/:202`)。
**字段来源 = view_page XML 的 `<page>/<fields>/<field>`**(`FormPageTemplateUtil.getFieldElement()` = `selectNodes("//page/fields/field")`,`page/FormPageTemplateUtil.java:104-106`),**不从 sys_entityattribute 动态拼**(运行时不读该表;它只在 grid 列/设计期用,`grid/GridTemplateComponent.java:609-611`)。两层合并:(a) `VIEW_PAGE_CUSTOM` 自定义 XML 同名替换/新名追加(`FormPageTemplateComponent.java:143-148`、`FormPageTemplateUtil.java:31-94`);(b) 单字段属性 = XML 实写属性 ∪ `FieldFactory` 默认属性模板(`form/FormEngineUtil.java:469`、`util/PropertyUtil.java:55-72`)。
**uitype → 控件分派**:集中在 `FormEngineUtil.elementFieldConvertToUI(...)` 一个大 if-else,按 uitype 字符串 `equals` 比对(`form/FormEngineUtil.java:468-926`):
- `SelectDialog`(拟稿人/人员选择) → `new SingleSelectField(dialogid, label, filterscript, group)`,随后 required / `hidden→setVisible(false)` / buttoncaption(`:789-807`)。
- `RichTextArea`(富文本) → `CKEditorConfig` + `new CKEditorTextField(config)`,固定 300×600,加长度校验(`:627-651`)。
- 其余:TextField `:531`、NumberField `:557`、ComboBox `:655`、PopupDateField `:713`、MultiSelectDialog `:808`、MultiFileUploadField `:859` 等;不匹配 `return null`(`:906-908`)。
**隐藏字段处理(关键)**:遍历对象是 `fields`(= XML 里实际存在的 field,`form/FormEngineUtil.java:178`)。
- 字段在 XML 里但 `hidden='true'` → 仍建完整隐藏控件 + `addItemProperty` 后备值持有器 + `setVisible(false)` + `group.bind` + 参与提交(`:527-528,796-797,915-918`;提交 `grid/GridTemplateInsertWindow.java:259-266`)。
- **字段根本不在 XML 里(如 USER_ID 不在添加页 7a1bbdaf)→ 引擎完全无感知,FieldGroup/提交 Map 里都没有该 key**。该值只能由后端补齐。
**initvalue 应用(add 态核心)**:运行时在 `FormEngineUtil.binderProperties:178-287`,两阶段求值:
- 第一阶段(`:230-254`):若 `result` 含该 name(update 回填)→ `convertServerObj`;否则(典型 add)若 initvalue 是环境变量(`EnviromentGet.getCaptions().containsKey(initvalue)`)→ `getInitValueToString(EnviromentGet.get(initvalue))` → `convertTo` → 存 `initMap`。
- 第二阶段(`:255-284`):`AUTOGENERATECODE` 自动码,可引用一阶段 initMap。
- 求值后统一 `resetForm(group, initMap)` 写入控件(`:287`,赋值核心 `:944-945`)。
- 环境变量示例:`EnviromentGet.CURRENTUSER = "{CURRENTUSER}"`(`common/util/EnviromentGet.java:14`),解析 `EnviromentGet.get` 返回 `UserSession.get().getProperty(CURRENTUSER)`(`:35-36`)。**通知收藏/收藏类别页的 USER_ID 字段就用了 `initvalue="{CURRENTUSER}"`(view_page.copy:1,10)——但通知主实体的 USER_ID 拟稿人字段不在添加页 XML 里,此 token 路径对拟稿人不生效**(排除项,但说明引擎本有此能力)。
### EIP4 现状
- 前端是 **amis 表单**;表单 schema 由后端转换器 `TemplateToAmisConverter.convertForm` 从 view_page XML 生成(`platform-converter/.../TemplateToAmisConverter.java:626-690`):`form@pageid` → 查 `VIEW_PAGE.xml`(SQL `:1033`)→ 解析 `<fields>/<field>` → 逐字段 `UiTypeMapper.mapField(...)`(`:640`)。
- **uitype → amis 映射**(`UiTypeMapper.java`):`SelectDialog → select + source=/api/picker/{dialogid}/list?q=${term} + searchable`(`:124-136`,**非 amis picker**);`MultiSelectDialog → select(multiple,searchable)`(`:138-148`);`RichTextArea → input-rich-text`(`:63-68`);`hidden/required/readonly` 透传(`:46-55`)。人员选择无独立 person 控件,统一走 picker 端点路由到 `VIEW_SYS_USER`(PickerController)。
- 宽控件(rich-text/file/textarea/table)`colSize=full`,其余两栏横排(`:642-644,681-682`);提交 api 固定 `/api/entity/{table}/save`(`:679`);显式 `actions=[]` 消"双按钮"(`:688`)。
### 缺口 / 风险
- **风险 G1-1(initvalue/defaultvalue 不入 schema)**:`UiTypeMapper` 全文 grep 无 `initvalue`/`defaultvalue`/`value` 输出键(实查:UiTypeMapper.java 中 `initvalue|defaultvalue` 命中为 0)。即引擎本有的"字段初值(含 `{CURRENTUSER}`、自动码 `AUTOGENERATECODE`、字面默认值)"机制在 EIP4 转换器里**整体未迁移**。对通知拟稿人不直接致命(它本就不在添加页),但**全库任何依赖字段 initvalue 预填的页面在 EIP4 都会丢初值**——这是机制级缺口,不止通知。「推断」自动码/项目上下文只读(`CURRENTPROJECT`)等同样丢失。
- **风险 G1-2(隐藏字段语义)**:EIP3"XML 里有但 hidden"的字段在 EIP4 透传为 amis `hidden`(`UiTypeMapper.java:46-55`),语义保留;但"XML 里没有"的字段两边都不渲染,差异在后端补齐逻辑(见 §2)。
- **走样**:EIP3 SelectDialog 是真·弹窗选择器(SingleSelectField + dialog),EIP4 降级为 `select + 远程 source 搜索`(`UiTypeMapper.java:124-136` 注释自承"6.13 schema 未纳入 picker")。交互形态走样(下拉搜索 vs 弹窗多列表),近期 picker 补丁(commit d5c1236)只修了"显示列取姓名 + 孤儿用户路由",未恢复弹窗形态。
---
## 2. 默认值:add 态下哪些值被预置 + 拟稿人 USER_ID 到底谁设的
### 老系统怎么做(file:line)——默认值来源全清单(按实际生效排序)
**#1 serviceflow groovy 起始节点(拟稿人 USER_ID 的唯一真实来源,确凿)**
通知"添加"按钮绑定保存服务流。两条添加路径都在 start 节点 groovy 里设 USER_ID:
- `OA_NOTICEMANAGE_ADD`(sys_serviceflow.copy:27,script key `c697a669-...`):
```groovy
map.put("USER_ID", GetDefaultValueFunction.getCurrentUserId());
map.put("SAVETIME", GetDefaultValueFunction.currentDateTime());
if(map.get("NOTICECONTENT") == "") throw new ValidationException("内容是必填项");
```
- `OA_NOTICEMANAGE_ADD_AND_SUBMIT`(sys_serviceflow.copy:17,"保存并提交审批",script key `73ad08be-...`):
```groovy
map.put("USER_ID", GetDefaultValueFunction.getCurrentUserId());
map.put("SAVETIME", GetDefaultValueFunction.currentDateTime());
isSave = map.get("OA_NOTICEMANAGE_ID") == null;
if(isSave){ map.put("OA_NOTICEMANAGE_ID", GetDefaultValueFunction.guid()); }
```
之后 `save` 节点调 `pojoCRUDService.save`,再 `submitFlow` 节点调 `flowExcuteService.excute(..., OA_NOTICEMANAGE_SUBMIT)` 启动审批流。
- `GetDefaultValueFunction.getCurrentUserId()` → `return UserSession.get().getProperty(LoggedInUser.CURRENTUSER)`(`GetDefaultValueFunction.groovy:22-24`;`LoggedInUser.CURRENTUSER="CURRENTUSER"`)。
**#2 字段级 initvalue `{CURRENTUSER}` token(引擎机制,本字段未用)**
引擎支持字段 `initvalue="{CURRENTUSER}"` 自动取当前用户(`EnviromentGet.java:14,35-36`;客户端 `form/FormEngineUtil.java:230-250`)。兄弟实体在用(通知收藏/收藏类别 USER_ID,view_page.copy:1,10),但**通知主实体 USER_ID 不在添加页 XML → 不生效**。
**#3 元数据 defaultvalue(本字段空,不生效)**
拟稿人属性 `9c9ca3ae` 的 `defaultvalue/func/ruleid` 全空(DB 实查)。其他字段有:`ISACTIVE=1`、`ISDEL=0`、`ISSEND=0`、`VERSION=0`(DB 实查 RECORD 7/8/10/22)——这些由引擎 load 时套用。
**#4 引擎 setStandardDefaults(只填审计列,不填 USER_ID)**
`GeneralPO.setStandardDefaults()` 仅对 null 的系统列兜底:`CREATETIME/UPDATETIME ← now`、`CREATEBY/UPDATEBY ← ctx.CURRENTUSER`、`ISACTIVE←true`、`DEPARTID←ctx.CURRENTDEPART`、`ORGID←getOrgId`、`VERSION←0`、PK←NULL 哨兵(`GeneralPO.java:1518-1544`)。`SYSFIELD` 列表不含 USER_ID(`GeneralPOJO.SYSFIELD`)。
**#5 模板 onload 脚本(template e732c4b0,无 USER_ID 赋值)**
模板 3 段脚本(只读/按钮控制/查看只读)均不触及 USER_ID(详见 §3)。
**结论(最重要一条):拟稿人 USER_ID 在 add 时由保存服务流 `OA_NOTICEMANAGE_ADD`(或 `_ADD_AND_SUBMIT`)的起始 groovy 节点 `map.put("USER_ID", GetDefaultValueFunction.getCurrentUserId())` 显式设为当前登录用户(`UserSession.get().getProperty(CURRENTUSER)`),随后 `pojoCRUDService.save` 落库。并非字段 initvalue、元数据 defaultvalue、模板 onload 或引擎 setStandardDefaults 所为。** 这也解释了为何 USER_ID 不在添加页 XML 却仍被赋值——它在服务端 map 里补齐,前端无需展示。
### EIP4 现状
- 写端点 `EntityWriteController.save`(`platform-metadata/.../EntityWriteController.java:77-116`)收 amis 扁平 JSON,按主键有无分派:更新→`pojoCRUDService.update`(`:104`);**新增→先 `mandatoryUserColumnFiller.fillForInsert(t, normalized, ctx)`(`:108`),再 `pojoCRUDService.save`(`:109`)**。
- **EIP4 不执行任何写 serviceflow**:`EntityWriteController` 不引用 `FlowExcuteService`;serviceflow 引擎虽已回迁(`platform-legacy-core/.../FlowExcuteServiceImpl.java`、`GetDefaultValueFunction.java:42-44`),但只接到 `FlowController`(查询/搜索流),**写路径绕过 `OA_NOTICEMANAGE_ADD`**。
- 拟稿人改由通用 filler 实现:`MandatoryUserColumnFiller.fillForInsert`(`MandatoryUserColumnFiller.java:77-99`)对"必填的用户引用列"(SQL:`ismandatory=1` 且 `referenceid→SYS_REFERENCE→SYS_ENTITY.tablename∈{SYS_USER,VIEW_SYS_USER}`,排除 CREATEBY/UPDATEBY,`:110-122`)、**仅新增、仅缺失才填、绝不覆盖**地填 `ctx.CURRENTUSER`。这是**通用机制(全库 207 列/189 表),非通知专属硬编码**,OA_NOTICEMANAGE 仅 USER_ID 命中(类注释 `:41-44`)。
### 缺口 / 风险
- **风险 G2-1(最大:服务流被整体绕过,filler 只补了一个副作用)**:`OA_NOTICEMANAGE_ADD` 的 start 节点除了设 USER_ID,还做了 **(a) `SAVETIME=now`、(b) `NOTICECONTENT==""` 抛"内容是必填项"**。`_ADD_AND_SUBMIT` 还做 **(c) guid 生成、(d) 提交审批流 `OA_NOTICEMANAGE_SUBMIT`**。EIP4 的 `MandatoryUserColumnFiller` **只复刻了 USER_ID 这一条**(`MandatoryUserColumnFiller.java:91-98`),`SAVETIME`/`NOTICECONTENT 空串校验`/提交审批流在通用写路径**均未复刻**。
- SAVETIME「推断」可能由引擎 setStandardDefaults 漏填(它不在 SYSFIELD),导致 SAVETIME 为 null——需核实是否有业务依赖。
- "保存并提交"按钮的审批流启动是 EIP4 写端点完全没有的能力(只读切流阶段可能尚未涉及,但写阶段必须补)。
- **风险 G2-2(filler 与 serviceflow 语义等价性)**:filler 用 `ismandatory=1` 收口避免误伤可选用户列(指派人/审批人/接收人),语义"起草人=当前用户"。但 EIP3 serviceflow 是**逐实体精确编写**的;filler 是**全库通用规则**。对必填用户列恰好只有"起草人"语义的实体(如通知)等价;若某实体有多个必填用户列、或必填用户列语义不是"当前用户"(如"必填的审批人"),filler 会**误填当前用户**。这是通用化带来的过度泛化风险,需全库 207 列逐一核验语义。「推断」。
- **走样**:EIP3 拟稿人由"保存动作所属的那条 serviceflow"设,逻辑随按钮(添加 vs 添加并提交)而定且可携带去重/校验;EIP4 由统一前置 filler 设,与具体按钮/业务流解耦——机制更通用但**丢失了 serviceflow 里的业务校验与联动**(见 G2-1)。
---
## 3. 脚本:通知模板挂了哪些脚本,引擎何时跑,能改什么
### 老系统怎么做(file:line)
模板 `e732c4b0`(view_template.copy:3)`<crud>/<scripts>` 共 **3 条脚本**,经 `CRUDUtil.getViewScript()`(XPath `//crud/scripts/script`)读入(`grid/CRUDUtil.java:820-835`)。脚本本身无 type 属性,**类型由挂载点决定**:
| 脚本 id | 名称 | 挂载点 | 分类 | 改什么 |
|---|---|---|---|---|
| `2a753a3d` | 组件只读 | 「发送通知」按钮 `onloadscript` | onload | `group.getField("TITLE/IMPORTANT/DOCUMENT").setReadOnly(true)` + `NOTICECONTENT.setViewWithoutEditor(true)`——字段只读 |
| `a91535bd` | 按钮控制 | `<display onselectedscript>` | 行选中 | `if(item['STATUS']=="通过") enableButton("发送通知",true) else false`——**按钮启停(改不了字段)** |
| `d7a82532` | 查看时内容只读 | 「查看」按钮 `onloadscript` | onload | `NOTICECONTENT.setViewWithoutEditor(true)`——富文本去编辑器 |
**本模板无 field-onchange 脚本、无独立 validation 脚本、无过滤脚本**(所有 search/page 字段 `script=""`/`filterscript=""`;页面 `<scripts/>` 空)。
引擎三种执行时机(精确 hook):
- **onload**(表单/页面 attach 一次):`FormPageTemplateComponent.attach()` → `FormEngineUtil.excuteOnloadScript(ViewScript, FieldGroup)`(`page/FormPageTemplateComponent.java:255`、`form/FormEngineUtil.java:1034-1051`),绑定 `group`=FieldGroup,可 setReadOnly/setViewWithoutEditor。→ 脚本 A/C。
- **onselectedscript**(列表行选中):`TableItemSelectedListener.valueChange(...)`(`listener/TableItemSelectedListener.java:106-155`,调用 evaluateGroovy `:148`),绑定 `item`=选中行 map,facade `enableButton`(`:93-103`)。→ 脚本 B,**只能改按钮 enabled,没绑 group 改不了字段**。
- **field-onchange**(字段值变更,本模板未用):`DefaultVFVChangeListener.valueChange`(`listener/DefaultVFVChangeListener.java:82-107`),绑定 `group/po`,能改字段。仅当 field 有 `script` 属性时挂(`form/FormEngineUtil.java:919-922`)——通知字段 script 全空,不触发。
- **校验**:无 Groovy validation 机制,字段校验靠声明式 `required/minlength/maxlength`(Vaadin binder)。
### EIP4 现状(改写器 s3_rewriter 对照)
改写器 `tools/s3_rewriter/rewrite.py` 把脚本里裸 Vaadin 调用(`getField("X").setReadOnly(b)`)重写成 facade(`setFieldReadOnly("X",b)`),标 `FULL_AUTO/PARTIAL/HARD/NO_S3`(`rewrite.py:1-13`)。全量评测 1427 条:`NO_S3:815, FULL_AUTO:497, PARTIAL:30, HARD:85`,S3 自动化率 81.2%。
通知模板 `output/rewritten/e732c4b0-.../` 产出 3 文件,**3 条遗留脚本全部有迁移产物、无丢弃**:
| 产出 | label | 对应源脚本 | 改写后形态 |
|---|---|---|---|
| `1.FULL_AUTO.groovy` | FULL_AUTO | A(2a753a3d 组件只读) | `setFieldReadOnly("TITLE/IMPORTANT/DOCUMENT",true); setFieldViewOnly("NOTICECONTENT",true);` |
| `2.NO_S3.groovy` | NO_S3 | B(a91535bd 按钮控制) | 原样保留 `enableButton(...)`(已是 facade);**且比 1.0.17 install copy 多出 `文件归档/ISPLACE` 分支** |
| `3.FULL_AUTO.groovy` | FULL_AUTO | C(d7a82532 查看只读) | `setFieldViewOnly("NOTICECONTENT", true);` |
目标形态是**改写后 Groovy(S2 facade)**,不是 JS/amis onEvent/Java——只统一了 API 调用形态,留待下游 P4 platform-converter 继续转换。`20147656`(归档表单)产出 `setGroupReadOnly(true);`(整组只读),即脚本 B"文件归档"分支指向的配套模板。
### 缺口 / 风险
- **风险 G3-1(改写≠接线,脚本是否真在 EIP4 运行未验证)**:s3_rewriter 只产出"改写后的 Groovy 文本",**本文档证据链未见这些脚本在 EIP4 amis 运行时被实际加载/执行的接线点**。改写后的 onload/onselected 脚本要在 amis 端起作用,需要等价的"页面 attach 跑 onload""行选中跑 onselected"hook——这部分在 EIP4 是否落地、facade(`setFieldReadOnly`/`enableButton`/`setFieldViewOnly`)在 amis 上的运行时实现是否存在,**需另行验证**。「推断」当前只读切流阶段可能尚未接通脚本运行时。
- **风险 G3-2(改写器输入是生产 DB dump 而非 install copy,版本漂移)**:产出 `2.NO_S3.groovy` 含 install copy 没有的 `文件归档/ISPLACE` 逻辑,说明改写器输入是 `scripts_cache.json`(生产库 dump,`dump_db_scripts.py`),与本仓 1.0.17 安装包版本不一致。**以生产实际行为为准时,脚本 B 还联动控制"文件归档"按钮**——迁移验证必须以生产脚本为基线,不能只看 install copy。「推断」。
---
## 4. 校验:必填在引擎哪里触发,save 前还有哪些校验
### 老系统怎么做(file:line)
"拟稿人必填"的保障实际由**多重机制**叠加,而非单一 metadata `ismandatory`:
1. **serviceflow groovy 显式设值 + 空串校验**:`OA_NOTICEMANAGE_ADD` start 节点先 `map.put("USER_ID", ...)`(故 save 时 USER_ID 已非空,必填永不触发),并 `NOTICECONTENT==""` 抛 `ValidationException("内容是必填项")`(注意只挡空串 `""`,不挡 null/缺键)(sys_serviceflow.copy:27)。
2. **引擎元数据必填循环**:`GeneralPO.set_Value(int,Object)` 在值为 null 且 `p_info.isColumnMandatory(index)` 时抛 `IllegalArgumentException("<label>是必填项")`(`GeneralPO.java:833-837`);`POInfo.validate` 返回同消息(`POInfo.java:775-777`);`isColumnMandatory ← m_columns[index].IsMandatory ← rs.getInt(4)>0`(`POInfo.java:558-563,136`)。另有 `isMandatoryOK()` 循环(`GeneralPO.java:1571-1583`)但**在 save 路径是死代码**(saveNew/save_convertToSql 不调它)。
3. **DB NOT NULL**:`3-OA_NOTICEMANAGE.sql:34` `user_id character(36) NOT NULL`(及 title/noticecontent/important NOT NULL)。
- **拟稿人 USER_ID 的必填永不触发引擎报错**:groovy 在 save 前已填 USER_ID(`POJOCRUDServiceImpl.java:419-423`)。「推断」本实体 `sys_entityattribute` 的 USER_ID ismandatory 在 `.copy` dump 中读 0(列序解读),即便引擎循环也不会拦;真正保障是 groovy 填值 + DB NOT NULL。
save 前完整校验序(按钮点击 → INSERT):
1. groovy start 校验(USER_ID/SAVETIME 设值、NOTICECONTENT 空串校验)。
2. `new GeneralPO(tableName, map, ctx)` 类型强转,失败抛 `ValidationException("加载数据异常...")`(`GeneralPO.java:273-325`)。
3. `setStandardDefaults()` + `loadDefaults()`(`:1518-1544,1468-1513`)。
4. `beforeSave`(`POJOServiceImpl.java:671-754`):identifier 唯一性(`:694,707-709`)、combidentifier 唯一性(`:712-751`)、`Rule.BEFORESAVE` 实体规则(`:752`,但 `sys_rule.copy` 为 0 字节 → **无业务规则**)。
5. 逐列长度/min-max/引用存在性 `POInfo.validateValue`(`POJOServiceImpl.java:407-415`、`POInfo.java:841-866`)。
6. **数据权限 filterrule:save 不触发**——`POJOCRUDServiceImpl.save` 只有 `//FIXME: 数据权限` 注释(`:420`),`dataPrivilegeService` 从不在写路径调用。filterrule 仅查询时套(`DataPrivilegeServiceImpl.getWhereClause:35-66`,从 `listSelectSpecialCol:113-116`/`searchTreeStru:377-378` 调,ADMIN 跳过)。通知 filterrule 是 `USER_ID={CURRENTUSERID}`(sys_filterrule.copy:row2),即"只看自己拟稿的通知",**行级读过滤,不影响保存**。
### EIP4 现状
- 引擎 `POJOCRUDServiceImpl/POJOServiceImpl/GeneralPO/POInfo` 已原样回迁至 `platform-legacy-core/.../dataDic/`,`setStandardDefaults`(`GeneralPO.java:1518`)、必填校验(`:834-836`)、`beforeSave`/唯一性/长度校验**机制完整且实际生效**(filler 正是为绕过必填校验而存在)。
- 写侧数据权限改由上层接管:`EntityWriteController` 更新场景查 `SYS_FILTERRULE` 判行可写(`EntityWriteController.java:94-96`、`WritePrivilegeChecker`),新增无行可查则跳过——比 EIP3(写不查权限)**更严**。
### 缺口 / 风险
- **风险 G4-1(NOTICECONTENT 空串校验丢失)**:EIP3 groovy 的 `NOTICECONTENT==""` 校验在 EIP4 通用写路径无对应物。NOTICECONTENT 是 `ismandatory=1`(DB RECORD 11),引擎必填循环会挡 **null**,但 **挡不住空串 `""`**(引擎判 null 不判空串,`GeneralPO.java:834`)。EIP4 若 amis 提交空串富文本,引擎可能放行 → 落库空内容。需核实 amis 富文本空值提交形态(null vs "")。「推断」。
- **风险 G4-2(业务校验/去重逻辑随 serviceflow 丢失)**:通知主表本身 `sys_rule` 为空、无 BEFORESAVE 业务规则,这点 EIP4 无损;但兄弟流(收藏 `OA_NOTICECOLLECTION_ADD` 的"重复收藏"校验、`OA_NOTICECOLLECTIONTYPE_ADD` 的"类别名重复"校验)是写在 serviceflow groovy 里的(sys_serviceflow.copy:2,11)。一旦这些实体也走 EIP4 通用写端点,**这些 SQL 级业务校验全部丢失**。通知 add 本身不含此类,但同模块迁移时是普遍风险。
- **忠实保留**:引擎层必填/类型/长度/唯一性/引用存在性校验在 EIP4 完整保留(回迁原码)。
---
## 5. 保存落库:save 按钮 → 服务 → POJOCRUDServiceImpl.save 完整步骤
### 老系统怎么做(file:line)
`OA_NOTICEMANAGE_ADD` 的 `save` 节点 → `pojoCRUDService.save(map, tableName, ctx)`:
1. `POJOCRUDServiceImpl.save`(`:419-424`):`new GeneralPO(tableName, map, ctx)` + `pojoService.save(po, currentUser)`。
2. `GeneralPO` 构造 `load(map)`(`GeneralPO.java:273-325`)逐列从 map 取值强转入 `m_oldValues[]`;LIST 列经 `decrypt()`(`:327-397`)。
3. `setStandardDefaults()`(`:1518-1544`):仅填 null 的 `CREATETIME/UPDATETIME←now`、`CREATEBY/UPDATEBY←ctx.CURRENTUSER`、`ISACTIVE←true`、`DEPARTID←ctx.CURRENTDEPART`、`ORGID←getOrgId`、`VERSION←0`、PK←NULL 哨兵。`isdel/issend` 不在 map → INSERT 时跳过 → DB 默认 0。
4. `POJOServiceImpl.save → saveNew → save_convertToSql`(`:373-388,390-530`)建 INSERT:PK 空则生成 UUID(`:400-403`)、null 非 VERSION 列跳过(`:434-436`)、LOB→`saveAttachments`(`:444-452`)、Boolean→1/0(`:477-483`)、DateTime→millis(`:484-486`)。
5. **子表 OA_NOTICEMANAGEPEOPLE(接收人)= LIST 列中间表写,非独立 serviceflow 节点**:`NOTICEDRAFTPEOPLES` 是 LIST 列,`referencevalue=1810fa76` → `sys_referencevalue.copy:1` → 列 `MANAGEID`(`8d0bd495`)of 实体 `91e2c2fb`=OA_NOTICEMANAGEPEOPLE(MIDTABLE,tabletype=2)。`save_convertToSql` 遇 List 列且 `tableType==MIDTABLE` 调 `processMidList(...)`(`POJOServiceImpl.java:496-507,635-650`):`foreignKey=MANAGEID, other=USER_ID`,对每个接收人 id 生成 `INSERT INTO OA_NOTICEMANAGEPEOPLE(MANAGEID,USER_ID) VALUES('<noticeId>','<receiverId>')`,与父 INSERT 拼成一个多语句批一次 `jdbcTemplate.execute`(`:384,522-528`),全程 `@Transactional`。
6. **SYS_DATASTATUS/状态**:`OA_NOTICEMANAGE` 表**无 STATUS/DATASTATUS 列**(`3-OA_NOTICEMANAGE.sql`),状态在独立 `SYS_DATASTATUS` 表(按 TABLENAME+BUSINESSKEY),仅**读时 LEFT JOIN**(`POInfo.java:370-371,902,964-965`)。**add 流不写 SYS_DATASTATUS**;无记录时读出 NULL,`GeneralPO.load` 默认显示为 `1`("未提交")(`GeneralPO.java:220-225`)。SYS_DATASTATUS 由审批流(`OA_NOTICEMANAGE_SUBMIT`)写,不由 add 写。
7. `finishSave → Rule.AFTERSAVE`(空规则,无操作)+ `dataOperatorLog.insertData`(审计日志)(`:385-386`)。
### EIP4 现状
- 写端点直接调 `pojoCRUDService.save`(`EntityWriteController.java:109`),保存核心 `POJOCRUDServiceImpl.save`(`platform-legacy-core/.../POJOCRUDServiceImpl.java:419`)、`setStandardDefaults`、UUID 生成、Boolean/DateTime 转换**原样回迁生效**。
- **子表 OA_NOTICEMANAGEPEOPLE 写逻辑完整**:`POJOServiceImpl.save_convertToSql` 对 MIDTABLE 调 `processMidList`(`POJOServiceImpl.java:502-503,635`;更新侧 `updateMidTable→processMidList :976-995`)——接收人/NOTICEDRAFTPEOPLES 中间表写在 EIP4 写路径**被调用,未绕过**。
- SYS_DATASTATUS 读时 JOIN、add 不写状态——回迁原码,行为一致。
### 缺口 / 风险
- **风险 G5-1(SAVETIME 不被填)**:EIP3 serviceflow 设 `SAVETIME=now`,但 SAVETIME 不在引擎 SYSFIELD,`setStandardDefaults` 不填,EIP4 filler 也不填 → **EIP4 新增通知 SAVETIME 为 null**。需确认有无业务/列表展示依赖 SAVETIME。「推断」。
- **风险 G5-2(审批流启动缺失)**:EIP3"保存并提交"经 `_ADD_AND_SUBMIT` 的 `submitFlow` 节点启动 `OA_NOTICEMANAGE_SUBMIT` 审批流(sys_serviceflow.copy:17)。EIP4 通用写端点只 save,**不启动审批流**——"保存并提交审批"按钮的完整语义在 EIP4 写阶段尚未实现。
- **忠实保留**:父表 INSERT、子表中间表写、标准列填充、UUID、SYS_DATASTATUS 读时 JOIN 等核心落库机制因回迁原码而忠实保留。
---
## 6. 逐步对照:现代忠实保留 / 丢失走样 / 打补丁式临时修
近期 5 处修复均 git 标记 `F2-17根因`(自述"根因"非"打补丁"),通知页是**试点**(`git log`:f5850a8/d5c1236/37db794/e66480d/895ed54):
| 修复 | 实现 | 性质 | 证据 |
|---|---|---|---|
| 分页 | `FlowController.applyPaging`:amis `page/perPage` → 引擎 `PAGE_START/PAGE_SIZE`,仅显式带才翻译 | **机制级·通用**(所有合成搜索流) | commit f5850a8;`FlowController.java:101-122` |
| picker/选人 | `PickerController`:显示列优先 `isentitydisplay=1`(VIEW_SYS_USER.DISPLAYNAME);孤儿模板按 name 路由 VIEW_SYS_USER | **机制级·通用**(覆盖 244 dialogid) | commit d5c1236 |
| 富文本 | `UiTypeMapper`:`RichTextArea→input-rich-text` | **机制级·通用**(uitype 全集,16 处) | commit 37db794;`UiTypeMapper.java:63-68` |
| 人员列 | `UserColumnResolver`:列表人员列 id→姓名(568 列/385 实体) | **机制级·通用**(全库扫描) | commit e66480d |
| 拟稿人 filler | `MandatoryUserColumnFiller.fillForInsert`:必填用户列新增填当前用户(207 列/189 表) | **机制级·通用·但泛化过度风险**(见 G2-2) | `MandatoryUserColumnFiller.java:41-44,77-99` |
`platform-converter`/`platform-legacy-core` 的 `TODO/FIXME/HACK` 全是回迁旧代码自带的历史注释,**无一处为通知页临时硬编码 workaround**;`eip4-web/src` grep 不到 noticemanage/拟稿人/NOTICEDRAFTPEOPLES——**前端无通知专属代码,全靠后端元数据驱动**。
**总体判断**:5 处修复设计意图是机制级、通用、元数据驱动的(以全库列数为证),不是窄修。**但"通用 filler 替代逐实体 serviceflow"这一架构选择本身带来 G2-1/G2-2 风险**:filler 只复刻了 serviceflow 的一个副作用(USER_ID),把 serviceflow 里其余的设值(SAVETIME)、业务校验(NOTICECONTENT 空串、去重)、流程联动(审批流启动)都留在了缺口里。这不是"补丁式临时修",而是"机制替换尚不完整"——通用机制覆盖了字段填充,未覆盖业务流程。
---
## 通知 add → save 机制对照表
| # | 步骤 | 老系统 EIP3(file:line) | 新系统 EIP4(file:line) | 状态 |
|---|---|---|---|---|
| 1 | 添加入口 | grid 按钮 `buttonClick→createInsertWindow`(GridTemplateComponent.java:710,1229) | amis 表单(转换器生成,TemplateToAmisConverter.java:626) | 走样(整页换入→amis dialog) |
| 2 | 字段来源 | view_page XML `//page/fields/field`(FormPageTemplateUtil.java:104) | 同 view_page XML(TemplateToAmisConverter.java:634,1033) | 忠实 |
| 3 | uitype 渲染 | elementFieldConvertToUI 大 if-else→Vaadin 控件(FormEngineUtil.java:468) | UiTypeMapper→amis 控件(UiTypeMapper.java:36) | 走样(SelectDialog 弹窗→select 搜索) |
| 4 | 隐藏字段(XML 有 hidden) | 建隐藏控件+后备值+提交(FormEngineUtil.java:915-918) | 透传 amis hidden(UiTypeMapper.java:46-55) | 忠实 |
| 5 | 缺席字段(USER_ID 不在添加页) | 引擎无感知,后端补(view_page.copy:3) | 引擎无感知,后端 filler 补(EntityWriteController.java:108) | 机制不同但等效 |
| 6 | 字段 initvalue | binderProperties 两阶段+resetForm(FormEngineUtil.java:230-287) | **未迁移**(UiTypeMapper 无 initvalue 键) | **丢失** |
| 7 | **拟稿人 USER_ID 赋值** | **serviceflow groovy `getCurrentUserId()`**(sys_serviceflow.copy:27) | **MandatoryUserColumnFiller.fillForInsert**(MandatoryUserColumnFiller.java:91-98) | 机制不同,等效(泛化风险 G2-2) |
| 8 | SAVETIME 赋值 | serviceflow groovy `currentDateTime()`(sys_serviceflow.copy:27) | **未复刻**(不在 SYSFIELD/filler) | **丢失**(G5-1) |
| 9 | guid/PK 生成 | _ADD_AND_SUBMIT groovy guid / 引擎 saveNew UUID(POJOServiceImpl.java:400) | 引擎 saveNew UUID(回迁) | 忠实 |
| 10 | NOTICECONTENT 空串校验 | serviceflow groovy `=="" throw`(sys_serviceflow.copy:27) | **未复刻**(引擎只挡 null 不挡 "") | **丢失**(G4-1) |
| 11 | 必填校验(引擎) | GeneralPO.set_Value(GeneralPO.java:834) | 同(回迁) | 忠实 |
| 12 | 标准列填充 | setStandardDefaults CREATEBY/TIME/ORGID/VERSION(GeneralPO.java:1518) | 同(回迁) | 忠实 |
| 13 | 父表 INSERT | save_convertToSql(POJOServiceImpl.java:390) | 同(回迁) | 忠实 |
| 14 | 子表接收人(OA_NOTICEMANAGEPEOPLE) | LIST 中间表 processMidList(POJOServiceImpl.java:635) | 同(回迁,被调用) | 忠实 |
| 15 | SYS_DATASTATUS/状态 | add 不写,读时 JOIN,默认显示 1(GeneralPO.java:220) | 同(回迁) | 忠实 |
| 16 | 模板脚本(onload/按钮控制) | 3 脚本经 excuteOnloadScript/TableItemSelectedListener(FormEngineUtil.java:1034) | s3_rewriter 改写为 facade Groovy(rewritten/e732c4b0) | **改写已做,运行时接线未验证**(G3-1) |
| 17 | 数据权限 filterrule | 仅查询时套,save 不查(DataPrivilegeServiceImpl.java:35) | 写时查 SYS_FILTERRULE(更新场景)(EntityWriteController.java:94) | EIP4 更严 |
| 18 | 保存并提交审批 | _ADD_AND_SUBMIT submitFlow 启 OA_NOTICEMANAGE_SUBMIT(sys_serviceflow.copy:17) | **未实现** | **丢失**(G5-2) |
---
## 附:核心论断的可复核证据锚点
- 拟稿人 USER_ID 设值:`/Users/zhengwr/workspace/EIP-3.0/oa/trunck/com.dsasp.oa.noticemanage/META-INF/sql/install/1.0.17/sys_serviceflow.copy` 第 27 行(`OA_NOTICEMANAGE_ADD`)与第 17 行(`OA_NOTICEMANAGE_ADD_AND_SUBMIT`)。
- `getCurrentUserId`:`framework/com.dsasp.server.common/src/com/dsasp/server/common/function/GetDefaultValueFunction.groovy:22-24`。
- EIP4 写端点 + filler:`eip4-platform/platform-metadata/src/main/java/com/eip4/platform/metadata/web/EntityWriteController.java:108-109`、`.../write/MandatoryUserColumnFiller.java:77-99,110-122`。
- 转换器无 initvalue:`eip4-platform/platform-converter/src/main/java/com/eip4/platform/converter/UiTypeMapper.java`(grep `initvalue|defaultvalue` = 0 命中)。
- 拟稿人元数据(DB 实查):`eip3.sys_entityattribute` where `sys_entityattribute_id='9c9ca3ae-406d-4733-a2d4-1f57608c042d'`(ismandatory=1,defaultvalue/func/ruleid 空)。