"""B09 원가계산 — **수량의 소수자리**는 종목마다 다르다 (산림품셈 1-2-2의 1).

**왜 있는가** — 지금까지 화면이 **모든 수량을 2자리로** 찍고 있었는데, 품셈은 종목별로
자리를 따로 정해 두었다. 체적합계·시멘트·철근은 **정수**, 돌쌓기·옹벽·떼는 **1자리**,
철강재는 **3자리**다. 2자리 고정은 그 어느 것도 아니다 (2026-09-08 지식DB 대조에서 드러남).

    원문 = resources/knowledge/original/행정규칙/임도 품셈 적용기준
           (현 산림사업 표준품셈)/첨부/(산림청고시 제2025-82호) 산림사업 표준품셈.md L575~660
    요약 = resources/knowledge/technical_info/01_임도/04_수량분석정보/수량산출_일반.md §2

⚠ **수량은 반올림이다** ([주]① 「본 표에 따르며, **반올림**하여 적용한다」).
금액이 전부 **버림**인 것과 반대다 — 한 모듈에 섞어 두면 반드시 헷갈리므로
금액은 `B09_Estimation_Rounding` 이 따로 맡는다.

⚠ **항목이 표를 이긴다** ([주]② 「품셈 각 항목에서 제시한 소숫자리가 본 표와 상이할 경우
**항목에서 제시하는 소숫자리를 우선**」). 그래서 `override` 를 받는다. 다만 지금 공종
마스터에 「이 항목의 소수자리」를 담은 칸이 **아직 없다** — 그 칸이 생기면 여기로 흘리면 된다.

⚠ **모르는 종목은 손대지 않는다.** 규칙을 넓게 잡아 엉뚱한 줄까지 자르는 사고를 오늘만
여러 번 겪었다. 표에 없으면 `None` 을 돌려주고 **화면이 종전대로** 찍게 둔다 —
「모른다」가 보이는 편이 조용히 틀리는 것보다 낫다.
"""

from __future__ import annotations

from decimal import ROUND_HALF_UP, Decimal

#: (이름에 들어 있는 말, 그 단위) → 소수자리. **원문 표 순서 그대로** 옮겼다.
#: ⚠ 값을 고칠 일이 생기면 원문을 먼저 볼 것 — 여기서 고치면 근거가 끊긴다.
_DIGITS: tuple[tuple[tuple[str, ...], tuple[str, ...], int], ...] = (
    # 종목 이름 후보 · 단위 후보 · 소수자리
    (("공사연장", "노선연장"), ("m",), 0),
    (("공사폭원", "노폭"), ("m",), 1),
    (("직공인부",), ("인",), 2),
    (("체적합계", "토적합계"), ("㎥", "m3"), 0),
    (("떼", "평떼", "줄떼"), ("㎡", "m2"), 1),
    (("모래", "자갈", "조약돌"), ("㎥", "m3"), 2),
    (("견치돌", "깬돌"), ("㎡", "m2"), 1),
    (("야면석",), ("㎥", "m3"), 1),
    (("돌쌓기", "돌붙임"), ("㎥", "m3", "㎡", "m2"), 1),
    (("사석",), ("㎥", "m3"), 1),
    (("다듬돌", "절석", "판석"), ("개",), 2),
    (("벽돌", "블록"), ("개",), 0),
    (("시멘트",), ("kg", "㎏"), 0),
    (("모르타르", "모르터"), ("kg", "㎏"), 2),
    (("콘크리트",), ("㎥", "m3"), 2),
    (("합판",), ("장",), 1),
    (("말뚝",), ("개",), 0),
    (("철강재", "강재"), ("kg", "㎏"), 3),
    (("용접봉",), ("kg", "㎏"), 1),
    (("철근",), ("kg", "㎏"), 0),
    (("볼트", "너트", "꺽쇠"), ("개",), 0),
    (("철선", "철사"), ("kg", "㎏"), 2),
    (("못",), ("kg", "㎏"), 2),
    (("화약",), ("kg", "㎏"), 3),
    (("뇌관",), ("개",), 0),
    (("도화선",), ("m",), 1),
    (("수로연장",), ("m",), 1),
    (("옹벽",), ("㎡", "m2"), 1),
    (("도장", "칠하기"), ("㎡", "m2"), 1),
    (("방수",), ("㎡", "m2"), 1),
    (("보오링", "보링"), ("m",), 1),
)

#: 위 표에 이름이 안 걸릴 때 **단위만으로** 줄 수 있는 자리 — 품셈 「토적」 줄이 근거다.
#: 토적: 높이·너비 m 2 · 단면적 ㎡ 1 · 체적 ㎥ 2.
#: ⚠ **면적을 1자리로 내리지 않는다** — 「토적(단면적)」은 횡단면적을 말하는 것이라
#: 사면적·거푸집 면적까지 1자리로 자르면 틀린다. 확실한 ㎥ 만 잡는다.
_UNIT_ONLY = {"㎥": 2, "m3": 2}


def _tight(text: str) -> str:
    return "".join(str(text or "").split())


def digits_for(name: str, unit: str, spec: str = "") -> int | None:
    """그 줄의 수량 소수자리. **표에 없으면 `None`** — 지어내지 않는다."""
    haystack = _tight(name) + _tight(spec)
    unit_tight = _tight(unit)
    for words, units, digits in _DIGITS:
        if unit_tight not in units:
            continue
        if any(word in haystack for word in words):
            return digits
    return _UNIT_ONLY.get(unit_tight)


def round_quantity(
    value: Decimal,
    name: str,
    unit: str,
    spec: str = "",
    override: int | None = None,
) -> tuple[Decimal, int | None]:
    """수량을 그 종목의 자리로 **반올림**한다.

    돌려주는 것 — (자른 값, 쓴 자리). 자리를 못 찾으면 **값을 안 건드리고** `(값, None)`.
    `override` 는 품셈 **항목이 따로 제시한 자리**([주]②) — 표보다 우선한다.
    """
    digits = override if override is not None else digits_for(name, unit, spec)
    if digits is None:
        return value, None
    quantum = Decimal(1).scaleb(-digits)
    return value.quantize(quantum, rounding=ROUND_HALF_UP), digits