Files
eip4-platform/docs
zhengwr d3ec7581fd
Some checks failed
ci / build-test-parity (push) Has been cancelled
Merge origin/main (报表进度文档更新) into Modeler 设计文档
2026-06-26 09:42:45 +08:00
..

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

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

进度权威看这份:项目进度与路线-总览-2026-06-21.md(A/B 矩阵 + 06-17→06-21 增量交付 + 下一步 + 待拍板决策)。本 README 只做「文档地图 + 模块完成度」,进度细节以总览为准。

为什么需要本文:项目历史上随方法论演进(源码 parity → 宣称交付 → 数据驱动重审 → XML 审计 → engineclass Java delta → 人走五环低代码平台 / AI 确定性生产线)产出了多份状态文档,结论可能互相冲突。以本文 + 总览-2026-06-21 + 下方现行权威为准,归档/历史目录勿再据以判断进度。


0. 一句话现状(2026-06-21)

横向地基铺得较全(转换器通用能力 / 保真层 / 审批基础设施 / 写路径 / 机制① / 元数据+写真相门禁);A 兼容线纵向「按模块做到 parity 验收」目前只有「用户管理」1 个完成,framework 其余约 38 视图待写、业务 106 视图是最大未动块;B 新能力线本期破局——「人走五环建新功能」低代码平台 v1 全链交付合 main、设计器选型(amis-editor)拍板 + DesignerPage 全闭环、AI 确定性五环生产线合 main。仍在 dev,生产上线(A10)未起步。

06-17→06-21 增量(详见总览 §2):人走五环后端全链 + 前端编排壳/建模器、DesignerPage 闭环(解除 P1 头号阻塞)、主子表四件套、AI 五环生产线合 main + 写路径对齐、附件双态、framework P2 移植一批。两仓 origin/main 已 push(platform 75f942b / web d1fd6ed)。


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)
元数据/平台工具 功能模板下载 / 实体分类-枚举组 ✅ 已核对验收
流程/审批 待办/已办/我发起的任务 🟡 列表/查看/处理抽屉/审批历史抽屉已浏览器验收;缺最终同意/拒绝点击验、列表入口按钮接线
流程/审批 查看审批/流程监控/流程定义/BPMN 图 ❌🟠 监控部分移植;流程定义 = Flowable Modeler 另案(B3);客户 BPMN 部署 = 前置①
消息/邮件 收到/已发送消息、短消息 🟠→🟡 短消息发送 + 消息详情已移植(16393c1 等);已读联动未接
消息/邮件 电子邮件全家桶(webmail) ❌ 独立子系统,另案立项(A5)
picker 控件 用户选择框×4 / 流程选择框 🟡 已切回标准 amis picker(单/多选靠 multiple),数据源 /api/picker/<dialogid>/list;流程选择框接 transfer-picker。已烟测,待真实业务保存/权限验收
日志/历史 系统日志/登录历史 🟡 删除按钮组 + real-first 列表 + 时间段过滤已通;剩登录操作列表此库缺视图
其它 bespoke 个人设置/工作日历/报表 🟠❌ 工作日历已移植;个人设置/报表(A3)未起步

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 双层制架构 / 工程结构 / 选型 / 红线(架构基线)
迁移手册.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,状态随里程碑回写)
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 已被取代 被 06-21 总览取代(顶部已加横幅)
README.md(本文) 现行·权威 文档地图 + 模块完成度
架构设计、迁移手册 现行·权威 架构基线
plans/2026-06-19-EIP4开发平台-架构方向-design 现行·权威 方向 D1-D7
plans/2026-06-20-人走五环建新功能-NocoBase式-design 现行·权威 主特性设计
plans/2026-06-19-EIP4开发平台-落地执行路线图 现行·活路线图 里程碑状态已回写本期进展
plans/2026-06-20-人走五环建新功能-实施计划 现行(执行已收尾) 24 TDD 任务全完成 + 合 main(顶部已加横幅)
AI_AGENT_AUTO_DEVELOPMENT / PAGE_BLUEPRINT_CONTRACT / REPAIR_CONTRACT / Nocobase_ADOPTION_PLAN / Nocobase_SOURCE_REVIEW 现行·权威 AI 契约族;前 4 份正文个别过时点已加横幅
skills/(eip4-ai-feature-development / env-manage / release-manage) 现行·权威 AI Agent Skills 目录
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-14-onEvent脚本挂回修复-plan 已完成·归档候选 onEvent seq 映射已修上线
plans/2026-06-14-提交审批桥接-design 已完成·归档候选 processCoreService 桥已端到端实证
plans/2026-06-14-新闻管理垂直切片-plan 已完成·归档候选 新闻收藏已修上线
plans/2026-06-15-菜单维护树模式重建与树选择框修复-plan 已完成·归档候选 菜单树/树选已修 live 验收
plans/2026-06-16-WfTemplate驱动审批界面-完整实现方案 已完成·归档候选 Phase0-4 全做完(仍可作机制参考)
CRUD-QA-发现与剩余-2026-06-14 已完成·归档候选 单次 dogfooding,多数缺口已处理(被通用模板收口引用,移动前先改引用)
C3压测基线 / C5构建预演报告 已完成·归档候选 M0 一次性本地基线/构建预演(被 M0交付/M0剩余项登记 引用)
归档/(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⑤ 已实施 + 对抗审查 + 全验证(见总览 §9;提交于分支 feat/p0p1-impl,未 push)。

  • 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 立项 / 附件 A4 补完 / 生产上线 A10 / 生产级 UI B4 补完。

  • 待拍板(总览 §6):153 终判三选一、②面 AI/内置 LLM 立项、type100/101 死页停转或留、onEvent 面板自动化率边界、对外口径统一、webmail 是否纳入本期。

  • 部署/重转/导入 recipe、踩坑见「用户管理-Delta移植」§4 与本仓 scripts/run-dev.sh。