108 lines
12 KiB
Markdown
108 lines
12 KiB
Markdown
# EIP4 迁移项目 — 文档索引与状态总览
|
||
|
||
> 维护日期:2026-06-17 | **本文是 `docs/` 的唯一入口与状态权威。** 被取代的历史状态/审计快照已移入 `归档/`。
|
||
>
|
||
> **为什么需要本文**:项目历史上随方法论演进(源码 parity → 宣称交付 → 数据驱动重审 → XML 审计 → **engineclass Java delta**)产出了多份「framework 视图状态/parity」文档,结论互相冲突——尤其 `归档/framework系统管理视图-实现交付报告`(宣称「16 视图已交付」)是「以为做了很多」错觉的来源,实为 demo 级、未逐功能验收。**以本文 + 下方两份现行权威为准,其余归档勿再据以判断进度。**
|
||
|
||
---
|
||
|
||
## 0. 一句话现状
|
||
|
||
**横向地基铺得较全**(转换器通用能力 / 保真层 / 审批基础设施 / 写路径 / 机制①),但**纵向"按系统模块做到 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(功能模板下载 ✅、枚举组 ✅、日志组 🟡)。这些通用修复一次性惠及全库搜索/树编辑/列表页,非单视图。
|
||
|
||
---
|
||
|
||
## 1. 模块完成度(诚实口径)
|
||
|
||
档位说明:✅ parity 完成(逐功能验收过) | 🟡 demo 级(有页/端点但未 parity 验收) | 🟠 通用页已产·engineclass delta 未移植 | ❌ bespoke 未起步 | 🔵 横向能力(跨模块共用,非单模块)
|
||
|
||
### 1.1 纵向(系统模块 / framework 定制视图)
|
||
|
||
| 模块组 | 代表视图 | 档位 | 备注 |
|
||
|---|---|---|---|
|
||
| **用户管理** | 用户管理 629463ae | ✅ | 列表/设置主岗位/查看菜单/主部门主岗位树选/picker 显名/filterscript 级联,逐字段 dogfood 验收。剩:编辑页 org picker 查询条件、导出 Excel |
|
||
| RBAC/组织 | 用户组/角色/菜单维护/部门/数据权限授权 | 🟡 | 2026-06-14 搭了 CRUD 端点 + amis 后台页,但 demo 级、未对照旧版逐功能验收 |
|
||
| RBAC/组织 | 岗位管理/分公司岗位管理 | 🟠 | 通用页在;engineclass「设置(岗位↔用户 picker)」未移植 |
|
||
| 元数据/平台工具 | 实体/服务流/视图管理/功能管理/自动编号/定时任务/数据导入配置 | 🟠 | 通用页在;重写服务/设计器/脚本编辑器等重度 delta 未移植 |
|
||
| 元数据/平台工具 | 功能模板下载(设置 13accf09/管理 0246d4bd) | ✅ | `b5fe995` 机制①整页改写器:去右表单「添加」按钮 + 标题「编辑模板附件」+ `3276774` 布局保真。门控③(VIEW_TEMPLATEID 非空才显)暂延后 |
|
||
| 元数据/平台工具 | 实体分类-枚举组 b114351f | ✅ | 已核对:EIP4 树端点 PK 唯一+去重+全量建树,天然规避老 UUID 防重逻辑,无需移植 |
|
||
| 流程/审批 | 待办/已办/我的发起任务 | 🟡 | 已办 `FinishTaskComponentNew` 两个模板已浏览器验收只读详情;待办 `TaskComponentNew` 两个模板已验列表/查看详细/处理抽屉/遮罩层级,未点最终同意/拒绝,处理后刷新仍待专门测试数据或用户确认。我的发起任务的查看/撤回未接。 |
|
||
| 流程/审批 | 查看审批/流程监控/流程定义/审批表单删除 | ❌🟠 | 查看审批=bespoke 未起步;流程定义=Flowable Modeler 另案 |
|
||
| 消息/邮件 | 收到/已发送消息、短消息 | 🟠 | 列表页在(有删除);查看弹窗/发送/已读联动未接 |
|
||
| 消息/邮件 | 电子邮件全家桶(收件箱/发件箱/配置) | ❌ | 等同独立 webmail 子系统,另案立项 |
|
||
| picker 控件 | 用户选择框×4 / 流程选择框 | 🟡 | 用户选择框×4 已接 amis `tabs-transfer-picker` + `UserSelectController`;流程选择框已接 `transfer-picker` + `ProcessSelectController`。均已页面烟测,仍待真实业务保存/权限差异验收。 |
|
||
| 日志/历史 | 系统日志/登录历史/登录操作 | 🟡 | `17c449c` 删除按钮组已接(机制①+LogController systemLogManager);列表经 real-first 修通(原 SYS_USERLOGIN_HISTORY_SEARCH 报 createtime 缺列);时间段过滤已通。剩:登录操作列表 VIEW_SYS_USERLOGINFO 此库缺视图 |
|
||
| 其它 bespoke | 个人设置/工作日历/报表 | ❌ | 无 XML,逐个从零 |
|
||
|
||
> framework 定制视图共 46 个,逐视图清单与移植项见 **`framework定制视图-engineclass移植backlog-2026-06-17.md`**(主 backlog)。
|
||
|
||
### 1.2 业务模块(pm/hr/oa/dm 的 153 个定制视图)
|
||
|
||
另一条线,多数走 bespoke 重写或通用模板,绝大部分未做。处置口径见 `M0交付/153定制视图处置清单v1.md`(历史)。
|
||
|
||
### 1.3 🔵 横向能力(已就绪,跨模块共用)
|
||
|
||
- **转换器通用能力**:navigation 按钮、type=101 树形选择框、picker 引用列显名、filterscript 级联(组织→部门→岗位,已收口静态可达部分)、title 修正、colspan 栅格、A0 控件(密码/附件/日期)、EditGrid 子表递归。
|
||
- **🆕 树编辑表单布局保真**(`3276774`):type=3 可编辑树 master-detail 现按 view_page `<layout>` 的 `<div location>` 槽位排版 + 隐藏未布局字段(VERSION/主键/引用 id 等绑提交但不显示)——与 EDITFORM 同口径 `buildFormBody`,修「树编辑泄露隐藏字段 + 裸列名标签」。影响 41 可编辑树页。
|
||
- **🆕 搜索时间段过滤**(`fb8a37d`,全站通用):amis `input-date(time)-range` 的 `"起,止"` 串在保真层读流路径(NAMED_READ/SYNTHESIZED)转 `DateTime[]`,接通引擎 GeneralPO 区间查询 `(col>=起 AND col<=止)`;认 unix 秒/毫秒/格式化;只碰 DATE/TIME 列(零回归)。修「操作日志等时间段查不动」。
|
||
- **🆕 用户选择框全家接线**:旧 `UserSelectWindow` / `UserOrgSelectWindow` 四个 dialogid 已由转换器接到 amis 内建 `tabs-transfer-picker`,后端 `/api/user-select/options|search` 提供 `controlled/all/org/attendance` 四模式,覆盖人员、部门树、岗位类别、用户类别、ALL 特殊项与考勤源。已全库重转重导;真实业务保存和权限差异仍按 TODO 逐页验收。
|
||
- **🆕 流程选择框接线**:旧 `ProcessSelectDialog` 已由转换器接到 amis 内建 `transfer-picker`,后端 `/api/process-select/options|search` 维持旧值口径(流程名即提交值),数据源优先 Flowable Model/ProcDef,本地 dev 无模型时回退历史流程名。`919477da` 流程代理授权页面已页面烟测,保存闭环待验。
|
||
- **🆕 real-first 流解析**(`abc32af`):`_SEARCH` 优先真实 serviceflow(忠实旧引擎,无运行时合成兜底覆盖),统一所有操作读存储流。修约 107 列表打不开(无 createtime)+ 157 排序错;A/B 新修 33。
|
||
- **机制①** `EngineclassDelta`:engineclass FQN → 工具栏按钮注册表(REGISTRY)**+ 整页改写器(MUTATORS,`b5fe995`,覆盖非 crud 加按钮类 delta:移除/改写默认页元素)**。
|
||
- **审批基础设施**:后端 `ApprovalController`(approval-meta/business-data/action)+ `TodoController`(trace)+ BusinessRecordLoader/WfTemplateService/StatusWriteback;前端 `ApprovalDrawer.tsx`(业务表单+轨迹+动态按钮+提交)。**已建成,缺的是 amis 列表页的入口按钮接线。**
|
||
- **保真层/写路径**:JUEL(jakarta.el JSR-223)跨流条件求值、增删改查 + 提交审批桥(ProcessCoreServiceBridge)、PG 升级、Flowable 升级。
|
||
|
||
---
|
||
|
||
## 2. 现行权威文档(看这几份就够)
|
||
|
||
| 文档 | 用途 |
|
||
|---|---|
|
||
| **`项目进度与路线-总览-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 组件设计体系(已设计、未实现) |
|
||
| `通用模板全类型可用性-通盘盘点与收口计划-2026-06-16.md` | **通用模板**(非定制,~1363 个)覆盖与收口(与定制视图是两条线) |
|
||
| `客户沟通清单v1.md` | 商务/客户侧依赖卡点 |
|
||
| `plans/2026-06-16-WfTemplate驱动审批界面-完整实现方案.md` | 审批界面实现方案(对应基础设施 🔵 已建) |
|
||
| `决策与盘点/` | 架构决策报告/会纪要/客户库盘点(历史参考,奠基性) |
|
||
| `P0-PG升级/`、`P3-Flowable升级/` | PG / Flowable 升级 runbook |
|
||
| `研究/` | 服务流分派、通知保存老vs新机制 trace(专题研究) |
|
||
|
||
---
|
||
|
||
## 3. 全文档索引(含归档)
|
||
|
||
| 文档 | 状态 | 取代它的 / 备注 |
|
||
|---|---|---|
|
||
| README.md(本文) | 现行 | 唯一状态入口 |
|
||
| framework定制视图-TODO-2026-06-17 | 现行·活清单 | 当前执行队列,记录已改提交、待验项、下一批 |
|
||
| framework定制视图-engineclass移植backlog-2026-06-17 | 现行·权威 | framework 视图主 backlog |
|
||
| 用户管理-Delta移植-…-2026-06-17 | 现行·权威 | 方法论+交接 |
|
||
| 组件设计体系-design-2026-06-15 | 现行 | — |
|
||
| 通用模板全类型可用性-…-2026-06-16 | 现行 | 通用模板线 |
|
||
| 客户沟通清单v1 | 现行 | 商务线 |
|
||
| `归档/framework系统管理视图-功能点Parity对照与实现计划-2026-06-16`(84K) | 已归档 | 被 engineclass backlog 取代 |
|
||
| `归档/framework系统管理视图-实现交付报告-2026-06-17` | 已归档 | ⚠️「16 视图已交付」=demo 级,被数据驱动重审纠正;勿据此判进度 |
|
||
| `归档/framework系统管理视图-数据驱动Parity重审与修复队列-2026-06-17` | 已归档 | 被 engineclass backlog 取代 |
|
||
| `归档/framework定制视图-转换页审计-2026-06-17` | 已归档 | XML 审计(自评不可靠),被 engineclass backlog 取代 |
|
||
| `归档/EIP4-架构与缺口现状-2026-06-13`(34K) | 已归档 | 06-13 快照,早于 engineclass 重定性 + 06-14~17 全部工作 |
|
||
| `归档/转换器覆盖度审计-2026-06-13` | 已归档 | 06-13 缺口快照 |
|
||
| `归档/F2-17-审计基线-2026-06-13-升级` | 已归档 | 自动审计快照(历史) |
|
||
| `归档/F2-17-组件真实性审计-修复后复测`(06-12) | 已归档 | 自动审计快照(历史) |
|
||
| `归档/F2-17-组件真实性审计基线`(06-12) | 已归档 | 自动审计快照(历史) |
|
||
| `归档/F2-12-UI走查清单`(06-11/12) | 已归档 | UI 走查(历史) |
|
||
| `归档/未完成工作清单`(06-12) | 已归档 | 早期清单,已被多轮取代 |
|
||
| M0交付/、P1/、PoC证据/ 子目录 | 历史 | 阶段交付/简报/证据(保留备查,不反映当前进度) |
|
||
|
||
---
|
||
|
||
## 4. 下一步指引
|
||
|
||
- framework 定制视图优先级见 backlog §5:P1 = 岗位·主岗位·查看菜单按钮组 / 查看审批 / 任务按钮 / 消息查看 / 短消息;用户选择框全家、流程选择框已进入业务逐页验收队列。
|
||
- **主攻方向待拍板**(候选:RBAC/组织模块组做到 parity | 全模块完成度审计 | 广度优先铺基线 | 任务/审批簇接线)。
|
||
- 部署/重转/导入 recipe、踩坑见「用户管理-Delta移植」§4 与本仓 `scripts/run-dev.sh`。
|