3팀 요구사항 구현용 레포지토리

본 레포지토리는 3팀에게 전달받은 요구사항을 구현하는 것을 위한 레포지토리입니다. LMS와는 별개의 프로젝트로 진행될 예정입니다.

요구사항

1. 책, 영화 정보 삽입 / 업데이트

일정 주기마다 호출되어 영화/책에 대한 최신 정보를 업데이트하는 API 입니다.

• 최신 한국 영화와 책을 먼저 삽입.
• 이후 새롭게 개봉하거나 발간되는 영화와 책을 업데이트 (일주일에 한 번씩)
• 배우 테이블에 영화에 출연하는 배우 정보도 저장 (배우가 없으면 새롭게 추가)

2. 배우별 출연 영화 조회

• 특정 배우를 검색하면 배우가 출연한 영화들을 조회하는 API 입니다.
  • 페이징 형식의 조회로 구현할 것을 부탁드립니다!
• 배우별 영화까지 정리 (contents-actor 테이블 참고)

erd

---

API 문서

도서 정보 관리

최신 도서 로드

요청

• 엔드포인트: /api/book/first/data
• HTTP 메서드: POST
• 파라미터: 없음

응답

• HTTP 상태: 200
• 응답 바디:

  최신 도서 100권 로드 완료되었습니다.
  

효과

• OpenAPI에서 최신 도서 100권을 로드하여 DB에 저장합니다.

---

도서 업데이트

도서 업데이트 시작

요청

• 엔드포인트: /api/book/start
• HTTP 메서드: POST
• 파라미터: 없음

응답

• HTTP 상태: 200
• 응답 바디:

  도서 업데이트 작업이 매주 수요일마다 실행되도록 예약되었습니다.
  

효과

• 매주 수요일에 도서 업데이트 작업이 실행되도록 예약됩니다.

도서 업데이트 중지

요청

• 엔드포인트: /api/book/stop
• HTTP 메서드: POST
• 파라미터: 없음

응답

• HTTP 상태: 200
• 응답 바디:

  도서 업데이트 작업이 중지되었습니다.
  

효과

• 예약된 도서 업데이트 작업이 중지됩니다.

---

영화 정보 관리

최신 영화 로드

요청

• 엔드포인트: /api/movies/first/data
• HTTP 메서드: POST
• 파라미터: 없음

응답

• HTTP 상태: 200
• 응답 바디:

  success
  

효과

• OpenAPI에서 2025년 방영작을 로드하여 DB에 저장합니다.

---

영화 업데이트

영화 업데이트 시작

요청

• 엔드포인트: /api/movies/start
• HTTP 메서드: POST
• 파라미터: 없음

응답

• HTTP 상태: 200
• 응답 바디:

  "STARTED"
  

효과

• 영화 업데이트 작업이 시작됩니다.

영화 업데이트 중지

요청

• 엔드포인트: /api/movies/stop
• HTTP 메서드: POST
• 파라미터: 없음

응답

• HTTP 상태: 200
• 응답 바디:

  "STOPPED"
  

효과

• 영화 업데이트 작업이 중지됩니다.

---

배우별 출연 영화 조회

배우별 영화 검색

요청

• 엔드포인트: /api/movies/appearance

• HTTP 메서드: GET

• 쿼리 파라미터:

  • page: 현재 페이지 번호 (예: 0)
  • size: 페이지 당 데이터 수 (예: 10)
  • actor: 배우 이름 (예: 권상우)

  예시: /api/movies/appearance?page=0&size=10&actor=권상우

응답

• HTTP 상태: 200
• 응답 바디:

  {
    "pageable": {
      "page": 0,
      "size": 10,
      "totalPages": 1,
      "totalElements": 1,
      "end": true
    },
    "content": [
      {
        "contentId": 7,
        "category": "MOVIE",
        "title": "히트맨2",
        "writer": "최원섭"
      }
    ]
  }
  

---

참고 api

• 영화진흥위원회 오픈API

• KMDb - 한국영화데이터베이스

• OpenApi: 알라딘