# Framework 定制视图 TODO(活清单) > 维护日期:2026-06-17 > 口径:以 `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 组。 | | 代码已提交但待最终副作用验收 | 约 3 | 待办任务:列表、查看详细、处理抽屉已验;未点同意/拒绝。用户选择框全家已切标准 amis picker,并已覆盖单选查询、单选表单、多选弹窗层级与多选展示烟测;流程选择框已接线/页面烟测;两者都未覆盖所有真实业务保存和权限差异验收。 | | 仍需修或逐功能验收 | 约 39 | 含上面的 3 个待验组;大多是通用页已产出,但 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//list`),`eip4-web` 兼容过滤器继续把存量 `user-transfer-picker` 归一成标准 picker。本轮补丁补齐运行时默认值契约:转换器给编辑/查看弹窗 load 服务追加 `?__egtpl=`,`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` 写入/读取一致 | | 菜单真入口 | Needs verification | 前端已去硬编码假入口;需确认所有需要的真菜单在 `sys_menu` 中可达 | 用 `/api/menu` 和页面侧栏核对 | | 功能模板下载门控 | Pending | backlog 写了 `VIEW_TEMPLATEID` 非空才显示附件编辑;当前只做了去按钮/改标题 | 决定是否补门控,若补则在 `EngineclassDelta` mutator 中按行/上下文控制 | ## P0 / P1(下一批建议先做) | 优先级 | 范围 | 视图 / engineclass | 要补什么 | 复用机制 | |---|---|---|---|---| | P1 | 流程监控 | `9f3b5a8b` | 处理、高级处理、结束流程;高级处理涉及 Groovy 权限/审计 | 机制① + 流程端点,需权限守卫 | | P1 | 审批表单删除 | `91ccbba3` | 查看只读表单、删除历史流程实例 | 复用只读审批抽屉 + 流程删除端点 | ## P2(中等 delta,可批量复用) | 范围 | 视图 | 要补什么 | 复用点 | |---|---|---|---| | 脚本/XML 编辑器 | 定义定时任务、数据导入配置、流程监控高级处理、功能/视图编辑列表-自定义 | 通用 code-editor 弹窗;按字段保存 `RUNSCRIPT` / `CONVERTSCRIPT` / `SAVESCRIPT` / XML | 一个组件多处接线 | | 功能管理 / 视图管理 | `8b89fd29`, `d7e12a83` | 左树到右 grid 级联;编辑模板/高级配置;可视化设计器入口 | 机制① mutator + 设计中心/overlay | | 功能编辑列表-自定义 / 视图编辑列表-自定义 | `117374e1`, `de403e76` | 按 type 打开设计器;高级配置 XML 保存 | 同设计器/编辑器能力 | | 定义定时任务 | `d99b5760` | 编辑任务脚本;ENTITYTYPE 级联;部分字段保存 RUNSCRIPT | 级联 + code-editor | | 设置定时任务 | `70f85b21` | 设置提醒人;`SENDINFO` JSON 双向编辑 | 用户选择框 + UserTable 规则 | | 数据导入配置管理 | `7821ef3b` | 编辑转换/保存脚本;下载模板;下载基础数据;执行导入 | code-editor + POI/导入端点 | | 工作日历 | `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 项。