Pagination 로직 추가하기

[jhpa0308]

🤷‍♂️ Description

• API 호출시, 모든 질문, 루틴, 메모리카드 조회에 불러오는 item 갯수 제한을 거는 Pagination logic 구현.

❗️Requirements

주요 변경사항:

1. utils/pagination.js 파일 새로 생성

2. 각 controller에서 페이지네이션이 필요한 API 수정

• getAllQuestions
• getComments
• getMemoryCards
• getRoutines

4. Swagger 문서에 페이지네이션 관련 스키마와 파라미터 추가

모든 목록 조회 API에서 일관된 방식의 페이지네이션을 사용할 수 있도록 로직을 구현하였습니다.
각 API는 ?page=1&size=10 형식의 쿼리 파라미터를 통해 페이지네이션을 지원하며,
응답 형식도 통일되어 프론트엔드에서 쉽게 처리할 수 있습니다.

프론트엔드 구현 요구사항:
프론트엔드에서는 다음 기능들을 구현해야 합니다:

1. 페이지 번호 표시 UI

• 현재 페이지
• 이전/다음 페이지 버튼
• 총 페이지 수

2. API 호출 시 쿼리 파라미터 처리

3. 무한 스크롤 구현 (선택사항)

4. 로딩 상태 처리

[jhpa0308]

페이지네이션이 적용된 API 목록

• GET /qc/allquestions/{groupId} (전체 질문 목록)
• GET /qc/comments/{questionId} (질문 댓글 목록)
• GET /mc (메모리카드 목록)
• GET /routine (루틴 목록)

API 호출 방법

// 요청 시 쿼리 파라미터
{
  page: number;   // 페이지 번호 (기본값: 1)
  size: number;   // 페이지당 아이템 수 (기본값: 10)
}

// 예시 URL
/qc/allquestions/1?page=1&size=10

응답 데이터 형식

{
  status: boolean;
  message: string;
  data: {
    items: T[];           // 실제 데이터 배열
    totalItems: number;   // 전체 아이템 수
    currentPage: number;  // 현재 페이지
    totalPages: number;   // 전체 페이지 수
    hasNext: boolean;     // 다음 페이지 존재 여부
    hasPrevious: boolean; // 이전 페이지 존재 여부
    itemsPerPage: number; // 페이지당 아이템 수
  }
}