Files
eip4-platform/docs/M0交付/153终判证据包/终判评审材料.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

11 KiB
Raw Permalink Blame History

153 定制视图终判评审材料

生成时间:2026-06-11 | 性质:全见源码版·带证据的终判草案(供项目负责人 + 老员工一次评审会签字) 数据源:客户库 192.168.20.68:5435 dbname=postgres / schema eip3(只读,153 条全量)

  • 老系统完整源码全集 EIP-3.0/(只读,hr/pm/oa/dm 业务 addon + framework 核心,带 git)。 ⚠️ 连接注意:5435 必须连 postgres 库,ceshi 库同名 schema 为旧副本(103 条),曾误连已订正。 配套:终判建议表.csv(153 行逐视图证据,新增「源码路径」列)、分析脚本/(SQL+Python 批处理,参数化 EIP3_SRC 路径,可复跑)

〇、一句话结论

  • 【源码维度升级】原 106 个「源码 MISSING」实为「在另一仓库」——业务 addon 源码全部在苏州五建完整源码全集 EIP-3.0/。现 152/153 全见源码(真实行数/组件谱/外部依赖/CRUD 判定全为实测值,非盲判),仅 1 个疑废弃。
  • 基线证据估算 = 158.75 人日 ≈ 7.56 人月,🔴 超线,触发 S1。
  • 即便执行止损预案(低价值降级转留旧 37 个 + 去重红利 7.75 人日),仍约 6.24 人月,未能回落至 3 人月以内。
  • 与旧版盲判对比(关键):旧版基线 6.17 人月(重写 13),新版 7.56 人月(重写 23)。工时不降反升——因为 106 个原被盲判为低价值降级/留旧的视图,全见源码后暴露出大量真甘特(DsGantt/SchedulerGantt)、内嵌 iframe(Embedded)、实名制设备族,这些 amis 无对应物、必须重写。盲判时低估了这批 addon 的真实复杂度。
  • 故评审会真正要拍板的不再是「源码归属阻塞」(已解除),而是 2 个止损/口径问题(见第六节),其余 153 条照单签。

一、四分类汇总(全见源码 vs 旧版盲判)

分类 数量(新) 工时人日(新) 工时人月(新) 数量(旧/盲判) 单价口径
重写 23 75.0 3.57 13 2–4 人日(按真实组件谱/行数定档)
降级 97 76.25 3.63 95 0.75 人日(批量转换器+手工配置)
留旧 30 7.5 0.36 43 0.25 人日(过渡登记)
废弃 3 0.0 0.0 2 0(客户确认后剔除)
合计 153 158.75 7.56 153 —

对照口径:旧版基于 framework-only grep(106 个盲判 MISSING,按名称启发式定档),新版基于 EIP-3.0 全见源码实测组件谱定档。重写从 13 → 23(真甘特/iframe/设备族被识别)、降级 97、留旧从 43 → 30(许多原盲判留旧的低复杂视图实为可降级 CRUD)、废弃 3。

二、总工时 vs 止损线(敏感性)

场景 说明 工时(人日) 人月 对照 3 人月止损
基线(全见源码) 按真实组件谱逐条定档 158.75 7.56 🔴 超线,触发 S1
S1-降级转留旧 把「菜单引用=0」的低价值降级 37 个转留旧(postgres 库全量) 138.75 6.61 🔴 仍超线
S1+去重红利 再叠加同型 engineclass 批量复用(省 7.75 人日) 131.0 6.24 🔴 仍超线
旧版基线(盲判对照) framework-only 名义估算 129.5 6.17 🔴 超线

敏感性补充(手算,见脚本注释):

  • 若降级单价取低端 0.5 人日:基线约 6.24 人月,仍超线。
  • 若执行「强力 S1」(仅保留菜单引用≥1 的降级 60 个 @0.5,其余全部转留旧):约 5.36 人月,仍超线。

判断:全见源码后,工时不降反升(6.17 → 7.56 人月),重写部分 23 个 = 75.0 人日 ≈ 3.57 人月是真正硬成本(真甘特/iframe/设备/工作流,amis 无对应物)。压到 3 人月以内已不可能仅靠「降级转留旧」实现——重写池本身就接近 3.6 人月。需评审会就预算/分期/外包做结构性决策。

三、Top10 最贵重写视图明细(基于真实源码行数/组件谱)

# 视图名称 engineclass 源码行数 真实组件谱/外部依赖 工时(人日)
1 进度计划 ProjectProcessSetting 639 Gantt/Window/Dialog/Calendar/Print(打印) 4.0
2 图片管理-任务 DatumPictureProjectMain 638 BrowserFrame/iframe/Window/Dialog 4.0
3 图片管理-资料员编辑列表 DatumPictureProjectMain 638 BrowserFrame/iframe/Window/Dialog 4.0
4 会议室调度 MeetingRoomDispatchMainView 552 Gantt/Window/Dialog 4.0
5 车辆调度 VehicleDispatchMainView 539 Gantt/Window/Dialog/Print(打印) 4.0
6 流程定义 ProcessDefinitionComponent 490 Tree 4.0
7 员工排班 SchuserScheduleView 473 Gantt/Window/Dialog 3.0
8 实名制项目用工信息 PrjWorkerManageView 357 标准表单/列表(工作流交互) 3.0
9 图片资料管理--公司查看列表 DatumPicturCompanyMain 341 BrowserFrame/iframe/Window/Dialog 3.0
10 我的发起任务 MySendTaskComponent 256 Window/Dialog/Calendar 3.0

重写池共 23 个 = 75.0 人日 ≈ 3.57 人月。三大族:

  1. 甘特/调度族(进度计划/会议室调度/车辆调度/员工排班/进度对比,真用 DsGantt/SchedulerGantt,amis 无甘特组件);
  2. 内嵌 iframe/图片族(图片管理多视图,Vaadin Embedded 嵌外部资源,需自定义渲染器);
  3. 工作流审批 + 实名制设备族(待办/已办/审批/监控/流程定义/服务流与 P3 Flowable REST 强绑定;实名制考勤机/显示屏/用工信息含人脸/卡设备对接)。

四、源码定位结论(重大订正:原 MISSING 已解除)

原判 106 个「源码 MISSING」是误判——真相是 hr/pm/oa/dm 业务 addon 源码不在 eip3/framework(仅核心平台),而在苏州五建完整源码全集 EIP-3.0/(带 git,最近提交「苏州五建包更新版本号」)。

本轮全树定位结果:

  • 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,疑改名或废弃。判废弃候选,待客户确认是否已删/改名后剔除。

源码定位按业务域分布(全部命中):

业务域 全见源码数
com.dsasp.pm.* 64
com.dsasp.client.* 37
com.dsasp.hr.* 23
com.dsasp.oa.* 14
com.dsasp.clinet.* 8
com.dsasp.dm.* 4
com.dsasp.server.* 1
com.dsasp.tools.* 1

版本对应核验结论:客户库 5435 中 119/153 模板名带「五建/定制」字样,确认 EIP-3.0 = 苏州五建源码、与客户库同源。客户库 153 个 engineclass 涉及 42 个业务模块,全部能在 EIP-3.0 找到对应 addon 目录/包(pm.process 的目录名为 projectprocess,包名一致)。 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 精确版本对齐,建议比对 EIP-3.0 各包 MANIFEST.MF 与客户现场部署的 jar 版本(不阻塞本次终判,登记为后续核验项)。

五、去重红利(同型视图可批量处理)

engineclass 复用视图数 桶 批量可省(人日)
DatumPictureProjectMain 2 重写 3.75
TaskComponentNew 2 重写 2.75
FuncDownloadComponent 2 降级 0.5
PositionManageView 2 降级 0.5
MaterialSelectView 3 降级 0.25
合计可省 7.75

同一 engineclass 被多个 view_template 复用时,重写/降级只需做一次,其余按登记成本计。

六、评审会待决问题清单(就这几个问题要人拍板,其余照单签)

Q1(已解除阻塞 / 仅需确认)源码归属问题已解决:152/153 在 EIP-3.0 全见源码。

  • 原「源码 MISSING 106 个、P4 前置阻塞」结论作废——源码在另一仓库,非废弃。
  • 仅剩 1 项需确认:SupplierResearchCaseView(物资供应商调查-表单)疑废弃(同模块有近似类),请老员工/客户确认是否已删/改名。
  • 待后续核验项(不阻塞终判):EIP-3.0 各 addon MANIFEST 版本 ↔ 目标客户现场部署版本的逐包对应(同源已确认,仅做精确版本登记)。

Q2(止损级 / 必答)基线 7.56 人月超 3 人月止损线,止损预案已不足以回落,如何决策?

  • 现实约束:全见源码后重写池本身 = 3.57 人月(23 个真甘特/iframe/设备/工作流),即便把所有可降级转留旧也压不到 3 人月。默认止损(降级转留旧 37 + 去重)仅到 6.24 人月。
  • 需三选一:(a) 重写池分期——首期只做菜单引用≥1 的高频重写视图,其余跟随业务排期;(b) 甘特/图片/调度族评估第三方现成组件或保留旧前端嵌入(降重写为集成);(c) 项目负责人上报 CTO 批准 6–8 人月预算(含外包)。

Q3(口径级 / 必答)菜单引用=0 的 58 个视图(含所有桶),哪些是真未用、哪些是被其他视图内嵌调用的选择框/弹窗?

  • 证据局限:本库无「按视图」访问日志,使用频率仅以 sys_menu 引用数为代理;选择框/Dialog/树等内嵌组件天然 menu_ref=0,不等于未用。
  • 需老员工现场区分:真未用 → 废弃;内嵌调用 → 维持降级/留旧。

(其余条目照单签) 重写 23 / 降级 97 / 留旧 30 / 废弃 3,证据充分(全见源码),无需逐条讨论。


附:方法与口径

  • DB 连接:192.168.20.68:5435 dbname=postgres(非 ceshi 库)/ schema eip3,153 条全量命中。
  • 源码基准(全见源码升级):EIP-3.0/(hr/pm/oa/dm 业务 addon + framework,参数化 EIP3_SRC)。全树建「简单类名→路径」索引,engineclass 完整包路径最长后缀消歧。
  • 使用度信号:sys_menu.view_templateid → view_template 的引用计数(本库无按视图访问日志,如实标注)。
  • 源码复杂度:定位 .java → 真实行数 + 组件谱(Window/Table/Tree/Upload/Chart/Gantt/Canvas/iframe/Wizard)+ 外部依赖(PDF/Excel/设备/打印)+ CRUD 包装判定。
  • 三分判定:按 v1 文档第一节决策树,用真实证据(行数/组件/依赖/使用度)而非类名;名称含「未用/暂时不用/测试/废」直接判废弃。
  • 工时定档:重写 2–4 人日(按真实行数 <250/<500/≥500 与组件谱)、降级 0.75(导入导出 1.0)、留旧 0.25、废弃 0。
  • 复跑:bash 分析脚本/00_run_all.sh(连 postgres 库导出 DB 证据 → Python 全见源码采集 → 生成 CSV+stats+md)。