[web-33] 관리자 메인 로고 수정 API 구현

[Chunwol]

이전 PR(리뷰 참고): #14

작업 내용

관리자 페이지에서 메인 페이지 로고 이미지를 수정할 수 있는 API를 구현합니다.
파일 업로드는 클라이언트가 Presigned PUT URL로 MinIO에 직접 업로드하는 방식을 사용합니다.
서버는 파일을 받지 않고, 업로드 완료 후 전달받은 objectKey로 URL을 저장합니다.

변경 사항

• FileController 추가: GET /api/v1/files/upload-url — Presigned PUT URL 발급
• PresignedUploadResponseDto 추가: uploadUrl, objectKey 필드
• MinioConfig 추가: application.yml의 minio.* 프로퍼티 바인딩, MinioClient Bean 등록
• MinioService 추가: generateUploadUrl(), generateDownloadUrl(), getObjectUrl(), deleteFile(), extractObjectKey()
• PATCH /api/v1/admin/main/logo 엔드포인트 구현 (JSON body)
• MainPageConfig 엔티티 정리 (description, recruitmentStart/End 제거)
• MainLogoResponseDto, MainLogoUpdateRequestDto(objectKey) 추가
• MainPageConfigRepository 추가 (getConfig() — Singleton 엔티티 ID 고정 1)
• AdminMainController, AdminMainService 추가

파일 업로드 흐름

1. GET /api/v1/files/upload-url?type=logo
   → { uploadUrl, objectKey } 수령

2. PUT {uploadUrl}  ← 브라우저에서 MinIO로 직접 전송 (서버 경유 없음)
   Body: 파일 바이너리

3. PATCH /api/v1/admin/main/logo
   Body: { "objectKey": "logo/uuid" }
   → 서버가 objectKey로 URL 구성 후 DB 저장

API

1. Presigned 업로드 URL 발급

GET /api/v1/files/upload-url?type=logo

Response: 200 OK

{
  "success": true,
  "data": {
    "uploadUrl": "http://minio:9000/one-bucket/logo/uuid?X-Amz-Signature=...",
    "objectKey": "logo/550e8400-e29b-41d4-a716-446655440000"
  }
}

type 파라미터: logo → logo/uuid, project → projects/uuid 경로로 생성

2. 메인 로고 수정

PATCH /api/v1/admin/main/logo

Content-Type: application/json

Request Body:

{
  "objectKey": "logo/550e8400-e29b-41d4-a716-446655440000"
}

Response: 200 OK

{
  "success": true,
  "data": {
    "logoUrl": "http://minio:9000/one-bucket/logo/550e8400-e29b-41d4-a716-446655440000"
  }
}

프론트엔드 요청 예시 (JavaScript):

// 1. Presigned URL 발급
const { uploadUrl, objectKey } = await axios
  .get('/api/v1/files/upload-url?type=logo')
  .then(res => res.data.data);

// 2. MinIO에 직접 업로드 (서버 경유 없음)
await axios.put(uploadUrl, logoFile, {
  headers: { 'Content-Type': logoFile.type }
});

// 3. objectKey를 서버에 전달해 DB 저장
await axios.patch('/api/v1/admin/main/logo', { objectKey });

테스트

• GET /api/v1/files/upload-url?type=logo → 200 OK, uploadUrl + objectKey 반환
• PUT uploadUrl 로 파일 직접 업로드 → MinIO 저장 확인
• PATCH /api/v1/admin/main/logo → 200 OK, logoUrl 반환
• 기존 로고 있을 때 새 로고 저장 시 기존 파일 MinIO에서 삭제 확인