docs+javadoc: 文档-代码对抗核查对齐 + 归档候选物理归档

5 路并行核对总览 §9/§10/§11 + A/B 矩阵声明 vs 两仓代码(48 条 46 条完全一致,无虚报),修正不一致处:
- A10 行 🔴→🟡:W1 Flyway(V1-V3)+W2-W4 容器化/nginx/compose 骨架 06-25 已合 main,文档此前低报;§10.2 Flyway/compose 两条标 ✅
- §9 P0② 表格「同族扩长」与对抗审查①矛盾(代码一律拒 TYPE 变更)改齐
- §10.2 render-plan 行号迁 AiDraftGateValidator.java:246(SRP 拆分后位置)
- §11 报表单测 73→79;§2「五步编排壳」改四步向导
- CandidateUsersHandler 类级 javadoc:scriptUser 已于 06-26 接入(resolveScriptUsers),删「WARN 降级未接入」陈旧表述(纯注释零行为变更)

归档整理(总览 §8 归档候选落地):
- 10 份已完成/被取代文档 git mv 入 docs/归档/(06-14×3/06-15/06-16/06-20 plans、CRUD-QA、C3/C5、总览-06-17)
- 引用同步改路径:README 索引、M0剩余项登记、通用模板收口计划、架构方向-design、新闻管理plan
- README 刷新至 07-02:补 06-22→06-26 增量一节、审批/报表行状态、§2 补登 06-25/06-26 四份 design/计划、§4 过时「未 push」表述修正

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-02 08:01:23 +08:00
parent b4baca5d94
commit 1b02036153
16 changed files with 46 additions and 37 deletions

View File

@@ -1,6 +1,6 @@
# EIP4 迁移项目 — 文档索引与状态总览
> 维护日期:2026-06-21 | **本文是 `docs/` 的唯一入口与状态权威。** 被取代的历史状态/审计快照已移入 `归档/`。
> 维护日期:2026-07-02 | **本文是 `docs/` 的唯一入口与状态权威。** 被取代的历史状态/审计快照已移入 `归档/`。
>
> **进度权威看这份**:`项目进度与路线-总览-2026-06-21.md`(A/B 矩阵 + 06-17→06-21 增量交付 + 下一步 + 待拍板决策)。本 README 只做「文档地图 + 模块完成度」,进度细节以总览为准。
>
@@ -8,12 +8,14 @@
---
## 0. 一句话现状(2026-06-21)
## 0. 一句话现状(2026-07-02)
**横向地基铺得较全**(转换器通用能力 / 保真层 / 审批基础设施 / 写路径 / 机制① / 元数据+写真相门禁);**A 兼容线**纵向「按模块做到 parity 验收」目前只有「用户管理」1 个完成,framework 其余约 38 视图待写、**业务 106 视图是最大未动块**;**B 新能力线本期破局**——「人走五环建新功能」低代码平台 v1 全链交付合 main、设计器选型(amis-editor)拍板 + DesignerPage 全闭环、AI 确定性五环生产线合 main。仍在 dev,生产上线(A10)未起步。
**横向地基铺得较全**(转换器通用能力 / 保真层 / 审批基础设施 / 写路径 / 机制① / 元数据+写真相门禁);**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. 模块完成度(诚实口径)
@@ -31,13 +33,13 @@
| 元数据/平台工具 | 数据导入配置 / 定时任务「设置提醒人」 | 🟡 | `DataImportConfigController` / `ScheduleJobNotifyController` 已落(c9e4d35);调度运行时未起步 |
| 元数据/平台工具 | 脚本编辑器 / 工作日历 | 🟡 | framework P2 批次已移植(57c3412…d218c2b) |
| 元数据/平台工具 | 功能模板下载 / 实体分类-枚举组 | ✅ | 已核对验收 |
| 流程/审批 | 待办/已办/我发起的任务 | 🟡 | 列表/查看/处理抽屉/审批历史抽屉已浏览器验收;缺最终同意/拒绝点击验、列表入口按钮接线 |
| 流程/审批 | 查看审批/流程监控/流程定义/BPMN 图 | ❌🟠 | 监控部分移植;流程定义 = Flowable Modeler 另案(B3);客户 BPMN 部署 = 前置① |
| 流程/审批 | 待办/已办/我发起的任务 | 🟡→✅ | 列表/查看/处理抽屉/审批历史抽屉已验收;列表入口接线已 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)未起步 |
| 其它 bespoke | 个人设置/工作日历/报表 | 🟠→🟢 | 工作日历已移植;**报表 A3 已完成**(JOR 重宿主 + 安全/OOM 收口,总览 §11);个人设置未起步 |
> framework 定制视图共 46 个,逐视图清单见 **`framework定制视图-engineclass移植backlog-2026-06-17.md`**(主 backlog),当前执行队列见 **`framework定制视图-TODO-2026-06-17.md`**(活清单·三态)。
@@ -71,6 +73,10 @@
| `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/移植项/优先级) |
@@ -91,15 +97,15 @@
| 文档 | 状态 | 备注 |
|---|---|---|
| `项目进度与路线-总览-2026-06-21` | 现行·权威 | 进度唯一入口 |
| `项目进度与路线-总览-2026-06-17` | 已被取代 | 被 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开发平台-落地执行路线图` | 现行·活路线图 | 里程碑状态已回写本期进展 |
| `plans/2026-06-20-人走五环建新功能-实施计划` | 现行(执行已收尾) | 24 TDD 任务全完成 + 合 main(顶部已加横幅) |
| `归档/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/`(eip4-ai-feature-development / env-manage / release-manage) | 现行·权威 | AI Agent Skills 目录 |
| `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` | 现行·权威 | 方法论 + 交接 |
@@ -107,13 +113,8 @@
| `通用模板全类型可用性-…-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剩余项登记 引用) |
| `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/选择窗),保留备查 |
@@ -125,11 +126,12 @@
## 4. 下一步指引
> 完整优先级排序见 `项目进度与路线-总览-2026-06-21.md` §5;**P0②/P1④/P1⑥/P1⑤ 已实施 + 对抗审查 + 全验证(见总览 §9;提交于分支 `feat/p0p1-impl`,未 push)**。
> 完整优先级排序见 `项目进度与路线-总览-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 立项 / 附件 A4 补完 / 生产上线 A10 / 生产级 UI B4 补完。
- **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`。