- docs/新人上手.md:第一天路径(前置软件/取码/构建/eip4dev/起服务/前端/必读序/高频坑/红线) - CONTRIBUTING.md:分支命名/--no-ff 合并/提交格式/质量门(TDD+全 reactor 绿+作者评审分离+转换器重转重导)/CI 现状/文档归档纪律(两仓通用) - docs/README.md §2 登记两份新文档 配套(仓外):工作区根 README 刷新至 07-02(原停 06-11);eip4-web README 联调指引修正另仓提交;两仓本地已合并分支清理(platform 40/web 7,含 ai-agent worktree)+远端 8 个已合并分支删除 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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/ webd1fd6ed)。
06-22→06-26 增量(详见总览 §10/§11 与 A2/A3 行):安全基线 P0 全收口(RCE/fail-open/asUser 越权/CI 孤儿 + 2 孪生 + Groovy 沙箱,platform
eba9ce1/ web2a37251);报表 A3 JOR 重宿主 + 安全/OOM 收口 🟢(总览 §11);审批闭环补齐(协办/转阅/BPMN 流程图/会签/会签进度,c95eaee);A10 W1-W4 骨架(Flywayf7675c9+ deploy97a0eb1);稳定性三件套 + 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/ webd1fd6ed)。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 保真、搜索时间段过滤、
_SEARCHreal-first 流解析。 - 机制①
EngineclassDelta:engineclass FQN → 工具栏按钮注册表 + 整页改写器。 - 审批基础设施:
ApprovalController/TodoController/ApprovalDrawer.tsx/ WfTemplate 驱动审批(缺列表入口接线)。 - 保真层/写路径:JUEL 跨流条件求值、增删改查 + 提交审批桥(ProcessCoreServiceBridge)、
PageSchemaWriter单一写真相(M3ad3b8846)、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 拍定,下一步 plan→实现) |
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。