Files
eip4-platform/docs/README.md
zhengwr 1b69f8b481
Some checks failed
ci / build-test-parity (push) Has been cancelled
docs: 统一项目文档进 eip4-platform/docs + 新增进度路线总览
- 从工作区根 docs/(非 git,未版本化)合并全部文档进版本控制,消除文档两头分裂
- 新增 README(状态总览+模块完成度+全文档索引)、项目进度与路线-总览-2026-06-17(A兼容/B新功能+关键路径+待拍板决策)
- 被取代的冲突状态/审计快照归入 归档/;对最易误导的两份("16视图已交付"实现交付报告、06-13架构快照)加"已归档"横幅
- 现行权威:engineclass移植backlog(46视图) + 用户管理Delta移植(方法论/交接) + 组件设计体系 + 通用模板收口 + 客户沟通
- 诚实口径:纵向模块仅用户管理 parity,横向引擎地基较全,余 153 定制视图(47 framework+106 业务)多为通用页已产·delta 未移植

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 14:53:29 +08:00

8.2 KiB
Raw Blame History

EIP4 迁移项目 — 文档索引与状态总览

维护日期:2026-06-17 | 本文是 docs/ 的唯一入口与状态权威。 被取代的历史状态/审计快照已移入 归档/。

为什么需要本文:项目历史上随方法论演进(源码 parity → 宣称交付 → 数据驱动重审 → XML 审计 → engineclass Java delta)产出了多份「framework 视图状态/parity」文档,结论互相冲突——尤其 归档/framework系统管理视图-实现交付报告(宣称「16 视图已交付」)是「以为做了很多」错觉的来源,实为 demo 级、未逐功能验收。以本文 + 下方两份现行权威为准,其余归档勿再据以判断进度。


0. 一句话现状

横向地基铺得较全(转换器通用能力 / 保真层 / 审批基础设施 / 写路径 / 机制①),但纵向"按系统模块做到 parity 验收"目前只有「用户管理」1 个完成。其余 ~45 个 framework 定制视图 + 业务模块,多处于"转换器产出了通用页、但 engineclass 的 Java 定制 delta 未移植 / 未逐功能验收"。详见 §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 未移植
流程/审批 待办/已办/我的发起任务 🟠 通用列表页在但工具栏空;「查看详细/处理」按钮未接(审批基础设施 🔵 已就绪,缺列表入口接线)
流程/审批 查看审批/流程监控/流程定义/审批表单删除 ❌🟠 查看审批=bespoke 未起步;流程定义=Flowable Modeler 另案
消息/邮件 收到/已发送消息、短消息 🟠 列表页在(有删除);查看弹窗/发送/已读联动未接
消息/邮件 电子邮件全家桶(收件箱/发件箱/配置) ❌ 等同独立 webmail 子系统,另案立项
picker 控件 用户选择框×4 / 流程选择框 ❌ bespoke 穿梭框(机制④自定义组件),审批/表单/短消息全链路依赖,keystone
日志/历史 系统日志/登录历史/登录操作 🟠 通用页在;删除按钮(systemLogManager)未接
其它 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 子表递归。
  • 机制① EngineclassDelta:engineclass FQN → 工具栏按钮注册表(移植 new-button 的复用骨架)。
  • 审批基础设施:后端 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定制视图-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定制视图-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 = picker 全家(机制④)/ 岗位·主岗位·查看菜单按钮组 / 查看审批 / 任务按钮 / 消息查看。
  • 主攻方向待拍板(候选:RBAC/组织模块组做到 parity | 全模块完成度审计 | 广度优先铺基线 | 任务/审批簇接线)。
  • 部署/重转/导入 recipe、踩坑见「用户管理-Delta移植」§4 与本仓 scripts/run-dev.sh。