diff --git a/B08_Quantity/B08_Quantity_Engine_UnitQuantity.py b/B08_Quantity/B08_Quantity_Engine_UnitQuantity.py index 398fe2de..d9e20814 100644 --- a/B08_Quantity/B08_Quantity_Engine_UnitQuantity.py +++ b/B08_Quantity/B08_Quantity_Engine_UnitQuantity.py @@ -38,6 +38,14 @@ from dataclasses import dataclass, field from typing import Any, Iterable from common_util.common_util_structure_face_role import structure_face_role +from common_util.common_util_excavation import ( + BASIS_WALL, + WALL_BLINDING_DEPTH_M, + WALL_FOUNDATION_DEPTH_M, + WALL_TRENCH_CLEARANCE_M, + wall_trench_area_m2, + wall_trench_width_m, +) from B08_Quantity.B08_Quantity_Engine_ObservedUnit import ( BASIS_DERIVED, BASIS_OBSERVED, @@ -67,6 +75,17 @@ STONE_BACK_LENGTH_TABLE: dict[int, dict[str, float | None]] = { } DEFAULT_BACK_LENGTH_CM = 45 +#: ⑤ 돌 중량이 어디서 온 값인가 (2026-09-08 사용자 확정 2차 ⑤ 「DB 확인 → 없으면 현재 유지, +#: 나중에 프로그램에서 확인할 수 있게 근거를 남길 것」). +#: ⚠ **품셈·교본에는 돌중량표가 없다** — 지식DB 전수 확인 결과 이 값이 나오는 곳은 +#: 실무 원단위 라이브러리 한 곳뿐이다(기술문서에는 그 라이브러리를 인용한 줄만 있음). +#: 그래서 값을 바꾸지 않고 **어디서 온 값인지**를 줄마다 달아 화면에서 되짚게 한다. +STONE_WEIGHT_SOURCE = "uljin_library" +STONE_WEIGHT_BASIS = ( + "⚠ 실무 관측값 — 울진 소광 원단위 라이브러리 「돌뒷길이별 원단위표」(35·45·55㎝만 있음)." + " 품셈·교본에는 돌중량표가 없음" +) + #: 돌 종류별 계수표 — 품셈 13-4-3·13-4-4 [주]① · 교본 7-3. #: ⚠ 지금까지 **건설품셈 참고자료 한 벌**(돌 종류로 안 갈리는 표)로만 돌고 있었다. @@ -92,6 +111,20 @@ def load_stone_kind_table() -> dict[str, Any]: return {} +#: ⑨ 계수를 **어느 열로 볼 것인가** (2026-09-08 사용자 확정 2차 ⑨). +#: 기본은 **품셈 열**(야면석 고임돌 0.11 · 채움 0.15)이고, 「실무 관행」으로 두면 +#: 건설품셈 참고자료 한 벌(깬돌 계열 0.15 · 0.20)로 덮어쓴다. +#: ⚠ **빈 칸은 「안 정함」**이고 그때 기본(품셈)으로 선다 — 등록부 default 는 비어 있다. +#: 기본값을 등록부가 아니라 여기가 갖는 것은 `face_slope_ratio` 와 같은 결이다. +COEFF_BASIS_KEY = "stone_coeff_basis" +COEFF_BASIS_PRACTICE = {"실무 관행", "실무관행", "practice", "관행"} + + +def wants_practice_coefficients(options: dict[str, Any]) -> bool: + """계수를 실무 관행 열로 볼 것인가. 빈 칸이면 **아니오**(= 품셈 열).""" + return str(options.get(COEFF_BASIS_KEY) or "").strip() in COEFF_BASIS_PRACTICE + + def stone_coefficients(options: dict[str, Any], back_cm: int) -> tuple[dict[str, Any], str]: """(계수 한 벌, 알림). 돌 종류를 안 고르면 **종전 값**으로 돌되 그 사실을 알린다. @@ -105,14 +138,21 @@ def stone_coefficients(options: dict[str, Any], back_cm: int) -> tuple[dict[str, return {}, "" if key not in [str(x) for x in (table.get("back_lengths_cm") or [])]: return {}, (f"뒷길이 {back_cm}㎝ 는 품셈 표(25·30·35·45·55·60·75㎝)에 없어 계수가 없습니다") - if not kind: + practice = wants_practice_coefficients(options) + if not kind or practice: fallback = table.get("fallback") or {} + message = ( + f"「{kind}」이지만 계수를 **실무 관행 열**(건설품셈 참고자료)로 덮어썼습니다 —" + " 기본은 품셈 열입니다(확정 ⑨)" + if practice and kind + else str(fallback.get("message") or "") + ) return { "wedge_stone_m3_per_m2": (fallback.get("wedge_stone_m3_per_m2") or {}).get(key), "fill_concrete_m3_per_m2": (fallback.get("fill_concrete_m3_per_m2") or {}).get(key), "backfill_ratio": fallback.get("backfill_ratio_of_back_length"), "kind": "", - }, str(fallback.get("message") or "") + }, message if kind not in (table.get("kinds") or []): return {}, f"「{kind}」은(는) 아는 돌 종류가 아니라 계수를 못 골랐습니다" wedge = ((table.get("wedge_stone_m3_per_m2") or {}).get(kind) or {}).get(key) @@ -159,8 +199,9 @@ STONE_MASONRY = { # 적어 둔다 — 관측 원단위가 있는 종류는 그 표가 이기고, 없는 종류만 이 값으로 선다. "weep_hole_length_m": 0.5, # 물구멍관 1개소당 관 길이 "mortar_m3_per_m2": 0.009, # 줄눈 모르터 (찰쌓기만) - "excavation_extra_m": 0.2, # 터파기 폭 여유 - "backfill_thickness_m": 0.2, # 되메우기 두께 + # ⚠ 터파기 여유폭·되메우기 두께는 **공용 한 벌**로 옮겼다 + # (`common_util/common_util_excavation.py` — 화면 B06 과 짝인 TS 가 있다). + # 여기서 다시 두면 그림과 물량이 갈린다. } # 성분이 어디로 가는가 — 이중계상을 막는 표시. @@ -172,9 +213,12 @@ STONE_MASONRY = { #: 구조물 시공이 원활하도록 **100 mm 두께의 버림콘크리트**를 타설하도록 한다」. #: 폭 근거: KCS 34 50 05 「버림 콘크리트의 두께는 설계도서에 따르며, **폭은 잡석다짐의 #: 폭과 동일**하게 한다」. -#: ⚠ 우리에게 **잡석다짐 폭이 아직 없다**(기초잡석은 품셈에 공종만 있고 두께·폭이 없음). -#: 그래서 **터파기 폭(평균두께 + 여유 0.2m)을 잠정으로** 쓰고 근거 문구에 그 사실을 적는다. -#: 잡석다짐 폭이 정해지면 이 한 줄만 바꾸면 된다. +#: ⭐ 그 잡석다짐 폭이 **정해졌다** — 「기준 구조물에서 유도, 같은 값을 공유」 +#: (2026-09-08 사용자 확정 2차 ⑪ 「기슭막이면 **하단 길이** × 종단방향 폭 × 높이」). +#: ⇒ 벽에서 **하단 길이 = 하부 두께**다. 종전의 「터파기 폭 잠정」을 그 값으로 바꾼다. +#: ⚠ **기초잡석(품셈 12-25) 물량은 아직 못 센다** — 폭은 이제 있으나 **두께가 어느 +#: 원문에도 없다**(품셈은 ㎥당 품만 줌). 실무 관측은 관보호공 날개벽 T=0.2 하나뿐이라 +#: **다른 구조물 값을 옮겨 쓰지 않고** 사유로 드러낸다. #: 돌을 **사 오나 캐나** — 기본은 「캔다」(2026-09-09 사용자 확정 ②). #: 법이 그쪽을 권한다 — 별표2 「석축 등에 필요한 야면석 등은 **가급적 현장에서 #: 채취·사용**하도록 운반거리를 조사한다」. 실무 견적 다섯 권에도 야면석 **구입 단가가 @@ -195,6 +239,31 @@ STONE_SUPPLY_PURCHASED = {"구입", "구입품", "사서", "purchase", "purchase #: 뒤집힌다. 우리는 **양수**로 주고, 빼는 것은 받는 쪽이 한다. COLLECTED_STONE_KEY = "collected_stone_deduction_m3" +#: ⑩ 채움 콘크리트 강도 (2026-09-08 사용자 확정 2차 ⑩ 「기본 210, 고를 수 있게」). +#: ⚠ **빈 칸은 「안 정함」**이고 그때 210 으로 선다 — 등록부 default 는 비어 있다. +#: 180 은 국가기준 하한(돌쌓기 전용 값)이라 고르면 그 값이 이긴다. +FILL_CONCRETE_MPA_KEY = "fill_concrete_mpa" +FILL_CONCRETE_MPA_DEFAULT = "210" +FILL_CONCRETE_MPA_CHOICES = ("180", "210") + + +def fill_concrete_mpa(options: dict[str, Any]) -> tuple[str, str]: + """(강도, 근거). 안 정했으면 기본 210 이고 그 사실이 근거에 적힌다.""" + value = str(options.get(FILL_CONCRETE_MPA_KEY) or "").strip() + if value in FILL_CONCRETE_MPA_CHOICES: + return value, f"강도 {value} — 저장 제원에서 고른 값" + if value: + return ( + FILL_CONCRETE_MPA_DEFAULT, + f"강도 {FILL_CONCRETE_MPA_DEFAULT} — ⚠ 저장값 「{value}」은 180·210 중에" + " 없어 기본으로 섬", + ) + return ( + FILL_CONCRETE_MPA_DEFAULT, + f"강도 {FILL_CONCRETE_MPA_DEFAULT} — 안 정해 기본값(확정 ⑩)", + ) + + BLINDING_THICKNESS_M = 0.10 #: 버림을 뺄 수 있는 칸 — 「기본은 넣고, 빼고 싶으면 뺀다」(사용자 확정 ⑭). #: 저장 제원에 이 칸이 없으면 **넣는 쪽**이 기본이다. @@ -219,6 +288,11 @@ DESTINATION = { # ⚠ 자재도 토공도 아닌 자리 — **유토곡선이 사토에서 뺄 밑수**다. 자재총괄은 # `material` 만 모으므로 여기 섞이지 않는다. "채집석": "haul_deduction", # ⚠ 자재 카탈로그가 이름으로 찾는다 — 공백 없는 한 낱말(B09 규약) + # ⚠ **보여 주기만 하는 줄** — 자재도 토공도 일위대가도 아니다. 정본 계산표 좌측 열에 + # 「입적」으로 실려 있어 그 이름 그대로 낸다(2026-09-08 확정 ⑦). 값은 이미 식 안에 + # 있던 것을 줄로 꺼낸 것뿐이고, `material`·`earthwork` 어디에도 안 섞인다. + # ⚠ 「석적」은 정본에 없다(소광리 시트에만) — **안 낸다.** + "입적": "reference", } # ⚠ 배합 성분 — 산출물에 나타나면 안 된다(㉢). B09 일위대가가 배합표로 분해한다. @@ -242,6 +316,8 @@ class Component: # 두 근거가 한 표에 섞이므로 줄마다 단다. 안 적으면 나중에 못 되짚는다. basis_kind: str = BASIS_DERIVED source: str = "" + #: 규격 — 같은 이름이라도 단가가 갈리는 값(채움 콘크리트 강도 등). 받는 쪽이 읽는다. + spec: str = "" @dataclass(slots=True) @@ -368,21 +444,42 @@ def wants_blinding(options: dict[str, Any]) -> bool: return True -def _blinding_component(base_width_m: float, length_m: float, options: dict[str, Any]): - """버림 콘크리트 한 줄. 넣지 않기로 했으면 `None`.""" +def _blinding_component( + base_width_m: float, + length_m: float, + options: dict[str, Any], + width_basis: str = "", +): + """버림 콘크리트 한 줄. 넣지 않기로 했으면 `None`. + + 폭은 **잡석다짐 폭**(KCS 34 50 05)이고, 그 값은 확정 ⑪ 로 **구조물 하단 길이**다. + 부르는 쪽이 그 폭과 까닭(`width_basis`)을 함께 넘긴다. + """ if not wants_blinding(options) or base_width_m <= 0 or length_m <= 0: return None + basis = ( + f"기초 폭 {base_width_m:.2f}m × 연장 × 두께 {BLINDING_THICKNESS_M:.2f}m" + " · 두께는 KDS 44 90 00(100㎜) · 폭은 잡석다짐 폭(KCS 34 50 05)" + ) + if width_basis: + basis = f"{basis} = {width_basis}" return Component( "버림콘크리트", "㎥", base_width_m * length_m * BLINDING_THICKNESS_M, DESTINATION["버림콘크리트"], - f"기초 폭 {base_width_m:.2f}m × 연장 × 두께 {BLINDING_THICKNESS_M:.2f}m" - " · 두께는 KDS 44 90 00(100㎜) · ⚠ 폭은 잡석다짐 폭(KCS 34 50 05)이라야 하나" - " 그 값이 아직 없어 **터파기 폭을 잠정**으로 씀", + basis, ) +#: 기초잡석(품셈 12-25)이 아직 못 서는 까닭 — **폭은 있고 두께가 없다.** +RUBBLE_BASE_BLOCKED = ( + "기초잡석(12-25) 물량이 안 섬 — 폭은 하단 길이 {width:.2f}m 로 섰으나 **두께가 원문에 " + "없음**(품셈 12-25 는 ㎥당 품만 줌). 실무 관측은 관보호공 날개벽 T=0.2 하나뿐이라 " + "다른 구조물 값을 옮겨 쓰지 않음" +) + + #: ⚠ **저장 제원의 실제 칸 이름**은 `back_len_cm` 이다(레지스트리 확인). #: 앞서 `stone_back_length_cm` 을 읽고 있어 **저장값이 영영 안 닿고 늘 기본 45㎝ 로 돌았다** #: — 뒷길이를 75 로 골라도 45 계수가 붙던 자리다. 값이 나오므로 아무 시험도 안 잡았다. @@ -427,8 +524,9 @@ BOULDER_MASONRY = { # ⚠ 검산 참고값 — 곱하지 않는다. 까닭은 `STONE_MASONRY` 의 같은 칸 주석을 볼 것. # 큰돌쌓기는 전면 기울기가 「1:0.3 **이상**」이라 특히 하드코딩하면 안 된다. "sheet_check_factor_at_0_3": 1.04, - "excavation_extra_m": 0.2, # 터파기 폭 여유 - "backfill_thickness_m": 0.2, # 되메우기 두께 + # ⚠ 터파기 여유폭·되메우기 두께는 **공용 한 벌**로 옮겼다 + # (`common_util/common_util_excavation.py` — 화면 B06 과 짝인 TS 가 있다). + # 여기서 다시 두면 그림과 물량이 갈린다. } @@ -469,7 +567,6 @@ def boulder_masonry( # ⚠ 큰돌쌓기는 **표준경사표 대상이 아니다** — 교본이 「1:0.3 **이상**」으로만 두었다. # 저장 제원에 값이 있으면 그것을 쓰고, 없으면 하한 0.3 으로 둔다. slope_ratio = _num(options.get("face_slope_ratio"), 0.3) - constants = BOULDER_MASONRY face_area = height_m * length_m # 기울기 몫은 **한 번만** — 13-4 와 같은 자리다(㉘). masonry_area = face_area * math.hypot(1.0, slope_ratio) @@ -490,30 +587,23 @@ def boulder_masonry( upper_cm = float(str(diameter).split("~")[-1]) thickness = upper_cm / 100.0 # 버림 콘크리트 — 돌쌓기와 같은 자리(사용자 확정 ⑭). 빼려면 저장 제원에서 「안 넣음」. - blinding = _blinding_component(thickness + constants["excavation_extra_m"], length_m, options) + blinding = _blinding_component( + thickness, + length_m, + options, + f"하단 길이(직경 위끝) {thickness:.2f}m — 확정 ⑪ 준용", + ) if blinding is not None: components.append(blinding) - 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["잔토처리"], - "터파기 − 되메우기", - ), - ] + _trench_components( + height_m, + length_m, + thickness, + options, + notes, + "⚠ 큰돌쌓기 터파기 폭 규정이 품셈에 없어 돌쌓기 방식을 준용", + ) ) notes.append( @@ -534,6 +624,66 @@ def boulder_masonry( return components, notes +def _trench_components( + height_m: float, + length_m: float, + thickness: float, + options: dict[str, Any], + notes: list[str], + extra_basis: str = "", +) -> list[Component]: + """터파기·되메우기·잔토 — **공용 단면 함수 한 벌**(`common_util_excavation`). + + ⚠ 여기서 식을 다시 짜지 않는다 — 화면(B06 횡단도)이 그리는 단면과 같은 코드라야 + 그림과 물량이 안 갈린다. 평균두께는 이쪽이 낸 값을 **넘겨 준다**(저쪽은 두께를 모름). + ⚠ 「기초유 / 기초버림」은 정본 탭 제목이고 **기초분 0.45 냐 0.07 이냐**를 가른다. + 안 고른 프로젝트는 **비탈분만** 세우고 사유를 남긴다 — 한쪽으로 찍으면 임의값이 + 금액으로 굳는다(기초분이 통째로 0.45㎥/m 다). + """ + foundation = str(options.get("foundation") or "").strip() + if foundation in ("기초유", "기초버림"): + has_foundation = foundation == "기초유" + area = wall_trench_area_m2(height_m, thickness, has_foundation=has_foundation) + base_depth = WALL_FOUNDATION_DEPTH_M if has_foundation else WALL_BLINDING_DEPTH_M + base_basis = f"기초분({foundation}) + " + else: + width = wall_trench_width_m(thickness) + area = None if width is None else height_m * width + base_depth = 0.0 + base_basis = "" + notes.append( + "⚠ 기초 유/무(기초유·기초버림)를 안 정해 **기초 터파기 몫이 안 섰음** — 비탈분만 세움" + ) + if area is None: + notes.append("⚠ 높이·평균두께가 없어 터파기가 서지 않음") + return [] + excavation = area * length_m + backfill = (base_depth + height_m) * WALL_TRENCH_CLEARANCE_M * length_m + basis = ( + f"{base_basis}H × (평균두께 {thickness:.2f} + {WALL_TRENCH_CLEARANCE_M}) × 연장" + f" · {BASIS_WALL}" + ) + if extra_basis: + basis = f"{basis} · {extra_basis}" + return [ + Component("터파기", "㎥", excavation, DESTINATION["터파기"], basis), + Component( + "되메우기", + "㎥", + backfill, + DESTINATION["되메우기"], + f"(기초깊이 {base_depth:g} + H) × {WALL_TRENCH_CLEARANCE_M} × 연장", + ), + Component( + "잔토처리", + "㎥", + excavation - backfill, + DESTINATION["잔토처리"], + "터파기 − 되메우기", + ), + ] + + def stone_masonry( height_m: float, length_m: float, @@ -617,6 +767,15 @@ def stone_masonry( DESTINATION["돌쌓기"], f"정면적 × √(1+{slope_ratio:g}²) — 비탈면적 · {slope_basis}", ), + # 입적 — 정본 계산표 좌측 열의 이름 그대로다(확정 ⑦). 값을 새로 내는 것이 아니라 + # 이미 쓰고 있던 밑수를 화면에 드러내는 줄이다. + Component( + "입적", + "㎥", + volume, + DESTINATION["입적"], + f"정면적 × 평균두께 {thickness:.2f} · {thickness_basis}", + ), ] # ⚠ 고임돌 계수가 **원문에서 「-」**인 칸이 있다(견치돌 25·30 · 야면석 75 · 깬돌 25). # 그 규격에 그 돌을 안 쓴다는 뜻이라 **0 줄을 만들지 않는다** — 0 은 「없음」과 @@ -650,7 +809,8 @@ def stone_masonry( "ton", masonry_area * stone_ton, DESTINATION["야면석"], - f"돌쌓기 × {stone_ton} ton/㎡ (뒷길이 {back_cm}㎝)", + f"돌쌓기 × {stone_ton} ton/㎡ (뒷길이 {back_cm}㎝) · {STONE_WEIGHT_BASIS}", + source=STONE_WEIGHT_SOURCE, ) ) @@ -672,13 +832,16 @@ def stone_masonry( ) if wet: + mpa, mpa_basis = fill_concrete_mpa(options) components.append( Component( "채움콘크리트", "㎥", masonry_area * _num(table["fill_concrete_m3_per_m2"]), DESTINATION["채움콘크리트"], - f"돌쌓기 × {table['fill_concrete_m3_per_m2']} ㎥/㎡ (뒷길이 {back_cm}㎝)", + f"돌쌓기 × {table['fill_concrete_m3_per_m2']} ㎥/㎡ (뒷길이 {back_cm}㎝)" + f" · {mpa_basis}", + spec=f"{mpa}", ) ) components.append( @@ -732,32 +895,22 @@ def stone_masonry( ) # 버림 콘크리트 — 기초 바닥에 까는 얇은 층. 빼려면 저장 제원에서 「안 넣음」으로 둔다. - base_width = thickness + constants["excavation_extra_m"] - blinding = _blinding_component(base_width, length_m, options) + # 잡석다짐 폭 = **하단 길이**(확정 ⑪) — 벽에서는 하부 두께다. 버림도 같은 폭을 쓴다. + base_width = bottom_thickness + blinding = _blinding_component( + base_width, + length_m, + options, + f"하단 길이(하부 두께) {bottom_thickness:.2f}m — 확정 ⑪ 「기준 구조물에서 유도」", + ) if blinding is not None: components.append(blinding) + notes.append(RUBBLE_BASE_BLOCKED.format(width=base_width)) + # 터파기·되메우기·잔토 — 토공으로 합산되는 값이다(내역 줄이 아니다). - 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:.2f}+0.2) × 연장 · {thickness_basis}", - ), - Component("되메우기", "㎥", backfill, DESTINATION["되메우기"], "높이 × 0.2 × 연장"), - Component( - "잔토처리", - "㎥", - excavation - backfill, - DESTINATION["잔토처리"], - "터파기 − 되메우기", - ), - ] + _trench_components(height_m, length_m, thickness, options, notes, thickness_basis) ) return components, notes @@ -1020,6 +1173,7 @@ def build_table( "basis": component.basis, "basis_kind": component.basis_kind, "source": component.source, + "spec": component.spec, } for component in item.components ],