[프로젝트] 반려동물 자랑 토이프로젝트 소개

📌 프로젝트 개요

“모여라 PAW PAW” 는 반려동물 자랑 커뮤니티입니다.

회원 가입 후 이용할 수 있으며, 반려동물의 사진과 프로필을 등록해 다른 사람과 공유할 수 있습니다.
좋아하는 단어, 싫어하는 단어, 한줄 소개 등을 통해 사용자와 반려동물 간의 교감을 표현합니다. 사용자는 등록된 반려동물 프로필을 보며 좋아요를 남길 수 있으며, 이를 기반으로 인기 랭킹이 구성됩니다.

반려동물 이미지 등록 시 AI를 통한 반려동물 판별 기능을 적용하여, 등록된 이미지가 실제 반려동물인지 사전에 검증할 수 있도록 했습니다.

 

Github Repo : https://github.com/HAN-SEOHYUN/wedlessInvite/issues

✅ 목표

• 아키텍처 분리, 예외 처리 등의 구조적인 설계
• 실전 부하 테스트 경험
• 공부중인 디자인 패턴 적용
• Docker, AWS 기술 학습 및 적용

 

🛠 사용 기술 스택

Spring Boot 서버와 Thymeleaf 템플릿 엔진으로 구성된 모놀리틱 아키텍처 기반의 웹 애플리케이션입니다.

Spring MVC 아키텍처를 기반으로 컨트롤러, 서비스, 레포지토리 계층을 명확하게 분리하고, Model-View-Controller 패턴에 따라 클라이언트 요청을 처리합니다. 

• Database: MySQL 8.0
• Infra: AWS EC2, S3, Docker
• Language: Java 23
• Framework: Spring Boot
• ORM: JPA (Hibernate)
• Database: MySQL
• Template Engine: Thymeleaf
• View Layer: HTML + CSS + JS
• AI Service: PyTorch + Flask (ResNet 기반 이미지 판별)
• 기타: Intellij, Github
• TEST : k6, Postman

K6 부하 테스트 아키텍쳐

 

 

🚀 주요 설계 포인트

1. 반려동물 이미지 판별 AI 기능

ImageController는 이미지를 MultipartFile로 받아서 Flask 기반 AI 서버로 전송하고, 해당 이미지가 강아지/고양이인지 판별합니다.
Flask 서버는 PyTorch의 ResNet-18 모델을 활용하며, 서버에서 분류 결과를 받아, 유효한 반려동물인지 체크 후 저장합니다.

 

2. 일관된 예외 처리 (Exception Handling)

반복적으로 사용되는 예외 상황을 간결하고 명확하게 처리하기 위해 CustomException과 ErrorCode를 설계했습니다.

@Getter
public class CustomException extends RuntimeException {
    private final ErrorCode errorCode;

    public CustomException(ErrorCode errorCode) {
        super(errorCode.getErrorMsg());
        this.errorCode = errorCode;
    }
}

 

아래와 같이 사용시점에 직관적이고 간단하게 예외처리를 할 수 있습니다. 

public void validateFileSize(MultipartFile file) {
        if (file.getSize() > MAX_FILE_SIZE) {
            throw new CustomException(EXCEED_MAX_FILE_SIZE);
        }
    }

 

 

3. DTO 기반 데이터 처리

모든 도메인에서 요청과 응답 데이터를 DTO(Data Transfer Object)로 분리해 처리했습니다.

또한 DTO 클래스는 Lombok의 @Builder 패턴을 적용해 불변성을 유지하면서도 가독성을 높였습니다.

예를 들어 이미지 목록 응답을 위한 DTO는 다음과 같이 구성됩니다:

@Getter
@Setter
public class ImageListResponseDto {
    private String orgFileName;
    private String s3Url;
    private Long fileSize;
    private LocalDateTime modTime;

    @Builder
    public ImageListResponseDto(String orgFileName, String s3Url, Long fileSize, LocalDateTime modTime) {
        this.orgFileName = orgFileName;
        this.s3Url = s3Url;
        this.fileSize = fileSize;
        this.modTime = modTime;
    }
}

 

 

4. Response<T>로 응답 일관성 확보

클라이언트와의 통신에서 일관된 응답 포맷을 유지하기 위해 AbstractResponse, SuccessResponse<T> 구조를 설계했습니다. 

응답은 다음과 같은 JSON 형태로 제공되며, 성공과 실패 여부에 관계없이 동일한 구조를 유지합니다. 

{
    "success": true,
    "statusCode": "OK",
    "message": "요청이 정상적으로 처리되었습니다.",
    "data": { ... }
}

 

공통 부모 클래스인 AbstractResponse는 성공 여부, 상태 코드, 메시지를 정의하고 있으며, 이를 상속하는 SuccessResponse<T>와 FailureResponse는 각각 성공과 실패에 따른 데이터를 포함합니다. SuccessResponse<T>는 제네릭 타입 T를 통해 다양한 형태의 데이터를 유연하게 담을 수 있도록 설계되어 있습니다. 

public class SuccessResponse<T> extends AbstractResponse {
    private final T data;

    public SuccessResponse(HttpStatus statusCode, String message, T data) {
        super(statusCode, message, true);  // success 값은 항상 true
        this.data = data;
    }

    public T getData() {
        return data;
    }
}

 

예를 들어, 좋아요 랭킹 데이터를 반환하는 API는 다음과 같이 작성됩니다.

@GetMapping("/rank")
public ResponseEntity<SuccessResponse<List<PetLikeRankingResponseDto>>> getPetLike() {
    List<PetLikeRankingResponseDto> dto = likeService.getTop3MostLikedInvitations();
    SuccessResponse<List<PetLikeRankingResponseDto>> successResponse = new SuccessResponse<>(
            HttpStatus.OK,
            LIKE_LIST_FETCH_SUCCESS_MESSAGE,
            dto
    );
    return ResponseEntity.status(HttpStatus.OK).body(successResponse);
}

 

5. 로그인 검사 인터셉터 (LoginCheckInterceptor)

비회원의 접근을 제한하기 위해 LoginCheckInterceptor를 구현했습니다. 인증이 필요한 요청에 대해 세션에 사용자 정보가 존재하지 않으면 로그인 페이지로 리다이렉트되며, 특정 공개 URI는 예외로 처리할 수 있도록 설계했습니다. 로그인 필터는 WebConfig 설정을 통해 컨트롤러 경로에 적용되며, 로그인 상태가 아닌 경우에는 자동으로 /login 경로로 이동시켜 사용자 인증을 유도합니다. 특정 API는 예외 경로로 등록할 수 있습니다. 

@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
    HttpSession session = request.getSession(false);
    if (session == null || session.getAttribute("userMaster") == null) {
        response.sendRedirect("/login");
        return false;
    }
    return true;
}

 

 

✅ 로그 추적 템플릿 (AbstractLogTraceTemplate)

각 요청별 실행 흐름을 추적하고, 예외 발생 시 원인을 정확히 파악할 수 있도록 하는 LogTrace 기능을 개발했습니다. 

공통적인 부가기능을 한 클래스에 모을 수 있도록 템플릿 메서드 패턴을 사용했습니다. 

자세한 내용은 링크에서 확인할 수 있습니다. 각 요청별 실행흐름에 대한 Log 는 아래와 같습니다. 

[71701732] OrderController.createInvitation()
[71701732] |-->InvitationService.saveInvitationMaster
[71701732] |<--InvitationService.saveInvitationMaster time=34ms
[71701732] OrderController.createInvitation() time=40ms

 

 

 

📚 진행하며 마주한 이슈나 학습 경험을 정리한 글들을 아래에 공유합니다

• 도커 이미지 아키텍쳐 오류
• 배포 전 부하테스트로 성능 병목 해결 - TPS 2배 향상
• 템플릿메서드 디자인 패턴을 활용한 LogTrace 개발
• EC2 서버 메모리 부족 이슈

 

📕 스토리보드