파일 업로드 도메인 개발

[xeoxxn]

어떤 기능인가요?

파일(이미지/첨부파일)을 S3에 업로드하기 위한 파일 업로드 도메인을 추가한다. 클라이언트가 Presigned URL을 발급받아 S3에 직접 업로드하고, 서버는 파일 메타데이터만 관리한다.

📝 작업 상세 내용

• Presigned URL 발급 API - POST v1/files/presigned-url
• 파일 삭제 API - DELETE v1/files/{fileId}
• 파일 메타데이터(fileId, fileKey, fileType, 상태 등) 저장 테이블 설계 (Flyway)
• 파일 타입/확장자/크기 검증 및 에러 코드 정의 (INVALID_FILE_TYPE, UNSUPPORTED_FILE_EXTENSION, FILE_SIZE_EXCEEDED)
• S3 Presigned URL 발급용 클라이언트 연동 (infrastructure/client)

참고: PUT {uploadUrl} 파일 업로드 자체는 클라이언트가 발급받은 Presigned URL로 S3에 직접 업로드하는 구간이라 서버 API로 구현하지 않음.

📁 참고 자료 (선택)

• Presigned URL 발급 API 요청/응답 스펙 및 에러코드(VALIDATION_ERROR, INVALID_FILE_TYPE, UNSUPPORTED_FILE_EXTENSION, FILE_SIZE_EXCEEDED, UNAUTHORIZED) 대화로 전달됨
• 사용 뷰: 관리자 페이지 (준비 중)