diff --git a/docs/README.md b/docs/README.md index ca8b1ce..ee50a29 100644 --- a/docs/README.md +++ b/docs/README.md @@ -8,7 +8,7 @@ ## 0. 一句话现状 -**横向地基铺得较全**(转换器通用能力 / 保真层 / 审批基础设施 / 写路径 / 机制①),但**纵向"按系统模块做到 parity 验收"目前只有「用户管理」1 个完成**。其余 ~45 个 framework 定制视图 + 业务模块,多处于"转换器产出了通用页、但 engineclass 的 Java 定制 delta 未移植 / 未逐功能验收"。详见 §1。 +**横向地基铺得较全**(转换器通用能力 / 保真层 / 审批基础设施 / 写路径 / 机制①),但**纵向"按系统模块做到 parity 验收"目前只有「用户管理」1 个完成**。其余 ~45 个 framework 定制视图 + 业务模块,多处于"转换器产出了通用页、但 engineclass 的 Java 定制 delta 未移植 / 未逐功能验收"。详见 §1;当前逐项执行队列见 `framework定制视图-TODO-2026-06-17.md`。 > **本会话进展(2026-06-17 续,6 提交已 push origin/main `1b69f8b..fb8a37d`)**:三个**全站通用**保真修复 + Wave A 两项。详见 §1.3 横向能力(real-first 流解析 / 树编辑布局保真 / 搜索时间段过滤)与 §1.1(功能模板下载 ✅、枚举组 ✅、日志组 🟡)。这些通用修复一次性惠及全库搜索/树编辑/列表页,非单视图。 @@ -28,7 +28,7 @@ | 元数据/平台工具 | 实体/服务流/视图管理/功能管理/自动编号/定时任务/数据导入配置 | 🟠 | 通用页在;重写服务/设计器/脚本编辑器等重度 delta 未移植 | | 元数据/平台工具 | 功能模板下载(设置 13accf09/管理 0246d4bd) | ✅ | `b5fe995` 机制①整页改写器:去右表单「添加」按钮 + 标题「编辑模板附件」+ `3276774` 布局保真。门控③(VIEW_TEMPLATEID 非空才显)暂延后 | | 元数据/平台工具 | 实体分类-枚举组 b114351f | ✅ | 已核对:EIP4 树端点 PK 唯一+去重+全量建树,天然规避老 UUID 防重逻辑,无需移植 | -| 流程/审批 | 待办/已办/我的发起任务 | 🟠 | 通用列表页在但工具栏空;「查看详细/处理」按钮未接(审批基础设施 🔵 已就绪,缺列表入口接线) | +| 流程/审批 | 待办/已办/我的发起任务 | 🟡 | 待办/已办 `TaskComponentNew`/`FinishTaskComponentNew` 已接 `/api/workflow/tasks/*-amis` +「查看详细/处理」抽屉入口(`57c3412`/`f7ac4cd`);仍需浏览器验收闭环。我的发起任务的查看/撤回未接。 | | 流程/审批 | 查看审批/流程监控/流程定义/审批表单删除 | ❌🟠 | 查看审批=bespoke 未起步;流程定义=Flowable Modeler 另案 | | 消息/邮件 | 收到/已发送消息、短消息 | 🟠 | 列表页在(有删除);查看弹窗/发送/已读联动未接 | | 消息/邮件 | 电子邮件全家桶(收件箱/发件箱/配置) | ❌ | 等同独立 webmail 子系统,另案立项 | @@ -59,6 +59,7 @@ | 文档 | 用途 | |---|---| | **`项目进度与路线-总览-2026-06-17.md`** | **全项目进度盘点 + 剩余工作路线**(A 兼容 / B 新功能 + 关键路径 + 待拍板决策) | +| **`framework定制视图-TODO-2026-06-17.md`** | **当前活 TODO**:已改/已提交/待验/下一批优先级;每次修完必须回写 commit 与验证。 | | **`framework定制视图-engineclass移植backlog-2026-06-17.md`** | 46 个 framework 定制视图迁移**主 backlog**(verdict/移植项/优先级 P1-P3) | | **`用户管理-Delta移植-实现过程与踩坑-2026-06-17.md`** | 方法论 + 机制① + 踩坑 + filterscript 级联收口(首个端到端案例 + 会话交接) | | `组件设计体系-design-2026-06-15.md` | 全站 UI/UE 组件设计体系(已设计、未实现) | @@ -76,6 +77,7 @@ | 文档 | 状态 | 取代它的 / 备注 | |---|---|---| | README.md(本文) | 现行 | 唯一状态入口 | +| framework定制视图-TODO-2026-06-17 | 现行·活清单 | 当前执行队列,记录已改提交、待验项、下一批 | | framework定制视图-engineclass移植backlog-2026-06-17 | 现行·权威 | framework 视图主 backlog | | 用户管理-Delta移植-…-2026-06-17 | 现行·权威 | 方法论+交接 | | 组件设计体系-design-2026-06-15 | 现行 | — | diff --git a/docs/framework定制视图-TODO-2026-06-17.md b/docs/framework定制视图-TODO-2026-06-17.md new file mode 100644 index 0000000..b05a04a --- /dev/null +++ b/docs/framework定制视图-TODO-2026-06-17.md @@ -0,0 +1,78 @@ +# Framework 定制视图 TODO(活清单) + +> 维护日期:2026-06-17 +> 口径:以 `framework定制视图-engineclass移植backlog-2026-06-17.md` 为总 backlog;本文只记录当前可执行队列、已改清单、提交与验证。 +> 使用规则:每次修功能后,把条目从 Pending/In Progress 移到 Done,并补 `commit`、`tests`、`deploy/import`。没有逐功能验收的页面不能标 Done。 + +## 当前状态 + +| 口径 | 数量 | 说明 | +|---|---:|---| +| framework 定制视图总数 | 46 | README 总览口径;backlog 表格当前可解析出 45 行,需后续校正缺的 1 行。 | +| 已明确完成 / 本轮收口 | 约 8 | 用户管理、功能模板下载 2、实体分类-枚举组、待办/已办任务 4。 | +| 仍需修或逐功能验收 | 约 37-38 | 大多是通用页已产出,但 engineclass Java delta 未迁移。 | +| 剩余工程单元 | 约 30+ | 多视图可复用同一套组件/端点,如 picker 全家、脚本编辑器、消息详情、工作流按钮。 | + +## Done(已提交) + +| 日期 | 范围 | 状态 | commit | 验证 | +|---|---|---|---|---| +| 2026-06-17 | 假菜单入口移除,只走后端 `/api/menu` 真菜单 | Done | `eip4-web f7ac4cd` | `npm run build` | +| 2026-06-17 | 待办任务 `TaskComponentNew`:改数据源 `/api/workflow/tasks/todo-amis`,注入「查看详细」「处理」 | Done | `eip4-platform 57c3412`, `eip4-web f7ac4cd` | `TodoControllerAmisTest`; live: `/api/workflow/tasks/todo-amis` | +| 2026-06-17 | 已办任务 `FinishTaskComponentNew`:改数据源 `/api/workflow/tasks/done-amis`,注入只读「查看详细」 | Done | `eip4-platform 57c3412`, `eip4-web f7ac4cd` | `TodoControllerAmisTest`; live: `/api/workflow/tasks/done-amis` | +| 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 | 功能模板下载模板管理/设置:去右表单添加按钮、标题改「编辑模板附件」 | Done | `b5fe995`, `3276774` | 转换器测试;重转重导后生效 | +| 2026-06-17 | 实体分类-枚举组:确认 EIP4 树端点 PK 唯一 + 去重,全量建树覆盖老 UUID 防重逻辑 | Done | 文档/核验项 | 无需移植 | +| 2026-06-17 | 用户管理 Delta 端到端案例 | Done | 见 `用户管理-Delta移植-实现过程与踩坑-2026-06-17.md` | 已逐字段 dogfood | + +## In Progress / Needs Verification + +| 范围 | 状态 | 缺口 | 下一步 | +|---|---|---|---| +| 流程/审批:待办/已办任务 | Needs verification | 列表和抽屉功能已接,仍需浏览器手工验「查看详细」「处理」「处理后刷新」完整闭环 | 用真实账号在页面逐条验收;通过后 README 从半完成改为完成 | +| 菜单真入口 | Needs verification | 前端已去硬编码假入口;需确认所有需要的真菜单在 `sys_menu` 中可达 | 用 `/api/menu` 和页面侧栏核对 | +| 功能模板下载门控 | Pending | backlog 写了 `VIEW_TEMPLATEID` 非空才显示附件编辑;当前只做了去按钮/改标题 | 决定是否补门控,若补则在 `EngineclassDelta` mutator 中按行/上下文控制 | + +## P0 / P1(下一批建议先做) + +| 优先级 | 范围 | 视图 / engineclass | 要补什么 | 复用机制 | +|---|---|---|---|---| +| P1 | 用户选择框全家 | `76d2f950`, `1b3bad0b`, `090981ba`, `e31ce405` | 受控/组织/全部/批量多维穿梭框;部门树、岗位类别、用户类别、ALL 特殊项、考勤过滤 | 机制④ React/amis 自定义组件 + `UserSelectController` + 转换器接线 | +| P1 | 流程选择框 | `b3070157` | 流程多选穿梭框;Flowable 流程定义列表端点 | 机制④,复用 picker 壳 | +| P1 | 查看审批 | `b4d00f1a` | businessKey/processInstanceId 双路解析;接轨迹与业务单据只读页 | 复用 `ApprovalDrawer`/trace | +| P1 | 我的发起任务 | `0db4af06` | 查看详细、撤回;撤回需 Flowable 桥和已流转校验 | 机制① + 流程端点 | +| P1 | 流程监控 | `9f3b5a8b` | 处理、高级处理、结束流程;高级处理涉及 Groovy 权限/审计 | 机制① + 流程端点,需权限守卫 | +| P1 | 审批表单删除 | `91ccbba3` | 查看只读表单、删除历史流程实例 | 复用只读审批抽屉 + 流程删除端点 | +| P1 | 消息查看/已读 | `83971d1a`, `b7635622` | 收到的消息查看弹窗、打开即已读、已发送消息只读详情 | MessageService REST + converted 按钮 | +| P1 | 短消息 | `ae79a47b` | 发送消息弹窗;收件人使用用户选择框全家 | 等 picker 完成后接 | + +## 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。 +- 每次全库重转重导后,需要把影响范围写回本文,特别是 `EngineclassDelta` 的新增 mutator/registry 项。