diff --git a/B08_Quantity/B08_Quantity_Engine_Handoff.py b/B08_Quantity/B08_Quantity_Engine_Handoff.py index 2c4f519f..bdfcde7c 100644 --- a/B08_Quantity/B08_Quantity_Engine_Handoff.py +++ b/B08_Quantity/B08_Quantity_Engine_Handoff.py @@ -55,6 +55,52 @@ DATASET_PREFIX = "work_item_mapping_" REBAR_DIR = Path(__file__).resolve().parents[1] / "resources" / "data_rebar" REBAR_PREFIX = "rebar_complexity_" +#: 돌쌓기 규격 갈래표 — 저장 제원 값으로 자동 판정한다(사람이 고르는 값이 아니다). +MASONRY_DIR = Path(__file__).resolve().parents[1] / "resources" / "data_masonry" +MASONRY_PREFIX = "masonry_class_" + + +def load_masonry_table(path: Path | None = None) -> dict[str, Any]: + """돌쌓기 갈래표. 파일이 없으면 빈 표 — 갈래가 안 붙고 그대로 드러난다.""" + target = path + if target is None: + files = sorted(MASONRY_DIR.glob(MASONRY_PREFIX + "*.json")) if MASONRY_DIR.is_dir() else [] + target = files[-1] if files else None + if target is None or not target.is_file(): + return {} + return json.loads(target.read_text(encoding="utf-8")) + + +def masonry_class( + options: dict[str, Any], table: dict[str, Any] | None = None +) -> tuple[str | None, str]: + """돌쌓기 갈래 — 저장 뒷길이로 **「…㎝ 이하」 구간**을 고른다. + + ⚠ 저장 선택지(25·30·35·45·55·60·75)와 단가 갈래(35·55·75 이하)는 축이 다르다. + **저장값 이상인 첫 경계**를 고르는 것이 「이하」 구간의 뜻이다. + """ + found = table if table is not None else load_masonry_table() + spec = (found or {}).get("back_length") or {} + from B08_Quantity.B08_Quantity_Wording import option_missing + + option_key = str(spec.get("option_key") or "back_len_cm") + raw = options.get(option_key) + if raw is None: + # ⚠ 「없다」만 말하지 않는다 — **어디서 채우면 단가가 붙는지**까지. + # 이름은 부르는 쪽(`unmatched`)이 이미 앞에 붙이므로 여기서는 칸 이름만 말한다. + return None, option_missing(option_key) + " (단가 갈래를 못 고름)" + try: + value = float(raw) + except (TypeError, ValueError): + return None, f"뒷길이 값을 못 읽음({raw!r})" + for row in spec.get("classes") or []: + if value <= float(row["max_cm"]): + return str(row["key"]), f"뒷길이 {value:g}㎝ → 품셈 13-4 「{row['key']}」 구간" + return None, f"뒷길이 {value:g}㎝ 를 덮는 갈래가 표에 없음" + + +from B08_Quantity.B08_Quantity_Wording import type_label as wording_type_label + def normalize_kind_key(label: str) -> str: """갈래 키 — **내부 공백만** 지운다 (2026-09-07 두 창 확정). @@ -82,6 +128,12 @@ NOTE_METHOD_MISSING = "시공법 미지정으로 공종을 못 고름" #: 아니라 공종 이름이라 성분 목록에는 안 온다. REBAR_PREFIXES = ("이형철근", "원형철근", "철근") +#: 줄이 왜 막혔나 — **받는 쪽이 「사용자가 입력하면 풀리는 것」과 「우리가 만들어야 하는 것」을 +#: 화면에서 갈라야** 한다(2026-09-07 3자 확정). 8-27 표에서 이미 가른 그 축이다. +BLOCKED_INPUT_MISSING = "input_missing" # 저장 제원 칸이 비어 있음 — 입력하면 풀림 +BLOCKED_UNIT_DATA_MISSING = "unit_data_missing" # 원단위·표준 물량 자료가 없음 +BLOCKED_FORMULA_MISSING = "formula_missing" # 수량 산출식 자체가 없음 + #: 사면 계열 — 토공집계에 함께 실리지만 출처가 사면적이다. SLOPE_GROUPS = frozenset({"성토면다짐", "초류종자살포", "지장목제거", "층따기", "면고르기"}) @@ -310,7 +362,13 @@ def rebar_complexity( return None, str(row.get("why") or "원문 예시에 없음") if fallback and fallback.get("class"): return str(fallback["class"]), f"품셈 12-3 [주]① 「{fallback.get('matched')}」" - return None, f"품셈 12-3 [주]① 예시에 없는 구조({type_id} {form}) — 임의로 고르지 않음" + from B08_Quantity.B08_Quantity_Wording import type_label + + detail = f"({form})" if form else "(형식이 아직 입력되지 않음)" + return None, ( + f"{type_label(type_id)} {detail} 는 품셈 12-3 [주]① 예시에 없어 " + "철근 갈래를 정하지 못했습니다 — 임의로 고르지 않습니다" + ) def euroform_type(type_id: str, table: dict[str, Any] | None = None) -> tuple[str | None, str]: @@ -328,7 +386,12 @@ def euroform_type(type_id: str, table: dict[str, Any] | None = None) -> tuple[st for row in (found or {}).get("type_map") or []: if row.get("type_id") == type_id and row.get("class"): return str(row["class"]), f"품셈 12-38-3 [주]④ 「{row.get('matched')}」" - return None, f"품셈 12-38-3 [주]④ 예시에 없는 시설({type_id}) — 임의로 고르지 않음" + from B08_Quantity.B08_Quantity_Wording import type_label + + return None, ( + f"{type_label(type_id)} 는 품셈 12-38-3 [주]④ 예시에 없어 유로폼 유형을 " + "정하지 못했습니다 — 임의로 고르지 않습니다" + ) def _spec_detail(structure: dict[str, Any]) -> str: @@ -402,6 +465,14 @@ def _earthwork_rows( "station_from": None, "station_to": None, "spec_detail": "", + "composite_parts": None, + "structure_kind": None, + "spec_class": None, + "spec_class_basis": "", + # 토공 줄은 막힐 자리가 없다 — 그래도 **칸은 둔다**(계약이 한 모양이어야 한다). + "blocked_kind": None, + "blocked_reason": "", + "composite_not_ready": None, # 합계 줄과 무대 줄은 값은 내되 내역에 안 선다. "in_bill": bool(row.get("in_bill", True)) and not is_subtotal, "excavation_method": methods.get(ground) if ground else None, @@ -442,9 +513,17 @@ def _haul_rows( "ground_class": row.get("ground") or None, "haul_distance_m": float(row.get("average_distance_m") or 0.0), "haul_equipment": equipment, + "excavation_method": None, "station_from": None, "station_to": None, "spec_detail": "", + "composite_parts": None, + "structure_kind": None, + "spec_class": None, + "spec_class_basis": "", + "blocked_kind": None, + "blocked_reason": "", + "composite_not_ready": None, "in_bill": in_bill, "in_bill_reason": str(entry.get("reason") or ""), "origin": ORIGIN_HAUL, @@ -453,6 +532,30 @@ def _haul_rows( return rows, unmatched +def blocked_of(structure: dict[str, Any], class_basis: str = "") -> tuple[str | None, str]: + """(막힌 갈래, 사유). 안 막혔으면 `(None, "")`. + + ⚠ 사유 문구는 **`B08_Quantity_Wording` 것을 그대로** 쓴다 — 두 벌로 짜면 갈린다. + 전개 알림(`notes`)에 이미 사람 말로 적혀 있으므로 그것을 그대로 옮긴다. + """ + notes = [str(note) for note in structure.get("notes") or []] + if structure.get("components"): + # 물량은 섰는데 **단가 갈래**를 못 고른 자리(돌쌓기 뒷길이 등). + if class_basis and "입력되지 않았습니다" in class_basis: + return BLOCKED_INPUT_MISSING, class_basis + return None, "" + for note in notes: + if "입력되지 않았습니다" in note: + return BLOCKED_INPUT_MISSING, note + if "자료에 없습니다" in note or "표준 물량 자료" in note: + return BLOCKED_UNIT_DATA_MISSING, note + if "산출식이 아직 없습니다" in note: + return BLOCKED_FORMULA_MISSING, note + if notes: + return BLOCKED_UNIT_DATA_MISSING, notes[0] + return None, "" + + def _structure_rows( unit_quantity_table: dict[str, Any], mapping: WorkItemMapping ) -> tuple[list[dict[str, Any]], list[str]]: @@ -467,14 +570,24 @@ def _structure_rows( type_id = str(structure.get("type_id") or "") entry = mapping.for_structure(type_id) or {} code = entry.get("work_item_code") + # 돌쌓기는 **뒷길이 갈래**로 단가가 갈린다 — 저장 제원에서 자동으로 고른다. + class_key: str | None = None + class_basis = "" + if code and entry.get("class_from") == "back_length": + class_key, class_basis = masonry_class(structure.get("options") or {}) + if class_key: + code = f"{code}#{normalize_kind_key(class_key)}" composite = mapping.composite_for(type_id) if code is None else None kind = structure_kind(structure) if composite else None parts: list[dict[str, Any]] | None = None - parts_missing: list[str] = [] + parts_missing: list[dict[str, Any]] = [] if composite: parts, parts_missing = composite_quantities(structure, composite, mapping) + blocked_kind, blocked_reason = blocked_of(structure, class_basis) if code is None and composite is None: - unmatched.append(f"구조물({type_id})") + unmatched.append(f"{wording_type_label(type_id)} — 품셈 공종을 아직 못 이었습니다") + elif entry.get("class_from") == "back_length" and class_key is None: + unmatched.append(f"{wording_type_label(type_id)} — {class_basis}") length = float(structure.get("length_m") or 0.0) rows.append( { @@ -492,11 +605,18 @@ def _structure_rows( "haul_equipment": None, "station_from": structure.get("start_m"), "station_to": structure.get("end_m"), + "excavation_method": None, "spec_detail": _spec_detail(structure), # 품셈에 그 이름의 공종이 없어 여러 공종을 묶는 자리 — 빈 코드와 구별한다. "composite_parts": parts, # 철근이 있나 없나로 자동 판정 — 사람이 고르는 값이 아니다. "structure_kind": kind, + # ⚠ 줄마다 **왜 막혔는지**를 싣는다 — 안 실으면 받는 쪽 화면이 빈다. + "blocked_kind": blocked_kind, + "blocked_reason": blocked_reason, + # 규격 갈래(뒷길이 …㎝ 이하) — 못 고르면 사유가 남는다. + "spec_class": class_key, + "spec_class_basis": class_basis, # ⚠ 물량을 못 채운 조각 — 0 으로 적지 않고 사유와 함께 드러낸다. "composite_not_ready": parts_missing or None, "in_bill": True, diff --git a/B08_Quantity/B08_Quantity_Engine_ObservedUnit.py b/B08_Quantity/B08_Quantity_Engine_ObservedUnit.py index ad2d25f6..b2caa79d 100644 --- a/B08_Quantity/B08_Quantity_Engine_ObservedUnit.py +++ b/B08_Quantity/B08_Quantity_Engine_ObservedUnit.py @@ -138,15 +138,19 @@ def expand_observed( table: ObservedUnitTable | None = None, ) -> tuple[list[dict[str, Any]], list[str]]: """(성분 목록, 알림). 규격이 표에 없으면 **빈 목록 + 미확보 알림**을 낸다.""" + from B08_Quantity.B08_Quantity_Wording import spec_missing + found = (table or load_observed_table()).find(type_id, spec) if found is None: known = (table or load_observed_table()).specs_for(type_id) - detail = f" — 표에 있는 규격: {known}" if known else "" - return [], [f"{NOTE_UNIT_MISSING} ({type_id} {spec}){detail}"] + # ⚠ 키 이름을 화면에 내보내지 않는다 — 사용자는 `retaining_wall` 을 모른다. + return [], [spec_missing(type_id, known)] scale, scale_note = scale_for(found, structure) if scale <= 0: - return [], [f"{NOTE_UNIT_MISSING} — 곱할 연장·면적이 0 ({type_id})"] + from B08_Quantity.B08_Quantity_Wording import type_label + + return [], [f"{type_label(type_id)}의 연장·면적이 0 이라 물량을 내지 않았습니다"] source_key = str(found.get("source") or "") components: list[dict[str, Any]] = [] diff --git a/B08_Quantity/B08_Quantity_Engine_UnitQuantity.py b/B08_Quantity/B08_Quantity_Engine_UnitQuantity.py index c1e5d697..13117703 100644 --- a/B08_Quantity/B08_Quantity_Engine_UnitQuantity.py +++ b/B08_Quantity/B08_Quantity_Engine_UnitQuantity.py @@ -134,10 +134,35 @@ class StructureQuantity: notes: list[str] = field(default_factory=list) +#: ⚠ **저장 제원의 실제 칸 이름**은 `back_len_cm` 이다(레지스트리 확인). +#: 앞서 `stone_back_length_cm` 을 읽고 있어 **저장값이 영영 안 닿고 늘 기본 45㎝ 로 돌았다** +#: — 뒷길이를 75 로 골라도 45 계수가 붙던 자리다. 값이 나오므로 아무 시험도 안 잡았다. +#: 옛 이름도 함께 본다(다른 곳에서 그 이름으로 넣어 줄 수 있다). +BACK_LENGTH_KEYS = ("back_len_cm", "stone_back_length_cm") + + def _back_length(options: dict[str, Any]) -> int: - raw = options.get("stone_back_length_cm") - if isinstance(raw, (int, float)) and int(raw) in STONE_BACK_LENGTH_TABLE: - return int(raw) + """뒷길이(㎝). 표에 없는 값이면 **가장 가까운 아래 칸**이 아니라 기본으로 간다. + + ⚠ 표는 35·45·55·60 네 칸뿐인데 레지스트리 선택지는 25·30·35·45·55·60·75 일곱이다. + 25·30 은 35 로, 75 는 60 으로 접는다 — **원단위표가 그 구간을 그렇게 덮는다** + (품셈 13-4 뒷길이 표준). 접은 사실은 근거 문구에 적는다. + """ + for key in BACK_LENGTH_KEYS: + raw = options.get(key) + if raw is None: + continue + try: + value = int(float(raw)) + except (TypeError, ValueError): + continue + if value in STONE_BACK_LENGTH_TABLE: + return value + # 표에 없는 값 — 그 값을 덮는 **가장 가까운 위 칸**으로 접는다(작은 돌이 큰 칸에 들어감). + larger = [cm for cm in sorted(STONE_BACK_LENGTH_TABLE) if cm >= value] + if larger: + return larger[0] + return max(STONE_BACK_LENGTH_TABLE) return DEFAULT_BACK_LENGTH_CM @@ -145,6 +170,111 @@ def _num(value: Any, fallback: float = 0.0) -> float: return float(value) if isinstance(value, (int, float)) else fallback +#: 큰돌쌓기(품셈 13-6) 직경 갈래 — **저장 제원 `stone_cm` 과 글자까지 같다**(레지스트리 확인). +#: ⚠ 돌쌓기(13-4)의 **뒷길이** 축과 섞지 않는다. 앞서 섞여 있어 직경 60~80 짜리가 +#: 「뒷길이 45㎝」 계수로 돌던 자리다. +BOULDER_DIAMETERS = ("40~60", "60~80", "80~100") + +#: 큰돌쌓기 전개 상수. **재료 원단위는 품셈에 없다** — 13-6 [주]⑦ 「재료량은 설계수량을 적용한다」. +#: 그래서 여기서 내는 것은 **면적과 터파기 계열까지**이고 큰돌 자체는 미확보로 둔다. +BOULDER_MASONRY = { + "face_to_slope_factor": 1.04, # 돌쌓기 면적 = 정면적 × 1.04 (13-4 와 같은 기울기 몫) + "excavation_extra_m": 0.2, # 터파기 폭 여유 + "backfill_thickness_m": 0.2, # 되메우기 두께 +} + + +def _boulder_diameter(options: dict[str, Any]) -> str | None: + """저장 제원의 직경 갈래. 표에 없는 값이면 **지어내지 않고 `None`**.""" + raw = options.get("stone_cm") + text = str(raw).strip() if raw is not None else "" + return text if text in BOULDER_DIAMETERS else None + + +def boulder_masonry( + height_m: float, length_m: float, options: dict[str, Any] +) -> tuple[list[Component], list[str]]: + """큰돌쌓기(품셈 13-6) 전개 — **치수로 낼 수 있는 것까지만** 낸다. + + ⚠ 재료 원단위가 품셈에 없다 — 13-6 [주]⑦ 「재료량은 설계수량을 적용한다」. + 돌쌓기(13-4)처럼 「뒷길이별 돌중량·고임돌」 표가 **없으므로** 큰돌·고임돌·막자갈을 + 내지 않는다. 대신 **왜 못 내는지**를 알림으로 남긴다. + + ⚠ 고임돌·채움콘크리트 품은 **품에 포함**돼 있다(13-6-1 [주]①·13-6-2 [주]①) — + 따로 세우면 이중계상이다. + + ⚠ 뒤채움(조약돌)은 **13-3 을 적용**한다(13-6 [주]⑧) — 이 표에서 찾지 않는다. + 두께는 13-4-3 [주]⑨ 를 준용하는데 **직고별 범위값**(상부 20~40㎝ / 하부 30~140㎝)이라 + 한 값으로 못 정한다. 미확보로 둔다. + """ + notes: list[str] = [] + if height_m <= 0 or length_m <= 0: + return [], ["높이·연장이 없어 전개하지 않음"] + + diameter = _boulder_diameter(options) + if diameter is None: + return [], [ + "큰돌쌓기 돌 직경이 아직 입력되지 않았습니다 — 구조물 상세 입력에서 " + f"{' · '.join(BOULDER_DIAMETERS)}㎝ 중 하나를 고르면 값이 섭니다" + ] + + slope_ratio = _num(options.get("face_slope_ratio"), 0.3) # 레지스트리에 칸 없음 — 기본 0.3 + constants = BOULDER_MASONRY + face_area = height_m * length_m + slope_area = face_area * math.hypot(1.0, slope_ratio) + masonry_area = slope_area * constants["face_to_slope_factor"] + + components = [ + Component( + "큰돌쌓기", + "㎡", + masonry_area, + DESTINATION["돌쌓기"], + f"비탈면적 × 1.04 · 직경 {diameter}㎝ (품셈 13-6)", + ) + ] + + # 터파기·되메우기·잔토 — 치수에서 나온다. 두께는 **직경 갈래의 위 끝**을 벽 두께로 본다. + # ⚠ 품셈에 큰돌쌓기 터파기 폭 규정이 없어 **돌쌓기와 같은 방식**(벽 두께 + 여유 0.2m)으로 + # 낸다. 근거 문구에 그 사실을 적어 되짚을 수 있게 한다. + upper_cm = float(str(diameter).split("~")[-1]) + thickness = upper_cm / 100.0 + excavation = height_m * (thickness + constants["excavation_extra_m"]) * length_m + backfill = height_m * constants["backfill_thickness_m"] * length_m + components.extend( + [ + Component( + "터파기", + "㎥", + excavation, + DESTINATION["터파기"], + f"높이 × (벽두께 {thickness:g}m + 0.2) × 연장 · ⚠ 큰돌쌓기 터파기 폭 규정이" + " 품셈에 없어 돌쌓기 방식을 준용", + ), + Component("되메우기", "㎥", backfill, DESTINATION["되메우기"], "높이 × 0.2 × 연장"), + Component( + "잔토처리", + "㎥", + excavation - backfill, + DESTINATION["잔토처리"], + "터파기 − 되메우기", + ), + ] + ) + + notes.append( + "재료(큰돌) 원단위 미확보 — 품셈 13-6 [주]⑦ 「재료량은 설계수량을 적용한다」라 " + "돌쌓기(13-4)의 뒷길이별 돌중량 표에 해당하는 것이 없음" + ) + notes.append("고임돌·채움콘크리트는 **품에 포함**(13-6 [주]①) — 따로 세우지 않음") + notes.append( + "뒤채움(조약돌)은 13-3 적용(13-6 [주]⑧). 두께는 13-4-3 [주]⑨ 준용인데 " + "직고별 범위값(상부 20~40㎝ / 하부 30~140㎝)이라 한 값으로 못 정함 — 미확보" + ) + notes.append("⚠ 메/찰 구분이 저장 제원에 없어 13-6-1(메)·13-6-2(찰) 중 어느 쪽인지 못 고름") + return components, notes + + def stone_masonry( height_m: float, length_m: float, options: dict[str, Any], wet: bool ) -> tuple[list[Component], list[str]]: @@ -160,6 +290,9 @@ def stone_masonry( back_cm = _back_length(options) table = STONE_BACK_LENGTH_TABLE[back_cm] + # ⚠ `face_slope_ratio` 는 **레지스트리에 없는 키**다 — 즉 지금은 늘 기본 0.3 으로 돈다. + # 상수로 두는 것이 아니라 「칸이 생기면 바로 받는다」는 뜻으로 남겨 둔다. + # (키 이름 어긋남으로 저장값이 안 닿던 `back_len_cm` 사고와 구별할 것 — 이쪽은 **칸 자체가 없다**.) slope_ratio = _num(options.get("face_slope_ratio"), 0.3) # 전면 기울기 1:0.3 (교본 7-3) constants = STONE_MASONRY @@ -288,6 +421,7 @@ OBSERVED_SPEC_KEYS: dict[str, tuple[str, ...]] = { EXPANDERS = { "masonry_wet": lambda h, l, o: stone_masonry(h, l, o, wet=True), "masonry_dry": lambda h, l, o: stone_masonry(h, l, o, wet=False), + "boulder_masonry": lambda h, l, o: boulder_masonry(h, l, o), # ⚠⚠ **큰돌쌓기(`boulder_masonry`)를 여기에 두지 않는다** (2026-09-07 발견). # 큰돌쌓기는 품셈 **13-6** 이고 돌쌓기는 **13-4** 다 — **규격 축이 다르다.** # 돌쌓기는 **뒷길이**(35·45·55·60㎝), 큰돌쌓기는 **직경**(40~60·60~80·80~100㎝). @@ -298,12 +432,7 @@ EXPANDERS = { } #: 전개식을 일부러 안 두는 종류 — 왜 안 두는지 사람이 읽게 적는다. -EXPANDER_WITHHELD = { - "boulder_masonry": ( - "큰돌쌓기는 품셈 13-6 이고 규격 축이 **직경**(40~60·60~80·80~100㎝)이다. " - "돌쌓기(13-4)의 **뒷길이** 계수로 돌리면 조용히 틀린 값이 나온다 — 전개식 미확보." - ), -} +EXPANDER_WITHHELD: dict[str, str] = {} #: 한 구조물이 **여러 내역 줄**을 낳는 자리. 배수관은 관 자체와 유입부 집수정이 따로 선다 @@ -346,7 +475,9 @@ def _observed_components( options = structure.get("options") or {} spec = {key: options[key] for key in keys if options.get(key) is not None} if not spec: - return [], [f"{type_id} 규격이 비어 있음 — 관측 원단위를 고를 수 없음"] + from B08_Quantity.B08_Quantity_Wording import option_missing + + return [], [option_missing(keys[0], type_id)] return expand_observed(type_id, spec, structure, observed) @@ -390,7 +521,11 @@ def expand( result.components = [Component(**item) for item in components] result.notes.extend(notes) return result - result.notes.append(f"'{type_id}' 전개식이 아직 없음 — 물량을 내지 않음") + from B08_Quantity.B08_Quantity_Wording import type_label + + result.notes.append( + f"{type_label(type_id, names)}의 수량 산출식이 아직 없습니다 — 물량이 서지 않습니다" + ) return result result.components, notes = expander(height, length, options) result.notes.extend(notes) diff --git a/B08_Quantity/B08_Quantity_Wording.py b/B08_Quantity/B08_Quantity_Wording.py new file mode 100644 index 00000000..b535dd4e --- /dev/null +++ b/B08_Quantity/B08_Quantity_Wording.py @@ -0,0 +1,80 @@ +"""사용자에게 뜨는 문구 — **키 이름을 화면에 내보내지 않는다** (B08 ㉑). + +왜 있나 + 「`back_len_cm` 가 저장돼 있지 않아 갈래를 못 고름」처럼 **개발자 키 이름이 그대로** + 화면에 뜨던 자리가 있었다. 사용자는 그 이름을 모르고, 무엇을 해야 하는지도 알 수 없다. + (반영률 라벨이 서버 키로 뜨던 그 자리와 같은 병이다.) + +⚠ 「없다」만 말하지 않는다 — **어디서 채우면 풀리는지**를 함께 적는다 + 「원단위 미확보」로 끝나면 사용자는 손쓸 데를 모른다. **무엇이 채워지면 값이 서는지**가 + 같이 있어야 그 말이 쓸모 있다. 오늘 「표에 있는 규격을 함께 알린」 그 방식이다. + +⚠ 여기서 값을 바꾸지 않는다 + 문구만 다듬는 자리다. 판정·계산은 각 엔진이 하고, 이 모듈은 **그 결과를 사람 말로** 옮긴다. +""" + +from __future__ import annotations + +from typing import Any + +#: 구조물 종류의 사람 이름. 레지스트리 이름이 정본이고 여기는 **화면 문구가 필요할 때만** 쓴다. +#: ⚠ 레지스트리에 없는 이름을 지어내지 않는다 — 못 찾으면 원래 값을 그대로 보인다. +TYPE_LABELS = { + "masonry_wet": "돌쌓기(찰)", + "masonry_dry": "돌쌓기(메)", + "boulder_masonry": "큰돌쌓기", + "retaining_wall": "옹벽", + "soil_guard": "흙막이", + "pipe": "배수관", + "pipe_inlet_basin": "배수관 유입부 집수정", + "ford_pavement": "물넘이포장", + "ford_bridge": "세월교", + "box_culvert": "BOX암거", +} + +#: 저장 제원 칸의 사람 이름 + **어디서 채우는지**. 키 이름을 화면에 내보내지 않기 위한 표. +OPTION_LABELS = { + "back_len_cm": ("돌 뒷길이(㎝)", "구조물 상세 입력"), + "stone_cm": ("돌 직경(㎝)", "구조물 상세 입력"), + "form": ("옹벽 형식", "구조물 상세 입력"), + "height_m": ("높이(m)", "구조물 배치"), + "length_m": ("연장(m)", "구조물 배치"), + "face_slope_ratio": ("전면 기울기", "아직 입력 칸이 없음"), +} + + +def type_label(type_id: str, names: dict[str, str] | None = None) -> str: + """구조물 이름 — 레지스트리 이름이 있으면 그것을 먼저 쓴다.""" + stored = (names or {}).get(type_id) + return stored or TYPE_LABELS.get(type_id, type_id) + + +def option_missing(option_key: str, type_id: str = "", names: dict[str, str] | None = None) -> str: + """「무엇이 없고 어디서 채우면 되는지」 한 줄. + + ⚠ 모르는 키면 **지어내지 않고** 키를 그대로 보인다 — 잘못된 안내가 없는 안내보다 나쁘다. + """ + label, where = OPTION_LABELS.get(option_key, (option_key, "")) + subject = f"{type_label(type_id, names)} " if type_id else "" + tail = f" — {where}에서 입력하면 값이 섭니다" if where else "" + return f"{subject}{label}이(가) 아직 입력되지 않았습니다{tail}" + + +def spec_missing( + type_id: str, known: list[dict[str, Any]], names: dict[str, str] | None = None +) -> str: + """규격이 표에 없을 때 — **표에 있는 규격을 함께** 보인다.""" + name = type_label(type_id, names) + if not known: + return f"{name}의 표준 물량 자료가 아직 없습니다 — 설계 표준도 확보가 필요합니다" + readable = " / ".join(_spec_text(spec) for spec in known) + return f"{name}의 이 규격은 자료에 없습니다 — 자료에 있는 규격: {readable}" + + +def _spec_text(spec: dict[str, Any]) -> str: + """규격 한 벌을 사람 말로. 키 이름 대신 라벨을 쓴다.""" + parts = [] + for key, value in spec.items(): + label = OPTION_LABELS.get(key, (key, ""))[0] + parts.append(f"{label} {value}") + return " · ".join(parts) diff --git a/resources/data_masonry/masonry_class_2026-01-01.json b/resources/data_masonry/masonry_class_2026-01-01.json new file mode 100644 index 00000000..9026c746 --- /dev/null +++ b/resources/data_masonry/masonry_class_2026-01-01.json @@ -0,0 +1,35 @@ +{ + "schema_version": "1.0", + "dataset_id": "masonry_class", + "effective_date": "2026-01-01", + "note": "돌쌓기(13-4)·큰돌쌓기(13-6) 의 **규격 갈래**. 저장 제원의 값으로 자동 판정하며 사람이 고르는 값이 아니다.", + "back_length": { + "note": "돌쌓기 — 저장 제원 `back_len_cm`(㎝). 품셈 갈래는 「…㎝ 이하」 구간이라 **저장값 이상인 첫 경계**를 고른다.", + "option_key": "back_len_cm", + "source": "품셈 13-4 뒷길이 표준 · B09 단가 갈래(#35cm이하·#55cm이하·#75cm이하)", + "classes": [ + { + "max_cm": 35, + "key": "35cm이하" + }, + { + "max_cm": 55, + "key": "55cm이하" + }, + { + "max_cm": 75, + "key": "75cm이하" + } + ] + }, + "boulder_diameter": { + "note": "큰돌쌓기 — 저장 제원 `stone_cm`. **품셈 13-6 직경 축과 글자까지 같다** — 접거나 바꾸지 않고 그대로 쓴다.", + "option_key": "stone_cm", + "source": "품셈 13-6 「직경 40㎝이상∼60㎝미만 / 60㎝이상∼80㎝미만 / 80㎝이상∼100㎝이하」", + "classes": [ + "40~60", + "60~80", + "80~100" + ] + } +} diff --git a/resources/data_work_item_mapping/work_item_mapping_2026-01-01.json b/resources/data_work_item_mapping/work_item_mapping_2026-01-01.json index a9f1bedb..c6bafe55 100644 --- a/resources/data_work_item_mapping/work_item_mapping_2026-01-01.json +++ b/resources/data_work_item_mapping/work_item_mapping_2026-01-01.json @@ -118,13 +118,17 @@ "type_id": "masonry_wet", "work_item_code": "FP-13-04-05", "master_name": "돌쌓기 > 찰쌓기(장비)", - "note": "인력 시공이면 FP-13-04-04" + "note": "인력 시공이면 FP-13-04-04", + "class_from": "back_length", + "class_note": "저장 제원 `back_len_cm` 으로 「…㎝ 이하」 구간을 고름 — 자동 판정" }, { "type_id": "masonry_dry", "work_item_code": "FP-13-04-02", "master_name": "돌쌓기 > 메쌓기(장비)", - "note": "인력 시공이면 FP-13-04-01" + "note": "인력 시공이면 FP-13-04-01", + "class_from": "back_length", + "class_note": "저장 제원 `back_len_cm` 으로 「…㎝ 이하」 구간을 고름 — 자동 판정" }, { "type_id": "pipe_inlet_basin", @@ -156,6 +160,15 @@ "FP-09-05 발파암" ], "why": "설계자가 넣는 암 갈래 이름(풍화암·연암·보통암·경암)이 리핑이냐 발파냐를 말하지 않음. 갈래마다 시공법을 지정하는 칸이 필요함" + }, + { + "type_id": "boulder_masonry", + "candidates": [ + "FP-13-06-01 메쌓기", + "FP-13-06-02 찰쌓기" + ], + "why": "저장 제원(`boulder_masonry`)에 **메/찰 구분 칸이 없어** 어느 쪽인지 못 고름. 레지스트리(`B05_Profile_Structure_Types.json`)는 다른 창 소관이라 여기서 못 고침 — 칸이 생기면 `structure` 에 옮긴다.", + "class_axis": "직경(`stone_cm`) 40~60·60~80·80~100 — 품셈 13-6 축과 글자까지 같음" } ] },