feat(B04): 자동 전처리를 기본 조합만 만들고 나머지는 관리자 요청 시 만든다

지면 필터를 고쳐 지면점이 9~26배 늘자, 필터 전체 x 표현 전체를 미리 만드는
자동 전처리가 감당 못 할 만큼 길어졌다(용화 기준 15~20 모델). 산출물 대부분은
아무도 열어 보지 않는다.

- 자동 전처리는 기본 필터 1종 x SURFACE_AUTO_METHODS(dtm) 만 만든다. 스무딩
  유무 두 벌은 기존대로 같이 나온다.
- 기본 필터는 고정값이 아니라 입력 LAS를 보고 정한다 — 지면분류(class 2)가
  있으면 classification, 없으면 csf. csf는 분류 없는 LAS를 필터링하기 위한
  수단이므로 그때만 쓴다.
- 관리자가 B04 드롭다운을 바꾸면 그 조합이 이미 저장돼 있는지 보고, 없으면
  모달로 물은 뒤 그 조합만 계산해 영구 저장한다. 취소하면 드롭다운을 되돌린다.
  이미 있으면 묻지 않고 저장된 데이터를 그대로 쓴다.
- config_signature에서 source_filters·precompute를 뺀다. 이 둘은 "무엇을
  만들지"를 고르는 값이라 서명에 넣으면 조합을 바꿀 때마다 manifest가 통째로
  폐기돼 이전에 만들어 둔 조합이 사라진다.
- analyzeSurface가 API_ANALYSIS_TIMEOUT_MS를 쓴다 — 기본 30초로는 조합 하나를
  만드는 동안 abort 된다.

detect_extra_filters()는 resolve_auto_source_filters()로 대체했다. 필터를
말없이 덧붙이는 대신, 자동 경로의 기본값을 정하는 판정으로 쓴다.

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

B04_PreProcess/B04_PreProcess_Api_Fetch.ts

@@ -178,10 +178,12 @@ export async function analyzeSurface(
   projectId: string,
   request: SurfaceAnalyzeRequest,
 ): Promise<SurfaceAnalyzeResponse> {
-  return requestJson<SurfaceAnalyzeResponse>(`/projects/${projectId}/surface/analyze`, {
-    method: "POST",
-    body: JSON.stringify(request),
-  });
+  // 조합 하나를 새로 만드는 요청이라 기본 30초로는 못 끝난다.
+  return requestJson<SurfaceAnalyzeResponse>(
+    `/projects/${projectId}/surface/analyze`,
+    { method: "POST", body: JSON.stringify(request) },
+    API_ANALYSIS_TIMEOUT_MS,
+  );
 }
 
 /** 프로젝트의 지표면 모델 목록을 조회한다. */

B04_PreProcess/B04_PreProcess_Engine.py

@@ -15,7 +15,7 @@ import numpy as np
 
 from B04_PreProcess.B04_PreProcess_Engine_Ground import (
     build_ground_masks,
-    detect_extra_filters,
+    resolve_auto_source_filters,
     run_ground_filter,
     summarize_masks,
 )
@@ -106,15 +106,18 @@ def run_surface_analysis(
     project_root: Path,
     las_path: Path,
     *,
-    source_filters: list[str],
+    source_filters: list[str] | None,
     methods: list[str],
     force: bool = False,
     on_progress: ProgressCallback | None = None,
 ) -> dict[str, Any]:
     """구조화→필터→모델 빌드를 수행하고 산출 메타데이터를 반환한다.
 
+    `source_filters`가 비면 입력 LAS를 보고 기본 필터를 정한다(자동 전처리 경로).
+
     반환 dict:
       - processed: {processed_file_path, converted_file_path, point_count, bounds, statistics}
+      - source_filters: 실제로 계산한 필터 목록 (자동 판정 결과 포함)
       - ground_summary: 필터별 지면 포인트 요약
       - manifest: 지표면 모델 파이프라인 manifest
       - models: [{model_type, model_file_path, resolution_m, generation_params, layers}]
@@ -174,11 +177,10 @@ def run_surface_analysis(
 
         # 2. 지면 필터 실행 — mask_{filter}.npy 영구 캐시 우선 재사용 (PLAN A-1)
         _report(40, "ground_filter", "지면 필터 적용 중")
-        # LAS가 지면분류를 싣고 왔으면 필터 하나로 더 쓴다 — 미분류 LAS면 조용히 빠진다.
-        extra_filters = detect_extra_filters(data, source_filters)
-        if extra_filters:
-            source_filters = list(source_filters) + extra_filters
-            logger.info("B04 LAS 자체 지면분류 감지 — 필터 추가: %s", ", ".join(extra_filters))
+        # 자동 전처리는 목록을 넘기지 않는다 — 기본 필터는 입력 LAS를 보고 여기서 정한다.
+        if not source_filters:
+            source_filters = resolve_auto_source_filters(data)
+            logger.info("B04 자동 전처리 기본 필터: %s", ", ".join(source_filters))
         masks: dict[str, np.ndarray] = {}
         for filter_key in source_filters:
             mask_path = processed_dir / f"mask_{filter_key}.npy"
@@ -266,7 +268,7 @@ def run_surface_analysis(
 
     _report(95, "saving", "결과 저장 중")
 
-    return _collect_analysis_result(
+    result = _collect_analysis_result(
         project_root,
         models_dir,
         structured_path,
@@ -278,6 +280,9 @@ def run_surface_analysis(
         sheet_models,
         total_started,
     )
+    # 자동 경로는 필터를 넘기지 않으므로, 무엇으로 계산했는지 호출부에 돌려준다.
+    result["source_filters"] = list(source_filters)
+    return result
 
 
 def download_geodata(

B04_PreProcess/B04_PreProcess_Engine_Ground.py

@@ -17,6 +17,7 @@ from B04_PreProcess.B04_PreProcess_Engine_Filter_CSF import filter_csf
 from B04_PreProcess.B04_PreProcess_Engine_Filter_Grid import filter_grid_min_z
 from B04_PreProcess.B04_PreProcess_Engine_Filter_PMF import filter_pmf
 from B04_PreProcess.B04_PreProcess_Engine_Filter_RANSAC import filter_ransac
+from config.config_system import SURFACE_AUTO_FALLBACK_FILTER
 
 # 필터 키 → 함수 매핑
 _FILTERS = {
@@ -35,16 +36,24 @@ def available_filters() -> tuple[str, ...]:
     return tuple(_FILTERS.keys())
 
 
-def detect_extra_filters(
+def usable_conditional_filters(
     structured_data: dict[str, Any] | np.lib.npyio.NpzFile,
-    filter_keys: tuple[str, ...] | list[str],
 ) -> list[str]:
-    """이 LAS에서만 쓸 수 있는 조건부 필터 중 아직 목록에 없는 것을 고른다."""
-    return [
-        key
-        for key, is_usable in _CONDITIONAL_FILTERS.items()
-        if key not in filter_keys and is_usable(structured_data)
-    ]
+    """이 LAS에서 실제로 쓸 수 있는 조건부 필터를 고른다 (드롭다운 노출용)."""
+    return [key for key, is_usable in _CONDITIONAL_FILTERS.items() if is_usable(structured_data)]
+
+
+def resolve_auto_source_filters(
+    structured_data: dict[str, Any] | np.lib.npyio.NpzFile,
+) -> list[str]:
+    """자동 전처리가 만들 기본 필터를 입력 LAS를 보고 정한다.
+
+    업체가 이미 지면을 분류해 놨으면 그것을 쓴다 — 계산이 없고 품질도 가장 안정적이다.
+    csf는 분류가 없는 LAS의 지면을 추려내기 위한 수단이므로 그때만 쓴다
+    (2026-09-01 사용자 확정).
+    """
+    usable = usable_conditional_filters(structured_data)
+    return usable[:1] if usable else [SURFACE_AUTO_FALLBACK_FILTER]
 
 
 def run_ground_filter(

B04_PreProcess/B04_PreProcess_Engine_ModelContext.py

@@ -87,12 +87,20 @@ def evaluate_nurbs_spline(
     return np.clip(z_values, low, high)
 
 
+# 서명에서 빼는 키 — 지오메트리를 만드는 방법이 아니라 "무엇을 만들지"를 고르는 값들.
+# source_filters·precompute를 넣으면 조합을 바꿀 때마다 manifest가 통째로 폐기돼
+# 이전에 만들어 둔 조합이 사라진다. manifest는 이미 필터·방식별로 키가 갈린다.
+_SIGNATURE_EXCLUDED_KEYS = {"source_filters", "precompute"}
+
+
 def config_signature(config: dict[str, Any]) -> str:
-    """지오메트리 원본과 무관한 등고선·스무딩 설정을 제외한 캐시 서명."""
+    """지오메트리 생성 방법만 남긴 캐시 서명 (선택 목록·등고선·스무딩 제외)."""
     sig_config = {
         k: v
         for k, v in config.items()
-        if not k.startswith("contour_") and not k.startswith("smoothing_")
+        if not k.startswith("contour_")
+        and not k.startswith("smoothing_")
+        and k not in _SIGNATURE_EXCLUDED_KEYS
     }
     encoded = json.dumps(sig_config, sort_keys=True, default=list).encode("utf-8")
     return hashlib.sha256(encoded).hexdigest()[:16]

B04_PreProcess/B04_PreProcess_UI_Page.ts

@@ -4,6 +4,7 @@ import {
   createButton,
   createTag,
   hideLoadingOverlay,
+  showConfirmDialog,
   showLoadingOverlay,
   showToast,
 } from "@ui/ui_template_elements";
@@ -22,6 +23,7 @@ import {
   type WorkflowState,
 } from "../A00_Common/b_workflow_nav";
 import {
+  analyzeSurface,
   confirmSurfaceModel,
   fetchConfirmedSurface,
   fetchSurfacePointCloud,
@@ -38,7 +40,9 @@ import { createSurfaceTerrainViewer } from "./B04_PreProcess_UI_TerrainViewer";
 import { createSurfacePointCloudViewer } from "./B04_PreProcess_UI_Viewer";
 import "./B04_PreProcess_UI_Style.css";
 
-const SOURCE_FILTERS = ["grid_min_z", "csf", "pmf"] as const;
+// 고를 수 있는 필터. 자동 전처리는 이 중 기본 하나만 만들고, 나머지는 관리자가
+// 드롭다운에서 고를 때 그 조합만 계산한다 (2026-09-01 사용자 확정).
+const SOURCE_FILTERS = ["classification", "grid_min_z", "csf", "pmf"] as const;
 const MODEL_METHODS = ["tin", "dtm", "nurbs", "implicit", "meshfree"] as const;
 const DEFAULT_FILTER = "csf";
 const DEFAULT_METHOD = "dtm";
@@ -155,6 +159,9 @@ export async function renderB04Surface(root: HTMLElement): Promise<void> {
     MODEL_METHODS,
     DEFAULT_METHOD,
   );
+  // 되돌릴 값을 기억해 둔다 — 모달에서 취소하면 드롭다운을 원래 자리로 돌린다.
+  let appliedFilter = DEFAULT_FILTER;
+  let appliedMethod = DEFAULT_METHOD;
   const viewer = createSurfacePointCloudViewer();
   const terrainViewer = createSurfaceTerrainViewer();
   const mapViewer = createSurfaceMapViewer();
@@ -411,6 +418,57 @@ export async function renderB04Surface(root: HTMLElement): Promise<void> {
     );
   }
 
+  /** 고른 조합이 영구 저장돼 있으면 그대로 쓰고, 없으면 물어본 뒤 그 조합만 만든다. */
+  async function ensureCombinationBuilt(
+    previousFilter: string,
+    previousMethod: string,
+  ): Promise<boolean> {
+    const projectId = getProjectId();
+    const filter = filterGroup.select.value;
+    const method = methodGroup.select.value;
+    if (!projectId || findSelectedModel()) return true;
+    if (!selectedInputFile) {
+      showToast(L("B04_Surface_Load_Failed"), "error");
+      return false;
+    }
+
+    const message = L("B04_Surface_Build_Confirm")
+      .replace("{filter}", filter)
+      .replace("{method}", method);
+    if (!(await showConfirmDialog(message, L("B04_Surface_Build_Action")))) {
+      filterGroup.select.value = previousFilter;
+      methodGroup.select.value = previousMethod;
+      return false;
+    }
+
+    showLoadingOverlay();
+    showToast(L("B04_Surface_Build_Running"), "info");
+    try {
+      await analyzeSurface(projectId, {
+        input_file_id: selectedInputFile.id,
+        source_filters: [filter],
+        methods: [method],
+        force: false,
+      });
+      models = (await listSurfaceModels(projectId)).models;
+      showToast(
+        L("B04_Surface_Build_Done")
+          .replace("{filter}", filter)
+          .replace("{method}", method),
+        "success",
+      );
+      return true;
+    } catch (error) {
+      const detail = error instanceof Error ? error.message : "";
+      showToast(`${L("B04_Surface_Build_Failed")} ${detail}`, "error");
+      filterGroup.select.value = previousFilter;
+      methodGroup.select.value = previousMethod;
+      return false;
+    } finally {
+      hideLoadingOverlay();
+    }
+  }
+
   function updateSelectedModel(): void {
     const projectId = getProjectId();
     if (!projectId) return;
@@ -591,6 +649,9 @@ export async function renderB04Surface(root: HTMLElement): Promise<void> {
     } catch {
       showToast(L("B04_Surface_Load_Failed"), "error");
     } finally {
+      // 확정값이 드롭다운에 반영된 뒤이므로, 되돌릴 기준도 여기서 다시 맞춘다.
+      appliedFilter = filterGroup.select.value;
+      appliedMethod = methodGroup.select.value;
       hideLoadingOverlay();
     }
   }
@@ -601,10 +662,24 @@ export async function renderB04Surface(root: HTMLElement): Promise<void> {
     renderInputInfo();
   });
   filterGroup.select.addEventListener("change", () => {
-    updateSelectedModel();
-    void updatePointCloudForFilter();
+    void (async () => {
+      if (!(await ensureCombinationBuilt(appliedFilter, appliedMethod))) {
+        updateSelectedModel();
+        return;
+      }
+      appliedFilter = filterGroup.select.value;
+      updateSelectedModel();
+      await updatePointCloudForFilter();
+    })();
+  });
+  methodGroup.select.addEventListener("change", () => {
+    void (async () => {
+      if (await ensureCombinationBuilt(appliedFilter, appliedMethod)) {
+        appliedMethod = methodGroup.select.value;
+      }
+      updateSelectedModel();
+    })();
   });
-  methodGroup.select.addEventListener("change", updateSelectedModel);
 
   root.replaceChildren(layout.root);
   const projectId = getProjectId();