Files
eip4-platform/docs/framework定制视图-TODO-2026-06-17.md
zhengwr f736d33a20
Some checks failed
ci / build-test-parity (push) Has been cancelled
docs(platform): record approval history completion
2026-06-18 02:13:09 +08:00

80 lines
12 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-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 | 约 7 | 用户管理、功能模板下载、实体分类-枚举组、已办任务、消息查看/已读、短消息、查看审批。功能模板下载/已办/消息查看各覆盖 2 个 templateId,但按 engineclass 各计 1 组。 |
| 代码已提交但待最终副作用验收 | 约 3 | 待办任务:列表、查看详细、处理抽屉已验;未点同意/拒绝。用户选择框全家已切标准 amis picker,并已覆盖单选查询、单选表单、多选弹窗层级与多选展示烟测;流程选择框已接线/页面烟测;两者都未覆盖所有真实业务保存和权限差异验收。 |
| 仍需修或逐功能验收 | 约 40 | 含上面的 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`:选中第一行 →「查看审批」打开“审批详情”抽屉,含“业务单据(总包合同评审)/流程轨迹”,无旧“审批记录”弹窗 |
## 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` 写入/读取一致 |
| 菜单真入口 | Needs verification | 前端已去硬编码假入口;需确认所有需要的真菜单在 `sys_menu` 中可达 | 用 `/api/menu` 和页面侧栏核对 |
| 功能模板下载门控 | Pending | backlog 写了 `VIEW_TEMPLATEID` 非空才显示附件编辑;当前只做了去按钮/改标题 | 决定是否补门控,若补则在 `EngineclassDelta` mutator 中按行/上下文控制 |
## P0 / P1(下一批建议先做)
| 优先级 | 范围 | 视图 / engineclass | 要补什么 | 复用机制 |
|---|---|---|---|---|
| P1 | 我的发起任务 | `0db4af06` | 查看详细、撤回;撤回需 Flowable 桥和已流转校验 | 机制① + 流程端点 |
| 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 项。