[FEATURE] 이미지 업로드 (프로필, 공통) (#367)

* refactor(user): 오타 수정

* feat(image): 이미지 업로드 전용 컨트롤러 추가

* feat(image): 이미지 업로드 전용 컨트롤러 추가

* Revert "test(notification): 쿼리 서비스 의존성 주입"

This reverts commit 2242452.

* Revert "test(notification): 알림 쿼리 서비스 세분화"

This reverts commit e356b93.

* Revert "test(notification): 변경 로직에 따라서 테스트 수정"

This reverts commit d8c7421.

* Revert "feat(notification): 복수형 정적 팩토리 메서드"

This reverts commit 6dfe3fe.

* Revert "feat(notification): repository 계층에서 read, unread 구분하지 않기"

This reverts commit 5fe6c1f.

* Revert "refactor: userId 어노테이션 수정"

This reverts commit 42ce01d.

* feat(user): 기본 정보 수정 목록의 이미지를 분리

* feat(presignedUrl): 사전 서명 URL 전용 레코드 추가

* refactor(auth): 패키지 이동

* feat(user): 유저 기본 정보 업데이트에서 이미지 분리

* refactor(img): 주석 삭제

* feat: 이미지 업로드 예외 오버로딩

* feat: PresignedUrl 클래스에 맞게 기존 로직 수정

* feat(img): 유저 프로필 이미지 수정을 하나의 엔드포인트로 변경

* refactor(user): 메서드 명 변경

* test(img): 로직 변경에 따른 테스트 코드 수정

* fix: 리베이스 오류 해결

* fix: 리베이스 오류 해결

* fix: 리베이스 오류 해결

* fix: 리베이스 오류 해결

* test(presignedUrl): 테스트 추가

* refactor: 리뷰 반영

Author: m-a-king

src/main/java/com/somemore/center/controller/CenterCommandApiController.java

@@ -4,8 +4,8 @@
 import com.somemore.global.auth.oauth.domain.CommonOAuthInfo;
 import com.somemore.global.auth.oauth.registrar.OAuthInfoRegistrar;
 import com.somemore.user.domain.User;
+import com.somemore.user.domain.UserAuthInfo;
 import com.somemore.user.domain.UserRole;
-import com.somemore.user.dto.UserAuthInfo;
 import com.somemore.user.service.RegisterUserService;
 import com.somemore.volunteer.usecase.NEWRegisterVolunteerUseCase;
 import lombok.RequiredArgsConstructor;

src/main/java/com/somemore/center/service/UpdateCenterProfileImgService.java

@@ -5,4 +5,8 @@ public class ImageUploadException extends RuntimeException {
     public ImageUploadException(String message) {
         super(message);
     }
+
+    public ImageUploadException(ExceptionMessage message) {
+        super(message.getMessage());
+    }
 }

src/main/java/com/somemore/center/usecase/UpdateCenterProfileImgUseCase.java

@@ -0,0 +1,36 @@
+package com.somemore.global.imageupload.controller;
+
+import com.somemore.global.auth.annotation.UserId;
+import com.somemore.global.common.response.ApiResponse;
+import com.somemore.global.imageupload.usecase.ImageUploadUseCase;
+import com.somemore.user.dto.request.ImgUrlRequestDto;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import org.springframework.security.access.annotation.Secured;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.UUID;
+
+@Tag(name = "Presigned URL Query API", description = "이미지 업로드 URL 조회 API")
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/api/image")
+public class GetPresignedUrlController {
+
+    private final ImageUploadUseCase imageUploadUseCase;
+
+    @Secured("ROLE_VOLUNTEER, ROLE_CENTER")
+    @PostMapping("/upload")
+    @Operation(summary = "이미지 업로드 URL 조회", description = "이미지 업로드 URL을 조회합니다.")
+    public ApiResponse<String> getImageUploadUrl(
+            @UserId UUID userId,
+            @RequestBody ImgUrlRequestDto dto
+    ) {
+        return ApiResponse.ok(imageUploadUseCase.getPresignedUrl(dto.fileName()).value(),
+                "이미지 업로드 URL 발급 성공");
+    }
+}

src/main/java/com/somemore/domains/center/controller/CenterProfileCommandApiController.java

@@ -42,8 +42,8 @@ public class ImageUploadService implements ImageUploadUseCase {
 
 
     @Override
-    public String getPresignedUrl(String filename) {
-        if(imageUploadValidator.isEmptyFileName(filename)) {
+    public PresignedUrl getPresignedUrl(String filename) {
+        if (imageUploadValidator.isEmptyFileName(filename)) {
             return null;
         }
 
@@ -56,9 +56,10 @@ public String getPresignedUrl(String filename) {
                         .key(uniqueFilename))
                 .build();
 
-        return s3Presigner.presignGetObject(getObjectPresignRequest)
-                .url()
-                .toString();
+        return PresignedUrl.from(
+                s3Presigner.presignGetObject(getObjectPresignRequest)
+                        .url()
+                        .toString());
     }
 
     @Override

src/main/java/com/somemore/global/auth/sign/up/SignUpService.java

@@ -0,0 +1,28 @@
+package com.somemore.global.imageupload.service;
+
+import com.somemore.global.exception.ImageUploadException;
+import lombok.extern.slf4j.Slf4j;
+
+import static com.somemore.global.exception.ExceptionMessage.UPLOAD_FAILED;
+
+@Slf4j
+public record PresignedUrl(
+        String value
+) {
+    public String removeQueryString() {
+        int queryIndex = value.indexOf('?');
+        if (queryIndex == -1) {
+            log.error("PresignedUrl({})에 쿼리스트링이 없어서 업로드 할 수 없습니다", value);
+            throw new ImageUploadException(UPLOAD_FAILED);
+        }
+        return value.substring(0, queryIndex);
+    }
+
+    public static PresignedUrl from(String url) {
+        if (url != null && url.contains("?")) {
+            return new PresignedUrl(url);
+        }
+        log.error("PresignedUrl({})이 올바르지 않은 형식입니다.", url);
+        throw new ImageUploadException(UPLOAD_FAILED);
+    }
+}

src/main/java/com/somemore/global/exception/ImageUploadException.java

@@ -1,8 +1,10 @@
 package com.somemore.global.imageupload.usecase;
 
 import com.somemore.global.imageupload.dto.ImageUploadRequestDto;
+import com.somemore.global.imageupload.service.PresignedUrl;
 
 public interface ImageUploadUseCase {
     String uploadImage(ImageUploadRequestDto requestDto);
-    String getPresignedUrl(String filename);
+
+    PresignedUrl getPresignedUrl(String filename);
 }