eomsangdonandClaude Opus 5
3a452028d3
수량 자릿수 (품셈 1-2-2의 1) - 화면이 모든 수량을 2자리로 찍고 있었음. 품셈은 종목별로 자리를 따로 정함 — 체적합계·시멘트·철근 정수 / 돌쌓기·옹벽·떼 1자리 / 철강재 3자리. - 수량은 반올림([주]①), 금액은 버림 — 반대라 모듈을 갈라 둠. - 항목이 표를 이김([주]②) → override 받음. 표에 없는 종목은 안 건드림. - 서버가 줄마다 quantity_digits 를 실어 보내고 화면은 그 자리로 찍기만 함. 금액 자리 보강 (품셈 1-2-2의 2) - 설계서 총액 1,000원 미만 버림 · 일위대가 계금 1원 미만 버림 추가. 금액란(0.1원)·소계(1원)와 자리가 넷 다 다름. ⚠ 단위 불일치 가드 - 돌쌓기(찰)이 연장 10m 로 오는데 일위대가는 ㎡당이라 52,938.9×10 = 529,389원이 조용히 서 있었음. 면적으로 세면 1,381,753원 — 2.6배 적은 금액이었음. - 단위가 다르면 곱하지 않고 사유를 남김. 표기 차이(㎥/m3·개소/개)는 흡수하되 환산은 안 함. 내역 합계 6,252,172 → 5,048,775 (틀린 두 줄이 빠짐). 제잡비 밑수 - 닫힌 물음임을 원문 인용으로 못 박음 — 산림품셈 [주]③ 여섯 자리가 「노무비의 합계액」이고, 일위대가 안에는 간접노무비가 없으므로 그 표의 노무비 합 = 직접노무비. 하루에 두 번 뒤집힌 값이라 세 번째가 없게 근거를 남김. 시험 10건 추가, 238건 통과. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
258 lines
12 KiB
Python
258 lines
12 KiB
Python
"""B09 원가계산 — 단가 계층 (PLAN 9-3 · 9-4).
|
|
|
|
**표를 세 벌 만들지 않는다.** 「제목 한 줄 + 상세 여러 줄」 한 쌍을 두고 **종류로만** 가른다.
|
|
상용 프로그램 둘(STmate `COSTN`/`BOQ11`, EST Plus `*Title`/`*Main`)이 같은 모양이었고,
|
|
실무 시트 이름도 `일위대가목록표 / 일위대가표` 처럼 짝을 이룬다.
|
|
|
|
실제 층은 넷이다 (2026-09-07 STC `COSTN` 186행 실측, PLAN 9-3):
|
|
|
|
S 중기 취득가(천원) → X 시간당 중기사용료 → B 일위대가 → D 단가산출
|
|
↑ L 노임 · M 자재를 참조
|
|
|
|
금액은 **어느 층이든 재료·노무·경비 3분할**이고 `합계 = 재료 + 노무 + 경비` 다
|
|
(ESTX 9.1만 건 전건 통과).
|
|
|
|
단가 원천은 **슬롯 6개**다 (PLAN 9-4). 번호는 고정, **이름은 프로젝트 설정**이다 —
|
|
설계사무소마다 다르다(영월만 「유통 물가·거래 가격등·기타 단가」). 기본 채택은 **6번**
|
|
(STmate `JUKNM=6`, Ini 보유 6파일 전건 일치).
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from dataclasses import dataclass, field
|
|
from decimal import Decimal
|
|
from enum import Enum
|
|
|
|
_ZERO = Decimal(0)
|
|
|
|
#: 단가 원천 슬롯 수. 번호 고정.
|
|
PRICE_SLOT_COUNT = 6
|
|
#: 기본 채택 슬롯(1-based). STmate `JUKNM=6` = 「적용 단가」.
|
|
DEFAULT_ADOPTED_SLOT = 6
|
|
|
|
#: 슬롯 이름 기본값 — **프로젝트 설정으로 덮어쓴다**.
|
|
#: TODO(미결 PLAN 9-4): 사무소마다 1~5 이름이 달라 확정 기본값이 아님. 프로젝트가 고름.
|
|
DEFAULT_SLOT_NAMES: tuple[str, ...] = (
|
|
"조달가격",
|
|
"물가정보",
|
|
"물가자료",
|
|
"적산정보",
|
|
"견적단가",
|
|
"적용 단가",
|
|
)
|
|
|
|
|
|
class PriceKind(str, Enum):
|
|
"""단가 항목의 종류. STC `COSTN.CODE` 앞글자와 1:1 (PLAN 9-3)."""
|
|
|
|
MATERIAL = "material" # M — 자재 카탈로그 (재료비만)
|
|
LABOR = "labor" # L — 노임 카탈로그 (노무비만)
|
|
MACHINE_BASE = "machine_base" # S — 중기 취득가 (천원 단위, 경비만)
|
|
MACHINE_HOURLY = "machine_hourly" # X — 시간당 중기사용료 (3분할)
|
|
UNIT_PRICE = "unit_price" # B — 일위대가 (3분할)
|
|
PRICE_BASIS = "price_basis" # D — 단가산출 (3분할)
|
|
LUMPSUM = "lumpsum" # W — 일식·견적 (무대처리 등, 단가 0)
|
|
|
|
|
|
#: 카탈로그 층 — 상세를 갖지 않고 값이 바로 있는 종류.
|
|
CATALOG_KINDS = frozenset({PriceKind.MATERIAL, PriceKind.LABOR, PriceKind.MACHINE_BASE})
|
|
|
|
|
|
class PriceBookError(LookupError):
|
|
"""단가 조립이 성립하지 않는 경우. 0 으로 때우지 않고 멈춘다."""
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class Money3:
|
|
"""금액 3분할 — 재료·노무·경비. 합계는 셋의 합이다."""
|
|
|
|
material: Decimal = _ZERO
|
|
labor: Decimal = _ZERO
|
|
expense: Decimal = _ZERO
|
|
|
|
@property
|
|
def total(self) -> Decimal:
|
|
return self.material + self.labor + self.expense
|
|
|
|
def __add__(self, other: Money3) -> Money3:
|
|
return Money3(
|
|
self.material + other.material,
|
|
self.labor + other.labor,
|
|
self.expense + other.expense,
|
|
)
|
|
|
|
def scaled(self, factor: Decimal) -> Money3:
|
|
return Money3(self.material * factor, self.labor * factor, self.expense * factor)
|
|
|
|
|
|
@dataclass
|
|
class PriceTitle:
|
|
"""제목 줄 — 「무엇이 있나」 한 줄. 실무 시트의 `…목록표` 에 해당."""
|
|
|
|
code: str
|
|
kind: PriceKind
|
|
name: str
|
|
spec: str = ""
|
|
unit: str = ""
|
|
|
|
#: 원천 슬롯 6개. 값이 없는 슬롯은 None (그 출처에 안 실린 자재).
|
|
slots: list[Decimal | None] = field(default_factory=lambda: [None] * PRICE_SLOT_COUNT)
|
|
#: 슬롯별 근거 쪽수 — 실무 내역서가 「물가정보 몇 쪽」을 남긴다(STC `PG_` 열).
|
|
slot_pages: list[str | None] = field(default_factory=lambda: [None] * PRICE_SLOT_COUNT)
|
|
#: 채택 슬롯(1-based).
|
|
adopted_slot: int = DEFAULT_ADOPTED_SLOT
|
|
|
|
def adopted_price(self) -> Decimal:
|
|
"""채택 슬롯의 단가. 비어 있으면 0 으로 때우지 않고 멈춘다."""
|
|
if not 1 <= self.adopted_slot <= PRICE_SLOT_COUNT:
|
|
raise PriceBookError(
|
|
f"{self.code}: 채택 슬롯 번호가 범위 밖입니다 ({self.adopted_slot})"
|
|
)
|
|
value = self.slots[self.adopted_slot - 1]
|
|
if value is None:
|
|
raise PriceBookError(
|
|
f"{self.code} ({self.name}): 채택 슬롯 {self.adopted_slot} 에 단가가 없습니다. "
|
|
"유료 물가지를 안 봤다면 6번(적용 단가)에 직접 넣으십시오."
|
|
)
|
|
return value
|
|
|
|
def catalog_money(self) -> Money3:
|
|
"""카탈로그 층의 3분할 — 종류가 성분을 정한다.
|
|
|
|
자재는 재료비만, 노임은 노무비만, 중기 취득가는 경비만 갖는다(STC 실측).
|
|
"""
|
|
price = self.adopted_price()
|
|
if self.kind is PriceKind.MATERIAL:
|
|
return Money3(material=price)
|
|
if self.kind is PriceKind.LABOR:
|
|
return Money3(labor=price)
|
|
if self.kind is PriceKind.MACHINE_BASE:
|
|
return Money3(expense=price)
|
|
raise PriceBookError(f"{self.code}: 카탈로그 종류가 아닙니다 ({self.kind})")
|
|
|
|
|
|
@dataclass
|
|
class PriceDetail:
|
|
"""상세 줄 — 「그것이 무엇으로 이루어졌나」 한 줄.
|
|
|
|
`ref_code` 가 **원천 참조**다. 어느 층을 가리키는지가 그 코드의 종류로 드러난다
|
|
(ESTX `LinkIndex` 와 같은 축).
|
|
"""
|
|
|
|
parent_code: str
|
|
ref_code: str
|
|
quantity: Decimal
|
|
note: str = ""
|
|
#: 비율 행(공구손료 등) — 참조 단가의 %로 계산하는 줄.
|
|
percent_of_parent: Decimal | None = None
|
|
#: **노무비 합계**의 %로 붙는 경비 줄 — 제잡비(품셈 13-6-1 [주]③).
|
|
#: ⚠ `percent_of_parent` 와 다르다: 밑수가 3분할 전체가 아니라 **노무비만**이고,
|
|
#: 결과는 **경비(J)** 로만 들어간다. 「상한」이라 설계자가 낮출 수 있는 값이다.
|
|
percent_of_labor: Decimal | None = None
|
|
|
|
|
|
@dataclass
|
|
class PriceBook:
|
|
"""제목 + 상세 한 벌. 종류로만 갈린다."""
|
|
|
|
titles: dict[str, PriceTitle] = field(default_factory=dict)
|
|
details: dict[str, list[PriceDetail]] = field(default_factory=dict)
|
|
#: 슬롯 이름 — 프로젝트 설정.
|
|
slot_names: tuple[str, ...] = DEFAULT_SLOT_NAMES
|
|
|
|
def add_title(self, title: PriceTitle) -> None:
|
|
if title.code in self.titles:
|
|
raise PriceBookError(f"코드가 겹칩니다: {title.code}")
|
|
self.titles[title.code] = title
|
|
|
|
def add_detail(self, detail: PriceDetail) -> None:
|
|
self.details.setdefault(detail.parent_code, []).append(detail)
|
|
|
|
def title(self, code: str) -> PriceTitle:
|
|
try:
|
|
return self.titles[code]
|
|
except KeyError as exc:
|
|
raise PriceBookError(f"단가표에 없는 코드입니다: {code}") from exc
|
|
|
|
def resolve(self, code: str, _seen: tuple[str, ...] = ()) -> Money3:
|
|
"""그 항목의 단가를 3분할로 조립한다.
|
|
|
|
카탈로그 층(M·L·S)은 값이 바로 있고, 그 위 층(X·B·D)은 상세 줄을 재귀로 더한다.
|
|
`W`(일식·견적)는 **단가가 0** 이다 — 무대처리처럼 품에 이미 포함된 줄 (PLAN 8-7 ㉡).
|
|
"""
|
|
if code in _seen:
|
|
raise PriceBookError(f"단가 참조가 돌고 있습니다: {' → '.join((*_seen, code))}")
|
|
|
|
title = self.title(code)
|
|
if title.kind is PriceKind.LUMPSUM:
|
|
return Money3()
|
|
if title.kind in CATALOG_KINDS:
|
|
return title.catalog_money()
|
|
|
|
rows = self.details.get(code)
|
|
if not rows:
|
|
raise PriceBookError(f"{code} ({title.name}): 상세 줄이 없어 단가를 조립할 수 없습니다")
|
|
|
|
total = Money3()
|
|
# 제잡비 밑수로 쓸 **사람 품(직접노무비)** — 기계 줄 안의 조종원 노임은 안 센다.
|
|
# 근거는 아래 `percent_of_labor` 자리 주석의 인용 셋.
|
|
direct_labor = Decimal(0)
|
|
for row in rows:
|
|
# ⚠ 비율 줄은 **참조를 풀기 전에** 처리한다 — 자기 자신을 가리키므로
|
|
# 먼저 풀면 순환으로 잡힌다(제잡비 줄이 그렇다).
|
|
if row.percent_of_labor is not None:
|
|
# 제잡비 — **노무비 합계**의 %가 **경비**로 붙는다(품셈 13-6-1 [주]③).
|
|
#
|
|
# ⚠ **밑수는 사람 품(직접노무비)이다** — 기계 줄 안의 조종원 노임은
|
|
# 안 센다. 근거 셋(2026-09-08 원문 대조, 두 창 합의):
|
|
# ① 산림품셈 13-6-2 [주]③ — 「제잡비는 콘크리트 버켓 손료, 다짐기계
|
|
# 손료 비용이며 **노무비의 합계액**에 위 표의 비율을 곱한 금액을
|
|
# 상한으로 하여 계상한다」
|
|
# ② 건설품셈 제8장 — 「잡재료 등 손료 : **직접노무비**에 다음 표의
|
|
# 비율을 곱한 것을 상한으로 한다」 (같은 이름의 규정)
|
|
# ③ 같은 장 — 기계를 넣을 때는 「잡재료비 = **노무비, 기계손료 및
|
|
# 운전경비의 합** × 잡재료비율」이라 **따로 적음** ⇒ 넓은 쪽이면
|
|
# 명시하는 서식인데 13-6-2 는 그냥 「노무비」다.
|
|
# 뜻으로도 그렇다 — 제잡비는 **본 자원에 안 선 잔 기계 손료**를 사람
|
|
# 품에 비례해 얹는 자리인데, 그 표엔 굴착기가 이미 본 자원으로 서 있다.
|
|
#
|
|
# ⚠⚠ **닫힌 물음이다 — 다시 뒤집지 말 것** (2026-09-08 전수 대조로 확정).
|
|
# 이 값은 하루에 두 번 뒤집혔고 금액이 약 ±22 % 움직였다. 세 번째가
|
|
# 없도록 근거를 여기 못 박는다.
|
|
# ㉠ **산림품셈이 1차 적용**이고(품셈 1-1·별표2, 건설품셈은 보완),
|
|
# 그 [주]③ 은 여섯 자리에서 한결같이 **「노무비의 합계액」**이라 적는다
|
|
# (원문 L5498·L7013·L7299·L7323·L7350·L7401).
|
|
# ㉡ **일위대가 안에는 간접노무비가 없다.** 간접노무비는 원가계산서 층에서
|
|
# 「직접노무비 × 율」로 나중에 생기는 값이다
|
|
# (resources/knowledge/.../05_원가정보/원가계산_체계.md §2 밑수 정의표).
|
|
# ⇒ 그러므로 **그 표의 노무비 줄 합 = 직접노무비**이고, 「직접노무비냐
|
|
# 노무비 계정이냐」라는 물음 자체가 이 층에서는 성립하지 않는다.
|
|
# ⚠ 건설품셈 제8장(말뚝)은 **「직접노무비」**라고 다르게 적지만, 위 ㉠ 으로
|
|
# 임도는 산림품셈 문구를 따른다 — 결과값은 어차피 같다.
|
|
# ⚠ 「**상한**」이다 — 곱한 값 **이하**로 계상하는 값이라 설계자가 낮출 수 있다.
|
|
total = total + Money3(expense=direct_labor * row.percent_of_labor / Decimal(100))
|
|
continue
|
|
|
|
child = self.resolve(row.ref_code, (*_seen, code))
|
|
if row.percent_of_parent is not None:
|
|
# 비율 행 — 지금까지 쌓인 값의 %로 붙는다(공구손료 등).
|
|
total = total + total.scaled(row.percent_of_parent / Decimal(100))
|
|
continue
|
|
scaled = child.scaled(row.quantity)
|
|
if self.titles[row.ref_code].kind is PriceKind.LABOR:
|
|
direct_labor = direct_labor + scaled.labor
|
|
total = total + scaled
|
|
return total
|
|
|
|
def unmatched_codes(self) -> list[str]:
|
|
"""상세가 가리키는데 제목이 없는 코드 — **빈칸으로 두지 않고 목록으로 낸다**.
|
|
|
|
문자열 매칭 실패를 조용히 0 원으로 넘기지 않기 위한 자리 (PLAN 8-6).
|
|
"""
|
|
missing: list[str] = []
|
|
for rows in self.details.values():
|
|
for row in rows:
|
|
if row.ref_code not in self.titles and row.ref_code not in missing:
|
|
missing.append(row.ref_code)
|
|
return missing
|