docs: 统一项目文档进 eip4-platform/docs + 新增进度路线总览
Some checks failed
ci / build-test-parity (push) Has been cancelled
Some checks failed
ci / build-test-parity (push) Has been cancelled
- 从工作区根 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>
This commit is contained in:
277
docs/研究/通知保存流程-老vs新-机制trace.md
Normal file
277
docs/研究/通知保存流程-老vs新-机制trace.md
Normal file
@@ -0,0 +1,277 @@
|
||||
# 通知管理「添加 → 保存」流程:老系统(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 空)。
|
||||
Reference in New Issue
Block a user