Merge remote-tracking branch 'origin/dev' into main_laptop_1

resources/tester/test_master_labels_cover.py

@@ -95,9 +95,13 @@ def _scan(path: Path) -> tuple[list, list]:
     return tables, values
 
 
+#: 사전 모양 표의 **줄 이름 열** — API 가 이 이름으로 내보낸다(2026-09-15 브레인 ①).
+ROW_KEY_COLUMN = "@key"
+
+
 def _columns_of(node, shape: str) -> list[str]:
     records = node if shape == "list" else list(node.values())
-    seen: list[str] = []
+    seen: list[str] = [ROW_KEY_COLUMN] if shape == "map" else []
     for record in records:
         if not isinstance(record, dict):
             continue
@@ -281,3 +285,87 @@ def test_세어_둔_수가_실제와_같다(labels):
 
 def test_강우_IDF_캐시는_안_담았다(labels):
     assert not [f for f in labels["files"] if "rainfall" in f["path"]]
+
+
+def test_사전_모양_표에는_줄_이름_열이_있다(labels):
+    """`fx`·`oil` 처럼 사전 모양인 표는 **줄 이름(키) 자체가 한 열**이다.
+    그 열이 없으면 화면에 영문 `@key` 로 뜬다(2026-09-15 브레인 ①)."""
+    bad = []
+    for entry in labels["files"]:
+        for table in entry["tables"]:
+            if table["shape"] != "map":
+                continue
+            first = table["columns"][0] if table["columns"] else None
+            if first is None or first["key"] != ROW_KEY_COLUMN:
+                bad.append(f"{entry['file_id']}::{table['key']} — 줄 이름 열 없음")
+            elif not first["name_ko"].strip():
+                bad.append(f"{entry['file_id']}::{table['key']} — 줄 이름 열에 한글 이름 없음")
+            elif not first.get("is_row_key"):
+                bad.append(f"{entry['file_id']}::{table['key']} — is_row_key 표시 없음")
+    assert not bad, f"줄 이름 열 문제: {bad}"
+
+
+def test_줄_이름_열은_사전_모양_표에만_있다(labels):
+    stray = [
+        f"{entry['file_id']}::{table['key']}"
+        for entry in labels["files"]
+        for table in entry["tables"]
+        if table["shape"] != "map" and any(c["key"] == ROW_KEY_COLUMN for c in table["columns"])
+    ]
+    assert not stray, f"사전 모양이 아닌데 줄 이름 열이 있다: {stray}"
+
+
+def test_줄_이름_열의_이름이_표마다_제_것이다(labels):
+    """뜻이 표마다 다르므로 한 이름으로 뭉치면 안 된다 — 같은 이름이 겹치면 살펴볼 것."""
+    names = [
+        column["name_ko"]
+        for entry in labels["files"]
+        for table in entry["tables"]
+        for column in table["columns"]
+        if column["key"] == ROW_KEY_COLUMN
+    ]
+    assert names, "줄 이름 열이 하나도 없다"
+    # 「출처 키」만 두 표가 같은 뜻으로 쓴다(출처 사전 둘). 그 밖은 겹치지 않는다.
+    duplicated = {n for n in names if names.count(n) > 1}
+    assert duplicated <= {"출처 키"}, f"줄 이름이 겹친다: {sorted(duplicated)}"
+
+
+def test_값_묶음마다_값이냐_설명이냐가_적혀_있다(labels):
+    known = set(labels["value_roles"])
+    bad = []
+    for entry in labels["files"]:
+        for group in entry["value_groups"]:
+            if group.get("role") not in known:
+                bad.append(f"{entry['file_id']}::{group['key']} — {group.get('role')!r}")
+    assert not bad, f"값·설명이 안 갈린 값 묶음: {bad}"
+
+
+def test_값_갈래_잣대가_이름표에_적혀_있다(labels):
+    rule = labels["policy"]["value_role_rule"]
+    assert "금액이 움직이나" in rule
+    assert labels["policy"]["row_key_column"]
+
+
+def test_한_값짜리_요율은_값으로_선다(labels):
+    """산재 3.56 % 처럼 원가에 그대로 드는 요율이 설명으로 숨으면 트리에서 사라진다."""
+    rates = next(f for f in labels["files"] if f["file_id"] == "rates")
+    by_key = {g["key"]: g["role"] for g in rates["value_groups"]}
+    for key in (
+        "variables/rate_sanjae",
+        "variables/rate_health",
+        "variables/rate_care",
+        "variables/rate_vat",
+        "variables/rate_retirement_mutual_aid",
+        "variables/rate_wage_claim_contribution",
+        "variables/rate_asbestos_contribution",
+    ):
+        assert by_key.get(key) == "value", f"{key} 가 값으로 안 섰다"
+    assert by_key.get("processing_rules") == "note"
+
+
+def test_세어_둔_갈래_수가_실제와_같다(labels):
+    counted: dict[str, int] = {}
+    for entry in labels["files"]:
+        for group in entry["value_groups"]:
+            counted[group["role"]] = counted.get(group["role"], 0) + 1
+    assert counted == labels["counts"]["value_groups_by_role"]