🔨 Refactor: 이미지 파일 도메인 처리 구조 개선

src/main/java/com/dodo/backend/common/exception/GlobalExceptionHandler.java

@@ -5,6 +5,7 @@
 import com.dodo.backend.board.exception.BoardException;
 import com.dodo.backend.fence.exception.FenceException;
 import com.dodo.backend.healthanalysis.exception.HealthAnalysisException;
+import com.dodo.backend.imagefile.exception.ImageFileException;
 import com.dodo.backend.pet.exception.PetException;
 import com.dodo.backend.petweight.exception.PetWeightException;
 import com.dodo.backend.reaction.exception.ReactionException;
@@ -125,6 +126,15 @@ protected ResponseEntity<ErrorResponse> handleReactionException(ReactionExceptio
         return toResponseEntity(e.getErrorCode());
     }
 
+    /**
+     * 이미지 파일(ImageFile) 도메인 비즈니스 로직에서 발생하는 {@link ImageFileException}을 처리합니다.
+     */
+    @ExceptionHandler(ImageFileException.class)
+    protected ResponseEntity<ErrorResponse> handleImageFileException(ImageFileException e) {
+        log.error("ImageFileException occurred: {}", e.getErrorCode());
+        return toResponseEntity(e.getErrorCode());
+    }
+
     /**
      * {@code @Valid} 어노테이션을 통한 요청 데이터 유효성 검증 실패 시 발생하는 예외를 처리합니다.
      */
@@ -164,4 +174,4 @@ protected ResponseEntity<ErrorResponse> handleException(Exception e) {
         log.error("Internal Server Error : {}", e.getMessage(), e);
         return toResponseEntity(INTERNAL_SERVER_ERROR);
     }
-}
+}

src/main/java/com/dodo/backend/imagefile/exception/ImageFileErrorCode.java

@@ -0,0 +1,48 @@
+package com.dodo.backend.imagefile.exception;
+
+import com.dodo.backend.common.exception.BaseErrorCode;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import org.springframework.http.HttpStatus;
+
+/**
+ * 이미지 파일(ImageFile) 도메인에서 발생하는 예외 상황을 관리하는 에러 코드 정의 클래스입니다.
+ * <p>
+ * 이미지 업로드, 프로필 이미지 저장 및 수정 과정에서 발생할 수 있는 예외를 포함하며,
+ * HTTP 상태 코드와 클라이언트에게 전달할 메시지를 {@code Key-Value} 형태로 관리합니다.
+ */
+@AllArgsConstructor
+@Getter
+public enum ImageFileErrorCode implements BaseErrorCode {
+
+    /**
+     * 클라이언트의 요청 형식이 잘못되었거나 이미지 파일 검증을 통과하지 못했을 때 사용합니다.
+     * <p>
+     * HTTP {@code 400 Bad Request}를 반환합니다.
+     */
+    INVALID_REQUEST(HttpStatus.BAD_REQUEST, "잘못된 요청입니다."),
+
+    /**
+     * 이미지 업로드 결과에서 유효한 이미지 URL을 확인할 수 없을 때 사용합니다.
+     * <p>
+     * HTTP {@code 500 Internal Server Error}를 반환합니다.
+     */
+    IMAGE_UPLOAD_FAILED(HttpStatus.INTERNAL_SERVER_ERROR, "이미지 업로드 중 오류가 발생했습니다."),
+
+    /**
+     * 서버 내부에서 예상치 못한 오류가 발생했을 때 사용합니다.
+     * <p>
+     * HTTP {@code 500 Internal Server Error}를 반환합니다.
+     */
+    INTERNAL_SERVER_ERROR(HttpStatus.INTERNAL_SERVER_ERROR, "서버 내부 오류가 발생했습니다.");
+
+    /**
+     * 에러 상황에 해당하는 HTTP 상태 코드입니다.
+     */
+    private final HttpStatus httpStatus;
+
+    /**
+     * 클라이언트에게 전달할 상세 에러 메시지입니다.
+     */
+    private final String message;
+}

src/main/java/com/dodo/backend/imagefile/exception/ImageFileException.java

@@ -0,0 +1,22 @@
+package com.dodo.backend.imagefile.exception;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * 이미지 파일(ImageFile) 도메인 비즈니스 로직 수행 중 발생하는 전용 예외 클래스입니다.
+ * <p>
+ * 이미지 업로드, 프로필 이미지 저장 및 수정 등 이미지 파일 관련 서비스 로직에서
+ * 예외 상황 발생 시 이 클래스를 throw 합니다.
+ * {@code GlobalExceptionHandler}에서 이 예외를 가로채어
+ * {@link ImageFileErrorCode}에 정의된 표준 응답으로 변환합니다.
+ */
+@AllArgsConstructor
+@Getter
+public class ImageFileException extends RuntimeException {
+
+    /**
+     * 발생한 예외의 구체적인 종류(상태 코드, 메시지)를 담고 있는 Enum입니다.
+     */
+    private final ImageFileErrorCode errorCode;
+}

src/main/java/com/dodo/backend/imagefile/mapper/ImageFileMapper.java

@@ -0,0 +1,22 @@
+package com.dodo.backend.imagefile.mapper;
+
+import org.apache.ibatis.annotations.Mapper;
+import org.apache.ibatis.annotations.Param;
+
+@Mapper
+public interface ImageFileMapper {
+
+    /**
+     * 펫 프로필 이미지 URL을 수정합니다.
+     *
+     * @param petId            수정할 펫 ID
+     * @param imageFileUrl     새로운 이미지 URL
+     * @param originalFilename 이미지 URL에서 추출한 파일명
+     * @return 수정된 행 수
+     */
+    int updatePetProfileImage(
+            @Param("petId") Long petId,
+            @Param("imageFileUrl") String imageFileUrl,
+            @Param("originalFilename") String originalFilename
+    );
+}

src/main/java/com/dodo/backend/imagefile/service/ImageFileService.java

@@ -1,6 +1,7 @@
 package com.dodo.backend.imagefile.service;
 
 import com.dodo.backend.imagefile.dto.response.ImageFileResponse.ImageUploadResponse;
+import com.dodo.backend.pet.entity.Pet;
 import org.springframework.web.multipart.MultipartFile;
 
 import java.util.List;
@@ -26,4 +27,21 @@ public interface ImageFileService {
      * @return 업로드 응답 DTO
      */
     ImageUploadResponse uploadImages(List<MultipartFile> files);
+
+    /**
+     * 펫 프로필 이미지 URL을 저장합니다.
+     *
+     * @param pet          이미지와 연결할 펫
+     * @param imageFileUrl 저장할 이미지 URL
+     */
+    void savePetProfileImage(Pet pet, String imageFileUrl);
+
+    /**
+     * 펫 프로필 이미지 URL을 수정합니다.
+     * 기존 이미지 정보가 없으면 새로 저장합니다.
+     *
+     * @param pet          이미지와 연결할 펫
+     * @param imageFileUrl 수정할 이미지 URL
+     */
+    void updatePetProfileImage(Pet pet, String imageFileUrl);
 }