- 从工作区根 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
通知管理「添加 → 保存」流程:老系统(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_entityattributeRECORD 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:
- 建添加按钮:
GridTemplateComponent遍历crud/buttoninsert 节点生成按钮并挂buttonClick(grid/GridTemplateComponent.java:681-723)。 - 点击 → createInsertWindow:
buttonClick调createInsertWindow(insertroot, crudUtil),再setCompositionRoot(...)把表单整页换入(非弹窗)(:710-711)。 - 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)。 - GridTemplateInsertWindow 分叉:
init()→buildMainLayout()→ 若rootMap.get("pageid")!=null走createFormPage()(view_page XML 路径,通知添加走这条),否则bindFields()(内联 field)(grid/GridTemplateInsertWindow.java:89-112,分叉:102-106)。 - createFormPage:
PageService.getTemplateXML(pageId)取 view_page XML →new FormPageTemplateComponent(pageXml, entity, pageId)→getFieldGroup()(:181-206)。 - 真正建表单:
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 补丁(commitd5c1236)只修了"显示列取姓名 + 孤儿用户路由",未恢复弹窗形态。
2. 默认值:add 态下哪些值被预置 + 拟稿人 USER_ID 到底谁设的
老系统怎么做(file:line)——默认值来源全清单(按实际生效排序)
#1 serviceflow groovy 起始节点(拟稿人 USER_ID 的唯一真实来源,确凿) 通知"添加"按钮绑定保存服务流。两条添加路径都在 start 节点 groovy 里设 USER_ID:
OA_NOTICEMANAGE_ADD(sys_serviceflow.copy:27,script keyc697a669-...):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 key73ad08be-...):之后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,facadeenableButton(: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:
- serviceflow groovy 显式设值 + 空串校验:
OA_NOTICEMANAGE_ADDstart 节点先map.put("USER_ID", ...)(故 save 时 USER_ID 已非空,必填永不触发),并NOTICECONTENT==""抛ValidationException("内容是必填项")(注意只挡空串"",不挡 null/缺键)(sys_serviceflow.copy:27)。 - 引擎元数据必填循环:
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 不调它)。 - DB NOT NULL:
3-OA_NOTICEMANAGE.sql:34user_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 在.copydump 中读 0(列序解读),即便引擎循环也不会拦;真正保障是 groovy 填值 + DB NOT NULL。
save 前完整校验序(按钮点击 → INSERT):
- groovy start 校验(USER_ID/SAVETIME 设值、NOTICECONTENT 空串校验)。
new GeneralPO(tableName, map, ctx)类型强转,失败抛ValidationException("加载数据异常...")(GeneralPO.java:273-325)。setStandardDefaults()+loadDefaults()(:1518-1544,1468-1513)。beforeSave(POJOServiceImpl.java:671-754):identifier 唯一性(:694,707-709)、combidentifier 唯一性(:712-751)、Rule.BEFORESAVE实体规则(:752,但sys_rule.copy为 0 字节 → 无业务规则)。- 逐列长度/min-max/引用存在性
POInfo.validateValue(POJOServiceImpl.java:407-415、POInfo.java:841-866)。 - 数据权限 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):
POJOCRUDServiceImpl.save(:419-424):new GeneralPO(tableName, map, ctx)+pojoService.save(po, currentUser)。GeneralPO构造load(map)(GeneralPO.java:273-325)逐列从 map 取值强转入m_oldValues[];LIST 列经decrypt()(:327-397)。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。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)。- 子表 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。 - 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 写。 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(grepinitvalue|defaultvalue= 0 命中)。 - 拟稿人元数据(DB 实查):
eip3.sys_entityattributewheresys_entityattribute_id='9c9ca3ae-406d-4733-a2d4-1f57608c042d'(ismandatory=1,defaultvalue/func/ruleid 空)。