Place Course detail API 개발

[Zerohertz]

개요

코스 상세 정보를 조회하는 API 개발이 필요합니다. 사용자가 코스 상세 페이지에서 볼 수 있는 모든 정보를 포함해야 합니다.

필요한 기능

• 코스 기본 정보 조회 (이름, 설명, 썸네일)
• 코스에 포함된 장소 목록
• 코스 이미지 목록
• 코스 리뷰 및 평점
• 좋아요 및 북마크 상태
• 방문 날짜 설정/수정 기능

API 엔드포인트

• GET /api/courses/{courseId}: 코스 상세 정보 조회
• POST /api/courses/{courseId}/reviews: 코스 리뷰 작성
• PATCH /api/courses/{courseId}/visit-date: 코스 방문 날짜 설정

응답 형식

{
  "id": 1,
  "name": "코스 이름",
  "description": "코스 설명",
  "thumbnail": "이미지 URL",
  "category": {
    "id": 1,
    "name": "카테고리"
  },
  "likeCount": 10,
  "bookmarkCount": 5,
  "isLiked": true,
  "isBookmarked": false,
  "visitDate": "2023-05-11",
  "images": [
    {
      "id": 1,
      "imageUrl": "이미지 URL"
    }
  ],
  "places": [
    {
      "id": 1,
      "name": "장소 이름",
      "thumbnail": "이미지 URL",
      "category": {
        "id": 1,
        "name": "카테고리"
      },
      "address": "장소 주소",
      "latitude": "37.1234",
      "longitude": "127.1234",
      "sequenceOrder": 1
    }
  ],
  "reviews": [
    {
      "id": 1,
      "content": "리뷰 내용",
      "rating": 4.5,
      "username": "사용자",
      "createdAt": "2023-05-11T12:00:00"
    }
  ],
  "averageRating": 4.5
}

추가 고려 사항

• 인증된 사용자만 리뷰 작성 및 방문 날짜 설정 가능
• 코스 검색 및 필터링 기능을 위한 확장 고려
• 효율적인 데이터 로딩을 위한 쿼리 최적화

참고 이미지

첨부된 UI 디자인 이미지를 참고하여 필요한 데이터 구조 설계