feat(B03): 자료 교체 시 옛 산출물 정리 + 분석 중 업로드 차단 (E2E 결함 3·6 서버측)

사용자 결정(2026-08-08): 새 자료를 올리면 재계산해 덮어쓰고, 화면은 불러올 자료가 없으면
대시보드로 보낸다. 그러려면 자료가 갈리는 순간 옛 계산 결과가 남아 있으면 안 된다.

- common_util_project_reset 신설: 단계별 산출물 폴더(B04~B09)와 산출물 DB 레코드
  (surface_models·routes·route_points·route_statistics·longitudinal_sections·
  cross_sections·structures·quantity_items·outputs·processed_point_cloud)를 함께 지운다.
  **B03_FileInput(업로드 원본)은 지우지 않는다** — 같은 파일인지 가리는 중복 검사가 쓴다.
- 직접 업로드 완료·보관함 연결 양쪽에서 정리를 호출하고, 진행 단계도 1단계 이후를
  NOT_STARTED로 되돌린다(reset_stages_after_input_change).
- is_analysis_running(): 전처리가 도는 중이면 업로드 세션 생성과 보관함 연결을 409로
  막는다. 화면 버튼 잠금은 새로고침·다른 탭으로 우회되므로 서버에도 문을 단다.
- fail_stage 아래 있던 리비전(번호표) 안은 폐기 — 사용자가 "산출물이 없으면 대시보드"
  방식으로 정리했다.

곁들여: os.replace 공유 위반 재시도(replace_with_retry)
  진행률 파일은 서버가 쓰는 동안 화면이 계속 읽어 WinError 5가 났고, 전처리
  structured.npz 교체에서는 같은 이유로 분석이 통째로 죽었다(결함 3의 사망 원인).
  짧게 여러 번 다시 시도하도록 바꿨다.

검증(실서버 f45243b3, 계획노선 CSV 재업로드로 자료 교체):
  전처리 결과 112개 -> 재분석분만, 노선 2->0, 횡단 20->0,
  DB 지표면 15->0 / 노선 1->0 / 횡단 19->0, 업로드 원본 6개는 그대로.
  진행 단계가 초기로 돌아가고 재분석이 자동 시작됨.
  교체 재시도는 읽는 쪽이 파일을 잡고 있는 상황을 만들어 성공 확인.
ruff format·check 통과.

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

B03_FileInput/B03_FileInput_Router.py

@@ -53,11 +53,14 @@ from B03_FileInput.B03_FileInput_Schema import (
 from B03_FileInput.B03_FileInput_Service_WF1 import trigger_wf1_analysis_and_email
 from common_util.common_util_auth import verify_session
 from common_util.common_util_json import atomic_write_json
+from common_util.common_util_project_reset import purge_project_outputs
 from common_util.common_util_storage import resolve_stored_project_path
 from common_util.common_util_workflow import load_project_workflow
 from common_util.common_util_workflow_state import (
     complete_stage,
     get_workflow_state,
+    is_analysis_running,
+    reset_stages_after_input_change,
 )
 from config.config_db import get_db_pool
 from config.config_system import (
@@ -65,6 +68,8 @@ from config.config_system import (
     UPLOAD_MAX_FILES,
 )
 
+_ANALYSIS_RUNNING_MESSAGE = "이 프로젝트는 지금 분석 중입니다. 끝난 뒤에 새 자료를 올려 주세요."
+
 logger = logging.getLogger(__name__)
 router = APIRouter(prefix="/api/projects", tags=["B03 File Input"])
 
@@ -106,7 +111,14 @@ async def _complete_file_input_if_ready(
     _require_complete_file_set(file_types)
     if point_cloud_input_id is None:
         raise ValueError("LAS 또는 LAZ 입력 파일을 찾을 수 없습니다.")
-    async with connection.cursor() as cursor:
+    # 자료가 갈렸으니 옛 계산 결과(파일 + DB)를 지우고 진행 표시도 되돌린다. 남겨 두면
+    # 아직 다시 만들어지지 않은 뒷단계 화면이 옛 결과를 새 자료 것인 양 보여준다.
+    stored_path = await get_project_storage_relative_path(connection, project_id)
+    await purge_project_outputs(
+        connection, str(project_id), Path(resolve_stored_project_path(stored_path))
+    )
+    async with connection.cursor(aiomysql.DictCursor) as cursor:
+        await reset_stages_after_input_change(cursor, str(project_id))
         await complete_stage(cursor, str(project_id), 0)
     return point_cloud_input_id
 
@@ -381,6 +393,14 @@ async def create_project_upload_session(
     try:
         async with pool.acquire() as connection:
             await get_project_storage_relative_path(connection, project_id)
+            # 분석이 도는 중이면 새 자료를 받지 않는다 — 받아 봐야 분석 2개가 같은 산출물
+            # 경로에서 부딪힌다. 화면도 버튼을 잠그지만 새로고침으로 우회할 수 있어 여기서 막는다.
+            async with connection.cursor(aiomysql.DictCursor) as cursor:
+                if await is_analysis_running(cursor, str(project_id)):
+                    return JSONResponse(
+                        status_code=409,
+                        content={"status": "error", "message": _ANALYSIS_RUNNING_MESSAGE},
+                    )
             await create_upload_session(
                 connection,
                 session_id=session_id,