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,36 @@
#!/usr/bin/env bash
# =============================================================================
# 00_run_all.sh — 一键复跑 153 终判证据包(只读客户库 + 只读 EIP-3.0 全见源码)
# 用法:bash 00_run_all.sh
# 产物:../终判建议表.csv ../终判评审材料.md ../stats.json
# 数据源:192.168.20.68:5435 库 postgres schema eip3 账号 ceshi/ceshi(只读)
#
# 【2026-06-11 全见源码升级】源码基准从 eip3/framework(仅核心平台,106 MISSING 盲判)
# 切换到苏州五建完整 OSGi 源码全集 EIP-3.0/(hr/pm/oa/dm 业务 addon + framework)。
# 可用环境变量 EIP3_SRC 覆盖源码根(默认 /Users/zhengwr/workspace/EIP-3.0):
# EIP3_SRC=/path/to/EIP-3.0 bash 00_run_all.sh
# 现 152/153 全见源码,1 个疑废弃(SupplierResearchCaseView)。
#
# ⚠️ 已知坑:5435 上必须连 dbname=postgres(非 ceshi 库)。
# postgres 库 eip3 schema = 153 条全量;ceshi 库同名 schema 仅 103 条旧副本。
# 曾误连 ceshi 导致"81 个不在快照"假象,已订正。
# =============================================================================
set -euo pipefail
HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
export PGPASSWORD=ceshi
PGCONN=(psql -h 192.168.20.68 -p 5435 -U ceshi -d postgres)
echo "[1/3] 导出 DB 侧证据(engineclass 聚合 + 菜单引用)..."
"${PGCONN[@]}" -v ON_ERROR_STOP=1 <<'SQL'
\copy (SELECT v.engineclass, count(*) AS template_cnt, max(length(v.xml::text)) AS xml_bytes_max, sum(length(v.xml::text)) AS xml_bytes_sum, max(v.isactive) AS any_active FROM eip3.view_template v WHERE v.engineclass IS NOT NULL AND v.engineclass <> '' GROUP BY v.engineclass ORDER BY v.engineclass) TO '/tmp/db_ec_agg.csv' CSV HEADER
\copy (SELECT v.engineclass, count(DISTINCT m.sys_menu_id) AS menu_ref_cnt FROM eip3.view_template v LEFT JOIN eip3.sys_menu m ON m.view_templateid = v.view_template_id WHERE v.engineclass IS NOT NULL AND v.engineclass <> '' GROUP BY v.engineclass ORDER BY v.engineclass) TO '/tmp/db_ec_menu.csv' CSV HEADER
SQL
echo "[2/3] 采集源码复杂度 + 决策树定档 → 终判建议表.csv / stats.json ..."
python3 "$HERE/02_build_evidence.py"
echo "[3/3] 渲染评审材料 → 终判评审材料.md ..."
python3 "$HERE/03_render_review.py"
echo "完成。产物位于 $(cd "$HERE/.." && pwd)"

View File

@@ -0,0 +1,65 @@
-- =============================================================================
-- 01_db_evidence.sql — 153 定制视图 DB 侧证据采集(只读)
-- 数据源:192.168.20.68:5435 库 postgres schema eip3 账号 ceshi/ceshi(只读)
-- 运行:PGPASSWORD=ceshi psql -h 192.168.20.68 -p 5435 -U ceshi -d postgres -f 01_db_evidence.sql
--
-- ⚠️ 已知坑(迁移手册):5435 上有两个库——
-- • postgres 库(dbname=postgres,currentSchema=eip3)← 正确口径,153 条全量
-- • ceshi 库(dbname=ceshi, currentSchema=eip3)← 旧副本,仅 103 条,数据不全
-- JDBC 连接串写作 ?currentSchema=eip3 时对应的 dbname=postgres,务必连 postgres 库。
-- 若误连 ceshi 库,将得到"81 个不在快照"的假象,本文件首次版本曾犯此错已订正。
-- =============================================================================
\pset footer off
SET search_path TO eip3, public;
-- 0) 健康检查:应为 153(全量精确命中)
\echo '== [0] view_template 中 engineclass 非空模板数(本快照)=='
SELECT count(*) AS engineclass_templates_in_snapshot
FROM view_template
WHERE engineclass IS NOT NULL AND engineclass <> '';
-- 1) 按 engineclass 聚合:模板数、XML 字节数(最大/合计)、是否带菜单
-- XML 大小作为 UI 复杂度的辅助信号;同一 engineclass 可能被多个模板复用。
\echo '== [1] 按 engineclass 聚合 XML 大小与模板数 =='
SELECT
v.engineclass,
count(*) AS template_cnt,
max(length(v.xml::text)) AS xml_bytes_max,
sum(length(v.xml::text)) AS xml_bytes_sum,
max(v.isactive) AS any_active
FROM view_template v
WHERE v.engineclass IS NOT NULL AND v.engineclass <> ''
GROUP BY v.engineclass
ORDER BY v.engineclass;
-- 2) 菜单引用:每个 engineclass 被多少条菜单引用(使用度信号,无独立访问日志可用)
-- 关联:sys_menu.view_templateid -> view_template.view_template_id
\echo '== [2] engineclass 的菜单引用数(使用度代理信号)=='
SELECT
v.engineclass,
count(DISTINCT m.sys_menu_id) AS menu_ref_cnt,
string_agg(DISTINCT m.name, ' | ' ORDER BY m.name) FILTER (WHERE m.name IS NOT NULL) AS menu_names
FROM view_template v
LEFT JOIN sys_menu m ON m.view_templateid = v.view_template_id
WHERE v.engineclass IS NOT NULL AND v.engineclass <> ''
GROUP BY v.engineclass
ORDER BY menu_ref_cnt DESC, v.engineclass;
-- 3) 单模板明细(含 view_template_id),供按 ID 精确回填
\echo '== [3] 单模板明细(id|name|engineclass|xml_bytes|menu_ref)=='
SELECT
v.view_template_id,
v.name,
v.engineclass,
length(v.xml::text) AS xml_bytes,
v.isactive,
(SELECT count(*) FROM sys_menu m WHERE m.view_templateid = v.view_template_id) AS menu_ref_cnt
FROM view_template v
WHERE v.engineclass IS NOT NULL AND v.engineclass <> ''
ORDER BY v.engineclass, v.name;
-- 4) 访问日志能力侦察:本库无「按视图」的访问日志表,sys_userlogin_history 仅为登录历史(全局)
-- sys_log / sys_data_log 为操作日志,未按 view_template 维度归集。故使用频率以菜单引用数为唯一代理。
\echo '== [4] 登录历史表行数(仅证明无按视图访问日志,使用频率以菜单引用为代理)=='
SELECT count(*) AS login_history_rows FROM sys_userlogin_history;

View File

@@ -0,0 +1,452 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
02_build_evidence.py — 153 定制视图「带证据的终判草案」批量生成器(可复跑)
输入:
- 153视图全量清单.txt(id|名称|engineclass,权威全量来源 = 盘点报告)
- framework 源码树(只读 grep 复杂度)
- DB 侧证据 CSV(由 01_db_evidence.sql / 本脚本内联导出生成)
输出:
- 终判建议表.csv(153 行)
- stats.json(四分类/工时/MISSING/Top10 汇总,供评审材料引用)
判定逻辑(基于证据,非类名):见 decide() 注释,落地 v1 文档第一节决策树。
"""
import csv, json, os, re, subprocess, sys
from collections import defaultdict
# ---- 路径 ----
ROOT = "/Users/zhengwr/workspace/eip3"
TXT = f"{ROOT}/docs/M0交付/153视图全量清单.txt"
# 【2026-06-11 全见源码升级】源码基准从 eip3/framework(仅核心平台)扩展到苏州五建完整 OSGi 源码全集 EIP-3.0/。
# EIP-3.0 = 完整源码(带 git,最近提交「苏州五建包更新版本号」):hr/pm/oa/dm 业务 addon + framework 核心。
# 原 106 个 MISSING 的真相 = 业务 addon「在另一仓库」(EIP-3.0),并非废弃。现 152/153 全见源码,1 个疑废弃。
# 可用环境变量 EIP3_SRC 覆盖源码根(默认 /Users/zhengwr/workspace/EIP-3.0),脚本对路径参数化。
EIP3_SRC = os.environ.get("EIP3_SRC", "/Users/zhengwr/workspace/EIP-3.0")
SRC_ROOTS = [f"{EIP3_SRC}/hr", f"{EIP3_SRC}/pm", f"{EIP3_SRC}/oa",
f"{EIP3_SRC}/dm", f"{EIP3_SRC}/framework"]
SRC_ROOTS = [p for p in SRC_ROOTS if os.path.isdir(p)]
# 兜底:若 EIP-3.0 不可用,退回旧的 framework-only 口径(会复现 106 MISSING,仅作降级保护)
if not SRC_ROOTS:
SRC_ROOTS = [f"{ROOT}/framework"]
OUTDIR = f"{ROOT}/docs/M0交付/153终判证据包"
DB_AGG = "/tmp/db_ec_agg.csv" # engineclass,template_cnt,xml_bytes_max,xml_bytes_sum,any_active
DB_MENU = "/tmp/db_ec_menu.csv" # engineclass,menu_ref_cnt
# ⚠️ 已知坑:上方两个 CSV 须由 00_run_all.sh(或手工 \copy)从 dbname=postgres 导出。
# 5435 上存在两库:postgres(153 条全量,正确口径)/ ceshi(103 条旧副本,数据不全)。
# 若 CSV 来自 ceshi 库,将出现大量"菜单引用=无数据/XML=无数据"假象。曾犯此错,已订正。
# 疑废弃类:客户库 view_template 有此 engineclass,但 EIP-3.0 无对应 .java;同模块有近似类(疑改名/废弃)。
SUSPECT_DEPRECATED = {
"com.dsasp.pm.materialsuppliermanagement.client.view.SupplierResearchCaseView":
"同模块 com.dsasp.pm.materialsuppliermanagement 存在近似类 SupplierResearchView/SupplierResearchWindowView/SupplierResearchCaseWindow,疑改名或废弃",
}
# ---- 组件谱:Vaadin / dsasp 自定义 / 外部库 关键词(按 import 与 new 检测)----
# 重组件(推高复杂度,倾向重写)
HEAVY_COMPONENTS = {
"Tree": [r"\bTree\b", r"\bTreeTable\b", r"ExTree", r"TreeGrid"],
"Upload": [r"\bUpload\b", r"MultiFileUpload", r"easyuploads", r"swfupload"],
"Chart": [r"\bChart\b", r"invient", r"highcharts", r"DCharts"],
"Gantt": [r"Gantt", r"SchedulerGantt"],
"Canvas": [r"dscanvas", r"\bCanvas\b"],
"BrowserFrame/iframe": [r"BrowserFrame", r"\bEmbedded\b", r"ExBrowserFrame"],
"Window/Dialog": [r"\bWindow\b", r"\bDialog\b"],
"Wizard/MultiStep": [r"Wizard", r"Stepper"], # TabSheet 过于常见,不计入重组件
"TabSheet": [r"TabSheet"],
"Calendar": [r"\bCalendar\b", r"DateField"],
}
# CRUD 包装信号(只用这些 => 低复杂、可降级)
CRUD_COMPONENTS = [r"PagedTable", r"\bTable\b", r"BeanFieldGroup", r"FieldGroup",
r"FormLayout", r"\bForm\b", r"SearchComponent"]
# 外部依赖(打印/设备/第三方)
EXTERNAL_DEPS = {
"PDF(itext/lowagie)": [r"import com\.itextpdf", r"import com\.lowagie"],
"Excel(poi/jxl)": [r"import org\.apache\.poi", r"import jxl"],
"Report(jasper/jor)": [r"jasperreports", r"\bJasper", r"\.jrxml"],
"Device(实名制/考勤机/串口)": [r"\bSerialPort\b", r"javax\.comm", r"gnu\.io", r"\bRXTX",
r"考勤机", r"读卡器", r"刷卡"],
"Print(打印)": [r"java\.awt\.print", r"PrinterJob", r"javax\.print", r"打印"],
}
def sh(args):
try:
return subprocess.run(args, capture_output=True, text=True, timeout=60).stdout
except Exception:
return ""
# ---- 全见源码定位:预建「简单类名 -> [路径]」索引(一次 find 扫全树,比逐类 find 快得多)----
_SRC_INDEX = None
def _build_src_index():
global _SRC_INDEX
if _SRC_INDEX is not None:
return _SRC_INDEX
idx = defaultdict(list)
for root in SRC_ROOTS:
out = sh(["find", root, "-name", "*.java", "-type", "f"])
for p in out.splitlines():
if p.strip():
idx[os.path.basename(p)[:-5]].append(p) # 去 .java
_SRC_INDEX = idx
return idx
def find_class_file(engineclass):
"""class fqn -> source file path or None。
全见源码版:在 EIP-3.0 hr/pm/oa/dm/framework 全树按简单类名定位;
同名多文件时用 engineclass 完整包路径做「最长后缀」消歧(已验证 17 个同名类 0 存疑)。
注意:OSGi addon 目录名可能与包名不同(如目录 com.dsasp.pm.projectprocess 内含包 com.dsasp.pm.process),
故以包路径片段匹配而非目录名匹配。"""
idx = _build_src_index()
simple = engineclass.split(".")[-1]
paths = idx.get(simple, [])
if not paths:
return None
if len(paths) == 1:
return paths[0]
segs = engineclass.split(".")
best, best_len = None, 0
for path in paths:
norm = path.replace("\\", "/")
for k in range(len(segs), 1, -1):
tail = "/".join(segs[len(segs) - k:]) # 末 k 段(含类名)
if tail in norm:
if k > best_len:
best, best_len = path, k
break
return best or paths[0]
def analyze_source(path):
"""返回 (loc, comp_spectrum_list, external_deps_list, is_crud_wrapper)"""
try:
with open(path, encoding="utf-8", errors="ignore") as f:
text = f.read()
except Exception:
return (0, [], [], False)
loc = text.count("\n") + 1
comps = []
for label, pats in HEAVY_COMPONENTS.items():
if any(re.search(p, text) for p in pats):
comps.append(label)
deps = []
for label, pats in EXTERNAL_DEPS.items():
if any(re.search(p, text) for p in pats):
deps.append(label)
# CRUD 包装判定:命中 CRUD 组件,且未命中任何 “真正的重组件”(Tree/Upload/Chart/Gantt/Canvas/BrowserFrame/Wizard)
real_heavy = {"Tree", "Upload", "Chart", "Gantt", "Canvas", "BrowserFrame/iframe", "Wizard/MultiStep"}
has_crud = any(re.search(p, text) for p in CRUD_COMPONENTS)
has_real_heavy = bool(set(comps) & real_heavy)
is_crud_wrapper = has_crud and not has_real_heavy and loc < 600
return (loc, comps, deps, is_crud_wrapper)
def load_db():
agg, menu = {}, {}
if os.path.exists(DB_AGG):
for r in csv.DictReader(open(DB_AGG, encoding="utf-8")):
agg[r["engineclass"]] = r
if os.path.exists(DB_MENU):
for r in csv.DictReader(open(DB_MENU, encoding="utf-8")):
menu[r["engineclass"]] = int(r["menu_ref_cnt"])
return agg, menu
NAME_DISCARD = ["未用", "暂时不用", "测试", "(测试)", "(测试)", "废"]
def v1_bucket(ec):
"""v1 文档 §6.1 名称启发式初判归桶(A/B/C/D/E/F),用于回填「初判桶」列做初判→终判对照。"""
low = ec.lower()
if any(k in low for k in ["report", "pdf", "print", "account", "summary", "journal", "chart"]):
return "A.报表/PDF/台账(留旧)"
if any(k in low for k in ["research", "select", "window", "picker", "tree", "dialog"]):
return "B.选择窗/树/查询窗(降级)"
if any(k in low for k in ["manage", "config", "main", "info", "list"]):
return "C.管理CRUD(降级)"
if any(k in low for k in ["task", "process", ".wf.", "monitor", "workflow"]):
return "D.流程交互(重写)"
if any(k in low for k in ["import", "export", "send", "message", "input"]):
return "E.导入导出/消息(逐个)"
return "F.其他(逐个)"
def decide(row, src, db):
"""
基于证据的终判建议。决策树落地 v1 文档第一节。
优先级:废弃标记 > 报表/PDF/台账(留旧) > 设备依赖(重写) > 流程交互(重写)
> 富交互组件(重写) > 选择/查询窗(降级) > CRUD/管理(降级) > 导入导出(逐个) > 兜底
源码缺失(MISSING)时:仍按 名称+engineclass+DB 信号 走同一决策树,但工时记为「名义估算」,
并在证据摘要标注源码缺失(重大信号:留旧都需补丁包/可能已废弃)。
row: dict(id,name,engineclass);src: (loc,comps,deps,is_crud) 或 None;db: dict(menu_ref,xml_bytes,in_db)
返回 (bucket, mandays, reason);bucket ∈ {重写,降级,留旧,废弃}
"""
name = row["name"]
ec = row["engineclass"]
low = ec.lower()
# 疑废弃:客户库有模板但 EIP-3.0 全树无 .java,且同模块有近似类 → 优先判废弃候选
if ec in SUSPECT_DEPRECATED:
return ("废弃", 0.0, f"源码缺失-疑废弃:EIP-3.0 全树无对应 .java;{SUSPECT_DEPRECATED[ec]};建议客户确认是否已删/改名后剔除")
missing = src is None
if missing:
# 全见源码升级后,此分支仅剩「真正定位不到源码」的兜底(正常情况不应触发,仅作保护)
loc, comps, deps, is_crud = "MISSING", [], [], False
src_tag = "源码MISSING(EIP-3.0全树未定位,需核查)"
md_tag = "名义估算(源码缺失需核查)"
else:
loc, comps, deps, is_crud = src
src_tag = f"源码{loc}行"
md_tag = ""
# 真·amis 无对应物的重组件(触发重写):甘特/画布/图表/内嵌iframe/向导。
# Tree/Upload 由 amis tree-select/input-file 覆盖,不单独触发重写(只作为复杂度旁证)。
real_heavy = {"Chart", "Gantt", "Canvas", "BrowserFrame/iframe", "Wizard/MultiStep"}
heavy_hit = sorted(set(comps) & real_heavy)
has_pdf_dep = any(("PDF" in d) or ("Report" in d) for d in deps)
has_device = any("Device" in d for d in deps)
def loc_lt(n): # 行数阈值:MISSING 时取保守上档
return (not missing) and loc < n
# F0. 废弃候选:名称含废弃标记
if any(k in name for k in NAME_DISCARD):
return ("废弃", 0.0, "名称含废弃标记,建议客户确认后剔除(连留旧成本都省)")
# 工作流(审批) 与 项目进度计划(Gantt) 的区分:
# - workflow 审批流 = .client.wf. 包 或 类名含 workflow/任务(task)审批语义
# - .pm.process.ProjectProcess* = 项目「进度计划」(甘特/计划表),非审批流,不强制重写
is_wf = (".client.wf." in low) or any(k in low for k in ["workflow", "flowservice", "processmonitor",
"processdefinition", "processselect",
"processformremove", "sendtaskcomponent",
".task.component"])
is_schedule = ".pm.process." in low # 进度计划族(ProjectProcess*)
# 台账/日记账/journal/account 归报表族
is_journal = any(k in low for k in ["journal", "account", "buyaccount", "台账"]) or "台账" in name or "日记账" in name or "日志统计" in name
# A. 报表/PDF/打印/台账/图表/日记账 → 留旧(待 P4 报表方案 C 类),审批流例外
is_report = (any(k in low for k in ["pdf", "report", "chart", "print", "summary"]) or has_pdf_dep or is_journal)
if is_report and not is_wf:
return ("留旧", 0.25, f"报表/PDF/台账/图表/日记账类({src_tag},依赖={deps or '无'})→ 留旧,归 P4 报表方案 C 类")
# B. 设备/终端依赖(实名制考勤机/显示屏/串口)→ 重写
if has_device or any(k in low for k in ["shiming.view", "screen", "prjdevice"]):
md = 3.0 if loc_lt(400) else 4.0
return ("重写", md, f"设备/终端依赖({src_tag},组件={heavy_hit or comps or '名义'})→ 重写,需确认 PC/移动终端适配{(';'+md_tag) if md_tag else ''}")
# C. 工作流审批交互类(待办/已办/审批/监控/流程定义)→ 重写
if is_wf:
md = 3.0 if loc_lt(300) else 4.0
return ("重写", md, f"工作流审批交互类({src_tag},组件={heavy_hit or comps or '名义'})→ 重写,amis 无现成对应,待 P3 Flowable REST 稳定{(';'+md_tag) if md_tag else ''}")
# C2. 项目进度计划族(甘特/计划表)→ 重写(有甘特组件) 或 降级(纯表格计划)
if is_schedule:
if (not missing and heavy_hit):
md = 3.0 if loc_lt(500) else 4.0
return ("重写", md, f"项目进度计划+富组件 {heavy_hit}({src_tag})→ 重写(甘特/计划交互)")
# MISSING 或无甘特证据:保守降级(计划表本质为结构化表格),止损预案优先压低成本
return ("降级", 1.0, f"项目进度计划族({src_tag})→ 降级为 amis 表格/计划视图;若实为甘特需升级重写(待过堂){(';'+md_tag) if md_tag else ''}")
# D. 真·重组件命中(甘特/画布/图表/iframe/向导,amis 无对应物)→ 重写
# 注意:放在选择窗/CRUD 之前,因这类组件即便出现在管理视图里也无法降级。
if heavy_hit:
md = 2.0 if loc_lt(250) else (3.0 if loc_lt(500) else 4.0)
return ("重写", md, f"amis 无对应物的重组件命中 {heavy_hit}({src_tag})→ 重写为 React/amis 自定义渲染器")
# E. 选择窗/树/查询窗 → 降级(amis tree-select/picker 标准对应物,Tree 也由其覆盖)
if any(k in low for k in ["select", "window", "picker", "dialog", "research"]) or "选择" in name:
tree_note = "(含组织树,amis tree-select 覆盖)" if (comps and "Tree" in comps) else ""
return ("降级", 0.75, f"选择/查询窗类{tree_note}({src_tag})→ 降级为 amis tree-select/picker,需确认多级过滤{(';'+md_tag) if md_tag else ''}")
# F. CRUD 包装 / 标准管理列表(含树形 CRUD)→ 降级
if is_crud or any(k in low for k in ["manage", "config", "main", "info", "list", "edit", "setting"]):
tree_note = "(树形列表,amis tree/crud 覆盖)" if (comps and "Tree" in comps) else ""
return ("降级", 0.75, f"标准 CRUD/管理列表{tree_note}({src_tag},CRUD包装={'是' if is_crud else '否/名义'})→ 降级走批量转换器+手工配置{(';'+md_tag) if md_tag else ''}")
# G. 导入导出/消息 → 逐个:仅当行数很高(复杂字段映射UI)才重写,否则降级
# Upload/Excel 由 amis input-file/input-excel 覆盖,不单独触发重写。
if any(k in low for k in ["import", "export", "upload", "input", "send", "message"]):
if (not missing and loc > 500):
return ("重写", 2.5, f"导入导出类但交互重({src_tag},组件={comps},疑含复杂字段映射UI)→ 重写")
return ("降级", 1.0, f"导入导出/消息类({src_tag})→ 降级用 amis input-excel/input-file{(';'+md_tag) if md_tag else ''}")
# H. 兜底:低复杂降级、否则留旧
if not missing and loc < 200:
return ("降级", 0.75, f"低复杂未命中启发式({src_tag})→ 降级候选,终判过堂确认")
return ("留旧", 0.25, f"未命中启发式({src_tag})→ 留旧候选,终判过堂确认{(';'+md_tag) if md_tag else ''}")
def main():
rows = []
with open(TXT, encoding="utf-8") as f:
for line in f:
line = line.strip()
if "|" not in line:
continue # 跳过 SET 头
parts = line.split("|")
if len(parts) < 3:
continue
rows.append({"id": parts[0].strip(), "name": parts[1].strip(), "engineclass": parts[2].strip()})
db_agg, db_menu = load_db()
out_rows, stats = [], {
"total": 0, "buckets": defaultdict(int), "mandays": defaultdict(float),
"missing": [], "deprecated": [], "rewrite_detail": [],
"in_db": 0, "not_in_db": 0, "src_located": 0, "src_missing": 0,
}
detail = [] # 供 S1 止损场景与去重分析
for r in rows:
ec = r["engineclass"]
is_deprecated = ec in SUSPECT_DEPRECATED
path = None if is_deprecated else find_class_file(ec)
src = analyze_source(path) if path else None
in_db = ec in db_agg
menu_ref = db_menu.get(ec, "")
# xml_bytes_max 为空字符串表示模板存在但 xml 字段为 NULL(23 条已知情况)
# 用 "null(xml为空)" 区分"模板不存在"的情况,避免与旧版 ceshi 库 "无数据" 混淆
if in_db:
raw_xml = db_agg[ec]["xml_bytes_max"]
xml_bytes = raw_xml if raw_xml != "" else "null(模板存在,xml为空)"
else:
xml_bytes = "无数据(模板不存在)"
bucket, md, reason = decide(r, src, {"menu_ref": menu_ref, "xml_bytes": xml_bytes, "in_db": in_db})
# 源码绝对路径(全见源码新列);疑废弃标注,真缺失标注
if is_deprecated:
src_path = "源码缺失-疑废弃"
elif path:
src_path = path
else:
src_path = "未定位"
loc = src[0] if src else ("废弃" if is_deprecated else "MISSING")
comps = "/".join(src[1]) if src else ""
deps = "/".join(src[2]) if src else ""
crud = ("是" if src and src[3] else "否") if src else ""
# 待人工确认点
confirm = []
if is_deprecated:
confirm.append("疑废弃:确认是否已删/改名(同模块有近似类)后剔除")
elif src is None:
confirm.append("源码未定位,需核查 engineclass 拼写/包路径")
if bucket == "重写":
confirm.append("交互细节/终端适配/REST 依赖")
if bucket == "降级":
confirm.append("是否有特殊批量/权限/多级过滤")
if menu_ref == 0:
confirm.append("菜单引用=0,是否仍在用")
if menu_ref == "":
confirm.append("本快照无该模板,使用频率无数据")
out_rows.append({
"id": r["id"], "name": r["name"], "engineclass": ec,
"源码路径": src_path, # 全见源码新列:.java 绝对路径 / 源码缺失-疑废弃 / 未定位
"源码行数": loc, "组件谱": comps, "外部依赖": deps, "CRUD包装": crud,
"菜单引用数": menu_ref if menu_ref != "" else "无数据",
"XML大小(bytes)": xml_bytes, # 已在上方赋值时区分:数字/null(模板存在,xml为空)/无数据(模板不存在)
"初判桶": v1_bucket(ec), # v1 §6.1 名称启发式归桶,供初判→终判对照
"终判建议": bucket, "工时(人日)": md,
"证据摘要": reason,
"待人工确认点": ";".join(confirm) or "无",
})
stats["total"] += 1
stats["buckets"][bucket] += 1
stats["mandays"][bucket] += md
if in_db: stats["in_db"] += 1
else: stats["not_in_db"] += 1
if is_deprecated:
stats["deprecated"].append({"id": r["id"], "name": r["name"], "engineclass": ec,
"note": SUSPECT_DEPRECATED[ec]})
elif path:
stats["src_located"] += 1
else:
stats["src_missing"] += 1
stats["missing"].append({"id": r["id"], "name": r["name"], "engineclass": ec})
if bucket == "重写":
stats["rewrite_detail"].append({"name": r["name"], "engineclass": ec,
"loc": loc, "comps": comps, "md": md})
detail.append({"name": r["name"], "ec": ec, "bucket": bucket, "md": md,
"menu_ref": (menu_ref if menu_ref != "" else None),
"in_db": in_db, "missing_src": src is None})
# 写 CSV
os.makedirs(OUTDIR, exist_ok=True)
csv_path = f"{OUTDIR}/终判建议表.csv"
cols = ["id","name","engineclass","源码路径","源码行数","组件谱","外部依赖","CRUD包装",
"菜单引用数","XML大小(bytes)","初判桶","终判建议","工时(人日)","证据摘要","待人工确认点"]
with open(csv_path, "w", encoding="utf-8-sig", newline="") as f:
w = csv.DictWriter(f, fieldnames=cols)
w.writeheader()
w.writerows(out_rows)
# 汇总
stats["buckets"] = dict(stats["buckets"])
stats["mandays"] = {k: round(v, 2) for k, v in stats["mandays"].items()}
stats["total_mandays"] = round(sum(stats["mandays"].values()), 2)
stats["total_manmonths"] = round(stats["total_mandays"] / 21.0, 2) # 21 人日/月
stats["rewrite_detail"].sort(key=lambda x: (-x["md"], str(x["loc"])), reverse=False)
# Top10 最贵重写:按工时降序,再按行数降序
def loc_num(v):
try: return int(v)
except: return -1
stats["top10_rewrite"] = sorted(
stats["rewrite_detail"], key=lambda x: (x["md"], loc_num(x["loc"])), reverse=True
)[:10]
# ---- 去重红利:同一 engineclass 被多个视图复用,重写/降级只做一次,复用项按登记成本 ----
by_ec = defaultdict(list)
for d in detail:
by_ec[d["ec"]].append(d)
dup_classes = {ec: ds for ec, ds in by_ec.items() if len(ds) > 1}
dedup_saving = 0.0
dup_report = []
for ec, ds in dup_classes.items():
if ds[0]["bucket"] in ("重写", "降级"):
# 首个全价,其余按 0.25 登记成本
extra = len(ds) - 1
saved = sum(d["md"] for d in ds[1:]) - extra * 0.25
dedup_saving += max(saved, 0)
dup_report.append({"ec": ec, "count": len(ds), "bucket": ds[0]["bucket"], "saved": round(max(saved,0),2)})
stats["dedup_classes"] = sorted(dup_report, key=lambda x: -x["saved"])
stats["dedup_saving_mandays"] = round(dedup_saving, 2)
# ---- S1 止损场景:base 超 3 人月时,按止损预案把「低价值降级」降为留旧 ----
# 低价值判据:降级 且 (菜单引用=0 或 本快照无数据[无法转换]) → 留旧(0.25)
base_md = stats["total_mandays"]
s1_rows = []
s1_md = base_md
s1_demoted = 0
for d in detail:
if d["bucket"] == "降级":
# 低价值判据(postgres 库全量 153 条都在库,所以 not in_db 不再触发):
# 仅剩 menu_ref=0(菜单无引用,疑似未用或纯内嵌组件)
low_value = (d["menu_ref"] == 0)
if low_value:
s1_md += (0.25 - d["md"]) # 降级md -> 留旧0.25
s1_demoted += 1
s1_rows.append({"name": d["name"], "ec": d["ec"],
"why": "菜单引用=0,疑似未用或内嵌选择框/弹窗(需老员工区分)"})
s1_md = round(s1_md, 2)
stats["s1_scenario"] = {
"trigger": base_md / 21.0 > 3.0,
"demoted_count": s1_demoted,
"demoted_to_legacy": s1_rows,
"mandays_after": s1_md,
"manmonths_after": round(s1_md / 21.0, 2),
"mandays_after_dedup": round(s1_md - dedup_saving, 2),
"manmonths_after_dedup": round((s1_md - dedup_saving) / 21.0, 2),
}
stats["stop_loss_line_manmonths"] = 3.0
with open(f"{OUTDIR}/stats.json", "w", encoding="utf-8") as f:
json.dump(stats, f, ensure_ascii=False, indent=2)
# 控制台摘要
print("=== 四分类 ===")
for k in ["重写","降级","留旧","废弃"]:
print(f" {k}: {stats['buckets'].get(k,0)} 个 / {stats['mandays'].get(k,0)} 人日")
print(f"基线总工时: {stats['total_mandays']} 人日 = {stats['total_manmonths']} 人月 (止损线 3 人月)")
s1 = stats["s1_scenario"]
print(f"S1止损场景: 降级->留旧 {s1['demoted_count']} 个 => {s1['manmonths_after']} 人月; 叠加去重红利 {stats['dedup_saving_mandays']} 人日 => {s1['manmonths_after_dedup']} 人月")
print(f"源码定位(全见): {stats['src_located']} 个 / 疑废弃: {len(stats['deprecated'])} 个 / 真缺失: {stats['src_missing']} 个")
print(f"本快照有DB数据: {stats['in_db']} / 无: {stats['not_in_db']}")
print(f"重复 engineclass(可批量): {len(stats['dedup_classes'])} 组")
print(f"CSV: {csv_path}")
if __name__ == "__main__":
main()

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))