数据目录 F2b:剖析报告和目录页读结构化字段,不再从原话里认——服务端最小改动:码值候选的结论带 pending(还有几个含义待填写),关系的结论带 cardinality_checked;报告里「N 个含义待填写」读 pending,基数写「已用数据核实」或「子表一侧未核实」读 cardinality_checked,挑表时跳过的空表读 empty_tables 列出来;表详情的关联关系标出基数已核实;剖析说明不带日期后,码值弹窗的说明后面按这一项的 updated_at 写时间;补后端测试和检查脚本的断言(假答复的 summary 不再写待填写)

This commit is contained in:
ThearchyHelios
2026-10-04 03:06:14 +08:00
parent 5b3839f787
commit ab9d45c428
8 changed files with 75 additions and 21 deletions
+7 -4
View File
@@ -930,7 +930,8 @@ async def _check_dates(cx: _Context, table: str, columns: list[str], total: int,
def _relation_finding(o: _RelationOutcome, rel: dict[str, Any], *, status: str, confirmed: bool) -> dict[str, Any]:
"""一条关系的核实结论。previous_status 是剖析之前目录里这条关系的状态:报告按它说「升为已验证」还是「仍为已验证」
(重新剖析、目录没变时不能说升了)。"""
(重新剖析、目录没变时不能说升了);cardinality_checked:基数是不是用数据核实的(子表一侧数过是否唯一),
报告据此写「已用数据核实」,不从说明的原话里认。"""
previous = rel.get("status")
if confirmed:
summary = "已人工确认,只补充覆盖率和基数"
@@ -943,8 +944,8 @@ def _relation_finding(o: _RelationOutcome, rel: dict[str, Any], *, status: str,
return {"kind": "relation", "path": f"relations.{o.rid}", "target": o.target,
"columns": list(rel.get("columns") or []), "to_table": rel.get("to_table"),
"to_columns": list(rel.get("to_columns") or []), "status": status, "confirmed": confirmed,
"previous_status": previous, "coverage": o.coverage, "cardinality": o.cardinality, "sample": o.sample,
"matched": o.matched, "summary": summary}
"previous_status": previous, "coverage": o.coverage, "cardinality": o.cardinality,
"cardinality_checked": o.cardinality_checked, "sample": o.sample, "matched": o.matched, "summary": summary}
def _codes_value(c: _CodesOutcome, item: dict[str, Any] | None) -> dict[str, str]:
@@ -959,11 +960,13 @@ def _codes_value(c: _CodesOutcome, item: dict[str, Any] | None) -> dict[str, str
def _codes_finding(c: _CodesOutcome, value: dict[str, str]) -> dict[str, Any]:
"""码值候选的结论。pending:写进目录的码值里还有几个含义空着(别的来源写过的含义会沿用),报告按它说
「N 个含义待填写」,不从 summary 的原话里认。"""
pending = sum(1 for v in value.values() if not v.strip())
summary = f"{len(c.values)} 个取值" + (f",{pending} 个含义待填写" if pending else "")
return {"kind": "codes", "path": f"columns.{c.column}.codes", "column": c.column,
"values": [{"value": k, "rows": n} for k, n in c.values], "rows": c.rows, "status": "proposed",
"summary": summary}
"pending": pending, "summary": summary}
def _patch_confirmed(rel: dict[str, Any], o: _RelationOutcome, at: str) -> bool:
+5
View File
@@ -231,6 +231,11 @@ async def test_profile_verifies_name_relations_and_proposes_codes_and_business_d
gate = next(f for f in visits["findings"] if f["kind"] == "relation" and f["columns"] == ["gate_id"])
assert gate["status"] == "verified" and gate["path"] == f"relations.{_relation(notes, 'gate_id')['id']}"
assert gate["sample"] == 8 and gate["matched"] == 8 and gate["summary"]
# 结构化的字段:基数用数据核实过没有、码值还有几个含义待填写(界面读这些,不从原话里认)
assert isinstance(gate["cardinality_checked"], bool)
codes = next(f for f in visits["findings"] if f["kind"] == "codes")
blank = sum(1 for v in notes["columns"][codes["column"]]["codes"]["value"].values() if not v.strip())
assert codes["pending"] == blank and (f"{blank} 个含义待填写" in codes["summary"]) == (blank > 0)
assert visits["row_estimate"] == {"rows": 1500, "method": "count", "at_least": None}
assert visits["added"] == 2 and visits["updated"] == 2 and visits["error"] is None