eomsangdonandClaude Opus 5
76b302be3a
**단수 처리를 「출력 위치」에 바인딩** (`B09_Estimation_Rounding.py`) - `단수처리_규칙.md` §1 — 같은 수량×단가라도 **내역서 본체는 절사, 집계표는 반올림**. 함수가 항목이 아니라 **표 종류**에 붙음. 자리를 안 대고 부르는 길을 안 둠(기본값 없음). - ⚠ **집계표와 본체의 합이 어긋나는 것이 정상** — 「합계가 1원 틀린다」에 계산을 고치지 않도록 `summary_vs_body_gap()` 으로 차이를 값으로 드러내고 화면 문구를 상수로 둠. - 계산은 전정밀, 자르는 것은 표 그리는 자리에서. 값은 원문에서 복사 안 하고 문서를 가리킴. **단가 계층 — 표를 세 벌 만들지 않음** (`B09_Estimation_PriceBook.py`) - 「제목 + 상세」 한 쌍 + 종류 구분. 층은 `S 중기취득가 → X 시간당사용료 → B 일위대가 → D 단가산출`, 바닥은 `M 자재`·`L 노임`, `W 일식·견적`은 **단가 0**(무대처리, 8-7 ㉡). - 금액은 어느 층이든 **재료·노무·경비 3분할**, 합계 = 셋의 합. - **단가 슬롯 6개** — 번호 고정, **이름은 프로젝트 설정**. 기본 채택 6번(`JUKNM=6`). 슬롯별 **근거 쪽수**(STC `PG_` 열) 자리도 둠. - 안전장치: 채택 슬롯이 비면 **0 으로 안 때우고 멈춤** · 없는 코드는 `unmatched_codes()` 로 **목록으로 냄** · 참조 순환 감지. **프로젝트 스냅샷** (`B09_Estimation_Storage.py`) - 채택 단가를 `<project_root>/B09_Estimation/v1/` 에 사본으로. 기준자료가 갱신돼도 **옛 프로젝트 결과가 안 바뀜**. `dataset_version` 은 `dataset_id`+`effective_date`+ `sha256` **세 쪽**. 사본이 바뀌면 지문 불일치로 멈춤. 차수(당초·1~3차) 자리 비워 둠. 자체검증 — 신규 13건 포함 `pytest tmp/tests/ -q` **85 passed** · ruff 통과 · 파일 최대 534줄. 중기 실측값(`X00005` 96,829 = 노 55,700 + 재 18,001 + 경 23,128)으로 3분할 유지·층 쌓임 확인. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
70 lines
3.1 KiB
Python
70 lines
3.1 KiB
Python
"""B09 원가계산 — 단수 처리는 **출력 위치**에 붙는다.
|
|
|
|
`resources/knowledge/technical_info/01_임도/05_원가정보/단수처리_규칙.md` §1 관측:
|
|
같은 「수량 × 단가」라도 **내역서 본체는 절사(ROUNDDOWN), 집계표는 반올림(ROUND)** 이다.
|
|
즉 단수 함수는 **항목이 아니라 표 종류에 바인딩**된다.
|
|
|
|
그래서 이 모듈이 있는 자리 —
|
|
- **계산 함수 안에서 자르지 않는다.** 계산은 전정밀 `Decimal` 로 내고,
|
|
**표를 그리는 자리에서** 이 모듈의 함수로 자른다.
|
|
- ⚠ **집계표(반올림)와 본체(절사)를 더하면 합이 1원 단위로 어긋나는 것이 정상**이다.
|
|
나중에 「합계가 안 맞는다」는 지적이 반드시 나오는데, **그때 계산을 고치면 안 된다.**
|
|
어긋남 자체가 규칙이다.
|
|
|
|
값은 원문에서 복사하지 않는다 — 자릿수·함수만 여기 두고 근거는 위 문서를 가리킨다.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from decimal import ROUND_CEILING, ROUND_FLOOR, ROUND_HALF_UP, Decimal
|
|
from enum import Enum
|
|
|
|
_ONE = Decimal(1)
|
|
_THOUSAND = Decimal(1000)
|
|
|
|
|
|
class OutputPlace(str, Enum):
|
|
"""숫자가 찍히는 자리. 자리마다 단수 함수가 다르다."""
|
|
|
|
#: 설계내역서 행 금액(수량×단가) — 절사
|
|
BOQ_ROW = "boq_row"
|
|
#: 제경비 각 항목(밑수×율) — 행별 절사
|
|
OVERHEAD_ROW = "overhead_row"
|
|
#: 조달수수료(관급×율) — 절사
|
|
PROCUREMENT_FEE = "procurement_fee"
|
|
#: 자원 집계표(재료·노무·경비·중기) — **반올림**
|
|
RESOURCE_SUMMARY = "resource_summary"
|
|
#: 관급자재대 총액 — **천원 올림**
|
|
OWNER_MATERIAL_TOTAL = "owner_material_total"
|
|
|
|
|
|
def round_at(value: Decimal, place: OutputPlace) -> Decimal:
|
|
"""그 자리의 규칙대로 자른다.
|
|
|
|
자리를 안 대고 부르는 길을 두지 않는다 — 기본값을 두면 어느 자리인지 모른 채
|
|
아무 함수나 쓰게 된다.
|
|
"""
|
|
if place in (OutputPlace.BOQ_ROW, OutputPlace.OVERHEAD_ROW, OutputPlace.PROCUREMENT_FEE):
|
|
return value.quantize(_ONE, rounding=ROUND_FLOOR)
|
|
if place is OutputPlace.RESOURCE_SUMMARY:
|
|
return value.quantize(_ONE, rounding=ROUND_HALF_UP)
|
|
if place is OutputPlace.OWNER_MATERIAL_TOTAL:
|
|
return (value / _THOUSAND).quantize(_ONE, rounding=ROUND_CEILING) * _THOUSAND
|
|
raise ValueError(f"단수 처리 자리를 모릅니다: {place}")
|
|
|
|
|
|
#: 집계표와 본체를 나란히 보일 때 화면 비고에 다는 문구.
|
|
#: 「합이 1원 안 맞는다」는 지적에 계산을 고치지 않게 하려는 것이다.
|
|
SUMMARY_MISMATCH_NOTE = (
|
|
"집계표는 반올림, 내역서 본체는 절사 — 두 표의 합이 원 단위로 어긋나는 것은 정상입니다."
|
|
)
|
|
|
|
|
|
def summary_vs_body_gap(summary_total: Decimal, body_total: Decimal) -> Decimal:
|
|
"""집계표 합계와 내역서 본체 합계의 차이.
|
|
|
|
**0 이 아닌 것이 정상**이다. 화면에 그 차이를 숨기지 않고 보여, 설계자가
|
|
「어긋남이 규칙임」을 알고 넘어가게 한다.
|
|
"""
|
|
return summary_total - body_total
|