Files
eip4-platform/docs/README.md
zhengwr 6f5b1f7117 docs(plan): 在线流程Modeler(B3)实施计划——4阶段TDD任务
基于 06-26 design(D1-D9)+三路事实勘探(语料/后端/前端)合成:
- §0 事实基线:1512真实BPMN扩展面实测(11属性/5元素/中文key会签流)+后端(deploy无审计/sanitize单向/Model API零使用/网关超管判定现成)+前端(bpmn-js17已装/属性面板缺/admin门与测试范本)
- §0.5 计划级决策P1-P6:moddle自建vendored+语料双门/影响摘要节点级diff/3模板/草稿admin共见/EIP4控件走React侧板非preact/全量保真扫描做工具不进CI
- 阶段1 moddle保真+只读载入/阶段2 三控件+草稿/阶段3 发布门(校验+超管+同人确认+审计V4+id还原)/阶段4 新建+live e2e
- 验收清单8项+红线提醒(databaseSchemaUpdate=false/保真层不改/JDK解析器/部署门只落网关)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 09:13:02 +08:00

141 lines
16 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
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-07-02 | **本文是 `docs/` 的唯一入口与状态权威。** 被取代的历史状态/审计快照已移入 `归档/`。
>
> **进度权威看这份**:`项目进度与路线-总览-2026-06-21.md`(A/B 矩阵 + 06-17→06-21 增量交付 + 下一步 + 待拍板决策)。本 README 只做「文档地图 + 模块完成度」,进度细节以总览为准。
>
> **为什么需要本文**:项目历史上随方法论演进(源码 parity → 宣称交付 → 数据驱动重审 → XML 审计 → engineclass Java delta → **人走五环低代码平台 / AI 确定性生产线**)产出了多份状态文档,结论可能互相冲突。**以本文 + 总览-2026-06-21 + 下方现行权威为准,归档/历史目录勿再据以判断进度。**
---
## 0. 一句话现状(2026-07-02)
**横向地基铺得较全**(转换器通用能力 / 保真层 / 审批基础设施 / 写路径 / 机制① / 元数据+写真相门禁);**A 兼容线**纵向「按模块做到 parity 验收」目前只有「用户管理」1 个完成,framework 其余约 38 视图待写、**业务 106 视图是最大未动块**;**B 新能力线本期破局**——「人走五环建新功能」低代码平台 v1 全链交付合 main、设计器选型(amis-editor)拍板 + DesignerPage 全闭环、AI 确定性五环生产线合 main。仍在 dev;**A10 MVP 骨架(Flyway + 容器化/nginx/compose)已合 main(06-25),切流未执行**。
> **06-17→06-21 增量**(详见总览 §2):人走五环后端全链 + 前端编排壳/建模器、DesignerPage 闭环(解除 P1 头号阻塞)、主子表四件套、AI 五环生产线合 main + 写路径对齐、附件双态、framework P2 移植一批。两仓 origin/main 已 push(platform `75f942b` / web `d1fd6ed`)。
> **06-22→06-26 增量**(详见总览 §10/§11 与 A2/A3 行):安全基线 P0 全收口(RCE/fail-open/asUser 越权/CI 孤儿 + 2 孪生 + Groovy 沙箱,platform `eba9ce1` / web `2a37251`);报表 A3 JOR 重宿主 + 安全/OOM 收口 🟢(总览 §11);审批闭环补齐(协办/转阅/BPMN 流程图/会签/会签进度,`c95eaee`);A10 W1-W4 骨架(Flyway `f7675c9` + deploy `97a0eb1`);稳定性三件套 + actuator + ArchUnit 6 条 + AiAgentService SRP 拆分;G1-G3 外部 agent 接入(`eip4 init`/platform-mcp/7 skills);在线流程 Modeler design 拍定 D1-D9(`d3ec758`)。06-26 后至 07-02 无代码增量(本次为文档对齐与归档)。
---
## 1. 模块完成度(诚实口径)
档位:✅ parity 完成(逐功能验收过)| 🟡 demo 级(有页/端点未 parity 验收)| 🟠 通用页已产·engineclass delta 未移植 | ❌ bespoke 未起步 | 🔵 横向能力 | 🆕 本期新能力
### 1.1 纵向(系统模块 / framework 定制视图)
| 模块组 | 代表视图 | 档位 | 备注 |
|---|---|---|---|
| **用户管理** | 用户管理 | ✅ | 列表/设置主岗位/查看菜单/主部门主岗位树选/picker 显名/filterscript 级联,逐字段 dogfood 验收(`bf7bb25/0d6fab4/17c449c`)。剩:编辑页 org picker 查询条件、导出 Excel |
| RBAC/组织 | 用户组/角色/菜单维护/部门/数据权限授权 | 🟡 | CRUD 端点 + amis 后台页已建,demo 级未对照旧版逐功能验收 |
| RBAC/组织 | 岗位管理/分公司岗位管理 | 🟠 | 通用页在;engineclass「设置(岗位↔用户 picker)」未移植 |
| 元数据/平台工具 | 实体/服务流/视图管理/功能管理/自动编号 | 🟠 | 通用页在;重写服务/设计器/脚本编辑器重度 delta 未移植 |
| 元数据/平台工具 | 数据导入配置 / 定时任务「设置提醒人」 | 🟡 | `DataImportConfigController` / `ScheduleJobNotifyController` 已落(c9e4d35);调度运行时未起步 |
| 元数据/平台工具 | 脚本编辑器 / 工作日历 | 🟡 | framework P2 批次已移植(57c3412…d218c2b) |
| 元数据/平台工具 | 功能模板下载 / 实体分类-枚举组 | ✅ | 已核对验收 |
| 流程/审批 | 待办/已办/我发起的任务 | 🟡→✅ | 列表/查看/处理抽屉/审批历史抽屉已验收;列表入口接线已 live(228 页 openApprovalDrawer);协办/转阅/会签/会签进度/approve 默认「同意」意见 06-26 补齐。剩客户 BPMN 真实流转(外部前置①) |
| 流程/审批 | 查看审批/流程监控/流程定义/BPMN 图 | 🟡 | 监控(撤回/结束/高级)已 live;BPMN 流程图**查看**已做(ProcessDiagramController + bpmn-js,中文 id 净化);流程定义**编辑**=Modeler 另案(B3,design 已拍定 D1-D9);客户 BPMN 部署=前置① |
| 消息/邮件 | 收到/已发送消息、短消息 | 🟠→🟡 | 短消息发送 + 消息详情已移植(16393c1 等);已读联动未接 |
| 消息/邮件 | 电子邮件全家桶(webmail) | ❌ | 独立子系统,另案立项(A5) |
| picker 控件 | 用户选择框×4 / 流程选择框 | 🟡 | 已切回标准 amis `picker`(单/多选靠 `multiple`),数据源 `/api/picker/<dialogid>/list`;流程选择框接 `transfer-picker`。已烟测,待真实业务保存/权限验收 |
| 日志/历史 | 系统日志/登录历史 | 🟡 | 删除按钮组 + real-first 列表 + 时间段过滤已通;剩登录操作列表此库缺视图 |
| 其它 bespoke | 个人设置/工作日历/报表 | 🟠→🟢 | 工作日历已移植;**报表 A3 已完成**(JOR 重宿主 + 安全/OOM 收口,总览 §11);个人设置未起步 |
> framework 定制视图共 46 个,逐视图清单见 **`framework定制视图-engineclass移植backlog-2026-06-17.md`**(主 backlog),当前执行队列见 **`framework定制视图-TODO-2026-06-17.md`**(活清单·三态)。
### 1.2 业务模块(pm/hr/oa/dm 的 106 个定制视图)
另一条线,源码在 `EIP-3.0` 仓(3.1G),**基本未动 = A 兼容线最大块**。处置口径卡 S1 止损评审(见总览 §6 待拍板①)。
### 1.3 🆕 本期新能力(人走五环 / AI / 设计器)
- **人走五环建新功能 v1**:NocoBase 式建模器 + 实时设计器,五环(元数据→表→设计→实现→发布)+ AI①面入口 + 主子表四件套,全链交付合 main(platform `75f942b` / web `d1fd6ed`)。v1 限简单 CRUD/树 recipe + 只建新不改表。设计权威:`plans/2026-06-20-人走五环建新功能-NocoBase式-design.md`。
- **B1 设计器**:amis-editor 选型拍板(D1);DesignerPage 全闭环上线(`2278cbc` 等),原 P1 头号阻塞解除。
- **B2 AI 模块**:确定性(非 LLM)五环增量生产线合 main,终点恒人审、平台不内置生成 LLM;契约见 `AI_AGENT_*.md` + `skills/`。
### 1.4 🔵 横向能力(已就绪,跨模块共用)
- 转换器通用能力:navigation 按钮、type=101 树选、picker 显名、filterscript 级联、colspan 栅格、A0 控件、EditGrid 子表递归、树编辑 layout 保真、搜索时间段过滤、`_SEARCH` real-first 流解析。
- 机制① `EngineclassDelta`:engineclass FQN → 工具栏按钮注册表 + 整页改写器。
- 审批基础设施:`ApprovalController` / `TodoController` / `ApprovalDrawer.tsx` / WfTemplate 驱动审批(缺列表入口接线)。
- 保真层/写路径:JUEL 跨流条件求值、增删改查 + 提交审批桥(ProcessCoreServiceBridge)、`PageSchemaWriter` 单一写真相(M3a `d3b8846`)、PG/Flowable 升级。
- AI 门禁五件套:page-recipe / typed-page-schema / amis-schema / local-smoke / render-plan(已接 putOverlay,只严格约束 AI 草稿)。
---
## 2. 现行权威文档(看这几份就够)
| 文档 | 用途 |
|---|---|
| **`项目进度与路线-总览-2026-06-21.md`** | **全项目进度权威**:A/B 矩阵 + 增量交付 + 下一步 + 待拍板决策 |
| `新人上手.md` | 新成员第一天路径(环境→起服务→验证→必读序→高频坑→红线) |
| `../CONTRIBUTING.md` | 分支/合并/提交/质量门/文档纪律约定(两仓通用) |
| `架构设计.md` | 双层制架构 / 工程结构 / 选型 / 红线(架构基线) |
| `迁移手册.md` | 双层制纪律 + 踩坑四栏制(知识转移手册) |
| `plans/2026-06-19-EIP4开发平台-架构方向-design.md` | 开发平台方向级 design(锁定 D1-D7) |
| `plans/2026-06-20-人走五环建新功能-NocoBase式-design.md` | 主特性「人走五环」设计定型 |
| `plans/2026-06-19-EIP4开发平台-落地执行路线图.md` | 活路线图(M0-M8,状态随里程碑回写) |
| `plans/2026-06-25-A10-生产上线工程化-design.md` | A10 生产化 design(D1-D6 待拍板;W1-W4 骨架已合 main) |
| `plans/2026-06-25-报表迁移-JOR引擎重宿主-design.md` | 报表 A3 设计(Phase1-3 已完成 + 安全收口,总览 §11) |
| `plans/2026-06-25-审批闭环-实施计划.md` | 审批闭环 P0-P3(已实施合 main `c95eaee`,剩外部前置) |
| `plans/2026-06-26-在线流程Modeler-design.md` | B3 流程 Modeler 设计(D1-D9 拍定) |
| `plans/2026-07-02-在线流程Modeler-实施计划.md` | B3 实施计划(4 阶段 TDD 任务,含语料/代码勘探基线 + P1-P6 计划级决策,**执行中**) |
| `AI_AGENT_AUTO_DEVELOPMENT.md` + `AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md` / `AI_AGENT_REPAIR_CONTRACT.md` / `AI_AGENT_Nocobase_ADOPTION_PLAN.md` + `skills/` | AI Agent 对外口径红线 + 编译/修复/采纳契约 + Skills 目录 |
| `framework定制视图-TODO-2026-06-17.md` | A 兼容线**活清单**(Done/In-Progress/待验三态),每次修完回写 |
| `framework定制视图-engineclass移植backlog-2026-06-17.md` | 46 framework 视图迁移**主 backlog**(verdict/移植项/优先级) |
| `用户管理-Delta移植-实现过程与踩坑-2026-06-17.md` | engineclass Delta 移植方法论 + 机制① + 踩坑(首个端到端案例 + 交接) |
| `通用模板全类型可用性-通盘盘点与收口计划-2026-06-16.md` | **通用模板**(~1363)覆盖与收口(与定制视图两条线) |
| `组件设计体系-design-2026-06-15.md` | 全站 UI/UE 组件设计体系(落地状态以总览 B4 为准) |
| `客户沟通清单v1.md` | 商务/客户侧依赖卡点 |
| `决策与盘点/EIP3架构决策{报告,会纪要}.md` | 奠基性决策 + 对外口径红线来源 |
| `P0-PG升级/`、`P3-Flowable升级/` | PG / Flowable 升级 runbook(生产切流执行依据) |
| `研究/` | 服务流分派、通知保存老vs新机制 trace(专题研究) |
---
## 3. 全文档索引(含状态分级)
状态:现行·权威 | 现行 | 活清单 | **已完成·归档候选**(一次性 plan/报告,已落地,可后续 `git mv` 入 `归档/`)| 已归档 | 历史
| 文档 | 状态 | 备注 |
|---|---|---|
| `项目进度与路线-总览-2026-06-21` | 现行·权威 | 进度唯一入口 |
| `归档/项目进度与路线-总览-2026-06-17` | 已归档(07-02) | 被 06-21 总览取代 |
| `README.md`(本文) | 现行·权威 | 文档地图 + 模块完成度 |
| `架构设计`、`迁移手册` | 现行·权威 | 架构基线 |
| `plans/2026-06-19-EIP4开发平台-架构方向-design` | 现行·权威 | 方向 D1-D7 |
| `plans/2026-06-20-人走五环建新功能-NocoBase式-design` | 现行·权威 | 主特性设计 |
| `plans/2026-06-19-EIP4开发平台-落地执行路线图` | 现行·活路线图 | 里程碑状态已回写本期进展 |
| `归档/2026-06-20-人走五环建新功能-实施计划` | 已归档(07-02) | 24 TDD 任务全完成 + 合 main |
| `AI_AGENT_AUTO_DEVELOPMENT` / `PAGE_BLUEPRINT_CONTRACT` / `REPAIR_CONTRACT` / `Nocobase_ADOPTION_PLAN` / `Nocobase_SOURCE_REVIEW` | 现行·权威 | AI 契约族;前 4 份正文个别过时点已加横幅 |
| `skills/`(7 份:ai-feature-development / data-modeling / page-recipe / acl-manage / amis-pitfalls / env-manage / release-manage) | 现行·权威 | AI Agent Skills 目录(`eip4 init` 渲染分发,G1/G3) |
| `framework定制视图-TODO-2026-06-17` | 现行·活清单 | 执行队列 |
| `framework定制视图-engineclass移植backlog-2026-06-17` | 现行·权威 | framework 主 backlog(开头有 agent 思考噪声待清) |
| `用户管理-Delta移植-…-2026-06-17` | 现行·权威 | 方法论 + 交接 |
| `组件设计体系-design-2026-06-15` | 现行(落地状态见总览 B4) | 顶部已加横幅 |
| `通用模板全类型可用性-…-2026-06-16` | 现行 | 通用模板线(§七运行库现状需复核) |
| `客户沟通清单v1` | 现行 | 商务线(部分卡点随本期交付已消解) |
| `决策与盘点/`(架构决策报告/会纪要/客户库盘点/源码预核查/报表迁移方案/EIP4前端实施计划) | 现行·权威 + 历史盘点混放 | 决策报告/会纪要 = 现行权威红线来源;06-10 一次性盘点报告(源码预核查/客户库盘点/报表迁移方案)= 历史 |
| `plans/2026-06-24-生成式OS数据驾驶舱-design` | 指针存根 | 方案已迁独立仓 `genos-cockpit`(权威在彼仓 docs/design/) |
| `归档/`(06-14 onEvent修复/提交审批桥接/新闻管理、06-15 菜单维护、06-16 WfTemplate方案、CRUD-QA-06-14、C3压测基线、C5构建预演) | 已归档(07-02) | 一次性 plan/报告,均已落地;引用处已同步改路径 |
| `归档/`(framework parity/交付报告/数据驱动重审/转换页审计/EIP4-架构与缺口现状-06-13/转换器覆盖度审计-06-13/F2-12/F2-17 三件套/未完成工作清单) | 已归档 | 历史快照,**勿据以判进度** |
| `M0交付/`(153 处置清单 v1 / 153 终判证据包 / M0 剩余项登记) | 历史 | M0 阶段交付,已被 engineclass backlog + 终判取代 |
| `P1/`(F1/F2-x/F3/F4/P1-P4 简报 共 ~22 份) | 历史 | 阶段交付简报(部分已被后续重做取代,如审批 UI/选择窗),保留备查 |
| `决策与盘点/EIP3工程化实施计划` / `EIP3路线A-PoC执行方案` | 历史 | 早期工程化/PoC 方案 |
> eip4-web 仓另有 `docs/F1-4扫描报告.md`、`docs/P4脚手架报告.md`(06-11 一次性早期快照,建议 web 仓建 `docs/归档/` 归入)。
---
## 4. 下一步指引
> 完整优先级排序见 `项目进度与路线-总览-2026-06-21.md` §5;P0②/P1④/P1⑥/P1⑤ 已实施 + 对抗审查 + 全验证,**已合 main 并 push**(总览 §9);安全基线 P0(§10.1)、报表 A3(§11)、审批闭环(A2)、A10 骨架均已收口/落地。
- **P0**:① 文档对齐 ✅;② AI 门禁余项 —— 引擎 ALTER 安全通道 ✅ / 安全门 enforced ✅ / overlay 审计端点 ✅;存量 overlay 白名单 strict 化推进 待续。
- **P1**:③ framework 业务 106 视图 —— **双重阻塞:卡 S1 止损评审 + EIP-3.0 源码本地未克隆,无法分析迁移**;④ 人走五环 v2 改表加列 ✅(recipe 扩面 M7 待续);⑤ 流程审批列表入口 e2e ✅(真实流转依赖客户 BPMN、BPMN 图另案);⑥ 运行时 DELETE ✅ + publish 菜单授权 ✅(部署包下沉统一待续,已查两生成器现逻辑等价无 bug)。
- **P2**:~~报表 A3 立项~~(✅ 已完成,总览 §11)/ 附件 A4 补完 / 生产上线 A10 落地执行(骨架已建,剩切流/性能/灰度 + Gitea act_runner 注册)/ 生产级 UI B4 补完。
- **进行中方向**:B3 流程 Modeler(design 已拍定,待 plan→实现);报表作者化 WEB 设计器 + Agent 设计报表(目标已立,待 brainstorm→design)。
- **待拍板**(总览 §6):153 终判三选一、②面 AI/内置 LLM 立项、type100/101 死页停转或留、onEvent 面板自动化率边界、对外口径统一、webmail 是否纳入本期。
- 部署/重转/导入 recipe、踩坑见「用户管理-Delta移植」§4 与本仓 `scripts/run-dev.sh`。