Files
eip4-platform/docs/framework定制视图-TODO-2026-06-17.md
zhengwr 9cdd043af3
Some checks failed
ci / build-test-parity (push) Has been cancelled
docs: record schedule and data import status
2026-06-18 10:01:15 +08:00

84 lines
18 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Framework 定制视图 TODO(活清单)
> 维护日期:2026-06-18
> 口径:以 `framework定制视图-engineclass移植backlog-2026-06-17.md` 为总 backlog;本文只记录当前可执行队列、已改清单、提交与验证。
> 使用规则:每次修功能后,把条目从 Pending/In Progress 移到 Done,并补 `commit`、`tests`、`deploy/import`。没有逐功能验收的页面不能标 Done;代码已提交但页面闭环未验的项只能放在 Needs Verification。
## 当前状态
| 口径 | 数量 | 说明 |
|---|---:|---|
| framework 定制视图总数 | 46 | README 总览口径;backlog 表格当前可解析出 45 行,需后续校正缺的 1 行。 |
| 已逐功能验收 / 可算 Done | 约 8 | 用户管理、功能模板下载、实体分类-枚举组、已办任务、消息查看/已读、短消息、查看审批、我的发起任务。功能模板下载/已办/消息查看各覆盖 2 个 templateId,但按 engineclass 各计 1 组。 |
| 代码已提交但待最终副作用验收 | 约 8 | 待办任务:列表、查看详细、处理抽屉已验;未点同意/拒绝。用户选择框全家已切标准 amis picker,并已覆盖单选查询、单选表单、多选弹窗层级与多选展示烟测;流程选择框已接线/页面烟测;审批表单删除已补查看/删除端点和按钮注入;流程监控已补处理明细查看、结束流程和「高级处理」Groovy 执行入口;通用脚本/XML 编辑器已接入第一批页面;设置定时任务提醒人和数据导入下载入口已接线。上述项未覆盖所有真实业务保存、权限差异或页面副作用验收。 |
| 仍需修或逐功能验收 | 约 39 | 含上面的 5 个待验组;大多是通用页已产出,但 engineclass Java delta 未迁移。 |
| 剩余工程单元 | 约 28+ | 多视图可复用同一套组件/端点,如脚本编辑器、消息详情、工作流按钮。 |
## Done(已完成 / 已验收)
| 日期 | 范围 | 状态 | commit | 验证 |
|---|---|---|---|---|
| 2026-06-17 | 假菜单入口移除,只走后端 `/api/menu` 真菜单 | Done | `eip4-web f7ac4cd` | `npm run build` |
| 2026-06-17 | ApprovalDrawer 全局动作:converted amis `openApprovalDrawer` -> React 抽屉 | Done | `eip4-web f7ac4cd` | `registerApprovalAction.test.ts`; `npm run build` |
| 2026-06-17 | 抽屉遮罩层级修复,避免列表工具按钮盖住抽屉 | Done | `eip4-web f7ac4cd` | `npm run build`; 手工截图问题复现点 |
| 2026-06-17 | 流程发起者展示名:`INITUSERID_DISPLAY__` 批量解析 `VIEW_SYS_USER` | Done | `eip4-platform 57c3412` | live: `会议通知` 返回 `沈波恩[000026]` |
| 2026-06-17 | 待办/已办时间范围查询:兼容 AMIS datetime-range 秒/毫秒时间戳 | Done | `eip4-platform 57c3412` | live: `2026-06-15 20:37 - 2026-06-17 20:37` 返回 `total=0` |
| 2026-06-17 | `/api/flow` 老脚本临时绑定 `UserSession`,避免无 JWT 上下文直接崩 | Done | `eip4-platform 57c3412` | `FlowControllerTest` |
| 2026-06-17 | 已办任务 `FinishTaskComponentNew`:两个模板只读「查看详细」 | Done | `eip4-platform 57c3412`, `eip4-web f7ac4cd` | 浏览器验收:`efa62458`、`c6eb659c` 均有数据、无「处理」、只读详情抽屉含业务单据和轨迹 |
| 2026-06-17 | 功能模板下载模板管理/设置:去右表单添加按钮、标题改「编辑模板附件」 | Done | `b5fe995`, `3276774` | 转换器测试;重转重导后生效 |
| 2026-06-17 | 实体分类-枚举组:确认 EIP4 树端点 PK 唯一 + 去重,全量建树覆盖老 UUID 防重逻辑 | Done | 文档/核验项 | 无需移植 |
| 2026-06-17 | 用户管理 Delta 端到端案例 | Done | 见 `用户管理-Delta移植-实现过程与踩坑-2026-06-17.md` | 已逐字段 dogfood |
| 2026-06-18 | 消息查看/已读:收到的消息查看弹窗、打开即已读、已发送消息只读详情 | Done | `eip4-platform f690f30` | `NoticeControllerTest`; 浏览器验收 `83971d1a`:本地记录 `94d3645c-2487-47f6-bbf5-ebdff3434f6e` 置未读后列表显示“否”,打开详情后 DB 与列表均回“是”;浏览器验收 `b7635622`:已发送消息只读详情正常,无“消息详情加载失败” |
| 2026-06-18 | 短消息 `MessageManageView`:发送消息弹窗、标准用户多选 picker、写 `sys_message/sys_messageuser`、发送后刷新已发列表 | Done | `eip4-platform 723443e` | `NoticeControllerTest`; `TemplateToAmisConverterTest#engineclass_MessageSendView_注入查看按钮,#engineclass_MessageManageView_注入发送消息弹窗`; live 浏览器验收 `ae79a47b`:打开「发送消息」→ 接收人标准 amis 表格 picker(搜索/分页/checkbox)→ 发送成功 → 不点搜索即在已发列表第一行出现 `codex短消息live刷新-*` |
| 2026-06-18 | 查看审批 `WorkFlowHistoryDetailPanel`:通用审批业务列表「查看审批」从轨迹表弹窗升级为只读 `ApprovalDrawer`,支持 businessKey/processInstanceId 双路历史查看,展示业务单据 + 流程轨迹 | Done | `eip4-platform 21e3865`, `eip4-web d03c2ba` | `TemplateToAmisConverterTest#buildToolbar_审批列表补查看审批按钮`; `ApprovalControllerHistoryTest`; `registerApprovalAction.test.ts`; `npm run build`; `mvn -q -pl platform-app -am package -DskipTests`; 全量重转 2757 项,导入更新 636 项;浏览器验收 `18fb15c9`:选中第一行 →「查看审批」打开“审批详情”抽屉,含“业务单据(总包合同评审)/流程轨迹”,无旧“审批记录”弹窗 |
| 2026-06-18 | 我的发起任务 `MySendTaskComponent`:列表改走 Flowable startedBy 聚合端点;查看详细打开只读 ApprovalDrawer;撤回桥接 Flowable changeActivityState + 挂起实例;起流写入 authenticated user,保证 startedBy 有数据 | Done | `61f3152` | `FlowControllerTest`; `FlowableClientTest`; `TodoControllerAmisTest`; `TemplateToAmisConverterTest#engineclass_MySendTaskComponent_注入查看详细和撤回按钮`; `registerApprovalAction.test.ts`; `npm run build`; `mvn -q -pl flowable-service,platform-app -am clean package -DskipTests`; 全量重转 2757 项、导入更新 641 项;接口 E2E:`20424028` 以 `ADMIN` 发起后 `/api/workflow/process/started-amis` 返回 `E2E-MYSEND-BROWSER-20260618-0250`;浏览器验收 `0db4af06`:列表出现测试行,选中后“查看详细/撤回”启用,“查看详细”打开业务单据+流程轨迹;撤回后实例 `suspended=true` |
## In Progress / Needs Verification
| 范围 | 状态 | 缺口 | 下一步 |
|---|---|---|---|
| 流程/审批:待办任务 `TaskComponentNew` | Needs side-effect verification | 浏览器已验 `4ebfc9ee`、`0f7531e2`:列表有数据、发起人显名、查看详细抽屉、处理抽屉、遮罩层级均正常;未点最终同意/拒绝,未验处理后刷新 | 准备专门测试流程实例,或经用户确认可消耗真实待办后,再验“同意/拒绝/退回后列表刷新” |
| 用户选择框全家 | Implemented / Needs business verification | 最新口径:用户单选 `SelectDialog`、多选 `MultiSelectDialog` 均使用标准 amis `picker`(单选不加 `multiple`;多选 `multiple:true` + `overflowConfig.maxTagCount=1`;数据源 `/api/picker/<dialogid>/list`),`eip4-web` 兼容过滤器继续把存量 `user-transfer-picker` 归一成标准 picker。本轮补丁补齐运行时默认值契约:转换器给编辑/查看弹窗 load 服务追加 `?__egtpl=<editFormViewPageId>`,`FlowController` 按该编辑表单 XML 将 load 返回的 `SelectDialog/MultiSelectDialog` 裸 id 解析为 `{_id,_label}`(多选为对象数组),避免默认值显示 UUID 或撑开布局。部署:`BatchConvertCli` 全量重转 2757 项(view_page 编辑表单 1241 个产物),`SchemaImportCli` 扫描 2727 个产物、入库/更新 1054 个,8093 已重启。自动化:`mvn -q -pl platform-converter -Dtest=TemplateToAmisConverterTest#read按钮接load服务_dialog用api加载本体数据,TemplateToAmisConverterTest#crud_用户单选框受控转标准Picker,TemplateToAmisConverterTest#crud_用户选择框组织与考勤模式接线,TemplateToAmisConverterTest#crud_multiSelectDialog转picker多选弹窗 test`、`mvn -q -pl platform-metadata -Dtest=FlowControllerTest#postLoadWithEditTemplateResolvesPickerDefaults test`、`npm test -- --run src/amis/registerUserTransferPicker.test.ts`。浏览器烟测:`5078945c`「用户组-分配用户」为标准多选 picker,默认值显示 `施继栋002[222222]`、无裸 UUID、控件 32px、二级弹窗含搜索/分页/checkbox;`919477da`「流程代理授权」代理人为标准单选 picker,控件与 label 对齐且二级弹窗实际 input 类型为 radio;短消息 `ae79a47b` 已覆盖多选 picker 选人并保存。 | 继续在设置定时任务、岗位设置等真实引用页验保存值、ALL 互斥、受控/全部权限差异和考勤排除挂靠 |
| 流程选择框 | 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 字段一致;确认弹窗层级、只读/必填、空值保存和异常提示 |
| 设置定时任务 `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 待做 |
| 菜单真入口 | Needs verification | 前端已去硬编码假入口;需确认所有需要的真菜单在 `sys_menu` 中可达 | 用 `/api/menu` 和页面侧栏核对 |
| 功能模板下载门控 | Pending | backlog 写了 `VIEW_TEMPLATEID` 非空才显示附件编辑;当前只做了去按钮/改标题 | 决定是否补门控,若补则在 `EngineclassDelta` mutator 中按行/上下文控制 |
## P0 / P1(下一批建议先做)
| 优先级 | 范围 | 视图 / engineclass | 要补什么 | 复用机制 |
|---|---|---|---|---|
| P1 | 流程监控(剩余) | `9f3b5a8b` | 已接线;待页面副作用验收见上方 Needs Verification | 通用 code-editor + Groovy 权限/审计端点 |
## P2(中等 delta,可批量复用)
| 范围 | 视图 | 要补什么 | 复用点 |
|---|---|---|---|
| 脚本/XML 编辑器 | 定义定时任务、数据导入配置、流程监控高级处理、功能/视图编辑列表-自定义 | 第一批已接线;按字段保存 `RUNSCRIPT` / `CONVERTSCRIPT` / `SAVESCRIPT` / XML;待页面保存副作用验收 | 一个组件多处接线 |
| 功能管理 / 视图管理 | `8b89fd29`, `d7e12a83` | 高级配置 XML 已接线;仍缺编辑模板/可视化设计器入口和左树到右 grid 级联逐页确认 | 机制① mutator + 设计中心/overlay |
| 功能编辑列表-自定义 / 视图编辑列表-自定义 | `117374e1`, `de403e76` | 高级配置 XML 已接线;仍缺按 type 打开设计器 | 同设计器/编辑器能力 |
| 定义定时任务 | `d99b5760` | 编辑任务脚本已接线;仍缺 ENTITYTYPE 级联和页面保存副作用验收 | 级联 + code-editor |
| 设置定时任务 | `70f85b21` | 设置提醒人已接线;仍缺页面保存副作用验收 | 用户选择框 + UserTable 规则 |
| 数据导入配置管理 | `7821ef3b` | 编辑转换/保存脚本、下载模板、下载基础数据已接线;仍缺执行导入和页面下载文件验收 | code-editor + 导入端点 |
| 工作日历 | `a13fa07f` | 年历网格;例外日 toggle;3 态着色 | 新 bespoke 页,后端服务已在 |
| 报表 | `e81454af` | DOCUMENT 菜单树;右区按 `VIEW_TEMPLATEID` 路由复用已转换页 | 路由宿主 |
## P3 / 另案
| 范围 | 视图 | 处置 |
|---|---|---|
| 电子邮件全家桶 | `27e3d27b`, `827e5a96`, `80ba2bef`, `8b30b940` | 等同 webmail 子系统,需单独立项:IMAP/SMTP、写信、收发件箱、配置、默认邮箱。 |
| 流程定义 | `5628f2e9` | Flowable Modeler 在线建模/部署/导入导出,独立子系统,需客户确认是否需要在线建模。 |
| 个人设置内联子组件 | `db87828a` | 改密已覆盖;其余手机、上级、主岗位等按用户管理/个人中心需求拆做。 |
## 待校正口径
- `docs/README.md` 和 backlog 摘要写 framework 定制视图 46 个,但 backlog 表格当前只有 45 行。后续需要从原始分析 JSON 或 `view_template` 查询补齐缺失的 1 个,避免统计漂移。
- 历史「16 视图已交付」报告已归档,不能作为完成口径;只能看本文、README 和 engineclass backlog。
- 统计必须区分 templateId、视图/engineclass 组、功能点。比如待办/已办覆盖 4 个 templateId,但按 engineclass 只算 2 组;功能模板下载覆盖 2 个 templateId,但按 engineclass 只算 1 组。
- 每次全库重转重导后,需要把影响范围写回本文,特别是 `EngineclassDelta` 的新增 mutator/registry 项。