[feat] CH9. API & Paging

[millkk04]

🚀 조회 API 3종 구현 완료

📋 이슈 개요

회원 리뷰, 가게 미션, 회원 미션 조회를 위한 REST API 3종을 구현하였습니다.

---

✅ 구현 완료 API 목록

1️⃣ 내가 작성한 리뷰 목록 조회 API

• API Path: GET /api/members/{memberId}/reviews
• 기능: 특정 회원이 작성한 리뷰 목록을 페이징하여 조회
• 쿼리 파라미터:
  • page (기본값: 0) - 페이지 번호
  • size (기본값: 10) - 페이지 크기
• 응답 코드: REVIEW200_4

2️⃣ 특정 가게의 미션 목록 조회 API

• API Path: GET /api/stores/{storeId}/missions
• 기능: 특정 가게의 미션 목록을 페이징하여 조회
• 쿼리 파라미터:
  • page (기본값: 0) - 페이지 번호
  • size (기본값: 10) - 페이지 크기
• 응답 코드: MISSION200_7

3️⃣ 내가 진행 중인 미션 목록 조회 API

• API Path: GET /api/members/{memberId}/missions
• 기능: 특정 회원이 진행 중인 미션 목록을 페이징하여 조회
• 쿼리 파라미터:
  • page (기본값: 0) - 페이지 번호
  • size (기본값: 10) - 페이지 크기
• 응답 코드: MISSION200_8

---

🔧 구현 세부사항

API 1: 내가 작성한 리뷰 목록 조회

생성/수정된 파일

• ✅ ReviewController.java - GET 엔드포인트 추가
• ✅ ReviewQueryService.java - 인터페이스 메서드 추가
• ✅ ReviewQueryServiceImpl.java - 조회 로직 구현
• ✅ ReviewResDTO.java - MyReviewPageDTO, MyReviewDTO 추가
• ✅ ReviewConverter.java - DTO 변환 메서드 추가
• ✅ ReviewRepository.java - findByMemberId() 메서드 추가
• ✅ ReviewSuccessCode.java - MY_REVIEW_LIST_RETRIEVED 코드 추가

주요 기능

• 회원 ID로 작성한 리뷰 조회
• 최신순 정렬 (createdAt DESC)
• 페이징 처리 지원
• 가게 정보 포함 (Join Fetch 최적화 가능)

응답 예시

{
  "isSuccess": true,
  "code": "REVIEW200_4",
  "message": "내가 작성한 리뷰 목록 조회에 성공했습니다.",
  "result": {
    "currentPage": 0,
    "totalPages": 3,
    "totalElements": 25,
    "pageSize": 10,
    "hasNext": true,
    "hasPrevious": false,
    "reviews": [
      {
        "reviewId": 15,
        "storeId": 5,
        "storeName": "맛있는 떡볶이",
        "star": 5,
        "content": "정말 맛있어요!",
        "createdAt": "2025-11-20T14:30:00"
      }
    ]
  }
}

---

API 2: 특정 가게의 미션 목록 조회

생성/수정된 파일

• ✅ MissionController.java - GET 엔드포인트 추가
• ✅ MissionQueryService.java - 인터페이스 메서드 추가
• ✅ MissionQueryServiceImpl.java - 조회 로직 구현
• ✅ MissionResDTO.java - MissionPageDTO, MissionDTO 추가
• ✅ MissionConverter.java - DTO 변환 메서드 추가
• ✅ MissionRepository.java - findByStoreId() 메서드 추가
• ✅ MissionSuccessCode.java - MISSION_LIST_RETRIEVED 코드 추가

주요 기능

• 가게 ID로 미션 목록 조회
• 가게 존재 여부 검증
• 최신순 정렬 (createdAt DESC)
• 페이징 처리 지원
• 참여 인원 수 표시

응답 예시

{
  "isSuccess": true,
  "code": "MISSION200_7",
  "message": "특정 가게의 미션 목록 조회에 성공했습니다.",
  "result": {
    "currentPage": 0,
    "totalPages": 1,
    "totalElements": 8,
    "pageSize": 10,
    "hasNext": false,
    "hasPrevious": false,
    "missions": [
      {
        "missionId": 3,
        "conditional": "떡볶이 3회 구매",
        "point": 1000,
        "deadline": "2025-12-31",
        "createdAt": "2025-11-15T10:00:00",
        "participantCount": 12
      }
    ]
  }
}

---

API 3: 내가 진행 중인 미션 목록 조회

생성/수정된 파일

• ✅ MemberMissionRepository.java - 신규 생성 (member 패키지)
• ✅ MissionController.java - GET 엔드포인트 추가
• ✅ MissionQueryService.java - 인터페이스 메서드 추가
• ✅ MissionQueryServiceImpl.java - 조회 로직 구현
• ✅ MissionResDTO.java - MyMissionPageDTO, MyMissionDTO 추가
• ✅ MissionConverter.java - DTO 변환 메서드 추가
• ✅ MissionSuccessCode.java - MY_MISSION_LIST_RETRIEVED 코드 추가
• ✅ MissionCommandServiceImpl.java - import 수정

주요 기능

• 회원 ID로 진행 중인 미션 조회
• 회원 존재 여부 검증
• 최신순 정렬 (createdAt DESC)
• 페이징 처리 지원
• 미션 완료 여부 표시
• 가게 정보 포함

Repository 추가 메서드

// MemberMissionRepository
Page<MemberMission> findByMemberId(Long memberId, Pageable pageable);
boolean existsByMemberIdAndMissionId(Long memberId, Long missionId);
Page<MemberMission> findInProgress(@Param("memberId") Long memberId, Pageable pageable);
Page<MemberMission> findCompleted(@Param("memberId") Long memberId, Pageable pageable);

응답 예시

{
  "isSuccess": true,
  "code": "MISSION200_8",
  "message": "내가 진행 중인 미션 목록 조회에 성공했습니다.",
  "result": {
    "currentPage": 0,
    "totalPages": 2,
    "totalElements": 15,
    "pageSize": 10,
    "hasNext": true,
    "hasPrevious": false,
    "missions": [
      {
        "memberMissionId": 1,
        "missionId": 5,
        "storeName": "맛있는 떡볶이",
        "conditional": "떡볶이 3회 구매",
        "point": 1000,
        "deadline": "2025-12-31",
        "isComplete": false,
        "startedAt": "2025-11-20T10:30:00"
      }
    ]
  }
}

---

🏗️ 공통 아키텍처 패턴

모든 조회 API는 동일한 레이어드 아키텍처를 따릅니다:

Controller → QueryService → Repository → Entity
    ↓            ↓              ↓           ↓
 요청 수신    비즈니스 로직    데이터 조회   DB 매핑
    ↓            ↓
Converter ← DTO 변환
    ↓
 Response 반환

계층별 역할

1. Controller Layer

   • HTTP 요청 수신 및 경로 매핑
   • 쿼리 파라미터 처리 (page, size)
   • 응답 포맷 통일 (ApiResponse)

2. Service Layer

   • 비즈니스 로직 실행
   • 엔티티 존재 여부 검증
   • 페이징 설정 (Pageable 생성)

3. Repository Layer

   • JPA 메서드 쿼리 또는 JPQL 사용
   • 페이징 지원 (Page<T> 반환)

4. Converter Layer

   • Entity → DTO 변환
   • Page 객체 메타데이터 추출

5. DTO Layer

   • 응답 데이터 구조화
   • 페이징 정보 포함

---

🎯 공통 기능

페이징 처리

• Spring Data JPA의 Pageable 활용
• 기본값: page=0, size=10
• 정렬: 최신순 (createdAt DESC)

에러 처리

• 존재하지 않는 회원: MemberException
• 존재하지 않는 가게: StoreException
• 통일된 에러 응답 포맷

응답 구조

모든 API는 다음 정보를 포함:

• currentPage: 현재 페이지 번호
• totalPages: 전체 페이지 수
• totalElements: 전체 항목 수
• pageSize: 페이지 크기
• hasNext: 다음 페이지 존재 여부
• hasPrevious: 이전 페이지 존재 여부
• [data]: 실제 데이터 리스트

---

🐛 해결한 이슈

MemberMissionRepository 중복 문제

• 문제: MemberMissionRepository가 member, mission 패키지에 중복 생성
• 원인: Bean 이름 충돌 발생
• 해결:
  1. mission 패키지의 Repository 삭제
  2. member 패키지로 통합
  3. 모든 메서드 병합
  4. import 문 수정

---

📝 테스트 방법

1. 내가 작성한 리뷰 목록 조회

GET http://localhost:8080/api/members/1/reviews?page=0&size=10

2. 특정 가게의 미션 목록 조회

GET http://localhost:8080/api/stores/1/missions?page=0&size=10

3. 내가 진행 중인 미션 목록 조회

GET http://localhost:8080/api/members/1/missions?page=0&size=10