# EIP4 前端与收尾实施计划(F 阶段) > 日期:2026-06-11 > 性质:P4 收口后的后续开发计划,接力《EIP3工程化实施计划.md》(PoC→P4 已全部完成) > 现状基线:只读切流端到端链路已闭合(见 `docs/P1/P4收口简报.md`);本计划覆盖前端成品化、写路径、脚本收尾、低代码工具链与模块化/升级架构 > 已拍板:原型缺失场景由 Claude Code 自行设计实现,不再走 claude-design(2026-06-11) --- ## 一、现状基线(一段话) PoC/M0/P0'/P1/P2/P3/P4 全部技术阶段完成:元数据/权限/组织/流程后端移植并对拍通过,1,516 模板批量转换闸一 98.2%(1,489 产物入 SYS_PAGE_SCHEMA),1,427 条脚本全量产出(自动化率 81.2%),Flowable 升级链可用,eip4-web 具备登录/待办/页面渲染三页脚手架。本地开发库 eip4dev 已建成(2.7GB,dev profile,8093),5435 收敛为对拍真值/性能基线/刷新源。剩余技术工作全部在前端成品化与三类收尾上;非技术依赖(S1 决策、检查点评审、商务开放项)单列第七节。 ## 二、阶段总览 | 阶段 | 主题 | 核心出口判据 | 门控 | |------|------|--------------|------| | F1 | 应用壳 + 只读完整体验 | 全量 1,489 schema 页可浏览,壳层成品 | 无(可立即开工) | | F2 | 写路径闭环 + 脚本三缺口 | 首个模块(oa)真实可用 | 无 | | F3 | 153 重写 + 报表四类 | 重判清单交付(重写23/降级97/留旧30/废弃3) | **S1 止损评审会三选一** | | F4 | 低代码工具链 L1→L3 | 设计器存盘走标准/overlay 双层协议 | 无(架构已拍板) | F1/F2 串行为主;F4-L1(editor 二开)可与 F2 并行;F3 随 S1 决策落地后插入。 ## 三、F1:应用壳 + 只读完整体验 目标:支撑检查点②只读切流的「产品级」前端。 1. **壳层直接迁移 claude-design 原型**(评审结论:75 分,沿用不重设计): - 迁移源:`claude-design-设计输入包/EIP4架构原型/eip4/{frame,ui,app}.jsx` - 迁移件:顶栏/三级侧栏/多 Tab 工作区/全局搜索(frame.jsx)、Icon/Dialog/Drawer/Toast/分页等基础组件(ui.jsx)、CSS 变量主题四维可调(app.jsx)、工作台首页与待办中心(screens-home.jsx) - 业务页(M1/M2/M7 等)原型仅作视觉基准,落地一律走 amis schema,不照搬 React 原生写法 2. **schema 页全量接入**:菜单树(按权限裁剪)→ /api/page/schema/{id} 全量可达;937 个依赖 picker 的模板验证选择窗链路 3. **framework 系统管理页**:用户/角色/菜单/数据权限维护界面(后端能力 P2 已有,纯前端补齐) 4. **原型缺失场景自行设计**(已拍板不走 claude-design):用户-角色-菜单三维权限分配页、数据字典管理、消息中心;遵守 amis 边界(列冻结/日历多事件不可用,见设计输入包 02 约束) 出口判据:真实账号登录 → 菜单全量可浏览 → 任一 schema 页渲染取数(行级权限生效)→ 待办跳转业务页,playwright 回归全绿。 ## 四、F2:写路径闭环 + 脚本三缺口 目标:第一个模块端到端真实可用(建议 oa 先行,见第五节顺序)。 1. **CRUD 写闭环**:amis form 提交 → 元数据写路径(含校验/数据权限写侧判定)→ 审批办理动作 → 附件上传(P2 横切件已真实现,FTP→本地盘口径) 2. **脚本三缺口**(与写路径同期,因脚本联动多发生在表单编辑场景): - **WS3 函数库回迁**:GetServicesFunction 等约 2,600 行 Groovy 函数库目前仅 findCount 最小桩(迁移手册 §111);612 条 S3 中仅 296 条 facade-only 可直接跑,全量可用以此为前置 - **115 份人工作业单**(PARTIAL 30 + HARD 85,`tools/s3_rewriter/output/manual_workpackage/`):盘点口径 0.5–1 人月,上界 2.8 人月 - **FULL_AUTO 批量回归**:497 条目前仅 6 条集成挑样 + 2 模板端到端,需批量跑一遍 3. ProjectSwitchService 桩真实现(P2 遗留唯一桩) 4. **前端产品化工作线(2026-06-11 补充显式化,此前被折叠在后端任务里)**: - 审批办理 UI(办理/驳回/转办/意见/流程轨迹时间线)——oa 端到端前置 - 表单写体验闭环(后端校验错误→amis 行内展示/附件控件/保存反馈/403 友好提示) - 选择窗完整化(type101 树形/多选/搜索回填,937 模板依赖) - 系统管理写操作 + 用户组-角色-菜单三维分配页 - 消息中心与工作台通知(API+UI) - 后续:报表体验验证修缮(F3)、amis-editor 二开与 L2/L3(F4)、移动端(F5,原型 mobile.jsx 已有设计) - **2026-06-12 用户拍板:移动端(F5)后置不做适配;优先级=UI 基本操作全面正常(F2-17 操作级巡检清单)** 出口判据:oa 模块新建→审批→归档全链路真实数据闭环(含办理 UI,非仅 API);脚本批量回归报告产出。 ## 五、模块推进顺序与「完成」定义 策略:**只读横向铺开(F1 一次性全模块),写路径按模块纵向推进**。 写路径顺序及理由: 1. **oa**——审批/待办最通用,P3 流程链路已通,最先形成完整体验 2. **pm**——客户核心业务;性能优先实体 PM_CONTRACTBALANCE/PM_PAYMENTAPPLY 在此,索引/参数化改造同期做 3. **hr**——HR_ATTENDLOG 等大表多(923ms 问题实体),与流式改造合并 4. **dm**——最后 模块「完成」定义:该模块全部模板可用 + 脚本动作可重放 + 审批闭环 + 该模块 153 重写项交付。 ## 六、模块化授权与升级架构(已拍板 2026-06-11) > 6.1/6.2 已获认可,作为打包方式与 F4 设计器存盘协议的既定架构。 ### 6.1 模块授权:全量打包 + 运行时授权裁剪 - 不回 OSGi 动态装卸;所有客户同一 jar,license/配置驱动模块开关 - 三层一致裁剪:菜单不下发 / API 按模块前缀(HR_/PM_/OA_/DM_)拦截 403 / schema 接口不下发 - 模块内功能级授权沿用已移植的角色-菜单权限 + SYS_FILTERRULE 体系(P2 对拍 100%),不新发明 - 数据库全量建表不裁剪(未授权模块表空置),换取升级脚本对所有客户统一 ### 6.2 升级:标准/overlay 双层 + 版本化 DDL - 老 EIP3 教训:153 模板中 119 个带「五建/定制」,标准与定制混杂导致无法升级 - **SYS_PAGE_SCHEMA 加来源标记:标准产物层 + 客户 overlay 层**;升级时标准层整体替换,overlay 保留并提示 diff;设计器改页 = 自动落 overlay - DDL 增量 Flyway 版本化(P1 DDL 生成器产出纳入版本链);平台版本与各模块 schema 版本分记,升级工具先做兼容检查(推广 Flowable Runbook 思路) ### 6.3 无定制代码功能的在线导入发布(方向成立,细化设计随 F4) - **结论:可行**。无定制 Java 代码的功能 = 纯元数据资产包(实体定义+DDL+页面 schema+改写后脚本+流程 BPMN+菜单/权限配置),全部以 DB 行/Flowable 部署形态存在,理论上不停机导入发布——这是元数据驱动架构相对老 OSGi 热插拔的等价红利 - **四个前置条件**: 1. **缓存失效闭环**:~~须先修~~ **复核后确认 P1-4 已整体闭环**(迁移手册 §5.20:`PoInfoCacheInvalidator.evictByTable` 解决冷态 id_cache 问题,接入 MetaController + `POST /api/meta/evict/{table}` 运维出口,8086 实测不重启生效);在线发布只需导入器在发布动作里调用该失效出口,验收判据仍为「导入后无需重启生效」 2. **DDL 只允许加法在线**:新建表/加列在线执行;改列/删列等破坏性变更一律走升级窗口(锁表与数据迁移风险) 3. **脚本导入安全纪律**:包内 Groovy 随导入入服务端产物库,按 templateId/seq 引用执行(沿 P4-5 无注入面口径),禁止任何前端直传脚本文本路径;导入包建议签名+导入审核 4. **落层与依赖校验**:导入包必须标记落「标准层」或「客户 overlay 层」(衔接 6.2);导入前校验依赖的实体/枚举/picker 存在性,导入事务原子可回滚;发布建议草稿→发布两态(SYS_PAGE_SCHEMA 已有 ETag,可扩 status) - 实装排期:包格式定义与导入器随 F4-L1 设计器一并做(设计器「另存为包」与「导入包」同一套协议) ## 七、F3 / F4 与外部依赖 ### F3:153 重写 + 报表四类(门控:S1 评审会) - 源码已定位(`/Users/zhengwr/workspace/EIP-3.0`,152/153 匹配),重判 7.56 人月、硬成本 3.57 逼近止损线 - 评审会三选一:分期 / 第三方组件 / 扩预算——**这是唯一卡技术线的外部决策** ### F4:低代码工具链(L1→L3,设计器非切流前置) - **L1 页面设计器**:amis-editor 二开(amis-fork 已在 workspace);二开点 = 数据源对接元数据实体、存盘走 6.2 双层协议、32 个 facade 动词的 onEvent 配置面板。可与 F2 并行 - **L2 实体建模器**:可视化维护 SYS_ENTITY/属性/枚举/过滤规则(后端 P1 已有,纯界面) - **L3 流程设计器**:bpmn.js + Flowable 部署接口;短期新流程用 Flowable Modeler 顶 ### 外部/人工依赖清单(不卡 F1/F2 开工) S1 止损评审会(卡 F3)、检查点①②评审、商务开放项 1/3、JOR 文件系统侧清点、11 个引擎缺陷旧系统同病验证、58 个零引用视图老员工区分、27 空 XML 孤儿定性、EIP-3.0↔目标客户版本对应确认。 ## 八、环境口径 - 日常开发:localhost:5433/**eip4dev**(dev profile,8093);`tools/local-devdb/build_devdb.sh` 一键重建 - 5435(20.68)仅三用途:对拍真值基线 / 性能基线(3 巨表与 ACT_ 本地 schema-only,考勤/实名制/流程历史性能必须回 5435)/ eip4dev 刷新源 - 连 5435 必须 `dbname=postgres¤tSchema=eip3`(ceshi 库是不完整副本,禁用)