feat(master_data): 로직 재료 줄 고르기 조건 — 구분·상세구분·규격 후보 · 대표 줄 · 후보 목록 API

- `_틀.md` 7장에 재료 고르기 문법 — 호표 `요소` 를 조건 묶음으로 · 규격 낱말 조건 · 대표 줄 지정
- 엔진 `candidates`·`pick`·`check_pick` — 조건 안 후보 목록(화면·테스트 컨테이너 공용) · 시험 계산은 대표 줄, 없으면 값 있는 첫 줄(자재지역 우선)
- 로직 검사에 고르기 조건 검사 — 칸 이름 · 자재품목에 없는 구분·상세구분 · 조건 밖 대표 · 후보 0
- M01 서버 `GET /api/m01/materials` — 구분·상세구분·규격·자재지역으로 좁힌 후보와 기본 줄
- 옛 방식 재료 줄(`MP…`·`MT…` 키)은 그대로 돎

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JgUhN55Z3BCYhUJTjwTNfj

resources/master_data/scripts/master_material.py

@@ -16,6 +16,7 @@ LINKED = "MP"  # 품셈재료 테이블ID
 MARKET = "MT"  # 자재품목 테이블ID
 PRICED = "MO"  # 유가전력 테이블ID — 값 한 칸
 SLOTS = ("물가자료", "유통물가", "물가정보", "거래가격", "관급")  # 자재품목 값 열
+PICK_KEYS = ("구분", "상세구분", "규격", "대표")  # 재료 고르기 조건 칸 (`_틀.md` 7장)
 REGION = "자재지역"  # 로직 입력 — 「지역」 은 유가 고르기가 씀
 TARIFF = "전력 계약종별"  # 로직 입력 — 품셈·계약예규에 계약종별 규정 없음
 _UNITS = {"ea": "개", "ton": "톤", "t": "톤", "l": "ℓ", "리터": "ℓ", "set": "조", "세트": "조"}
@@ -104,8 +105,58 @@ def _candidates(master: mf.Master, ref: str, row: dict, env: dict) -> list[str]:
     return [key for _, key in hits]
 
 
-def element(master: mf.Master, ref: str, env: dict) -> tuple[object, str | None]:
-    """요소 값과 출처 — 자재품목은 제 줄, 품셈재료는 연결을 따라가 낮은 값 · 그 밖은 줄의 `값`."""
+# ── 재료 고르기 ────────────────────────────────────────────────────────
+def candidates(master: mf.Master, cond: dict, env: dict | None = None) -> list[str]:
+    """고르기 조건 안 자재품목 키 — 구분 · 상세구분 · 규격 낱말이 모두 든 줄 · 파일 차례대로.
+    입력 `자재지역` 이 있으면 이름에 그 지역이 든 줄만(그런 줄이 없으면 조건 안 전부)."""
+    want = [plain_spec(w) for w in str(cond.get("규격") or "").split()]
+    detail = cond.get("상세구분")
+    hits = [
+        key
+        for key, row in master.index.get(MARKET, {}).items()
+        if row.get("구분") == cond.get("구분")
+        and (not detail or row.get("상세구분") == detail)
+        and all(w in plain_spec(row.get("규격")) for w in want)
+    ]
+    region = plain((env or {}).get(REGION, ""))
+    near = [k for k in hits if region in plain(master.get(k).get("이름"))] if region else []
+    return near or hits
+
+
+def pick(master: mf.Master, cond: dict, env: dict) -> str:
+    """시험 계산이 쓸 줄 — 관리자가 정한 `대표`, 없으면 조건 안 값 있는 첫 줄."""
+    if cond.get("대표"):
+        return str(cond["대표"])
+    keys = candidates(master, cond, env)
+    keys = [k for k in keys if _offers(master, k)] or keys
+    if not keys:
+        raise mf.FormulaError(f"재료 고르기 후보 없음 — {cond}")
+    return keys[0]
+
+
+def check_pick(master: mf.Master, where: str, cond: dict) -> list[str]:
+    """고르기 조건 검사 — 칸 이름 · 구분·상세구분이 자재품목에 있는지 · 대표 줄 · 후보 0."""
+    if set(cond) - set(PICK_KEYS) or not cond.get("구분"):
+        return [f"{where} · 재료 고르기 조건 모양 「{cond}」 — {' · '.join(PICK_KEYS)}"]
+    out, rows = [], master.index.get(MARKET, {})
+    for slot in ("구분", "상세구분"):
+        if cond.get(slot) and not any(r.get(slot) == cond[slot] for r in rows.values()):
+            out.append(f"{where} · 자재품목에 없는 {slot} 「{cond[slot]}」")
+    rep = cond.get("대표")
+    if rep and str(rep) not in rows:
+        out.append(f"{where} · 대표 줄 「{rep}」 이 자재품목에 없음")
+    elif rep and str(rep) not in candidates(master, cond):
+        out.append(f"{where} · 대표 줄 「{rep}」 이 고르기 조건 밖")
+    if not out and not candidates(master, cond):
+        out.append(f"{where} · 재료 고르기 후보 0")
+    return out
+
+
+def element(master: mf.Master, ref, env: dict) -> tuple[object, str | None]:
+    """요소 값과 출처 — 자재품목은 제 줄, 품셈재료는 연결을 따라가 낮은 값 · 그 밖은 줄의 `값`.
+    `ref` 가 고르기 조건 묶음이면 대표 줄(없으면 조건 안 첫 줄)로 풂."""
+    if isinstance(ref, dict):
+        ref = pick(master, ref, env)
     row = master.get(ref)
     if ref[:2] == MARKET:  # 자재품목을 바로 가리키는 호표 줄
         return _lowest(master, ref)