perf(영구저장): 343-2 도엽 3D 면 열쇠 · 지표면 모델 id 유지 · 비용면 메모리 기억 · 추천 노선 열쇠 · 횡단 상세 ETag

- 도엽 3D 면 — 결과 옆 dtm_sheet_{방식}.key.json(등고선 이름:mtime:크기 · 노선 · CRS · 격자 · 여유 · 스무딩 · 화면 상자 · ALGO) 같으면 건너뜀
- 지표면 모델 — (방식 · 필터 · 파일) + 파일 지문 같으면 행 id 살려 고쳐 씀 · 이번 결과에 없는 옛 행만 지움
- 비용면 · 계류 메모리 기억(비용면 서명 · 계류 파일 지문 · 좌표계) · 추천 열쇠 = 서명(배열 통째 해시 없앰)
- 추천 저장본 종류(갈래 · 지형)당 최근 2벌 · 꺼내면 최근으로
- 횡단 상세 GET — 측점 파일 안 지움(valid_cross_names) · 본문 해시 ETag 304
- 시험 test_343_2_persist_keys 13건

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

B05_Profile/B05_Profile_Engine_RouteInitial_Store.py

@@ -1,7 +1,7 @@
 """계획노선 추천 결과 영구 저장(PLAN 327 · 요구 224-3).
 
 같은 입력이면 같은 결과 — 셈한 추천을 입력 지문 키로 프로젝트 폴더에 남기고, 같은 입력이 오면
-셈하지 않고 꺼낸다. 바뀐 입력만 새로 셈해 더한다(덮어쓰기 없음 · 상한 없음).
+셈하지 않고 꺼낸다. 바뀐 입력만 새로 셈해 더한다(덮어쓰기 없음 · 종류마다 최근 `KEEP_PER_KIND` 벌).
 
 층 = 서버 계산 캐시(데이터 3층 밖 · 사용자 편집값 아님 — 자동저장 금지와 무관). 자리
 `B05_Profile/route_recommend/<키>.json` — initial_snapshot 대상(`B05_Profile/route`) 밖이라
@@ -33,6 +33,8 @@ from common_util.common_util_json import atomic_write_json
 
 ALGO_VERSION = 2
 STORE_DIR = "B05_Profile/route_recommend"
+# 종류(갈래 · 지형) 마다 남길 벌 수 — 꺼낼 때 수정시각을 새로 해 최근에 쓴 것이 남음
+KEEP_PER_KIND = 2
 # 업로드 체인 끝에 미리 셈할 기본 다섯 알약(화면 차례) · 추적은 묶음이 선 뒤라 `similar` 가 채워짐
 DEFAULT_MODES = ("gradeline", "earthwork", "gentle", "weighted", "follow")
 
@@ -85,12 +87,17 @@ def is_default(
 
 def read_stored(project_root: Path, key: str) -> dict[str, Any] | None:
     """저장본 한 벌 — 없거나 못 읽거나 판이 다르면 None."""
+    path = store_dir(project_root) / f"{key}.json"
     try:
-        data = json.loads((store_dir(project_root) / f"{key}.json").read_text(encoding="utf-8"))
+        data = json.loads(path.read_text(encoding="utf-8"))
     except (OSError, ValueError):
         return None
     if not isinstance(data, dict) or data.get("version") != ALGO_VERSION:
         return None
+    try:
+        path.touch()  # 최근에 쓴 것 = 정리 때 남김
+    except OSError:
+        pass
     return data
 
 
@@ -118,9 +125,32 @@ def write_stored(
             "result": result,
         },
     )
+    prune_stored(project_root, request)
     return True
 
 
+def _kind(request: Any) -> tuple[Any, Any]:
+    request = request if isinstance(request, dict) else {}
+    return request.get("mode"), request.get("terrain")
+
+
+def prune_stored(project_root: Path, request: dict[str, Any]) -> int:
+    """같은 종류(갈래 · 지형) 저장본을 최근 `KEEP_PER_KIND` 벌만 남기고 지운다. 지운 수."""
+    kind = _kind(request)
+    same: list[tuple[int, Path]] = []
+    for path in store_dir(project_root).glob("*.json"):
+        try:
+            data = json.loads(path.read_text(encoding="utf-8"))
+            if _kind(data.get("request")) == kind:
+                same.append((path.stat().st_mtime_ns, path))
+        except (OSError, ValueError, AttributeError):
+            continue
+    same.sort(reverse=True)
+    for _, path in same[KEEP_PER_KIND:]:
+        path.unlink(missing_ok=True)
+    return max(0, len(same) - KEEP_PER_KIND)
+
+
 @asynccontextmanager
 async def pool_lock(pool: str) -> AsyncIterator[None]:
     # ponytail: 잠금은 지우지 않음 — 입력 묶음 수만큼(작음) · 다중 프로세스면 파일 잠금으로