fix(b09): 사유 없이 버려지던 잎 공종 49 에 사유 — 표 번호·모양(작업량·소요량·형식 미정)·한 줄도 안 섬을 성분 미확보로(읽는 길은 안 만듦 · 프로젝트 내역 해당 0)

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

B09_Estimation/B09_Estimation_UnitPrice.py

@@ -1134,6 +1134,10 @@ def build_unit_prices(
     from B09_Estimation.B09_Estimation_RockLoss import attach_rock_loss
 
     attach_rock_loss(build, master)
+    # 제목도 사유도 없는 잎 공종 — 버린 표 번호·모양을 사유로(2026-09-15 · 모든 공종 모듈이 돈 뒤).
+    from B09_Estimation.B09_Estimation_UnreadTables import mark_unread_tables
+
+    mark_unread_tables(build, master)
     build.labor_reliability = _labor_reliability_in_use(build.book)
     # ③ 할증 포함 재료량을 준 공종에 자재가 재료비로 붙지 않았는가(명세 6장 · ㉠).
     from B09_Estimation.B09_Estimation_Guards import check_materials_before_surcharge

B09_Estimation/B09_Estimation_UnreadTables.py

@@ -0,0 +1,42 @@
+"""B09 원가계산 — **사유 없이 버려지는 표에 사유를 남긴다** (2026-09-15 브레인 「버릴 때는 사유」).
+
+일할 표(작업량·소요량·형식 미정)를 가진 잎 공종인데 제목도 사유도 없는 것 — 표를 읽는 길이 없어 한 줄도
+안 서고 어디에도 안 남음(잰 수 49 · ㉯ 가르기에서 먼저 6). 내역서가 「일위대가가 아직 없습니다」 만 띄워
+무엇을 손볼지 모름 → 표 번호·모양을 `component_gaps` 에 적음(내역서 「성분 미확보 — …」 로 섬).
+⚠ 읽는 길을 만드는 것이 아님 — 그 표가 풀리면 제목이 서서 이 사유는 저절로 안 붙음.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+#: 마스터 표 형식 → 사유에 쓰는 이름. 여기 없는 형식(참고·계수)은 일할 표가 아님.
+FORM_LABELS = {
+    "productivity": "작업량 표",
+    "requirement": "소요량 표",
+    "undetermined": "형식 미정 표(모양 판정 안 됨)",
+}
+UNREAD = "표를 읽는 길이 없어 한 줄도 안 섬 — {tables}"
+
+
+def mark_unread_tables(build: Any, master: dict[str, Any]) -> None:
+    """제목·사유가 둘 다 없는 잎 공종에 표 번호·모양 사유를 단다."""
+    from B09_Estimation.B09_Estimation_KnownGaps import known_gap_note
+
+    nodes = master.get("work_items", [])
+    parents = {node.get("parent_code") for node in nodes}
+    titled = {code[2:].split("#")[0] for code in build.book.titles if code.startswith("B-")}
+    for node in nodes:
+        code = node["work_item_code"]
+        tables = [t for t in node.get("tables") or [] if t.get("pum_form") in FORM_LABELS]
+        if not tables or code in titled or code in parents:
+            continue
+        if (
+            build.unattached.get(code)
+            or build.component_gaps.get(code)
+            or code in build.basis_missing
+            or known_gap_note(code)
+        ):
+            continue
+        listed = " · ".join(f"{t.get('pum_table_id')} {FORM_LABELS[t['pum_form']]}" for t in tables)
+        build.component_gaps[code] = UNREAD.format(tables=listed)

resources/tester/test_b09_unread_tables.py

@@ -0,0 +1,55 @@
+"""사유 없이 버려지는 표 — 2026-09-15 브레인 차례 ① (㉯ 가르기에서 6 · 전체로 재면 49).
+
+일할 표(작업량·소요량·형식 미정)를 가진 잎 공종인데 **제목도 사유도 없는** 것 — 표를 읽는 길이 없어
+한 줄도 안 서고 `unattached`·`component_gaps`·밑수·[주] 사유 어디에도 안 남아, 내역서엔 「일위대가가 아직
+없습니다」 만 뜸(무엇을 손볼지 모름). 예: 3-1 경계표시 F0075 「0.2 | 보통인부」(값이 이름 앞) ·
+6-4-1 덩굴걷기 F0158 · 7-3 아키야윈치 F0174 · 10-13-1 드론운반 F0322(형식 미정).
+⇒ 읽는 길을 만드는 것은 뒤(예취기 한 모양 4 …) — 여기서는 **버린 표를 사유로 남김**(버릴 때는 사유).
+"""
+
+from __future__ import annotations
+
+from B09_Estimation.B09_Estimation_KnownGaps import known_gap_note
+from B09_Estimation.B09_Estimation_ResourceAxis import load_work_item_master
+from B09_Estimation.B09_Estimation_UnitPrice import cached_build
+
+WORK_FORMS = {"productivity", "requirement", "undetermined"}
+
+
+def test_제목_없는_잎_공종은_모두_사유가_있음() -> None:
+    build = cached_build()
+    master = load_work_item_master()
+    parents = {n.get("parent_code") for n in master["work_items"]}
+    titled = {t[2:].split("#")[0] for t in build.book.titles if t.startswith("B-")}
+    silent = [
+        n["work_item_code"]
+        for n in master["work_items"]
+        if n["work_item_code"] not in titled
+        and n["work_item_code"] not in parents
+        and any(t.get("pum_form") in WORK_FORMS for t in n.get("tables") or [])
+        and not (
+            build.unattached.get(n["work_item_code"])
+            or build.component_gaps.get(n["work_item_code"])
+            or n["work_item_code"] in build.basis_missing
+            or known_gap_note(n["work_item_code"])
+        )
+    ]
+    assert silent == [], silent
+
+
+def test_사유는_표_번호와_모양을_가리킴() -> None:
+    gaps = cached_build().component_gaps
+    for code, table in (
+        ("FP-03-01", "F0075"),
+        ("FP-06-04-01", "F0158"),
+        ("FP-07-03", "F0174"),
+        ("FP-03-08", "F0082"),
+    ):
+        assert table in gaps[code] and "한 줄도" in gaps[code], (code, gaps.get(code))
+    assert "F0322" in gaps["FP-10-13-01"] and "형식 미정" in gaps["FP-10-13-01"]
+
+
+def test_부모와_제목_선_공종에는_안_붙음() -> None:
+    build = cached_build()
+    assert "FP-04-01" not in build.component_gaps  # choose_one 부모 — 잎이 섬
+    assert "FP-05-24-01" not in build.component_gaps  # 제목 선 공종