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

121 lines
9.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 库是不完整副本,禁用)