feat(B09): 유가 지역 단가를 물림 — 시도를 고르면 그 값으로 기계 연료비가 다시 섬

품셈 8-1-7 5호 「유류가격은 해당지역의 가격으로 한다」. 칸은 있었으나 시도별 값이
없어 잠겨 있었음. 오피넷 avgSidoPrice.do 스냅샷을 받아 데이터셋으로 세우고 물림.

- 안 고르면 전국평균 그대로 — 현장 소재지를 임의로 찍지 않음.
- 판에 없는 지역은 조용히 전국평균으로 눕지 않고 사유를 남김.
- 「지역 공시가」를 고를 수 있는지는 코드가 아니라 판이 정함.
- ⚠ 원천의 시도 가름이 행정구역과 다름(20=전남광주 한 줄, 07·16 없음) — 원문 그대로 둠.
- 수집 스크립트에 시도별 호출을 더함(전국평균과 두 벌로 보존).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

B09_Estimation/B09_Estimation_MachineOperating.py

@@ -289,20 +289,72 @@ def write_operating_records(
     return path
 
 
-def load_fuel_price(oil_file: str = "oil_2026-08-14.json") -> tuple[Decimal, dict[str, str]]:
-    """경유 단가와 그 판의 신원.
+#: 시도별 유가 판 — 품셈 8-1-7 5호 「유류가격은 **해당지역의 가격**으로 한다」.
+#: ⚠ **파일이 있을 때만 지역을 고를 수 있다** — 없으면 전국평균 한 벌로 돈다(코드로 막지 않음).
+REGIONAL_OIL_FILE = "oil_regional_2026-09-09.json"
 
-    ⚠ **전국평균이다.** 품셈 8-1-7 5호는 「유류가격은 **해당 지역의 가격**」이라
-    규정하므로 나중에 현장 소재지 값으로 갈아끼울 자리다 (TODO 미결 PLAN 9-6).
-    지역 파라미터 자리만 뚫어 두고 지금은 전국평균을 잠정으로 쓴다.
+
+def load_regional_fuel_table(oil_file: str = REGIONAL_OIL_FILE) -> tuple[dict[str, dict], dict]:
+    """(시도코드 → {이름·값}, 판 신원). 판이 없으면 **빈 표**를 돌려준다.
+
+    ⚠ 원문에 있는 코드 `00`(전국)은 **지역 선택지에서 뺀다** — 그 자리는 전국평균 판이
+    맡고, 두 판이 같은 이름으로 서면 어느 값으로 섰는지 못 가린다.
     """
-    payload = _read_json(*_CATALOG_SUBPATH, oil_file)
+    try:
+        payload = _read_json(*_CATALOG_SUBPATH, oil_file)
+    except FileNotFoundError:
+        return {}, {}
     diesel = payload["variables"]["oil_diesel"]
-    return Decimal(str(diesel["value"])), {
+    table = {
+        str(record["sido_code"]): {
+            "name": str(record["sido_name"]),
+            "value": Decimal(str(record["value"])),
+        }
+        for record in diesel.get("records", [])
+        if str(record["sido_code"]) != "00"
+    }
+    meta = {
         "dataset_id": payload.get("dataset_id", ""),
         "effective_date": payload.get("effective_date", ""),
         "scope": diesel.get("scope", ""),
     }
+    return table, meta
+
+
+def load_fuel_price(
+    oil_file: str = "oil_2026-08-14.json", region: str | None = None
+) -> tuple[Decimal, dict[str, str]]:
+    """경유 단가와 그 판의 신원. `region`(시도코드)을 주면 **그 지역 값**으로 선다.
+
+    품셈 8-1-7 5호가 「유류가격은 **해당 지역의 가격**」이라 규정한다.
+    ⚠ **안 주면 전국평균**이다 — 현장 소재지를 임의로 찍지 않는다(프로젝트가 고름).
+    ⚠ 준 지역이 판에 없으면 **조용히 전국평균으로 눕지 않고** 그 사실을 신원에 적는다.
+    """
+    payload = _read_json(*_CATALOG_SUBPATH, oil_file)
+    diesel = payload["variables"]["oil_diesel"]
+    meta = {
+        "dataset_id": payload.get("dataset_id", ""),
+        "effective_date": payload.get("effective_date", ""),
+        "scope": diesel.get("scope", ""),
+        "region": "",
+        "region_name": "",
+    }
+    if not region:
+        return Decimal(str(diesel["value"])), meta
+
+    table, region_meta = load_regional_fuel_table()
+    picked = table.get(str(region))
+    if picked is None:
+        meta["region"] = str(region)
+        meta["region_missing"] = "그 지역 값이 판에 없어 전국평균으로 섰습니다"
+        return Decimal(str(diesel["value"])), meta
+    return picked["value"], {
+        "dataset_id": region_meta.get("dataset_id", ""),
+        "effective_date": region_meta.get("effective_date", ""),
+        "scope": region_meta.get("scope", ""),
+        "region": str(region),
+        "region_name": picked["name"],
+    }
 
 
 def load_operator_wages(labor_file: str = "labor_const_2026-01-01.json") -> dict[str, Decimal]:
@@ -342,7 +394,7 @@ def hourly_cost_of(machine_code: str, *, region: str | None = None):
     """기종 하나의 **시간당 사용료 3분할**을 완성해 돌려준다.
 
     재료비 = 주연료 × 유가 + 잡재료(주연료의 %) / 노무비 = 조종원 일당 ÷ 8시간 /
-    경비 = 손료. `region` 은 유가 지역값 자리 — 지금은 전국평균만 있어 무시된다.
+    경비 = 손료. `region`(시도코드)을 주면 **그 지역 유가**로 선다(품셈 8-1-7 5호).
     """
     from B09_Estimation.B09_Estimation_MachineCost import hourly_machine_cost, load_machine_catalog
 
@@ -353,7 +405,7 @@ def hourly_cost_of(machine_code: str, *, region: str | None = None):
     if record is None:
         return hourly_machine_cost(machine)
 
-    fuel_price, _ = load_fuel_price()
+    fuel_price, _ = load_fuel_price(region=region)
     wages = load_operator_wages()
 
     liters = record.fuel_liters_per_hour