feat: complete framework P2 deltas

This commit is contained in:
2026-06-18 11:18:40 +08:00
parent be9d1c8e71
commit 5636b37220
15 changed files with 1590 additions and 10 deletions

View File

@@ -10,7 +10,7 @@
|---|---:|---|
| framework 定制视图总数 | 46 | README 总览口径;backlog 表格当前可解析出 45 行,需后续校正缺的 1 行。 |
| 已逐功能验收 / 可算 Done | 约 8 | 用户管理、功能模板下载、实体分类-枚举组、已办任务、消息查看/已读、短消息、查看审批、我的发起任务。功能模板下载/已办/消息查看各覆盖 2 个 templateId,但按 engineclass 各计 1 组。 |
| 代码已提交但待最终副作用验收 | 约 9 | 待办任务:列表、查看详细、处理抽屉已验;未点同意/拒绝。用户选择框全家已切标准 amis picker,并已覆盖单选查询、单选表单、多选弹窗层级与多选展示烟测;流程选择框已接线/页面烟测;审批表单删除已补查看/删除端点和按钮注入;流程监控已补处理明细查看、结束流程和「高级处理」Groovy 执行入口;通用脚本/XML 编辑器已接入第一批页面;设置定时任务提醒人、数据导入下载入口、工作日历已接线。上述项未覆盖所有真实业务保存、权限差异或页面副作用验收。 |
| 代码已提交但待最终副作用验收 | 约 12 | 待办任务:列表、查看详细、处理抽屉已验;未点同意/拒绝。用户选择框全家已切标准 amis picker,并已覆盖单选查询、单选表单、多选弹窗层级与多选展示烟测;流程选择框已接线/页面烟测;审批表单删除已补查看/删除端点和按钮注入;流程监控已补处理明细查看、结束流程和「高级处理」Groovy 执行入口;通用脚本/XML 编辑器已接入第一批页面;设置定时任务提醒人、数据导入下载/执行入口、功能/视图设计器入口、报表宿主、工作日历已接线。上述项未覆盖所有真实业务保存、权限差异或页面副作用验收。 |
| 仍需修或逐功能验收 | 约 38 | 含上面的待验组;大多是通用页已产出,但 engineclass Java delta 未迁移。 |
| 剩余工程单元 | 约 28+ | 多视图可复用同一套组件/端点,如脚本编辑器、消息详情、工作流按钮。 |
@@ -42,10 +42,12 @@
| 流程选择框 | Implemented / Needs business verification | `ProcessSelectController` 已提供 `/api/process-select/options|search`;转换器已把 `b3070157` 接到 amis `transfer-picker`;`919477da` 流程代理授权已重转重导并从 PARTIAL 转 SUCCESS;浏览器 smoke 可打开弹窗,显示「流程名称/已选流程」和流程名 | 继续验流程代理授权保存闭环:代理类型=指定流程时必填、保存后 `wf_agent_process` 写入/读取一致 |
| 审批表单删除 `91ccbba3` | Implemented / Needs page verification | `eip4-platform 1d8a4fe` 已补 `flowable-service` 历史流程删除端点 `/api/flow/process/{processInstanceId}/delete-history`(运行中流程 409)、网关 AMIS 端点 `/api/workflow/process/{processInstanceId}/delete-history`、`ProcessFormRemoveComponent` 查看/删除按钮注入与 CRUD reload 锚点。自动化已过:`FlowControllerTest`、`TodoControllerAmisTest,FlowableClientTest`、`TemplateToAmisConverterTest#engineclass_ProcessFormRemoveComponent_注入查看和删除历史流程按钮`;打包已过:`mvn -q -pl flowable-service package -DskipTests`、`mvn -q -pl platform-app -am package -DskipTests`。 | 重转/导入 `91ccbba3` 后浏览器验收:列表选中已结束流程 → 查看打开只读 ApprovalDrawer;删除成功后列表刷新;运行中流程删除返回 409 且不误删 |
| 流程监控 `9f3b5a8b` | Implemented / Needs page verification | `eip4-platform a019af8` 已补 `flowable-service` 运行中流程结束端点 `/api/flow/process/{processInstanceId}/terminate`(已结束流程 409)、网关 AMIS 端点 `/api/workflow/process/{processInstanceId}/terminate` 并回写 `SYS_DATASTATUS=6(作废)`、`ProcessMonitorComponentNew` 注入「处理」和「结束流程」按钮与 CRUD reload 锚点;`eip4-platform 3523007` 已补「高级处理」按钮和 `/api/workflow/process/{processInstanceId}/advanced-script` Groovy 执行入口,绑定 `processid/businessKey/processInstanceId/tableName/currentUser*` 等上下文。「处理」当前复用只读 ApprovalDrawer 承载流程监控明细查看。自动化已过:`FlowControllerTest`、`TodoControllerAmisTest,FlowableClientTest`、`TemplateToAmisConverterTest#engineclass_ProcessMonitorComponentNew_注入处理和结束流程按钮`、`TodoControllerAmisTest` 高级脚本成功/失败、`TemplateToAmisConverterTest` 高级处理按钮;打包已过:`mvn -q -pl flowable-service package -DskipTests`、`mvn -q -pl platform-app -am package -DskipTests`。部署:全量重转 2757 项、导入扫描 2727 项/更新 647 项,HTTP schema 已确认含「高级处理」和 `/advanced-script`。 | 浏览器验收:选中运行中流程 → 处理打开审批详情;结束流程成功后列表刷新且状态回写作废;已结束流程返回 409;高级处理执行只读脚本/失败脚本并确认错误提示、权限与审计口径 |
| 通用脚本/XML 编辑器(第一批) | Implemented / Needs page verification | `eip4-platform 3523007` 新增 `/api/field-editor/load|save`,白名单限制 `RUNSCRIPT/CONVERTSCRIPT/SAVESCRIPT/XML/CONTENTXML/SENDINFO`;转换器已给 `d99b5760` 定义定时任务注入「编辑任务脚本」、`7821ef3b` 数据导入配置注入「编辑转换脚本/编辑保存脚本」、`8b89fd29/d7e12a83/117374e1/de403e76` 功能/视图管理和自定义列表注入 XML「高级配置」。自动化已过:`FieldEditorControllerTest`、`TemplateToAmisConverterTest` 定时任务嵌套 CRUD 和数据导入脚本按钮;打包已过:`mvn -q -pl platform-app -am package -DskipTests`。部署:全量重转 2757 项、导入扫描 2727 项/更新 647 项,HTTP schema 已确认 `d99b5760`、`7821ef3b`、`9f3b5a8b` 按钮与端点存在。 | 浏览器逐页验:打开脚本/XML 弹窗、加载已有值、保存后 DB 字段一致;确认弹窗层级、只读/必填、空值保存和异常提示 |
| 通用脚本/XML 编辑器(第一批) | Implemented / Needs page verification | `eip4-platform 3523007` 新增 `/api/field-editor/load|save`,白名单限制 `RUNSCRIPT/CONVERTSCRIPT/SAVESCRIPT/XML/CONTENTXML/SENDINFO`;转换器已给 `d99b5760` 定义定时任务注入「编辑任务脚本」、`7821ef3b` 数据导入配置注入「编辑转换脚本/编辑保存脚本」、`8b89fd29/d7e12a83/117374e1/de403e76` 功能/视图管理和自定义列表注入 XML「高级配置」。自动化已过:`FieldEditorControllerTest`、`TemplateToAmisConverterTest` 定时任务嵌套 CRUD 和数据导入脚本按钮;打包已过:`mvn -q -pl platform-app -am package -DskipTests`。部署:全量重转 2757 项、导入扫描 2727 项/更新 647 项,HTTP schema 已确认 `d99b5760`、`7821ef3b`、`9f3b5a8b` 按钮与端点存在。本次 P2 又给功能/视图管理四个页面补了设计器入口,浏览器 smoke 已确认 `8b89fd29` 页面可见「编辑模板/高级配置」。 | 浏览器逐页验:打开脚本/XML 弹窗、加载已有值、保存后 DB 字段一致;确认弹窗层级、只读/必填、空值保存和异常提示 |
| TreeGrid 实体分类级联 | Implemented / Needs page verification | `eip4-platform 1ef3de1` 修复 `/api/template/treegrid` 对伪 `rcol=ENTITYTYPE` 的处理:老源码实际是 `ENTITYS -> ENTITYTYPE` 关联过滤,现对白名单 `VIEW_TEMPLATE/VIEW_PAGE/SYS_SCHEDULEJOB` 通过 `view_templateentity/view_pageentity/sys_schedulejobentity` 转成主键 IN,再交给原 `_SEARCH` 流。自动化已过:`TemplateTreeControllerTest`;打包已过:`mvn -q -pl platform-app -am package -DskipTests`;8093 已重启。HTTP smoke:功能管理 `VIEW_TEMPLATE` 节点返回 `total=77`,视图管理 `VIEW_PAGE` 节点返回 `total=75`,定义定时任务 `SYS_SCHEDULEJOB` 节点返回 `total=13`,均 200/status=0。 | 浏览器验收:`8b89fd29`、`d7e12a83`、`d99b5760` 左树点击后右表数据随实体分类变化;新增时默认实体分类/关联实体保存口径仍需页面闭环 |
| 设置定时任务 `70f85b21` | Implemented / Needs page verification | `eip4-platform c9e4d35` 新增 `/api/schedulejob/{id}/notify` GET/POST、`/api/schedulejob/dimensions/options`、`/api/schedulejob/project-role-options`,把旧 `SYS_SCHEDULEJOB.SENDINFO` 的 `{"items":[...]}` 拆成 input-table 结构化编辑并保存回旧 JSON;转换器给 `ScheduleJobSettingComponent` 注入「设置提醒人」,用户/部门/岗位/岗位类别使用标准 amis picker。自动化已过:`ScheduleJobNotifyControllerTest`、`TemplateToAmisConverterTest#engineclass_ScheduleJobSettingComponent_注入设置提醒人规则编辑器`;部署:全量重转 2757 项、导入扫描 2727 项/更新 794 项,8093 已重启;HTTP smoke:`/api/schedulejob/NO_SUCH/notify` 返回 200/业务失败,`70f85b21` schema 含「设置提醒人」和 `/api/schedulejob/`。 | 浏览器验收:打开提醒人弹窗、加载已有 `SENDINFO`、新增/修改用户/部门/岗位/维度/项目角色规则后保存,DB JSON 与页面回显一致 |
| 数据导入配置管理 `7821ef3b`(下载入口) | Implemented / Needs page verification | `eip4-platform c9e4d35` 新增 `/api/dataimport/template?configId=...` 和 `/api/dataimport/basedata`,用 SpreadsheetML 2003 输出 Excel/WPS 可打开的 `.xls`;转换器给 `DataImportConfigView` 注入「下载模板」「下载基础数据」。自动化已过:`DataImportConfigControllerTest`、`TemplateToAmisConverterTest#engineclass_DataImportConfigView_注入转换和保存脚本编辑按钮`;部署同上;HTTP smoke:`/api/dataimport/basedata` 返回 200 attachment,`7821ef3b` schema 含两个下载按钮和端点。 | 浏览器验收:选中配置后下载模板文件可打开且列符合实体;基础数据文件可打开且含公司/用户/部门/工程 sheet;执行导入仍在 P2 待做 |
| 功能/视图管理设计入口 `8b89fd29/d7e12a83/117374e1/de403e76` | Implemented / Browser smoke verified | 本次待提交:转换器给 `UserFunDesignComponent/UserPageDesignComponent` 注入「编辑模板/编辑页面」并打开现有 `/editor.html?templateId=${selectedItems[0].<pk>}`;给自定义列表 `UserFunDesignCustomComponent/UserPageDesignCustomComponent` 按底层 `TEMPLATEID/PAGEID` 打开设计器,避免用自定义行主键。自动化:`TemplateToAmisConverterTest#engineclass_功能和视图管理注入设计器入口`、`#engineclass_功能和视图自定义列表设计器入口使用底层模板和页面Id`。部署:全量重转 2757 项、导入扫描 2727 项/更新 644 项;HTTP schema 已确认四页入口均存在;内置浏览器 smoke:`8b89fd29` 可见「编辑模板/高级配置」。 | 页面副作用验收:选中真实功能/视图行后打开设计器,编辑保存后 overlay/schema 变化可回读;自定义列表确认打开的是底层 `TEMPLATEID/PAGEID` 对应设计器 |
| 数据导入配置/文件管理 `7821ef3b/1d132d4a` | Implemented / Browser smoke verified | `eip4-platform c9e4d35` 新增 `/api/dataimport/template?configId=...` 和 `/api/dataimport/basedata`,用 SpreadsheetML 2003 输出 Excel/WPS 可打开的 `.xls`;本次待提交新增 `DataImportExecuteController`、`DataImportExecutionService`、`DataImportExcelParser`、`DataImportScriptHelper`,支持 SpreadsheetML/Excel 解析、zip 内首个 Excel、旧 `CONVERTSCRIPT/SAVESCRIPT` Groovy、`findUser/findCompany/findDepart/findProject/findUnitProject/findProjectCompany/findUserOrg/findUserDepart/findUserPosition/savePo/saveDoc/saveWf/execSql`,`saveWf` 同步写旧 `wf_hi_*`、Flowable `act_hi_*` 和 `sys_datastatus`。转换器给 `DataImportConfigView` 注入「下载模板/下载基础数据」,给 `DataExcelImportView` 注入「执行」。自动化:`DataImportConfigControllerTest`、`DataImportExcelParserTest`、`DataImportExecuteControllerTest`、`TemplateToAmisConverterTest#engineclass_DataExcelImportView_注入执行按钮`;HTTP smoke:`7821ef3b` schema 含下载端点,`1d132d4a` schema 含「执行」和 `/api/dataimport/execute`,`POST /api/dataimport/execute?fileId=NO_SUCH_FILE` 返回业务 422;内置浏览器 smoke:`1d132d4a` 可见「执行」。 | 业务验收:选中配置后下载模板文件可打开且列符合实体;基础数据文件可打开且含公司/用户/部门/工程 sheet;准备一份非生产导入文件,点击「执行」后确认目标业务表、附件、流程历史与 `sys_datastatus` 写入一致 |
| 报表 `e81454af-0e0e-4c0d-add8-db434f198936` | Implemented / Browser smoke verified | 本次待提交新增 `ReportMenuController` `/api/report/menu-tree`,按旧 `ReportComponent` 的 DOCUMENT 菜单树口径从 `VIEW_SYS_MENU` 构建父菜单/类型/报表三级树,并只返回 `sys_page_schema` 已有的可路由叶子;`PageSchemaController` 对报表 templateId 提供内置宿主 schema,左侧树选择叶子后右侧用 `/api/page/schema/${reportTemplateId}?format=amis` 复用已转换页。自动化:`ReportMenuControllerTest`、`PageSchemaControllerTest#reportHostBuiltinSchemaFallback`;HTTP smoke:`/api/report/menu-tree` 返回 110 个叶子,宿主 schema 200 且含 `/api/report/menu-tree`、`report-schema-host`;内置浏览器 smoke:报表页显示 DOCUMENT 菜单树和「请选择左侧报表」。 | 页面副作用验收:逐类选择 3-5 个真实报表叶子,确认右侧报表页 schema 加载、查询条件、分页和导出/打印等报表专属动作是否需要继续迁移 |
| 工作日历 `a13fa07f` | Implemented / Browser smoke verified | `eip4-platform eafd872` 新增 `workCalendarService`(bean 名与旧脚本函数一致),复用旧表 `SYS_CALENDAREXCEPTDAY`,实现周末默认休息、例外日双语义(周末调班/工作日放假)、`getNextWorkDay/isWorkDay`;新增 `/api/work-calendar/year` 和 `/api/work-calendar/toggle`;`PageSchemaController` 对 XML 为空的工作日历 templateId 提供内置标准 amis schema,避免菜单 404。自动化已过:`WorkCalendarServiceImplTest`、`WorkCalendarControllerTest`、`PageSchemaControllerTest`;打包:`mvn -q -pl platform-app -am package -DskipTests`;8093 已重启。HTTP smoke:schema 200/X-Schema-Layer=standard,年度 2026 返回 365 行,`2099-01-03` 周末例外日 toggle 写入后回滚;内置浏览器验证 `a13fa07f` 页面显示工作日历、年度查询、日期列表、周休日和切换例外日。 | 用户验收:确认当前 amis 列表式年历是否接受;如必须完全复刻旧 3x4 月历网格,再补视觉布局层;再抽一个真实年份例外日做页面按钮 toggle 后 DB/回显闭环 |
| 菜单真入口 | Needs verification | 前端已去硬编码假入口;需确认所有需要的真菜单在 `sys_menu` 中可达 | 用 `/api/menu` 和页面侧栏核对 |
| 功能模板下载门控 | Pending | backlog 写了 `VIEW_TEMPLATEID` 非空才显示附件编辑;当前只做了去按钮/改标题 | 决定是否补门控,若补则在 `EngineclassDelta` mutator 中按行/上下文控制 |
@@ -58,16 +60,18 @@
## P2(中等 delta,可批量复用)
> 2026-06-18:P2 缺实现项已清零;下表只保留仍需业务副作用验收的页面闭环。
| 范围 | 视图 | 要补什么 | 复用点 |
|---|---|---|---|
| 脚本/XML 编辑器 | 定义定时任务、数据导入配置、流程监控高级处理、功能/视图编辑列表-自定义 | 第一批已接线;按字段保存 `RUNSCRIPT` / `CONVERTSCRIPT` / `SAVESCRIPT` / XML;待页面保存副作用验收 | 一个组件多处接线 |
| 功能管理 / 视图管理 | `8b89fd29`, `d7e12a83` | 高级配置 XML 已接线;左树到右 grid 实体分类级联已恢复;仍缺编辑模板/可视化设计器入口和页面级验收 | 机制① mutator + 设计中心/overlay |
| 功能编辑列表-自定义 / 视图编辑列表-自定义 | `117374e1`, `de403e76` | 高级配置 XML 已接线;仍缺按 type 打开设计器 | 同设计器/编辑器能力 |
| 功能管理 / 视图管理 | `8b89fd29`, `d7e12a83` | 高级配置 XML、左树到右 grid 实体分类级联、编辑模板/可视化设计器入口均已接线;待页面保存副作用验收 | 机制① mutator + 设计中心/overlay |
| 功能编辑列表-自定义 / 视图编辑列表-自定义 | `117374e1`, `de403e76` | 高级配置 XML、按底层 `TEMPLATEID/PAGEID` 打开设计器均已接线;待页面保存副作用验收 | 同设计器/编辑器能力 |
| 定义定时任务 | `d99b5760` | 编辑任务脚本已接线;左树到右 grid 实体分类级联已恢复;仍缺页面保存副作用验收 | 级联 + code-editor |
| 设置定时任务 | `70f85b21` | 设置提醒人已接线;仍缺页面保存副作用验收 | 用户选择框 + UserTable 规则 |
| 数据导入配置管理 | `7821ef3b` | 编辑转换/保存脚本、下载模板、下载基础数据已接线;仍缺执行导入和页面下载文件验收 | code-editor + 导入端点 |
| 数据导入配置/文件管理 | `7821ef3b`, `1d132d4a` | 编辑转换/保存脚本、下载模板、下载基础数据、执行导入端点和文件页「执行」按钮已接线;待真实文件导入和下载文件打开验收 | code-editor + 导入端点 |
| 工作日历 | `a13fa07f` | 已接线:例外日服务、年度列表、toggle、3 态状态;待用户确认是否必须复刻旧 3x4 月历网格 | 新 bespoke 页 + 旧表 `SYS_CALENDAREXCEPTDAY` |
| 报表 | `e81454af` | DOCUMENT 菜单树;右区按 `VIEW_TEMPLATEID` 路由复用已转换页 | 路由宿主 |
| 报表 | `e81454af-0e0e-4c0d-add8-db434f198936` | DOCUMENT 菜单树和右区按 `VIEW_TEMPLATEID` 路由复用已转换页已接线;待真实报表叶子页面副作用验收 | 路由宿主 |
## P3 / 另案