Merge remote-tracking branch 'origin/sub_laptop_1' into main_laptop_1 — 서브 갈래마다 한 줄(산림 627)·총칙 기본 감춤·이름표 읽기 받음 · 「연결됨」·줄 구실 칸을 갈래 줄에 얹음(공종 열쇠 @key 로 판정) · 연결 시험은 표가 붙은 줄만 잼(묶는 마디 CW-01329 는 목록 밖)

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BW6Jdsh18WPtYUR6THZJqn

Z01_MasterData/Z01_MasterData_BasePrices.py

@@ -427,14 +427,21 @@ def kind_label(kind: str) -> str:
     return named.get("name_ko") or kind
 
 
+def group_label(group: str) -> str:
+    """상자 이름 — 이름표 `base_price_groups[갈래].name_ko` 에서만(없으면 영문 그대로 · 화면은 `group_label` 을 읽음)."""
+    named = (tables.load_labels().get("base_price_groups") or {}).get(group) or {}
+    return named.get("name_ko") or group
+
+
 def kinds() -> list[dict[str, Any]]:
     """화면이 상자를 세울 목록 — **서버가 냄**(화면이 제 코드에 들면 새 kind 가 조용히 안 뜸).
 
-    갈래 · kind · 한글 이름(이름표) · 줄 수.
+    갈래 · 갈래 한글 이름 · kind · 한글 이름(이름표) · 줄 수.
     """
     return [
         {
             "group": kind_group(kind),
+            "group_label": group_label(kind_group(kind)),
             "kind": kind,
             "label": kind_label(kind),
             "rows": len(rows(kind)),

Z01_MasterData/Z01_MasterData_WorkItems.py

@@ -1,7 +1,7 @@
 """Z01 공종 축 — 산림·건설 두 kind 를 기초단가와 **같은 계약**으로(2026-09-17 브레인 · PLAN_공종축 8-4).
 
 줄 = **품셈 표가 붙은 마디**(`axis_policy.json` `flat_list_filter: pum_tables > 0` — 잎으로 거르면 부모에 붙은 표가 안 뜸) ·
-  갈래(`variant_keys`)는 칸으로(편 수 = `stats.units`).
+  갈래(`variant_keys`)마다 한 줄로 폄 — 줄 수 = 편 수(`stats.units`) · 공종 수 = `stats.work_items`.
 이름 = 뿌리부터 전체 경로(「토공 › 토사깍기 › 기계」 · 건설은 부문부터) — 잎 이름만으론 겹침.
 계산 규칙 = 표 수준 `rules`(부모 마디 choose_one · sum_steps) + 줄 칸 `rule`·`step_weight`
   — 빠지면 발파암(절취 0.1 + 깍기 0.9 + 집토 1) 금액이 틀어짐.
@@ -77,6 +77,9 @@ def base_rows(kind: str) -> list[dict[str, Any]]:
         return []
     d, name = found
     items, by, children = _tree(d)
+    # 계산 규칙 이름 — 이름표 `value_overrides["work_item_master::<방식>"]`(「아래를 단계로 다 더함」) · 없으면 영문
+    named = tables.load_labels().get("value_overrides") or {}
+    linked, roles = linked_keys(), _role_names()
     rows = []
     for item in items:
         if not item.get("tables"):
@@ -86,24 +89,32 @@ def base_rows(kind: str) -> list[dict[str, Any]]:
             (s["weight"] for s in parent.get("steps") or [] if s["code"] == item["work_item_code"]),
             None,
         )
-        rows.append(
-            {
-                "@id": _key(item),
-                "@source": name,
-                "work_item_code": item["work_item_code"],  # 목차 코드 — 열쇠 아님, 칸으로만
-                "number": item["number"],
-                "name": _path(item, by),
-                "variant_keys": item.get("variant_keys") or [],
-                "pum_tables": [t["pum_table_id"] for t in item["tables"]],
-                "rule": parent.get("parent_mode"),
-                "step_weight": weight,
-                # 「임도가 쓰는 것」 — 연결고리 표가 확정으로 이은 줄(판정은 그 표 · 감추지 않고 표시만)
-                "link": LINKED if _key(item) in linked_keys() else "",
-                # 줄 구실(총칙·공종) — 이름은 axis_policy.json · 감추지 않고 표시(거르기 상자로 고름)
-                "axis_role": _role_names().get(str(item.get("axis_role") or ""), ""),
-                "effective_date": d.get("pum_edition") or d.get("effective_date"),
-            }
-        )
+        key = _key(item)
+        # 갈래마다 한 줄 — 일위대가가 갈래마다 달라 집는 단위가 갈래임(교목굴취 나무높이 9 · 2026-09-17 브레인 ③).
+        # 열쇠 = 공종 열쇠#갈래 키(B08·B09 `코드#갈래` 꼴) · 갈래 키 글자는 마스터 것 그대로(조립 두 벌 금지).
+        for variant in item.get("variant_keys") or [None]:
+            rows.append(
+                {
+                    "@id": f"{key}#{variant}" if variant else key,
+                    "@key": key,  # 공종 열쇠 — 거르기·줄 수는 공종 단위로
+                    "@source": name,
+                    "work_item_code": item["work_item_code"],  # 목차 코드 — 열쇠 아님, 칸으로만
+                    "number": item["number"],
+                    "name": _path(item, by),
+                    "variant": variant,
+                    "pum_tables": [t["pum_table_id"] for t in item["tables"]],
+                    "rule": (named.get(f"work_item_master::{parent.get('parent_mode')}") or {}).get(
+                        "name_ko"
+                    )
+                    or parent.get("parent_mode"),
+                    "step_weight": weight,
+                    # 「임도가 쓰는 것」 — 연결고리 표가 확정으로 이은 공종(판정은 그 표 · 감추지 않고 표시만)
+                    "link": LINKED if key in linked else "",
+                    # 줄 구실(총칙·공종) — 이름은 axis_policy.json · 표시 칸(거르기 상자로 고름)
+                    "axis_role": roles.get(str(item.get("axis_role") or ""), ""),
+                    "effective_date": d.get("pum_edition") or d.get("effective_date"),
+                }
+            )
     return rows
 
 
@@ -171,9 +182,12 @@ def notice(kind: str) -> list[str]:
 
 
 #: 거르기 — **자료에 있는 가름만**(건설 부문 · 줄 구실 · 연결고리 표). 어느 줄을 거를지는 서버 한 곳 ·
-#: 화면은 고른 값만 보냄 · 기본은 늘 「전부」(감추지 않음 — 사용자 「어디에 쓸지 모르니 건설 전체」 · 브레인).
+#: 화면은 고른 값만 보냄 · 연결은 기본 「전부」(감추지 않음 — 「어디에 쓸지 모르니 건설 전체」 · 브레인) ·
+#: 줄 구실만 기본 「공종」(총칙 기본 감춤 · 서브 2ee6a7ed · 브레인).
 FILTER_KEYS = ("link", "division", "axis_role")
 ALL = ""
+#: 값을 안 보냈을 때 거는 값 — 총칙 줄은 기본 감춤 · 「전부」를 고르면 보임(2026-09-17 브레인)
+DEFAULTS = {"axis_role": "work_item"}
 
 
 def _facets(kind: str) -> dict[str, dict[str, str]]:
@@ -200,7 +214,7 @@ def _role_names() -> dict[str, str]:
 
 
 def filters(kind: str, rows: list[dict[str, Any]]) -> list[dict[str, Any]]:
-    """거르기 상자 — 줄이 둘 이상으로 갈리는 가름만 · 기본은 「전부」(안 거름)."""
+    """거르기 상자 — 줄이 둘 이상으로 갈리는 가름만 · 기본은 `DEFAULTS`(그 값이 표에 있을 때) 아니면 「전부」."""
     facets = _facets(kind)
     labels = {
         "link": ("연결", {LINKED: "연결된 것만"}),
@@ -211,19 +225,20 @@ def filters(kind: str, rows: list[dict[str, Any]]) -> list[dict[str, Any]]:
     for key in FILTER_KEYS:
         counts: dict[str, int] = {}
         for row in rows:
-            value = facets.get(row["@id"], {}).get(key, ALL)
+            value = facets.get(row["@key"], {}).get(key, ALL)
             counts[value] = counts.get(value, 0) + 1
         values = [v for v in counts if v != ALL]
         if len(counts) < 2:  # 다 같은 값이면 거를 것이 없음(연결은 「연결됨」 · 빈칸 둘로 갈림)
             continue
         label, names = labels[key]
+        default = DEFAULTS.get(key, ALL)
         out.append(
             {
                 "key": key,
                 "label": label,
                 "options": [{"value": ALL, "label": "전부", "rows": len(rows)}]
                 + [{"value": v, "label": names.get(v, v), "rows": counts[v]} for v in values],
-                "default": ALL,
+                "default": default if default in values else ALL,
             }
         )
     return out
@@ -233,9 +248,12 @@ def apply_filters(
     kind: str, rows: list[dict[str, Any]], picked: dict[str, str]
 ) -> list[dict[str, Any]]:
     facets = _facets(kind)
-    for key, value in picked.items():
-        if key in FILTER_KEYS and value != ALL:
-            rows = [r for r in rows if facets.get(r["@id"], {}).get(key) == value]
+    # 안 보낸 가름은 상자 기본값으로 — 상자에 보이는 값과 걸린 값이 같게(찾기 결과가 아니라 표 전체로 정함)
+    defaults = {f["key"]: f["default"] for f in filters(kind, base_rows(kind))}
+    for key in FILTER_KEYS:
+        value = picked.get(key, defaults.get(key, ALL))
+        if value != ALL:
+            rows = [r for r in rows if facets.get(r["@key"], {}).get(key) == value]
     return rows
 
 
@@ -246,7 +264,7 @@ def extra(kind: str) -> dict[str, Any]:
         "filters": filters(kind, rows),
         "rules": rules(kind),
         "stats": {
-            "work_items": len(rows),
-            "units": sum(max(1, len(r["variant_keys"])) for r in rows),
+            "work_items": len({r["@key"] for r in rows}),
+            "units": len(rows),
         },
     }

resources/data_master_labels/labels_2026-01-01.json

@@ -1389,10 +1389,11 @@
      "note": "뿌리부터 전체 경로(「토공 › 토사깍기 › 기계」) — 잎 이름만으론 겹침."
     },
     {
-     "key": "variant_keys",
-     "name_ko": "갈래 키",
+     "key": "variant",
+     "name_ko": "갈래",
      "unit": "",
-     "visible": true
+     "visible": true,
+     "note": "갈래마다 한 줄(일위대가가 갈래마다 다름) — 줄 열쇠는 공종 열쇠#갈래."
     },
     {
      "key": "pum_tables",
@@ -1466,10 +1467,11 @@
      "note": "부문부터 전체 경로(「공통부문 › 토공사 › 굴착 › 굴착(인력/토사)」) — 부문마다 장 번호가 1부터라 부문이 뿌리."
     },
     {
-     "key": "variant_keys",
-     "name_ko": "갈래 키",
+     "key": "variant",
+     "name_ko": "갈래",
      "unit": "",
-     "visible": true
+     "visible": true,
+     "note": "갈래마다 한 줄(일위대가가 갈래마다 다름) — 줄 열쇠는 공종 열쇠#갈래."
     },
     {
      "key": "pum_tables",

resources/tester/test_z01_work_items.py

@@ -38,15 +38,21 @@ def _get(client: TestClient, kind: str, **params) -> dict:
 def test_산림_평평한_잎_목록과_계산_규칙(client: TestClient) -> None:
     listed = client.get("/api/master-data/base-prices").json()["kinds"]
     forest = next(i for i in listed if i["kind"] == "work_item_forest")
-    assert forest["group"] == "work_item" and forest["rows"] == 365
+    assert forest["group"] == "work_item" and forest["rows"] == 627  # 갈래마다 한 줄
+    # 상자 이름은 이름표 것 — 영문 키(work_item)로 뜨던 자리(2026-09-17 브레인 ①)
+    assert {i["group"]: i["group_label"] for i in listed} == {
+        "base_price": "기초단가",
+        "pumsem_basis": "품셈 기준",
+        "work_item": "공종 축",
+    }
 
-    table = _get(client, "work_item_forest", size=500)
-    assert table["total"] == 365 and table["stats"] == {"work_items": 365, "units": 627}
+    table = _get(client, "work_item_forest", size=500, axis_role="")  # 「전부」 — 총칙까지
+    assert table["total"] == 627 and table["stats"] == {"work_items": 365, "units": 627}
     assert table["editable"] == [] and set(table["locked"]) == set(table["sortable"])
-    rows = table["rows"]
-    assert len({r["@id"] for r in rows}) == 365
+    rows = table["rows"] + _get(client, "work_item_forest", size=500, page=2, axis_role="")["rows"]
+    assert len({r["@id"] for r in rows}) == 627
     assert (
-        len({r["name"] for r in rows}) == 365
+        len({r["@key"] for r in rows}) == len({r["name"] for r in rows}) == 365
     )  # 잎 이름 겹침 — 경로로 풀림 · 목차 오기 바로잡아 358 → 360(12-17-2 · 12-24-1)
     by_code = {r["work_item_code"]: r for r in rows}
     assert by_code["FP-09-03-02"]["name"] == "토공 › 토사깍기 › 기계"
@@ -55,19 +61,21 @@ def test_산림_평평한_잎_목록과_계산_규칙(client: TestClient) -> Non
     assert modes.count("choose_one") == 91 and modes.count("sum_steps") == 3
     blast = next(r for r in table["rules"] if r["work_item_code"] == "FP-09-05")
     assert [s["weight"] for s in blast["steps"]] == ["0.1", "0.9", "1"]
-    assert by_code["FP-09-05-02"]["rule"] == "sum_steps"
+    # 계산 규칙 칸은 이름표 이름 — 「sum_steps」 영문으로는 더해야 하는 줄로 안 읽힘(브레인 ②)
+    assert by_code["FP-09-05-02"]["rule"] == "아래를 단계로 다 더함"
+    assert by_code["FP-09-03-02"]["rule"] == "아래 하나를 고름"
     assert by_code["FP-09-05-02"]["step_weight"] == "0.9"
     # 2026-09-17 FW- 가 옴(데스크탑 서브) — 알림이 사라지는 것이 곧 열쇠가 섰다는 증거.
     assert all(r["@id"].startswith("FW-") for r in rows)  # 불변 열쇠(데스크탑 서브 7dd2c515)
     assert not any("불변 열쇠" in line for line in table["notice"])
 
     found = _get(client, "work_item_forest", q="발파암 ›")
-    assert found["total"] == 3
+    assert found["total"] == 5  # 절취 · 깍기(연암·보통암·경암) · 집토
 
 
 def test_건설_공종_축도_같은_길(client: TestClient) -> None:
     """건설(2026-09-17 뽑음) — 부문이 뿌리라 경로가 부문부터 · 열쇠 CW- · 계산 규칙은 전부 choose_one."""
-    table = _get(client, "work_item_const", size=500)
+    table = _get(client, "work_item_const", size=500, axis_role="")
     assert table["total"] == table["stats"]["work_items"] > 900
     rows = table["rows"]
     assert all(r["@id"].startswith("CW-") for r in rows)
@@ -101,7 +109,8 @@ def test_불변_열쇠가_오면_id_로_씀_자료_파일은_판_id_로_가림(
     monkeypatch.setattr(work_items, "FOLDER", folder)
 
     table = _get(client, "work_item_const")
-    assert [r["@id"] for r in table["rows"]] == ["CW-00002"]
+    assert [r["@id"] for r in table["rows"]] == ["CW-00002#갑", "CW-00002#을"]  # 갈래마다 한 줄
+    assert {r["@key"] for r in table["rows"]} == {"CW-00002"}
     assert table["rows"][0]["work_item_code"] == "CP-01-01"  # 목차 코드는 칸으로 남음
     assert table["rows"][0]["name"] == "토공 › 인력"
     assert table["stats"] == {"work_items": 1, "units": 2}
@@ -109,7 +118,7 @@ def test_불변_열쇠가_오면_id_로_씀_자료_파일은_판_id_로_가림(
     assert _get(client, "work_item_forest")["total"] == 0  # 산림 파일은 이 폴더에 없음
 
     res = client.put(
-        "/api/master-data/base-prices/work_item_const/CW-00002",
+        "/api/master-data/base-prices/work_item_const/CW-00002%23갑",
         json={"values": {"name": "바꿈"}},
     )
     assert res.status_code == 400 and "공종 축 뼈대" in res.json()["detail"]
@@ -118,7 +127,7 @@ def test_불변_열쇠가_오면_id_로_씀_자료_파일은_판_id_로_가림(
 def test_거르기는_자료에_있는_가름만_서버가_판정(client: TestClient) -> None:
     """화면(서브 b890fba0)이 `filters` 를 받으면 상자를 세우고 고른 값만 보냄 — 판정은 서버 한 곳.
     건설 부문 다섯 · 줄 구실(이름은 axis_policy.json) · 연결(연결고리 표)."""
-    const = _get(client, "work_item_const", size=1)
+    const = _get(client, "work_item_const", size=1, axis_role="")
     by_key = {f["key"]: f for f in const["filters"]}
     assert set(by_key) == {"link", "division", "axis_role"}
     division = by_key["division"]
@@ -136,7 +145,7 @@ def test_거르기는_자료에_있는_가름만_서버가_판정(client: TestCl
         "general_provision"
     ] == "총칙"
 
-    civil = _get(client, "work_item_const", size=500, division="토목부문")
+    civil = _get(client, "work_item_const", size=500, division="토목부문", axis_role="")
     assert civil["total"] == next(
         o["rows"] for o in division["options"] if o["value"] == "토목부문"
     )
@@ -178,13 +187,52 @@ def test_연결고리_표가_이은_줄에_연결됨_감추지_않고_표시만(
         if key
     } - confirmed
     for kind, prefix in (("work_item_const", "CW-"), ("work_item_forest", "FW-")):
-        every = _get(client, kind, size=500)
-        rows = every["rows"] + _get(client, kind, size=500, page=2)["rows"]
-        assert len(rows) == every["total"]  # 기본은 다 보임
-        marked = {r["@id"] for r in rows if r["link"] == "연결됨"}
-        assert marked == {k for k in confirmed if k.startswith(prefix)}
+        every = _get(client, kind, size=500, axis_role="")
+        rows = every["rows"] + _get(client, kind, size=500, page=2, axis_role="")["rows"]
+        assert len(rows) == every["total"]  # 연결 거르기 기본은 「전부」 — 다 보임
+        marked = {r["@key"] for r in rows if r["link"] == "연결됨"}  # 갈래 줄은 공종 열쇠로
+        listed = {r["@key"] for r in rows}  # 표가 안 붙은 묶는 마디(CW-01329 따위)는 목록 밖
+        assert marked == {k for k in confirmed if k.startswith(prefix) and k in listed}
+        assert marked  # 연결이 늘면 저절로 늘어남 — 지금도 한 줄 이상
         assert not marked & unconfirmed
-        only = _get(client, kind, size=500, link="연결됨")
-        assert {r["@id"] for r in only["rows"]} == marked and only["total"] == len(marked)
+        only = _get(client, kind, size=500, link="연결됨", axis_role="")
+        assert {r["@key"] for r in only["rows"]} == marked
         box = next(f for f in every["filters"] if f["key"] == "link")
-        assert box["default"] == "" and box["options"][1]["rows"] == len(marked)
+        assert box["default"] == "" and box["options"][1]["rows"] == only["total"]
+
+
+def test_갈래마다_한_줄이라_편_하나를_집는다(client: TestClient) -> None:
+    """2026-09-17 브레인 ③ — 일위대가는 갈래마다 다름. 교목굴취(나무높이) 한 줄이면 어느 높이 값인지 못 고름."""
+    rows = _get(client, "work_item_forest", size=50, q="교목굴취(나무높이)")["rows"]
+    assert [r["variant"] for r in rows] == [
+        "1.0 이하", "1.1∼1.5", "1.6∼2.0", "2.1∼2.5", "2.6∼3.0",
+        "3.1∼3.5", "3.6∼4.0", "4.1∼4.5", "4.6∼5.0",
+    ]  # fmt: skip
+    assert rows[1]["@id"] == "FW-00105#1.1∼1.5" and rows[1]["@key"] == "FW-00105"
+    # 갈래 없는 공종은 한 줄 · 열쇠에 # 없음
+    plain = _get(client, "work_item_forest", q="교목굴취(근원직경)")["rows"]
+    assert [(r["@id"], r["variant"]) for r in plain] == [("FW-00106", None)]
+    # 갈래 이름으로도 찾힘
+    assert _get(client, "work_item_forest", q="2.1∼2.5")["total"] >= 1
+
+
+def test_총칙_줄은_기본_감춤_전부를_고르면_보임(client: TestClient) -> None:
+    """2026-09-17 브레인 — 값을 안 보내면 상자 기본값(공종)으로 거름 · 화면은 그 기본값을 상자에 보임."""
+    for kind in ("work_item_forest", "work_item_const"):
+        shown = _get(client, kind, size=500)
+        role = next(f for f in shown["filters"] if f["key"] == "axis_role")
+        assert role["default"] == "work_item"
+        counts = {o["value"]: o["rows"] for o in role["options"]}
+        assert counts["general_provision"] > 0
+        # 기본 = 공종만 · 찾기 결과로 기본이 흔들리지 않음(총칙만 걸리는 낱말도 기본은 감춤)
+        assert shown["total"] == counts["work_item"]
+        assert (
+            _get(client, kind, size=500, q="적용기준")["total"]
+            < _get(client, kind, size=500, q="적용기준", axis_role="")["total"]
+        )
+        # 「전부」(빈 값을 보냄) → 총칙까지
+        assert _get(client, kind, size=1, axis_role="")["total"] == counts[""]
+        assert (
+            _get(client, kind, size=1, axis_role="general_provision")["total"]
+            == (counts["general_provision"])
+        )