Files
eip4-platform/docs/决策与盘点/EIP4前端与收尾实施计划.md
zhengwr 1b69f8b481
Some checks failed
ci / build-test-parity (push) Has been cancelled
docs: 统一项目文档进 eip4-platform/docs + 新增进度路线总览
- 从工作区根 docs/(非 git,未版本化)合并全部文档进版本控制,消除文档两头分裂
- 新增 README(状态总览+模块完成度+全文档索引)、项目进度与路线-总览-2026-06-17(A兼容/B新功能+关键路径+待拍板决策)
- 被取代的冲突状态/审计快照归入 归档/;对最易误导的两份("16视图已交付"实现交付报告、06-13架构快照)加"已归档"横幅
- 现行权威:engineclass移植backlog(46视图) + 用户管理Delta移植(方法论/交接) + 组件设计体系 + 通用模板收口 + 客户沟通
- 诚实口径:纵向模块仅用户管理 parity,横向引擎地基较全,余 153 定制视图(47 framework+106 业务)多为通用页已产·delta 未移植

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 14:53:29 +08:00

9.9 KiB
Raw Permalink Blame History

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&currentSchema=eip3(ceshi 库是不完整副本,禁用)