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

34 KiB
Raw Blame History

通知管理「添加 → 保存」流程:老系统(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-...):
    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-...):
    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 空)。