여행 위시리스트 도메인

데이터베이스 스키마

• 주요 테이블
  • member: 회원 정보 (회원 ID)
  • outing_wishlist_entry: 여행 위시리스트 요소 (순번 등)
  • outing_course: 여행 코스 (여행 코스 ID)
  • outing_guide: 장소/이벤트 정보 (단일 테이블 상속)

API 명세

목차

• 여행 위시리스트에 여행 코스 추가 API
• 여행 위시리스트에 추가한 장소 목록 조회 API
• 여행 위시리스트에 추가한 행사 목록 조회 API
• 여행 위시리스트에 추가한 여행 코스 목록 조회 API
• 여행 위시리스트에 추가한 장소 상세 조회 API
• 여행 위시리스트에 추가한 행사 상세 조회 API
• 여행 위시리스트에 추가한 여행 코스 상세 조회 API
• 여행 위시리스트에 추가한 장소 제거 API
• 여행 위시리스트에 추가한 행사 제거 API
• 여행 위시리스트에 추가한 여행 코스 제거 API

여행 위시리스트에 여행 코스 추가 API

목차로 돌아가기

• API 명세: POST /api/v2/member/outing-wishlist/outing-courses

• 권한

  • 로그인한 사용자 (유효하며 블랙리스트에 등재되지 않은 액세스 토큰 보유)

• 구현 상세

  • 요청

    • 본문 (@Valid @RequestBody)

      • outing_course_id: Long(@NotNull @Positive)

  • 처리 로직

    1. 요청 본문 유효성 검증, 실패 시 422 오류 반환

       • "INVALID_OUTING_COURSE_ID", "유효하지 않은 코스 ID입니다."

    2. 액세스 토큰에서 회원 id 추출

       • Long.valueOf(jwt.getSubject)

    3. 서비스 계층에 요청

       • member_id
       • ...Request

    4. outing_course_id를 통해 Repository에 해당 여행 코스의 존재 여부 확인

       • 여행 코스가 존재하는 지 확인, 존재하지 않을 시 404 오류 반환

         • "OUTING_COURSE_NOT_FOUND", "여행 코스를 찾을 수 없습니다."

         • .findById(outingCourseId).orElseThrow(() -> new OutingCourseNotFoundException())
           

         • 코스는 Soft Delete 정책이 적용되어 WHERE delete_datetime = null의 추가 조건 필요

    5. 여행 위시리스트 엔티티 생성 (member_id, type="place", outing_course_id, save_datetime)

       • (memberId, outingCourseId, Instant.now())

    6. Repository에 저장

       • 만약 저장 중 해당 코스가 기존에 저장된 코스와 중복인 경우 409 오류 반환

         • "OUTING_COURSE_DUPLICATE", "기존에 저장된 코스와 중복됩니다."

         • ...Repository.findByMemberIdAndOutingCourseId(memberId, outingCourseId)
               .ifPresent(() -> new OutingCourseDuplicateException());
           ...Repository.save(...);
           

  • 트랜잭션 관리

    • 엔티티 생성 및 Repository 저장은 원자적으로 처리되어야 함
    • (member_id, outing_course_id)에 UNIQUE 제약 조건이 필요할 듯?

여행 위시리스트에 추가한 장소 목록 조회 API

목차로 돌아가기

• API 명세: GET /api/v2/member/outing-wishlist/places

• 권한

  • 로그인한 사용자 (유효하며 블랙리스트에 등재되지 않은 액세스 토큰 보유)

• 구현 상세

  • 페이지의 size는 50으로 설정

  • 정렬 조건은 최근 저장 순 (desc), ID(desc)

  • 요청

    • 파라미터 (@RequestParam)

      • location: String(도, 광역/특별시의 영문명(ex: "incheon", "daegu", ...), @NotBlank, required = false)
      • cursor: String(조회할 페이지의 커서, @NotBlank, required = false(요청에 제공되지 않을 시 첫 페이지 조회))

  • 처리 로직

    1. 요청 파라미터가 유효성 검증, 실패 시 422 오류 반환

       • "INVALID_FILTER", "유효하지 않은 필터 조건입니다."
       • "INVALID_CURSOR", "유효하지 않은 커서입니다."

    2. 액세스 토큰에서 회원 id 추출

       • Long.valueOf(jwt.getSubject)
         

    3. 서비스 계층에 요청

       • memberId
       • location
       • cursor

    4. cursor가 가리키는 페이지의 존재 확인, 없을 시 404 오류 반환

       • "PAGE_NOT_FOUND", "페이지를 찾을 수 없습니다."

    5. 회원의 위시리스트 요소 테이블과 장소 테이블을 조인, location에 따라 한 번 더 필터링 진행한 결과 반환

       • 장소는 Soft Delete 정책이 적용되어 WHERE delete_datetime = null의 추가 조건 필요

    6. 검색 결과가 0건일 시, 빈 리스트 반환

여행 위시리스트에 추가한 행사 목록 조회 API

목차로 돌아가기

• API 명세: GET /api/v2/member/outing-wishlist/events

• 권한

  • 로그인한 사용자 (유효하며 블랙리스트에 등재되지 않은 액세스 토큰 보유)

• 구현 상세

  • 페이지의 size는 50으로 설정

  • 정렬 조건은 최근 저장 순 (desc), ID(desc)

  • 요청

    • 파라미터 (@RequestParam)

      • ongoing: Boolean(현재 운영 중인 행사만 조회할 지 여부, @NotBlank, required = false)
      • cursor: String(조회할 페이지의 커서, @NotBlank, required = false(요청에 제공되지 않을 시 첫 페이지 조회))

  • 처리 로직

    1. 요청 파라미터가 유효성 검증, 실패 시 422 오류 반환

       • "INVALID_FILTER", "유효하지 않은 필터 조건입니다."
       • "INVALID_CURSOR", "유효하지 않은 커서입니다."

    2. 액세스 토큰에서 회원 id 추출

       • Long.valueOf(jwt.getSubject)
         

    3. 서비스 계층에 요청

       • memberId
       • ongoing
       • cursor

    4. cursor가 가리키는 페이지의 존재 확인, 없을 시 404 오류 반환

       • "PAGE_NOT_FOUND", "페이지를 찾을 수 없습니다."

    5. 회원의 위시리스트 요소 테이블과 행사 테이블을 조인하고, ongoing = true시 현재 시간 < event.end_datetime로 필터링 진행한 결과 반환

       • 행사는 Soft Delete 정책이 적용되어 WHERE delete_datetime = null의 추가 조건 필요

    6. 검색 결과가 0건일 시, 빈 리스트 반환

여행 위시리스트에 추가한 여행 코스 목록 조회 API

목차로 돌아가기

• API 명세: GET /api/v2/member/outing-wishlist/outing-courses

• 권한

  • 로그인한 사용자 (유효하며 블랙리스트에 등재되지 않은 액세스 토큰 보유)

• 구현 상세

  • 페이지의 size는 50으로 설정

  • 정렬 조건은 최근 저장 순 (desc), ID(desc)

  • 요청

    • 파라미터 (@RequestParam)

      • location: String(도, 광역/특별시의 영문명(ex: "incheon", "daegu", ...), @NotBlank, required = false)
      • cursor: String(조회할 페이지의 커서, @NotBlank, required = false(요청에 제공되지 않을 시 첫 페이지 조회))

  • 처리 로직

    1. 요청 파라미터가 유효성 검증, 실패 시 422 오류 반환

       • "INVALID_FILTER", "유효하지 않은 필터 조건입니다."
       • "INVALID_CURSOR", "유효하지 않은 커서입니다."

    2. 액세스 토큰에서 회원 id 추출

       • Long.valueOf(jwt.getSubject)
         

    3. 서비스 계층에 요청

       • memberId
       • location
       • cursor

    4. cursor가 가리키는 페이지의 존재 확인, 없을 시 404 오류 반환

       • "PAGE_NOT_FOUND", "페이지를 찾을 수 없습니다."

    5. 회원의 위시리스트 요소 테이블과 여행 코스 테이블을 조인하고, location에 따라 한 번 더 필터링 진행한 결과 반환

       • 여행 코스는 Soft Delete 정책이 적용되어 WHERE delete_datetime = null의 추가 조건 필요

    6. 검색 결과가 0건일 시, 빈 리스트 반환

여행 위시리스트에 추가한 장소 상세 조회 API

목차로 돌아가기

• API 명세: GET /api/v2/member/outing-wishlist/places/{placeId}

• 요청

  • 경로 변수 (@PathVariable)

    • placeId: Long (@Positive)

• 권한

  • 로그인한 사용자

• 구현 상세

  • 처리 로직

    1. placeId의 유효성 검증, 실패 시 422 오류 반환

       • "INVALID_PLACE_ID", "유효하지 않은 장소 ID입니다."

    2. 서비스 계층에 요청

       • memberId
       • placeId

    3. placeId의 존재 여부 확인, 존재하지 않을 시 404 오류 반환

       • "PLACE_NOT_FOUND", "장소를 찾을 수 없습니다."

       • ...Repository.findById(placeId).orElseThrow(() -> new PlaceNotFoundException())
         

       • 장소는 Soft Delete 정책이 적용되어 WHERE delete_datetime = null의 추가 조건 필요

    4. Repository에서 placeId가 가리키는 장소 조회 후 반환

여행 위시리스트에 추가한 행사 상세 조회 API

목차로 돌아가기

• API 명세: GET /api/v2/member/outing-wishlist/events/{eventId}

• 요청

  • 경로 변수 (@PathVariable)

    • eventId: Long (@Positive)

• 권한

  • 로그인한 사용자

• 구현 상세

  • 처리 로직

    1. eventId의 유효성 검증, 실패 시 422 오류 반환

       • "INVALID_EVENT_ID", "유효하지 않은 행사 ID입니다."

    2. 서비스 계층에 요청

       • memberId
       • eventId

    3. eventId의 존재 여부 확인, 존재하지 않을 시 404 오류 반환

       • "EVENT_NOT_FOUND", "행사를 찾을 수 없습니다."

       • ...Repository.findById(eventId).orElseThrow(() -> new EventNotFoundException())
         

       • 행사는 Soft Delete 정책이 적용되어 WHERE delete_datetime = null의 추가 조건 필요

    4. Repository에서 eventId가 가리키는 행사 조회 후 반환

여행 위시리스트에 추가한 여행 코스 상세 조회 API

목차로 돌아가기

• API 명세: GET /api/v2/member/outing-wishlist/outing-courses/{outingCourseId}

• 권한

  • 로그인한 사용자

• 요청

  • 경로 변수 (@PathVariable)

    • outingCourseId: Long (@Positive)

• 구현 상세

  • 처리 로직

    1. outingCourseId의 유효성 검증, 실패 시 422 오류 반환

       • "INVALID_OUTING_COURSE_ID", "유효하지 않은 여행 코스 ID입니다."

    2. 서비스 계층에 요청

       • memberId
       • outingCourseId

    3. outingCourseId의 존재 여부 확인, 존재하지 않을 시 404 오류 반환

       • "OUTING_COURSE_NOT_FOUND", "여행 코스를 찾을 수 없습니다."

       • ...Repository.findById(outingCourseId).orElseThrow(() -> new OutingCourseNotFoundException)
         

       • 여행 코스는 Soft Delete 정책이 적용되어 WHERE delete_datetime = null의 추가 조건 필요

    4. Repository에서 outingCourseId가 가리키는 여행 코스 조회 후 반환

여행 위시리스트에서 장소 제거 API

목차로 돌아가기

• API 명세: DELETE /api/v2/member/outing-wishlist/places/{placeId}

• 요청

  • 경로 변수 (@PathVariable)

    • placeId: Long (@Positive)

• 권한

  • 로그인한 사용자

• 구현 상세

  • 처리 로직

    1. placeId의 유효성 검증, 실패 시 422 오류 반환

       • "INVALID_PLACE_ID", "유효하지 않은 장소 ID입니다."

    2. 서비스 계층에 요청

       • memberId
       • placeId

    3. placeId의 존재 여부 확인, 존재하지 않을 시 404 오류 반환

       • "PLACE_NOT_FOUND", "장소를 찾을 수 없습니다."

       • ...Repository.findById(placeId).orElseThrow(() -> new PlaceNotFoundException())
         

       • 장소는 Soft Delete 정책이 적용되어 WHERE delete_datetime = null의 추가 조건 필요

    4. Repository에서 placeId가 가리키는 장소 삭제

       • .delete()

• 트랜잭션 관리

  • Soft Delete 정책 (@Transactional 필요)

여행 위시리스트에서 행사 제거 API

목차로 돌아가기

• API 명세: DELETE /api/v2/member/outing-wishlist/events/{eventId}

• 요청

  • 경로 변수 (@PathVariable)

    • eventId: Long (@Positive)

• 권한

  • 로그인한 사용자

• 구현 상세

  • 처리 로직

    1. eventId의 유효성 검증, 실패 시 422 오류 반환

       • "INVALID_EVENT_ID", "유효하지 않은 행사 ID입니다."

    2. 서비스 계층에 요청

       • memberId
       • eventId

    3. eventId의 존재 여부 확인, 존재하지 않을 시 404 오류 반환

       • "EVENT_NOT_FOUND", "행사를 찾을 수 없습니다."

       • ...Repository.findById(eventId).orElseThrow(() -> new EventNotFoundException())
         

       • 행사는 Soft Delete 정책이 적용되어 WHERE delete_datetime = null의 추가 조건 필요

    4. Repository에서 eventId가 가리키는 행사 삭제

       • .delete()

• 트랜잭션 관리

  • Soft Delete 정책 (@Transactional 필요)

여행 위시리스트에서 여행 코스 제거 API

목차로 돌아가기

• API 명세: DELETE /api/v2/member/outing-wishlist/outing-courses/{outingCourseId}

• 요청

  • 경로 변수 (@PathVariable)

    • outingCourseId: Long (@Positive)

• 권한

  • 로그인한 사용자

• 구현 상세

  • 처리 로직

    1. outingCourseId의 유효성 검증, 실패 시 422 오류 반환

       • "INVALID_OUTING_COURSE_ID", "유효하지 않은 여행 코스 ID입니다."

    2. 서비스 계층에 요청

       • memberId
       • outingCourseId

    3. outingCourseId의 존재 여부 확인, 존재하지 않을 시 404 오류 반환

       • "OUTING_COURSE_NOT_FOUND", "여행 코스를 찾을 수 없습니다."

       • ...Repository.findById(outingCourseId).orElseThrow(() -> new OutingCourseNotFoundException())
         

       • 여행 코스는 Soft Delete 정책이 적용되어 WHERE delete_datetime = null의 추가 조건 필요

    4. Repository에서 outingCourseId가 가리키는 여행 코스 삭제

       • .delete()

• 트랜잭션 관리

  • Soft Delete 정책 (@Transactional 필요)