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:
219
docs/研究/按钮与保存-服务流分派机制.md
Normal file
219
docs/研究/按钮与保存-服务流分派机制.md
Normal file
@@ -0,0 +1,219 @@
|
||||
# EIP3 按钮 / 保存 → 服务流派发机制(只读研究)
|
||||
|
||||
> 目的:搞清老通用低代码引擎如何把【按钮点击】和【保存】派发到具体【服务流】,作为 EIP4「写/动作路径走服务流」转换设计的依据。
|
||||
> 纪律:每条论断给 `file:line` 或 DB 证据;推断明确标注「推断」。
|
||||
|
||||
---
|
||||
|
||||
## 0. 一句话结论(最重要)
|
||||
|
||||
**派发不是命名约定,而是显式绑定。** 每个 CRUD 按钮在 `view_template.xml` 里都带一个或多个 `<method servicename="…"/>` 子元素,`servicename` 的值(如 `OA_NOTICEMANAGE_ADD`)**就是 `sys_serviceflow` 表的主键 `sys_serviceflow_id`**。运行时引擎用这个名字按主键直接 `loadPOJO` 出服务流定义并执行。`{TABLE}_{ADD/UPDATE/DELETE/SEARCH}` 只是**人起的命名习惯**,引擎不靠它推断——靠的是 XML 里写死的 `servicename`。
|
||||
|
||||
起点事实里「按钮无 servicename/serviceid 属性」是对的,但只对**按钮元素的属性**成立;`servicename` 藏在按钮的**子元素 `<method>`** 上。这是之前误判的根因。
|
||||
|
||||
---
|
||||
|
||||
## 1. 按钮 → 服务流的确切派发约定
|
||||
|
||||
### 1.1 数据形态(DB 实测)
|
||||
|
||||
通知管理 crud `e732c4b0-2402-4e73-8cc4-786c8a8c52af` 的 XML 存在 `eip3.view_template.xml` 列(`view_template` 表结构:`view_template_id, name, type, xml, engineclass…`,DB `\d view_template`)。该行 `name=通知管理, type=1, engineclass=空`。
|
||||
|
||||
实测 XML 的按钮节点(`psql … SELECT xml FROM view_template WHERE view_template_id='e732c4b0…'`):
|
||||
|
||||
| 按钮 name | button @type | button @id(节选) | `<method>` 子元素 servicename |
|
||||
|---|---|---|---|
|
||||
| 添加 | insert | 478f950e… | **保存**→`OA_NOTICEMANAGE_ADD`;**保存并提交审批**→`OA_NOTICEMANAGE_ADD_AND_SUBMIT` |
|
||||
| 修改 | update | 6e5b803c… | load→`OA_NOTICEMANAGE_LOAD`;**保存**→`OA_NOTICEMANAGE_UPDATE`;**保存并提交审批**→`OA_NOTICEMANAGE_ADD_AND_SUBMIT` |
|
||||
| 删除 | delete | 61c64168… | `OA_NOTICEMANAGE_DELETE` |
|
||||
| 查看 | read | b229add5…(onloadscript=d7a82532) | `OA_NOTICEMANAGE_LOAD` |
|
||||
| 实际接收对象 | read | 6ec34d40… | `OA_NOTICEMANAGE_LOAD` |
|
||||
| 发送通知 | update | e62f1594…(onloadscript=2a753a3d) | load→`OA_NOTICEMANAGE_LOAD_SENDNOTICE`;**发送**→`OA_NOTICEMANAGE_PUBLISH` |
|
||||
| 文件归档 | delete | 5f15dbfe… | `OA_NOTICEMANAGE_UPDATE_AC` |
|
||||
| 提交审批 | delete | b3c01de2… | `OA_NOTICEMANAGE_SUBMIT` |
|
||||
|
||||
关键 XML 形态(实测):
|
||||
```xml
|
||||
<button id="478f950e-…" type="insert" name="添加" pageid="7a1bbdaf-…" …>
|
||||
<method name="保存" servicename="OA_NOTICEMANAGE_ADD" successmsg="保存成功!"/>
|
||||
<method name="保存并提交审批" servicename="OA_NOTICEMANAGE_ADD_AND_SUBMIT" successmsg="保存成功!"/>
|
||||
</button>
|
||||
<button id="6e5b803c-…" type="update" name="修改" pageid="7a1bbdaf-…" …>
|
||||
<method servicename="OA_NOTICEMANAGE_LOAD"/> <!-- 加载(前置 load) -->
|
||||
<method name="保存" servicename="OA_NOTICEMANAGE_UPDATE" successmsg="保存成功!"/>
|
||||
<method name="保存并提交审批" servicename="OA_NOTICEMANAGE_ADD_AND_SUBMIT" successmsg="保存成功!"/>
|
||||
</button>
|
||||
```
|
||||
(注:`修改`/`发送通知` 等 update/read 按钮的第一个 `<method>` 无 `name`,是**前置加载流**;带 `name` 的是表单页底部的**保存/动作按钮**。`删除`/`文件归档`/`提交审批` 仅一个 `<method>`,列表页点击即执行,无表单页。)
|
||||
|
||||
### 1.2 解析路径(源码逐跳)
|
||||
|
||||
1. **XML→对象**:`GridTemplateConverter.convertXmlToGridTemplate` 逐个 `<button>` 调 `ToolButtonUtil.createToolButtonByElement`
|
||||
- `framework/com.dsasp.client.viewFramework/.../grid/GridTemplateConverter.java:139-144`
|
||||
2. **`<method>`→服务名**:`ToolButtonUtil` 把每个 `<method>` 转成一个 `EditFormButton`,`servicename` → `EditFormButton.excuteservice`,`name`/`successmsg`/`icon` 一并带上;首个 `load/method` 的 servicename 作为前置 `beforeService`
|
||||
- `framework/com.dsasp.client.viewFramework/.../util/ToolButtonUtil.java:25-55`(`saveService = method.attributeValue("servicename")`;`new EditFormButton(name, icon, excuteservice)`)
|
||||
3. **按钮 id→服务名(运行时分派表)**:`CRUDUtil`(grid 包)从 XML 用 XPath 按 `@type` + `@id` 取 `<method>/@servicename`:
|
||||
- `getInsertMethod(id)` → `//crud/button[@type='insert'][@id='…']/method/@servicename` —— `grid/CRUDUtil.java:738-745`
|
||||
- `getUpdateMethod(id)` → `…[@type='update']…` —— `:756-763`
|
||||
- `getDeleteMethod(id)` → `…[@type='delete']…` —— `:774-781`
|
||||
- `getSelectMethod(id)` / `getSelectLoadMethod` / `getInsertLoadMethod` / `getUpdateLoadMethod` 同理 —— `:783-800, 747-754, 765-772`
|
||||
- `getSearchMethod()` 特殊:取 `//crud/display/@selectservice`(列表查询服务挂在 display 根属性上,不是按钮)—— `grid/CRUDUtil.java:725-728`
|
||||
- `getMethodsByButtonId(id)`:返回该按钮**全部** `<method>` 的 servicename 列表(多保存按钮场景)—— `grid/CRUDUtil.java:859-869`
|
||||
4. **按钮渲染 + onClick**:`GridTemplateComponent` 为每个 insert/update/delete 按钮建 Vaadin Button,`button.setId(buttonId)`,onClick 里:
|
||||
- insert:`createButtonUseMoreServ(label, icon, crudUtil.getMethodsByButtonId(insertid), listener)`,点击打开表单页 `GridTemplateInsertWindow` —— `grid/GridTemplateComponent.java:679-739`
|
||||
- update:同上,先校验「选中一条」,再打开表单页 —— `:745-826`
|
||||
- delete:`createButton(label, icon, crudUtil.getDeleteMethod(deleteid), listener)`,点击(可选确认框)后直接 `deleteExcute(deleteid)` —— `:831-922`
|
||||
5. **真正执行**:`ViewEngineActionUtil.excuteService(param, serviceName)` →
|
||||
`flowExcuteService.excute(param, UserSession.get(), serviceName)`
|
||||
- `framework/com.dsasp.client.viewFramework/.../component/ViewEngineActionUtil.java:165-181`
|
||||
- delete 直接执行点:`GridTemplateComponent.java:927, 950`(`ViewEngineActionUtil.excuteService(param, crudUtil.getDeleteMethod(deleteid))`)
|
||||
|
||||
### 1.3 「提交审批」vs「文件归档」如何区分(关键难点)
|
||||
|
||||
两者 `@type` 都是 `delete`,但 **`@id` 不同,各自挂不同的 `<method servicename>`**:
|
||||
- 文件归档 `id=5f15dbfe…` → `OA_NOTICEMANAGE_UPDATE_AC`(XML 实测)
|
||||
- 提交审批 `id=b3c01de2…` → `OA_NOTICEMANAGE_SUBMIT`(XML 实测)
|
||||
|
||||
`GridTemplateComponent.bindingDataDelete()` 对每个 delete 按钮按其 `deleteid` 调 `crudUtil.getDeleteMethod(deleteid)`(`grid/CRUDUtil.java:774` 的 XPath 带 `[@id='…']`),所以两个同 type 的按钮各自解析到自己的服务流。**区分键是 button @id,不是 name、不是 view_template_service、不是 onloadscript。** (name 仅用于显示和「服务控制」匹配,见 §1.4。)
|
||||
|
||||
注意一个反直觉点:**两个 delete 按钮实际都不是删数据**——文件归档走 `_UPDATE_AC`(发送归档=改状态)、提交审批走 `_SUBMIT`(改流程状态)。`type=delete` 在这里只决定**渲染成列表页工具按钮 + 可选确认框 + 点击即执行**这套交互形态,与服务流真实语义无关。**推断**:老系统设计者把「列表行上点一下就触发、不开表单页」的动作一律塞进 `delete` 类型复用其交互骨架。
|
||||
|
||||
### 1.4 旁路:服务控制(自动前置流,非主线)
|
||||
|
||||
`GridTemplateComponent` 各按钮 onClick 里有 `controlMap` 分支:若按 `buttonName` 命中 `SYS_TEMPLATECONTROL_BUTTON`,会先 `GetServicesFunction.excuteFlow(map, flowId)` 跑控制流(`GridTemplateComponent.java:653-665, 700, 776, 864`)。引擎侧 `FlowExcuteServiceImpl.checkControl` 也会按 `SYS_TEMPLATECONTROL` 自动链式执行 `iscontrol` 控制流(`FlowExcuteServiceImpl.java:104-135`)。**通知模块未实测到 button 控制配置,EIP4 转换初期可忽略,但需登记为未知项(见 §5)。**
|
||||
|
||||
---
|
||||
|
||||
## 2. 服务流 servicename 的存储与解析
|
||||
|
||||
### 2.1 存储:servicename = sys_serviceflow 主键
|
||||
|
||||
`sys_serviceflow` 表结构(DB `\d sys_serviceflow`):
|
||||
`sys_serviceflow_id(PK, varchar200), displayname, contentxml(xml), entityid, iscontrol, isactive, isupdateable …`
|
||||
|
||||
**`sys_serviceflow_id` 存的就是 `OA_NOTICEMANAGE_ADD` 这种可读名字(不是 UUID)。** DB 实测(`SELECT sys_serviceflow_id, displayname, iscontrol FROM sys_serviceflow WHERE sys_serviceflow_id ILIKE 'OA_NOTICEMANAGE%'`)15 行全部命中,节选:
|
||||
|
||||
| sys_serviceflow_id | displayname | iscontrol |
|
||||
|---|---|---|
|
||||
| OA_NOTICEMANAGE_ADD | 通知管理新增 | 1 |
|
||||
| OA_NOTICEMANAGE_ADD_AND_SUBMIT | 通知管理保存并提交审批 | 1 |
|
||||
| OA_NOTICEMANAGE_UPDATE | 通知管理更新 | 1 |
|
||||
| OA_NOTICEMANAGE_DELETE | 通知管理删除 | 1 |
|
||||
| OA_NOTICEMANAGE_LOAD | 通知管理加载 | 0 |
|
||||
| OA_NOTICEMANAGE_SEARCH | 通知管理查询 | 0 |
|
||||
| OA_NOTICEMANAGE_PUBLISH | 发送通知 | 1 |
|
||||
| OA_NOTICEMANAGE_UPDATE_AC | 通知管理-发送归档 | 1 |
|
||||
| OA_NOTICEMANAGE_SUBMIT | 通知管理-提交审批 | 1 |
|
||||
| OA_NOTICEMANAGE_LOAD_SENDNOTICE | 通知管理-发送通知加载 | 0 |
|
||||
|
||||
§1.1 表里 8 个按钮引用的 9 个 servicename **逐一对得上** `sys_serviceflow` 的 PK(DB 实测 IN 查询 9 行全中)。**所以「key 存在哪」的答案是:就是 `sys_serviceflow_id` 列本身**——不在 contentxml 属性里,也不靠 view_template_service,也不靠约定生成。起点笔记「sys_serviceflow 只有 displayname+id+contentxml+entityid」漏看了 **id 列本身就是可读 servicename**。
|
||||
|
||||
> `view_template_service`(列 `view_templateid, servicename`)对通知模板只关联 `OA_NOTICEMANAGE_SEARCH`(DB 实测)。**推断**:该表只登记「列表初始查询服务」用于鉴权/索引,**不是**按钮派发的依据;按钮派发完全走 XML 内联 `<method>`。
|
||||
|
||||
### 2.2 运行时解析:按主键 loadPOJO
|
||||
|
||||
`FlowExcuteServiceImpl.excute(map, ctx, flowId)`(`FlowExcuteServiceImpl.java:78-102`)
|
||||
→ `flowService.getFlowDefinition(flowId)`(`:80`)
|
||||
→ `FlowServiceImpl.getFlowDefinition`:`pojoService.loadPOJO(flowKey, "SYS_SERVICEFLOW", null, true)`(`FlowServiceImpl.java:70-88`)——**按主键 = 服务名直接 load 出行**,再 `BaseFlowConvert` 用 `CONTENTXML` 建 `Flow`(`BaseFlowConvert.java:199`)。无 XML 全表扫描,O(1) 主键查。
|
||||
|
||||
### 2.3 EIP4 FlowNameResolver 解析(已移植)
|
||||
|
||||
`eip4-platform/platform-metadata/.../flow/FlowNameResolver.java`(`resolve(flowId)` `:99-133`)三级解析:
|
||||
1. **UUID 格式** → `UUID_PASSTHROUGH`,原样交引擎按 PK 查(`:104-107`)
|
||||
2. **`_SAVE/_UPDATE/_DELETE` 后缀** → `WRITE_REDIRECT`,引导走 `/api/entity/{table}/save`(`:109-112, 57-59`)
|
||||
3. **`<TABLE>_SEARCH` 且 TABLE 在 SYS_ENTITY** → `SYNTHESIZED`,运行时合成默认搜索流并缓存(`:114-123, 141-166`)
|
||||
4. **其余命名服务**:`SELECT COUNT(*) FROM sys_serviceflow WHERE sys_serviceflow_id = ?`(`:171-176`),命中 → `NAMED_HIT`(用原名按 PK 执行),否则 → `ORPHAN`(404)
|
||||
|
||||
`FlowController.run`(`platform-metadata/.../web/FlowController.java:146-180`)按解析类型分派:`UUID_PASSTHROUGH`/`NAMED_HIT` 直接 `flowExcuteService.excute(map, ctx, id)`;`SYNTHESIZED` 用合成 key 执行;`WRITE_REDIRECT`/`ORPHAN` 返 404。
|
||||
|
||||
> **关键观察**:`OA_NOTICEMANAGE_ADD` / `_ADD_AND_SUBMIT` / `_PUBLISH` / `_UPDATE_AC` / `_SUBMIT` **不以 `_SAVE/_UPDATE/_DELETE` 结尾**,所以走第 4 步 `NAMED_HIT` → 会被 `/api/flow/{id}` 真正执行(写流也会跑!)。只有恰好叫 `…_UPDATE` / `…_DELETE`(如 `OA_NOTICEMANAGE_UPDATE`、`OA_NOTICEMANAGE_DELETE`)才会被后缀闸挡成 `WRITE_REDIRECT`。**这是个语义不一致点**(见 §5 风险)。
|
||||
|
||||
---
|
||||
|
||||
## 3. 保存触发
|
||||
|
||||
### 3.1 多保存按钮:每个 `<method name>` = 表单页一个底部按钮
|
||||
|
||||
点「添加」打开 `GridTemplateInsertWindow`,`createButtons()` 遍历该按钮的 `List<EditFormButton>`(来自 `getMethodsByButtonId`),**每个 method 渲染成一个底部按钮**,按钮的 `excuteservice` 即其 servicename:
|
||||
- `GridTemplateInsertWindow.createButtons()` `:114-132`(`serviceName = button.getExcuteservice()`)
|
||||
- onClick:`commitForm()` 收表单 → `ViewEngineActionUtil.excuteService(updateParam, serviceName)` —— `:134-179`(`:151`)
|
||||
|
||||
所以「添加」表单页底部有两个按钮:
|
||||
- **保存** → `OA_NOTICEMANAGE_ADD`
|
||||
- **保存并提交审批** → `OA_NOTICEMANAGE_ADD_AND_SUBMIT`
|
||||
|
||||
`_ADD` 与 `_ADD_AND_SUBMIT` 何时各调:**由用户点哪个底部按钮决定**,不是引擎自动判断。两者是并列的独立服务流(`_ADD_AND_SUBMIT` 推断 = 保存 + 触发审批,contentxml 待核)。
|
||||
|
||||
### 3.2 前置加载流(load/method)
|
||||
|
||||
`修改`/`查看`/`发送通知` 的首个无 name 的 `<method>` 是打开表单页**前**的数据加载流(`OA_NOTICEMANAGE_LOAD` / `_LOAD_SENDNOTICE`),由 `getInsertLoadMethod/getUpdateLoadMethod/getSelectLoadMethod`(`grid/CRUDUtil.java:747-800`)解析。`iscontrol=0`(读流)。
|
||||
|
||||
### 3.3 保存做了什么(为什么不能裸存)
|
||||
|
||||
`OA_NOTICEMANAGE_ADD` 的 contentxml 实测含 `getCurrentUserId` + `USER_ID` + `SAVETIME`,且内含 `<service beanName="pojoCRUDService">…save`(DB grep)。**即:服务流 = 在 pojoCRUDService.save 外面包了「盖拟稿人 USER_ID + 盖保存时间 SAVETIME」等业务逻辑。** 直接调 `POJOCRUDService.save` 会丢掉这层。
|
||||
|
||||
---
|
||||
|
||||
## 4. EIP4 转换设计建议
|
||||
|
||||
### (a) 各按钮该生成什么 amis 动作
|
||||
|
||||
按 button `@type` + 是否带 pageid + `<method>` 列表生成:
|
||||
|
||||
| 老按钮形态 | amis 动作 |
|
||||
|---|---|
|
||||
| **insert/update(带 pageid,多 method)** | 列表工具栏 button → 打开 dialog/drawer 表单(pageid 对应的表单 schema)。表单底部**每个带 name 的 `<method>` 渲染一个提交按钮**,`actionType:ajax`,`api:"POST /api/flow/{servicename}"`,body=表单数据。打开前若有 load `<method>`,dialog 的 `initApi:"POST /api/flow/{loadServicename}"` 预填。 |
|
||||
| **delete(单 method,无 pageid)** | 列表行/工具栏 button,`actionType:ajax`(可配 `confirmText`=showmsg),`api:"POST /api/flow/{servicename}"`,body 带选中行主键。**注意**:通知的「删除/文件归档/提交审批」语义各异,统一走各自 servicename 即可,不要按字面 type 归类。 |
|
||||
| **read(带 pageid)** | button → 打开**只读** dialog,`initApi:"POST /api/flow/{loadServicename}"`(如 `OA_NOTICEMANAGE_LOAD`)。 |
|
||||
| **列表查询(display@selectservice)** | crud `api:"GET /api/flow/{TABLE}_SEARCH"`,由 FlowNameResolver 合成或命中。 |
|
||||
|
||||
调用端点统一是 **`/api/flow/{servicename}`**(servicename 取自 XML `<method>/@servicename`),不是别的。
|
||||
|
||||
### (b) 写端点/保存该怎么调服务流引擎
|
||||
|
||||
**核心矛盾**:现状 `EntityWriteController`(`platform-metadata/.../web/EntityWriteController.java:77-116`)的 `/api/entity/{table}/save` **绕过服务流**,直接 `pojoCRUDService.save/update`,并用 `MandatoryUserColumnFiller`(`:108`)手工补「拟稿人 USER_ID」——这正是 `OA_NOTICEMANAGE_ADD` 流 contentxml 里本就有的逻辑的**手工复刻**。对零业务流模块尚可,但对有业务流的写动作(盖章/审批/状态机/级联)会丢逻辑。
|
||||
|
||||
**建议**:写/动作路径**改走服务流**,而非通用 save:
|
||||
- 保存/动作按钮的 amis `api` 指向 `POST /api/flow/{servicename}`(如 `OA_NOTICEMANAGE_ADD`),让引擎跑 contentxml 全套逻辑(含拟稿人/时间戳/级联),**不再走 `/api/entity/*/save`**。
|
||||
- 这要求放宽 `FlowController` 当前「只放查询类」的运维纪律(`FlowController.java:44-52` 注释自陈)——需补 §5 的写流防护后才能放心放行写流。
|
||||
- 仅当某模块**确无业务流**(纯元数据 CRUD)时,才回退用 `/api/entity/{table}/save` 通用端点。**判定方法**:转换期查该按钮 `<method servicename>` 是否存在于 `sys_serviceflow` 且 `iscontrol=1`(写流)——存在则走 `/api/flow/{servicename}`,不存在才走通用 save。
|
||||
|
||||
### (c) 命名约定/关联表怎么在转换期解析出每个按钮的目标服务流
|
||||
|
||||
**转换期直接读 `view_template.xml` 的 `<button>/<method>/@servicename`,零推断**:
|
||||
1. 取 crud XML:`SELECT xml FROM eip3.view_template WHERE view_template_id = ?`
|
||||
2. 对每个 `<button>`:读 `@type/@id/@name/@pageid/@onloadscript`;遍历其 `<method>`,取 `@servicename/@name/@successmsg/@icon`;首个无 name 的(或 `load/method`)= 前置加载流。
|
||||
3. (可选校验)`SELECT sys_serviceflow_id, iscontrol FROM eip3.sys_serviceflow WHERE sys_serviceflow_id = ANY(?)` 验证每个 servicename 存在、判读/写(iscontrol)。
|
||||
4. 生成 amis:动作 api = `/api/flow/{servicename}`;读/写分流按 (b)。
|
||||
|
||||
**不要**依赖 `{TABLE}_{ADD/...}` 命名约定反推 servicename——命名只是习惯,真值在 XML。`view_template_service` 仅作辅助校验(登记了 `_SEARCH`),不作派发依据。
|
||||
|
||||
### (d) 风险与未知项 —— 见 §5
|
||||
|
||||
---
|
||||
|
||||
## 5. 风险与未解决的未知项
|
||||
|
||||
1. **写流后缀闸不全(语义不一致,高优先)**:`FlowNameResolver` 只挡 `_SAVE/_UPDATE/_DELETE` 后缀(`FlowNameResolver.java:57-59`)。通知的写流 `OA_NOTICEMANAGE_ADD/_ADD_AND_SUBMIT/_PUBLISH/_UPDATE_AC/_SUBMIT` 不带这些后缀 → 当前会被 `/api/flow/{id}` 当 `NAMED_HIT` 直接执行(含写)。而 `_UPDATE/_DELETE` 又被挡成 `WRITE_REDIRECT`。**同一批写流,命名不同、放行策略相反**。转 (b) 方案后这反而是「需要写流能执行」——但意味着 FlowController「只读纪律」名存实亡,必须落实写流防护。
|
||||
2. **写流防护缺位(FlowController 自陈,安全)**:`FlowController.java:44-52` 注释明示引擎不区分读写,入口理论上可触发写流,P2 才补「流定义 service 节点 method 白名单 + 只读连接 + statement_timeout」。走 (b)(写动作经 /api/flow)前,必须先把这层防护和「写流显式放行清单」做出来。
|
||||
3. **服务控制(SYS_TEMPLATECONTROL)未覆盖**:按钮可配前置控制流(§1.4,`GridTemplateComponent.java:653-665` / `FlowExcuteServiceImpl.checkControl`)。通知模块未实测到配置,但 EIP4 转换器目前**未处理** button 控制链;若有控制配置的模块会漏跑前置校验流。需登记并在引擎侧确认 `checkControl` 是否已在 EIP4 执行路径生效。
|
||||
4. **`_ADD_AND_SUBMIT` / `_SUBMIT` / `_PUBLISH` / `_UPDATE_AC` 的 contentxml 未逐一审阅**:只确认了 `_ADD` 含拟稿人/时间戳逻辑。这些写流是否触发 Flowable 审批、是否级联多表、是否依赖前端额外参数(如 onloadscript 2a753a3d 预填的发送参数),需逐一读 contentxml 才能定 amis 表单字段与 body。
|
||||
5. **onloadscript(查看 d7a82532 / 发送通知 2a753a3d)的前端脚本语义未解析**:老引擎在打开页时跑 ViewScript(JS-like),可能改字段可见性/默认值/联动。amis 侧需评估能否用 `initApi` + 表达式覆盖,或需自定义逻辑。
|
||||
6. **多保存按钮的 amis 表单复用**:「添加」一个表单页挂两个提交按钮(保存 / 保存并提交审批),amis form 需支持多 submit 各自不同 api——可行(多 button `actionType:ajax` 指不同 api),但要确认 amis-fork 已支持本项目用法。
|
||||
7. **type=delete 实为改状态**:转换器若按 `type` 字面映射「删除」交互(红色/危险确认),会误导用户——文件归档/提交审批应按 `name` + servicename 语义渲染,不能按 type=delete 一刀切。
|
||||
|
||||
---
|
||||
|
||||
## 附:关键证据索引
|
||||
|
||||
- 按钮模型字段 `excuteservice`:`framework/com.dsasp.client.viewFramework/src/com/dsasp/client/viewframework/template/editform/EditFormButton.java:13`
|
||||
- `<method>`→`EditFormButton`:`…/template/util/ToolButtonUtil.java:30-55`
|
||||
- 按 type+id 取 servicename:`…/template/grid/CRUDUtil.java:725-809, 859-869`
|
||||
- 按钮渲染+onClick+执行:`…/template/grid/GridTemplateComponent.java:679-922, 927, 950`
|
||||
- 表单页多保存按钮:`…/template/grid/GridTemplateInsertWindow.java:114-179`
|
||||
- 执行入口:`…/component/ViewEngineActionUtil.java:165-181`
|
||||
- 引擎按名查流:`framework/com.dsasp.server.core/.../FlowServiceImpl.java:70-88`;`FlowExcuteServiceImpl.java:78-102`
|
||||
- EIP4 解析器:`eip4-platform/platform-metadata/.../flow/FlowNameResolver.java:99-176`
|
||||
- EIP4 flow 门面:`eip4-platform/platform-metadata/.../web/FlowController.java:146-180`
|
||||
- EIP4 现状写端点(绕流直存):`eip4-platform/platform-metadata/.../web/EntityWriteController.java:77-116`
|
||||
- DB:`view_template`(crud XML)、`sys_serviceflow`(servicename=PK)、`view_template_service`(仅 _SEARCH)。连接 `psql -h localhost -p 5433 -U zhengwr -d eip4dev`,`search_path=eip3`。
|
||||
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