eomsangdonandClaude Opus 5
aadb4f6756
- 자재단가대비표: 적용 칸을 calc+rule(기.가·유.물·견적), 값 없는 원천 칸은 blocked - 환율및기초자료: 공표·공시값 standard 와 사용자가 고른 유가 범위 input 을 가름 - 단가산출근거·산출기초: 모으는 표라 식을 비우고 source·등급만 채움 - 설계서 구성표·산출 조건 패널은 일부러 뺌(프로젝트 값이 아니거나 근거 한 줄과 중복) - 원가계산서 금액은 총원가·도급금액·총계 세 줄에만 칸 단위 final 을 심음 - 700줄을 넘어 Provenance / _Sources / _Common 셋으로 가름(공통 조각을 한쪽에 두면 불러들이기가 고리를 이룸) 사전 16장 92열, 등급 여덟이 모두 쓰임. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GrXDD23Dvt2sR7q3X6oekp
269 lines
12 KiB
Python
269 lines
12 KiB
Python
"""B09 **바깥에서 온 값**과 **모으는 표**의 근거 사전 (PLAN 8-36 ④).
|
|
|
|
왜 파일을 갈랐나
|
|
`B09_Estimation_Provenance.py` 가 700줄을 넘었다(CLAUDE.md 4장). 가르는 금은
|
|
**값을 낳는 장**과 **값이 바깥에서 오거나 모으기만 하는 장**이다 —
|
|
· 저쪽: 원가계산서·내역서·일위대가·자재대·중기·기초자료 목록표
|
|
· 이쪽: 자재단가대비표·환율및기초자료·단가산출근거·산출기초
|
|
이쪽 넷은 식이 얇거나 아예 없고, 대신 **「어느 판에서 왔나」**가 알맹이다.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from typing import Any
|
|
|
|
from common_util.common_util_provenance import (
|
|
TIER_BLOCKED,
|
|
TIER_CALC,
|
|
TIER_INPUT,
|
|
TIER_STANDARD,
|
|
TIER_UNCLASSIFIED,
|
|
ColumnProvenance,
|
|
sheet_provenance,
|
|
)
|
|
from B09_Estimation.B09_Estimation_Provenance_Common import _label, _note_column
|
|
|
|
|
|
# =============================================================================
|
|
# ⑥ 자재단가대비표 — **원천 다섯 중 하나를 고르는** 자리
|
|
# =============================================================================
|
|
|
|
|
|
def material_comparison_sheet() -> dict[str, Any]:
|
|
"""실무 시트의 「기.가 · 유.물 · 견적」 약호가 곧 채택 근거다.
|
|
|
|
⚠ 원천 칸이 **여럿이라도 뜻은 하나**다(어느 판이 얼마라 했나). 슬롯마다 열 키를
|
|
따로 두면 사전이 다섯 벌이 되고 판이 늘 때마다 어긋난다 — 한 키를 나눠 쓴다.
|
|
"""
|
|
return sheet_provenance(
|
|
[
|
|
_label("code", "코드번호"),
|
|
_label("name", "명 칭"),
|
|
_label("spec", "규 격"),
|
|
_label("unit", "단위"),
|
|
ColumnProvenance(
|
|
key="slot_price",
|
|
label="원천 단가",
|
|
tier=TIER_STANDARD,
|
|
formula="그 판이 적어 놓은 값을 그대로 옮김",
|
|
source="물가지·거래가격·업체 견적 등 판마다 다름 — 오른쪽 「페이지」 칸이 "
|
|
"어느 쪽에서 왔는지 가리킨다",
|
|
rule="⚠ **빈 칸은 「0원」이 아니라 「그 판에 그 품목이 없다」** — "
|
|
"0 으로 때우지 않는다",
|
|
code="B09_Estimation_Lists_Sources.py:79 material_price_comparison",
|
|
),
|
|
ColumnProvenance(
|
|
key="slot_page",
|
|
label="페이지",
|
|
tier=TIER_STANDARD,
|
|
formula="그 값이 실린 쪽수·출처 표기",
|
|
source="실무 시트의 「기.가 1,024」 같은 약호 — 사람이 원문을 찾아갈 열쇠",
|
|
code="B09_Estimation_Lists_Sources.py:79 material_price_comparison",
|
|
),
|
|
ColumnProvenance(
|
|
key="adopted_price_krw",
|
|
label="적 용",
|
|
tier=TIER_CALC,
|
|
formula="원천 다섯 중 **채택한 하나**의 값",
|
|
source="채택한 칸은 표에서 굵게 선다 — 표가 스스로 「어느 값을 썼나」를 밝힌다",
|
|
rule="⚠ **값 안에 고름이 숨은 열**(PLAN 8-36 ㉯). 실무 약호가 곧 채택 규칙이다 "
|
|
"— 「기.가」(정부 기준가격) · 「유.물」(물가정보) · 「견적」(업체). "
|
|
"슬롯 6 이 곧 적용 단가라 그 자리에 값이 서면 「적용」 칸을 따로 안 세운다",
|
|
code="B09_Estimation_Lists_Sources.py:79 material_price_comparison",
|
|
),
|
|
_note_column("B09_Estimation_Lists_Sources.py:79"),
|
|
]
|
|
)
|
|
|
|
|
|
# =============================================================================
|
|
# ⑦ 환율및기초자료 — **바깥에서 온 값**과 **우리가 고른 것**이 갈리는 장
|
|
# =============================================================================
|
|
|
|
|
|
def base_reference_labor_sheet() -> dict[str, Any]:
|
|
"""② 인건비 — 공표 노임을 시간당으로 푼 표."""
|
|
return sheet_provenance(
|
|
[
|
|
_label("code", "코드번호"),
|
|
_label("name", "직 종"),
|
|
ColumnProvenance(
|
|
key="day_wage_krw",
|
|
label="일 당",
|
|
tier=TIER_STANDARD,
|
|
formula="공표 노임을 그대로 옮김",
|
|
source="대한건설협회 시중노임 공표값. ⚠ **기본급여액뿐**이라 제수당·상여금·"
|
|
"퇴직급여충당금은 따로 계상해야 한다",
|
|
rule="표본이 얇은 직종(조사현장 5곳 미만 `*` · 미조사 `**`)은 금액은 서되 "
|
|
"그 사실을 화면이 따로 알린다",
|
|
code="B09_Estimation_Lists_Sources.py:137 base_reference_data",
|
|
),
|
|
ColumnProvenance(
|
|
key="hourly_krw",
|
|
label="시간당",
|
|
tier=TIER_CALC,
|
|
formula="일당 ÷ 8시간",
|
|
source="⚠ **나눈 값을 자르지 않고 그대로 둔다** — 여기서 원 단위로 자르면 "
|
|
"기계 시간당 사용료가 조금씩 어긋난다. 자르는 자리는 일위대가·내역서 쪽",
|
|
code="B09_Estimation_Lists_Sources.py:137 base_reference_data",
|
|
),
|
|
ColumnProvenance(
|
|
key="formula",
|
|
label="산 식",
|
|
tier=TIER_CALC,
|
|
formula="그 줄이 실제로 쓴 셈을 사람이 읽게 적은 한 줄",
|
|
source="서버가 값과 같이 지음 — 화면이 따로 짓지 않는다",
|
|
code="B09_Estimation_Lists_Sources.py:137 base_reference_data",
|
|
),
|
|
]
|
|
)
|
|
|
|
|
|
def base_reference_fuel_sheet() -> dict[str, Any]:
|
|
"""③ 단가 및 재료비 — 유가 한 줄. 지역을 고르면 기계 연료비가 다시 선다."""
|
|
return sheet_provenance(
|
|
[
|
|
_label("item", "항 목"),
|
|
ColumnProvenance(
|
|
key="price_krw",
|
|
label="단 가",
|
|
tier=TIER_STANDARD,
|
|
formula="공시가를 그대로 옮김 (전국 또는 고른 시도)",
|
|
source="한국석유공사 공시가. 이 값이 바뀌면 **기계 연료비가 통째로 다시 선다**",
|
|
code="B09_Estimation_Lists_Sources.py:137 base_reference_data",
|
|
),
|
|
ColumnProvenance(
|
|
key="scope",
|
|
label="적용 범위",
|
|
tier=TIER_INPUT,
|
|
formula="사용자가 고른 유가 범위 (전국 공시가 또는 현장 시도)",
|
|
source="안 고르면 전국 공시가로 선다 — 고른 적이 없다는 뜻이지 "
|
|
"「전국이 맞다」는 뜻이 아니다",
|
|
rule="⚠ **자료가 없는 시도는 고를 수 없게 둔다.** 고르게만 해 두고 값이 없으면 "
|
|
"조용히 틀린 값이 선다",
|
|
code="B09_Estimation_Lists_Sources.py:44 fuel_scopes",
|
|
),
|
|
ColumnProvenance(
|
|
key="effective_date",
|
|
label="기준일",
|
|
tier=TIER_STANDARD,
|
|
formula="그 공시가의 기준일",
|
|
source="어느 판으로 섰는지는 산출기초 ① 에 지문까지 남는다",
|
|
code="B09_Estimation_Lists_Sources.py:137 base_reference_data",
|
|
),
|
|
_label("dataset_id", "자료", "판 이름 — 산출기초 ① 의 같은 낱말"),
|
|
]
|
|
)
|
|
|
|
|
|
# =============================================================================
|
|
# ⑧ 모으는 표 둘 — **값을 낳지 않는다.** 식은 비우고 「어디서 왔나」만 적는다
|
|
# =============================================================================
|
|
|
|
|
|
def price_basis_sheet() -> dict[str, Any]:
|
|
"""단가산출근거 목록 — 내역서 줄의 단가가 어느 일위대가에서 왔는지.
|
|
|
|
⚠ **여기서 값을 다시 셈하지 않는다.** 그래서 `formula` 를 비웠다 — 없는 식을
|
|
지어 적으면 읽는 사람이 「여기서 계산한다」고 잘못 읽는다.
|
|
"""
|
|
return sheet_provenance(
|
|
[
|
|
ColumnProvenance(
|
|
key="number",
|
|
label="번호",
|
|
tier=TIER_STANDARD,
|
|
source="내역서에 **쓰인 차례**대로 매긴 번호 — 실무 참조번호(「단산 46」)가 "
|
|
"곧 이 번호다",
|
|
code="B09_Estimation_PriceBasis.py:74 build_price_basis",
|
|
),
|
|
_label("name", "공종", "공종 이름 + 규격"),
|
|
_label("unit", "단위"),
|
|
ColumnProvenance(
|
|
key="unit_price_krw",
|
|
label="단가",
|
|
tier=TIER_CALC,
|
|
source="한 층 아래 일위대가 본표의 합계를 **그대로 옮긴 값** — 그 표는 "
|
|
"일위대가 탭에서 본다(본문 「참조」가 그 코드를 가리킨다)",
|
|
code="B09_Estimation_PriceBasis.py:74 build_price_basis",
|
|
),
|
|
]
|
|
)
|
|
|
|
|
|
def basis_sheet_tables() -> dict[str, dict[str, Any]]:
|
|
"""산출기초 네 표. **모으기만 하는 장**이라 식이 없다.
|
|
|
|
⚠ 이 장이 답하는 물음은 「이 값이 얼마인가」가 아니라 **「어느 판·어느 근거로
|
|
섰나」** 다. 그래서 `source` 와 등급만 채운다.
|
|
"""
|
|
versions = sheet_provenance(
|
|
[
|
|
_label("dataset_id", "자료", "판 이름"),
|
|
_label("file", "파일", "그 판의 파일 이름"),
|
|
ColumnProvenance(
|
|
key="effective_date",
|
|
label="기준일",
|
|
tier=TIER_STANDARD,
|
|
source="그 판이 언제 것인가 — 값이 달라졌을 때 가장 먼저 보는 자리",
|
|
code="B09_Estimation_BasisSheet.py:44 dataset_versions",
|
|
),
|
|
ColumnProvenance(
|
|
key="sha256",
|
|
label="지문(앞 12)",
|
|
tier=TIER_UNCLASSIFIED,
|
|
source="파일 해시. 값도 근거도 아니고 **재현성 표식**이라 여섯 어디에도 "
|
|
"안 맞는다(PLAN 8-36 ㉰). 「같은 판으로 다시 세웠나」를 가르는 데만 쓴다",
|
|
code="B09_Estimation_BasisSheet.py:44 dataset_versions",
|
|
),
|
|
]
|
|
)
|
|
chosen = sheet_provenance(
|
|
[
|
|
_label("item", "항 목", "고를 수 있는 자리의 이름"),
|
|
ColumnProvenance(
|
|
key="value",
|
|
label="고른 값",
|
|
tier=TIER_INPUT,
|
|
source="사용자가 산출 조건에서 고른 값 — 비어 있으면 **고른 적이 없어 "
|
|
"확정 기본값으로 돌고 있다**는 뜻이다",
|
|
code="B09_Estimation_BasisSheet.py:77 chosen_conditions",
|
|
),
|
|
]
|
|
)
|
|
items = sheet_provenance(
|
|
[
|
|
_label("code", "코드"),
|
|
_label("name", "공 종"),
|
|
_label("unit", "단위"),
|
|
ColumnProvenance(
|
|
key="notes",
|
|
label="근 거",
|
|
tier=TIER_STANDARD,
|
|
source="그 공종의 단가가 **어느 품셈 표·어느 [주]** 를 따랐는지. 줄에 달린 "
|
|
"근거를 모아 온 것이라 여기서 새로 짓지 않는다",
|
|
code="B09_Estimation_BasisSheet.py:106 work_item_basis",
|
|
),
|
|
]
|
|
)
|
|
gaps = sheet_provenance(
|
|
[
|
|
_label("kind", "갈 래", "못 채운 사유의 갈래"),
|
|
_label("code", "코드"),
|
|
ColumnProvenance(
|
|
key="reason",
|
|
label="사 유",
|
|
tier=TIER_BLOCKED,
|
|
source="⚠ **0 으로 때우지 않고 남겨 둔 자리.** 근거가 오면 채워질 자리이지 "
|
|
"「세면 안 되는 자리」가 아니다",
|
|
code="B09_Estimation_BasisSheet.py:134 open_gaps",
|
|
),
|
|
]
|
|
)
|
|
return {
|
|
"basis_versions": versions,
|
|
"basis_chosen": chosen,
|
|
"basis_items": items,
|
|
"basis_gaps": gaps,
|
|
}
|