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

16 KiB
Raw Blame History

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。