- 从工作区根 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>
11 KiB
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 人月。三大族:
- 甘特/调度族(进度计划/会议室调度/车辆调度/员工排班/进度对比,真用 DsGantt/SchedulerGantt,amis 无甘特组件);
- 内嵌 iframe/图片族(图片管理多视图,Vaadin Embedded 嵌外部资源,需自定义渲染器);
- 工作流审批 + 实名制设备族(待办/已办/审批/监控/流程定义/服务流与 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)。