fix(git): 병합이 떨군 파일 22개와 되돌아간 파일 35개를 되살림

무슨 일이 있었나
랩탑 줄의 병합 `20ba886c`(Merge origin/main_desktop_1·main_laptop_1·sub_desktop_1 into
sub_laptop_1)가 우리 파일 22개를 떨구고 35개 파일의 내용을 옛것으로 되돌림. 손으로 지운
커밋은 없고 **병합 자체가 떨군 것**임. 그것이 `origin/dev`·`main_laptop_1`·`sub_laptop_1`·
`CODEX` 까지 퍼졌고(데스크탑 둘만 무사), 이 창의 병합 `d92c1f2b` 로 들어옴.

잃었던 것
- 공용 — `common_util_provenance.py` · `ui_template_provenance.ts`
- B08 — 근거 사전 · 좌측 패널 상자 모듈 · 토량환산계수 칸
- B09 — 근거 사전 셋
- B05 — 계획노선 편집 모듈 아홉 · 지형 라우터 · B04 지도 모듈
- 시험 셋과, 35개 파일 안의 최근 작업(환산계수 고르기 · 근거 호버 배선 등)

어떻게 되살렸나
`611a2b40`(병합 직전, 전부 온전)에서 `git show <커밋>:<경로>` 로 내용만 꺼내 되돌림.
이력은 안 건드림. ⚠ HEAD 에만 있던 「추가 816줄」은 랩탑의 새 작업이 아니라 **되살아난
옛 코드**였음(B05 편집은 모듈로 쪼개기 전 덩어리 · B08 라우터는 환산계수 고르기 전 옛
상수판). 되돌릴 시점 이후의 **진짜 새 커밋은 둘뿐**이라 그 둘만 패치로 다시 얹음 —
`9f827bf6`(리로드 빌드 고리 끊기, 데스크탑 보조) · `b9bca6b3`(B06 조정창 1px, 랩탑).
위키 여덟은 코덱스 몫이라 손대지 않음.

자체검증 — 양쪽 작업이 다 살아 있음을 짚어 확인: `main.py` 의 「개발 서버는 살려 둔다」 ·
`B05_Profile_Engine_Grade.py` 의 `plan_curve_length_limit_m` · `B08_..._EarthworkGrid.ts` 의
`attachProvenance`. `tsc --noEmit` 통과 · `pytest -q` **1317 passed, 28 skipped**
(되살리기 전에는 시험 둘이 수집 단계에서 깨져 있었음).

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

B09_Estimation/B09_Estimation_Router.py

@@ -28,6 +28,7 @@ from B09_Estimation.B09_Estimation_Engine_Cost import (
     proposed_profit_adjustment,
 )
 from B09_Estimation.B09_Estimation_PriceBook import PriceBookError
+from B09_Estimation.B09_Estimation_Provenance import estimation_provenance
 from B09_Estimation.B09_Estimation_BillOfQuantities import bill_summary, build_bill
 from B09_Estimation.B09_Estimation_Guards import DoubleCountError
 from B09_Estimation.B09_Estimation_Rates import RateLookupError
@@ -47,6 +48,18 @@ logger = logging.getLogger(__name__)
 router = APIRouter(prefix="/api/projects", tags=["B09 Estimation"])
 
 
+def _with_provenance(body: dict[str, Any]) -> dict[str, Any]:
+    """근거 사전을 응답에 얹는다 — **개발환경이 아니면 칸 자체를 안 만든다.**
+
+    ⚠ 빈 dict 를 실으면 화면이 「사전이 있는데 비었다」로 읽어 빈 카드를 띄운다.
+    그래서 `None` 이면 **키를 넣지 않는다**(로직 보안의 문은 서버 쪽 하나뿐이다).
+    """
+    provenance = estimation_provenance()
+    if provenance is not None:
+        body["provenance"] = provenance
+    return body
+
+
 class CostRequest(BaseModel):
     """원가계산 입력 — 금액은 원 단위."""
 
@@ -176,7 +189,7 @@ async def compute_cost(project_id: UUID, payload: CostRequest) -> JSONResponse:
         body["suggested_profit_adjustment_krw"] = str(
             proposed_profit_adjustment(result, payload.target_contract_amount_krw)
         )
-    return JSONResponse(content={"status": "success", **body})
+    return JSONResponse(content=_with_provenance({"status": "success", **body}))
 
 
 @router.get("/{project_id}/estimation/items")
@@ -203,11 +216,13 @@ async def list_unit_price_titles(project_id: UUID) -> JSONResponse:
     try:
         build = await _build_for(project_id)
         return JSONResponse(
-            content={
-                "status": "success",
-                "summary": build_summary(build),
-                "rows": list_unit_prices(build),
-            }
+            content=_with_provenance(
+                {
+                    "status": "success",
+                    "summary": build_summary(build),
+                    "rows": list_unit_prices(build),
+                }
+            )
         )
     except Exception:
         logger.exception("B09 일위대가 목록 실패: project_id=%s", project_id)
@@ -274,7 +289,9 @@ async def get_base_data_lists(project_id: UUID) -> JSONResponse:
 
     try:
         return JSONResponse(
-            content={"status": "success", **all_lists(await _build_for(project_id))}
+            content=_with_provenance(
+                {"status": "success", **all_lists(await _build_for(project_id))}
+            )
         )
     except Exception:
         logger.exception("B09 기초자료 목록 실패: project_id=%s", project_id)
@@ -303,13 +320,15 @@ async def get_price_sources(project_id: UUID) -> JSONResponse:
         root = await _project_root_of(project_id)
         settings = estimation_settings(root) if root else {}
         return JSONResponse(
-            content={
-                "status": "success",
-                "material_comparison": material_price_comparison(build),
-                "base_reference": base_reference_data(
-                    build, str(settings.get("fuel_region") or "") or None
-                ),
-            }
+            content=_with_provenance(
+                {
+                    "status": "success",
+                    "material_comparison": material_price_comparison(build),
+                    "base_reference": base_reference_data(
+                        build, str(settings.get("fuel_region") or "") or None
+                    ),
+                }
+            )
         )
     except Exception:
         logger.exception("B09 단가 원천 표 실패: project_id=%s", project_id)
@@ -332,7 +351,9 @@ async def get_basis_sheet(project_id: UUID) -> JSONResponse:
         build = await _build_for(project_id)
         root = await _project_root_of(project_id)
         settings = estimation_settings(root) if root else {}
-        return JSONResponse(content={"status": "success", **basis_sheet(build, settings)})
+        return JSONResponse(
+            content=_with_provenance({"status": "success", **basis_sheet(build, settings)})
+        )
     except Exception:
         logger.exception("B09 산출기초 실패: project_id=%s", project_id)
         return JSONResponse(
@@ -689,7 +710,9 @@ async def get_unit_price_detail(project_id: UUID, code: str) -> JSONResponse:
     """일위대가 **본표** — 「무엇으로 이루어졌나」. 줄마다 원천·파고들기 표시가 붙는다."""
     try:
         return JSONResponse(
-            content={"status": "success", **detail_of(await _build_for(project_id), code)}
+            content=_with_provenance(
+                {"status": "success", **detail_of(await _build_for(project_id), code)}
+            )
         )
     except PriceBookError as error:
         return JSONResponse(status_code=404, content={"status": "error", "message": str(error)})
@@ -759,14 +782,18 @@ async def get_bill(project_id: UUID) -> JSONResponse:
         )
 
     return JSONResponse(
-        content={
-            "status": "success",
-            "rows": [row.as_dict() for row in result.rows],
-            "excluded": [row.as_dict() for row in result.excluded],
-            "materials": [row.as_dict() for row in result.material_rows],
-            "summary": bill_summary(result),
-            "price_basis": result.price_basis.as_dict() if result.price_basis else {"entries": []},
-        }
+        content=_with_provenance(
+            {
+                "status": "success",
+                "rows": [row.as_dict() for row in result.rows],
+                "excluded": [row.as_dict() for row in result.excluded],
+                "materials": [row.as_dict() for row in result.material_rows],
+                "summary": bill_summary(result),
+                "price_basis": (
+                    result.price_basis.as_dict() if result.price_basis else {"entries": []}
+                ),
+            }
+        )
     )