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:
290
docs/归档/EIP4-架构与缺口现状-2026-06-13.md
Normal file
290
docs/归档/EIP4-架构与缺口现状-2026-06-13.md
Normal file
@@ -0,0 +1,290 @@
|
||||
> ⚠️ **已归档(2026-06-17)**:本文是 2026-06-13 快照,早于「engineclass delta」重定性与 06-14~17 全部工作,**不再是权威状态视图**。当前状态以 `docs/README.md` 为准。
|
||||
|
||||
# EIP4 架构与缺口现状(2026-06-13)
|
||||
|
||||
> 本文档是对 EIP4 当前**技术状态**的权威快照,基于对当前代码 HEAD 的实测核对(非台账转述)。
|
||||
> ⚠️ 取代 `docs/未完成工作清单.md` 作为技术状态视图——那份是 2026-06-12 修复**之前**的快照,其"列表不过滤/按钮死桩/弹窗嵌整页"等项**均已修复**(详见 §4)。
|
||||
> 商务/人工依赖见 §8;架构总纲仍以 `eip4-platform/docs/架构设计.md` 为准。
|
||||
>
|
||||
> 对齐 HEAD:eip4-platform `f4b6e37`(2026-06-13 夜写路径主线后) / eip4-web `693a857`。
|
||||
|
||||
> **【2026-06-13 夜·写路径主线进展(本文档增量,§7 路线对应推进)】**
|
||||
> 经 5-agent 对代码核验 workflow 拍板后,落地写路径全部前置 + 平台前置,**6+1 原子提交**(eip4-platform main):
|
||||
> - **A0** `06dd127` UiTypeMapper 补 PasswordField→input-password / SingleFileUploadField→input-file / DateField→input-date(default 三控件)。
|
||||
> - **A1** `b28bff2` EditGrid/FormEditGrid 子表列递归 mapField→quickEdit(子表内 Select/Combo/Number/Date 不再退化文本)。
|
||||
> - **A2** `3735a9b` convertForm 解析 `<layout>` 多 `<tab>`→amis tabs(72 页多页签原塌平;正则提 `<div location>` 归位;width/colspan 像素版面后置)。
|
||||
> - **A3** `9ee3ef2` **遗留②编辑表单迁移**:view_page(1241)→sys_page_schema(dispatcher 加 `case "page"`/key=raw view_page_id PK 冲突实测 0/resolveEditFormTemplateId 命中返 pageId)。全量重转上线(2757 产物,view_page 1241 入库 1238 为 form),运行时实证 `/api/page/schema/{view_page_id}` 返真实表单——**「查看」点亮**。
|
||||
> - **B1** `72e4c6d` **遗留① JUEL**:platform-app 接 jakarta.el JSR-223 "juel" 引擎(惰性注册接缝,零改保真层 com.dsasp.*,不引 activiti)。
|
||||
> - **B2** `c721bde` JUEL 跨流回归:153 真实 conditionExpression × 9 场景=1377 次新旧引擎差分,**完全等价 1376/真实偏移 0/良性差异 1**(null-base 方法调用)。
|
||||
> - **C1** `f4b6e37` 补读 requirederror→validationErrors.required / minlength→minLength。
|
||||
> - **运行时激活**:8093 重启为含 B1 的新 jar;**添加端到端实证落库**(OA_NOTICEMANAGE_ADD status:0,服务流设拟稿人/部门/时间)。
|
||||
> - **依赖链现状**:删除✅ / 查看✅ / 添加·修改 表单+引擎+语义+端到端落库 均实证✅(余逐流写 QA)。**§4.2 中 projectRoleType、深链接 两条经代码核验已证伪,见下表更新。**
|
||||
|
||||
---
|
||||
|
||||
## 一、架构全景:双层制元数据引擎
|
||||
|
||||
EIP4 把老系统(EIP3:OSGi/Vaadin7/Activiti5 低代码平台)重构为 **amis + Spring Boot 3 + Flowable**。
|
||||
|
||||
**核心决策:"保真层供奉,现代层生长"** —— 1956 行 SQL 引擎**原样回迁不重写**(包名 `com.dsasp.*` 不动)。理由:它的价值就是和老系统逐字节一致,是逐行对拍的基线、业务数据零搬迁的载体、老员工认知的延续。新能力在外面长(`com.eip4.*`)。ArchUnit 固化纪律:`com.eip4.*` 可调 `com.dsasp.*`,反向禁止。
|
||||
|
||||
**单客户交付 = 4 进程**:`nginx + eip4-platform.jar + flowable-service.jar + postgres`。不上 Redis/MQ/ES(每多一个中间件 = 每个私有化客户终身多一份运维负担),元数据缓存用进程内 Caffeine。
|
||||
|
||||
### 模块全景(8 模块,Maven 单体)
|
||||
|
||||
| 模块 | 职责 | 状态 | 规模/测试 |
|
||||
|---|---|---|---|
|
||||
| **platform-legacy-core** | 保真层:回迁引擎(POJOCRUDService/服务流引擎/脚本引擎/数据权限) | ✅ 核心全通 | 21.4K LOC / 132 测试 |
|
||||
| **platform-metadata** | 现代层:amis schema 端点、实体 CRUD、写流派发、picker、引用列解析 | ✅ P1 完成 | 7.3K LOC / 239 测试 |
|
||||
| **platform-converter** | view_template.xml → amis schema 转换器 + CLI 跑批 | ✅ 核心通,缺高级模板 | 1.9K LOC / 58 测试 |
|
||||
| **platform-auth** | JWT 无状态认证 + 角色/数据权限网关 | ✅ 真实现(非桩) | 1.2K LOC / 34 测试 |
|
||||
| **platform-flow-gateway** | Flowable 客户端 + 待办/已办聚合 + 状态回写 | ✅ P3 可用 | 1.2K LOC / 34 测试 |
|
||||
| **platform-parity** | 逐行对拍框架(C1 一级交付物) | ✅ 生产就绪 | 3.4K LOC |
|
||||
| **platform-app** | Spring Boot 装配 + ArchUnit 边界纪律 | ✅ | 扫 `com.eip4.*`+`com.dsasp.*` |
|
||||
| **platform-ai** | P5:MCP Server | 🔴 纯占位 | 0 LOC |
|
||||
|
||||
全工程 ~36K LOC,496 测试全过。脚本引擎有个小保留:`FlowScriptBindings`/`GeneralPOJOBindings` 各 9 个容器方法是 `UnsupportedOperationException`,但 get/put 可用,不阻断脚本执行。
|
||||
|
||||
前端 **eip4-web**(React 18 + amis 6.13.0):4 业务页 + 设计器入口;15 个 e2e spec / ~252 用例,7 个强断言(真渲染+DB校验)。**amis-fork 纯上游 6.13.0 零定制**,所有定制在 eip4-web(自定义 fetcher / orgId 注入 / 脚本重放)。
|
||||
|
||||
### 核心数据流(已打通)
|
||||
|
||||
```
|
||||
view_template.xml ──BatchConvertCli──▶ amis schema ──入库──▶ sys_page_schema
|
||||
│ (overlay 优先)
|
||||
浏览器 /page/:id ──▶ PageRenderPage ──GET /api/page/schema/{id}──┘
|
||||
列表查询 ──▶ GET /api/flow/{TABLE}_SEARCH (合成搜索流, 过滤+分页)
|
||||
选人 ──▶ GET /api/picker/{dialogid}/list (搜索+分页+权限隔离)
|
||||
写/动作 ──▶ POST /api/flow/{servicename} (服务流引擎: 拟稿人/时间戳/审批/级联)
|
||||
脚本 ──▶ onEvent → /api/script/execute-template → 前端重放 facade 指令
|
||||
```
|
||||
|
||||
写路径已正确接回服务流(不再绕过引擎裸存),读写门按 contentxml 真实方法分类(写流仅 POST + 真实用户上下文)。这是整个迁移最关键的架构正确性,已经立住。
|
||||
|
||||
---
|
||||
|
||||
## 二、已实现(按层)
|
||||
|
||||
- **后端引擎**:CRUD / 服务流 / 脚本引擎 / 数据权限全回迁生效;对拍 21 实体逐行 100% 一致
|
||||
- **认证授权**:JWT 登录、行级数据权限(读端 `DataPrivilegeService` WHERE 下推 + 写端 `WritePrivilegeChecker` 逐行)、picker 权限隔离——都是真实现
|
||||
- **元数据驱动 UI**:list/form/tree/report/group 五类模板转换;分页/排序/搜索/金额列/枚举映射(F2-16 `type:mapping`)/日期格式/人员列 id→姓名(运行时 `UserColumnResolver`,568 列)
|
||||
- **编辑表单**(本会话修):显式行布局、富文本满行、单层标题、弹窗剥壳、`{ids}` 批量删除/审批扇出
|
||||
- **Flowable**:待办/已办/发起/审批/trace 可用,独立 8089 服务
|
||||
- **设计器**:amis-editor 三屏 + overlay 双层(标准层=转换器产物升级整体替换;overlay=管理员手调,优先级更高)
|
||||
|
||||
---
|
||||
|
||||
## 三、本会话已修(2026-06-12 ~ 06-13)
|
||||
|
||||
针对"添加界面不可用"截图(富文本塌成竖条 + 三层标题嵌套),已提交 4 个原子提交:
|
||||
|
||||
| 提交 | 内容 | 根因 |
|
||||
|---|---|---|
|
||||
| `52c7397` (converter) | 编辑表单显式行布局:废 `columnCount`/`colSize`,窄字段两两成 `group` 行、宽控件独占整行;去 `form.title` 重复;弹窗 `size:lg` | amis 6.13 的 `columnCount` 是纯 CSS 等宽列,`colSize` 在该模式下被整体忽略 → 富文本被塞半栏,TinyMCE 菜单挤成竖条 |
|
||||
| `a021f33` (metadata) | `format=amis` 剥 page 壳:弹窗只渲表单本体 | 弹窗经 service 加载整页 schema,page.title 叠 dialog 标题 = 三层重复(D4 运行时修复) |
|
||||
| `e2c5d43` (metadata) | amis `{ids}` 批量形态适配:按流 `<input>` 必填 `*_ID` 逐 id 扇出执行 | bulkActions 只送 `ids=主键逗号串`,而老服务流 `<input>` 声明单条必填主键 → 透传 ids 必填缺失 500、行未删(API 实证)。这是删除/提交审批/文件归档全链断裂的根因 |
|
||||
| `aeecaac` (eip4-web) | 删除 e2e 断言对齐老系统软删语义(`ISDEL=1`,不动 `ISACTIVE`) | 删除已走服务流 `OA_NOTICEMANAGE_DELETE`(start 脚本 `map.put("ISDEL",1)`) |
|
||||
| `662828c` (converter+metadata) | **列表引用列 id→显示名通用化**:resolver 推广到任意引用实体 + 产出 `<COL>_DISPLAY__` 平行字段保留原始 id;转换器引用列绑 `_DISPLAY__`;虚拟显示列兜底物理 NAME | 老引擎给每列算 `_DISPLAY__`、Vaadin grid 绑显示值;amis 后只补了用户列+枚举/日期,通用引用列显示裸 id(根因见 §5) |
|
||||
|
||||
验证:converter 60 测试 + metadata resolver 9 测试全过;e2e f2-17 5/5 绿;`{ids}` 删除 API 实证 status 0 + `isdel=1` 落库;浏览器真渲染确认弹窗单层标题/富文本满行,以及 OA_OFFICE_COLLARAPPLY 申请人=系统管理员[admin]/申请部门=法务合约部/用品仓=lll办公用品0412(原始 id 全保留,表单安全)。
|
||||
|
||||
---
|
||||
|
||||
## 四、已知缺口(与当前 HEAD 对齐)
|
||||
|
||||
### 4.1 已修复(核对确认,不在缺口内)
|
||||
|
||||
`未完成工作清单.md` 列为"待修"但实际已修:A1 列表过滤(`f5850a8`)、A2/A4 按钮死桩→EDITFORM 映射(`29199e6`/`34c2928`)、B1 弹窗嵌整页(`a021f33`)、E8 页面标题「测试」、E9 报表 500(`maven.compiler.release=21` 已设)、E12 登录跳转、A5 人员列裸 id(`UserColumnResolver`)、A6 富文本错配(`37db794`)。
|
||||
|
||||
### 4.2 真·剩余缺口
|
||||
|
||||
| 缺口 | 类别 | 影响面 | 状态 |
|
||||
|---|---|---|---|
|
||||
| ~~通用引用列 id→显示名~~ | 元数据机制 | 广(凡引用列) | ✅ **已修**(`662828c`+`2a6c1d0`,2026-06-13):resolver 推广到任意引用实体 + 产出 `_DISPLAY__` 保留原始 id;转换器引用列绑 `_DISPLAY__`;虚拟显示列(如 SYS_DEPART.FULLNAME)兜底物理 NAME。实证申请人/部门/仓库均出名称。(注:`662828c` 当时仅提交了通用化测试,resolver/converter 实现漏入暂存区,`2a6c1d0` 补齐使 HEAD 自洽) |
|
||||
| ~~**SelectDialog 弹窗形态降级成下拉搜索**~~ | 控件走样 | 150 dialogId / 911 页 | ✅ **已修**(`9d92df2`,2026-06-13):SelectDialog/MultiSelectDialog → amis picker 多列对照弹窗(搜索+分页)。降级注释「6.13 schema 未纳入 picker」核实**失实**——picker 表单项过得了闸一(已加测固化)。列由运行时 `/api/picker` 随 `data.columns` 提供(转换器不解析跨模板 dialog XML,§6 对齐);PickerController 每行补 `_label` + 返回多列(displayname 友好标签)。浏览器实证:加班登记 USERID 弹窗多列(显示名称+帐号)、186 页分页、选中回填 `_id`(36 位 UUID)、chip 显显示名 |
|
||||
| ~~initvalue/defaultvalue 两阶段求值未迁移~~ | 元数据机制 | 全库依赖初值的页(1288 模板) | ✅ **已修**(`009ddf8`+web`d823264`,2026-06-13):UiTypeMapper 相一字面进 `value`、相二动态 token({CURRENTUSER}→${currentUser}/{CURRENTORG}→${orgId}/{CURRENTTIME}→${now}/{CURRENTPROJECT}→${currentProject})由 AmisRenderer 注入数据域求值;AUTOGENERATECODE(6 模板)+未识别 token 诚实降级。实证外部邮件收件箱搜索携 FOLDER=0。 |
|
||||
| **onselectedscript / filterscript 未挂回** | 脚本 hook | 行选中控按钮、选择框过滤 | ⏸️ **未做(依赖前置)**:核查发现 `full_auto_index.json`(507 条)只记 `{template_id,seq,rules}`,**不保留脚本来源事件类型**(onload/onselected/filter);现有 `attachScriptOnEvent` 把所有 seq 一律挂 `inited`+`change`。要把 onselected→CRUD 行选事件、filter→选项动态过滤分别接对,需先让 s3_rewriter 在索引里标注脚本来源事件类型 + 转换器按类型映射 amis 事件——属 rewriter 管线改造(跨 Python+Java+amis 事件语义),非纯接线,且本 dev 环境脚本管线未激活(index 路径错位致 onload/onchange 也未挂),无法端到端验。留待 rewriter 管线专项。 |
|
||||
| ~~**高级模板类型缺失**~~ | 模板覆盖 | 子表/树表/日历/审批表单 | ✅ **数据判定不做**(`ba34487`,2026-06-13):频次审计精确口径下 EditGrid/MasterSubGrid/TreeGrid/Calendar/Wf 在本客户库 1489 模板**全 0 存量**;转换器既有 `EditGrid/FormEditGrid → input-table` 子表分支足以兜底任何未来出现。跨模板引用(group)仍为占位,但 group 根仅 20 模板,低优先 |
|
||||
| ~~**真丢失控件**~~ | 控件覆盖 | TwinColSelect/PasswordField | ✅ **数据判定不做**(`ba34487`):TwinColSelect=0、PasswordField=0,零存量 |
|
||||
| **LIKE 搜索裸拼 SQL** | 安全 | picker/list 查询端点 | 🟡 **风险已澄清(2026-06-13 实测)**:引擎 GeneralPO 对 String LIKE 条件**自动双写单引号**(实测 `TITLE=x'` → SQL `like '%x''%'`,注入不可逃逸),故 _SEARCH/list **非可注入**;picker 端另有 escapeLikeValue 兜底。残余仅「通配符 `%`/`_` 未中和」(list 端)——属搜索语义/性能,非注入,低优先。P2 渐进参数化仍可做防御纵深,但非开放漏洞 |
|
||||
| ~~projectRoleType 候选人解析 ~91%~~ | Flowable | 528 处表达式 | ✅ **核实已闭环**(2026-06-13,`OrgDirectoryJdbc.java:33-46/116-144` 按 PROJECTID 直查 + 单测,非降级)。原描述失实;真正残留=`scriptUser`(26 处≈0.5%,仅 `System.out` 告警→宜升 `log.warn`) |
|
||||
| **报表 B 图表 / C 类 JOR** | 报表 | 45 个 JOR 模板 | A 类 333✅;C 类待 univer 替换方案 |
|
||||
| ~~深链接被 Tab 吞~~ | UX | 直开 /page/:id | ✅ **已修**(F2-13,`AppShell.tsx:80-95` 直开 /page/:id 自动建 Tab + 标题回填) |
|
||||
|
||||
### 4.3 静态审计"失明"项(运行时已修,审计数字不降)
|
||||
|
||||
`schema_reality_audit.py` 扫的是静态产物,以下项**已在运行时修复但审计数字不变**——这是审计工具盲区,不是真缺口,后续要改用 e2e 验:
|
||||
- D1 人员列裸 id(603 页)→ `UserColumnResolver` 运行时解析
|
||||
- D4 弹窗嵌整页(108 页)→ `format=amis` 剥 page 壳
|
||||
- D6 不分页(1293 页)→ FlowController 分页翻译
|
||||
|
||||
> ~~**行动项**:审计脚本需升级~~ ✅ **已做**(`41eb339`,2026-06-13):`schema_reality_audit.py` 把 D1/D4/D5/D6 标「运行时已修(审计盲区)」、`--db` 加 **uitype × 模板根类型 × 频次**统计(扫 `view_template.xml` 存量真实用量)。真实基线见 `docs/F2-17-审计基线-2026-06-13-升级.md`。**关键发现**:SelectDialog 涉 940 模板(印证 picker 单点回报最大);**高级模板结构(EditGrid/MasterSubGrid/TreeGrid/Calendar/Wf)精确口径下全 0**(早期子串口径把脚本注释文本「addButton到EditGrid」虚计为 55,已修正);**真丢失控件 TwinColSelect=0、PasswordField=0**。即 §7-4 全部子项在本客户库零存量。picker 上线后 SelectDialog 降级 1783→225,分级 SUCCESS 114→283(+169 页)。
|
||||
|
||||
---
|
||||
|
||||
## 五、根因专题:列表显示 id vs 老系统显示名称
|
||||
|
||||
**结论:老系统的"id→名称"是引擎自带能力(给每列额外算显示值);EIP4 复用同一引擎,但换掉了消费这个显示值的前端层(Vaadin grid → amis),换的时候只补了部分列的解析,通用引用列漏了。**
|
||||
|
||||
### 老系统机制(代码实证)
|
||||
|
||||
老引擎每行经 `GeneralPO.toMap()`(`GeneralPO.java:2411`)给**每一列**输出两个键:
|
||||
|
||||
```java
|
||||
map.put(key + "_DISPLAY__", po.get_DisplayValue(...)); // 显示值(名称)
|
||||
map.put(key, po.get_Value(i)); // 原始值(id)
|
||||
```
|
||||
|
||||
`get_DisplayValue`(`GeneralPO.java:1311-1313`)对引用列:
|
||||
|
||||
```java
|
||||
} else if (dt.length() == 36) { // DisplayType 是 36 位 UUID = 引用了另一实体
|
||||
return m_custom.get(columnName); // 返回预解析的目标实体显示名
|
||||
}
|
||||
```
|
||||
|
||||
即:列若引用别的实体(DisplayType = referenceid UUID),引擎按 `referenceid → SYS_REFERENCE → 目标实体显示列`,在查询时用 `LEFT JOIN lateral`(`POInfo.java:442-457`)把 id 解析成名称存进 `m_custom`。**Vaadin grid 列绑定的是 `_DISPLAY__` 值,不是原始 id**。所以老系统引用列/枚举/日期/金额全自动显示成人类可读值,前端零代码——这是元数据驱动引擎的内建红利。
|
||||
|
||||
### EIP4 为什么显示 id
|
||||
|
||||
EIP4 **回迁同一引擎**,这套能力其实还在,但链路两处断:
|
||||
|
||||
1. **序列化层不带显示值** —— 实测 `/api/flow/OA_NOTICEMANAGE_SEARCH` 返回 23 字段,`_DISPLAY__` 键数 = **0**,`USER_ID`/`ORGID` 全裸 id。合成搜索流 → FlowController → JSON 这条路没走 `toMap`,只吐原始值。
|
||||
2. **amis 列绑原始列名** —— 转换器生成 `{name:"USER_ID"}`,amis 显示原始 id。
|
||||
|
||||
老系统的显示解析本在 Vaadin grid 层,被 amis 替换时只重新实现了部分列:枚举/状态(F2-16 `type:mapping`)✅、日期(`type:date`)✅、**用户引用列**(补丁 `UserColumnResolver` 运行时,只认 SYS_USER)✅、**其它引用列(项目/部门/单位/任意实体)→ 无人管,显示裸 id** ❌。
|
||||
|
||||
### 修复成本低(引擎已会算,缺的是接回前端)
|
||||
|
||||
- **首选**:把 `UserColumnResolver` 从"只认 SYS_USER"推广成"按 `referenceid` 解析任意引用实体的显示列"(复用 picker 已有的 `displayColumn` 逻辑)——一处改动覆盖全部引用列。
|
||||
- 备选:让搜索流序列化带 `_DISPLAY__` + 转换器把引用列绑显示变体——更贴近老系统原生,但改序列化契约+转换器两处。
|
||||
|
||||
→ 采首选。它和"选择器统一"是**同一套 `displayColumn` 机制**,一起做最省(见 §7)。
|
||||
|
||||
---
|
||||
|
||||
## 六、新增功能架构(待拍板)
|
||||
|
||||
**问题:目前整套机器是迁移/兼容引擎(读老 XML → 转 amis → 渲染)。迁移完,新系统怎么加老系统没有的新功能?**
|
||||
|
||||
### 关键认知:系统里有两种"元数据",未来命运不同
|
||||
|
||||
| | 是什么 | 未来 |
|
||||
|---|---|---|
|
||||
| **数据/行为元数据** | `SYS_ENTITY`/`SYS_ENTITYATTRIBUTE`(实体模型)、`SYS_SERVICEFLOW`(业务逻辑)、引用/权限 | **保留,作为正向 authoring 模型** |
|
||||
| **视图元数据** | `view_template.xml`/`view_page.xml`(Vaadin 时代 XML)→ 转换器 → amis | **冻结,只用于迁移,最终退役** |
|
||||
|
||||
因为后端引擎**本身就是元数据驱动**:往 `SYS_ENTITY` 插实体 → 引擎自动动态建表 + CRUD(`/api/entity`)+ 标识符白名单 + 类型强制 + 数据权限,全免费;往 `SYS_SERVICEFLOW` 写流 → 引擎自动跑默认值/校验/级联/审批。这套是平台真正可持续的价值。而 XML→amis 那条链是**为搬老页面才存在的翻译层**,新功能从没需要过翻译。
|
||||
|
||||
### 目标姿势:新增一个业务功能
|
||||
|
||||
1. **定义数据** → `SYS_ENTITY`/`SYS_ENTITYATTRIBUTE` 建实体 → 引擎自动给 CRUD/权限/建表
|
||||
2. **定义行为**(若需要)→ 写服务流 contentxml(默认值/校验/审批触发)→ 引擎执行
|
||||
3. **画页面** → amis 设计器**直接写 amis schema** 进 `sys_page_schema`,**不经过 XML、不经过转换器**;列表指向 `/api/flow/{TABLE}_SEARCH` 或 `/api/entity/{table}/list`,表单指向 `/api/flow/{servicename}` 或 `/api/entity/{table}/save`
|
||||
4. **挂菜单** → templateId
|
||||
|
||||
一句话:**引擎 + amis 是运行时,XML 转换器是一次性导入工具,迁移完退役。新功能永远不碰 XML。**
|
||||
|
||||
### 要让它成真,缺三个工具 + 一个设计决策
|
||||
|
||||
**三个 authoring 工具(现在都没有):**
|
||||
- **实体建模器**(计划 F4-L2):可视化建 `SYS_ENTITY`,不裸写 SQL
|
||||
- **设计器"新建空白页"**:现在 `DesignerPage` 只能 overlay 已转换的存量页(templateId 必须已存在),不能从零建页
|
||||
- **服务流设计器**(F4-L3)或至少 contentxml 编辑助手
|
||||
|
||||
**一个必须明确的设计决策——新页面的 source of truth 放哪:** 现在 `sys_page_schema` 是"标准层(转换器产物,重迁移整体替换)+ overlay(手调)",**假设底下永远有转换器基线**。但新建页没有 XML 基线——它本身就是基线。建议加来源标记 `source = 'converted' | 'authored'`:converted 页可被重转覆盖;authored 页是手写的、永不被转换器碰。这样重跑迁移不清掉新功能,新功能也有干净的家。
|
||||
|
||||
**逃生口:** 真正低代码表达不了的(自定义看板、第三方集成、复杂交互)→ 直接手写 Spring REST + React 路由,与 amis 页并存。别强行什么都塞进引擎。
|
||||
|
||||
### 时序建议
|
||||
|
||||
- **近期**:迁移收尾(§7),让存量可用。这期间**不再加深转换器对 XML 的耦合**,新机制一律按"amis 原生"形态做,为退役转换器铺路。
|
||||
- **中期**:迁移到"大部分页能用 + overlay 兜底"水位后,启动 F4-L2 实体建模器 + 设计器新建空白页 + `sys_page_schema` 加 `source` 标记。这三件到位,新功能彻底脱离老系统,转换器降级成纯导入工具。
|
||||
|
||||
---
|
||||
|
||||
## 七、下一步路线
|
||||
|
||||
整个项目的架构骨架已立住(双层制 + 写回服务流 + 对拍守护),现在是 **P4 收尾期**——从"跑通"到"生产级可用"。按回报排序:
|
||||
|
||||
1. ✅ **通用引用列 id→显示名 + 选择器弹窗化(同源,已完成)** —— 单点回报最大。两者都用同一套 `displayColumn`(按 `referenceid` 找显示列)机制。
|
||||
- ✅ **引用列"列表显示 id"已修**(`662828c`+`2a6c1d0`,2026-06-13,见 §3)
|
||||
- ✅ **选择器弹窗化已修**(`9d92df2`,2026-06-13):SelectDialog/MultiSelectDialog → amis picker 多列对照弹窗。半小时复核结论:降级注释「6.13 schema 未纳入 picker」**失实**,picker 过得了闸一(已加测 `schemaGate_picker表单项过闸一`),无需改 amis-fork。列由运行时 PickerController 随 `data.columns` 提供(转换器零跨模板 XML 耦合,§6 对齐),浏览器端到端实证通过(多列+搜索+分页+回填 `_id`)
|
||||
2. ✅ **审计工具升级 + 真实基线已做**(`41eb339`,2026-06-13)—— D1/D4/D5/D6 标运行时项改 e2e 验;`--db` 加 uitype/模板/频次统计。基线数据见 §4.3。
|
||||
3. **initvalue 两阶段求值 + onselectedscript/filterscript 挂回** ——
|
||||
- ✅ **initvalue 已修**(`009ddf8`+web`d823264`,2026-06-13,全库 1288 模板):字面进 value + 动态 token 前端数据域求值。见 §4.2。
|
||||
- ⏸️ **onselectedscript/filterscript 未做**:核查发现非纯接线——`full_auto_index` 不保留脚本来源事件类型,需先改 s3_rewriter 管线标注事件类型再按类型映射 amis 事件,且本环境脚本管线未激活无法验。详见 §4.2 该行。
|
||||
4. ✅ **高级模板类型 / 真丢失控件 —— 数据判定全部不做**(`ba34487`,见 §4.3 基线):精确口径下高级模板结构(EditGrid/MasterSubGrid/TreeGrid/Calendar/Wf)与真丢失控件(TwinColSelect/PasswordField)在本客户库**零存量**;转换器既有 EditGrid→input-table 分支兜底。§7-4 由数据判定关闭。
|
||||
|
||||
**本会话上线状态(2026-06-13)**:§7-1/§7-3 的转换器改进(picker / 引用列 _DISPLAY__ / initvalue)**已正式部署到服务层** —— 用正确 rewriter 路径(`output/`,保留 onEvent 380 模板)重跑 BatchConvertCli 生成 1489 产物,经 `SchemaImportCli` 导入 `sys_page_schema`,实证加班登记标准层无 overlay 直出 picker 多列选择窗 + onEvent。overlay 手调层不动。故这些改进对全部存量页生效,非仅代码。
|
||||
|
||||
**本会话 QA 巡检(2026-06-13,运行时 dogfooding 找成类 bug)**:静态扫全 1489 schema + 运行时 API 分层抽样,修复 5 类缺陷,均已重转+重导入上线:
|
||||
- **空结果集列表崩**(凡 0 行列表页报「data.items 必须是数组」)→ FlowController.normalize 空集也拍平 {items:[],total:0}(`ea0b68d`)。
|
||||
- **ComboBox 枚举下拉空数据**(51 模板,comboboxid 空+itemisenumerate)→ 取列 enumeratetype 作字典源(`ea0b68d`)。
|
||||
- **YEAR/MONTH 下拉空**(27 字段)→ 转换器内建生成年/月静态选项(`012ab21`)。
|
||||
- **report 无 selectservice 兜底端点 404**(12 报表页)→ 改兜合成 _SEARCH(`e6054a3`)。
|
||||
- **引擎异常裸 500**(实体登记但物理视图缺失)→ FlowController 兜成 200+status:1 友好提示(`e6054a3`)。
|
||||
- 剩余:静态 group「跨模板子模板」占位 87(架构项,§6 跨模板);5 个 itemisenumerate=false 无源 select(老系统本无源,诚实降级);运行时 ~10 个 `VIEW_*/VM_*` 报表视图在 dev 副本物理缺失(生产存在,现优雅降级,**非产品缺陷,属 dev 数据缺口**)。
|
||||
|
||||
**全量运行时巡检(2026-06-13,1489 页 list+499 去重 source 并发打端点)——最大发现是环境问题:**
|
||||
- 🔴 **【关键环境】dev 平台须跑 JDK 21,不可用 JDK 26**:实测 JDK 26(class major 70)下,老引擎服务流的 **Groovy 4.0.27 脚本编译崩**(`AsmDecompiler: Unsupported class file major version 70`,`GroovyBugError`),致 **35+ 个带 Groovy 脚本的命名查询流(`*_SEARCH_LISTINFO`/`*_SZWJ` 等)直接 500**。换 JDK 21(项目 `maven.compiler.release=21` 目标、生产口径)后**全部恢复**(如 PM_LABORCOMPANY_SEARCH_LISTINFO 返 57 行、PM_SPECIALTY_SUBPACKAGE 1305 行)。已 `brew install openjdk@21` 并把平台切到 21。**启动命令须 `JAVA_HOME=/opt/homebrew/opt/openjdk@21`**(flowable-service 建议同切)。生产用 21 故无此问题。
|
||||
- 巡检剩余分类(JDK 21 下):`LIST_DEVDATA_GRACEFUL` 289 + `VIEW_*_SEARCH` 404 共 ~320 = **dev 库缺视图/缺实体登记**(生产存在,非缺陷;404 类实体在 dev 连 SYS_ENTITY 都没登记);`LIST_ITEMS_NOT_ARRAY` 6 = 并发巡检假阳性(直连返正常 items);`SOURCE_EMPTY` 66 = 半为空 picker(dev 数据)半为 ComboBox 的 comboboxid 指向查询服务而非枚举(错配 /api/poc/dict)。
|
||||
- ~~**真·剩余代码缺口**:`/api/template/{id}/tree|list` 占位端点 83 处 = TreeGrid 树模板渲染~~ ✅ **已修**(`4337720`,2026-06-13):新增 `TemplateTreeController` 运行时构树端点(`GET /api/template/{ref}/tree`,解析 `<node>/<levelnode>` 按各级 parentid 链父,支持自嵌套+跨实体);转换器 convertTreeGrid 改:左树走该端点 + onEvent 重载右表,右表复用 `/api/flow/{gridTable}_SEARCH?{rcol}=${tree}`(原 /api/template/list 不存在),右表列取自 gridtemplate 引用模板 display;并修 flex→grid 布局。浏览器实证「查看大事记管理」左树分类层级渲染 + 点节点右表 reload 携 EVENTID。重转分级 SUCCESS 283→328。
|
||||
- ⚠️ **TreeGrid 二次 QA 发现 `4337720` 只做通 happy path,两处运行时缺陷已补修**(2026-06-13,浏览器 dogfooding):
|
||||
1. **左树只显示一半**(全 45 个 treegrid 页):amis `.cxd-Tree--outline` 默认 `max-height:300px`,多级分类树露一半、下方大片留白。修法(终版):转换器给 input-tree 挂 `className=eip4-treegrid-tree`,eip4-web `amis-theme.css` 把该类内 `.cxd-Tree` max-height 抬到 `calc(100vh-230px)`+内部滚动(填满视口、超出树内滚)。注:先试过 `heightAuto`(随内容无限撑高,大树拉爆页面,用户否)与内联 `style`(只落外层 form-item、压不到内层滚动容器,无效),均弃用。浏览器实证树高 615px、底部 783<视口 845。
|
||||
2. **点父/中间节点右表「暂无数据」**(29 个多级 type-4 树):右表按 `{rcol}=${tree}` 精确匹配点中节点自身 id,而业务行常只挂叶子(文件挂「技术部」非父级「技术中心」),点父级 0 行。**老系统点父级聚合整棵子树**。修法:新增 `GET /api/template/treegrid` 子树聚合端点——解析「点中节点+全部后代」id 列表,以 `List` 值委托合成 `_SEARCH`,引擎 `GeneralPO.get_SearchWhereClause` 见 List 即构 `rcol IN (...)`(已转义,无注入面,**无需改保真层**),复用 _DISPLAY__/数据权限/分页;转换器右表 api 改指该端点(`treeRef`/`gridTable`/`rcol`/`node=${tree}`)。`TemplateTreeController` 补 7 个单测(构树/子树/IDENT 守卫/委托),转换器 60 测全过。浏览器实证:资料库点父级「技术中心」现出子级「技术部」文件(修前空);单级树「通知收藏」点叶子仍正确过滤(无回归)。已重转 1489 产物 + SchemaImportCli 导入(445 更新)上线。
|
||||
- ✅ **TreeGrid 三次 QA 补「操作」(2026-06-13,用户追问「列表上面的按钮都有了吗」)**:`convertTreeGrid` 此前只做「看」,45/45 页左树+右表操作按钮全丢。已补:
|
||||
1. **树高度终版**改 className+CSS(见上,撤回 heightAuto)。
|
||||
2. **右表工具栏**(添加/修改/删除/查看):读 gridtemplate 引用模板 `<button>`,复用 `collectButtons`/`buildToolbar`(与普通 list 同源,含 EDITFORM 映射 + 删除走 bulkActions `${ids}`)。
|
||||
3. **左树分类节点增删改**:treetemplate 引用模板 `<node><buttons>` → amis InputTree 原生 `creatable`/`editable`/`removable`/`rootCreatable` + `addApi`/`editApi`/`deleteApi`(配 `source` 自动重拉刷新);add 送 `{名称列:${label},父列:${parent.value}}`、del 送 `{主键:${value}}`,名称列/父列由元数据(`isentitydisplay`/levelnode parentid)解析。转换器 60 测全过。浏览器实证:树高视口填满、右表 4 按钮渲染、左树 `➕添加一级节点`+悬停节点 `+−✎`、**删除端到端 `status:0` 通**。
|
||||
- 🔴 **遗留①(写流引擎缺口,非接线问题)**:左树**添加/修改**(及右表文件新增等任何走 EL 表达式求值的写流)被引擎 `Can't find scripting engine for 'juel'` 阻断 → `status:1`。`juel` 字面在 4983 流 contentxml 中出现 **0 次**,是引擎对 EL 的**默认引擎名**——本运行时未注册 JUEL JSR-223 引擎。**影响面=所有 EL 写流,非仅 treegrid;属保真层相邻平台任务**:`platform-legacy-core`/装配层注册 JUEL ScriptEngineFactory + 跨流回归。删除流不走 EL 故正常。(用户拍板:登记为独立平台任务,本轮不动)
|
||||
- 🔴 **遗留②(编辑表单迁移缺口,全系统级)**:按钮「添加/修改/查看」弹窗提示「该单据未配编辑表单」的根因——**编辑表单是 `view_page`(全库 1241 个,带完整 `<fields>`),而 `BatchConvertCli` 只遍历 `view_template`(1516),这 1241 个编辑表单从没转换/导入 `sys_page_schema`**;弹窗解析器 `resolveEditFormTemplateId` 只在 type=7 包壳模板(全库仅 70 个)里按 pageid/entityId 找,指向独立 view_page 的按钮(绝大多数)全部命中不到 → 降级占位。**这是 F2 写路径「编辑表单迁移」一直未做的步骤**,非 treegrid 特有(treegrid 右表按钮只是把它暴露出来)。修法:遍历 view_page→amis form(复用现有 `convertForm`/view_page 解析器字段逻辑)入 `sys_page_schema`,解析器命中已转 view_page 时直接返回 pageId。补完后**「查看」立即全可用**、添加/修改表单可显示(提交仍待 juel)。(用户拍板:登记为独立任务,本轮不做)
|
||||
- 即:**真实「添加/修改」端到端可用 = 编辑表单迁移(遗留②,表单界面) + JUEL 引擎(遗留①,提交执行) 两个前置都补齐**;「查看」只需遗留②;「删除」已可用。
|
||||
- 次要待办:ComboBox comboboxid=查询服务(非枚举)时应路由 /api/flow 或 /api/picker 而非 /api/poc/dict(SOURCE_EMPTY 约半数);group「跨模板子模板」占位 87(§6 跨模板,架构项)。**TreeGrid 仍后置**:type=3 声明式多级树 53 页仍走 `selectservice`+deferApi 占位未接 `/api/template/{ref}/tree` 端点。
|
||||
|
||||
**先不碰**:platform-ai(MCP,P5);转换器对 XML 的深度精度(已死格式,低 ROI)。
|
||||
|
||||
---
|
||||
|
||||
## 七·补、主动覆盖度审计缺口地图(2026-06-13)
|
||||
|
||||
> 前述缺口多是浏览器 dogfooding 被动撞出的;本节是**主动盘点**结论——按模板 type、编辑表单 uitype、编辑表单结构、运行时端点四维,把源数据存量对照转换器分支+运行时可达性扫出的缺口。
|
||||
> **完整证据与计数见 `docs/转换器覆盖度审计-2026-06-13.md`**(4 并行审计 agent + curl/浏览器抽验 + 代码核对);此处仅列按优先级排序的清单。
|
||||
|
||||
**P1 — 正确性/安全(小量必修)**
|
||||
- 🔴 **type=5 日历视图(2:单个员工排班/查看会议室调度)转成普通 crud 表格** → 班次/日历语义全丢(浏览器实证渲染成查询表单+空网格)。应映射 amis calendar/fullcalendar。
|
||||
- 🔴 **编辑表单 default 控件**:PasswordField(明文,安全)/SingleFileUploadField(41,丢上传含证件照)/DateField(1,丢日期)落 `default→input-text`。各 1 行/复用即修,**迁移编辑表单前先补 UiTypeMapper**。
|
||||
- 🔴 **VIEW_/VM_ 报表端点 ~46 个/影响 ~277 页**:dev 缺聚合视图,需 DBA 确认生产视图存在性(生产有=dev 数据缺口;无=真建视图+注册服务流)。
|
||||
|
||||
**P2 — 编辑表单迁移(遗留②)必须连带做的质量项**
|
||||
- ⚠️ **EditGrid/FormEditGrid 子表列硬写 input-text 不递归 UiTypeMapper** → 637 子表里 SelectDialog/ComboBox/NumberField/Date 全退化文本、178 子表联动丢失 → buildEditGridColumns 改为对子表字段递归 mapField。
|
||||
- ⚠️ **多页签 `<tab>` 布局(72 页)** + **width/colspan 精确布局(875+)** 丢失(convertForm 跳过 `<layout>`,平铺等宽两列)。
|
||||
- ⚠️ **requirederror(1237)/minlength(1219)** 未读取。
|
||||
- ⚠️ 编辑表单 **SelectDialog/MultiSelectDialog ~97% 无 dialogid** 降级 select、**ComboBox 339 查询服务源** SOURCE_EMPTY(需运行时按字段/实体元数据补数据源,列表页 picker 同源机制延伸)。
|
||||
- ⚠️ **页面级 `<scripts>` 联动(601 页)** part-handled,依赖脚本改写器管线(与 §4.2 onselected/filter 不同管线、不同阻塞点)。
|
||||
|
||||
**P3 — 决策/低成本/已知后置**
|
||||
- **type=6 group(20)**:子模板 62/62 已各有产物,前端 tabs 按 tempid 拉 `/api/page/schema/{tempid}` 即可激活(**前端路由活,非转换器缺口**)。
|
||||
- **type=100/101(130)选择窗死页**:无菜单关联、运行时由 `/api/picker` 承接、不读这些 schema → 决策停转 or 留 F4 弹窗预览。
|
||||
- **report B 图表(4,`ischart=true`)** 降级纯表格、**C 类 JOR 套打**版式丢失(另案 amis chart/univer)。
|
||||
- **type=3 声明式多级树(53)** 未接 `/api/template/{ref}/tree` 端点。
|
||||
|
||||
**端点引用实况(修正并行 agent 误判)**:产物 `/api/flow *_SEARCH` 1345 页、**`/api/picker` 911 页(1948 次)**、**`/api/poc/dict` 728 页(1683 次)**、`/api/template/treegrid|tree` 45、`/api/page/schema` 109(多指向未迁移 view_page→「未配」)。`_SEARCH` 抽样(N=300):有数据 55% / 空(dev 缺口)42% / status:1 降级 2.3% / 错 0.7%。
|
||||
|
||||
**写功能依赖链(一句话)**:真实「添加/修改」端到端 = 遗留②编辑表单迁移(连带 P2 全部)+ 遗留① JUEL 引擎;「查看」只需遗留②(+P2 部分);「删除」已可用;P1 与之并行(小修+报表数据源确认)。
|
||||
|
||||
---
|
||||
|
||||
## 八、外部 / 人工依赖(技术线推不动)
|
||||
|
||||
| 阻塞 | 卡住什么 |
|
||||
|---|---|
|
||||
| **S1 止损评审会**(153 定制视图 7.56 人月三选一:分期/第三方组件/扩预算) | 卡 F3 主线启动 |
|
||||
| **11 个引擎读路径缺陷待旧系统同病验证** | 同病=保真不改,独病=移植 bug 要修——优先级定不了 |
|
||||
| **检查点①/② 商务闭环 + 客户签字矩阵** | 卡首批切流 |
|
||||
| **1854 账号无盐 MD5 弱口令** | 安全建议书,切流后推升级 |
|
||||
| **PG 9.4→15 / Flowable 5→6 生产升级窗口** | Runbook 就位,待客户隔离准生产环境演练 |
|
||||
|
||||
---
|
||||
|
||||
**维护**:本文档随 §7 路线推进滚动更新;§6 新增功能架构待拍板后,转为正式架构决策回写 `eip4-platform/docs/架构设计.md`。
|
||||
90
docs/归档/F2-12-UI走查清单.md
Normal file
90
docs/归档/F2-12-UI走查清单.md
Normal file
@@ -0,0 +1,90 @@
|
||||
# F2-12 UI/UE 设计走查清单
|
||||
|
||||
> 第一轮日期:2026-06-11 | 第二轮日期:2026-06-12
|
||||
> 方法:Chrome DevTools / Playwright 实测(vite 5173 + dev 8093,admin 真实登录),对照 claude-design 原型
|
||||
> 实测页面:type1 物资供应商临时合格设置 / sys-admin-user 用户查询 / type200 月度检查整改
|
||||
|
||||
## 重要更正
|
||||
|
||||
F1-4 的 26 张 e2e 截图全部呈现「空工作台+loading」,**实测确认是截图竞态**(截图早于渲染完成),渲染本身正常。但 e2e 截图作为视觉证据失效——schema-samples.spec 需在截图前等 networkidle/内容可见。
|
||||
|
||||
## P0(功能性,阻塞交付)
|
||||
|
||||
| # | 问题 | 证据/根因 | 修法 |
|
||||
|---|------|----------|------|
|
||||
| 1 | **86% 页面标题=「测试」**(1,291/1,493) | 转换器 title 取源错误(view_template.name 是对的,XML 内某字段=测试) | 修 TemplateToAmisConverter title 来源→重批重入库(流程已标准化) |
|
||||
| 2 | **报表取数 500**(337 个 type200 疑似全中) | `Unsupported class file major version 70`:Groovy 4.0.27 ASM 不认 JDK26 字节码,取数链路 Groovy 语义分析解析 JDK26 编译的服务端类时崩 | 根 pom 设 maven.compiler.release=21(保真层不需要 JDK26 特性)→重打包;或升 Groovy。修后报表族抽测 |
|
||||
| 3 | **深链接被 Tab 吞**:直开 /page/:id 内容正确但 Tab 栏停在「工作台」高亮 | AppShell.tsx:74-80 明确「路径不在 tab 列表则不自动新增」 | 深链接时把当前路由作为新 Tab 加入并激活(带模板名做 Tab 题——又依赖 P0-1 标题修复) |
|
||||
|
||||
## P1(体验,交付前应修)
|
||||
|
||||
| # | 问题 | 说明 |
|
||||
|---|------|------|
|
||||
| 4 | 报表查询区暴露「主键」下拉做查询条件 | 转换器对 report 族查询列的选择逻辑不合理(主键 UUID 不可人查);查询列应取业务列 |
|
||||
| 5 | e2e 截图竞态 | schema-samples.spec 截图前加内容可见等待,否则视觉证据失效 |
|
||||
| 6 | 用户列表「未知」状态标签 | isactive 映射不全或脏数据;F2-10 一并处理 |
|
||||
| 7 | 查询面板布局密度 | 标签+控件左挤、搜索按钮孤悬右侧;对照原型 form-grid 调 amis 主题/包装容器 |
|
||||
| 8 | 状态标签风格 | amis 默认绿实底 vs 原型浅底+前置点 tag;amis cxd 主题变量对齐 theme.css token |
|
||||
|
||||
## P2(打磨,可后置)
|
||||
|
||||
- 分页条在表头右上(amis 默认)vs 原型底部居右
|
||||
- 空态插画与原型风格不一致
|
||||
- 深色模式下 amis 区域未跟随(壳层已支持)
|
||||
- 操作按钮主次级不分(查看/修改状态都是描边灰)
|
||||
|
||||
## 正面确认
|
||||
|
||||
- 壳层(顶栏/侧栏/Tab/搜索/主题)视觉还原原型程度高
|
||||
- sys-admin-user 页(amis schema 形态)数据/分页/过滤/标签完整可用,证明 schema 路线成立
|
||||
- 行级权限/登录态/错误降级链路工作正常
|
||||
|
||||
---
|
||||
|
||||
## 第二轮走查(F2-12 P1/P2 修复,2026-06-12)
|
||||
|
||||
### 变更说明
|
||||
|
||||
| 文件 | 变更内容 |
|
||||
|------|---------|
|
||||
| `eip4-web/src/shell/amis-theme.css`(新建) | amis cxd 主题变量覆盖:品牌色 `--colors-brand-5: #2B5CE6`、圆角 `--borders-radius-3: 6px`、字体族、中性色,对齐 theme.css token;深色模式 `[data-dark="1"]` 下映射暗色 token;状态标签 `.label-*` 覆盖为浅底+前置圆点;查询面板密度压缩;表格行高 42px |
|
||||
| `eip4-web/src/main.tsx` | 在 theme.css 后引入 amis-theme.css |
|
||||
| `eip4-platform/.../sys-admin-user.json`(src+target) | state mapping 补充 `"4": "已注销"`,覆盖实际数据中 state=4 的 23 条记录(之前显示"未知") |
|
||||
|
||||
### amis 主题变量机制说明
|
||||
|
||||
amis 6.x SDK(cxd 主题)在 `:root` 暴露两层 token:
|
||||
|
||||
1. **底层语义 token**:`--colors-brand-5`(主色)、`--borders-radius-3`(基础圆角)、`--fonts-base-family`(字体族)等,由具体组件变量引用。
|
||||
2. **组件变量**:`--Button--primary-bg: var(--colors-brand-5)`、`--Form-input-borderRadius: var(--borders-radius-3)` 等。
|
||||
|
||||
本次只覆盖底层 token,不逐一改写组件变量,变更面最小(6 个底层 token 覆盖 ~60 个组件变量)。
|
||||
|
||||
深色模式:`[data-dark="1"]` 挂在 `<html>` 上,CSS 特异性高于 `:root`,amis 区域随之切换 fill/text/line 中性色系,达到深色跟随效果。
|
||||
|
||||
### 二轮逐屏走查结论
|
||||
|
||||
| 屏幕 | 截图 | 结论 | 遗留 |
|
||||
|------|------|------|------|
|
||||
| 工作台 | `01-workbench.png` | **可接受** — 品牌色、卡片圆角、字体均对齐原型 | — |
|
||||
| 待办中心 | `02-todo.png` / `07-todo-page.png` | **可接受** — 待办列表、标签颜色正常 | — |
|
||||
| 用户查询(系统管理) | `03-sys-user-list.png` | **已修** — 状态标签浅底+前置圆点;state=4"已注销"已显示;--colors-brand-5=#2B5CE6 核验通过 | — |
|
||||
| 角色与成员 | `04-sys-role.png` | **可接受** — 表格密度、分页位置可接受 | — |
|
||||
| 深色模式(用户查询) | `05-sys-user-dark.png` | **已修** — amis 区域随 data-dark="1" 切换;label-success bg=#18352a color=#4cc98a 核验通过 | — |
|
||||
| 消息 Drawer | `06-notice-drawer.png` | **可接受** — 抽屉背景/分割线对齐壳层 token | — |
|
||||
|
||||
### 各走查项处置结论
|
||||
|
||||
| # | 走查项 | 处置 | 状态 |
|
||||
|---|--------|------|------|
|
||||
| 1 | amis 主题变量层落地 | 新建 amis-theme.css,覆盖品牌色/圆角/字体/中性色;main.tsx 引入 | **已完成** |
|
||||
| 2 | 深色模式 amis 区域跟随 | `[data-dark="1"]` 覆盖层,实测截图验证 | **已完成** |
|
||||
| 3 | 状态标签风格(浅底+前置点) | `.label-*` 全局 CSS 覆盖,inline-flex + ::before 圆点 | **已完成** |
|
||||
| 4 | 查询面板布局密度 | amis-theme.css 压缩 .cxd-Crud-filter 行间距/标签宽 | **已完成** |
|
||||
| 5 | 分页位置 | footerToolbar pagination 保留 amis 默认(底部右对齐),可接受;headerToolbar pagination 在表格右上,符合 amis 惯例 | **可接受,保留** |
|
||||
| 6 | state=4「未知」→「已注销」 | sys-admin-user.json mapping 补充 "4" 键,src+target 同步 | **已完成** |
|
||||
| 7 | 空态/取数失败区分 | amis 渲染异常已有 SchemaErrorCard;crud api 请求失败 amis 内置会在表格区显示 toast/错误提示(实测两页确认:sys-admin-user 后端返回 5xx 时 amis 内置 ajax 错误 toast 可见,无需额外配置) | **可接受** |
|
||||
|
||||
### e2e 回归
|
||||
|
||||
基线 75/75,F2-12 修改均为纯 CSS + JSON schema,不涉及 TS 逻辑,e2e 回归预期无回归(见终验结果)。
|
||||
200
docs/归档/F2-17-审计基线-2026-06-13-升级.md
Normal file
200
docs/归档/F2-17-审计基线-2026-06-13-升级.md
Normal file
@@ -0,0 +1,200 @@
|
||||
# F2-17 EIP4 前端组件真实性审计基线
|
||||
|
||||
> 扫描时间: 2026-06-13 16:41:27
|
||||
> 扫描目录: `/Users/zhengwr/workspace/eip3/eip4-platform/platform-converter/转换产物/schema`
|
||||
> 本报告由 `schema_reality_audit.py` 自动生成,只读扫描,可重复运行。
|
||||
|
||||
## 一、汇总表
|
||||
|
||||
| 指标 | 数值 |
|
||||
|------|------|
|
||||
| 总页数 | 1489 |
|
||||
| CRUD 列表页 | 1293 |
|
||||
| Form 表单页 | 70 |
|
||||
| JSON 解析失败 | 0 |
|
||||
|
||||
| 缺陷编号 | 缺陷描述 | 静态命中页数 | 类别 |
|
||||
|---------|---------|---------|------|
|
||||
| D1 | 人员/引用列裸显示 id | 602 | 🟢 运行时已修(审计盲区) |
|
||||
| D2 | 按钮死桩(未配编辑表单/该单据未配) | 631 | 🔴 静态真缺口 |
|
||||
| D3 | 长文本/富文本错配单行 input-text | 138 | 🟡 大面已修,残余 e2e 复核 |
|
||||
| D4 | 弹窗嵌整页(双确认取消风险) | 108 | 🟢 运行时已修(审计盲区) |
|
||||
| D5 | 依赖 picker 后端 | 911 | 🟢 已弹窗化(picker,审计盲区) |
|
||||
| D6 | CRUD 页受后端不分页缺陷影响 | 1293 | 🟢 运行时已修(审计盲区) |
|
||||
|
||||
> **审计盲区说明(§4.3/§7-2)**:🟢 标记项的静态计数是产物快照,运行时已解决,**不计真实缺口**,改用 e2e 验。
|
||||
> - D1:人员/引用列裸 id → 运行时 UserColumnResolver 解析任意引用实体的 _DISPLAY__(662828c+2a6c1d0)
|
||||
> - D4:弹窗嵌整页 → 运行时 format=amis 剥 page 壳,弹窗只渲表单本体(a021f33)
|
||||
> - D5:依赖 picker 后端 → SelectDialog 已弹窗化为 amis picker 多列对照,运行时 /api/picker 供列(9d92df2)
|
||||
> - D6:CRUD 不分页 → 运行时 FlowController 分页翻译(_SEARCH 合成流)
|
||||
|
||||
## 二、D1 人员列裸显示 id
|
||||
|
||||
命中页数: **602**,以下展示前 10 个 templateId 及首条命中:
|
||||
|
||||
| templateId | 命中详情 |
|
||||
|-----------|---------|
|
||||
| `00e7a83b-dd1f-4d7a-a574-bc362bc785d2` | name=REGISTERBY_DISPLAY__ label=登记人 | label 含关键字 '人': 登记人 |
|
||||
| `00ff3f9d-b744-4e55-a731-f98d16d6f7fe` | name=ATTENDEEAMOUNT label=与会人数 | label 含关键字 '人': 与会人数 |
|
||||
| `021e3ba7-e03a-412a-9f0e-c20ef440a885` | name=APPLYNAME_DISPLAY__ label=申请人 | label 含关键字 '人': 申请人 |
|
||||
| `023fe74b-3d5b-4551-ac90-b8b4e6341bd0` | name=REIMBURSEMENTNAME_DISPLAY__ label=报销人 | label 含关键字 '人': 报销人 |
|
||||
| `031d16c6-1944-47c9-98b7-08e40404f0b7` | name=USERID_DISPLAY__ label=姓名 | name 命中正则: USERID_DISPLAY__ |
|
||||
| `03c5fc8f-e6c9-4e3d-b3a1-3be73cf053b0` | name=CONTACTPERSONID_DISPLAY__ label=联系人 | name 命中正则: CONTACTPERSONID_DISPLAY__ |
|
||||
| `03d58f2c-d41e-437f-8cc3-a83209505f8d` | name=USERID_DISPLAY__ label=用户 | name 命中正则: USERID_DISPLAY__ |
|
||||
| `0567316f-6a71-47f6-a669-eb8c91670e45` | name=OPERATOR_DISPLAY__ label=经办人 | label 含关键字 '人': 经办人 |
|
||||
| `0697af60-7c07-48ac-944c-91ca754290a4` | name=RECORDER_DISPLAY__ label=审核人 | label 含关键字 '人': 审核人 |
|
||||
| `06e27e60-8755-4e67-9de6-36ece947969e` | name=APPLYER_DISPLAY__ label=申请人 | label 含关键字 '人': 申请人 |
|
||||
|
||||
## 三、D2 按钮死桩
|
||||
|
||||
命中页数: **631**,以下展示前 10 个 templateId 及首条命中:
|
||||
|
||||
| templateId | 命中详情 |
|
||||
|-----------|---------|
|
||||
| `009c4f52-636a-4688-8148-75cabe83fd83` | 该单据未配编辑表单 |
|
||||
| `00e7a83b-dd1f-4d7a-a574-bc362bc785d2` | 该单据未配编辑表单 |
|
||||
| `00f6638e-72c7-4834-96ff-904935375951` | 该单据未配编辑表单 |
|
||||
| `01711eee-5b37-4801-895c-90195b06cc51` | 该单据未配编辑表单 |
|
||||
| `017d6c4c-d84f-40c3-bf70-73e83c41fc23` | 该单据未配编辑表单 |
|
||||
| `021e3ba7-e03a-412a-9f0e-c20ef440a885` | 该单据未配编辑表单 |
|
||||
| `023fe74b-3d5b-4551-ac90-b8b4e6341bd0` | 该单据未配编辑表单 |
|
||||
| `031d16c6-1944-47c9-98b7-08e40404f0b7` | 该单据未配编辑表单 |
|
||||
| `03c5fc8f-e6c9-4e3d-b3a1-3be73cf053b0` | 该单据未配编辑表单 |
|
||||
| `03d58f2c-d41e-437f-8cc3-a83209505f8d` | 该单据未配编辑表单 |
|
||||
|
||||
## 四、D3 长文本字段错配
|
||||
|
||||
命中页数: **138**,以下展示前 10 个 templateId 及首条命中:
|
||||
|
||||
| templateId | 命中详情 |
|
||||
|-----------|---------|
|
||||
| `00e7a83b-dd1f-4d7a-a574-bc362bc785d2` | name=APPLYCONTENT label=登记内容 |
|
||||
| `017d6c4c-d84f-40c3-bf70-73e83c41fc23` | name=REMARK label=备注 |
|
||||
| `04da8989-3627-4360-9834-bb55178546dd` | name=PERSONREMARK label=备注 |
|
||||
| `05e99b05-2362-4c16-b905-ae9f6b3750b9` | name=REMARK label=备注 |
|
||||
| `062041e3-0862-49b1-a304-34c873ac5b9e` | name=DESCRIPTION label=描述 |
|
||||
| `067b7bcb-7124-4a83-95f0-cfbaaff1d6b1` | name=DESCRIPTION label=描述 |
|
||||
| `0697af60-7c07-48ac-944c-91ca754290a4` | name=APPROVALCONTENT label=审核内容 |
|
||||
| `081c1fef-9b3c-489f-b467-b866ace68ca5` | name=REPORTCONTENT label=施工方案名称 |
|
||||
| `086ef320-9f86-4d70-b9c5-4fa6b6880da5` | name=SUBREMARK label=备注 |
|
||||
| `088ce7c7-c536-405e-bb37-c5b5e7172f52` | name=REMARK label=备注 |
|
||||
|
||||
## 五、D4 弹窗嵌整页
|
||||
|
||||
命中页数: **108**,以下展示前 10 个 templateId 及首条命中:
|
||||
|
||||
| templateId | 命中详情 |
|
||||
|-----------|---------|
|
||||
| `00551ef5-1c76-4015-bec9-2e1c8b631deb` | schemaApi=get:/api/page/schema/6000d02f-2069-4e5b-9a7f-a5ba2b560828?format=amis |
|
||||
| `081c1fef-9b3c-489f-b467-b866ace68ca5` | schemaApi=get:/api/page/schema/6e033687-403e-46f4-8897-ba59a90f2a50?format=amis |
|
||||
| `09aaa5dd-56d3-4364-a5ad-e77480d4d0a9` | schemaApi=get:/api/page/schema/81ca5026-ccd4-48f0-a504-a6584d1253a6?format=amis |
|
||||
| `0b2c7a3f-4a8c-48b7-9f4d-239e36a29c72` | schemaApi=get:/api/page/schema/6b622f06-1abc-450c-895f-761259977cc8?format=amis |
|
||||
| `0b2e5f73-98c9-4f59-a9cc-0bc1cd87d201` | schemaApi=get:/api/page/schema/2d408ea9-4aa6-4fb2-b94c-504ab762b3cd?format=amis |
|
||||
| `0dab3418-8233-4f90-896e-f087b943a393` | schemaApi=get:/api/page/schema/aae46962-bf76-455b-8d01-0fa621a6bbd1?format=amis |
|
||||
| `11b66410-e20a-4d08-b01d-344b1e6f65dd` | schemaApi=get:/api/page/schema/6b622f06-1abc-450c-895f-761259977cc8?format=amis |
|
||||
| `14a0f2e3-77b0-4433-a8b8-b7fc63ba0813` | schemaApi=get:/api/page/schema/cb66a282-41d4-4935-b082-adc2ac413c32?format=amis |
|
||||
| `174c6a9f-3226-47ff-afad-4daf26b779a1` | schemaApi=get:/api/page/schema/9ec230fa-649c-42b9-83fc-6d7c6cffcd8c?format=amis |
|
||||
| `191cfb4b-0ef4-4d1a-822e-dac767689405` | schemaApi=get:/api/page/schema/04da8989-3627-4360-9834-bb55178546dd?format=amis |
|
||||
|
||||
## 六、D5 依赖 picker 后端
|
||||
|
||||
命中页数: **911**,以下展示前 10 个 templateId 及首条命中:
|
||||
|
||||
| templateId | 命中详情 |
|
||||
|-----------|---------|
|
||||
| `00511ac1-ee64-4ecd-a550-22842ee5be72` | name=MEETINGID dialogId=a9a6235a-773b-48fe-a52c-549cb3c3f39b |
|
||||
| `00551ef5-1c76-4015-bec9-2e1c8b631deb` | name=UNITNAME dialogId=93a5fb27-fdf1-41fb-9ce5-cec44826a6fa |
|
||||
| `009c4f52-636a-4688-8148-75cabe83fd83` | name=PROJECTNAMEID dialogId=07eef963-fd17-42a5-997c-219f0ec18cff |
|
||||
| `00a64619-0014-412f-8ca9-95edcf988c2f` | name=MEETINGROOMDISPATCHID dialogId=unknown |
|
||||
| `00e7a83b-dd1f-4d7a-a574-bc362bc785d2` | name=ORGID dialogId=1a998b23-371d-4ebb-911f-6465a56a6809 |
|
||||
| `00ff3f9d-b744-4e55-a731-f98d16d6f7fe` | name=APPLYUSER dialogId=76d2f950-ef40-4eff-89ec-98ad9a4976b9 |
|
||||
| `017d6c4c-d84f-40c3-bf70-73e83c41fc23` | name=EMPLOYEE dialogId=4982d448-a9d4-493e-9e1d-ebcd3c7dfcd6 |
|
||||
| `021e3ba7-e03a-412a-9f0e-c20ef440a885` | name=DEPART_ID dialogId=138b7ca7-befb-4a0c-bfc6-ed8fb4d4e434 |
|
||||
| `023fe74b-3d5b-4551-ac90-b8b4e6341bd0` | name=PROJECTID dialogId=66e57e6d-0cbb-40cf-8b84-c512345734b7 |
|
||||
| `0267be11-591a-4533-b7cc-079cef81086e` | name=ROLLOUTUSE dialogId=1b6820ad-bc7c-4eef-ac63-652cdf52c75f |
|
||||
|
||||
## 七、D6 受后端不分页缺陷影响的 CRUD 页(前 10)
|
||||
|
||||
命中页数: **1293**
|
||||
|
||||
| templateId |
|
||||
|-----------|
|
||||
| `00551ef5-1c76-4015-bec9-2e1c8b631deb` |
|
||||
| `00654052-f899-45d6-bbd4-04457c13025a` |
|
||||
| `009c4f52-636a-4688-8148-75cabe83fd83` |
|
||||
| `00e7a83b-dd1f-4d7a-a574-bc362bc785d2` |
|
||||
| `00f6638e-72c7-4834-96ff-904935375951` |
|
||||
| `00ff3f9d-b744-4e55-a731-f98d16d6f7fe` |
|
||||
| `01711eee-5b37-4801-895c-90195b06cc51` |
|
||||
| `017d6c4c-d84f-40c3-bf70-73e83c41fc23` |
|
||||
| `021e3ba7-e03a-412a-9f0e-c20ef440a885` |
|
||||
| `023fe74b-3d5b-4551-ac90-b8b4e6341bd0` |
|
||||
|
||||
## 八、Picker dialogId 去重清单
|
||||
|
||||
共 **150** 个唯一 dialogId(后端修 picker 时需逐一验证),以下展示前 20 个:
|
||||
|
||||
| # | dialogId |
|
||||
|---|---------|
|
||||
| 1 | `00f6638e-72c7-4834-96ff-904935375951` |
|
||||
| 2 | `00ff3f9d-b744-4e55-a731-f98d16d6f7fe` |
|
||||
| 3 | `01711eee-5b37-4801-895c-90195b06cc51` |
|
||||
| 4 | `0211a0e2-2073-4b24-b59f-e6757e5dcff0` |
|
||||
| 5 | `023fe74b-3d5b-4551-ac90-b8b4e6341bd0` |
|
||||
| 6 | `07eef963-fd17-42a5-997c-219f0ec18cff` |
|
||||
| 7 | `08357c7a-42f7-46e4-bdf7-4556947557e1` |
|
||||
| 8 | `090981ba-0c10-4d84-92dc-80e226594480` |
|
||||
| 9 | `093cd444-7bff-4f47-ad30-3b9187ce8c4a` |
|
||||
| 10 | `0b2c7a3f-4a8c-48b7-9f4d-239e36a29c72` |
|
||||
| 11 | `0d674631-7a53-44b0-bb41-6aa201ede8ec` |
|
||||
| 12 | `0d6df814-ccfd-4689-a2d8-408110c2d12f` |
|
||||
| 13 | `0f95521e-5eb2-455f-9cbd-d9a8a5de8d11` |
|
||||
| 14 | `1113ddf3-94c0-4b91-8657-dfda08da7105` |
|
||||
| 15 | `138b7ca7-befb-4a0c-bfc6-ed8fb4d4e434` |
|
||||
| 16 | `15fcc491-74e1-422a-862b-ebe027ba8bd7` |
|
||||
| 17 | `1964fda1-b020-4a8b-95e2-dc32de36e74a` |
|
||||
| 18 | `1a998b23-371d-4ebb-911f-6465a56a6809` |
|
||||
| 19 | `1b3bad0b-a24b-4347-9466-db78f7432756` |
|
||||
| 20 | `1b6820ad-bc7c-4eef-ac63-652cdf52c75f` |
|
||||
|
||||
|
||||
## 十、uitype × 模板类型 × 使用频次(DB 存量真实用量,§7-2)
|
||||
|
||||
> 源:`view_template.xml` 全量扫描(1489/1489 有 xml)。
|
||||
> 用途:让 §4.2 的「高级模板类型」「真丢失控件」覆盖缺口按**存量真实频次**排序,而非按清单平铺。
|
||||
|
||||
### 10.1 uitype 频次 Top(出现次数 / 涉及模板数)
|
||||
|
||||
| uitype | 出现次数 | 模板数 |
|
||||
|--------|---------|--------|
|
||||
| TextField | 2164 | 892 |
|
||||
| SelectDialog | 1772 | 940 |
|
||||
| ComboBox | 1555 | 696 |
|
||||
| DoublePopupDateField | 763 | 508 |
|
||||
| NumberField | 437 | 183 |
|
||||
| PopupDateField | 284 | 139 |
|
||||
| MultiSelectDialog | 148 | 140 |
|
||||
| CheckBox | 60 | 53 |
|
||||
| TextArea | 2 | 1 |
|
||||
|
||||
### 10.2 模板根类型分布
|
||||
|
||||
| 根元素 | 模板数 |
|
||||
|--------|--------|
|
||||
| `crud` | 956 |
|
||||
| `report` | 337 |
|
||||
| `tree` | 106 |
|
||||
| `form` | 70 |
|
||||
| `group` | 20 |
|
||||
|
||||
### 10.3 高级模板结构存量(§4.2「高级模板类型缺失」按频次排序)
|
||||
|
||||
| 结构标记 | 涉及模板数 |
|
||||
|---------|-----------|
|
||||
|
||||
### 10.4 §4.2「真丢失控件」存量(决定 §7-4 是否值得做)
|
||||
|
||||
| 控件 uitype | 出现次数 | 模板数 | 结论 |
|
||||
|------------|---------|--------|------|
|
||||
| TwinColSelect | 0 | 0 | 零存量,可不做 |
|
||||
| PasswordField | 0 | 0 | 零存量,可不做 |
|
||||
152
docs/归档/F2-17-组件真实性审计-修复后复测.md
Normal file
152
docs/归档/F2-17-组件真实性审计-修复后复测.md
Normal file
@@ -0,0 +1,152 @@
|
||||
# F2-17 EIP4 前端组件真实性审计基线
|
||||
|
||||
> 扫描时间: 2026-06-12 14:35:31
|
||||
> 扫描目录: `/Users/zhengwr/workspace/eip3/eip4-platform/platform-converter/转换产物/schema`
|
||||
> 本报告由 `schema_reality_audit.py` 自动生成,只读扫描,可重复运行。
|
||||
|
||||
## 一、汇总表
|
||||
|
||||
| 指标 | 数值 |
|
||||
|------|------|
|
||||
| 总页数 | 1489 |
|
||||
| CRUD 列表页 | 1293 |
|
||||
| Form 表单页 | 70 |
|
||||
| JSON 解析失败 | 0 |
|
||||
|
||||
| 缺陷编号 | 缺陷描述 | 命中页数 |
|
||||
|---------|---------|---------|
|
||||
| D1 | 人员列裸显示 id(无 mapping/tpl) | 603 |
|
||||
| D2 | 按钮死桩(未配编辑表单/该单据未配) | 631 |
|
||||
| D3 | 长文本/富文本错配单行 input-text | 138 |
|
||||
| D4 | 弹窗嵌整页(双确认取消风险) | 108 |
|
||||
| D5 | 依赖 picker 后端(当前解析失败) | 911 |
|
||||
| D6 | CRUD 页受后端不分页缺陷影响 | 1293 |
|
||||
|
||||
## 二、D1 人员列裸显示 id
|
||||
|
||||
命中页数: **603**,以下展示前 10 个 templateId 及首条命中:
|
||||
|
||||
| templateId | 命中详情 |
|
||||
|-----------|---------|
|
||||
| `00e7a83b-dd1f-4d7a-a574-bc362bc785d2` | name=REGISTERBY label=登记人 | label 含关键字 '人': 登记人 |
|
||||
| `00ff3f9d-b744-4e55-a731-f98d16d6f7fe` | name=ATTENDEEAMOUNT label=与会人数 | label 含关键字 '人': 与会人数 |
|
||||
| `021e3ba7-e03a-412a-9f0e-c20ef440a885` | name=APPLYNAME label=申请人 | label 含关键字 '人': 申请人 |
|
||||
| `023fe74b-3d5b-4551-ac90-b8b4e6341bd0` | name=REIMBURSEMENTNAME label=报销人 | label 含关键字 '人': 报销人 |
|
||||
| `031d16c6-1944-47c9-98b7-08e40404f0b7` | name=USERID label=姓名 | name 命中正则: USERID |
|
||||
| `03c5fc8f-e6c9-4e3d-b3a1-3be73cf053b0` | name=CONTACTPERSONID label=联系人 | name 命中正则: CONTACTPERSONID |
|
||||
| `03d58f2c-d41e-437f-8cc3-a83209505f8d` | name=USERID label=用户 | name 命中正则: USERID |
|
||||
| `0567316f-6a71-47f6-a669-eb8c91670e45` | name=OPERATOR label=经办人 | label 含关键字 '人': 经办人 |
|
||||
| `0697af60-7c07-48ac-944c-91ca754290a4` | name=RECORDER label=审核人 | label 含关键字 '人': 审核人 |
|
||||
| `06e27e60-8755-4e67-9de6-36ece947969e` | name=APPLYER label=申请人 | label 含关键字 '人': 申请人 |
|
||||
|
||||
## 三、D2 按钮死桩
|
||||
|
||||
命中页数: **631**,以下展示前 10 个 templateId 及首条命中:
|
||||
|
||||
| templateId | 命中详情 |
|
||||
|-----------|---------|
|
||||
| `009c4f52-636a-4688-8148-75cabe83fd83` | 该单据未配编辑表单 |
|
||||
| `00e7a83b-dd1f-4d7a-a574-bc362bc785d2` | 该单据未配编辑表单 |
|
||||
| `00f6638e-72c7-4834-96ff-904935375951` | 该单据未配编辑表单 |
|
||||
| `01711eee-5b37-4801-895c-90195b06cc51` | 该单据未配编辑表单 |
|
||||
| `017d6c4c-d84f-40c3-bf70-73e83c41fc23` | 该单据未配编辑表单 |
|
||||
| `021e3ba7-e03a-412a-9f0e-c20ef440a885` | 该单据未配编辑表单 |
|
||||
| `023fe74b-3d5b-4551-ac90-b8b4e6341bd0` | 该单据未配编辑表单 |
|
||||
| `031d16c6-1944-47c9-98b7-08e40404f0b7` | 该单据未配编辑表单 |
|
||||
| `03c5fc8f-e6c9-4e3d-b3a1-3be73cf053b0` | 该单据未配编辑表单 |
|
||||
| `03d58f2c-d41e-437f-8cc3-a83209505f8d` | 该单据未配编辑表单 |
|
||||
|
||||
## 四、D3 长文本字段错配
|
||||
|
||||
命中页数: **138**,以下展示前 10 个 templateId 及首条命中:
|
||||
|
||||
| templateId | 命中详情 |
|
||||
|-----------|---------|
|
||||
| `00e7a83b-dd1f-4d7a-a574-bc362bc785d2` | name=APPLYCONTENT label=登记内容 |
|
||||
| `017d6c4c-d84f-40c3-bf70-73e83c41fc23` | name=REMARK label=备注 |
|
||||
| `04da8989-3627-4360-9834-bb55178546dd` | name=PERSONREMARK label=备注 |
|
||||
| `05e99b05-2362-4c16-b905-ae9f6b3750b9` | name=REMARK label=备注 |
|
||||
| `062041e3-0862-49b1-a304-34c873ac5b9e` | name=DESCRIPTION label=描述 |
|
||||
| `067b7bcb-7124-4a83-95f0-cfbaaff1d6b1` | name=DESCRIPTION label=描述 |
|
||||
| `0697af60-7c07-48ac-944c-91ca754290a4` | name=APPROVALCONTENT label=审核内容 |
|
||||
| `081c1fef-9b3c-489f-b467-b866ace68ca5` | name=REPORTCONTENT label=施工方案名称 |
|
||||
| `086ef320-9f86-4d70-b9c5-4fa6b6880da5` | name=SUBREMARK label=备注 |
|
||||
| `088ce7c7-c536-405e-bb37-c5b5e7172f52` | name=REMARK label=备注 |
|
||||
|
||||
## 五、D4 弹窗嵌整页
|
||||
|
||||
命中页数: **108**,以下展示前 10 个 templateId 及首条命中:
|
||||
|
||||
| templateId | 命中详情 |
|
||||
|-----------|---------|
|
||||
| `00551ef5-1c76-4015-bec9-2e1c8b631deb` | schemaApi=get:/api/page/schema/6000d02f-2069-4e5b-9a7f-a5ba2b560828?format=amis |
|
||||
| `081c1fef-9b3c-489f-b467-b866ace68ca5` | schemaApi=get:/api/page/schema/6e033687-403e-46f4-8897-ba59a90f2a50?format=amis |
|
||||
| `09aaa5dd-56d3-4364-a5ad-e77480d4d0a9` | schemaApi=get:/api/page/schema/81ca5026-ccd4-48f0-a504-a6584d1253a6?format=amis |
|
||||
| `0b2c7a3f-4a8c-48b7-9f4d-239e36a29c72` | schemaApi=get:/api/page/schema/6b622f06-1abc-450c-895f-761259977cc8?format=amis |
|
||||
| `0b2e5f73-98c9-4f59-a9cc-0bc1cd87d201` | schemaApi=get:/api/page/schema/2d408ea9-4aa6-4fb2-b94c-504ab762b3cd?format=amis |
|
||||
| `0dab3418-8233-4f90-896e-f087b943a393` | schemaApi=get:/api/page/schema/aae46962-bf76-455b-8d01-0fa621a6bbd1?format=amis |
|
||||
| `11b66410-e20a-4d08-b01d-344b1e6f65dd` | schemaApi=get:/api/page/schema/6b622f06-1abc-450c-895f-761259977cc8?format=amis |
|
||||
| `14a0f2e3-77b0-4433-a8b8-b7fc63ba0813` | schemaApi=get:/api/page/schema/cb66a282-41d4-4935-b082-adc2ac413c32?format=amis |
|
||||
| `174c6a9f-3226-47ff-afad-4daf26b779a1` | schemaApi=get:/api/page/schema/9ec230fa-649c-42b9-83fc-6d7c6cffcd8c?format=amis |
|
||||
| `191cfb4b-0ef4-4d1a-822e-dac767689405` | schemaApi=get:/api/page/schema/04da8989-3627-4360-9834-bb55178546dd?format=amis |
|
||||
|
||||
## 六、D5 依赖 picker 后端
|
||||
|
||||
命中页数: **911**,以下展示前 10 个 templateId 及首条命中:
|
||||
|
||||
| templateId | 命中详情 |
|
||||
|-----------|---------|
|
||||
| `00511ac1-ee64-4ecd-a550-22842ee5be72` | name=MEETINGID dialogId=a9a6235a-773b-48fe-a52c-549cb3c3f39b |
|
||||
| `00551ef5-1c76-4015-bec9-2e1c8b631deb` | name=UNITNAME dialogId=93a5fb27-fdf1-41fb-9ce5-cec44826a6fa |
|
||||
| `009c4f52-636a-4688-8148-75cabe83fd83` | name=PROJECTNAMEID dialogId=07eef963-fd17-42a5-997c-219f0ec18cff |
|
||||
| `00a64619-0014-412f-8ca9-95edcf988c2f` | name=MEETINGROOMDISPATCHID dialogId=unknown |
|
||||
| `00e7a83b-dd1f-4d7a-a574-bc362bc785d2` | name=ORGID dialogId=1a998b23-371d-4ebb-911f-6465a56a6809 |
|
||||
| `00ff3f9d-b744-4e55-a731-f98d16d6f7fe` | name=APPLYUSER dialogId=76d2f950-ef40-4eff-89ec-98ad9a4976b9 |
|
||||
| `017d6c4c-d84f-40c3-bf70-73e83c41fc23` | name=EMPLOYEE dialogId=4982d448-a9d4-493e-9e1d-ebcd3c7dfcd6 |
|
||||
| `021e3ba7-e03a-412a-9f0e-c20ef440a885` | name=DEPART_ID dialogId=138b7ca7-befb-4a0c-bfc6-ed8fb4d4e434 |
|
||||
| `023fe74b-3d5b-4551-ac90-b8b4e6341bd0` | name=PROJECTID dialogId=66e57e6d-0cbb-40cf-8b84-c512345734b7 |
|
||||
| `0267be11-591a-4533-b7cc-079cef81086e` | name=ROLLOUTUSE dialogId=1b6820ad-bc7c-4eef-ac63-652cdf52c75f |
|
||||
|
||||
## 七、D6 受后端不分页缺陷影响的 CRUD 页(前 10)
|
||||
|
||||
命中页数: **1293**
|
||||
|
||||
| templateId |
|
||||
|-----------|
|
||||
| `00551ef5-1c76-4015-bec9-2e1c8b631deb` |
|
||||
| `00654052-f899-45d6-bbd4-04457c13025a` |
|
||||
| `009c4f52-636a-4688-8148-75cabe83fd83` |
|
||||
| `00e7a83b-dd1f-4d7a-a574-bc362bc785d2` |
|
||||
| `00f6638e-72c7-4834-96ff-904935375951` |
|
||||
| `00ff3f9d-b744-4e55-a731-f98d16d6f7fe` |
|
||||
| `01711eee-5b37-4801-895c-90195b06cc51` |
|
||||
| `017d6c4c-d84f-40c3-bf70-73e83c41fc23` |
|
||||
| `021e3ba7-e03a-412a-9f0e-c20ef440a885` |
|
||||
| `023fe74b-3d5b-4551-ac90-b8b4e6341bd0` |
|
||||
|
||||
## 八、Picker dialogId 去重清单
|
||||
|
||||
共 **150** 个唯一 dialogId(后端修 picker 时需逐一验证),以下展示前 20 个:
|
||||
|
||||
| # | dialogId |
|
||||
|---|---------|
|
||||
| 1 | `00f6638e-72c7-4834-96ff-904935375951` |
|
||||
| 2 | `00ff3f9d-b744-4e55-a731-f98d16d6f7fe` |
|
||||
| 3 | `01711eee-5b37-4801-895c-90195b06cc51` |
|
||||
| 4 | `0211a0e2-2073-4b24-b59f-e6757e5dcff0` |
|
||||
| 5 | `023fe74b-3d5b-4551-ac90-b8b4e6341bd0` |
|
||||
| 6 | `07eef963-fd17-42a5-997c-219f0ec18cff` |
|
||||
| 7 | `08357c7a-42f7-46e4-bdf7-4556947557e1` |
|
||||
| 8 | `090981ba-0c10-4d84-92dc-80e226594480` |
|
||||
| 9 | `093cd444-7bff-4f47-ad30-3b9187ce8c4a` |
|
||||
| 10 | `0b2c7a3f-4a8c-48b7-9f4d-239e36a29c72` |
|
||||
| 11 | `0d674631-7a53-44b0-bb41-6aa201ede8ec` |
|
||||
| 12 | `0d6df814-ccfd-4689-a2d8-408110c2d12f` |
|
||||
| 13 | `0f95521e-5eb2-455f-9cbd-d9a8a5de8d11` |
|
||||
| 14 | `1113ddf3-94c0-4b91-8657-dfda08da7105` |
|
||||
| 15 | `138b7ca7-befb-4a0c-bfc6-ed8fb4d4e434` |
|
||||
| 16 | `15fcc491-74e1-422a-862b-ebe027ba8bd7` |
|
||||
| 17 | `1964fda1-b020-4a8b-95e2-dc32de36e74a` |
|
||||
| 18 | `1a998b23-371d-4ebb-911f-6465a56a6809` |
|
||||
| 19 | `1b3bad0b-a24b-4347-9466-db78f7432756` |
|
||||
| 20 | `1b6820ad-bc7c-4eef-ac63-652cdf52c75f` |
|
||||
152
docs/归档/F2-17-组件真实性审计基线.md
Normal file
152
docs/归档/F2-17-组件真实性审计基线.md
Normal file
@@ -0,0 +1,152 @@
|
||||
# F2-17 EIP4 前端组件真实性审计基线
|
||||
|
||||
> 扫描时间: 2026-06-12 09:14:56
|
||||
> 扫描目录: `/Users/zhengwr/workspace/eip3/eip4-platform/platform-converter/转换产物/schema`
|
||||
> 本报告由 `schema_reality_audit.py` 自动生成,只读扫描,可重复运行。
|
||||
|
||||
## 一、汇总表
|
||||
|
||||
| 指标 | 数值 |
|
||||
|------|------|
|
||||
| 总页数 | 1489 |
|
||||
| CRUD 列表页 | 1293 |
|
||||
| Form 表单页 | 70 |
|
||||
| JSON 解析失败 | 0 |
|
||||
|
||||
| 缺陷编号 | 缺陷描述 | 命中页数 |
|
||||
|---------|---------|---------|
|
||||
| D1 | 人员列裸显示 id(无 mapping/tpl) | 603 |
|
||||
| D2 | 按钮死桩(未配编辑表单/该单据未配) | 712 |
|
||||
| D3 | 长文本/富文本错配单行 input-text | 144 |
|
||||
| D4 | 弹窗嵌整页(双确认取消风险) | 59 |
|
||||
| D5 | 依赖 picker 后端(当前解析失败) | 911 |
|
||||
| D6 | CRUD 页受后端不分页缺陷影响 | 1293 |
|
||||
|
||||
## 二、D1 人员列裸显示 id
|
||||
|
||||
命中页数: **603**,以下展示前 10 个 templateId 及首条命中:
|
||||
|
||||
| templateId | 命中详情 |
|
||||
|-----------|---------|
|
||||
| `00e7a83b-dd1f-4d7a-a574-bc362bc785d2` | name=REGISTERBY label=登记人 | label 含关键字 '人': 登记人 |
|
||||
| `00ff3f9d-b744-4e55-a731-f98d16d6f7fe` | name=ATTENDEEAMOUNT label=与会人数 | label 含关键字 '人': 与会人数 |
|
||||
| `021e3ba7-e03a-412a-9f0e-c20ef440a885` | name=APPLYNAME label=申请人 | label 含关键字 '人': 申请人 |
|
||||
| `023fe74b-3d5b-4551-ac90-b8b4e6341bd0` | name=REIMBURSEMENTNAME label=报销人 | label 含关键字 '人': 报销人 |
|
||||
| `031d16c6-1944-47c9-98b7-08e40404f0b7` | name=USERID label=姓名 | name 命中正则: USERID |
|
||||
| `03c5fc8f-e6c9-4e3d-b3a1-3be73cf053b0` | name=CONTACTPERSONID label=联系人 | name 命中正则: CONTACTPERSONID |
|
||||
| `03d58f2c-d41e-437f-8cc3-a83209505f8d` | name=USERID label=用户 | name 命中正则: USERID |
|
||||
| `0567316f-6a71-47f6-a669-eb8c91670e45` | name=OPERATOR label=经办人 | label 含关键字 '人': 经办人 |
|
||||
| `0697af60-7c07-48ac-944c-91ca754290a4` | name=RECORDER label=审核人 | label 含关键字 '人': 审核人 |
|
||||
| `06e27e60-8755-4e67-9de6-36ece947969e` | name=APPLYER label=申请人 | label 含关键字 '人': 申请人 |
|
||||
|
||||
## 三、D2 按钮死桩
|
||||
|
||||
命中页数: **712**,以下展示前 10 个 templateId 及首条命中:
|
||||
|
||||
| templateId | 命中详情 |
|
||||
|-----------|---------|
|
||||
| `00551ef5-1c76-4015-bec9-2e1c8b631deb` | 该单据未配编辑表单 |
|
||||
| `009c4f52-636a-4688-8148-75cabe83fd83` | 该单据未配编辑表单 |
|
||||
| `00e7a83b-dd1f-4d7a-a574-bc362bc785d2` | 该单据未配编辑表单 |
|
||||
| `00f6638e-72c7-4834-96ff-904935375951` | 该单据未配编辑表单 |
|
||||
| `01711eee-5b37-4801-895c-90195b06cc51` | 该单据未配编辑表单 |
|
||||
| `017d6c4c-d84f-40c3-bf70-73e83c41fc23` | 该单据未配编辑表单 |
|
||||
| `021e3ba7-e03a-412a-9f0e-c20ef440a885` | 该单据未配编辑表单 |
|
||||
| `023fe74b-3d5b-4551-ac90-b8b4e6341bd0` | 该单据未配编辑表单 |
|
||||
| `031d16c6-1944-47c9-98b7-08e40404f0b7` | 该单据未配编辑表单 |
|
||||
| `03c5fc8f-e6c9-4e3d-b3a1-3be73cf053b0` | 该单据未配编辑表单 |
|
||||
|
||||
## 四、D3 长文本字段错配
|
||||
|
||||
命中页数: **144**,以下展示前 10 个 templateId 及首条命中:
|
||||
|
||||
| templateId | 命中详情 |
|
||||
|-----------|---------|
|
||||
| `00e7a83b-dd1f-4d7a-a574-bc362bc785d2` | name=APPLYCONTENT label=登记内容 |
|
||||
| `017d6c4c-d84f-40c3-bf70-73e83c41fc23` | name=REMARK label=备注 |
|
||||
| `04da8989-3627-4360-9834-bb55178546dd` | name=PERSONREMARK label=备注 |
|
||||
| `05e99b05-2362-4c16-b905-ae9f6b3750b9` | name=REMARK label=备注 |
|
||||
| `062041e3-0862-49b1-a304-34c873ac5b9e` | name=DESCRIPTION label=描述 |
|
||||
| `067b7bcb-7124-4a83-95f0-cfbaaff1d6b1` | name=DESCRIPTION label=描述 |
|
||||
| `0697af60-7c07-48ac-944c-91ca754290a4` | name=APPROVALCONTENT label=审核内容 |
|
||||
| `081c1fef-9b3c-489f-b467-b866ace68ca5` | name=REPORTCONTENT label=施工方案名称 |
|
||||
| `086ef320-9f86-4d70-b9c5-4fa6b6880da5` | name=SUBREMARK label=备注 |
|
||||
| `088ce7c7-c536-405e-bb37-c5b5e7172f52` | name=REMARK label=备注 |
|
||||
|
||||
## 五、D4 弹窗嵌整页
|
||||
|
||||
命中页数: **59**,以下展示前 10 个 templateId 及首条命中:
|
||||
|
||||
| templateId | 命中详情 |
|
||||
|-----------|---------|
|
||||
| `0b2c7a3f-4a8c-48b7-9f4d-239e36a29c72` | schemaApi=get:/api/page/schema/6000d02f-2069-4e5b-9a7f-a5ba2b560828?format=amis |
|
||||
| `1964fda1-b020-4a8b-95e2-dc32de36e74a` | schemaApi=get:/api/page/schema/04da8989-3627-4360-9834-bb55178546dd?format=amis |
|
||||
| `1a35cb86-7473-4c8a-a43a-e223e719cb28` | schemaApi=get:/api/page/schema/04da8989-3627-4360-9834-bb55178546dd?format=amis |
|
||||
| `2054ee9b-e986-4bd1-becf-b53c93bb982c` | schemaApi=get:/api/page/schema/c2412b26-a02d-4134-beca-577a18775e9b?format=amis |
|
||||
| `209a68bd-77c9-48ce-9522-cbcb19b144e5` | schemaApi=get:/api/page/schema/7147a78b-8116-41f8-a729-dcf8193ca4e3?format=amis |
|
||||
| `21ad2d00-06eb-4ca6-9b97-cf06431b9a3f` | schemaApi=get:/api/page/schema/1d1d51b5-032c-4e08-9789-bf78a034aa93?format=amis |
|
||||
| `25310d37-e4ce-4426-be95-23645e60a4ff` | schemaApi=get:/api/page/schema/6538e7f3-6fa6-4ef2-a635-3c9cdf8bdc01?format=amis |
|
||||
| `28d7997e-fc9e-41d1-aa27-86dbb3d44380` | schemaApi=get:/api/page/schema/cb66a282-41d4-4935-b082-adc2ac413c32?format=amis |
|
||||
| `30b8f8fb-26be-4a07-87cf-2d66053acfb0` | schemaApi=get:/api/page/schema/6000d02f-2069-4e5b-9a7f-a5ba2b560828?format=amis |
|
||||
| `30f07343-c77a-46b9-bba4-695daeed47cc` | schemaApi=get:/api/page/schema/1a7d5038-ea05-4bf6-9f6f-bbc210483ba9?format=amis |
|
||||
|
||||
## 六、D5 依赖 picker 后端
|
||||
|
||||
命中页数: **911**,以下展示前 10 个 templateId 及首条命中:
|
||||
|
||||
| templateId | 命中详情 |
|
||||
|-----------|---------|
|
||||
| `00511ac1-ee64-4ecd-a550-22842ee5be72` | name=MEETINGID dialogId=a9a6235a-773b-48fe-a52c-549cb3c3f39b |
|
||||
| `00551ef5-1c76-4015-bec9-2e1c8b631deb` | name=UNITNAME dialogId=93a5fb27-fdf1-41fb-9ce5-cec44826a6fa |
|
||||
| `009c4f52-636a-4688-8148-75cabe83fd83` | name=PROJECTNAMEID dialogId=07eef963-fd17-42a5-997c-219f0ec18cff |
|
||||
| `00a64619-0014-412f-8ca9-95edcf988c2f` | name=MEETINGROOMDISPATCHID dialogId=unknown |
|
||||
| `00e7a83b-dd1f-4d7a-a574-bc362bc785d2` | name=ORGID dialogId=1a998b23-371d-4ebb-911f-6465a56a6809 |
|
||||
| `00ff3f9d-b744-4e55-a731-f98d16d6f7fe` | name=APPLYUSER dialogId=76d2f950-ef40-4eff-89ec-98ad9a4976b9 |
|
||||
| `017d6c4c-d84f-40c3-bf70-73e83c41fc23` | name=EMPLOYEE dialogId=4982d448-a9d4-493e-9e1d-ebcd3c7dfcd6 |
|
||||
| `021e3ba7-e03a-412a-9f0e-c20ef440a885` | name=DEPART_ID dialogId=138b7ca7-befb-4a0c-bfc6-ed8fb4d4e434 |
|
||||
| `023fe74b-3d5b-4551-ac90-b8b4e6341bd0` | name=PROJECTID dialogId=66e57e6d-0cbb-40cf-8b84-c512345734b7 |
|
||||
| `0267be11-591a-4533-b7cc-079cef81086e` | name=ROLLOUTUSE dialogId=1b6820ad-bc7c-4eef-ac63-652cdf52c75f |
|
||||
|
||||
## 七、D6 受后端不分页缺陷影响的 CRUD 页(前 10)
|
||||
|
||||
命中页数: **1293**
|
||||
|
||||
| templateId |
|
||||
|-----------|
|
||||
| `00551ef5-1c76-4015-bec9-2e1c8b631deb` |
|
||||
| `00654052-f899-45d6-bbd4-04457c13025a` |
|
||||
| `009c4f52-636a-4688-8148-75cabe83fd83` |
|
||||
| `00e7a83b-dd1f-4d7a-a574-bc362bc785d2` |
|
||||
| `00f6638e-72c7-4834-96ff-904935375951` |
|
||||
| `00ff3f9d-b744-4e55-a731-f98d16d6f7fe` |
|
||||
| `01711eee-5b37-4801-895c-90195b06cc51` |
|
||||
| `017d6c4c-d84f-40c3-bf70-73e83c41fc23` |
|
||||
| `021e3ba7-e03a-412a-9f0e-c20ef440a885` |
|
||||
| `023fe74b-3d5b-4551-ac90-b8b4e6341bd0` |
|
||||
|
||||
## 八、Picker dialogId 去重清单
|
||||
|
||||
共 **150** 个唯一 dialogId(后端修 picker 时需逐一验证),以下展示前 20 个:
|
||||
|
||||
| # | dialogId |
|
||||
|---|---------|
|
||||
| 1 | `00f6638e-72c7-4834-96ff-904935375951` |
|
||||
| 2 | `00ff3f9d-b744-4e55-a731-f98d16d6f7fe` |
|
||||
| 3 | `01711eee-5b37-4801-895c-90195b06cc51` |
|
||||
| 4 | `0211a0e2-2073-4b24-b59f-e6757e5dcff0` |
|
||||
| 5 | `023fe74b-3d5b-4551-ac90-b8b4e6341bd0` |
|
||||
| 6 | `07eef963-fd17-42a5-997c-219f0ec18cff` |
|
||||
| 7 | `08357c7a-42f7-46e4-bdf7-4556947557e1` |
|
||||
| 8 | `090981ba-0c10-4d84-92dc-80e226594480` |
|
||||
| 9 | `093cd444-7bff-4f47-ad30-3b9187ce8c4a` |
|
||||
| 10 | `0b2c7a3f-4a8c-48b7-9f4d-239e36a29c72` |
|
||||
| 11 | `0d674631-7a53-44b0-bb41-6aa201ede8ec` |
|
||||
| 12 | `0d6df814-ccfd-4689-a2d8-408110c2d12f` |
|
||||
| 13 | `0f95521e-5eb2-455f-9cbd-d9a8a5de8d11` |
|
||||
| 14 | `1113ddf3-94c0-4b91-8657-dfda08da7105` |
|
||||
| 15 | `138b7ca7-befb-4a0c-bfc6-ed8fb4d4e434` |
|
||||
| 16 | `15fcc491-74e1-422a-862b-ebe027ba8bd7` |
|
||||
| 17 | `1964fda1-b020-4a8b-95e2-dc32de36e74a` |
|
||||
| 18 | `1a998b23-371d-4ebb-911f-6465a56a6809` |
|
||||
| 19 | `1b3bad0b-a24b-4347-9466-db78f7432756` |
|
||||
| 20 | `1b6820ad-bc7c-4eef-ac63-652cdf52c75f` |
|
||||
235
docs/归档/framework定制视图-转换页审计-2026-06-17.md
Normal file
235
docs/归档/framework定制视图-转换页审计-2026-06-17.md
Normal file
@@ -0,0 +1,235 @@
|
||||
Entendido. Voy a sintetizar los 46 audits en un informe en Markdown. No necesito herramientas — los datos están todos en el prompt. Procedo a analizarlos y agruparlos.
|
||||
|
||||
Déjame estructurar el análisis: clasificación por verdict/severity, identificación de patrones de converter-defect (el más recurrente: tree-editable退化, navigation按钮丢失, grid CRUD按钮丢失, picker双斜杠, filterscript未挂), y la secuencia de fixes.
|
||||
|
||||
# EIP4 framework 层 46 定制视图迁移审计综合报告
|
||||
|
||||
> 路线认知:正确迁移 = 转换器→转换页(sys_page_schema)→保真层(/api/flow/、/api/picker/...)。手搓 bespoke 已弃用回退。转换器当前只有一个 navigation 按钮通用修复(未提交,需 BatchConvertCli→SchemaImportCli 全库重转才 live)。下文结论以"修转换器=通用收益最大"为优先级排序原则。
|
||||
|
||||
---
|
||||
|
||||
## 1. 总览看板
|
||||
|
||||
### 按 verdict 统计
|
||||
|
||||
| verdict | 数量 | 视图 |
|
||||
|---|---|---|
|
||||
| **等价** | 17 | 待办任务、我的发起任务、数据导入文件管理、用户选择框×3(全部不受控/受控/批量排除挂靠)、短消息、系统日志查询、自动编号规则、视图编辑列表-自定义、设置定时任务、外部邮件发件箱、外部邮件配置、实体、功能编辑列表-自定义、数据导入配置管理、已发送消息、电子邮件、用户组管理 |
|
||||
| **部分** | 18 | 功能模板下载模板管理/设置、功能管理、外部邮件收件箱、定义定时任务、实体分类-枚举组、审批表单删除、已办任务、已办任务(测试)、待办任务(五建)、收到的消息、数据权限配置、服务流、流程监控、用户登录历史、用户登录操作信息、用户管理、视图管理 |
|
||||
| **严重缺** | 2 | 分公司岗位管理、岗位管理 |
|
||||
| **bespoke未覆盖** | 7 | 个人设置、工作日历、报表、查看审批、流程定义、流程选择框、用户选择框-受控-org |
|
||||
| **(合计)** | **44** | (注:输入 46 条声明,实际 JSON 44 条;下文以 44 条实测为准) |
|
||||
|
||||
### 按 severity 统计
|
||||
|
||||
| severity | 数量 |
|
||||
|---|---|
|
||||
| 高 | 7 |
|
||||
| 中 | 14 |
|
||||
| 低 | 12 |
|
||||
| 无 | 11 |
|
||||
|
||||
### 核心判断:转换页"本就好" vs "真要动手"
|
||||
|
||||
- **转换页本就等价/接近、零或仅轻度退化(本就好)= 17 个**(全部"等价")。其中 **9 个"等价/无"且仅差挂菜单**(外部邮件发件箱/配置、实体、已发送消息、用户选择框×3 等),挂菜单后即 100% 可用。
|
||||
- **真要动手 = 27 个**(18 部分 + 2 严重缺 + 7 bespoke)。但这 27 个里:
|
||||
- **9 个是 not-mounted 主因**(挂菜单即解决,几乎零代码);
|
||||
- **10 个是 converter-defect**(改转换器一次惠及全库);
|
||||
- **7 个是纯 bespoke 无 XML**(转换器天然无能为力,另案);
|
||||
- 其余是 degraded/fidelity 杂项。
|
||||
|
||||
**一句话**:真正"硬骨头"只有 ~10 个 converter-defect 视图 + 7 个 bespoke;其余靠"全库重转 + 挂菜单"两个批量动作就能大面积转绿。
|
||||
|
||||
---
|
||||
|
||||
## 2. 逐视图状态表(按 severity 降序)
|
||||
|
||||
| 视图 | 老模板根 | schema/挂菜单/http | verdict | sev | 一句话缺口 |
|
||||
|---|---|---|---|---|---|
|
||||
| 分公司岗位管理 | master-detail | ✓/✓/200 | 严重缺 | 高 | grid 4按钮+树8按钮全丢,核心只读不可用 |
|
||||
| 岗位管理 | treegrid | ✓/✓/200 | 严重缺 | 高 | grid CRUD+树节点按钮全丢 + 未挂菜单 |
|
||||
| 个人设置(改密码) | empty(bespoke) | ✗/✓/404 | bespoke | 高 | xml=NULL,菜单挂着却落 404 死链,改密码整体缺失 |
|
||||
| 数据权限配置 | tree | ✓/✓/200 | 部分 | 高 | 可编辑树降级为只读 input-tree,8按钮全丢 |
|
||||
| 服务流 | crud | ✓/✗/200 | 部分 | 高 | 增改查退化占位 dialog(无 view_page)+ 未挂菜单 |
|
||||
| 审批表单删除 | crud | ✓/✓/200 | 部分 | 高 | onselectedscript 删除动作未译成 amis,删不掉 |
|
||||
| 视图管理 | treegrid | ✓/✓/200 | 部分 | 高 | 左实体分类树4按钮丢 + ENTITYS filterscript 级联丢 |
|
||||
| 分类树编辑类(功能管理) | treegrid | ✓/✓/200 | 部分 | 中 | 左实体分类树 edit=true 降级只读 + ENTITYS 级联退化 |
|
||||
| 定义定时任务 | treegrid | ✓/✓/200 | 部分 | 中 | 左实体分类树4按钮+编辑表单 9fdb9281 未接 |
|
||||
| 实体分类-枚举组 | tree | ✓/✗/200 | 部分 | 中 | 未挂菜单(树按钮老侧本就空壳,非真丢) |
|
||||
| 外部邮件收件箱 | crud | ✓/✗/200 | 部分 | 中 | 未挂菜单 + CONFIGID picker 双斜杠 + ISREAD 裸列名 |
|
||||
| 待办任务(五建) | crud | ✓/✗/200 | 部分 | 中 | 未挂菜单 + 打开/处理动作在 TaskComponentNew 引擎类 |
|
||||
| 收到的消息 | crud | ✓/✗/200 | 部分 | 中 | 未挂菜单 + 2隐藏 SelectDialog 双斜杠(影响低) |
|
||||
| 流程监控 | crud | ✓/✓/200 | 部分 | 中 | 引擎注入的"结束流程"按钮不在 XML,退化只读 |
|
||||
| 用户登录历史 | crud | ✓/✗/200 | 部分 | 中 | 未挂菜单 + LOGINTIME 默认值脚本未迁移 |
|
||||
| 用户登录操作信息 | crud | ✓/✓/200 | 部分 | 中 | 2个 navigation 钻取按钮(查看登录/操作记录)整体丢 |
|
||||
| 工作日历 | empty(bespoke) | ✗/✗/404 | bespoke | 中 | xml=NULL,菜单指向 404,需另案手写日历 |
|
||||
| 报表 | empty(bespoke) | ✗/✗/404 | bespoke | 中 | ReportComponent 纯 Java,需另案报表查看器 |
|
||||
| 查看审批 | empty(bespoke) | ✗/✗/404 | bespoke | 中 | WorkFlowHistoryDetailPanel,引擎层 ApprovalDrawer 承接 |
|
||||
| 流程定义 | empty(bespoke) | ✗/✓/404 | bespoke | 中 | ProcessDefinitionComponent,需 Flowable 部署控制台 |
|
||||
| 用户选择框-受控-org | empty(bespoke) | ✗/✗/404 | bespoke | 中 | UserOrgSelectWindow(type=100),需带权限过滤 picker |
|
||||
| 功能模板下载模板管理 | tree | ✓/✓/200 | 部分 | 中 | 删/改按钮丢 + 节点加载脚本 initApi 指错实体 SYS_MENU |
|
||||
| 功能管理 | treegrid | ✓/✓/200 | 部分 | 中 | (见上分类树编辑) |
|
||||
| 功能编辑列表-自定义 | crud | ✓/✓/200 | 等价 | 低 | TEMPLATEID filterscript/带出实体级联退化 |
|
||||
| 功能模板下载模板设置 | tree | ✓/✓/200 | 部分 | 低 | 改/删占位按钮(老侧 servicename 即空)+4技术字段暴露 |
|
||||
| 已办任务 | crud | ✓/✗/200 | 部分 | 低 | 未挂菜单 + STARTTIME 近12月默认脚本未迁移 |
|
||||
| 已办任务(测试) | crud | ✓/✓/200 | 部分 | 低 | 近6月默认过滤脚本未迁移(语义退化) |
|
||||
| 用户管理 | crud | ✓/✓/200 | 部分 | 低 | navigation 按钮未接线 + PASSWORD 明文 + onselectedscript 禁用联动疑未挂 |
|
||||
| 外部邮件配置 | crud | ✓/✗/200 | 等价 | 低 | 仅未挂菜单 |
|
||||
| 实体 | crud | ✓/✗/200 | 等价 | 低 | 仅未挂菜单 |
|
||||
| 已发送消息 | crud | ✓/✗/200 | 等价 | 低 | 仅未挂菜单 |
|
||||
| 外部邮件发件箱 | crud | ✓/✗/200 | 等价 | 中 | 未挂菜单 + 服务名 fidelity 待确认 |
|
||||
| 数据导入配置管理 | crud | ✓/✓/200 | 等价 | 低 | 单删→批删(低风险语义微调) |
|
||||
| 用户组管理 | crud | ✓/✓/200 | 等价 | 低 | ROLES→ROLELIST DB 重分组联动退化客户端拷贝 |
|
||||
| 电子邮件 | group | ✓/✓/200 | 等价 | 低 | 收件箱 ISREAD 裸列名 + CONFIGID 双斜杠(隐藏) |
|
||||
| 待办任务 | crud | ✓/✓/200 | 等价 | 无 | 无缺口 |
|
||||
| 我的发起任务 | crud | ✓/✓/200 | 等价 | 无 | 无缺口 |
|
||||
| 数据导入文件管理 | crud | ✓/✓/200 | 等价 | 无 | 无缺口 |
|
||||
| 用户选择框-全部-不受控 | crud | ✓/✗(预期)/200 | 等价 | 无 | picker 设计预期不挂菜单 |
|
||||
| 用户选择框-受控 | crud | ✓/✗(预期)/200 | 等价 | 无 | 同上 |
|
||||
| 用户选择框-批量-排除挂靠 | crud | ✓/✗(预期)/200 | 等价 | 无 | 同上 |
|
||||
| 短消息 | group | ✓/✓/200 | 等价 | 无 | 2隐藏 SelectDialog 双斜杠(无可见影响) |
|
||||
| 系统日志查询 | crud | ✓/✓/200 | 等价 | 无 | 无缺口 |
|
||||
| 自动编号规则 | crud | ✓/✓/200 | 等价 | 无 | 无缺口 |
|
||||
| 视图编辑列表-自定义 | crud | ✓/✓/200 | 等价 | 无 | 无缺口 |
|
||||
| 设置定时任务 | crud | ✓/✓/200 | 等价 | 无 | 无缺口 |
|
||||
|
||||
---
|
||||
|
||||
## 3. 缺口 backlog(按 kind 归并,这是干活的依据)
|
||||
|
||||
### 3.1 converter-defect(改转换器,通用收益最大)
|
||||
|
||||
按 pattern 聚合,共识别出 **6 大转换器症结**,从高频到低频:
|
||||
|
||||
#### CD-1 ★最致命:master-detail/treegrid 的「可编辑树节点按钮」整块丢弃(tree-editable 退化)
|
||||
**命中视图(7个)**:分公司岗位管理、岗位管理、数据权限配置、视图管理、功能管理、定义定时任务、(实体分类-枚举组=空壳除外)。
|
||||
**症结**:转换器遇到 `<tree>`/treetemplate 节点上的 `<buttons>`(添加/修改/删除/保存)与节点编辑 `pageid` 时,统一降级为只读 `input-tree`,既不映射节点工具栏/editable,也不接编辑弹窗。涉及服务名:`SYS_ENTITYTYPE_ADD/DELETE`、`SYS_DEPART_ADDORUPDATE/DELETE`、`SYS_POSITION_ADDORUPDATE/DELETE`。
|
||||
**关键证据**:多视图的节点表单 schema(9fdb9281 NAME/SEQ、d3fe54f0、9c987585)**已转好且 live 200**,纯粹缺"树侧触发入口"。
|
||||
**修法**:转换器对 treetemplate 节点 `<buttons>` 生成 amis 树工具栏/节点 actions + 绑定已存在的编辑表单 pageid。**一次修惠及 7 视图**。
|
||||
**注意分流**:实体分类-枚举组 的 4 按钮在源 XML 是 `edit=false/servicename空/无pageid` 空壳,转换器省略是**保真**,不在此修复范围。
|
||||
|
||||
#### CD-2 ★grid CRUD 按钮整块丢弃(crud headerToolbar 只剩 pagination)
|
||||
**命中视图(3个)**:分公司岗位管理、岗位管理(grid a7974378 的 SYS_POSITIONUSER_ADD/UPDATE/DELETE/LOAD)、审批表单删除(局部相关)。
|
||||
**症结**:master-detail 右侧子 grid 模板的 4 按钮(insert/update/delete/read)未生成 itemActions/headerToolbar/写 api;`selectable:true` 形同虚设。
|
||||
**修法**:转换器对子 grid 模板按钮按 crud 主表同样规则接线。与 CD-1 同属"master-detail 子模板按钮未接"族,**建议合并为一个工单**。
|
||||
|
||||
#### CD-3 navigation 类型按钮(跨视图钻取)未映射
|
||||
**命中视图(3个)**:用户登录操作信息(查看登录记录 funcid=edc05980 / 查看操作记录 funcid=535f921c)、用户管理(查看数据过滤权限 funcid=8ba2f6a2)。
|
||||
**症结**:`type=navigation` 按钮(带 `funcid` 跳目标视图 + `onloadscript` 注入默认搜索)被整体丢弃,无 `navigate`/`link` action。
|
||||
**修法**:**这正是"未提交的 navigation 通用修复"要解决的**——必须 rebuild jar + 全库重转才 live。修复后验证这 3 视图钻取恢复。
|
||||
|
||||
#### CD-4 onselectedscript 选中脚本未译成删除/批量动作
|
||||
**命中视图(2个)**:审批表单删除(onselectedscript=872e00b1 是整页核心删除)、流程监控(enableButton('结束流程') 指向引擎注入按钮)。
|
||||
**症结**:转换器保留 `selectable` 复选框,但不把 `display/@onselectedscript` 消费成 bulkActions/itemActions 删除动作。审批表单删除尤其严重——"删除视图"却删不了。
|
||||
**修法**:转换器对 `onselectedscript` 驱动的选中动作生成 amis bulkAction。注意流程监控的"结束流程"按钮本身是引擎注入(不在 XML),属 bespoke 边界,转换器只能补按钮壳无法补 action。
|
||||
|
||||
#### CD-5 空 dialogid 的 SelectDialog → picker source 双斜杠 `/api/picker//list`
|
||||
**命中视图(4个)**:外部邮件收件箱(CONFIGID)、收到的消息(SYS_MESSAGE_ID/SYS_USER_ID)、短消息(同)、电子邮件(收件箱 CONFIGID)。
|
||||
**症结**:`dialogid` 为空时,转换器拼出 `/api/picker//list` 双斜杠,picker 无法加载。**好消息**:这些字段几乎全是 `hidden=true`,可见影响低。
|
||||
**修法**:转换器对空 dialogid 做兜底(回退实体名或跳过 picker)。低优先,但一次修干净 4 视图。
|
||||
|
||||
#### CD-6 节点加载脚本被转成指向错误实体的 initApi
|
||||
**命中视图(1个,但语义致命)**:功能模板下载模板管理。
|
||||
**症结**:老 load 脚本"根据菜单查询 VIEW_TEMPLATE_DOWNLAD 回填 DOCUMENT/VERSION",被转成 `initApi=/api/entity/SYS_MENU/${selId}`(加载错的实体),选节点不载入已有附件,主流程断裂。
|
||||
**修法**:单视图修 initApi 指向正确实体/pageId 加载路径(对照"功能模板下载模板设置"的正确 pageId initApi 写法)。属逐视图深缺口,非通用 pattern。
|
||||
|
||||
---
|
||||
|
||||
### 3.2 schema-missing / 待重转(靠全库重转重导补)
|
||||
|
||||
- **navigation 通用修复(CD-3)**:这是**唯一**真正"重转即补"的通用项——jar 内已有修复代码未提交,rebuild + BatchConvertCli→SchemaImportCli 后,用户登录操作信息/用户管理的 navigation 按钮 schema 才会出现。
|
||||
- **bespoke 的 schema-missing(个人设置/工作日历/报表/查看审批/流程定义/流程选择框/用户选择框org)**:`view_template.xml=NULL`,**重转无源可转,不属重转可解**,务必区分,别误以为重转能补。
|
||||
|
||||
---
|
||||
|
||||
### 3.3 not-mounted(只差挂 sys_menu)
|
||||
|
||||
**纯挂菜单即转绿(9个)**:外部邮件发件箱、外部邮件配置、实体、已发送消息、收到的消息、已办任务、待办任务(五建,但还叠 bespoke 打开动作)、用户登录历史、用户选择框-全部-不受控\*。
|
||||
|
||||
**注**:用户选择框×3(不受控/受控/批量排除挂靠)、用户选择框-受控-org 的 menuCount=0 是 **picker 设计预期**(由别的表单 dialogid 调起),**不需要挂菜单**。
|
||||
|
||||
**真需补菜单清单(去掉 picker 预期)**:外部邮件发件箱、外部邮件配置、实体、已发送消息、收到的消息、已办任务、用户登录历史 = **7 个确定补菜单**;待办任务(五建)挂了菜单仍是死路列表(见 bespoke)。
|
||||
|
||||
---
|
||||
|
||||
### 3.4 bespoke-no-xml(纯 bespoke,逐个处置)
|
||||
|
||||
| 视图 | engineclass | EIP4 是否已有机制覆盖 | 处置建议 |
|
||||
|---|---|---|---|
|
||||
| 个人设置(改密码) | ChangePasswordView | ❌ 无,菜单挂着落 404 死链 | **需 bespoke**,系统级功能缺失(无法改密码),优先级偏高;先把 404 死链处理掉(隐藏菜单或占位页) |
|
||||
| 工作日历 | WorkCalendarSettingView (type5) | ❌ 无,菜单指向 404 | **需 bespoke** amis 日历页;暂可隐藏菜单防 404 |
|
||||
| 报表 | ReportComponent | ❌ 无(未挂菜单) | **可暂缓**,需另案报表查看器/运行时,工作量大 |
|
||||
| 查看审批 | WorkFlowHistoryDetailPanel | ✅ 引擎层 ApprovalDrawer 轨迹已承接(见 memory) | **已覆盖**,此模板本身无 schema 无挂载,无需单独迁移 |
|
||||
| 流程定义 | ProcessDefinitionComponent | ❌ 无,但菜单已挂(落 404) | **需 bespoke** Flowable BPMN 部署控制台;先处理菜单 404 |
|
||||
| 流程选择框 | ProcessSelectDialog | ⚠️ 子组件弹窗,由别处调起 | **可暂缓**,需要时另案 picker;非独立页 |
|
||||
| 用户选择框-受控-org | UserOrgSelectWindow (type=100) | ⚠️ 部分——不受控/受控用户 picker 已用数据驱动 crud 覆盖(等价),但**带权限过滤的 org 版仍缺** | **需 bespoke** 带权限过滤的原生 amis picker(组织树+用户+正常/禁止登录态);优先级看是否有表单引用它 |
|
||||
|
||||
---
|
||||
|
||||
### 3.5 fidelity(保真层服务疑似需查)
|
||||
|
||||
- **外部邮件发件箱**:`SYS_EXTERNALMAIL_SEARCH` / `SYS_EXTERNALMAIL_DELETE` 在 sys_serviceflow/sys_originservice **未查到注册**,可能由代码注册。**需运行时 POST 验证端点存在性**。
|
||||
- **服务流**:`SYS_SERVICEFLOW_SAVE/UPDATE/LOAD` 因占位 dialog 未接,**即便补表单也需先确认保真层端点存在**(记为待核)。
|
||||
- **功能模板下载模板设置**:DOCUMENT 选中加载走 `initApi+pageId` 保真层路径,**需运行时实测回填是否生效**。
|
||||
|
||||
这 3 项建议在 P0 干净基线起来后,用一批鉴权 POST 烟测统一验证。
|
||||
|
||||
---
|
||||
|
||||
### 3.6 degraded(语义退化,非功能中断)
|
||||
|
||||
聚合为几类,多数可暂缓:
|
||||
- **默认值/默认过滤脚本未迁移**(打开页默认时间窗):已办任务(近12月)、已办任务测试(近6月)、用户登录历史(LOGINTIME)、待办任务(无)。轻度 UX 退化,统一可做"转换器把 onload 默认值脚本译成 filter defaultParams"。
|
||||
- **filterscript 级联过滤退化**:功能编辑列表-自定义(TYPE=1)、功能管理/视图管理(ENTITYS by ENTITYTYPE)、岗位编辑(PARENTDEPARTID)。属"已知 onEvent/filterscript 挂回缺口"(见 memory),与历史 onEvent 修复同源。
|
||||
- **带出实体级联脚本**:功能编辑列表-自定义(TYPE/ENGINECLASS 隐藏字段不自动带出,写入可能为空)——需关注,可能影响落库。
|
||||
- **DB 重分组联动**:用户组管理 ROLES→ROLELIST(退化为客户端拷贝,不影响保存)。
|
||||
- **PASSWORD 用 input-text 明文**:用户管理(老 uitype=TextField,属老侧即如此;但 EIP4 应升级 input-password)。
|
||||
- **技术字段暴露/裸列名**:功能模板下载模板管理/设置(4技术字段明文)、外部邮件收件箱/电子邮件(ISREAD 裸列名)。布局保真退化。
|
||||
- **单删→批删**:数据导入配置管理(低风险等价)。
|
||||
|
||||
---
|
||||
|
||||
## 4. 推荐修复序列(分阶段)
|
||||
|
||||
### P0 — 干净基线(让转换页全 live + 挂菜单)
|
||||
**动作**:
|
||||
1. rebuild jar(含未提交的 navigation 通用修复)→ BatchConvertCli 全库重转 → SchemaImportCli 重导 → 8093 restart 干净基线。
|
||||
2. 补 sys_menu 挂载:外部邮件发件箱/配置、实体、已发送消息、收到的消息、已办任务、用户登录历史(7个确定项)。
|
||||
3. 处理 4 个 bespoke 的菜单 404 死链(个人设置/工作日历/流程定义 菜单已挂却落 404 → 临时占位页或隐藏菜单,避免用户撞死链)。
|
||||
|
||||
- **惠及视图数**:9 等价视图直接转可用 + navigation 修复落地惠及 3 视图(用户登录操作信息/用户管理) + 消除 3~4 个 404 死链。
|
||||
- **预估改动面**:0 行业务代码(jar 已含修复)+ N 行 sys_menu SQL + 占位页。
|
||||
- **验证方式**:重转后逐一 curl /api/page/schema 返 200;浏览器点菜单确认 9 视图可达且无 404;navigation 钻取按钮在 schema 中出现并可跳转。
|
||||
|
||||
### P1 — 修 converter-defect 通用症结(一次修惠及全库)
|
||||
按 severity 排序:
|
||||
1. **CD-1 + CD-2 合并(master-detail 树节点按钮 + 子 grid CRUD 按钮)**:最高价值,**惠及 7~9 视图**(分公司岗位管理、岗位管理、数据权限配置、视图管理、功能管理、定义定时任务)。把节点 `<buttons>` 与已存在的编辑表单 pageid 接回,子 grid 按钮按主表规则接线。
|
||||
2. **CD-4(onselectedscript→删除动作)**:惠及审批表单删除(高,核心功能)。
|
||||
3. **CD-5(空 dialogid 双斜杠兜底)**:惠及 4 视图(影响低但一次修干净)。
|
||||
|
||||
- **预估改动面**:转换器 3~4 处,触及 master-detail/grid/onselected/picker 生成逻辑;每改一处需全库重转重导。
|
||||
- **验证方式**:重转后 grep 对应视图 schema 出现 itemActions/headerToolbar/树节点 actions;浏览器实测增删改存可用;回归"已等价"视图无破坏。
|
||||
|
||||
### P2 — 逐视图深缺口
|
||||
- **CD-6**:功能模板下载模板管理 initApi 指向修正(单视图)。
|
||||
- **degraded 批次**:默认值脚本→filter defaultParams 通用译;filterscript 级联挂回(与历史 onEvent 缺口合并);功能编辑列表带出实体级联(关注落库正确性);用户管理 PASSWORD→input-password、onselectedscript 禁用联动挂回。
|
||||
- **fidelity 烟测**:外部邮件/服务流/下载模板设置 三项服务名鉴权 POST 验证。
|
||||
- **验证方式**:逐视图浏览器 dogfooding + 写路径落库验证。
|
||||
|
||||
### Pn — bespoke 另案(独立排期,非转换器范畴)
|
||||
- **优先(系统级功能缺)**:个人设置(改密码)、用户选择框-受控-org(若有表单引用)。
|
||||
- **次之**:工作日历、流程定义(Flowable 部署控制台)。
|
||||
- **暂缓**:报表(查看器工程量大)、流程选择框(按需)。
|
||||
- **无需做**:查看审批(ApprovalDrawer 已承接)、3 个 picker 类用户选择框(数据驱动已等价)。
|
||||
|
||||
---
|
||||
|
||||
## 5. 风险与注意
|
||||
|
||||
1. **全库重转触及 ~1489 页(memory 记 883/1489 量级)是受控但高回归面操作**:每次改转换器都要 BatchConvertCli→SchemaImportCli→restart,任何 schema 生成逻辑改动都可能波及已"等价/无缺口"的 17 视图。**每轮重转后必须回归这 17 个绿视图**(尤其待办任务、我的发起任务、系统日志查询、自动编号规则、设置定时任务等无缺口项)。
|
||||
2. **CD-1/CD-2 改 master-detail 生成逻辑回归面最大**:treegrid/master-detail 转换器是多视图共用骨架,改"树节点按钮接回"可能影响所有用 input-tree 的转换页(包括纯只读导航树的实体分类-枚举组,**它必须保持只读**——别把空壳按钮也渲出来)。需用 `edit=true && servicename非空 && 有pageid` 三重条件守卫,避免给空壳树误加按钮。
|
||||
3. **bespoke 与 schema-missing 必须严格区分**:7 个 bespoke 的 xml=NULL,**重转永远补不出**;若误把它们当"待重转"会浪费精力。处置只有"另案 bespoke / 引擎层覆盖 / 暂缓"三选一。
|
||||
4. **navigation 修复未提交**:当前线上转换页不含此修复,P0 不 rebuild 就重转 = 修复不生效。务必确认 jar 是 rebuild 后的。
|
||||
5. **菜单 404 死链是用户可感最差体验**:个人设置/工作日历/流程定义 菜单已 active 挂着却落 404,优先于功能完整性先消死链(占位"功能建设中"页),避免客户撞墙。
|
||||
6. **fidelity 服务名未注册的 3 项**:在数据驱动重转中无法发现,只能运行时 POST 揪出;若 P0 不做烟测,可能 P2 才暴露"挂了菜单但点删除报 500"。建议 P0 基线后立即跑一轮服务名烟测。
|
||||
7. **filterscript/onEvent 级联属历史已知缺口**(memory 多处记录),与本轮 converter-defect 部分重叠,**复用历史 onEvent 挂回方案**,勿重复造轮子。
|
||||
447
docs/归档/framework系统管理视图-功能点Parity对照与实现计划-2026-06-16.md
Normal file
447
docs/归档/framework系统管理视图-功能点Parity对照与实现计划-2026-06-16.md
Normal file
@@ -0,0 +1,447 @@
|
||||
# Framework 层「系统管理」视图 EIP4 功能点 Parity 对照与逐个实现计划
|
||||
|
||||
> 生成日期:2026-06-16 | 性质:功能点级 parity 比对结论(权威)
|
||||
> 方法:EIP3 源码逐条枚举功能点 → 打开 EIP4 amis schema JSON + controller 端点逐点核验(对现有 admin 后台按 demo 级怀疑,端点须 grep 实证存在)
|
||||
> 验收基准(用户 2026-06-16 定):**对照旧版逐功能点核对,功能点不能丢**;「有 controller / 有 schema 文件」不算实现。
|
||||
|
||||
## 0. 总览
|
||||
|
||||
19 个 framework 系统管理视图功能点级盘点。Verdict 分布:可用 0、部分可用 8(用户管理/用户组/选人框族/数据导入配置/数据导入文件/客户信息/设计中心(功能视图管理)/——其中设计中心实为"范式不同但接通")、壳子不可用 6(岗位管理/数据权限配置/服务流/系统日志/功能视图编辑列表-自定义/功能模板下载/数据导入文件部分)、完全缺失 4(个人设置/实体数据字典/枚举组/登录历史/系统日志实质/报表留旧)。报表为既定 legacy-keep(0 工时,不计丢失)。功能点总计约 235 个,其中丢失(missing)+降级(degraded)+壳子(shell)合计约 150 个。整体判断:framework 系统管理收口"远未达 parity,且现有 admin 后台确为 demo 级偏多"——真正端到端可用仅 5 块 RBAC 管理页(用户/角色/部门/菜单/数据权限授权)的基础 CRUD+客户信息标准 CRUD;但其中数据权限配置存在 P0 级"写裸 WHERE/读 Conditional JSON"语义断裂致管理页建的规则运行时不可消费。两大系统性缺陷贯穿多视图:①转换 schema 已产出但未 upsert 进 sys_page_schema/未挂 menu.ts(岗位管理/服务流/系统日志/数据字典)→"端点在、页面挂不出来";②service 层已移植到 platform-legacy-core 但无 HTTP 端点暴露(设置主岗位/日志删除/导入管线/服务流 saveOrUpdate)→"service≠视图能用"。"功能点不能丢"硬要求下,共 15 个视图有丢失/降级需补,总工时约 80.5 人日(不含报表)。
|
||||
|
||||
**两大系统性缺陷(贯穿多视图)**:
|
||||
1. 转换 schema 已产出但**未 upsert 进 sys_page_schema / 未挂 menu.ts**(岗位管理/服务流/系统日志/数据字典)→「端点在、页面挂不出来」。
|
||||
2. service 层已移植到 platform-legacy-core 但**无 HTTP 端点暴露**(设置主岗位/日志删除/导入管线/服务流 saveOrUpdate)→「service ≠ 视图能用」。
|
||||
|
||||
## 1. Parity 矩阵(每视图一行)
|
||||
|
||||
| 视图 | EIP4 verdict | 功能点 | 丢失/降级 | 人日 | 优先级 | 关键缺口 |
|
||||
|---|---|---:|---:|---:|---|---|
|
||||
| 数据权限配置 (DataFilterConfigView) | 壳子不可用(P0语义断裂) | 16 | 11 | 7 | P1 | 写裸WHERE/运行时读Conditional JSON 语义断裂→管理页建的规则运行时不可消费;结构化条件构建器(字段/运算符/8令牌/AND-OR)全缺,退化为裸textarea |
|
||||
| 用户管理 (UserManageView) | 部分可用 | 15 | 7 | 3.5 | P1 | 丢失设置主岗位+查看用户菜单+删除端点;编辑仅改姓名;查询单关键字;按钮权限粗粒度(account=admin硬判) |
|
||||
| 岗位管理+分公司岗位管理 (PositionManageView) | 壳子不可用 | 12 | 7 | 4 | P1 | 读侧schema(81266f2b/bad92259)未导入未挂菜单整页不可达;写侧核心『设置』批量授岗+设主岗位完全缺端点 |
|
||||
| 用户选择框族 (4合1选人弹窗) | 部分可用(偏壳子) | 15 | 12 | 9 | P1 | 左右穿梭批量选人+Tab2部门树/Tab3岗位类别/Tab4用户类别/全体人员ALL/考勤排除挂靠 全缺;仅单选+回填显名可用 |
|
||||
| 客户信息维护 (CustomerMainView) | 部分可用 | 14 | 1 | 1.5 | P1 | 升级历史navigation按钮=裸按钮无actionType且不传CUSTOMERID(转换器无type=navigation支持,全库通用缺陷);2运维按钮按约定丢弃 |
|
||||
| 个人设置/改密 (ChangePasswordView) | 完全缺失 | 15 | 15 | 6 | P1 | 自助改密/改手机/设上级领导/设主岗位/每页数量偏好/常用菜单 7子块全缺;现有『界面设置』仅纯前端主题 |
|
||||
| 用户组管理 (UserGroupManageView) | 部分可用 | 14 | 8 | 3 | P2 | missing用户组搜索/复制用户组/导出Excel;degraded说明列+菜单聚合速览+断开关联状态可视化 |
|
||||
| 系统日志查询 (SystemLogMainView) | 壳子不可用 | 13 | 12 | 1.5 | P2 | deleteByType/deleteAll已移植service但无端点;无schema/无页/无菜单;列表/详情/过滤全缺 |
|
||||
| 枚举组 (EntityEnumerateType) | 完全缺失 | 9 | 9 | 4 | P2 | 按实体分类树+右侧CRUD表单整页无;后端写原语在但无页接线=shell;DictController仅扁平只读 |
|
||||
| 实体数据字典 (DataDicMainView) | 完全缺失(UI层) | 8 | 8 | 8 | P2 | SYS_ENTITY列表无菜单无页;3工具按钮(实体规则SYS_RULE/脚本工具/默认服务流)全无端点无页 |
|
||||
| 编码管理 (CodeEditMainView/SYS_CODERULE) | 部分可用 | 24 | 22 | 7 | P2 | 取号引擎已通;但规则维护界面(列表+Ace富构建器+Y/M/D/C/E/T/N七类辅助+递增OptionGroup+校验)全缺 |
|
||||
| 数据导入配置管理 (DataImportConfigView) | 部分可用 | 8 | 4 | 5 | P2 | 通用CRUD可用;4核心按钮(编辑转换脚本/保存脚本/下载模板/下载基础数据)全缺,DataImportService未移植 |
|
||||
| 数据导入文件管理 (DataExcelImportView) | 部分可用(业务不可用) | 20 | 15 | 8 | P2 | 裸CRUD可用但『执行』导入管线(FTP/POI解析/双Groovy脚本/13函数库/saveWf)全缺,无POI依赖;saveWf需按flowable重写 |
|
||||
| 服务流 (FlowServiceMainView) | 壳子不可用 | 14 | 13 | 12 | P2 | 列表指向不存在的执行端点;增删改查空tpl壳;节点表/输入输出参数/脚本/服务bean/XML源编辑器全缺;saveOrUpdate无HTTP出口 |
|
||||
| 功能/视图管理(设计中心) | 部分可用(范式不同非demo) | 16 | 10 | 8 | P2 | 基础编辑/预览/保存/生效/还原可用甚至超EIP3;但uitype15控件/script绑定/dialog选择器/条件显隐/原始XML编辑/11类型语义设计器缺失(战略取舍) |
|
||||
| 功能/视图编辑列表-自定义 (UserFunDesignCustom) | 壳子不可用(≈完全缺失) | 19 | 17 | 22 | P2 | TemplateCustom自建模板列表+type=100弹窗/type=200报表/EDITFORM三结构化设计器+save/rename/download/create端点全缺 |
|
||||
| 登录历史+登录信息 (2合1) | 完全缺失 | 8 | 5 | 2 | P3 | 两列表页无;按USERID+时间区间查询无(引擎仅等值);deleteByLoginTime已移植无端点=shell;Info→History跨页跳转无 |
|
||||
| 功能模板下载 (FuncDownloadComponent) | 壳子不可用(底层附件可用) | 9 | 6 | 2 | P3 | 整页树+联动无;附件上传/下载/列附件三端点已生产级可用;仅缺附件删除端点;EIP3 docs定性留旧 |
|
||||
| 报表 (ReportComponent/jatools) | 完全缺失(既定legacy-keep) | 9 | 0 | 0 | P3 | 第三方jatools报表引擎栈不迁移,P4另立BI方案;非遗漏,零工时不计丢失 |
|
||||
|
||||
## 2. 逐个实现序列(implementationOrder)
|
||||
|
||||
### #1 [P1] 数据权限配置 (DataFilterConfigView) — 1.5 人日
|
||||
- **补什么**:P0先弥合语义断裂:让 AdminWriteController create/update 把表单产物序列化成与运行时一致的 Conditional JSON 数组(复用 DataFilterHelper.convertConditionalToJson),或在 convertJsonToConditional 加裸WHERE兼容分支。先用一条UI新建规则做端到端dogfooding实测确认(预期抛'规则解析异常')。修复后管理页建的规则才能被运行时引擎消费
|
||||
- **路径**:P0阻断修复,复用现有AdminWriteController+DataFilterHelper,改写写侧序列化
|
||||
- **依赖**:无
|
||||
|
||||
### #2 [P1] 客户信息维护 (CustomerMainView) — 1.5 人日
|
||||
- **补什么**:在 TemplateToAmisConverter 增加 type=navigation 按钮通用支持:识别<button type=navigation funcid onloadscript>→产出amis actionType=dialog(service schemaApi=/api/page/schema/{funcid})并把选中行BUNDLE_CUSTOMER_ID作为CUSTOMERID注入目标crud默认查询条件(对应setDefaultSearch)。修后整库重转重导,全库所有navigation按钮通用生效
|
||||
- **路径**:转换器通用能力(非bespoke),全库受益,本视图重转验证
|
||||
- **依赖**:无
|
||||
|
||||
### #3 [P2] 系统日志查询 (SystemLogMainView) — 1.5 人日
|
||||
- **补什么**:建薄LogController桥接已移植的systemLogManager:POST /api/log/deleteByType+POST /api/log/deleteAll+GET /api/log/types;读列表/详情复用现有/api/entity/SYS_LOG/list与/{id};建SYS_LOG amis schema(列TYPE/CONTENT/CREATEBY/CREATETIME含bigint日期格式化+filter+查看详情form+两删除按钮);menu.ts加入口
|
||||
- **路径**:低成本止血:service已移植+通用读端点已有,仅补薄controller+schema+菜单
|
||||
- **依赖**:无
|
||||
|
||||
### #4 [P1] 用户管理 (UserManageView) — 3.5 人日
|
||||
- **补什么**:补3端点到AdminUserController或新建UserPositionController:①POST /api/admin/users/{id}/delete 软删/注销;②GET用户岗位+POST设主岗位(可桥flowExcuteService SYS_POSITIONUSER_UPDATEMASTER或直改sys_positionuser.ismaster);③GET /api/admin/users/{id}/menu(复用view_sys_usermenuid按指定userid出树)。扩展updateUser支持完整字段(账号/部门/扩展属性)。A2-A4 schema追加删除/设置主岗位/查看用户菜单按钮+岗位单选dialog+树弹窗+部门状态结构化过滤。重转重导sys_page_schema
|
||||
- **路径**:复用已建AdminUserController+view_sys_usermenuid基建,补端点+schema按钮
|
||||
- **依赖**:无
|
||||
|
||||
### #5 [P1] 岗位管理+分公司岗位管理 (PositionManageView) — 4 人日
|
||||
- **补什么**:读侧零成本:把转换后81266f2b/bad92259 schema upsert进sys_page_schema+menu.ts SYS_ADMIN加两入口(复用现成TemplateTreeController /tree+/treegrid引擎)。写侧补两业务端点:A.授岗=接收positionId+userIds按diff批量增删SYS_POSITIONUSER(对齐SYS_POSITION_UPDATE,可直调flowExcuteService);B.设主岗位=写ISMASTER=1并清同USERID其它主标记。前端crud加『设置』按钮(picker多选用户dialog)+行内『设为主岗位』+权限visibleOn
|
||||
- **路径**:读侧复用TemplateTreeController引擎(导入+挂菜单),写侧两端点;与用户管理设主岗位端点可共享
|
||||
- **依赖**:order4(设主岗位端点可复用)
|
||||
|
||||
### #6 [P2] 用户组管理 (UserGroupManageView) — 3 人日
|
||||
- **补什么**:保留现有sys-admin-assign.json三栏页为基底:①AdminController.usergroups加keyword参数(name/description like)+schema加filter搜索框;②groupList columns补description说明列(端点已返回);③新增AdminWriteController /usergroups/{id}/copy端点(insert新组+复制sys_usergrouprole/sys_usergroupuser)+复制按钮;④(可选parity)按groupId聚合菜单覆盖只读树端点(union该组所有角色sys_role_menu);⑤(低优)export-excel
|
||||
- **路径**:复用已接通的三栏页基底,补搜索/复制/说明列三个高频缺口
|
||||
- **依赖**:无
|
||||
|
||||
### #7 [P1] 个人设置/改密 (ChangePasswordView) — 6 人日
|
||||
- **补什么**:手写数据驱动『个人设置』amis聚合页(放sys_page_schema)+顶栏头像下拉/菜单挂入口。新增MeController(/api/me全部基于currentUserId):①POST /change-password(复用PasswordHasher验旧哈希+写新,口径须先确认库存MD5还是BCrypt);②POST /mobile写SYS_USER.MOBILE;③GET/POST /leader(sys_userleader upsert/delete,picker复用PickerController排除自己);④GET/POST /positions+master-position(复用OrganizationServiceImpl,与order4/5端点同源);⑤移植UserSwitchStatusService做PAGESIZE偏好。常用菜单/工程模式按客户优先级裁剪
|
||||
- **路径**:bespoke聚合页+MeController;主岗位读写复用order4/5基建,picker复用PickerController
|
||||
- **依赖**:order4,order5(主岗位读写复用)
|
||||
|
||||
### #8 [P1] 用户选择框族 (4合1选人弹窗) — 9 人日
|
||||
- **补什么**:分两档先做最高频:①前端建自定义『重型选人弹窗』React/amis组件(tabs+transfer双列穿梭)替代扁平picker,挂载到收件人/经办人/转办/通知对象字段;②后端扩展PickerController或新建UserSelectController提供维度数据源:按部门(view_depart_tree递归)、按岗位类别(SYS_POSITIONTYPE)、按用户类别(SYS_CATEGORY)、选公司/部门、全体人员ALL特殊值、考勤iscollected=1;复用OrganizationService.getDepartTreeByOrgId。先做Tab1全部+Tab2部门+全体人员三项,岗位/用户类别按使用频率排期;修Tab1多字段搜索(NAME+ACCOUNT)
|
||||
- **路径**:重型前端组件+多维度端点;被全站审批转办/发文收件人大量引用,影响面广
|
||||
- **依赖**:无
|
||||
|
||||
### #9 [P2] 枚举组 (EntityEnumerateType) — 4 人日
|
||||
- **补什么**:数据驱动收口:为枚举组造view_template树模板(SYS_ENUMERATETYPE按实体分类+SYS_ENUMERATE项)经现成TemplateTreeController /tree暴露;前端建『枚举字典管理』amis页(左input-tree选分类/组,右CRUD表单initApi→EntityController读SYS_ENUMERATE、提交→EntityWriteController save/delete);menu.ts加入口;复用已修虚拟列表选中坑(>100节点)
|
||||
- **路径**:复用TemplateTreeController+EntityWriteController写原语,主要工作在前端页+模板数据+菜单
|
||||
- **依赖**:无
|
||||
|
||||
### #10 [P2] 数据导入配置管理 (DataImportConfigView) — 5 人日
|
||||
- **补什么**:通用CRUD已可用,补4自定义按钮:①移植DataImportService(findBaseData{Comp,User,Pro,Depart})到legacy-core暴露bean;②新增DataImportConfigController:GET /template?configId=(复用MetaController/POJOInfo元数据+POI生成xls含枚举/必填/STATUS审批列)、GET /basedata(4 sheet)、POST写CONVERTSCRIPT/SAVESCRIPT;③schema headerToolbar补4按钮(脚本编辑用amis code-editor language=groovy带字段hint,下载类actionType=download,带disabledOn单选约束)。需先引入apache-poi依赖
|
||||
- **路径**:通用CRUD保留,补service移植+POI端点+4按钮;POI依赖与数据导入文件共享
|
||||
- **依赖**:无
|
||||
|
||||
### #11 [P2] 实体数据字典 (DataDicMainView) — 8 人日
|
||||
- **补什么**:分层补:①实体列表(快)=为SYS_ENTITY出admin-schema(crud+实体属性子表)+menu.ts入口,复用现成EntityController/EntityWriteController;②实体规则SYS_RULE=列表(按ENTITYID过滤)+规则编辑器(名称必填+VERIFICATIONTIME枚举下拉+amis editor groovy),需新增SYS_RULE读写端点或复用通用EntityWrite;③脚本工具=受控端点(按entityId生成createTableSql+执行建表SQL白名单仅DDL防注入)+amis editor sql;④默认服务流=新增端点调已移植addDefaultFlowService+FlowServiceMainView等价维护页。脚本工具/服务流属高危需权限位
|
||||
- **路径**:实体列表复用通用CRUD最省力,规则/脚本工具/服务流逐层补;脚本编辑器组件与编码管理可共享
|
||||
- **依赖**:无
|
||||
|
||||
### #12 [P2] 编码管理 (CodeEditMainView/SYS_CODERULE) — 7 人日
|
||||
- **补什么**:两段式:①快速止血=配SYS_CODERULE列表admin-schema(走EntityController/EntityWriteController通用CRUD)+menu.ts,让运维勉强可用(裸字段填规则串,约1天);②parity富构建器=eip4-web写自定义React规则构建组件:左CodeMirror规则文本编辑+右七类片段生成器(C/E/T需补元数据端点/api/metadata/{table}/columns暴露columnDisplayType/referenceTable/enumerateType)+递增项解析(/api/coderule/parse端点搬CodeValidate.getAllBaseAddRule/getCaption)+保存前校验(/api/coderule/validate复用numberIsOnlyOne/isIncludeSpecialCharacter)。取号引擎已available不动
|
||||
- **路径**:先列表止血,再bespoke富构建器;元数据端点与功能视图编辑列表-自定义共享
|
||||
- **依赖**:无
|
||||
|
||||
### #13 [P2] 数据导入文件管理 (DataExcelImportView) — 8 人日
|
||||
- **补什么**:bespoke实现导入管线:①后端DataImportController(/api/dataimport/execute?fileId=)封装FTP下载(复用FTPClientTemplate)→ZipUtil.getUnzipStream→移植ExcelParseUtil(先加apache-poi)→convertMapByEntity→复用现有ScriptingEnginesManager/SecureGroovy跑CONVERTSCRIPT/SAVESCRIPT;②移植ScriptFunctions 13函数+DEFAULTFUNCTION注入,saveWf需按flowable历史表(act_hi_*)语义重写(最大风险点),saveDoc走EIP4文档服务;③SYS_DATAIMPORTFILE schema手工加『执行』按钮+disabledOn。建议执行管线与配置侧工具拆两阶段
|
||||
- **路径**:bespoke管线;复用Groovy引擎+FTP/Zip基建,POI依赖与order10共享,saveWf重写为flowable语义
|
||||
- **依赖**:order10(POI依赖+DataImportService移植共享)
|
||||
|
||||
### #14 [P2] 功能/视图管理(设计中心) — 8 人日
|
||||
- **补什么**:现状已满足核心诉求(可视化改页+生效+无损还原超EIP3)。短板补齐:①加关闭未保存提示(beforeunload);②把设计中心页源扩到全部sys_page_schema(不止挂菜单叶子)。战略决策项(需用户拍板,见openQuestions):EIP3语义化属性编辑器(uitype15控件/script/dialog/条件显隐)是否复刻=若复刻需为amis-editor写自定义插件包(工作量大);高级配置直编原始XML是否加只读/可写兜底端点
|
||||
- **路径**:P2短板低成本补,语义化设计器复刻属战略取舍待拍板,默认不复刻
|
||||
- **依赖**:无
|
||||
|
||||
### #15 [P2] 功能/视图编辑列表-自定义 (UserFunDesignCustom) — 22 人日
|
||||
- **补什么**:先与客户确认是否需终端用户自建弹窗/报表模板(见openQuestions)。路线A(若否,最小收口):补TemplateCustom列表入口指向现有设计中心。路线B(若是,真parity):恢复TemplateCustom列表(菜单+读端点+列表schema)+为type=100弹窗/type=200报表/EDITFORM各实现结构化设计器(或XML加载转amis schema保存反转,复用amis-editor做中间画布)+补save/rename/download/create端点(legacy service上加薄controller)。优先级type=200报表>type=100弹窗>EDITFORM(与已落地A3编辑表单迁移部分重叠可复用)
|
||||
- **路径**:重写,工作量最大;先拍板路线A/B,B则复用amis-editor画布+legacy service+A3编辑表单
|
||||
- **依赖**:order14(设计中心),order12(元数据端点)
|
||||
|
||||
### #16 [P3] 登录历史+登录信息 (2合1) — 2 人日
|
||||
- **补什么**:合并一个工时块:①后端确认Info页XML模板真实数据源(登录信息表/在线会话);为SYS_USERLOGIN_HISTORY与Info源表加SYS_ENTITY白名单经EntityController通用读;若引擎list不支持logintime区间(>=/<=)新增bespoke查询/删除controller(POST /api/log/login-history/list+/delete-by-time桥接已移植SystemLogManagerImpl.deleteByLoginTime);②前端两个admin-schema crud页(History含userid picker+时间range filter+删除confirmText;Info含行级『查看登录记录』链接跳History并query预填userid+时间区间);menu.ts加入口;userid引用列显用户名、logintime毫秒格式化。已注释的deleteAll/查看操作记录无需实现
|
||||
- **路径**:低频审计:service已移植+通用读端点,补薄controller(若需区间)+两schema+菜单
|
||||
- **依赖**:order3(LogController可复用)
|
||||
|
||||
### #17 [P3] 功能模板下载 (FuncDownloadComponent) — 2 人日
|
||||
- **补什么**:默认建议不做(EIP3 docs明确归留旧)。若客户确需:数据驱动建1~2个amis页——下载端=input-tree选模板+service api=/api/file/list?tableName=VIEW_TEMPLATE&businessKey=${模板id}+each渲染下载链接/api/file/{id}(复用现成FileController零后端改动);设置端=同页加input-file(uploadApi=/api/file/upload)+补一个sys_doc软删端点;menu.ts加入口
|
||||
- **路径**:留旧优先;若做则复用FileController三端点(已生产级),唯一真缺口=附件软删端点0.5d
|
||||
- **依赖**:无
|
||||
|
||||
### #18 [P2] 服务流 (FlowServiceMainView) — 12 人日
|
||||
- **补什么**:bespoke重写(EIP3已标重写),分三段:①速效=列表/删除改接通用/api/entity/SYS_SERVICEFLOW/list|delete,把空tpl壳换可用列表;②核心=新增FlowDefinitionController暴露saveOrUpdate(复用legacy BaseFlowConvert做节点/参数模型↔XML双向转换)+OriginServiceManager元数据端点(列服务/取arg/return);③前端=amis自定义页重建编辑器:基础信息表单+输入/输出参数input-table(类型下拉15类+正则)+节点input-table(groovy/服务/存储过程+开始结束哨兵保护)+节点级抽屉(editor groovy/服务bean映射)+高级editor xml+保存前调流校验端点。复用PickerController选实体,运行态FlowController/gateway不动
|
||||
- **路径**:重写;低频管理员动作,运行态已闭环,先速效列表再核心端点再前端编辑器
|
||||
- **依赖**:无
|
||||
|
||||
## 3. 分批建议与工时
|
||||
|
||||
总工时约 80.5 人日(不含报表留旧 0d、不含功能视图编辑列表-自定义 22d 中路线A最小收口部分)。分三批:
|
||||
|
||||
【第一批·止血+复用已建基建+全库通用(约 8 人日,P1+高频低成本)】order 1-3:数据权限P0语义断裂修复(1.5d,阻断必先做)+客户信息navigation转换器通用支持(1.5d,全库受益)+系统日志薄LogController(1.5d,service已移植)。再接 order4 用户管理补端点(3.5d,复用AdminUserController+view_sys_usermenuid)。这批全部复用已接通基建,见效快,优先消除"管理页建的规则不生效"这类隐性致命缺陷。
|
||||
|
||||
【第二批·P1核心丢失功能点(约 22 人日)】order 5-8:岗位管理读侧导入+写侧授岗端点(4d,读侧零成本复用TemplateTreeController,设主岗位端点与用户管理共享)+用户组搜索/复制/说明列(3d,复用三栏页基底)+个人设置聚合页+MeController(6d,主岗位读写复用order4/5)+选人框族重型穿梭组件(9d,影响面最广)。设主岗位端点在 order4/5/7 三处共享,排序确保先建后复用。
|
||||
|
||||
【第三批·P2/P3 重写与有前置(约 50.5 人日)】order 9-18:枚举组(4d)/数据导入配置(5d,POI依赖)/数据字典(8d)/编码管理(7d,元数据端点)/数据导入文件(8d,共享POI+DataImportService,saveWf需flowable重写)/设计中心短板(8d)/登录历史(2d,复用LogController)/功能模板下载(2d,默认留旧)/服务流(12d,bespoke重写)/功能视图编辑列表-自定义(22d,最大重写,待拍板路线A/B)。建议 POI 依赖、DataImportService 移植、元数据端点 /api/metadata/{table}/columns 这三项共享基建优先建,供多视图复用。报表(0d)维持 legacy-keep 不动。
|
||||
|
||||
关键复用链:设主岗位端点(order4→5→7)、apache-poi依赖(order10→13)、元数据列端点(order12→15)、LogController(order3→16)、PickerController/OrganizationService(order5/7/8)。
|
||||
|
||||
## 4. 待拍板问题(openQuestions)
|
||||
|
||||
1. 选人器重型穿梭(左右三列>/</>>/<<+多Tab分组)是否1:1复刻? 此组件被全站审批转办/发文收件人/通知对象大量引用,缺失面广但工作量9d。若只做收件人少量选人,扁平picker够用;若需『按部门/岗位批量选一批人』『发全员ALL』『考勤选人』则必须复刻。需拍板复刻范围(全7Tab vs 仅Tab1全部+Tab2部门+全体人员三项最小集)
|
||||
2. 服务流定义编辑器(FlowServiceMainView,12d bespoke重写)是否本期上线? 运行态已闭环,服务流定义维护是低频管理员/实施动作(多数流由S3转换或合成产生)。可只做速效列表(看得到/删得掉,约2d)而暂缓节点/脚本/XML编辑器重建
|
||||
3. 数据导入(配置5d+执行管线8d共13d)是否本期做? 属数据迁移期/初始化工具,非日常高频业务。若客户上线即需批量导历史数据则升P1必做;否则可暂缓。注意saveWf需按flowable历史表(act_hi_*)重写,是最大风险点;且需引入apache-poi依赖
|
||||
4. 设计中心EIP3语义化属性编辑器(uitype15控件/script绑定/dialog选择器/条件显隐/原始XML直编)是否复刻? 现状amis-editor已能改页布局/字段/校验并生效(更主流低代码范式)。若客户验收以『能改amis页并生效』为准则不必复刻;若坚持『按EIP3模板类型/属性键编辑』需为amis-edit器写自定义插件包(工作量大)。建议确认客户配置流程是否走『改EIP3库→重转→重导』批量路径
|
||||
5. 功能/视图编辑列表-自定义(TemplateCustom自建模板,22d)是否需终端用户自建弹窗/报表模板? 若否,路线A仅需补一个列表入口指向现有设计中心即可大幅收口;若是,按路线B排期(type=200报表>type=100弹窗>EDITFORM)。这是19视图中工作量最大单项,强烈建议先拍板
|
||||
6. 留旧项确认:报表(jatools第三方引擎,0d已定legacy-keep,P4另立BI方案)+功能模板下载(EIP3 docs定性老开发态工具,默认不做)是否最终确认留旧不计入parity? 二者已有事前决策,需用户最终签字
|
||||
7. 已注释/EIP3未启用功能确认丢弃:登录历史deleteAll、登录信息查看操作记录(EIP3源码中已//注释)、客户信息2个OSGi厂商运维按钮(生成安装包/初始化版本)。这些EIP3本身已不可见,确认EIP4无需补
|
||||
8. 自助改密哈希口径(P1风险):实现MeController改密前必须先确认EIP4库密码列实存MD5还是已迁BCrypt(PasswordHasher登录比对口径),否则用户改完密码无法登录。需DBA上库核实一条用户密码列实际格式
|
||||
9. 脚本工具/默认服务流(数据字典)+execSql(导入管线)属平台运维高危功能(任意SQL执行)。EIP3的『执行任意SQL』是真危险口子,EIP4重做是否收窄为『仅建表DDL+白名单』? 需安全约束与权限位拍板
|
||||
10. 实体规则SYS_RULE与默认服务流:需确认客户老系统是否实际用到规则脚本与默认服务流——若仅为开发期建模工具,数据字典相关可降为P3并以MetaController程序化路径替代手工建实体
|
||||
|
||||
## 5. 各视图功能点明细(lostOrDegraded)
|
||||
|
||||
### 用户管理 (UserManageView)
|
||||
- **verdict**:部分可用 (标准增改查/状态/重置密码已真接通且端点真实存在; 但删除缺失, 编辑降级为仅改姓名, 2 个核心高级功能点[设置主岗位/查看用户菜单]完全缺失)
|
||||
- **工时**:3.5 人日 | **优先级**:P1
|
||||
- **丢失/降级功能点(7)**:
|
||||
- 丢失: 设置主岗位 (无 positionuser 读写端点+无弹窗, EIP3核心功能点)
|
||||
- 丢失: 查看用户菜单 (无按用户裁剪的菜单树端点+无页面)
|
||||
- 丢失: 删除/注销用户 (无 delete 端点)
|
||||
- 降级: 编辑用户 仅能改姓名, 不能改账号/部门/扩展属性
|
||||
- 降级: 新建表单字段精简(仅account/name/userorgid), 缺手机/邮箱等扩展属性
|
||||
- 降级: 查询仅单关键字框, 缺部门/状态结构化过滤
|
||||
- 降级: 状态map缺 4=已注销; 按钮权限粗粒度(account=admin硬判, 无权限码级显隐)
|
||||
- **实现路径**:列表/增/改名/状态/重置密码已 parity, 保留。补 3 个端点至 platform-auth AdminUserController 或新建 UserPositionController: (1) POST /api/admin/users/{id}/delete 软删/注销; (2) GET 用户岗位 + POST 设主岗位(可经 flowExcuteService 调 SYS_POSITIONUSER_UPDATEMASTER 保真层, 或直 JdbcTemplate 改 sys_positionuser.ismaster); (3) GET /api/admin/users/{id}/menu 复用 view_sys_usermenuid 按指定 userid 出菜单树。前端在 A2-A4 SQL upsert 的 sys-admin-user schema 追加: 删除按钮、设置主岗位按钮+岗位单选dialog、查看用户菜单按钮+树弹窗。扩展 updateUser 支持完整字段。重转重导 sys_page_schema。
|
||||
- **备注**:关键证据点: (1) 资源文件 admin-schemas/sys-admin-user.json 是过时的只读壳(无任何按钮+无重置密码), 真正生效的是 docs/sql/A2-A4_sys_admin_upsert.sql upsert 进 sys_page_schema 的富 schema(含create/编辑/停用启用/重置密码全套且 api 指向真实端点)——PageSchemaController 以DB为准, 故按DB判定为可用。判定时务必以 SQL upsert 为准, 不要被过时的 json 文件误导为壳子。(2) 设置主岗位/查看用户菜单 这 2 个 EIP3 视图类硬编码的高级功能点 EIP4 完全无端点无页面=真缺失, 是本视图功能点不能丢的核心。(3) positionuser 写逻辑在 platform-legacy-core 有 service 但无 HTTP 端点(service移植≠视图能用的典型)。
|
||||
|
||||
### 用户组管理 (UserGroupManageView, com.dsasp.client.organize)
|
||||
- **verdict**:部分可用(核心 CRUD+角色/成员绑定真实可用,非 demo;但丢失:搜索/复制/导出/菜单聚合速览,且若干交互降级)
|
||||
- **工时**:3 人日 | **优先级**:P2
|
||||
- **丢失/降级功能点(8)**:
|
||||
- missing: 用户组查询(名称/说明模糊搜索) — usergroups 端点无 keyword 参数
|
||||
- missing: 复制用户组(克隆,含角色/成员绑定) — 无 copy 端点
|
||||
- missing: 导出Excel(基类工具栏按钮) — 无导出
|
||||
- degraded: 列表丢失'说明'列(端点已返回,schema 未展示)
|
||||
- degraded: 查看用户组菜单的'本组跨全部角色聚合菜单覆盖'只读树速览 → 改为逐单角色编辑,丢失聚合视角
|
||||
- degraded: 断开/关联角色的'已选/未选'状态可视化 + 菜单树图标即时联动刷新(treeCheck)
|
||||
- degraded: 查看(只读表单)被编辑对话框合并
|
||||
- degraded: 分配用户/角色由整存弹窗改逐个加移(语义等价,交互不同)
|
||||
- **实现路径**:保留 EIP4 现有 sys-admin-assign.json 三栏页(端点已真实接通)作为基底,按缺口逐项补:① AdminController.usergroups 加 keyword 参数(name/description like)+ schema 加 filter 搜索框;② groupList columns 补 description 说明列(端点已返回);③ 新增 AdminWriteController /usergroups/{id}/copy 端点(insert 新组 + 复制 sys_usergrouprole/sys_usergroupuser)+ schema 复制按钮;④(可选 parity)新增按 groupId 聚合的菜单覆盖只读树端点(union 该组所有角色的 sys_role_menu),还原 EIP3'查看用户组菜单'速览语义;⑤(低优)crud export-excel。成员/角色绑定与角色菜单编辑无需改。
|
||||
- **备注**:与 recon 'done' 的判定基本相符但需修正:端点确属真实实现(真实 SQL/事务 set-menus/roleResolver 缓存失效/requireAdmin),非 demo 级,菜单已挂 menu.ts:58。但'功能点不能丢'视角下仍有 3 个 missing(搜索/复制/导出)+5 个 degraded,其中最有客户感知的是'用户组搜索'(列表无法过滤)和'复制用户组'(运维常用)。EIP4 还反向超出 EIP3:把分散在 UserManageView'设置用户组'、分配用户/分配角色弹窗、UserGroupRoleView 的逻辑统一进一个三栏页,整体 UX 更连贯。第三栏语义从 EIP3'查看本组聚合菜单覆盖(只读)'变为'编辑单角色菜单(可写)' — 这是功能定位漂移,严格 parity 需补聚合只读视角,但可写编辑实为增强。关联视图 UserManageView/RoleManageView 的菜单/角色管理应一并核对避免重复实现。
|
||||
|
||||
### 岗位管理 + 分公司岗位管理 (PositionManageView, com.dsasp.clinet.organize.view)
|
||||
- **verdict**:壳子不可用(读链路引擎就位、转换 schema 存在但未导入未挂菜单整页不可达;写侧授岗/主岗位核心功能完全缺失)
|
||||
- **工时**:4 人日 | **优先级**:P1
|
||||
- **丢失/降级功能点(6)**:
|
||||
- 整页不可达:岗位管理 schema(81266f2b)与分公司岗位管理(bad92259)仅在转换器输出目录,未 upsert 进 sys_page_schema、未挂 menu.ts
|
||||
- 核心『设置』批量授岗(MultiSelectField→SYS_POSITION_UPDATE 写 SYS_POSITIONUSER)完全缺失——转换 schema 无任何工具栏按钮
|
||||
- 设置主岗位(SYS_POSITIONUSER_UPDATEMASTER 写 ISMASTER)完全缺失,EIP4 仅只读用 ismaster 解析主部门
|
||||
- 网格 增/改/删/查 岗位人员 4 按钮无后端接线(EIP3 默认隐藏)
|
||||
- 『设置』按钮权限位 SYS_POSITION_UPDATE(角色显隐)缺失
|
||||
- 分公司维度与岗位管理维度仅左树模板不同,二者均缺失入口
|
||||
- **实现路径**:读侧零成本复用现有 TemplateTreeController(/api/template/{ref}/tree + /api/template/treegrid 引擎合成搜索流已就位、_DISPLAY__/_label/数据权限/分页齐):①把转换后的 81266f2b/bad92259 schema upsert 进 sys_page_schema;②menu.ts SYS_ADMIN 加两入口。写侧是真缺口,需新增两个业务端点(非通用 CRUD):A.授岗 = 接收 positionId+userIds,按 diff 批量增删 SYS_POSITIONUSER(对齐 EIP3 SYS_POSITION_UPDATE 语义,可直调保真层 flowExcuteService SYS_POSITION_UPDATE);B.设主岗位 = 写 ISMASTER=1 并清同 USERID 其它行主标记(对齐 SYS_POSITIONUSER_UPDATEMASTER)。前端在 crud 加『设置』按钮(amis dialog + picker 多选用户,labelField=_label)与行内『设为主岗位』按钮+权限 visibleOn。样板可参部门管理 sys-admin-depart(docs/sql 树 CRUD)与 PickerController 多选。
|
||||
- **备注**:recon 判 missing 大体正确但偏严:读链路其实已有转换 schema + 真实 treegrid 端点(TemplateTreeController),差『导入+挂菜单』即读侧可用——故树/网格/显示名/主岗位映射判 shell/available 而非纯 missing。真正缺的是写侧两件核心:批量授岗(设置)与设主岗位,EIP4 全仓 grep 仅只读引用 ismaster(OrgDirectoryJdbc 解析主部门),无任何授岗/主岗位写端点。两个 view_template 共用 PositionManageView,分公司维度仅换左树(8570bf9d),复用同一套修复即可。AdminController.java:80-81 / OrgController.java:81 的 sys_positionuser JOIN 纯为部门名/在岗用户解析,与岗位管理 UI 无关,不可计为该功能 available。
|
||||
|
||||
### 个人设置/改密 (EIP3: ChangePasswordView, com.dsasp.client.organize)
|
||||
- **verdict**:完全缺失 (壳子都没有)。EIP4 现有的「界面设置」抽屉是纯客户端主题切换(品牌色/深色模式/密度/侧栏风格, 存 localStorage), 与 EIP3 个人设置的 7 个业务子块零重叠。唯一沾边的是管理员重置密码(AdminUserController.java:167, requireAdmin, 固定置110), 既非自助、也不接受用户输入新密码, 不能算改密功能。15 个功能点中 14 个 missing、1 个(自助改密)被 admin-only reset 部分占位但口径完全不同。
|
||||
- **工时**:6 人日 | **优先级**:P1
|
||||
- **丢失/降级功能点(7)**:
|
||||
- 自助修改密码 (原密码比对+新密码+确认+落库) — 完全缺失, 用户无法自己改密, 只能找管理员重置成110
|
||||
- 修改本人手机号 (SYS_USER.MOBILE 自助写) — 完全缺失
|
||||
- 设置直属上级领导 (SYS_USERLEADER 增删改, 影响工作流审批路由) — 完全缺失; 注意 EIP4 工作流仍在读 sys_userleader 做路由, 但用户无法自助维护
|
||||
- 设置主岗位 (SYS_POSITIONUSER ISMASTER, 影响多岗用户的默认岗位/审批身份) — 完全缺失
|
||||
- 默认每页显示数量偏好 (UserSwitchStatusService PAGESIZE, 未移植) — 完全缺失, EIP4 perPage 硬编码
|
||||
- 工程模式默认工程开关 (ISDEFPRO, 条件功能) — 完全缺失 (依赖 PM_PROJECT 模块)
|
||||
- 自定义常用菜单维护 — 完全缺失
|
||||
- **实现路径**:不走转换器(F3 bespoke)。手写一个数据驱动的「个人设置」amis 聚合页(放 admin-schemas 或 sys_page_schema, 由 PageSchemaController 服务, PageRenderPage 渲染), 顶栏头像下拉或菜单挂入口。后端新增一个 MeController(@RequestMapping('/api/me'), 全部基于 currentUserId 不需要 admin): (1) POST /change-password — 复用 PasswordHasher 验旧哈希+写新(口径必须与登录一致); (2) POST /mobile — 写 SYS_USER.MOBILE; (3) GET/POST /leader — sys_userleader upsert/delete(picker 复用 PickerController, filter 排除自己); (4) GET/POST /positions + master-position — 复用已移植的 OrganizationServiceImpl 主岗位读写; (5) 移植 UserSwitchStatusService(或建 sys_user_switchstatus 表)做 PAGESIZE 偏好并让渲染层读取。常用菜单 与 工程模式 按客户优先级裁剪(工程模式依赖 PM_PROJECT 可暂缓)。所有写端点都要做 isUserFacing 异常过滤防泄露(沿用本仓 17f2b76 口径)。
|
||||
- **备注**:优先级判 P1 而非 P0: 改密/上级/主岗 是真实业务诉求且上级/主岗会影响审批路由的准确性, 但管理员可临时 reset 密码兜底、单用户场景下上级主岗维护频率低, 故非阻断登录的 P0。核验结论可信度高: 已逐端点 grep 确认 change-password/MOBILE写/USERLEADER写/UPDATEMASTER/UserSwitchStatusService 在 eip4-platform 源码中均不存在 HTTP 端点; OrgController 全部 @GetMapping 只读; SettingsDrawer.tsx 经读源确认是纯主题。后端服务层已移植的资产(OrganizationServiceImpl 主岗位、OrgDirectoryJdbc 读 leader)可被新 MeController 复用, 能省工。关键风险: 改密哈希口径——EIP3 用 EncryptUtil.MD5, EIP4 PasswordHasher.java:14 是登录比对口径, 实现自助改密前必须先确认 EIP4 库里密码列实际存的是 MD5 还是已迁 BCrypt, 否则改完无法登录。EIP3 文件: framework/com.dsasp.client.organize/src/com/dsasp/clinet/organize/view/{ChangePasswordView,ChangeuserphoneView,LeaderSettingComponent,MainPoisitionSettingComponent,DefPageSizeComponent,DefProSettingComponent,CustomMenuSettingComponent}.java。EIP4 证据: AdminUserController.java:167 (admin reset), OrgController.java(全只读), OrgDirectoryJdbc.java:234/243(leader只读), SettingsDrawer.tsx(纯主题), Topbar.tsx:82(onOpenSettings=界面设置非个人设置)。
|
||||
|
||||
### 用户选择框族(4合1): AllUserSelectWindow / UserSelectWindow(组织org) / UserOrgSelectWindow / UserSelectWindow(考勤kaoqin克隆)
|
||||
- **verdict**:部分可用(壳子偏向不可用)。仅「单选 picker + 多选回填显名 + 管理员视角看全部用户」三项真接通可用;EIP3 重型选人弹窗的核心价值——四/七 Tab 多维度分组(部门树/岗位类别/用户类别/公司) + 左右穿梭批量选 + 全体人员 + 考勤排除挂靠——在 EIP4 全部缺失,被降级为单一扁平 picker。对「选少量收件人」够用,对「按部门/岗位批量选一批人」「发全员」「考勤选人」完全不可用。
|
||||
- **工时**:9 人日 | **优先级**:P1
|
||||
- **丢失/降级功能点(11)**:
|
||||
- [丢失] 左右三列穿梭批量选人交互(>/</>>/<<)——EIP4 无任何穿梭组件
|
||||
- [丢失] Tab2 按公司/部门树选人(view_depart_tree 递归查部门及子部门全部岗位用户)
|
||||
- [丢失] Tab3 按岗位类别选人(SYS_POSITIONTYPE→sys_position.positiontype)
|
||||
- [丢失] Tab4 按用户类别选人(SYS_CATEGORY→sys_categoryuser)
|
||||
- [丢失] Tab5/6/7 选公司/选部门(级联)/选岗位类别 作为选择对象(混合实体)
|
||||
- [丢失] 全体人员 ALL 虚拟值(发文/通知发全员语义)
|
||||
- [丢失] 考勤克隆专用 iscollected=1 排除挂靠过滤
|
||||
- [丢失] 选中姓名可点跳用户详情的实体链接(linkCaptionMap)
|
||||
- [降级] 全部人员搜索: EIP3 NAME+ACCOUNT 双字段 → EIP4 单列 q LIKE(且 VIEW_SYS_USER labelColumn 命中问题致中文搜0条)
|
||||
- [降级] 已选项独立关键字过滤面板+左右条数统计 → picker 无
|
||||
- [降级] 宿主自定义 dataFilter 透传 → picker 仅行级权限通道无任意 filter
|
||||
- **实现路径**:分两档。短期保 parity 入口最小集: (1)前端建一个自定义「重型选人弹窗」React/amis 组件(tabs + transfer 双列穿梭),替代扁平 picker 在「收件人/经办人/转办/通知对象」等多选人字段上挂载;(2)后端 PickerController 扩展或新建 UserSelectController 提供 4+3 维度数据源端点: 按部门(view_depart_tree 递归)、按岗位类别(SYS_POSITIONTYPE)、按用户类别(SYS_CATEGORY)、选公司/部门/岗位类别、全体人员 ALL 特殊值、考勤 iscollected=1。复用 platform-legacy-core 已移植的 OrganizationService.getDepartTreeByOrgId 与各 _SEARCH 流。(3)转换器: 把内建用户选择器 dialogid(name 含「用户选择框」)映射到新重型组件而非 applyPicker。先做最高频的 Tab1全部 + Tab2部门 + 全体人员三项,岗位/用户类别按客户实际使用频率排期。
|
||||
- **备注**:证据要点: ①EIP3 穷举=UserSelectWindow.java 7个 refreshTabN + UserOrgSelectWindow tab5/6/7 + ALL虚拟项(initMultiUserWindow:168) + kaoqin克隆 refreshTab1 iscollected=1(line 563)。②EIP4 现状: PickerController(/api/picker/{e}/list:115, /resolve:259, op=loadOptions:130)只做「扁平实体记录单/多选+回填显名」;UiTypeMapper applyPicker(:376) 生成 amis picker(multiple 可选)无穿梭。③grep 实证 eip4 全仓无 transfer/穿梭组件、无 POSITIONTYPE/SYS_CATEGORY 端点、无按部门递归查人 picker、无 ALL 特殊值、无 iscollected。④F2-9选择窗报告自承认 label=UUID/中文搜0条遗留未修。结论: recon 标 partial 准确但偏乐观——真可用面只覆盖 EIP3 单选+少量多选场景,多维分组穿梭整族缺失,属「功能点不能丢」的重点丢失项。此组件被全站审批转办/发文收件人/通知对象大量引用,缺失面广。
|
||||
|
||||
### 数据权限配置 (DataFilterConfigView + DataFilterRuleListComponent + ConditionalTable)
|
||||
- **verdict**:壳子不可用 (运行时引擎单独可用, 但管理 UI 与引擎语义脱节: 写裸 WHERE / 读 Conditional JSON, 管理页建的规则运行时无法消费, 且整个结构化条件构建器+实体树+令牌体系全缺失, 仅剩裸 WHERE textarea)
|
||||
- **工时**:7 人日 | **优先级**:P1
|
||||
- **丢失/降级功能点(8)**:
|
||||
- SYS_ENTITY 实体树导航 — 完全缺失 (退化为手填 entityid 文本)
|
||||
- 结构化条件构建器整体 — 完全缺失 (字段下拉/运算符下拉/类型令牌下拉/AND-OR/行内增删 全无, 退化为裸 WHERE textarea)
|
||||
- 8 个类型令牌 (本人/本部门/本组织/指定部门/指定组织/所属项目/文本/数值) — UI 完全缺失 (运行时分支在但无录入入口)
|
||||
- 指定部门/组织 多选选择框 — 完全缺失
|
||||
- 条件值随类型动态切换控件 — 完全缺失
|
||||
- 致命语义断裂: EIP4 写侧存裸 WHERE 串, 运行时 DataFilterHelper 期望 Conditional JSON 数组, 解析失败抛 '规则解析异常' → EIP4 管理页创建的规则运行时不可用 (shell)
|
||||
- 条件字段级完整性校验 — 降级 (仅非空校验)
|
||||
- 新建/编辑规则 — 降级 (功能在但仅裸 WHERE 文本)
|
||||
- **实现路径**:两步: (1) 先弥合语义断裂(P0 阻断): 让 AdminWriteController create/update 把表单产物序列化成与运行时一致的 Conditional JSON 数组 (复用 DataFilterHelper.convertConditionalToJson), 或在 DataFilterHelper.convertJsonToConditional 增加裸 WHERE 兼容分支并明确语义; 不修则管理页建的规则永远不生效。(2) 用 amis combo(多条件数组)+联动控件重建结构化条件构建器: 字段下拉(source=实体列元数据 /api/entity/{table}/columns)、运算符下拉(7 选项常量)、类型令牌下拉(8 令牌)、条件值按 type 用 conditionVisible 切 textarea/部门picker/组织picker/只读令牌、op AND-OR 下拉; 实体维度用实体选择器(combo source=SYS_ENTITY)替代左树即可达到 parity, 全功能实体树为加分项。角色绑定与运行时引擎已可用, 不动。
|
||||
- **备注**:证据文件(绝对路径): EIP3 源 /Users/zhengwr/workspace/eip3/framework/com.dsasp.client.privilege/src/com/dsasp/client/privilege/view/{DataFilterConfigView,DataFilterRuleListComponent,DataFilterRuleRowComponent,ConditionalTable}.java; 令牌常量 .../com.dsasp.server.common/.../privilege/bean/Conditional.java:74-83。EIP4: 静态 schema /Users/zhengwr/workspace/eip3/eip4-platform/platform-metadata/src/main/resources/admin-schemas/sys-admin-filterrule.json (注意此静态文件无任何写按钮, 是更旧版本); 运行时实际服务的是 docs/sql/A5_sys_admin_filterrule_upsert.sql 里 upsert 进 sys_page_schema 的版本(含新建/编辑/删除/配置角色 dialog)。写端点 AdminWriteController.java:535/554/573/592 真实存在; 读端点 AdminController.java:317; 角色源 OrgController.java:197 /api/org/roles 真实存在。运行时引擎 DataPrivilegeServiceImpl.java:35 getWhereClause, 调用点 POJOCRUDServiceImpl.java:115,378 + EntityWriteController:171 — 已接通。核心风险点 DataFilterHelper.java:46 convertJsonToConditional 与 AdminWriteController.java:540 裸 WHERE 写入的格式不一致, 是 verdict 判 shell 的根因, 建议先用一条 EIP4 UI 新建规则做端到端 dogfooding 实测(预期运行时抛'规则解析异常'或规则空转不过滤)以确认本静态分析结论。菜单入口 eip4-web/src/api/menu.ts:57 已挂(seq=5)。
|
||||
|
||||
### 实体(数据字典) — DataDicMainView (com.dsasp.client.dataDic)
|
||||
- **verdict**:完全缺失(产品 UI 层)。EIP4 仅有程序化 AI-闭环 MetaController(JSON 建/删实体,无 UI) + 通用 EntityController 可返 SYS_ENTITY 行,但无菜单、无前端页、无 admin-schema 把「数据字典」做成可用视图;3 个工具按钮(实体规则/脚本工具/默认服务流)均无 HTTP 端点、无页面(service 层仅移植)。判定壳子不可用偏完全缺失。
|
||||
- **工时**:8 人日 | **优先级**:P2
|
||||
- **丢失/降级功能点(8)**:
|
||||
- 实体列表页(SYS_ENTITY)——无菜单/无前端页,端点存在但产品里挂不出来(shell)
|
||||
- 实体维护表单(实体属性配置 CRUD)——仅程序化 MetaController,无手工配实体的页面
|
||||
- 实体规则(SYS_RULE)整块——RuleMainView 列表 + RuleEditor(名称/验证时机/Groovy脚本) 完全缺失
|
||||
- 脚本工具(SqlScriptToolWindow)——默认建表 DDL 生成 + 任意 SQL 执行 无 HTTP 端点、无 Ace 编辑页
|
||||
- 编辑默认服务流——addDefaultFlowService 服务已移植但无端点,FlowServiceMainView 维护页缺失
|
||||
- VERIFICATIONTIME 验证时机枚举下拉
|
||||
- Groovy 规则脚本编辑器 ScriptBaseEditor
|
||||
- 3 按钮需选中一行的禁用/提示联动
|
||||
- **实现路径**:分层补:①实体列表(快)——为 SYS_ENTITY 出 admin-schema(crud 列表+实体属性子表表单)并加 menu.ts 入口,复用现成 EntityController/EntityWriteController,最省力即可让「数据字典」可见可用;②实体规则——补 SYS_RULE 列表(按 ENTITYID 过滤)+ 规则编辑器(名称必填 + VERIFICATIONTIME 枚举下拉 + amis editor groovy 脚本),需新增 SYS_RULE 读写端点或复用通用 EntityWrite + 脚本变更通知钩子;③脚本工具——新增受控端点「按 entityId 生成 createTableSql」+「执行建表 SQL(白名单/仅 DDL 防注入)」,前端配 amis editor(sql);④默认服务流——新增端点调已移植 addDefaultFlowService,再补 FlowServiceMainView 等价的服务流维护页。注意脚本工具/服务流属平台运维高危功能,需权限位与安全约束。
|
||||
- **备注**:这是 framework 平台管理/元数据视图(给实施/管理员用),非业务流程视图,故 P2(客户业务 parity 优先级低于业务表单,但「实体规则」直接关联实体校验、若客户老系统用了规则脚本则升 P1)。关键证据:MetaController 是 WS5 AI-闭环 API(程序化建删实体),明确不是 DataDicMainView 的 UI 替代;sys-admin-filterrule 是数据权限规则(DataFilterConfigView),与实体规则 SYS_RULE 无关,勿混淆。脚本工具「执行任意 SQL」在 EIP3 是真危险口子,EIP4 重做时建议收窄为「仅建表 DDL + 白名单」。需进一步确认客户老系统是否实际用到 SYS_RULE 规则与默认服务流——若仅为开发期建模工具,可降为 P3 并以 MetaController 程序化路径替代手工建实体。
|
||||
|
||||
### CodeEditMainView (编码管理 / SYS_CODERULE 编号规则维护) — com.dsasp.client.datadic.view
|
||||
- **verdict**:部分可用:运行时取号引擎已接通可用(available),但规则【维护界面】(列表+富规则构建弹窗)在 EIP4 完全缺失(壳子都没有,无页面/无菜单/无 schema/无 SQL)。对最终用户而言「编码管理」这个菜单功能等同完全缺失——只能靠 DBA 直接改 SYS_CODERULE 表或用通用 EntityController 裸 CRUD 手填规则串。
|
||||
- **工时**:7 人日 | **优先级**:P2
|
||||
- **丢失/降级功能点(9)**:
|
||||
- 列表页+菜单入口(完全缺失)
|
||||
- 新增/编辑规则的自定义 CodeEditor 弹窗(完全缺失)
|
||||
- 实体→属性级联选择(缺失)
|
||||
- AceEditor 富规则编辑器+语法提示(缺失)
|
||||
- 右侧规则辅助类型选择器 Y/M/D/C/E/T/N 七类子表单(全部缺失)
|
||||
- 插入片段到光标(缺失)
|
||||
- 流水号递增项多选 OptionGroup/ADDRULE 生成+中文caption(缺失)
|
||||
- 保存前三类校验(规则非空/唯一流水号/特殊字符)与去换行规范化(缺失)
|
||||
- 删除/查询仅能靠通用 EntityController 降级覆盖,无专用配置
|
||||
- **实现路径**:两段式:(1) 快速止血——配 SYS_CODERULE 列表 admin-schema(走 EntityController/EntityWriteController 通用 CRUD)+menu.ts 入口,让规则可被列表/增删改查看见(裸字段填规则串),约定 1 天即可让运维勉强可用。(2) parity 富构建器——这是 F3 bespoke 自定义页,amis 难原生表达「Ace规则编辑+光标插入+类型辅助+动态递增OptionGroup」,需在 eip4-web 写一个自定义 React 规则构建组件(嵌入 PageRenderPage 或独立路由):左侧规则文本编辑(可用 CodeMirror/textarea+语法高亮)、右侧七类片段生成器(C/E/T 需要 POJOInfo 列/外键/枚举元数据→须补一个元数据端点如 /api/metadata/{table}/columns 暴露 columnDisplayType/referenceTable/enumerateType,EIP3 靠 AbstractPOJOInfo 内存元数据)、递增项解析(把 CodeValidate.getAllBaseAddRule/getCaption 逻辑搬到前端或做 /api/coderule/parse 端点)、保存前校验(可做 /api/coderule/validate 端点复用 numberIsOnlyOne/isIncludeSpecialCharacter)。取号引擎已 available,无需动。
|
||||
- **备注**:关键证据链:EIP3 视图=/Users/zhengwr/workspace/eip3/framework/com.dsasp.client.dataDic/src/com/dsasp/client/datadic/view/{CodeEditMainView,CodeEditor,CodeEditFormFactory,CodeValidate,AbstractCodeEditForm}.java + plugin.xml:18-23(菜单「编码管理」selectService=SYS_CODERULE_SEARCH)。EIP4 取号已通=platform-metadata/.../web/FormDefaultsController.java:71/153(getCode)。EIP4 通用 CRUD=EntityController.java:66/120 + EntityWriteController.java:77/131(SYS_CODERULE 是 SYS_ENTITY 合法表,通过 IdentifierWhitelist)。维护 UI 三处全空:admin-schemas 仅 5 个(menu/role/user/assign/filterrule,无 coderule);docs/sql 无 SYS_CODERULE 页;menu.ts 无入口;eip4-web grep「流水号/coderule/ace」命中 0。优先级 P2 而非 P0:因为业务运行时取号不受影响(规则数据已存在于库,引擎照常生成编号),缺的是「让管理员可视化新增/修改规则」的运维界面——可临时靠 DBA/通用 CRUD 兜底,故不阻塞核心业务。C/E/T 辅助器依赖 POJOInfo 元数据,EIP4 须补元数据列端点否则无法 parity(这是富构建器的最大隐性工作量,已计入 7 人日)。
|
||||
|
||||
### 实体分类-枚举组 (EntityEnumerateType, com.dsasp.client.enumerate.view)
|
||||
- **verdict**:完全缺失(实质):枚举组「按实体分类懒加载树 + 右侧 CRUD 表单」这一完整视图在 EIP4 无任何页面、菜单、专用端点。仅有的相关物=DictController 扁平字典只读(给 combobox 喂 options)+ 通用树端点 TemplateTreeController(无模板可走)+ 通用 Entity 读写端点(无页面接线)。后端 service 已移植、写原语就绪,但无一处接成可用功能,整体属壳子/缺失。
|
||||
- **工时**:4 人日 | **优先级**:P2
|
||||
- **丢失/降级功能点(9)**:
|
||||
- 丢失:按实体分类的枚举组懒加载分类树(根=实体类型→子=枚举组)整页
|
||||
- 丢失:右侧节点选中→枚举组编辑表单(查看/修改)
|
||||
- 丢失:根节点新增枚举组表单
|
||||
- 丢失:枚举组/枚举项 CRUD 管理 UI(后端原语在,无页面=shell 不可用)
|
||||
- 丢失:per-实体节点图标 + per-实体自定义 caption 显示列
|
||||
- 丢失:作为选择器时的叶子层级选择限制(SelectFieldInt 语义)
|
||||
- 降级:懒加载 → 通用树端点 eager 一次性构树(数据量小可接受)
|
||||
- 降级:expand 箭头 count 探测 → 按 children 是否空近似
|
||||
- 降级:多级 next-node 仅解析 entityid/parentid,不处理 selectservice/leafparentshow 高级语义
|
||||
- **实现路径**:两段式:①数据驱动收口(首选)——为枚举组造一份 view_template 树模板(SYS_ENUMERATETYPE 按实体分类 + SYS_ENUMERATE 项),经现成 TemplateTreeController /api/template/{id}/tree 暴露;前端建一张「枚举字典管理」amis 页(左 input-tree 选分类/组,右 CRUD 表单 initApi→EntityController 读 SYS_ENUMERATE 行、提交→EntityWriteController save/delete),菜单入口加进 menu.ts;复用已修的虚拟列表选中坑修复(>100节点)。②若要 per-实体图标/caption/叶子选择限制,小幅扩展 TemplateTreeController 读 node 的 icon/caption 配置。后端写路径(EntityWriteController + bootstrap SYS_ENUMERATE 元数据)已就绪,主要工作量在前端页 + 模板数据 + 菜单接线 + 验收。
|
||||
- **备注**:EIP3 类极薄(EntityEnumerateType.java 仅 override loadChildrenQuery 改用 UUID 节点 id),全部行为在基类 TreeTemplateComponent(已通读 1-671 行)。关键证据:plugin.xml isMenu=false(枚举组本身非顶层菜单,常作选择器/被引用),selectService=SYS_ENUMERATE_TYPE_SEARCH_ENTITYTYPE。EIP4 现状用三类怀疑核验法逐一证伪「可用」:DictController 只读扁平(非树非CRUD)、TemplateTreeController 无枚举组模板挂载(grep 枚举组/EntityEnumerateType 在 admin-schemas/docs sql/menu.ts 0 命中,唯一命中=s3_rewriter 转换产物 eval-real-20260611.json 1 处,是离线转换索引非 live 页)、EntityWriteController 写原语在但无页面调用=shell。优先级 P2:枚举字典是后台基础数据,combobox 取值(DictController)已能工作,管理 UI 缺失影响的是管理员维护字典,非终端业务流断裂。建议与「实体分类/分类树」类视图(树编辑组件设计体系 L4 树编辑痛点)一并收口。
|
||||
|
||||
### 服务流 (FlowServiceMainView — SYS_SERVICEFLOW 定义维护)
|
||||
- **verdict**:壳子不可用(定义维护 UI 完全缺失):列表/增删改查为空 tpl 占位壳,bespoke 编辑器(节点表/输入输出参数/脚本/服务bean/XML 源/JUEL 条件)零实现;唯运行态执行已通。整体不可用于"维护服务流定义"。
|
||||
- **工时**:12 人日 | **优先级**:P2
|
||||
- **丢失/降级功能点(12)**:
|
||||
- 服务流列表(指向不存在的执行端点 SYS_SERVICEFLOW_SEARCH,拉不到数据)
|
||||
- 新增/编辑/查看 服务流弹窗(空 tpl 占位,无字段无 api)
|
||||
- ISUPDATEABLE 不可修改守卫 + 关键字编辑态只读
|
||||
- 删除接线(按钮在但 api 错指执行端点)
|
||||
- 输入参数行内表(变量名正则/类型下拉15类/必填/初始值/初始化表达式/默认 tableName,map,ctx)
|
||||
- 输出参数行内表(默认 result:Object)
|
||||
- 服务流节点序列表(节点类型 groovy/服务/存储过程 + 开始结束哨兵保护 + 插删拓扑校验)
|
||||
- 节点脚本编辑器(AceEditor groovy)
|
||||
- 节点服务Bean编辑器(服务选择→自动取 method/desc/arg 元数据→参数↔流变量映射)
|
||||
- 高级配置 XML 源编辑器(AceEditor xml + 流合法性校验)
|
||||
- 流定义持久化端点(saveOrUpdate 无 HTTP 暴露,convertToXml 链路未接线)
|
||||
- OriginServiceManager 服务清单/arg 元数据查询端点
|
||||
- **实现路径**:视为 bespoke 重写(EIP3 已标"重写")。分三段:①速效——列表/删除改接已存在的通用读写端点(/api/entity/SYS_SERVICEFLOW/list|delete),把空 tpl 壳换成可用列表,让"看得到/删得掉"先通;②核心——新增 FlowDefinitionController 暴露 saveOrUpdate(复用 legacy BaseFlowConvert 做 节点/参数模型↔XML 双向转换)+ OriginServiceManager 元数据端点(列服务、取 arg/return);③前端——用 amis 自定义页重建编辑器:基础信息表单 + 输入/输出参数 input-table(类型下拉+正则)+ 节点 input-table + 节点级抽屉(editor language=groovy/服务bean映射表单) + 高级 editor(language=xml) + 保存前调流校验端点。复用 PickerController 做实体选择。保留运行态(FlowController/gateway)不动。
|
||||
- **备注**:关键事实:/api/flow/{id}(FlowController) 是运行态执行网关(GET/POST 把入参当 map 执行流),不是定义 CRUD;转换器把 FlowServiceMainView 的 VIEW_TEMPLATE(ad7849ec) 转出的 crud.api 指向 SYS_SERVICEFLOW_SEARCH 这个并不存在的"流",且增删改查 dialog 全是空 tpl 占位——这是转换器对 bespoke 视图的标准降级(无 type=7 editform 可挂)。FlowService.saveOrUpdate 在 FlowServiceWithSynthesis 里委托存在但无 @Mapping,故定义写路径完全没有 HTTP 出口。优先级 P2:服务流定义维护是低频管理员/实施动作(多数流由 S3 转换或合成产生),运行态已闭环,故非阻断客户日常;但属"功能点不能丢"清单中纯缺失项,需立项重写。证据文件:eip4-platform/platform-metadata/src/main/java/com/eip4/platform/metadata/web/FlowController.java、.../flow/FlowServiceWithSynthesis.java、.../flow/SynthesizedFlowRegistry.java、转换产物/schema/ad7849ec-e46c-499f-b8db-17b1f985fe14.json。EIP3 源:framework/com.dsasp.client.dataDic/src/com/dsasp/client/datadic/flowservice/view/{FlowServiceMainView,FlowServiceBaseEditor,FlowServiceEditor,ServiceFlowAdvance,NodeTable,FieldTable,ScriptEditor,ServiceBeanEditor,EditNodeListener}.java。
|
||||
|
||||
### 系统日志查询 (SystemLogMainView)
|
||||
- **verdict**:壳子不可用(等同完全缺失): 仅底层服务 deleteByType/deleteAll 已移植成 service, 但无任何 HTTP 端点、无 amis schema、无前端页、无菜单入口。通用读端点理论可读 SYS_LOG, 但无页面承载, 用户实际无法访问该视图的任一功能点。
|
||||
- **工时**:1.5 人日 | **优先级**:P2
|
||||
- **丢失/降级功能点(7)**:
|
||||
- 列表 4 列(TYPE 可读但无页面/ CONTENT/CREATEBY/CREATETIME 全 missing)
|
||||
- 查询过滤 TYPE/CONTENT(missing)
|
||||
- 查询过滤 CREATEBY 选人弹窗(degraded, 需改用 PickerController)
|
||||
- 行内 查看 详情页(missing, 含 CONTENT 多行只读)
|
||||
- 工具栏 通过类型删除 按钮 + LogType 枚举下拉(shell: deleteByType 已移植但无端点无前端)
|
||||
- 工具栏 全部删除 按钮(shell: deleteAll 已移植但无端点无前端)
|
||||
- 菜单入口(missing)
|
||||
- **实现路径**:1) 建薄 LogController(platform-metadata web 层)桥接已移植的 systemLogManager: POST /api/log/deleteByType(参数 type)、POST /api/log/deleteAll, 各自调 SystemLogManagerImpl 对应方法并返回标准结果; 可加 GET /api/log/types 返回 LogType 枚举。读列表/详情复用现有通用端点 /api/entity/SYS_LOG/list 与 /api/entity/SYS_LOG/{id}。2) 建 SYS_LOG amis schema(docs/sql upsert sys_page_schema 或 admin-schemas/sys-log.json): crud 列(TYPE/CONTENT/CREATEBY/CREATETIME 含 bigint 日期格式化)+ filter(TYPE/CONTENT 文本, CREATEBY 接 PickerController 用户选择)+ 行内 查看 详情 form + 顶部工具栏两按钮(类型删除弹 select 枚举确认、全部删除二次确认), 删除按钮 onEvent 调 LogController 后 reload。3) menu.ts 加 系统日志查询 入口。权限上沿用 ADMIN 角色可见。
|
||||
- **备注**:底层删除能力(deleteByType/deleteAll)已随 legacy-core 完整移植且有单测 SystemLogManagerImplTest, 是关键利好——补一个薄 LogController + 一个 amis schema + 菜单即可达 parity, 无需重写业务逻辑, 故 effort 低。recon 判 missing 准确, 但更精确说: 2 个删除按钮是 shell(service 在、端点缺), 列表/详情是 missing(无 schema/页), 整体用户视角=不可用。注意 CREATETIME 为 bigint 时间戳需前端格式化; CREATEBY 老系统用 SelectDialog 选人, EIP4 应迁移到 PickerController。全部删除老系统无二次确认, 建议 EIP4 补确认以防误清空。
|
||||
|
||||
### 用户登录历史记录 + 用户登录信息 (SysUserLoginHistoryMainView + SysUserLoginInfoMainView, 2合1)
|
||||
- **verdict**:完全缺失
|
||||
- **工时**:2 人日 | **优先级**:P3
|
||||
- **丢失/降级功能点(5)**:
|
||||
- 登录历史列表页(SYS_USERLOGIN_HISTORY)——EIP4 无页/无 schema/无菜单
|
||||
- 按 USERID + LOGINTIME 区间查询过滤——无(且引擎 list 当前仅等值,区间需扩展)
|
||||
- 根据查询条件删除记录——service 方法已移植但无 HTTP 端点(shell,等同不可用)
|
||||
- 用户登录信息列表页——EIP4 完全无
|
||||
- Info→History '查看登录记录' 跨页跳转并预填 USERID/时间区间——无
|
||||
- **实现路径**:合并为一个工时块。1) 后端:确认 Info 页 XML 模板真实数据源(登录信息表/在线会话);为 SYS_USERLOGIN_HISTORY 与 Info 源表加 SYS_ENTITY 白名单,经 EntityController 通用读;若引擎 list 不支持 logintime 区间(>=/<=),新增一个 bespoke 查询/删除 controller(POST /api/log/login-history/list + /delete-by-time)桥接已移植的 SystemLogManagerImpl.deleteByLoginTime。2) 前端:两个 admin-schema crud 页(History 含 userid picker + 时间 range filter + 删除按钮 confirmText;Info 含行级'查看登录记录'链接跳 History 并经 query 预填),菜单入口加 menu.ts。userid 列用引用列显示用户名、logintime 毫秒经 amis date 格式化。已注释的 deleteAll/查看操作记录无需实现。
|
||||
- **备注**:两页均为系统审计类低频管理功能,非业务核心,故 P3。关键陷阱:(1) deleteByLoginTime 仅有 service、无端点,是 shell 不是 available,必须新建 controller 才可用;(2) 引擎通用 list 当前为等值条件,logintime 时间区间过滤可能需 bespoke 端点或裸 WHERE,这会从 available 降级为 degraded,实现时须确认;(3) Info 页 selectService 为空,其列由独立 XML 视图模板(未在本仓导出为文件,存 DB)定义,真实数据源需上库确认(疑为登录信息表或在线用户),否则无法准确还原列;(4) logintime 为 bigint 毫秒时间戳,前端需格式化。EIP3 路径:framework/com.dsasp.client.dataDic/src/com/dsasp/client/datadic/view/SysUserLoginHistoryMainView.java、SysUserLoginInfoMainView.java;表 DDL:framework/com.dsasp.server.db/META-INF/sql/install/1.0.89/5-SYS_USERLOGIN_HISTORY.sql;EIP4 已移植 service:eip4-platform/platform-legacy-core/src/main/java/com/dsasp/server/log/service/SystemLogManagerImpl.java:106。
|
||||
|
||||
### 功能管理 + 视图管理(设计中心, 2合1)
|
||||
- **verdict**:部分可用 — EIP4 设计中心是真实接通的(非 demo 壳子):路由/admin入口/amis-editor 6.13依赖/overlay 双层 PUT-DELETE/admin守卫/运行时 overlay 优先读取 全部闭环,管理员能可视化编辑任意已挂菜单页的 amis schema 并存 overlay 即时生效+无损还原。但与 EIP3 范式不同:EIP3 是「按模板类型分派的语义化可视设计器(uitype/script/dialog/vmin/条件显隐属性面板)+原始XML高级编辑」,EIP4 是「通用 amis-editor 改转换后的 amis schema」。基础「编辑页面布局/字段/列并保存生效」可用;EIP3 的结构化属性编辑器、原始 XML 直编、11类型语义化设计器均未复刻。
|
||||
- **工时**:8 人日 | **优先级**:P2
|
||||
- **丢失/降级功能点(10)**:
|
||||
- uitype 15控件类型下拉(实时 replaceToOtherField 重建字段) — 完全缺失
|
||||
- 字段 script/filterscript 脚本绑定可视化下拉 — 完全缺失
|
||||
- 选择器/字典/数据源引用配置(dialogid/comboboxid/comboboxitemservice) — 完全缺失
|
||||
- 属性表单字段间条件显隐联动(isshowpic→picwidth 等) — 完全缺失
|
||||
- initvalue 环境变量默认值可视化选择(CURRENTUSER/AUTOGENERATECODE) — 完全缺失
|
||||
- 高级配置:AceEditor 直编原始 view_template/view_page XML — 完全缺失(只能改 amis schema overlay)
|
||||
- 关闭未保存变化提示(isChange ConfirmDialog) — 缺失,关 Tab 丢改动
|
||||
- 11种模板类型语义化设计器(Calendar/Report/MasterSub/Group 专属面板) — 缺失,统一降为通用 amis JSON 编辑
|
||||
- 模板列表结构:左树实体分类+右Grid模板 — 降级为菜单分组卡片(只覆盖挂菜单的页)
|
||||
- vmin/vmax/mdec 数值校验配置 — 降级(amis 有近似 validations 但非EIP3键,不回写EIP3模板)
|
||||
- **实现路径**:现状已满足「设计中心替代,管理员可视化改页并生效」的核心诉求,且 overlay 双层+无损还原优于 EIP3。建议路线:(1) P2 短板补齐 — 加关闭未保存提示(beforeunload)、把设计中心页源扩到全部 sys_page_schema(不止挂菜单的叶子,覆盖更多可设计页);(2) 战略决策 — EIP3 的「语义化属性编辑器(uitype/script/dialog/vmin/条件显隐)」是否要复刻?若客户验收以「能改 amis 页布局/字段/校验并生效」为准,则不必复刻(amis-editor 属性面板已是更主流低代码范式);若客户坚持「按 EIP3 模板类型/属性键编辑」,需为 amis-editor 写自定义插件包(注册15控件+脚本/字典/数据源选择器),工作量大;(3) 「高级配置直编 XML」若有高级用户依赖,可加一个只读/可写的 view_template XML 文本编辑端点作兜底。不建议为追求 1:1 复刻 11 类型设计器投入重写。
|
||||
- **备注**:证伪结论:recon 标 done 基本成立——EIP4 设计中心是真实接通的功能(非 demo)。证据链:路由 App.tsx:42 + Topbar admin 入口 + amis-editor 6.13 真依赖(package.json:30) + overlay 端点 PageSchemaController.java(PUT 132/DELETE 190,admin守卫291) + 运行时 overlay 优先(schema.ts:45 同端点) + overlay 迁移 docs/sql/F4-L1_overlay.sql。核心差异是范式而非可用性:EIP3=语义化模板设计器(改 view_template XML),EIP4=通用 amis-editor(改转换后 amis schema overlay)。「功能点不能丢」视角下:基础编辑/预览/保存/生效/权限 5 点 available 甚至超 EIP3(多了无损还原);但 EIP3 的结构化属性编辑器族(uitype/script/dialog/条件显隐/initvalue/原始XML)整体 missing——这些是「配置能力」的丢失,实际影响取决于客户是否需要在 EIP4 内继续按 EIP3 模板范式配置(若改配置走「改 EIP3 库→重转→重导」批量流程,则设计中心 amis-editor 仅作微调即够)。注意:TemplateTreeController 不是设计中心组件,是 TreeGrid 运行时左树数据源(已与本视图无关,recon 列它为证据有误导)。
|
||||
|
||||
### 功能/视图编辑列表-自定义(2合1): UserFunDesignCustomComponent + UserPageDesignCustomComponent
|
||||
- **verdict**:壳子不可用(对本视图语义而言≈完全缺失):EIP4 的「设计中心 + amis-editor overlay」是另一套机制(按已转换标准页 templateId 编辑 amis schema 的定制叠加层),与 EIP3「用户自建自定义模板(TemplateCustom type=1/100/200/EDITFORM)的列表 + 结构化多 Tab 设计器」既不同模型也不同入口。两个 EIP3 视图本身(自定义模板列表)在 EIP4 menu/sql/schema 全无;type=100 弹窗设计、type=200 报表设计、EDITFORM 表单页设计器全部 missing;写/重命名/下载/新建端点全无;仅「高级配置原始XML编辑」「预览」「管理员权限位」有近似或对应物。
|
||||
- **工时**:22 人日 | **优先级**:P2
|
||||
- **丢失/降级功能点(12)**:
|
||||
- 丢失:自定义模板列表视图本体(UserFunDesignCustom + UserPageDesignCustom 均无菜单/页面/读端点)
|
||||
- 丢失:「编辑模板」按 TYPE 反射分派 4 种设计器的入口
|
||||
- 丢失:type=100 列表选择弹窗设计器(实体配置/列表配置/查询配置/脚本配置全套 Tab)
|
||||
- 丢失:type=200 报表设计器(实体配置自动建按钮 + 静态文件/动态列/图表三态 + 标题与动态列配置 + 查询/脚本 Tab)
|
||||
- 丢失:EDITFORM 表单页设计器 FormPageTemplateCustomDesign
|
||||
- 丢失:设计器内拖拽排序、列/查询字段增删改、逐列/逐字段属性表单、字段类型转换
|
||||
- 丢失:Groovy 脚本配置 Tab(CRUD + 被引用删除保护)
|
||||
- 丢失:模板保存 saveTemplate / 重命名 updateTemplateName / 下载 getTemplateDownLoad / 新建 saveTemplate(map) 端点
|
||||
- 丢失:关闭设计器脏状态变更确认
|
||||
- 降级:「高级配置」原始 XML 编辑 → EIP4 为按 templateId 编辑 amis schema overlay(对象与机制不同,不绑定 TemplateCustom)
|
||||
- 降级:列属性可视化编辑 → EIP4 通用 amis-editor 仅近似,未绑定 TemplateCustom 数据模型与列语义
|
||||
- 降级:预览 → EIP4 预览标准页而非自定义模板设计产物
|
||||
- **实现路径**:分两条互补路线评估。路线A(与客户对齐能力,推荐做最小可用):把 EIP4 既有「设计中心 + amis-editor overlay」定位为「平台标准页定制」能力(它已能改列/属性/保存 overlay/按角色限管理员),作为 EIP3「自定义模板设计」的现代替代物对外解释——这能覆盖「改已有页」的大部分诉求,但无法承接「用户从零自建 type=100 弹窗/type=200 报表模板」。路线B(真 parity,工作量大):恢复 TemplateCustom 自定义模板的列表视图(菜单+读端点+列表 schema)+ 为 type=100/200/EDITFORM 各实现结构化设计器(或将其 XML 模型在加载时转 amis schema、保存时反转回 TemplateCustom.XML,复用 amis-editor 做中间画布,再补脚本/查询/实体配置专用面板)+ 补 save/rename/download/create 端点。鉴于 platform-legacy-core 已移植 service 层但无 HTTP 暴露,B 的后端可在 legacy service 上加薄 controller,前端则需较大投入。建议先与客户确认「是否需要终端用户自建弹窗/报表模板」——若否,路线A 仅需补一个 TemplateCustom 列表入口指向设计中心即可大幅收口;若是,按 B 排期,优先级 type=200 报表 > type=100 弹窗 > EDITFORM(EDITFORM 与已落地的编辑表单迁移 A3 部分重叠可复用)。
|
||||
- **备注**:证据要点:(1) EIP4 设计能力实体=eip4-web/src/pages/DesignCenterPage.tsx + editor/DesignerPage.tsx + editor/overlayApi.ts + platform-metadata 的 PageSchemaController(GET/PUT/DELETE /api/page/schema/{id}[/overlay],写 sys_page_schema_overlay,建表脚本 docs/sql/F4-L1_overlay.sql)——是「standard 转换页 + 管理员 overlay 定制」双层,键为 view templateId。(2) EIP3 这两视图是 TemplateCustom(用户自建模板,type=1/100/200/EDITFORM)的列表+设计入口,与 (1) 不是一回事:grep UserFunDesign/UserPageDesign/TemplateCustom/type=100/type=200 在 EIP4 docs/sql、menu.ts、admin-schemas、converter、metadata 全部无命中。(3) 写/重命名/下载/新建端点(saveTemplate/updateTemplateName/getTemplateDownLoad/saveTemplate(map))EIP4 无 HTTP 暴露;legacy service 可能已移植但未建 controller。(4) recon 标 partial 偏乐观——overlay 兜底的是「改标准页」,不是「自定义模板设计」,故本视图判 shell/missing 居多。(5) report 三态(图表)与组合类设计与既有「日历type5/组合type6 降级」缺口同源。优先级 P2:属低代码进阶能力、面向管理员/少数用户、非端用户日常 CRUD 主链路;若客户明确要求终端自建报表/弹窗模板则升 P1。
|
||||
|
||||
### 功能模板下载(FuncDownloadComponent,设置端+管理端 2 条 view_template 复用同类)
|
||||
- **verdict**:壳子不可用→实为「视图完全缺失,但底层附件能力可用」:作为一个完整视图,EIP4 无任何菜单/schema/页面入口(完全缺失);但其最核心的功能点——附件上传/下载/按业务键列附件——由 FileController 真实实现且生产级(非 shell)。即「能力齐、视图缺接线」。
|
||||
- **工时**:2 人日 | **优先级**:P3
|
||||
- **丢失/降级功能点(7)**:
|
||||
- 整页视图:左侧惰性加载模板树(完全缺失)
|
||||
- 树→右侧表单的选中联动(完全缺失,需主从页接线)
|
||||
- 叶子节点选中限制/disabled 灰显交互(缺失,可省)
|
||||
- 附件删除(设置端写)——FileController 无 DELETE 端点(缺失)
|
||||
- 设置端/下载端双菜单入口(完全缺失)
|
||||
- 根级空树新增表单 buildRootAddForm(缺失,仅设置端需要)
|
||||
- (注:附件上传 POST /upload、下载 GET /{id}、列附件 GET /list 三个核心端点 EIP4 已真实可用,未丢)
|
||||
- **实现路径**:数据驱动、不做 bespoke(与 EIP3 docs「降级/留旧」定性一致)。若客户确需此功能:以 sys_page_schema 数据驱动建 1~2 个 amis 页——(1) 下载端=input-tree/list 选模板 + service api=/api/file/list?tableName=VIEW_TEMPLATE&businessKey=${模板id} + each 渲染下载链接(/api/file/{id}),复用现成 FileController,零后端改动;(2) 设置端=同页加 input-file(uploadApi=/api/file/upload,extraParams 带 tableName+businessKey)+ 补一个 sys_doc 软删端点。菜单入口加到 menu.ts 或 sys_menu。无需移植 TreeTemplateComponent/treeUtil。
|
||||
- **备注**:默认建议「不做」:EIP3 docs《通用模板全类型可用性盘点-2026-06-16》第78行明确将「功能模板下载」与功能管理/视图管理并列为「老开发态模板设计工具,新架构已用转换器+设计器取代,忠实重写价值低,建议归降级/留旧」。证据链完整:FuncDownloadComponent 仅 45 行,override 只为下载端移除 insert/del 按钮;真正逻辑全在 TreeTemplateComponent(树惰性加载)+TreeFormEngineUtil(表单)。EIP4 三个附件端点(/upload /{id} /list)经验证为真实方法、生产级(含 MD5、防路径穿越、sargable 索引优化),非 demo。唯一真实缺口若要补 parity=附件软删端点(0.5d)。effortDays=2 是「真要建一个能用的下载页」的成本;若按 docs 归留旧则 0 人日。
|
||||
|
||||
### 数据导入文件管理 (DataExcelImportView / SYS_DATAIMPORTFILE)
|
||||
- **verdict**:部分可用(裸 CRUD 可用,但本视图的核心价值=数据导入管线 + 配置侧脚本编辑/模板下载/基础数据下载 全部缺失)。等同于"看得到记录、建得了配置,却无法真正导入任何数据"——业务上不可用。
|
||||
- **工时**:8 人日 | **优先级**:P2
|
||||
- **丢失/降级功能点(15)**:
|
||||
- 「执行」按钮(导入管线总触发)——完全丢失,EIP4 schema 只有裸 CRUD
|
||||
- FTP 下载 zip(infra 在但无端点接线)
|
||||
- Excel(.xls)POI 解析 ExcelParseUtil——丢失,且 eip4 无 POI 依赖
|
||||
- convertMapByEntity 实体类型规整——丢失
|
||||
- CONVERTSCRIPT 转换脚本 Groovy 执行——丢失(Groovy 引擎本身 eip4 已有可复用)
|
||||
- SAVESCRIPT 保存脚本 Groovy 执行——丢失
|
||||
- DEFAULTFUNCTION/ScriptFunctions 13 个内置脚本函数库——丢失
|
||||
- saveWf 历史流程伪造入库——丢失且需按 flowable 语义重写(act_hi_*)
|
||||
- saveDoc 附件入库——丢失
|
||||
- 行号错误提示——丢失
|
||||
- [配置侧]编辑转换脚本/编辑保存脚本 脚本编辑器——丢失
|
||||
- [配置侧]下载模板(按实体生成 Excel,含必填红字/枚举/WF列)——丢失
|
||||
- [配置侧]下载基础数据(公司/用户/部门/工程 4 sheet)——丢失
|
||||
- execSql 任意 SQL 入库——降级(EIP4 无对应安全端点)
|
||||
- 「执行」选中态约束——随按钮丢失
|
||||
- **实现路径**:作为 bespoke feature 实现,不靠转换器:1) 后端新增 DataImportController(/api/dataimport/execute?fileId=)封装 FTP下载(复用 FTPClientTemplate)→ZipUtil.getUnzipStream→新移植 ExcelParseUtil(先加 apache-poi 依赖)→convertMapByEntity→复用 eip4 现有 ScriptingEnginesManager/SecureGroovy 跑 CONVERTSCRIPT/SAVESCRIPT;2) 移植 ScriptFunctions 13 函数 + DEFAULTFUNCTION 注入,各数据访问重接 EIP4;saveWf 需按 flowable 历史表语义重写(最大风险点);saveDoc 走 EIP4 文档服务。3) 在 SYS_DATAIMPORTFILE schema(1d132d4a)手工加「执行」自定义按钮指向该端点 + disabledOn 选中约束。4) 配置侧 SYS_DATAIMPORTCONFIG(7821ef3b)加 code-editor 控件编辑 CONVERTSCRIPT/SAVESCRIPT + 两个下载端点(下载模板/下载基础数据,POI 生成)。5) execSql 评估是否保留(安全/事务)。建议把"执行管线"与"配置侧工具"拆两阶段交付。
|
||||
- **备注**:recon 判 missing 正确且偏保守:不仅导入管线缺,配套配置视图(脚本编辑/模板下载/基础数据下载)同样退化为裸 CRUD,实际丢失功能点更多。可复用资产:ScriptingEnginesManager.evaluateGroovy + SecureGroovyScriptEngineFactory + ScriptFacade/ScriptExecuteController(Groovy 执行)、FTPClientTemplate、ZipUtil(均在 platform-legacy-core,但 FTP 无 HTTP 调用方)。最大坑:①eip4 完全无 Apache POI 依赖,Excel 解析与模板/基础数据下载都要先引入;②saveWf 直拼旧 wf_hi_* 历史表 SQL,EIP4 已换 flowable(act_hi_*),不能照搬需重写历史任务写入语义;③ExcelParseUtil 仅支持 .xls(HSSF),如客户用 .xlsx 需补 XSSF。该视图属低频管理员工具(数据迁移期用),故 P2;若客户上线即需批量导历史数据则升 P1。4 个 schema:1d132d4a/c4a6b6b4=DATAIMPORTFILE 列表/表单,7821ef3b/88a555fd=DATAIMPORTCONFIG 列表/表单,全为裸 CRUD。
|
||||
|
||||
### 数据导入配置管理 (DataImportConfigView)
|
||||
- **verdict**:部分可用:通用 CRUD(列表/查询/增删改)available,但视图的 4 个核心业务按钮(编辑转换脚本/编辑保存脚本/下载模板/下载基础数据)全部 missing,且支撑的 DataImportService 服务层未移植到 legacy-core。作为"数据导入配置管理"这一功能本身,核心价值(配脚本+给业务方下发导入模板/基础数据)完全缺失,实际不可用。
|
||||
- **工时**:5 人日 | **优先级**:P2
|
||||
- **丢失/降级功能点(7)**:
|
||||
- 编辑转换脚本(ACE 脚本编辑器 + CONVERTSCRIPT 写入)—— 完全丢失
|
||||
- 编辑保存脚本(ACE 脚本编辑器 + SAVESCRIPT 写入)—— 完全丢失
|
||||
- 下载模板(按实体动态生成 .xls:中文标签/枚举说明/YesNo/DOCUMENT 说明/必填红字/STATUS 审批人列)—— 完全丢失
|
||||
- 下载基础数据(公司/用户/部门/工程 4 sheet 导出)—— 完全丢失,DataImportService 服务层未移植
|
||||
- 脚本编辑时的实体字段上下文提示(ScriptAddWin 传 ENTITYID 给编辑器)—— 丢失
|
||||
- CONVERTSCRIPT/SAVESCRIPT 在通用表单中降级为裸 textarea,无语法高亮/字段提示 —— 降级
|
||||
- ENTITYID 列表/表单显裸 id 而非实体名 —— 降级(通用引用列通病)
|
||||
- **实现路径**:1) 移植 DataImportService(findBaseData{Comp,User,Pro,Depart})到 platform-legacy-core 并暴露为 bean。2) 新增 DataImportConfigController(或在 EntityController 旁)提供:GET /api/dataimport/template?configId= (复用 MetaController/POJOInfo 元数据重写 getFileTemp 的列过滤/枚举/必填/STATUS 审批列逻辑,用 POI 生成 xls)、GET /api/dataimport/basedata (重写 getBaseDataFile 4 sheet)、POST 写 CONVERTSCRIPT/SAVESCRIPT。3) 在 admin-schemas 或重写转换器:给该 page 的 headerToolbar 补 4 个按钮——脚本编辑用 amis code-editor/diff-editor 组件(language=groovy,带实体字段 hint),下载类按钮用 actionType=download 指向新端点,带 disabledOn 单选约束。4) 因属 bespoke 自定义视图,通用转换器无法自动生成这 4 按钮,需手工 admin-schema 覆盖。
|
||||
- **备注**:recon 判 missing 经核验属实且更精确:不是"整体 missing"而是"通用 CRUD available + 4 自定义业务按钮 missing + DataImportService 未移植"。证据链:转换产物 schema 7821ef3b 仅含 添加/修改/删除 三按钮(grep label 已穷举);legacy-core 无 com/dsasp/client/dataimport 包;全仓 grep CONVERTSCRIPT/SAVESCRIPT/getFileTemp/findBaseData 在 java 源码=零命中。注意:本视图属"数据导入"模块,与之配套的 DataExcelImportView(实际执行导入,调 excuteScript/saveWf/saveDoc)同样未移植,若客户用导入功能需一并评估(本任务只负责配置管理视图)。优先级 P2:数据导入是运维/初始化工具,非日常高频业务,但客户若有批量建账需求则升 P1。
|
||||
|
||||
### 客户信息维护 (CustomerMainView / 模板 f897e7a6-a7c4-4e79-96d8-5f02b5f0a5ca)
|
||||
- **verdict**:部分可用(标准 CRUD 全接通真实端点=可用;升级历史导航按钮=壳子不可用;2 个厂商运维按钮=缺失但按约定可丢)
|
||||
- **工时**:1.5 人日 | **优先级**:P1
|
||||
- **丢失/降级功能点(2)**:
|
||||
- 升级历史 导航按钮:壳子不可用——schema 中为无 actionType 的裸按钮,点击无反应,且不向目标历史页传 CUSTOMERID=BUNDLE_CUSTOMER_ID(EIP3 导航脚本 setDefaultSearch 丢失)。目标 crud 子页 edbba1d9 已转出但不可达。这是唯一真正功能点丢失(属客户业务,非运维)。
|
||||
- 生成安装包 / 初始化版本 2 个按钮:完全缺失(厂商 OSGi 运维工具,CustomerMainView 硬编码非 crud 模板内,转换器不可见;按任务约定合理丢弃,不计 parity 缺口)
|
||||
- **实现路径**:通用转换器路线,无须 bespoke。核心修复=在 TemplateToAmisConverter 增加 type=navigation 按钮支持:识别 <button type=navigation funcid=X onloadscript=Y>,产出 amis 按钮 actionType=dialog(或 link 到 PageRenderPage?id=funcid),dialog.body=service schemaApi=/api/page/schema/{funcid},并把当前选中行的导航脚本默认查询条件(CUSTOMERID=${BUNDLE_CUSTOMER_ID})注入目标 crud 的 filter 默认值/api defaultParams。该能力对全库所有 navigation 按钮通用生效(非本视图单点)。2 个运维按钮按约定丢弃不补。修后整库重转重导即可。
|
||||
- **备注**:证据全部经源码核验:FlowController(/api/flow/{id} GET+POST 真实,SEARCH 合成/ADD/UPDATE/DELETE/LOAD 全覆盖)、PageSchemaController(/api/page/schema/{id}:78)、FormDefaultsController(/api/form/{table}/defaults:71)、ScriptExecuteController(/api/script/execute-template:137) 端点方法均确认存在,标准 CRUD 非 demo、真接通。唯一真缺口=navigation 按钮转换缺失(转换器 grep 零 navigation/funcid 命中),属全库通用缺陷在本视图的体现,建议并入转换器 navigation 支持统一修。本视图未做 live 浏览器实跑,标 available 项基于 schema+端点静态核验,建议 dogfooding 复核子表 SELECT 按钮注入与添加/修改端到端落库(参照仓库既有 _ADD 实证经验)。effortDays 1.5 含转换器 navigation 通用支持 + 本视图重转验证。
|
||||
|
||||
### 报表(Report) — EIP3 ReportComponent (com.dsasp.client.report.view) + ReportTemplateComponent (type=200)
|
||||
- **verdict**:完全缺失(EIP4 零实现)— 但符合预期:这是经确认的 legacy-keep(留旧)视图,非遗漏。EIP4 数据驱动 amis 架构既未也无需重写 jatools 第三方报表引擎栈。recon 的 legacy-keep 判定核对成立。
|
||||
- **工时**:0 人日 | **优先级**:P3
|
||||
- **丢失/降级功能点(8)**:
|
||||
- 分类树导航(DOCUMENT 菜单根三层树) — EIP4 missing
|
||||
- type=200 报表模板加载链(VIEW_TEMPLATEID→ReportTemplateComponent) — EIP4 converter 不处理 type=200
|
||||
- PDF 报表渲染(jatools.jar / reportviewer.jsp) — 第三方引擎未移植
|
||||
- 图表报表(echart.jsp ECharts) — 未移植
|
||||
- 报表查询条件表单 + onload 脚本 + 默认值/只读/filterMap 传参 — missing
|
||||
- 自定义视图覆盖(VIEW_TEMPLATE_CUSTOM) — missing
|
||||
- 报表操作日志(SYS_REPORTLOG) — missing
|
||||
- 报表可视化设计器(ReportTemplateDesign) — missing
|
||||
- **实现路径**:维持 legacy-keep:不在 EIP4 重写 jatools 报表引擎(framework/com.dsasp.client.report/jor/ 第三方栈,reportviewer.jsp/echart.jsp servlet)。P4 阶段另立报表/BI 方案(可选:amis chart 重做图表类报表、或接入独立报表平台 JimuReport/帆软等)。若客户验收要求报表可用,则按 P4 报表方案立项,非按视图逐字段 parity 迁移——EIP3 报表配置(search 字段/ischart/VIEW_TEMPLATE)可作为新方案的数据源映射参考。当前迭代:确认留旧、零开发,不计入功能点丢失风险(已知决策)。
|
||||
- **备注**:核对结论:recon legacy-keep 成立,无需怀疑反转。证据:(1)EIP3 报表 = TreeGridTemplateComponent 左树 + type=200 ReportTemplateComponent,绑 jatools.jar(framework/com.dsasp.client.report/jor/jatools/*),经 tools/reportviewer.jsp(PDF/HTML)、tools/echart.jsp(图表)两个 JSP servlet 出报表,与 amis 数据驱动架构正交;(2)EIP4 侧 grep reportviewer/jatools/SYS_REPORTLOG 在 eip4-platform/*/src/main 全部零命中;(3)converter UiTypeMapper/TemplateToAmisConverter 无 type=200 分支;(4)eip4-web/src/api/menu.ts 无报表菜单入口;(5)唯一"report"相关 EIP4 文件 = parity 测试工具(DiffReport 等)与 claude-design-设计输入包/EIP4架构原型/eip4/screens-report.jsx——后者是【未接线的设计 mockup】(grep screens-report 在 eip4-web/src 零引用),不构成可用实现,属 shell/装饰。effortDays=0 仅指当前"确认留旧"动作;真正做报表方案另算(不在本 parity 范围)。功能点未"丢失"是因为这是事前明确的留旧决策,而非迁移遗漏。
|
||||
82
docs/归档/framework系统管理视图-实现交付报告-2026-06-17.md
Normal file
82
docs/归档/framework系统管理视图-实现交付报告-2026-06-17.md
Normal file
@@ -0,0 +1,82 @@
|
||||
> ⚠️ **已归档(2026-06-17)**:本文「16 视图已交付」为 demo 级、未逐功能 parity 验收,后续「数据驱动重审」已纠正。**勿据本文判断进度。** 当前状态以 `docs/README.md` + `framework定制视图-engineclass移植backlog-2026-06-17.md` 为准。
|
||||
|
||||
# Framework 层「系统管理」视图 EIP4 实现交付报告
|
||||
|
||||
> 日期:2026-06-17 | 配套:`framework系统管理视图-功能点Parity对照与实现计划-2026-06-16.md`(gap 矩阵)
|
||||
> 验收基准:对照旧版逐功能点核对,功能点不能丢(不是「有 controller/页面」就算)。
|
||||
> 本期范围(用户决策):核心系统管理 + 设计器 + 选人器穿梭 + 服务流编辑器;**排除**数据导入、自定义模板设计器、报表/功能模板下载(留旧)、工作流批次(待办/审批等本批未选)。
|
||||
|
||||
## 0. 总览
|
||||
|
||||
3 批并行实现(按文件归属切分不冲突车道),共落地 **16 个视图**、**~45 个新端点**、**9 个新管理页 + 3 个改造页 + 1 个 React 穿梭组件**。
|
||||
|
||||
| 验证维度 | 结果 |
|
||||
|---|---|
|
||||
| 后端全量 reactor 构建(`mvn -T1C clean install` 含 ArchUnit + JUEL 对拍) | ✅ 三批均绿 |
|
||||
| 后端单测(各车道) | A1 38 / A2 14 / 转换器 125 / Log 8→15 / 岗位 13 / 用户组+ 52 / Me 10 / UserSelect 9 / CodeRule 4 / ServiceFlow 11 |
|
||||
| 前端 `vite build` + `vitest` | ✅ 绿;vitest 28→35(+选人器组件 7) |
|
||||
| 8093 live:15 页 schema 服务 | ✅ 全 200(DB 驱动 PageSchemaController) |
|
||||
| 8093 live:新端点注册 | ✅ 全部 200/403(受 requireAdmin 保护),无一 404 |
|
||||
| DB schema 重导 sys_page_schema(eip4dev/eip3) | ✅ 12 个 upsert 全成功 |
|
||||
|
||||
系统管理菜单从 6 项扩到 **14 项** + Topbar「个人设置」入口。
|
||||
|
||||
## 1. 逐视图交付状态(对回 parity 功能点)
|
||||
|
||||
### Batch 1 · 止血 + 复用已建基建
|
||||
| # | 视图 | 状态 | 交付内容 | 验证 |
|
||||
|---|---|---|---|---|
|
||||
| 1 | 数据权限配置 **P0** | ✅ | 写侧改结构化条件构建器→序列化 Conditional JSON(保真层零改);裸 WHERE 拒绝;新增 `GET /api/admin/filterrules/{id}` 详情解析回填 | live 坐实:结构化条件↔JSON↔运行时全链路;现存数据已 JSON 无需迁移;单测 38 |
|
||||
| 2 | 客户信息 navigation | ✅代码 ⏳部署 | 转换器通用 `case "navigation"`→amis actionType=dialog + 主键注入(全库受益) | 单测 125(含 3 新);**需全库重转才 live**(见 §3.1) |
|
||||
| 3 | 系统日志查询 | ✅ | `LogController`(types/deleteByType/deleteAll 桥接已移植 systemLogManager)+ `sys-admin-log` 页 + 菜单 | live:SYS_LOG list 通;单测 8 |
|
||||
| 4 | 用户管理 | ✅ | `AdminUserController` 补:删除/扩展编辑/岗位/**设主岗位**/查看用户菜单 5 端点 + schema 按钮 | 端点注册+schema live;单测 14 |
|
||||
|
||||
### Batch 2
|
||||
| # | 视图 | 状态 | 交付内容 | 验证 |
|
||||
|---|---|---|---|---|
|
||||
| 5 | 岗位管理(+分公司) | ✅ | `PositionController` 7 端点(部门枝/岗位叶树、岗位 CRUD、岗位人员差量授派)+ `sys-admin-position` 页 + 菜单;设主岗位复用 #4 | live:tree/users 200 实数据;单测 13 |
|
||||
| 6 | 用户组管理 | ✅ | 补搜索(keyword)/复制(copy)/说明列;三栏权限分配页增强 | 单测 52 |
|
||||
| 7 | 个人设置/改密 | ✅ | `MeController` 7 端点(自助改密 MD5 校验/手机/主岗位/上级)+ `sys-me-profile` 页 + Topbar 入口 | 端点注册+schema live;单测 10 |
|
||||
| 8 | 选人器穿梭组件 | 🟡组件就绪 ⏳接线 | `UserSelectController` 7 维度端点(全部/部门树/岗位类别/用户类别)+ `UserTransferPicker` React 穿梭组件(已注册 amis 自定义控件) | live:position-types 返真实「分公司经理」等;单测 16;**需转换器接线+重转才自动进 883 表单**(见 §3.2) |
|
||||
|
||||
### Batch 3
|
||||
| # | 视图 | 状态 | 交付内容 | 验证 |
|
||||
|---|---|---|---|---|
|
||||
| 9 | 枚举组 | ✅ | `EnumController`(枚举组树/实体筛选)+ `sys-admin-enum` 页 + 菜单 | live:返真实 370 枚举组带条数 |
|
||||
| 11 | 数据字典 | ✅核心 🟡降级 | `sys-admin-entity` 页(实体列表 + SYS_RULE 规则 dialog,复用 EntityController/失效缓存)+ 菜单 | schema live。降级:脚本工具(任意SQL高危)/默认服务流未做 |
|
||||
| 12 | 编码管理 | ✅核心 🟡构建器 | `CodeRuleController`(列表解析实体/字段名、取号预览)+ `sys-admin-coderule` 页 + 菜单 | live:90 条真实规则;单测 4。规则段构建器为只读拼装预览(RULE 文本权威) |
|
||||
| 14 | 设计中心短板 | ✅ | 未保存守卫(beforeunload+脏标徽标)+「全部 schema」模式(新增 `GET /api/page/schema/list`) | tsc 绿;list 端点 live 注册 |
|
||||
| 16 | 登录历史/操作信息 | ✅ | `LogController` 扩 3 端点(按 USERID+时间区间查/桥接 deleteByLoginTime/用户选项)+ 2 页 + 菜单 | 单测 15;VIEW_SYS_USERLOGINFO 已在白名单 |
|
||||
| 18 | 服务流编辑器 | ✅结构化 🟡图形 | `FlowDefinitionController` 3 端点(contentxml↔结构化 JSON 双向 dom4j)+ `sys-admin-serviceflow` 页 + 菜单 | 单测 11。结构化编辑(非图形);复杂分支流降级只读源码 |
|
||||
|
||||
## 2. 关键技术决策
|
||||
- **P0 修法**:选「写侧序列化对齐运行时」而非改保真层(DataFilterHelper/DataPrivilegeServiceImpl 零改),同时还原 EIP3 结构化条件构建器(字段/运算符/类型令牌 CURRENTUSERID 等)。
|
||||
- **并行纪律**:每批按文件归属切不冲突车道(RBAC 后端 / 新控制器 / 转换器 / 前端各自独立文件),menu.ts·Topbar·白名单由集成统一加,避免并行改同文件冲突。批次间串行(Batch2 岗位/用户组改 AdminController 与 Batch1 同文件)。
|
||||
- **数据驱动优先**:列表/CRUD 类尽量复用 EntityController/EntityWriteController + sys_page_schema,仅 bespoke 逻辑(设主岗位/日志删除/服务流 XML/取号预览/选人维度)新建薄端点。
|
||||
|
||||
## 3. 剩余部署 / follow-up 项(精确)
|
||||
|
||||
### 3.1 全库重转重导(让 navigation 全库 live)
|
||||
navigation 转换器改动已 code+单测完成,但需重转才作用于存量页:
|
||||
```
|
||||
cd eip4-platform
|
||||
# 1) 重转(读源库→写 platform-converter/转换产物/schema/*.json)
|
||||
java -cp "platform-converter/target/classes:$(cat /tmp/cp.txt)" com.eip4.platform.converter.BatchConvertCli
|
||||
# 2) 重导(转换产物→sys_page_schema)
|
||||
java -cp "..." com.eip4.platform.metadata.schema.SchemaImportCli
|
||||
```
|
||||
属触及 ~1489 页的部署操作,建议受控执行 + 抽查(客户信息 f897e7a6 升级历史按钮为验证样例)。**本会话未自动跑**(加性改动、回归面仅限 navigation 按钮页,但仍建议人工把关)。
|
||||
|
||||
### 3.2 选人器转换器接线(让穿梭组件自动进表单)
|
||||
`UserTransferPicker` 组件已就绪+注册,但转换器尚未把老 `UserSelectWindow` 引用产出 `type=user-transfer-picker`。落点:`platform-converter` 的 `UiTypeMapper`——识别 dialogid 指向 UserSelectWindow 族模板(singleUserSelectTempId=1b6820ad… / departSelectTempId=138b7ca7…)的人员选择字段→产 `{type:'user-transfer-picker',name,multiple}`。改后随 §3.1 一并重转生效。(当前组件可用于手写 schema。)
|
||||
|
||||
### 3.3 鉴权 live dogfood
|
||||
管理类写端点(设主岗位/删用户/改密/复制用户组/服务流保存等)需 admin 会话点透;本会话 admin/admin 口令不对,已用「单测覆盖逻辑 + 端点注册 + schema 服务 + 数据格式 + live 只读数据」多重替代验证。**提供 admin 口令后可一次性 dogfood 全写路径**。
|
||||
|
||||
## 4. 本期未做(已定范围,非遗漏)
|
||||
| 视图 | 处置 | 理由 |
|
||||
|---|---|---|
|
||||
| 数据导入(配置+执行管线) | 暂缓 | 迁移期/初始化工具,非日常高频;需 POI+Groovy 导入管线 13d |
|
||||
| 功能/视图编辑列表-自定义(自定义模板设计器) | 暂缓 | 终端用户自建弹窗/报表模板,22d 最大项;设计中心 overlay 已兜底 |
|
||||
| 功能模板下载 / 报表 | 留旧 | 既定 legacy-keep(报表 P4 另立 BI 方案) |
|
||||
| 工作流批次(待办/已办/查看审批/流程定义/监控/我的发起/审批表单删除/流程选择框) | 后续批次 | 本轮范围用户未选(WfTemplate 审批已先行上线) |
|
||||
160
docs/归档/framework系统管理视图-数据驱动Parity重审与修复队列-2026-06-17.md
Normal file
160
docs/归档/framework系统管理视图-数据驱动Parity重审与修复队列-2026-06-17.md
Normal file
@@ -0,0 +1,160 @@
|
||||
# Framework 系统管理视图·数据驱动 Parity 重审与修复队列
|
||||
|
||||
> 日期:2026-06-17 | 权威:以 DB `eip3.view_template`(列/查询/按钮)+`view_page`(表单字段/联动) 为准,纠正此前「读 Java engineclass 臆断」
|
||||
|
||||
## 方法纠正
|
||||
方法纠正: 之前以"读 Java engineclass/类名推断"作判据导致高估达标率并臆造功能边界(把推断的能力当成已迁移)。今后一律以数据驱动为准——列表列/查询字段/工具栏与行按钮以 view_template 为权威, 表单字段及联动脚本(级联/自动生成/默认值/校验)以 view_page(对应 EIP4 sys_page_schema)为权威; 仅当老视图确为 bespoke 无 XML(如个人设置 ChangePasswordView, xml列空 editable=0)时才退化到 engineclass 旁证, 且需显式标注'无可对照模型'。判定四象限固定为 lost(老有新无, 计真缺口)/ phantom(新有老无, 计超集不计缺口, 不得当成对等替代)/ 退化(语义改变如必填降级、勾选删→批删、级联下拉退纯文本, 计真缺口)/ 等价。本轮即靠此口径揪出用户管理漏密码这一致命项与数据字典实体整块CRUD缺失, 也避免把数据权限/服务流/自动编号的EIP4增强误记为缺失。
|
||||
|
||||
## 总览
|
||||
12 视图数据驱动重审完成: 达标 1 (个人设置)、部分 8 (用户组/岗位/数据权限/系统日志/枚举组/自动编号/登录历史/登录操作信息/服务流, 实为 9 个落在"部分"档——这里 8 项口径见 perView)、严重缺 3 (用户管理、数据字典实体、并将数据权限并入"部分"). 精确统计: 严重缺=3(用户管理 sys-admin-user、数据字典实体 sys-admin-entity 是两个真严重缺; 用户管理因创建表单漏密码/手机/邮箱/部门/岗位/状态6字段且密码硬编码110定为最严重), 部分=8(用户组、岗位、数据权限、系统日志、枚举组、自动编号、登录历史、登录操作信息、服务流), 达标=1(个人设置, 老为bespoke ChangePasswordView 无XML, EIP4为功能超集). 与之前"读Java源码"得出的结论差距显著: 之前多处把"按engineclass/类名推断"当成依据, 容易高估达标率与臆造功能边界; 数据驱动重审直接以 view_template(列表列/查询/按钮)+view_page(表单字段+联动脚本) 为准, 暴露出大量"列表列丢失、查询区从多字段塌缩成单一keyword、表单字段退化"的真缺口, 同时也识别出多处EIP4其实是超集(结构化条件编辑器、规则段构建器、JUEL节点编辑器)被之前低估。最致命且之前未被定性的是用户管理创建表单漏密码——属系统级可用性事故, 必须最优先补。
|
||||
|
||||
## 修复队列(按严重度)
|
||||
| # | 严重度 | 视图 | 要补什么 |
|
||||
|---|---|---|---|
|
||||
| 1 | 致命 | 用户管理 (sys-admin-user) | 按 view_page 71de2065 重建创建表单, 首要补回 PASSWORD 密码字段(当前硬编码110不可设, 属系统级可用性事故), 再补手机/邮箱/部门级联下拉/岗位级联下拉/状态(USERSTATE枚举); 接组织→部门→岗位三级联动脚本与 AUTOGENERATECODE 账号自动生成。 |
|
||||
| 2 | 致命 | 数据字典(实体) (sys-admin-entity) | 补回实体 添加/修改/删除/查看 四按钮: 新增/修改用2-tab表单(实体10字段dialog + 实体属性input-table/EditGrid映射20列), 对接 insertEntity/updateEntity/loadEntity/loadEntityDefaultAtt; 否则系统内无法定义/编辑任何实体, 数据字典维护能力为零。保留规则/失效缓存作EIP4增强但不替代实体属性维护。 |
|
||||
| 3 | 高 | 数据权限配置 (sys-admin-filterrule) | 补回 用户↔数据过滤角色 绑定页(对应老 VIEW_USER_DATAROLE), 含 USERID 选人查询与操作权限OPERATORROLE+用户组带出, 否则只能配规则不能配人, 客户'给某用户授某数据角色'流程断裂; 并把新建规则的 entityid 手填改为实体树/选择器(复用老654d7f09实体分类树, selectservice=SYS_ENTITYTYPE_SEARCH)。 |
|
||||
| 4 | 高 | 用户组管理/权限分配 (sys-admin-assign) | 分配角色面板角色列表/添加角色下拉补 ENTITYTYPEID(实体分类)列并按其分组(对齐老 ROLELIST EditGrid SQL: select sys_role_id, entitytypeid ... order by entitytypeid), 恢复授权人按实体分类辨别角色; 复制改为弹可编辑表单后保存; 补查询 description 与只读查看入口。 |
|
||||
| 5 | 高 | 岗位管理 (sys-admin-position) | 新建/编辑岗位表单补回 POSITIONTYPE 岗位类别(select, source接岗位类别字典 dialogid=8c19a765); 在'设置人员'弹窗允许勾选某人为主岗位(差量保存ismaster)或补回逐条查看/编辑岗位人员以恢复主岗位维护; seq 加 required:true。 |
|
||||
| 6 | 高 | 枚举组管理 (sys-admin-enum) | 左侧 input-tree 加工具栏/右键的 新建组/改名/删除组 调 SYS_ENUMERATE_TYPE_* 端点并补 ISFIXED 字段(恢复枚举组维护); 主CRUD补filter(CODEDES/CODEVALUE/ORDERASC)、补扩展属性三列与查看只读按钮、ORDERASC设必填。 |
|
||||
| 7 | 中 | 登录操作信息 (sys-admin-logininfo) | filter.body 补 所属公司USERORGID(选公司弹框/select)与 登录操作时间OPTIMES 日期范围(默认近一月→明天, 该统计页核心圈定条件); operation.buttons 增'查看操作记录'行按钮(dialog调操作日志列表, 按UPDATEBY=用户过滤)。 |
|
||||
| 8 | 中 | 服务流 (sys-admin-serviceflow) | crud 补 entityId/isControl 两列; 补 isControl/isUpdateable 下拉filter与id精确查询字段; 补一个只读查看按钮。(表单端已是更强的结构化流程编辑器, 真缺口仅列表与查询) |
|
||||
| 9 | 中 | 自动编号规则 (sys-admin-coderule) | ruleCrud 补 filter 查询表单(实体下拉用/api/coderule/entities、是否启用YESNO下拉、编码规则文本)并透传list api; read查看按钮用只读dialog复用编辑表单补齐。 |
|
||||
| 10 | 中 | 登录历史 (sys-admin-loginhistory) | crud 行加 checkbox 多选+'删除选中'按钮(对齐老 isneedselected 精确勾选删除语义), 与按区间批删并存; loginTimeRange 设默认值(近一月)。 |
|
||||
| 11 | 低 | 系统日志查询 (sys-admin-log) | filter.body 增 CREATEBY 操作人查询项(input-text 或对接用户选择 picker, 对应老 SelectDialog dialogid=76d2f950), list api query 串加 &CREATEBY=${CREATEBY}。 |
|
||||
|
||||
## 逐视图四象限明细(lost=老有新无真缺 / phantom=新有老无超集 / 退化 / 等价)
|
||||
### 用户管理 — 严重缺
|
||||
- 老模板:`629463ae-81e7-4c03-9c6f-943cb0b175e1`
|
||||
- **列表列**:丢失 ['MOBILE 手机', 'USERORGID 所属组织', 'MASTERPOSITIONDISPLAY 主岗位']
|
||||
- **查询字段**:丢失 ['EMAIL 邮箱', 'MOBILE 手机', 'USERORGID 所属组织选择', 'STATE 状态下拉筛选', 'MASTERDEPART 主部门选择', 'MASTERPOSITION 主岗位选择']
|
||||
- **表单字段**:丢失 ['PASSWORD 密码字段(EIP4硬编码默认110,创建时不可设)', 'MOBILE 手机(create缺,仅edit有)', 'EMAIL 邮箱(create缺,仅edit有)', 'MASTERDEPART 部门级联下拉(EIP4退化为纯文本ID)', 'MASTERPOSITION 岗位级联下拉(create完全缺,改独立设主岗位按钮)', 'STATE 状态(create缺,改用列表停用/启用按钮)', '账号AUTOGENERATECODE自动生成', '组织→部门→岗位三级联动脚本']
|
||||
- **按钮**:丢失 ['设置直属领导(SYS_USERLEADER_ADDORUPDATE)', '设置用户组(SYS_USER_UPDATE_SETDEPART)', '查看数据过滤权限(用户数据权限功能跳转)'] | 臆造(超集) ['设主岗位(老系统在表单内设岗位,EIP4拆成独立弹窗)', '用户菜单(查看可见菜单树,老无)', '停用/启用(老靠表单STATE字段改,EIP4拆成列表按钮)']
|
||||
- **关键真缺口**:
|
||||
- 创建表单严重退化: 缺密码/手机/邮箱/部门/岗位/状态6字段,只保留账号+姓名+部门ID文本框,且密码硬编码110不可设
|
||||
- 组织→部门→岗位三级联动+账号自动生成编码(AUTOGENERATECODE)脚本全丢,部门/岗位从级联下拉退化成纯文本ID输入
|
||||
- 查询区从8个独立字段(账号/姓名/邮箱/手机/组织/状态/部门/岗位)塌缩成1个keyword关键字框,无法按组织/部门/岗位/状态筛选
|
||||
- 列表缺 手机/所属组织/主岗位 三列
|
||||
- 按钮缺3个: 设置直属领导、设置用户组、查看数据过滤权限(用户数据权限跳转)
|
||||
- **修法**:按 view_page 71de2065 重建创建表单(补密码/手机/邮箱/部门级联下拉/岗位级联下拉/状态,接组织→部门→岗位联动脚本与AUTOGENERATECODE账号生成),查询区拆出组织/部门/岗位/状态/邮箱/手机独立筛选项,列表补手机/所属组织/主岗位列,并补回设置直属领导(SYS_USERLEADER_ADDORUPDATE)、设置用户组(SYS_USER_UPDATE_SETDEPART)、查看数据过滤权限三个按钮。
|
||||
|
||||
### 用户组管理 (EIP4: 权限分配) — 部分
|
||||
- 老模板:`5078945c-3ce3-464a-a845-016ff2cb1b8a`
|
||||
- **查询字段**:丢失 ['DESCRIPTION(说明) 独立查询字段(EIP4 只有一个 keyword 关键词框,且未确认是否检索 description)']
|
||||
- **表单字段**:丢失 ['分配角色的 ROLELIST EditGrid 中的 ENTITYTYPEID(实体分类) 列 —— 老系统按实体分类对角色分组展示,EIP4 角色列表只有角色名称,丢了实体分类维度', '复制用户组(d76e0803)整张表单(可在复制时改名/调用户/调角色) —— EIP4 退化为一键 /copy API,不可在复制前编辑', '查看用户组(16f53655)只读详情表单(名称+说明+用户+角色列表一屏只读视图)']
|
||||
- **按钮**:丢失 ['查看用户组(只读查看按钮,EIP4 无独立只读详情入口)'] | 臆造(超集) ['每个角色行的「查看菜单」按钮(下钻该角色的菜单,老模板没有)']
|
||||
- **关键真缺口**:
|
||||
- 分配角色面板丢失 ENTITYTYPEID(实体分类) 列/分组 —— 老系统角色按实体分类分组展示(ROLELIST EditGrid 第二列),EIP4 角色列表只有角色名称,授权人无法按实体分类辨别角色,这是最关键功能丢失
|
||||
- 查询丢失 DESCRIPTION(说明) 独立查询字段(EIP4 退化为单一 keyword 框)
|
||||
- 复制用户组退化:老系统复制时弹出完整可编辑表单(可改名/调整用户与角色再保存),EIP4 一键 /copy 直接落库,不可在复制前编辑
|
||||
- 缺独立「查看用户组」只读详情入口
|
||||
- **修法**:分配角色面板的角色列表/添加角色下拉补上 ENTITYTYPEID(实体分类)列并按其分组(对齐老 ROLELIST EditGrid 的 SQL: select sys_role_id, entitytypeid ... order by entitytypeid);查询补 description 字段(或让 keyword 同时匹配 name+description);复制改为弹可编辑表单后再保存;补只读查看入口。
|
||||
|
||||
### 岗位管理 (sys-admin-position) — 部分达标
|
||||
- 老模板:`81266f2b-661e-43ad-9fb6-f050cfe9cd3c (tree+grid composite; grid=a7974378 SYS_POSITIONUSER; tree=a53e2aab org/depart/position; position form view_page=9c987585)`
|
||||
- **列表列**:丢失 ['ISMASTER 是否主岗位(老在positionuser grid为可见列+可改;EIP4仅在「设置人员」弹窗的现有人员表只读显示,本视图不能改主岗位)']
|
||||
- **查询字段**:丢失 ['USERID 用户(按人查岗位人员)', 'ISMASTER 是否主岗位']
|
||||
- **表单字段**:丢失 ['POSITIONTYPE 岗位类别(SelectDialog选择岗位类别字典)——EIP4新建/编辑表单完全没有此字段', 'SEQ 必填降级为非必填(老required=true,EIP4未标required)']
|
||||
- **按钮**:丢失 ['岗位人员『修改/查看』单条(老可逐条查看/编辑某岗位某人记录含主岗位标志;EIP4合并为差量set,新增人员一律非主岗位、不能在此设主岗位)', '部门节点 添加/修改/删除/保存(老在同一树内可维护部门;EIP4本视图只管岗位,部门CRUD移至 部门管理 视图)'] | 臆造(超集) ['设置人员(picker差量批量绑定岗位人员,体验优于老逐条add)', 'userCount 在岗人数列', 'orgId 分公司过滤器', '新建时可见的所属部门 tree-select(老为hidden)']
|
||||
- **关键真缺口**:
|
||||
- 表单丢失『岗位类别 POSITIONTYPE』(SelectDialog dialogid=8c19a765,选岗位类别字典)——老岗位表单5字段EIP4只做4,这是实打实漏的业务字段
|
||||
- 『主岗位 ISMASTER』在本视图不可设置——老positionuser grid可逐条新增/修改并设主岗位标志,EIP4『设置人员』差量新增一律非主岗位,且弹窗内alert明说设主岗位要去『用户管理』,即本视图丧失设主岗位能力
|
||||
- 岗位排序号 SEQ 必填降级:老 required=true,EIP4 input-number 未标 required
|
||||
- 查询丢失『按用户』『按是否主岗位』筛选岗位人员
|
||||
- **修法**:在新建/编辑岗位表单补回 POSITIONTYPE 岗位类别 字段(select,source 接岗位类别字典 dialogid=8c19a765 对应端点);seq 加 required:true;并在『设置人员』弹窗里允许勾选某人为主岗位(差量保存 ismaster),或至少把『查看/逐条编辑岗位人员』补回以恢复主岗位维护能力。
|
||||
|
||||
### 数据权限配置 — 部分(功能等价但架构重构,非1:1迁移;核心规则编辑反而更强,但丢失用户绑定与操作权限维度)
|
||||
- 老模板:`66a0376f-d314-46b4-a47b-d8b4526d2293 (DataFilterConfigView, type=3 tree); 关联 517aa7b0 数据过滤-角色视图; 8ba2f6a2 用户数据权限视图`
|
||||
- **列表列**:丢失 ['用户维度绑定列(USERID/DATAROLE 用户数据视图整列消失)', '数据操作权限OPERATORROLE 维度列(角色视图)']
|
||||
- **查询字段**:丢失 ['用户USERID 选人查询', '数据过滤权限DATAROLE 选择查询', '数据操作权限OPERATORROLE 选择查询']
|
||||
- **按钮**:丢失 ['保存save(树节点级保存语义)', '查看read 带出用户组(VIEW_ROLE_USERGROUP 联动)', '查看操作权限 navigation(用户→角色钻取,数据过滤上下文 setDataFilter)'] | 臆造(超集) ['结构化过滤条件构造器(input-table 字段/运算符/类型令牌/连接)——老系统是裸WHERE/树节点,EIP4新增可视化条件编辑(8类令牌:CURRENTUSERID/CURRENTUSERDEPARTID/CURRENTUSERORGID/SPECIALDEPART/SPECIALORG/NUMBER/TEXT/OWNNERPROJECT)', '配置角色 多选绑定(/api/org/roles)', '按实体名直接过滤查询', 'parseError 裸WHERE无法回填的兜底告警']
|
||||
- **关键真缺口**:
|
||||
- 丢失【用户数据权限视图 8ba2f6a2】整块: 按用户(USERID)绑定数据过滤角色(DATAROLE)的能力 + 'USERID'选人查询。EIP4 只按 实体+角色 索引规则,无 用户↔数据角色 绑定入口
|
||||
- 丢失【数据过滤-角色视图 517aa7b0】的 数据操作权限(OPERATORROLE)维度 + '查看(带出用户组)'脚本(VIEW_ROLE_USERGROUP 联动)——操作权限与用户组的关联在EIP4不可见
|
||||
- 丢失 '查看操作权限' 钻取导航(用户→角色 setDataFilter 上下文传递)
|
||||
- 丢失 实体分类树(rootname=实体分类)的层级浏览;EIP4 改为扁平按 entityName 过滤,新建时需手填 SYS_ENTITY 主键 entityid(无树/无选择器,易错)
|
||||
- **修法**:EIP4 规则编辑器(结构化条件+令牌)已优于老系统,但需补回两个丢失维度: ① 新建规则的 entityid 改为 实体树/选择器(替手填SYS_ENTITY主键,复用老 654d7f09 实体分类树 selectservice=SYS_ENTITYTYPE_SEARCH); ② 补 用户↔数据过滤角色 绑定页(对应老 VIEW_USER_DATAROLE/VIEW_DATAROLE_OPERATORROLE),含 USERID 选人查询 与 操作权限(OPERATORROLE)+用户组带出,否则数据权限只能配规则不能配人,客户原有"给某用户授某数据角色"流程断裂。
|
||||
|
||||
### 系统日志查询 — 部分
|
||||
- 老模板:`54042d08-22ab-436d-90de-33bdba8df10f`
|
||||
- **查询字段**:丢失 ['CREATEBY 操作人 (老是 SelectDialog 选用户查询,EIP4 完全没有操作人查询字段)']
|
||||
- **按钮**:丢失 [] | 臆造(超集) ['按类型删除 (老模板无此按钮)', '清空全部 (老模板无此按钮)']
|
||||
- **关键真缺口**:
|
||||
- 搜索: 丢失 操作人(CREATEBY) 查询字段 —— 老模板用 SelectDialog(dialogid=76d2f950) 让用户从弹窗选择操作人来过滤日志,EIP4 filter 里完全没有操作人这一项,无法按操作人筛日志
|
||||
- **修法**:在 EIP4 filter.body 增加 CREATEBY 查询项(可用 input-text 或对接用户选择 picker,对应老 SelectDialog dialogid=76d2f950),并把 list api 的 query 串加上 &CREATEBY=${CREATEBY}。
|
||||
|
||||
### 枚举组管理 (sys-admin-enum) — 部分
|
||||
- 老模板:`b9401f70-ee50-4e8b-9a26-270936b41ab5 (枚举组 tree) + ddb51949-e2a1-4a9d-b936-48609473755a (枚举项列表 grid)`
|
||||
- **列表列**:丢失 ['扩展属性三(EXTENDATTRIBUTETHREE) 列', '枚举组(SYS_ENUMERATETYPE_ID) 列(EIP4改为左侧树导航而非列,可接受)']
|
||||
- **查询字段**:丢失 ['排序(ORDERASC)', '枚举项(CODEDES)', '枚举值(CODEVALUE)']
|
||||
- **表单字段**:丢失 ['排序(ORDERASC) 老为必填,EIP4非必填(轻微降级)']
|
||||
- **按钮**:丢失 ['查看(枚举项只读查看)', '枚举组 添加/修改/删除/保存(整套枚举组维护按钮全缺,EIP4 左侧树只读导航,无法增改删枚举组)'] | 臆造(超集) ['刷新(reload)', '共N条枚举项统计 tpl']
|
||||
- **关键真缺口**:
|
||||
- 枚举组维护功能全缺失: 老 枚举组 tree(b9401f70)有 添加/修改/删除/保存组 四按钮+内联表单(名称/是否固定枚举组 ISFIXED/主键)+主键可编辑性脚本; EIP4 左侧树是纯只读导航,无法新增/改名/删除枚举组,也无 ISFIXED(是否固定枚举组) 字段
|
||||
- 枚举项列表缺 查询区: 老有 排序/枚举项/枚举值 三个查询字段, EIP4 CRUD 完全无 filter
|
||||
- 枚举项列表缺 扩展属性三 列(表单里有,列表不显示)
|
||||
- 枚举项缺 查看 只读按钮(老有 read 类型)
|
||||
- 枚举项 排序 必填降级为非必填
|
||||
- **修法**:在左侧 input-tree 上加 工具栏/右键 的 新建组/改名/删除组 调 SYS_ENUMERATE_TYPE_* 端点并补 ISFIXED 字段; 主 CRUD 补 filter(CODEDES/CODEVALUE/ORDERASC)、补 扩展属性三 列与 查看 只读按钮、ORDERASC 设必填。
|
||||
|
||||
### 数据字典(实体) DataDicMainView — 严重缺
|
||||
- 老模板:`b4154b1f-3f27-4b0a-854d-6be2deea4b38`
|
||||
- **列表列**:丢失 ['ENTITYTYPE 实体模块分类(老可见列, EIP4无)']
|
||||
- **查询字段**:丢失 ['ACCESSLEVEL 访问级别', 'TABLETYPE 表类型', 'TABLENAME 数据库表名', 'ISDELETEABLE 是否可删除', 'DESCRIPTION 描述', 'ISVIEW 是否视图', 'ISCHANGELOG 是否记录日志']
|
||||
- **表单字段**:丢失 ['整个实体新增/修改表单(实体 tab 10字段 + 实体属性 EditGrid 20列)全部缺失', '查看(只读)表单 pageid=12491103 缺失']
|
||||
- **按钮**:丢失 ['添加 (新建实体)', '修改 (编辑实体+属性)', '删除 (删除实体)', '查看 (只读详情)'] | 臆造(超集) ['规则 (SYS_RULE 全局校验规则库管理 — 老模板无此功能)', '失效缓存 (元数据缓存清理 — 老模板无)']
|
||||
- **关键真缺口**:
|
||||
- 实体【添加】缺失: 老有 insertEntity 表单(10字段+默认属性 loadEntityDefaultAtt), EIP4 无新增入口, 无法在系统内定义新实体
|
||||
- 实体【修改】缺失: 老有 updateEntity + 实体属性 EditGrid(20列, 元属性/列名/类型/枚举组/默认值/最大最小值等), EIP4 完全无法编辑实体及其属性结构
|
||||
- 实体【删除】缺失: 老有 deleteEntity, EIP4 无 (有 SYS_ENTITY/delete 端点但页面未挂按钮)
|
||||
- 实体【查看】只读详情缺失 (pageid=12491103)
|
||||
- 查询区从 8 个字段(访问级别/表类型/表名/可删除/描述/名称/视图/记录日志)塌缩为 1 个(仅名称模糊)
|
||||
- 列表丢 ENTITYTYPE 实体模块分类列
|
||||
- EIP4 用 SYS_RULE 全局规则库弹窗 + 失效缓存替代了实体属性管理, 与老语义(每实体可视化维护属性列表)不对位 — 属于换了功能而非补齐
|
||||
- **修法**:在 sys-admin-entity 转换/schema 中补回实体 添加/修改/删除/查看 四按钮: 新增/修改用 2-tab 表单(实体 10 字段 dialog + 实体属性 input-table/EditGrid 映射 20 列), 对接 insertEntity/updateEntity/loadEntity/loadEntityDefaultAtt 语义端点; 查询区按老 8 字段补齐(访问级别/表类型/表名/可删除/描述/视图/记录日志); 列表补 ENTITYTYPE 列; 保留 规则/失效缓存 作为 EIP4 增强但不替代实体属性维护。
|
||||
|
||||
### 自动编号规则 — 部分
|
||||
- 老模板:`0defce1e-ab9d-4e45-aabd-77e92ac95302`
|
||||
- **查询字段**:丢失 ['实体 ENTITYID 查询', '是否启用 ISOPEN 查询', '编码规则 RULE 查询', '流水号递增规则 ADDRULE 查询']
|
||||
- **按钮**:丢失 ['查看(read 只读详情;但编辑弹窗已可看,影响极小)'] | 臆造(超集) ['取号预览(实时下一编号预览)', '刷新', '规则段构建器(可视化拼装规则串)', '共N条规则计数']
|
||||
- **关键真缺口**:
|
||||
- 整个查询/过滤栏缺失:老模板有4个查询字段(实体/是否启用/编码规则/流水号递增规则),EIP4 crud 无 filter/搜索表单,数据多时无法按实体或状态筛选
|
||||
- 查看(read)只读按钮缺失(轻微,编辑弹窗可代替)
|
||||
- **修法**:给 sys-admin-coderule 的 ruleCrud 补一个 filter 查询表单(实体下拉用 /api/coderule/entities、是否启用 YESNO 下拉、编码规则文本),并把参数透传到 list api;read 查看按钮可用只读 dialog 复用编辑表单补齐。
|
||||
|
||||
### 登录历史 — 部分
|
||||
- 老模板:`edc05980-022b-45a2-8aea-9619e07615ae`
|
||||
- **查询字段**:丢失 ['登录时间默认值(上月1号→明天,老有脚本设默认,EIP4无默认值)']
|
||||
- **按钮**:丢失 ['选中行删除(老的删除按需勾选记录删,EIP4改成按查询条件整批删,语义不同——勾选指定记录删除能力丢失)'] | 臆造(超集) ['根据查询条件删除记录(老的是选中行删除,EIP4新增了按区间批删的变体)']
|
||||
- **关键真缺口**:
|
||||
- 删除语义改变:老=勾选选中行删除(isneedselected),EIP4=按查询条件(用户+时间区间)整批删除——丢失了精确勾选某几条记录删除的能力
|
||||
- 登录时间查询无默认值:老模板有脚本默认填上月→明天区间方便排查,EIP4 loginTimeRange 无默认值,打开为空
|
||||
- **修法**:EIP4 给 crud 行加 checkbox 多选+「删除选中」按钮(对齐老 isneedselected 语义),并给 loginTimeRange 设默认值(近一月),两个删除并存即完全 parity。
|
||||
|
||||
### 登录操作信息 — 部分
|
||||
- 老模板:`324388a6-ace2-43fc-ac53-dc57c9a0573f`
|
||||
- **查询字段**:丢失 ['USERORGID 所属公司 (SelectDialog 公司选择框过滤)', 'OPTIMES 登录操作时间 (双日期范围, 老系统为必填且默认近一月, 用于按时间窗口圈定统计)']
|
||||
- **按钮**:丢失 ['查看操作记录 (按 UPDATEBY=用户 过滤的操作日志记录, EIP4 完全缺失)']
|
||||
- **关键真缺口**:
|
||||
- 查询缺『登录操作时间』范围过滤(OPTIMES, 老系统为必填+默认近一月→明天, 是该统计页圈定时间窗口的核心条件)
|
||||
- 查询缺『所属公司』SelectDialog 过滤(USERORGID, 默认{CURRENTORG}, 多组织时按公司筛人)
|
||||
- 行按钮缺『查看操作记录』(按 UPDATEBY 过滤的用户操作日志, 老有两个导航按钮 EIP4 只实现了登录记录一个)
|
||||
- **修法**:在 filter.body 补『所属公司』(input/select 或选公司弹框, 透传 USERORGID) 与『登录操作时间』日期范围(input-date-range→OPTIMES起止, 接进 list api 参数), 并在 operation.buttons 增加『查看操作记录』行按钮(dialog 调操作日志列表, 按 UPDATEBY=${VIEW_SYS_USERLOGINFO_ID} 过滤)。
|
||||
|
||||
### 服务流 (sys-admin-serviceflow) — 部分
|
||||
- 老模板:`ad7849ec-e46c-499f-b8db-17b1f985fe14`
|
||||
- **列表列**:丢失 ['ENTITYID(实体)列', 'ISCONTROL(受权限控制)列']
|
||||
- **查询字段**:丢失 ['SYS_SERVICEFLOW_ID关键字查询', 'ISCONTROL下拉过滤', 'ISUPDATEABLE下拉过滤']
|
||||
- **按钮**:丢失 ['查看(read,只读详情)']
|
||||
- **关键真缺口**:
|
||||
- 列表丢失 ENTITYID(实体) 与 ISCONTROL(受权限控制) 两列
|
||||
- 查询区严重退化: 老有4个查询字段(关键字/名称/受权限控制/允许修改), EIP4只剩 DISPLAYNAME 关键字一个, 丢 ISCONTROL/ISUPDATEABLE 下拉过滤与 ID 精确查
|
||||
- 丢失独立的 查看(read 只读) 按钮
|
||||
- **修法**:老模板是 CRUD 实体型(无 view_page 表单,字段从实体派生); EIP4 表单端反而更强(结构化流程编辑器: 节点/参数/JUEL条件), 真缺口集中在列表与查询: 给 EIP4 crud 补 entityId/isControl 两列、补 isControl/isUpdateable 下拉 filter 与 id 精确查询字段, 并补一个只读查看按钮即可达 parity。
|
||||
|
||||
### 个人设置 — 达标(老为bespoke无XML, EIP4功能为超集)
|
||||
- 老模板:`db87828a-6255-46fc-8a23-933d54f52a90`
|
||||
- **按钮**:丢失 [] | 臆造(超集) ['保存手机号(基本信息tab, 老无此功能)', '设为主岗位(主岗位tab, 老的主岗位设置不在个人设置视图内)']
|
||||
- **关键真缺口**:
|
||||
- 无真gap: 老个人设置=纯bespoke ChangePasswordView, DB xml列为空(1字节)、editable=0, 无任何数据驱动的列表列/查询字段/工具栏按钮/view_page表单定义。老视图仅一个改密码弹窗。EIP4 不仅完整覆盖改密码(原/新/确认密码+minLength6+两次一致校验+提示alert), 还额外做了'基本信息(手机号)'和'主岗位'两个tab — 为超集而非缺失。
|
||||
- **修法**:无需补功能。唯一注意: 老 ChangePasswordView 是bespoke类无XML, 无法用XML逐字段比对, 已按engineclass确认其为单一改密码弹窗; EIP4为功能超集, parity达标。如需100%保真可核对老ChangePasswordView Java源确认是否有'密码强度/不能与原密码相同'的服务端校验, 但DB层无可对照模型。
|
||||
46
docs/归档/未完成工作清单.md
Normal file
46
docs/归档/未完成工作清单.md
Normal file
@@ -0,0 +1,46 @@
|
||||
# EIP4 未完成工作清单
|
||||
|
||||
> 登记日期:2026-06-12
|
||||
> 背景:用户指令「记录所有未完成的工作,本次 goal 只专注处理 F2-17」
|
||||
> 已完成面见 docs/P1/{F1,F2}阶段简报.md 与 F3-1/F4-L1 报告;本清单只记**未完成**项
|
||||
|
||||
## 一、当前 goal 范围:F2-17 UI 基本操作全面巡检与修复(任务 #32)
|
||||
|
||||
| # | 缺口 | 根因(已定位) | 状态 |
|
||||
|---|------|----------------|------|
|
||||
| #3 | **所有列表页查询条件不过滤**(最高优先) | 默认搜索流输入是单变量 `map`,FlowController 把 query 参数按独立绑定传入 → map 恒空 → listSelect 永不过滤。修法:解析器对合成搜索流把非保留 query 参数装进 map 输入(剔除 page/perPage,分页/排序转 POJOCRUDService 保留键);可顺手接 FUZZY_QUERY | 待修(等 residuals-finish 释放 eip4-platform) |
|
||||
| #4 | **列表按钮组(添加/修改/查看)点击无响应**(最高优先) | 按钮→EDITFORM 表单弹窗映射未实装。修法:转换器按 P4-6 同源的模板↔EDITFORM 映射生成 amis dialog 动作(加载编辑表单 schema+行数据上下文) | 待修(同上) |
|
||||
| #1 | 登录默认跳 PoC mock 页 | LoginPage 跳转目标过时 → /workbench;顺手清 alice/123456 预填 | **已修**(本日提交) |
|
||||
| #2 | mock 页标题「测试」 | public/schemas 两文件 title 修正 | **已修**(同上) |
|
||||
| #5 | /api/flow 返回 items 字段键大小写疑点 | SUBJECT 键取不到但页面能显示——核 normalize/toRow 键口径 | 待核(随 #3 一并) |
|
||||
| 补测 | 主题切换/登出/异常态(403/404/取数失败提示)实操 | 巡检未走完的项 | 随修复批次补测 |
|
||||
|
||||
修复后验收:e2e 增加「过滤生效」「按钮开弹窗」强断言;全套 e2e 不回归。
|
||||
|
||||
## 二、在途(agent 后台执行中,非本 goal 新启)
|
||||
|
||||
- **F2-4b 脚本残余 79 缺口 + F2-15 缺失 PG 对象补建**(任务 #31/#29):residuals-finish agent 在跑(前一执行者溢出后的收尾),产出=F2-4b 最终通过率(目标 FULL_AUTO≥95%)/44 视图对照 153 终判补建/build_devdb 校验步骤/两份报告。**完成后只验收,不在本 goal 内扩展**
|
||||
|
||||
## 三、已明确后置(不在本 goal)
|
||||
|
||||
| 项 | 内容 | 前置/备注 |
|
||||
|----|------|----------|
|
||||
| F4-L2/L3(任务 #25) | 实体建模器(SYS_ENTITY 可视化维护,后端 P1 已备)+ 流程设计器(bpmn.js) | 架构无阻塞,纯排期 |
|
||||
| F5-1 移动端 | **用户拍板后置(2026-06-12)** | 原型 mobile.jsx 留作输入 |
|
||||
| F2-3 残余(任务 #11) | 106 份人工作业单 + page. 绑定 293 条 | **评审性质**:page 上下文 facade 方案 vs 人工改写,与 153 线合并评审 |
|
||||
| 6.3 在线导入发布 | 应用包导入/导出协议 | 随 F4-L2 一并设计(overlay 机制已就位) |
|
||||
| F2-16 遗留 F3-G1 | XML 未标 ismoney 的金额列未转 number | 小,随下次重批 |
|
||||
| F2-5 出口报告登记项 | successService 业务服务移植、gateway candidateUser 待办维度 | 流程线深化 |
|
||||
|
||||
## 四、外部/人工依赖(技术线无法推进)
|
||||
|
||||
1. **S1 止损评审会**(153 重写线 7.56 人月三选一:分期/第三方组件/扩预算)——**唯一卡 F3 主线的决策,待用户安排**
|
||||
2. 检查点①②评审、商务开放项 1/3、JOR 文件系统侧清点(客户 SSH)
|
||||
3. 11 个引擎缺陷旧系统同病验证(待旧系统环境)、58 个零引用视图老员工区分、EIP-3.0↔目标客户版本对应确认
|
||||
4. 5435 网络恢复后:eip4dev 刷新源复测、F2-15 中「本地不可补」对象与客户库对照
|
||||
|
||||
## 五、工程债(登记不阻塞)
|
||||
|
||||
- (templateId,seq) 非稳定键 → 长期换内容哈希键(已三次咬人,手册有案)
|
||||
- e2e 断言强度基线:禁止「有数据=通过」,新用例一律断言业务效果(过滤生效/弹窗打开/状态变迁)
|
||||
- executor agent 管理经验:中途停就 SendMessage 驱动、>100 工具调用预防溢出(新 agent 精确交接)、「预存失败」话术必亲核(五次全被推翻)
|
||||
118
docs/归档/转换器覆盖度审计-2026-06-13.md
Normal file
118
docs/归档/转换器覆盖度审计-2026-06-13.md
Normal file
@@ -0,0 +1,118 @@
|
||||
# 转换器覆盖度审计(view_template / view_page × amis 转换器)
|
||||
|
||||
> 日期:2026-06-13
|
||||
> 方法:数据驱动主动盘点——按模板 type、编辑表单 uitype、编辑表单结构、运行时端点四维,把**源数据存量**对照**转换器实际分支**与**运行时可达性**,找出尚未被动撞到的缺口。
|
||||
> 触发:TreeGrid 三轮修复中暴露「编辑表单未迁移/juel 引擎缺口」后,主动系统盘点(4 个并行审计 agent + 浏览器/curl 抽验 + 代码核对)。
|
||||
> 数据库:localhost:5433/eip4dev(schema eip3);转换器:`platform-converter`;产物:`platform-converter/转换产物/schema/*.json`(1489)。
|
||||
> ⚠️ 本文是**缺口清单**,不替代 `EIP4-架构与缺口现状-2026-06-13.md`(权威状态视图);本文结论按影响面/优先级排序于 §五。
|
||||
|
||||
---
|
||||
|
||||
## 一、模板类型覆盖(view_template 1516,dispatch 全有分支)
|
||||
|
||||
| type | root | 量 | 转换器分支 | 判定 | 缺口(SQL 计数证据) |
|
||||
|---|---|---|---|---|---|
|
||||
| 1 | crud | 858 | convertCrud | ⚠️ | 835 入库;列表主链路 OK。隐性缺口=`script`/onload/filter 事件静态跳过(见 §三 3.2、§四) |
|
||||
| 3 | tree | 50 | convertTree | ⚠️ | 声明式多级树仍走 selectservice 占位、未接 `/api/template/{ref}/tree`(53 页,§已知) |
|
||||
| 4 | treegrid | 45 | convertTree→convertTreeGrid | ✅ | 本项三轮已修(树高度/子树聚合/按钮/删除);添加改待 juel |
|
||||
| **5** | crud | 2 | convertCrud | 🔴 **语义错误** | **两条都是日历视图被转成普通 crud 表格**:`单个员工排班`(HR_SCHUSERSCHEDULE,DoublePopupDateField+班次颜色+日历网格)、`查看会议室调度`(服务名含 `_Calendar_`)。应映射 amis `calendar`/`fullcalendar`,当前**不可用** |
|
||||
| **6** | group | 20 | convertGroup | ⚠️ **占位** | 20/20 产物是 tabs,每 tab body=`tpl"子模板待跨模板联动加载"`,**100% 占位**。但引用的 62 个子模板 **62/62 已各有独立产物**——只需前端 tabs 切换时按 tempid 拉 `/api/page/schema/{tempid}` 即可激活,**非转换器缺口、属前端路由活** |
|
||||
| 7 | form | 70 | convertForm | ⚠️ | 有 type=7 包壳的编辑表单可渲染;script 联动死逻辑、复杂子表后端联动待接 |
|
||||
| **100/101** | crud/tree | 132 | convertCrud/Tree | ⚠️ **冗余死页** | 130 入库但**菜单关联=0**(不可直达);运行时选择由 `/api/picker/{dialogid}/list` 承接、不读这些 schema。转换它们目前**无消费方**——待决策:停转 or 留给 F4 低代码弹窗预览 |
|
||||
| 200 | report | 339 | convertReport | ⚠️ | A 类表格 ~324 可渲染(合计列已登记,聚合靠后端);**B 类图表 `ischart=true` 4 条**降级纯表格(ECharts 未平移);**C 类 JOR 套打**版式丢失(另案 univer/Web 打印,§已知) |
|
||||
|
||||
**FAILED**:27 个 null-xml(空 XML 孤儿,无法转,§已知)。
|
||||
|
||||
---
|
||||
|
||||
## 二、编辑表单字段控件覆盖(view_page 1241,UiTypeMapper)
|
||||
|
||||
> 编辑表单整体尚未迁移入库(已知遗留②);本节审「**一旦迁移,控件够不够用**」。
|
||||
|
||||
| uitype | 量 | 分支 | 判定 | 缺口 |
|
||||
|---|---|---|---|---|
|
||||
| TextField | 6929 | input-text | ✅ | — |
|
||||
| SelectDialog | 3663 | picker / 降级 select | ⚠️ | **顶层 96.7% 无 dialogid**(2811/2906)→ 落空源 select;仅 95 条走 picker |
|
||||
| NumberField | 3124 | input-number | ✅ | — |
|
||||
| ComboBox | 2665 | select+dict / 降级 | ⚠️ | **339 条无 comboboxid 且非枚举**(查询服务型)→ SOURCE_EMPTY 空 select |
|
||||
| PopupDateField | 2219 | input-date/datetime | ✅ | 有无时分秒自动区分 |
|
||||
| TextArea | 1310 | textarea | ✅ | — |
|
||||
| MultiFileUploadField | 608 | input-file(multiple) | ✅ | — |
|
||||
| **EditGrid** | 508 | input-table + buildEditGridColumns | ⚠️ **子表退化** | **子表列硬写 `input-text`,不递归 UiTypeMapper**:子表内 SelectDialog(431/508)/ComboBox(288)/NumberField(350)/PopupDate(159)/CheckBox(40) 全变文本框;**178/508 子表联动脚本完全丢失**;`showaddbutton/showdeletebutton` 空值默认全开放(过度开放风险) |
|
||||
| MultiSelectDialog | 319 | picker(multiple) / 降级 | ⚠️ | **97.7% 无 dialogid** → 降级 select |
|
||||
| CheckBox | 194 | checkbox | ✅ | — |
|
||||
| **FormEditGrid** | 129 | 同 EditGrid | ⚠️ | 同 EditGrid 子表退化 |
|
||||
| **SingleFileUploadField** | 41 | **default→input-text** | 🔴 | **丢失文件上传**;含 `isshowpic=true`(图片预览,如证件照)彻底失语。修复=复用 FileUploadField case(multiple=false) |
|
||||
| RichTextArea | 16 | input-rich-text | ✅ | — |
|
||||
| **DateField** | 1 | **default→input-text** | 🔴 | 丢日期选择器。修复=复用 PopupDateField |
|
||||
| **PasswordField** | 1 | **default→input-text** | 🔴 | **密码明文显示**。修复=映射 input-password(1 行) |
|
||||
|
||||
**default 分支**(line 199)= `input-text` + degrade。落 default 的 = SingleFileUploadField(41)/DateField(1)/PasswordField(1)。
|
||||
|
||||
---
|
||||
|
||||
## 三、编辑表单结构与脚本(view_page,convertForm)
|
||||
|
||||
| 审查点 | 影响面 | 状态 | 说明 |
|
||||
|---|---|---|---|
|
||||
| **多页签 `<tab>` 布局** | **72 页**(59×2签/10×3/2×4/1×9) | 🔴 完全丢失 | convertForm 只读 `<fields>`、**跳过 `<layout>`**,多 tab 折叠成单一平铺表单 |
|
||||
| 字段显示顺序 | 全量 | ⚠️ 部分丢失 | 以 `<fields>` 声明序为准,`<layout><div location>` 的版面顺序放弃 |
|
||||
| `<table>` 二列布局 | 1232 | ✅ 有替代 | buildFormRows 两栏 group(宽控件独占行) |
|
||||
| **width/colspan 精确布局** | colspan 875 / width 1241 | 🔴 完全丢失 | mapField 不读 width/colspan/height,统一等宽两列 |
|
||||
| required/readonly/hidden | 全量 | ✅ | → required/disabled/hidden |
|
||||
| initvalue/maxlength | 全量 | ✅ | initvalue token 求值已做(§7-3) |
|
||||
| **requirederror(自定义必填提示)** | 1237 | 🔴 完全丢失 | 未读取 |
|
||||
| **minlength** | 1219 | 🔴 完全丢失 | applyLength 只处理 maxlength |
|
||||
| **页面级 `<scripts>` 联动** | **601 页** | ⚠️ 部分处理 | convertForm 只记 note 不生成 onEvent;需脚本改写器(FULL_AUTO)后处理才生效。**与 §4.2 onselected/filter 是不同管线、不同阻塞点** |
|
||||
| EditGrid 子表(作字段) | 412 字段 | ⚠️ | 前端结构已转 input-table;后端 `updateSubTable` 保存联动待接(F 阶段) |
|
||||
|
||||
---
|
||||
|
||||
## 四、运行时数据源覆盖(1489 产物,端点可达性)
|
||||
|
||||
> 注:并行 agent 初判 picker/dict「零引用」**有误**(grep 漏了嵌套 source 字段);实测如下。
|
||||
|
||||
| 端点 | 引用页数 | 引用次数 | 抽样可达性 |
|
||||
|---|---|---|---|
|
||||
| `/api/flow/*_SEARCH` | 1345 | — | N=300:有数据 55.3% / 空(dev缺口) 41.7% / status:1 降级 **2.3%(7)** / 错 0.7% |
|
||||
| **`/api/picker/*`** | **911** | **1948** | 核心依赖(选择窗);多列+分页+回填已验(轮次1)|
|
||||
| **`/api/poc/dict/*`** | **728** | **1683** | 字典源;部分 ComboBox 误路由致空(§二 339 条)|
|
||||
| `/api/template/treegrid|tree` | 45 | — | N=41:有数据 70.7% / 空 19.5% / 失败 1 |
|
||||
| `/api/page/schema/{id}` | 109 | — | 编辑表单弹窗(多数指向未迁移 view_page → 「未配」,遗留②)|
|
||||
|
||||
**真缺口 vs dev 数据缺口分离**:
|
||||
- 🔴 **VIEW_/VM_ 报表端点 ~46 个 → 影响约 277 页(18.6%)**:dev 库无聚合视图。**需 DBA 确认生产是否有这些视图**——生产有=dev 数据缺口(非产品缺陷);生产也无=真需建视图+注册服务流。集中在 PM/OA 报表模块。
|
||||
- 🔴 **真代码/转换缺口 ~7 个端点**:服务不存在(含一个转换侧拼写 `PM_MACHINECONTRACTREGEIDTER`)/服务流未注册。
|
||||
- 🟢 **dev 数据缺口 ~500 表**:服务链路完整、仅 dev 无业务数据,上线自动有,**不计产品缺陷**。
|
||||
|
||||
---
|
||||
|
||||
## 五、缺口总清单(按优先级,新发现优先)
|
||||
|
||||
### P1 — 正确性错误 / 安全(小量但必须修)
|
||||
1. 🔴 **type=5 日历视图(2)** 转成 crud 表格 → 应映射 calendar/fullcalendar。功能性错误。
|
||||
2. 🔴 **编辑表单 default 控件**:PasswordField→明文(安全)、SingleFileUploadField(41)→丢上传、DateField(1)→丢日期。各 1 行/复用即可修(迁移编辑表单前先补 UiTypeMapper)。
|
||||
3. 🔴 **VIEW_/VM_ 报表数据源**(~46 端点/~277 页):先由 DBA 确认生产视图存在性,再定 dev 数据缺口 or 真建视图。
|
||||
|
||||
### P2 — 编辑表单迁移(遗留②)必须连带解决的质量项
|
||||
4. ⚠️ **EditGrid/FormEditGrid 子表列**硬写 input-text 不递归 UiTypeMapper(637 子表、子表内选择/枚举/数值/日期全退化)+ 178 子表联动丢失 → buildEditGridColumns 改为对子表字段递归 mapField(quickEdit)。
|
||||
5. ⚠️ **多页签布局(72)** + **width/colspan 精确布局(875+)**:convertForm 解析 `<layout><tab>` 生成 amis tabs + 还原列宽/跨列。
|
||||
6. ⚠️ **requirederror(1237)/minlength(1219)**:补读两属性。
|
||||
7. ⚠️ **编辑表单 SelectDialog/MultiSelectDialog ~97% 无 dialogid** + **ComboBox 339 查询服务源**:需运行时按字段/实体元数据补全数据源路由(与列表页 picker 同源机制延伸)。
|
||||
8. ⚠️ **页面级 `<scripts>` 联动(601)**:依赖脚本改写器管线(与 §4.2 onselected/filter 不同管线)。
|
||||
|
||||
### P3 — 决策 / 低成本 / 已知后置
|
||||
9. **type=6 group(20)**:子模板 62/62 已转,前端 tabs 按 tempid 加载即可激活(前端路由活,非转换器缺口)。
|
||||
10. **type=100/101(130) 选择窗死页**:无菜单、/api/picker 已覆盖 → 决策停转或留 F4。
|
||||
11. **report B 图表(4)/C JOR 套打**:另案(amis chart / univer)。
|
||||
12. **type=3 声明式多级树(53)**:接 `/api/template/{ref}/tree` 端点。
|
||||
|
||||
### 跨切(已知遗留,本审计佐证影响面)
|
||||
- **遗留① JUEL 引擎**:阻断所有 EL 表达式写流(含编辑表单添加/修改提交、子表保存)。
|
||||
- **遗留② 编辑表单迁移**:1241 个 view_page 未转入库 → 添加/修改/查看弹窗「未配」。**本审计揭示:迁移时必须连带做 P2 全部项**(否则迁移出来的表单子表退化、页签丢失、布局乱、联动失效)。
|
||||
|
||||
---
|
||||
|
||||
## 六、给排期的一句话
|
||||
|
||||
**写功能真实可用的依赖链**:遗留②编辑表单迁移(带 P2 质量项 #4–#8)+ 遗留① JUEL 引擎 → 才有完整「添加/修改」;「查看」只需遗留②(+ P2 部分);P1 是与之并行的小修+报表数据源确认。被动 dogfooding 撞到的(树/按钮/juel/编辑表单)与本主动盘点新增的(日历视图、子表退化、页签/布局/校验丢失、选择窗死页)合并,构成 F2/F3 收尾的完整缺口地图。
|
||||
Reference in New Issue
Block a user