Files
eip4-platform/docs
zhengwr 03bf036d87
Some checks failed
ci / build-test-parity (push) Has been cancelled
docs: record treegrid entity filtering status
2026-06-18 10:10:28 +08:00
..
2026-06-17 23:56:20 +08:00

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 续):三个全站通用保真修复 + Wave A 两项已 push origin/main 1b69f8b..fb8a37d;用户选择框最新回归标准 amis picker(eip4-web b0537f8、eip4-platform 0d6fab4)。详见 §1.3 横向能力(real-first 流解析 / 树编辑布局保真 / 搜索时间段过滤 / 标准 picker 接线)与 §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 picker(单选默认,multiple: true 为多选,数据源 /api/picker/<dialogid>/list;旧 schema 由 web 兼容过滤器兜底归一);流程选择框已接 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 标准 picker,单选/多选只通过 multiple 区分;数据源走统一 /api/picker/<dialogid>/list,表格弹窗保留搜索、分页、显名与 checkbox 多选。eip4-web 兼容过滤器会把历史 user-transfer-picker schema 归一成同一标准 picker。已页面烟测查询单选与业务表单多选;真实业务保存、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。