153 定制视图处置清单 v1
版本:v1.0(2026-06-10)| 性质:M0 决策会开放项,2 周限期交付
背景:客户库 view_template 表中 153 个模板带 engineclass 字段,硬编码 Vaadin Java 视图类,
自动转换器无法处理,必须逐个决策处置方式
重要声明:客户库测试副本(192.168.20.68:5435)在本文档编写时网络不可达(2026-06-10 实测),
完整 153 条 engineclass 映射需网络恢复后用第三节 SQL 一键拉取;
本文档为初判底稿,逐视图终判需项目负责人 + 老员工核定,客户书面确认后方生效。
一、三分判定标准(决策树)
对每个 engineclass 定制视图,按以下四维决策树判定处置方式:
三分定义
| 处置方式 |
定义 |
工期参考 |
技术路径 |
| 重写 |
用 React 自定义组件或 amis 自定义渲染器重新实现等价功能 |
2–4 人日/个(中高复杂度) |
React(集中外包)或 amis custom 类型渲染器 |
| 降级 |
用 amis 标准模板替代,接受 UI 差距,功能等价优先 |
0.5–1 人日/个(配置调整) |
走 P4 批量转换器,补充手工配置 |
| 留旧 |
保留在旧系统(EIP3)运行,进入长期过渡清单,随旧系统退役时间规划 |
登记成本(0.25 人日/个) |
切流期末批或不切流 |
预算敏感性分析(基于 1.5–3 人月预算)
| 场景 |
重写占比 |
降级占比 |
留旧占比 |
估算人月 |
预算判断 |
| 乐观 |
20%(31 个) |
30%(46 个) |
50%(76 个) |
31×3pd + 46×1pd = ~1.8 人月 |
✅ 预算内 |
| 基准 |
30%(46 个) |
30%(46 个) |
40%(61 个) |
46×3pd + 46×1pd = ~2.7 人月 |
✅ 预算内 |
| 悲观 |
40%(61 个) |
30%(46 个) |
30%(46 个) |
61×3pd + 46×1pd = ~3.5 人月 |
⚠️ 超 3 人月 → 触发 S1 止损 |
| 最悲观 |
50%(77 个) |
25%(38 个) |
25%(38 个) |
77×4pd + 38×1pd = ~5.2 人月 |
🔴 严重超支 → 强制扩大留旧 |
止损线:总工时估算 > 3 人月时,触发 S1(暂停重审),强制将重写候选中低优先级视图调整为留旧过渡,直至总估算回落至 3 人月以内。
二、已知视图类的初判
依据:客户库盘点报告第四节、EIP3 架构知识,按 engineclass 类名语义初判
精度声明:以下初判仅基于类名推断,未逐一阅读 Java 源码;终判需老员工确认实际功能
2.1 报表类视图 → 留旧(待 P4 报表方案)
| 类名模式 |
初判 |
理由 |
*ReportView、*报表View、*StatisticsView |
留旧 |
P4 有专项报表方案(A 类走转换器,B 类图表平移,C 类 JOR 替换);报表视图应归入对应报表类别,不单独重写 |
| JOR 布局相关视图 |
留旧 |
等待 M0 JOR 布局清点结果,归入 P4 C 类报表预算 |
2.2 管理类 CRUD 视图 → 降级候选
| 类名模式 |
初判 |
理由 |
UserManageView |
降级候选 |
用户管理本质是标准 CRUD + 权限位,amis crud + 表单可覆盖;需确认是否有特殊批量操作 |
*ManageView(一般管理类) |
降级候选 |
命名为"管理"的视图通常是标准 CRUD 列表,降级后功能等价;需逐一确认有无复杂批量操作或特殊权限逻辑 |
*ListView(纯列表类) |
降级候选 |
只读列表类,amis crud 标准渲染能力完全覆盖 |
2.3 流程监控类视图 → 重写候选
| 类名模式 |
初判 |
工时估算 |
理由 |
ProcessMonitorComponentNew |
重写候选 |
3–4 人日 |
流程监控需要实时状态展示、节点高亮、审批轨迹,属于高交互定制组件;amis 无标准近似物;P3 Flowable REST API 稳定后优先实现 |
*ProcessMonitor*、*WorkflowView |
重写候选 |
3–4 人日/个 |
同上 |
2.4 PDF 预览类视图 → 重写候选(或留旧)
| 类名模式 |
初判 |
工时估算 |
理由 |
*PdfPreviewView、*PdfView |
重写候选(优先)/ 留旧(备选) |
2–3 人日(重写) |
amis 有 iframe 和 pdf-viewer 组件,但如果原 Vaadin 实现有复杂签章/水印/打印控制,则应留旧等 P4 报表方案(Web 打印路线);需老员工确认 |
2.5 考勤打卡类视图 → 重写候选
| 类名模式 |
初判 |
工时估算 |
理由 |
*KaoqinView、*AttendView、*打卡View |
重写候选 |
3–5 人日/个 |
考勤打卡通常含设备对接、GPS 定位、照片上传等交互,属高复杂度;纯 Web 化重写需确认终端适配需求(PC/移动) |
2.6 数据导入/导出类视图 → 降级候选
| 类名模式 |
初判 |
理由 |
*ImportView、*ExportView、*UploadView |
降级候选 |
amis 有 input-file、input-excel 等标准组件;如原实现只是文件上传+解析,降级可覆盖;如有复杂字段映射 UI 则升级为重写 |
2.7 选人/选组织类视图 → 降级候选
| 类名模式 |
初判 |
理由 |
UserSelectWindow(已知)、*SelectWindow、*选择View |
降级候选 |
人员/组织树选择可用 amis tree-select 或 input-table + 搜索实现;但若有多级组织过滤或复杂展现需求则工时调升 |
三、清点 SQL 与登记表模板
3.1 全量拉取 SQL(网络恢复后一键执行)
执行环境:192.168.20.68:5435 / schema eip3(测试副本只读)
执行步骤:
- 确认网络可达:
psql -h 192.168.20.68 -p 5435 -U <user> -d postgres -c "SELECT 1"
- 执行全量拉取 SQL,导出为 CSV:
\copy (SELECT ...) TO '153_views_full.csv' CSV HEADER
- 将 CSV 导入到下方登记表,开始逐行初判
3.2 配套辅助 SQL(补充判断信息)
3.3 逐视图登记表模板
使用说明:从 3.1 SQL 导出结果逐行填入;「初判」一列先填 2.x 节结论,终判由老员工核定
| # |
模板 ID |
视图名称 |
engineclass(类名) |
XML 大小(bytes) |
初判 |
终判 |
工时估算(人日) |
责任人 |
客户确认状态 |
备注 |
| 1 |
待拉取 |
待拉取 |
UserManageView |
— |
降级候选 |
待定 |
1 |
待定 |
未确认 |
|
| 2 |
待拉取 |
待拉取 |
ProcessMonitorComponentNew |
— |
重写候选 |
待定 |
3 |
待定 |
未确认 |
|
| … |
… |
… |
… |
… |
… |
… |
… |
… |
… |
… |
| 153 |
待拉取 |
待拉取 |
待拉取 |
— |
待定 |
待定 |
待定 |
待定 |
未确认 |
|
填写规范:
- 初判:重写 / 降级 / 留旧(可加「候选」表示待老员工确认)
- 终判:重写 / 降级 / 留旧(终判后移除「候选」)
- 工时估算:重写参考 2–4 人日,降级参考 0.5–1 人日,留旧 0.25 人日
- 客户确认状态:未确认 / 确认中 / 已确认(含日期)
- 备注:特殊需求、依赖的外部系统、已知风险
四、工时汇总框架
4.1 汇总模板(按三分比例填写)
| 分类 |
数量(个) |
工时参考(人日/个) |
估算小计(人日) |
估算小计(人月,21pd=1月) |
| 重写(React/amis 自定义) |
待填 |
2–4 pd |
待填 |
待填 |
| 降级(标准模板配置) |
待填 |
0.5–1 pd |
待填 |
待填 |
| 留旧(过渡登记) |
待填 |
0.25 pd |
待填 |
待填 |
| 合计 |
153 |
— |
待填 |
待填 |
4.2 对照预算与止损线
| 总估算 |
判断 |
动作 |
| ≤ 1.5 人月 |
✅ 乐观区间 |
继续,重写部分外包采购 |
| 1.5–3 人月 |
✅ 预算内 |
继续,跟踪实际进度 |
| 3–4 人月 |
⚠️ 接近止损线 |
上报项目负责人,将低优先级重写调整为留旧 |
| > 4 人月 |
🔴 触发 S1 止损 |
暂停,扩大留旧比例,重估后重新决策 |
对照工程化实施计划预算:P4 阶段 153 定制视图预算含在「4–6 人月」最大不确定段内;决策会盘点报告已单列为「1.5–3 人月」增量,超 3 人月触发 S1。
4.3 敏感性分析(三分比例变化对总工时的影响)
| 重写% |
降级% |
留旧% |
中值工时(pd) |
估算人月 |
状态 |
| 20% |
30% |
50% |
31×3 + 46×1 + 76×0.25 = 158 pd |
1.76 月 |
✅ |
| 30% |
30% |
40% |
46×3 + 46×1 + 61×0.25 = 230 pd |
2.56 月 |
✅ |
| 40% |
30% |
30% |
61×3 + 46×1 + 46×0.25 = 240 pd |
2.67 月 |
✅ |
| 50% |
25% |
25% |
77×3 + 38×1 + 38×0.25 = 278 pd |
3.09 月 |
⚠️ 接近止损 |
| 60% |
20% |
20% |
92×4 + 31×1 + 30×0.25 = 407 pd |
4.53 月 |
🔴 触发 S1 |
五、决策权与闭环流程
5.1 决策分层
| 决策事项 |
决策人 |
依据 |
| 每个视图的初判 |
老员工(熟引擎)+ 前端架构 |
本文档第二节决策树 |
| 每个视图的终判 |
项目负责人 + 老员工核定 |
3.3 登记表,老员工确认签字 |
| 客户确认 |
项目负责人 → 客户业务负责人 |
决策会切流红线 6(功能点级别须业务负责人签字) |
| 工时超止损处置 |
项目负责人 → CTO/CEO |
触发 S1 止损流程 |
5.2 M0 出口条件
若 M0 两周内客户库仍不可访问:基于 2.x 节初判结果推进工时估算(按名字可判的类优先),终判延至 P4 启动前(P4 启动前必须完成)。
5.3 重写视图外包采购计划(参考)
| 事项 |
建议时机 |
说明 |
| 重写候选清单锁定 |
M0 出口后 |
确定数量后才能采购 |
| 外包需求包编制 |
P3 结束前 |
包含:视图列表、截图/录屏、后端 REST API 文档、amis 版本要求、验收标准 |
| 外包采购启动 |
P4 开始时 |
与批量转换并行,不占核心团队时间 |
| 外包交付物验收 |
P4 中后段 |
双闸验证(schema 校验 + 渲染冒烟)+ 业务功能测试 |
附注:
- 本文档依据《EIP3客户库盘点报告》第四节(153 个 engineclass 视图数据来源)编制
- engineclass 完整列表需执行第三节 SQL 后补入登记表
- 本稿为初判底稿,逐视图终判须项目负责人 + 老员工核定,客户书面确认后方生效
- 止损线 >3 人月触发 S1 为决策会纪要第七节 S1 止损条件的具体化
六、【2026-06-11 增补】真实清单已拉取——初判归桶结果
5435 网络恢复,第三节 SQL 已执行:全量 153 条 engineclass 映射确认(与盘点报告精确一致),明细见 153视图全量清单.txt(view_template_id | 模板名 | engineclass)。
6.1 按名称启发式初判归桶
| 桶 |
数量 |
初判方向 |
依据 |
| A. 报表/PDF/台账类 |
16 |
留旧候选(待 P4 报表方案 C 类统筹) |
类名含 report/pdf/print/account/summary |
| B. 选择窗/树/查询窗类 |
30 |
降级候选(amis picker/tree 有标准对应物) |
类名含 research/select/window/picker/tree |
| C. 管理 CRUD 类 |
47 |
降级候选(标准模板近似物大概率存在) |
类名含 manage/config/main/info/list |
| D. 流程交互类 |
22 |
重写候选(待办/审批交互重,amis 无现成对应) |
类名含 task/process/wf/monitor |
| E. 导入导出/消息类 |
6 |
重写/降级逐个判 |
import/export/send/message |
| F. 其他 |
32 |
逐个判 |
未命中启发式 |
| 合计 |
153 |
|
|
6.2 工时初算(对照预算与止损线)
按本归桶的中性假设(B+C 共 77 条降级 ×0.5–1 人日;D 22 条重写 ×2–4 人日;A 16 条留旧 ×0.25 人日;E+F 38 条按半降级半重写折中):约 2.3–4.4 人月,上沿已越过 3 人月止损线。结论:终判时必须把 F 桶 32 条和 D 桶 22 条逐个过堂,优先扩大「留旧过渡」比例(决策会止损预案),否则触发 S1 重审。高频类名(MaterialSelect×3、CheckIn×3、Input×4)提示存在同型视图可批量处理,有压缩空间。
6.3 待办更新
engineclass 完整列表需执行第三节 SQL 后补入登记表 → 已完成(2026-06-11)
剩余:逐视图终判(项目负责人+老员工,对照 6.1 初判) → 已升级为带证据的终判草案,见第七节
- 剩余:评审会签字(就第七节 3 个待决问题拍板)→ 客户书面确认 → 锁定外包采购清单
七、终判证据包(2026-06-11)
指针:docs/M0交付/153终判证据包/
内容:终判建议表.csv(153 行逐视图证据)、终判评审材料.md(评审会一页纸)、stats.json、分析脚本/(01 SQL + 02/03 Python,可复跑)
性质:把第六节「名称启发式初判」升级为带证据的终判草案(源码行数+组件谱+菜单引用+XML 大小),供项目负责人+老员工一次评审会签字。
7.1 证据口径(对比第六节,本节用证据而非名字)
- DB 侧(只读 ceshi/eip3):
sys_menu.view_templateid→view_template 菜单引用数(本库无按视图访问日志,使用频率仅此一个代理信号,如实标注);XML 字节数;同 engineclass 模板复用数。
- 源码侧(framework grep):定位
.java→行数+组件谱(Window/Table/Tree/Upload/Chart/Gantt/Canvas/iframe/Wizard)+外部依赖(PDF/Excel/设备/打印,已剔除 printStackTrace 等假信号)+CRUD 包装判定。
- 决策树:落地第一节,Tree/Upload 由 amis tree-select/input-file 覆盖→不单独触发重写;仅甘特/画布/图表/iframe/向导等 amis 无对应物的重组件才触发重写。
7.2 四分类终判结果(证据版)
| 分类 |
数量 |
工时(人日) |
工时(人月) |
对比 §6.1 名义 |
| 重写 |
13 |
43.0 |
2.05 |
由名义 22 收敛到 13(剔除被 process/task 误伤的进度计划/台账类) |
| 降级 |
95 |
75.75 |
3.61 |
B+C 桶证实可降级,部分 D/F 桶下沉至降级 |
| 留旧 |
43 |
10.75 |
0.51 |
A 桶报表/PDF 全留旧 |
| 废弃 |
2 |
0.0 |
0.0 |
新增:「已办任务(测试)」「材料选择框-废品材料」 |
| 合计 |
153 |
129.5 |
6.17 |
|
重写池(13 个=2 人月,唯一硬成本):工作流审批族(待办/已办/审批/监控/流程定义/服务流/流程选择/我的发起/审批表单删除,与 P3 Flowable REST 强绑定)+实名制设备族(考勤机/显示屏/用工信息,含设备对接,源码 MISSING)。
7.3 总工时 vs 止损线 → 触发 S1
- 基线 6.17 人月,越过 3 人月止损线 → 触发 S1。
- 执行止损预案(把「菜单引用=0」的 38 个低价值降级转留旧 + 去重红利 4.5 人日)→约 4.96 人月,仍未回落至 3 人月以内。
- 敏感性:降级取低端 0.5 人日→基线 4.58 人月;强力 S1(仅保留菜单引用≥1 的降级 @0.5,其余转留旧)→约 3.8+ 人月,均仍超线。
- 判断:任何合理场景都超 3 人月止损线。重写 2 人月是硬成本,摆动量全在「降级 vs 留旧」归属上。压到 ≤3 人月需评审会主动把更多低使用度降级判为留旧。
7.4 重大信号:源码 MISSING 106 个
framework/ 仅含核心平台(client/server/viewframework),所有 hr(23)/pm(65)/oa(14)/dm(4) 业务 addon 源码均不在本仓库。含义:这批视图既不能重写(无源码对照)也不能可靠留旧(升级/打补丁需 addon 构建产物)。这是 P4 启动的前置阻塞项,必须先向客户/原厂确认 addon 源码归属(补丁包/另一仓库/已废弃)。DB 侧:153 条全部在 postgres 库命中(153/153),其中 23 条 xml 字段为 NULL(模板存在但无 XML 内容)、130 条有 XML;曾误连 ceshi 旧副本(仅 103 条)导致"81 个不在快照"假象,已订正,正确口径为 dbname=postgres。
7.5 评审会待决问题(就这 3 个拍板,其余 ~150 条照单签)
- Q1(阻塞级) 源码 MISSING 的 106 个 addon 视图:客户提供源码/补丁包(→正常三分),还是确认已退役(→整域留旧/废弃,工时大降)?不决策 P4 无法启动。
- Q2(止损级) 基线 6.17 人月超线:执行止损预案(→4.96 人月)后仍超,二选一——(a)进一步扩大留旧至 ≤3 人月,或(b)上报 CTO 批 3.5–4 人月预算。
- Q3(口径级) 菜单引用=0 的 58 个视图(全桶合计),哪些真未用(→废弃)、哪些是内嵌调用的选择框/弹窗(menu_ref=0 不等于未用,→维持降级/留旧)?需老员工现场区分。
八、源码定位与全见源码终判(2026-06-11)
重大订正:第七节的「源码 MISSING 106 个」是误判。真相——hr/pm/oa/dm 业务 addon 源码不在 eip3/framework(仅核心平台),而在苏州五建完整 OSGi 源码全集 EIP-3.0/(带 git,最近提交「苏州五建包更新版本号」)。本节把源码维度从「盲判」升级为**「全见源码判」**(真实行数/组件谱/外部依赖/CRUD 全为实测值)。
产物已就地更新:153终判证据包/终判建议表.csv(新增「源码路径」列,152 条填 .java 绝对路径)、终判评审材料.md(全见源码版)、stats.json、分析脚本/(02/03 参数化 EIP3_SRC,可复跑)。
8.1 源码定位结论
- 152/153 全见源码:简单类名命中后用 engineclass 完整包路径做最长后缀消歧(17 个同名类 0 存疑;OSGi 目录名可能 ≠ 包名,如目录
com.dsasp.pm.projectprocess 含包 com.dsasp.pm.process,按包路径匹配已处理)。
- 1 个疑废弃:
SupplierResearchCaseView(物资供应商调查-表单)——EIP-3.0 全树无对应 .java;同模块 com.dsasp.pm.materialsuppliermanagement 有近似类 SupplierResearchView/SupplierResearchWindowView/SupplierResearchCaseWindow,疑改名或废弃 → 判废弃候选,待客户/老员工确认是否已删/改名后剔除。
- 版本对应核验:客户库 5435 中 119/153 模板名带「五建/定制」字样,确认 EIP-3.0 = 苏州五建源码、与客户库同源;153 个 engineclass 涉及 42 个业务模块,全部能在 EIP-3.0 找到对应 addon。EIP-3.0 各 addon OSGi Bundle-Version 为 1.0.x(materialsuppliermanagement=1.0.60、checkattendancemanager=1.0.52、materialbaseconfig=1.0.40 等),客户库
view_template.version 是模板修订号(0–25),二者口径不同不直接可比;类名匹配 152/153 + 同源命名已足以判定高度同源。逐 addon MANIFEST↔现场 jar 精确版本对齐登记为后续核验项(不阻塞终判)。
8.2 全见源码四分类终判(vs 旧版盲判)
| 分类 |
数量(新) |
工时(人日) |
工时(人月) |
数量(旧/盲判) |
变化主因 |
| 重写 |
23 |
75.0 |
3.57 |
13 |
原盲判为低价值降级/留旧的 addon,全见源码后暴露真甘特(DsGantt/SchedulerGantt)、内嵌 iframe(Embedded)、实名制设备族 |
| 降级 |
97 |
76.25 |
3.63 |
95 |
多数管理 CRUD 实测确为可降级 |
| 留旧 |
30 |
7.5 |
0.36 |
43 |
部分原盲判留旧的低复杂视图实为可降级 CRUD |
| 废弃 |
3 |
0.0 |
0.0 |
2 |
新增疑废弃 SupplierResearchCaseView |
| 合计 |
153 |
158.75 |
7.56 |
153 |
— |
8.3 总工时 vs 止损线 → 仍触发 S1(且不降反升)
- 基线 7.56 人月(旧版盲判 6.17)——工时不降反升。原因:106 个盲判 MISSING 被默认按低价值降级/留旧定档,全见源码后发现其中含大量真甘特/iframe/设备族(amis 无对应物、必须重写),盲判低估了这批 addon 复杂度。
- 执行止损预案(菜单引用=0 的 37 个降级转留旧 + 去重红利 7.75 人日)→ 约 6.24 人月,仍远超 3 人月。
- 关键约束:重写池本身 = 23 个 = 3.57 人月,即便把所有可降级全转留旧也压不到 3 人月。仅靠「降级转留旧」已不可能回落到止损线内——需评审会就预算/分期/外包做结构性决策。
8.4 Top3 最贵重写(真实行数/组件谱)
- 进度计划
ProjectProcessSetting — 639 行,Gantt(DsGantt)/Window/Dialog/Calendar + 打印 → 4 人日。
- 图片管理-任务
DatumPictureProjectMain — 638 行,内嵌 iframe(Embedded)/Window/Dialog → 4 人日(同 engineclass 复用 2 个,去重省 3.75 人日)。
- 会议室调度
MeetingRoomDispatchMainView — 552 行,Gantt(SchedulerGantt)/Window/Dialog → 4 人日。
重写三大族:甘特/调度族(进度计划/会议室调度/车辆调度/员工排班/进度对比)+ 内嵌 iframe/图片族(图片管理多视图)+ 工作流审批与实名制设备族(待办/已办/审批/监控/流程定义/服务流 + 实名制考勤机/显示屏/用工信息)。
8.5 评审会待决问题更新(对第七节 Q1–Q3)
- Q1(原阻塞级,已解除) 源码归属问题已解决:152/153 在 EIP-3.0 全见源码,「P4 前置阻塞」结论作废。仅剩 1 项确认——
SupplierResearchCaseView 疑废弃,请确认是否已删/改名。后续核验项:EIP-3.0↔目标客户现场部署的逐 addon 精确版本对应(同源已确认,不阻塞)。
- Q2(止损级,升级) 基线由 6.17 升至 7.56 人月,止损预案后仍 6.24,且重写池硬成本 3.57 人月已逼近止损线。三选一:(a) 重写池分期(首期只做菜单引用≥1 的高频重写),(b) 甘特/图片/调度族评估第三方组件或保留旧前端嵌入(降重写为集成),(c) 上报 CTO 批 6–8 人月预算(含外包)。
- Q3(口径级,不变) 菜单引用=0 的 58 个视图哪些真未用、哪些内嵌选择框/弹窗,仍需老员工现场区分(本库无按视图访问日志)。