feat(Z01): 기초단가 정본을 DB 로 — 저장소 신설 · 일괄 저장·줄 추가/삭제·초기값 되돌리기 API · 덮개 층 삭제

- Z01_MasterData_Repository_BasePrices.py 신설 — master_base_price·master_revision Raw SQL(읽기·줄 수·판번호·저장·되돌리기) · 판번호 줄을 잠그고 다시 봄 · 틀리면 통째로 되돌림
- GET /base-prices/{kind} 가 DB 를 읽음 · 응답에 revision · 줄마다 changed_columns·is_added 추가
- PUT /base-prices/{kind} {base_revision, edits, added, deleted} — 판 다르면 409 · 하나라도 틀리면 아무것도 안 씀 · edits 500 상한 · 모르는 칸 거절
- POST /base-prices/{kind}/reset {row_keys} — 주입 줄은 data := seed(지운 줄도 되살림) · 추가 줄은 지움
- 기계 시간당 단가는 DB 노임·유가로 읽을 때마다 셈 · 제원은 줄 값에서(추가한 기종도 섬)
- 옛 덮개 층 삭제 — Z01_MasterData_Overrides.py · 칸 단위 PUT · /overrides·/overrides/clear
- 새 줄 열쇠는 서버가 줌(added/{난수}) · 주입 data 에 '@' 칸이 없어도 축 잠금은 파일 원본으로 섬
- 시험: DB 가짜(helper_z01_fake_repo.py) 로 API 손질 · 저장소 SQL 흐름은 가짜 커넥션으로 잼

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01V1MKKZKpUHTPKb513FneU8

Z01_MasterData/Z01_MasterData_BasePrices_Machine.py

@@ -1,7 +1,7 @@
 """Z01 기초단가 — 기계 한 표: 기종 한 줄 + 시간당 단가(계산값) · 산출근거(2026-09-15 브레인 계약).
 
 기계단가는 취득가 613 · 손료계수 387 · 운전경비(연료·잡재료·조종원 — 건설품셈 8-4) · 노임 · 유가가 계산으로 물림.
-  고치는 칸 = 취득가 · 손료계수(이 표) — 노임·유가는 그 표에서 고치고 여기는 **덮개 얹은 값**을 끌어 씀
+  고치는 칸 = 취득가 · 손료계수(이 표) — 노임·유가는 그 표에서 고치고 여기는 **DB 의 지금 값**을 끌어 씀
   계산 칸 = 손료 · 연료 · 조종원 · 시간당 단가 — editable 에서 빼고 locked 에 까닭
 ⚠ 셈은 B09 함수를 그대로 부름(`load_machine_catalog` · `load_operating_records` · `hourly_machine_cost`) — 식을 두 벌로 안 둠.
   `hourly_cost_of`(B09) 와 같은 값인지 `test_z01_base_prices.py` 가 대조. 반만 선 값(연료·조종원 빠짐)은 시간당 단가를 안 냄.
@@ -9,13 +9,14 @@
 
 from __future__ import annotations
 
-from dataclasses import dataclass, replace
+from dataclasses import dataclass
 from decimal import Decimal
 from functools import lru_cache
 from typing import Any
 
 from B09_Estimation.B09_Estimation_MachineCost import (
     OPERATOR_WAGE_FORMULA,
+    MachineSpec,
     hourly_machine_cost,
     load_machine_catalog,
 )
@@ -40,7 +41,7 @@ _FORMULA = {
 _LOCKED_COMPUTED = "계산값 — 밑값(취득가·손료계수는 이 표 · 노임·유가는 그 표)을 고치면 따라 바뀜"
 _LOCKED_OPERATING = "건설품셈 8-4 운전경비표(로직)에서 옴 — 기초단가가 아님"
 _LOCKED = {
-    "machine_code": "자료 열쇠 — 바꾸면 덮개·다른 표가 이 줄을 못 찾음",
+    "machine_code": "자료 열쇠 — 바꾸면 다른 표가 이 줄을 못 찾음",
     "machine_name": "공표 원문 칸 — 원본 갱신으로만 바뀜",
     "specification": "공표 원문 칸 — 원본 갱신으로만 바뀜",
     "economic_life_hours": "공표 원문 칸 — 원본 갱신으로만 바뀜",
@@ -50,8 +51,8 @@ _LOCKED = {
     "misc_material_percent": _LOCKED_OPERATING,
     "operator_occupation_code": _LOCKED_OPERATING,
     "operator_person_per_day": _LOCKED_OPERATING,
-    "fuel_price_krw_per_l": "유가 표에서 고침 — 여기는 덮개 얹은 전국평균을 끌어 씀",
-    "operator_daily_wage_krw": "노임 표에서 고침 — 여기는 덮개 얹은 건설 노임을 끌어 씀",
+    "fuel_price_krw_per_l": "유가 표에서 고침 — 여기는 전국평균을 끌어 씀",
+    "operator_daily_wage_krw": "노임 표에서 고침 — 여기는 건설 노임을 끌어 씀",
     "hourly_note": "계산이 왜 안 섰는지 — 밑값이 비면 섬",
     "effective_date": "원본 판 기준일 — 원본 갱신으로만 바뀜",
     "operating_effective_date": "운전경비 원단위가 나온 건설품셈 판 기준일",
@@ -75,7 +76,7 @@ def _fmt(value: Decimal | int | float) -> str:
 
 @dataclass(frozen=True)
 class Inputs:
-    """기계 셈이 다른 표에서 끌어 오는 값 — 덮개를 얹은 뒤 · 판 기준일과 함께."""
+    """기계 셈이 다른 표에서 끌어 오는 값 — DB 지금 값 · 판 기준일과 함께."""
 
     wages: dict[str, Decimal | None]
     wage_date: str | None
@@ -123,10 +124,13 @@ def base_rows(source_name: str, effective_date: str | None) -> list[dict[str, An
 
 
 def compute(row: dict[str, Any], inputs: Inputs) -> dict[str, Any]:
-    """덮개 얹은 줄 → 시간당 단가 칸을 붙인 새 줄. B09 `hourly_cost_of` 와 같은 길."""
-    catalog, records = _inputs()
+    """DB 줄 → 시간당 단가 칸을 붙인 새 줄. B09 `hourly_cost_of` 와 같은 길.
+
+    기종 제원은 줄 값에서(카탈로그 아님) — 관리자가 추가한 줄도 섬 · 운전경비 원단위는 코드로 찾아 없으면 빈칸.
+    """
+    _, records = _inputs()
     code = row["@id"]
-    coef = row["loss_coefficient_per_hour"]
+    coef = row.get("loss_coefficient_per_hour")
     record = records.get(code)
     out = {
         **row,
@@ -137,13 +141,17 @@ def compute(row: dict[str, Any], inputs: Inputs) -> dict[str, Any]:
         "operator_wage_date": None,
         **dict.fromkeys(COMPUTED),
     }
-    if coef is None:
-        out["hourly_note"] = "손료계수 없음 — 시간당 단가 안 섬"
+    if coef is None or row.get("price_thousand_krw") is None:
+        out["hourly_note"] = f"{'손료계수' if coef is None else '취득가'} 없음 — 시간당 단가 안 섬"
         return out
-    spec = replace(
-        catalog.machines[code],
+    spec = MachineSpec(
+        machine_code=code,
+        name=str(row.get("machine_name") or ""),
+        specification=str(row.get("specification") or ""),
         price_thousand_krw=Decimal(str(row["price_thousand_krw"])),
         loss_coefficient_per_hour=Decimal(str(coef)),
+        economic_life_hours=row.get("economic_life_hours"),
+        annual_standard_hours=row.get("annual_standard_hours"),
     )
     liters = fuel_price = wage = None
     if record is not None: