Files
eip4-platform/docs/README.md
zhengwr 5946afa6e6
Some checks failed
ci / build-test-parity (push) Has been cancelled
docs: 同步本会话进展到状态总览(real-first/树编辑布局/时间段过滤+Wave A两项)
README §0/§1.1/§1.3 更新:
- §1.3 横向能力新增 3 个全站通用保真修复(树编辑 <layout> 布局保真、搜索时间段
  过滤 date-range→DateTime[]、real-first 流解析)+ 机制①扩出整页改写器。
- §1.1 功能模板下载/枚举组 → ✅,日志组 → 🟡(删除按钮接+real-first修通+时间段通)。
- §0 加本会话进展提要(6 提交已 push origin/main)。

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

104 lines
10 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# EIP4 迁移项目 — 文档索引与状态总览
> 维护日期:2026-06-17 | **本文是 `docs/` 的唯一入口与状态权威。** 被取代的历史状态/审计快照已移入 `归档/`。
>
> **为什么需要本文**:项目历史上随方法论演进(源码 parity → 宣称交付 → 数据驱动重审 → XML 审计 → **engineclass Java delta**)产出了多份「framework 视图状态/parity」文档,结论互相冲突——尤其 `归档/framework系统管理视图-实现交付报告`(宣称「16 视图已交付」)是「以为做了很多」错觉的来源,实为 demo 级、未逐功能验收。**以本文 + 下方两份现行权威为准,其余归档勿再据以判断进度。**
---
## 0. 一句话现状
**横向地基铺得较全**(转换器通用能力 / 保真层 / 审批基础设施 / 写路径 / 机制①),但**纵向"按系统模块做到 parity 验收"目前只有「用户管理」1 个完成**。其余 ~45 个 framework 定制视图 + 业务模块,多处于"转换器产出了通用页、但 engineclass 的 Java 定制 delta 未移植 / 未逐功能验收"。详见 §1。
> **本会话进展(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 防重逻辑,无需移植 |
| 流程/审批 | 待办/已办/我的发起任务 | 🟠 | 通用列表页在但工具栏空;「查看详细/处理」按钮未接(审批基础设施 🔵 已就绪,缺列表入口接线) |
| 流程/审批 | 查看审批/流程监控/流程定义/审批表单删除 | ❌🟠 | 查看审批=bespoke 未起步;流程定义=Flowable Modeler 另案 |
| 消息/邮件 | 收到/已发送消息、短消息 | 🟠 | 列表页在(有删除);查看弹窗/发送/已读联动未接 |
| 消息/邮件 | 电子邮件全家桶(收件箱/发件箱/配置) | ❌ | 等同独立 webmail 子系统,另案立项 |
| picker 控件 | 用户选择框×4 / 流程选择框 | ❌ | bespoke 穿梭框(机制④自定义组件),审批/表单/短消息全链路依赖,**keystone** |
| 日志/历史 | 系统日志/登录历史/登录操作 | 🟡 | `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 列(零回归)。修「操作日志等时间段查不动」。
- **🆕 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定制视图-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`。