docs: 统一项目文档进 eip4-platform/docs + 新增进度路线总览
Some checks failed
ci / build-test-parity (push) Has been cancelled

- 从工作区根 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>
This commit is contained in:
2026-06-17 14:52:50 +08:00
parent 838669f124
commit 1b69f8b481
54 changed files with 7485 additions and 0 deletions

View File

@@ -0,0 +1,195 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
03_render_review.py — 由 stats.json + 终判建议表.csv 渲染「终判评审材料.md」(可复跑)
依赖 02_build_evidence.py 的产物。
【2026-06-11 全见源码升级】源码基准从 eip3/framework(仅核心平台,导致 106 MISSING 盲判)
切换到苏州五建完整 OSGi 源码全集 EIP-3.0/(hr/pm/oa/dm 业务 addon + framework)。
本渲染器改为数据驱动(不再硬编码 106 MISSING / framework-only 叙事),以 stats.json 真值出文。
"""
import csv, json
from collections import defaultdict
OUTDIR = "/Users/zhengwr/workspace/eip3/docs/M0交付/153终判证据包"
S = json.load(open(f"{OUTDIR}/stats.json", encoding="utf-8"))
ROWS = list(csv.DictReader(open(f"{OUTDIR}/终判建议表.csv", encoding="utf-8-sig")))
def shortcls(ec): return ec.split(".")[-1]
# ---- 旧版(盲判 framework-only)基线,用于对比 ----
OLD = {"buckets": {"重写": 13, "降级": 95, "留旧": 43, "废弃": 2},
"total_mandays": 129.5, "total_manmonths": 6.17,
"s1_manmonths_after_dedup": 4.96, "missing": 106}
bk = S["buckets"]; md = S["mandays"]
s1 = S["s1_scenario"]
src_located = S.get("src_located", 0)
deprecated = S.get("deprecated", [])
true_missing = S.get("src_missing", 0)
over = "🔴 超线,触发 S1" if S["total_manmonths"] > 3.0 else "🟢 在线内"
L = []
w = L.append
w("# 153 定制视图终判评审材料")
w("")
w("> 生成时间:2026-06-11 | 性质:**全见源码版·带证据的终判草案**(供项目负责人 + 老员工一次评审会签字)")
w("> 数据源:客户库 192.168.20.68:5435 **dbname=postgres** / schema eip3(只读,153 条全量)")
w("> + 老系统**完整源码全集** EIP-3.0/(只读,hr/pm/oa/dm 业务 addon + framework 核心,带 git)。")
w("> ⚠️ 连接注意:5435 必须连 postgres 库,ceshi 库同名 schema 为旧副本(103 条),曾误连已订正。")
w(f"> 配套:`终判建议表.csv`(153 行逐视图证据,新增「源码路径」列)、`分析脚本/`(SQL+Python 批处理,参数化 `EIP3_SRC` 路径,可复跑)")
w("")
w("---")
w("")
w("## 〇、一句话结论")
w("")
w(f"- **【源码维度升级】原 106 个「源码 MISSING」实为「在另一仓库」**——业务 addon 源码全部在苏州五建完整源码全集 EIP-3.0/。"
f"现 **152/153 全见源码**(真实行数/组件谱/外部依赖/CRUD 判定全为实测值,非盲判),仅 1 个疑废弃。")
w(f"- **基线证据估算 = {S['total_mandays']} 人日 ≈ {S['total_manmonths']} 人月,{over}**。")
w(f"- 即便执行止损预案(低价值降级转留旧 {s1['demoted_count']} 个 + 去重红利 {S['dedup_saving_mandays']} 人日),仍约 **{s1['manmonths_after_dedup']} 人月**,**未能回落至 3 人月以内**。")
w(f"- **与旧版盲判对比(关键)**:旧版基线 {OLD['total_manmonths']} 人月(重写 {OLD['buckets']['重写']}),新版 **{S['total_manmonths']} 人月**(重写 **{bk.get('重写',0)}**)。"
f"**工时不降反升**——因为 106 个原被盲判为低价值降级/留旧的视图,全见源码后暴露出大量真甘特(DsGantt/SchedulerGantt)、内嵌 iframe(Embedded)、实名制设备族,"
f"这些 amis 无对应物、必须重写。盲判时低估了这批 addon 的真实复杂度。")
w(f"- 故评审会真正要拍板的不再是「源码归属阻塞」(已解除),而是 **2 个止损/口径问题**(见第六节),其余 {S['total']} 条照单签。")
w("")
w("---")
w("")
w("## 一、四分类汇总(全见源码 vs 旧版盲判)")
w("")
w("| 分类 | 数量(新) | 工时人日(新) | 工时人月(新) | 数量(旧/盲判) | 单价口径 |")
w("|------|-----:|----------:|----------:|-----:|---------|")
price = {"重写":"2–4 人日(按真实组件谱/行数定档)","降级":"0.75 人日(批量转换器+手工配置)",
"留旧":"0.25 人日(过渡登记)","废弃":"0(客户确认后剔除)"}
for b in ["重写","降级","留旧","废弃"]:
n=bk.get(b,0); m=md.get(b,0.0)
w(f"| {b} | {n} | {m} | {round(m/21,2)} | {OLD['buckets'].get(b,0)} | {price[b]} |")
w(f"| **合计** | **{S['total']}** | **{S['total_mandays']}** | **{S['total_manmonths']}** | **153** | — |")
w("")
w(f"> 对照口径:旧版基于 framework-only grep(106 个盲判 MISSING,按名称启发式定档),新版基于 EIP-3.0 全见源码实测组件谱定档。"
f"重写从 {OLD['buckets']['重写']} → **{bk.get('重写',0)}**(真甘特/iframe/设备族被识别)、"
f"降级 {bk.get('降级',0)}、留旧从 {OLD['buckets']['留旧']} → **{bk.get('留旧',0)}**(许多原盲判留旧的低复杂视图实为可降级 CRUD)、废弃 **{bk.get('废弃',0)}**。")
w("")
w("## 二、总工时 vs 止损线(敏感性)")
w("")
w("| 场景 | 说明 | 工时(人日) | 人月 | 对照 3 人月止损 |")
w("|------|------|----------:|-----:|----------------|")
w(f"| 基线(全见源码) | 按真实组件谱逐条定档 | {S['total_mandays']} | {S['total_manmonths']} | {over} |")
w(f"| S1-降级转留旧 | 把「菜单引用=0」的低价值降级 {s1['demoted_count']} 个转留旧(postgres 库全量) | {s1['mandays_after']} | {s1['manmonths_after']} | 🔴 仍超线 |")
w(f"| S1+去重红利 | 再叠加同型 engineclass 批量复用(省 {S['dedup_saving_mandays']} 人日) | {s1['mandays_after_dedup']} | {s1['manmonths_after_dedup']} | 🔴 仍超线 |")
w(f"| 旧版基线(盲判对照) | framework-only 名义估算 | {OLD['total_mandays']} | {OLD['total_manmonths']} | 🔴 超线 |")
w("")
rewrite_md = md.get("重写", 0.0)
legacy_md = md.get("留旧", 0.0)
menu1_cnt = sum(1 for r in ROWS if r["菜单引用数"] not in ("0","无数据","") and r["终判建议"]=="降级")
strong_s1 = round((rewrite_md + menu1_cnt*0.5 + legacy_md)/21, 2)
w("**敏感性补充**(手算,见脚本注释):")
w(f"- 若降级单价取低端 0.5 人日:基线约 {round((rewrite_md + bk.get('降级',0)*0.5 + legacy_md)/21,2)} 人月,仍超线。")
w(f"- 若执行「强力 S1」(仅保留菜单引用≥1 的降级 {menu1_cnt} 个 @0.5,其余全部转留旧):约 **{strong_s1} 人月**,仍超线。")
w("")
w(f"> **判断**:全见源码后,工时不降反升({OLD['total_manmonths']} → {S['total_manmonths']} 人月),"
f"**重写部分 {bk.get('重写',0)} 个 = {rewrite_md} 人日 ≈ {round(rewrite_md/21,2)} 人月是真正硬成本**(真甘特/iframe/设备/工作流,amis 无对应物)。"
"压到 3 人月以内已不可能仅靠「降级转留旧」实现——重写池本身就接近 3.6 人月。需评审会就预算/分期/外包做结构性决策。")
w("")
w("## 三、Top10 最贵重写视图明细(基于真实源码行数/组件谱)")
w("")
w("| # | 视图名称 | engineclass | 源码行数 | 真实组件谱/外部依赖 | 工时(人日) |")
w("|--:|---------|-------------|--------:|------------|----------:|")
csvmap = {r["engineclass"]+"|"+r["name"]: r for r in ROWS}
for i,t in enumerate(S["top10_rewrite"],1):
row = csvmap.get(t["engineclass"]+"|"+t["name"], {})
comps = (row.get("组件谱","") or "").strip()
deps = (row.get("外部依赖","") or "").strip()
note = "/".join([x for x in [comps, deps] if x]) or "标准表单/列表(工作流交互)"
w(f"| {i} | {t['name']} | {shortcls(t['engineclass'])} | {t['loc']} | {note} | {t['md']} |")
w("")
w(f"> 重写池共 {bk.get('重写',0)} 个 = {rewrite_md} 人日 ≈ {round(rewrite_md/21,2)} 人月。三大族:")
w("> 1) **甘特/调度族**(进度计划/会议室调度/车辆调度/员工排班/进度对比,真用 DsGantt/SchedulerGantt,amis 无甘特组件);")
w("> 2) **内嵌 iframe/图片族**(图片管理多视图,Vaadin Embedded 嵌外部资源,需自定义渲染器);")
w("> 3) **工作流审批 + 实名制设备族**(待办/已办/审批/监控/流程定义/服务流与 P3 Flowable REST 强绑定;实名制考勤机/显示屏/用工信息含人脸/卡设备对接)。")
w("")
w("## 四、源码定位结论(重大订正:原 MISSING 已解除)")
w("")
w(f"**原判 106 个「源码 MISSING」是误判**——真相是 hr/pm/oa/dm 业务 addon 源码不在 eip3/framework(仅核心平台),"
f"而在苏州五建完整源码全集 **EIP-3.0/**(带 git,最近提交「苏州五建包更新版本号」)。")
w("")
w("本轮全树定位结果:")
w(f"- **152/153 全见源码**(简单类名命中后用 engineclass 完整包路径做最长后缀消歧,17 个同名类 0 存疑;")
w(" 注意 OSGi 目录名可能与包名不同,如目录 `com.dsasp.pm.projectprocess` 内含包 `com.dsasp.pm.process`,按包路径匹配已处理)。")
if deprecated:
d = deprecated[0]
w(f"- **1 个疑废弃**:`{shortcls(d['engineclass'])}`({d['name']})——EIP-3.0 全树无对应 .java;{d['note']}。**判废弃候选,待客户确认是否已删/改名后剔除**。")
if true_missing:
w(f"- **{true_missing} 个真缺失**(全树仍未定位,需核查 engineclass 拼写/包路径,见 CSV「源码路径=未定位」行)。")
w("")
w("源码定位按业务域分布(全部命中):")
loc_by_domain = defaultdict(int)
for r in ROWS:
if r["源码路径"] not in ("源码缺失-疑废弃","未定位"):
parts = r["engineclass"].split(".")
dom = parts[2] if len(parts)>2 else "?"
loc_by_domain[dom]+=1
w("| 业务域 | 全见源码数 |")
w("|--------|----------:|")
for dom,c in sorted(loc_by_domain.items(), key=lambda x:-x[1]):
w(f"| com.dsasp.{dom}.* | {c} |")
w("")
w("**版本对应核验结论**:客户库 5435 中 119/153 模板名带「五建/定制」字样,确认 EIP-3.0 = 苏州五建源码、与客户库同源。"
"客户库 153 个 engineclass 涉及 42 个业务模块,**全部能在 EIP-3.0 找到对应 addon 目录/包**(`pm.process` 的目录名为 `projectprocess`,包名一致)。")
w("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 版本(不阻塞本次终判,登记为后续核验项)。")
w("")
w("## 五、去重红利(同型视图可批量处理)")
w("")
w("| engineclass | 复用视图数 | 桶 | 批量可省(人日) |")
w("|-------------|----------:|----|---------------:|")
for d in S["dedup_classes"]:
w(f"| {shortcls(d['ec'])} | {d['count']} | {d['bucket']} | {d['saved']} |")
w(f"| **合计可省** | | | **{S['dedup_saving_mandays']}** |")
w("")
w("> 同一 engineclass 被多个 view_template 复用时,重写/降级只需做一次,其余按登记成本计。")
w("")
w("## 六、评审会待决问题清单(就这几个问题要人拍板,其余照单签)")
w("")
w(f"**Q1(已解除阻塞 / 仅需确认)源码归属问题已解决:152/153 在 EIP-3.0 全见源码。**")
w("- 原「源码 MISSING 106 个、P4 前置阻塞」结论作废——源码在另一仓库,非废弃。")
if deprecated:
d = deprecated[0]
w(f"- 仅剩 1 项需确认:`{shortcls(d['engineclass'])}`({d['name']})疑废弃(同模块有近似类),请老员工/客户确认是否已删/改名。")
w("- 待后续核验项(不阻塞终判):EIP-3.0 各 addon MANIFEST 版本 ↔ 目标客户现场部署版本的逐包对应(同源已确认,仅做精确版本登记)。")
w("")
w(f"**Q2(止损级 / 必答)基线 {S['total_manmonths']} 人月超 3 人月止损线,止损预案已不足以回落,如何决策?**")
w(f"- 现实约束:全见源码后重写池本身 = {round(rewrite_md/21,2)} 人月({bk.get('重写',0)} 个真甘特/iframe/设备/工作流),"
f"即便把所有可降级转留旧也压不到 3 人月。默认止损(降级转留旧 {s1['demoted_count']} + 去重)仅到 {s1['manmonths_after_dedup']} 人月。")
w("- 需三选一:(a) 重写池分期——首期只做菜单引用≥1 的高频重写视图,其余跟随业务排期;"
"(b) 甘特/图片/调度族评估第三方现成组件或保留旧前端嵌入(降重写为集成);"
"(c) 项目负责人上报 CTO 批准 6–8 人月预算(含外包)。")
w("")
menu0_cnt = sum(1 for r in ROWS if r["菜单引用数"] == "0")
w(f"**Q3(口径级 / 必答)菜单引用=0 的 {menu0_cnt} 个视图(含所有桶),哪些是真未用、哪些是被其他视图内嵌调用的选择框/弹窗?**")
w("- 证据局限:本库无「按视图」访问日志,使用频率仅以 sys_menu 引用数为代理;选择框/Dialog/树等内嵌组件天然 menu_ref=0,**不等于未用**。")
w("- 需老员工现场区分:真未用 → 废弃;内嵌调用 → 维持降级/留旧。")
w("")
w(f"**(其余条目照单签)** 重写 {bk.get('重写',0)} / 降级 {bk.get('降级',0)} / 留旧 {bk.get('留旧',0)} / 废弃 {bk.get('废弃',0)},证据充分(全见源码),无需逐条讨论。")
w("")
w("---")
w("")
w("## 附:方法与口径")
w("- **DB 连接**:192.168.20.68:5435 **dbname=postgres**(非 ceshi 库)/ schema eip3,153 条全量命中。")
w("- **源码基准(全见源码升级)**:EIP-3.0/(hr/pm/oa/dm 业务 addon + framework,参数化 `EIP3_SRC`)。"
"全树建「简单类名→路径」索引,engineclass 完整包路径最长后缀消歧。")
w("- 使用度信号:sys_menu.view_templateid → view_template 的引用计数(**本库无按视图访问日志**,如实标注)。")
w("- 源码复杂度:定位 .java → 真实行数 + 组件谱(Window/Table/Tree/Upload/Chart/Gantt/Canvas/iframe/Wizard)+ 外部依赖(PDF/Excel/设备/打印)+ CRUD 包装判定。")
w("- 三分判定:按 v1 文档第一节决策树,用真实证据(行数/组件/依赖/使用度)而非类名;名称含「未用/暂时不用/测试/废」直接判废弃。")
w("- 工时定档:重写 2–4 人日(按真实行数 <250/<500/≥500 与组件谱)、降级 0.75(导入导出 1.0)、留旧 0.25、废弃 0。")
w("- 复跑:`bash 分析脚本/00_run_all.sh`(连 postgres 库导出 DB 证据 → Python 全见源码采集 → 生成 CSV+stats+md)。")
open(f"{OUTDIR}/终判评审材料.md", "w", encoding="utf-8").write("\n".join(L)+"\n")
print("written:", f"{OUTDIR}/终判评审材料.md", "lines:", len(L))