feat(B03): 같은 파일 재업로드는 전송 생략, 다른 내용이면 덮어쓰기 (E2E 결함 2)

사용자 결정(2026-08-08): 복수 파일을 허용하고 중복 기준은 파일명으로 둔다. 같은 이름으로
같은 내용이 다시 들어오면 덮어쓰지 말고 건너뛰고, 내용이 다르면 덮어쓴다.

파일 지문(부분 샘플링)
- B03_FileInput_Fingerprint.ts: 파일 크기 + 앞·중간·끝 8MB를 이어 SHA-256. 24MB만 읽어
  1~2초면 끝난다. 전체 읽기(1.7GB, 10~30초)와 견줘 실용적이고, 자리를 앞·중간·끝으로
  흩어 놓아 머리말만 같은 파일도 갈린다. 한계는 주석에 적었다.
- 화면이 업로드 세션 생성 요청에 지문을 실어 보내고, 서버가 같은 이름의 최신 입력 파일
  메타데이터에 적힌 지문과 견준다. 같으면 already_uploaded=true로 답해 **전송 자체를**
  건너뛴다(1.7GB면 3~5분 절약). 지문이 없거나 다르면 그냥 올린다 — 애매하면 올리는 쪽.
- 완료 요청에도 지문을 실어 input_files.metadata에 남긴다. upload_sessions에 컬럼을
  더하지 않으려는 선택이라 DB 스키마 변경이 없다.

옛 행 정리
- supersede_previous_input_files(): 같은 이름의 이전 행을 SUPERSEDED로 내린다. 조회는
  UPLOADED/PROCESSED만 보므로 목록·분석에서 자동으로 빠지고, 행은 이력으로 남는다.
- 직접 업로드 완료와 보관함 연결 양쪽에 적용.

검증(실서버 f45243b3)
- 같은 파일 재요청 → already_uploaded=true, 세션 미발급.
- 지문이 다르면 → 세션 발급(정상 업로드 경로).
- 옛 행이 SUPERSEDED로 내려가는 것 DB에서 확인.
- 화면 코드(B03_FileInput_Fingerprint.ts)를 그대로 실행해 만든 지문과 서버측 검증
  스크립트의 지문이 20MB 표본에서 완전히 일치(f281fd08…93e4).
typecheck·ruff·prettier 통과, 정적 번들 재빌드.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-08-08 20:11:23 +09:00
co-authored by Claude Opus 5
parent b3d8371882
commit d935013ffa
7 changed files with 205 additions and 4 deletions
+50
View File
@@ -338,3 +338,53 @@ async def list_incomplete_upload_sessions(
)
rows = await cursor.fetchall()
return [dict(row) for row in rows]
async def find_input_file_by_name(
connection: aiomysql.Connection,
project_id: UUID,
original_filename: str,
) -> dict[str, Any] | None:
"""같은 이름으로 등록된 최신 입력 파일 1건. 없으면 None.
같은 파일을 다시 올렸는지 가리는 데 쓴다 — 중복 판정 기준은 파일명이고, 내용이 같은지는
이 행의 메타데이터에 적힌 지문으로 본다(2026-08-08 사용자 결정).
"""
async with connection.cursor(aiomysql.DictCursor) as cursor:
await cursor.execute(
"""
SELECT id, original_filename, file_size_mb, metadata
FROM input_files
WHERE project_id = %s AND original_filename = %s
AND status IN ('UPLOADED', 'PROCESSED')
ORDER BY id DESC
LIMIT 1
""",
(str(project_id), original_filename),
)
row = await cursor.fetchone()
return dict(row) if row else None
async def supersede_previous_input_files(
connection: aiomysql.Connection,
project_id: UUID,
original_filename: str,
keep_input_file_id: int,
) -> int:
"""같은 이름의 옛 행을 `SUPERSEDED`로 내린다. 내린 건수를 돌려준다.
조회 쿼리들이 `UPLOADED`/`PROCESSED`만 보므로, 이렇게만 해도 목록·분석에서 빠진다.
행을 지우지 않는 이유는 언제 무엇이 교체됐는지 추적할 근거를 남기기 위해서다.
"""
async with connection.cursor() as cursor:
await cursor.execute(
"""
UPDATE input_files
SET status = 'SUPERSEDED'
WHERE project_id = %s AND original_filename = %s AND id <> %s
AND status IN ('UPLOADED', 'PROCESSED')
""",
(str(project_id), original_filename, keep_input_file_id),
)
return cursor.rowcount