Some checks failed
ci / build-test-parity (push) Has been cancelled
- 从工作区根 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>
97 lines
8.2 KiB
Markdown
97 lines
8.2 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。
|
||
|
||
---
|
||
|
||
## 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`。
|