[1주차] 영화 서비스 초기 구성 및 상영 중인 영화 조회 API 개발

.gitignore

@@ -0,0 +1,9 @@
+# Spring Boot
+*.log
+*.class
+
+# Gradle
+.gradle/
+
+# IntelliJ IDEA
+.idea/

README.md

@@ -1,3 +1,51 @@
-## [본 과정] 이커머스 핵심 프로세스 구현
-[단기 스킬업 Redis 교육 과정](https://hh-skillup.oopy.io/) 을 통해 상품 조회 및 주문 과정을 구현하며 현업에서 발생하는 문제를 Redis의 핵심 기술을 통해 해결합니다.
-> Indexing, Caching을 통한 성능 개선 / 단계별 락 구현을 통한 동시성 이슈 해결 (낙관적/비관적 락, 분산락 등)
+# [본 과정] 이커머스 핵심 프로세스 구현
+
+## How to use
+
+```bash
+docker compose up -d
+```
+```bash
+curl -X GET http://localhost:8080/api/movies?showDate=2022-05-18
+curl -X GET http://localhost:8080/api/movies?showDate=2022-05-17
+```
+
+## Multi Module
+총 3개 모듈로 구성되있습니다.
+
+### 1. movie-api
+> 영화 도메인을 담당하고 Presentation Layer를 담당하는 모듈입니다.
+- GET /api/movies?showDate=2025-01-01
+
+```json
+// 응답 예시
+[
+  {
+    "id": 0,
+    "title": "나 홀로 집에",
+    "description": "...",
+    "rating": "전체관람가",
+    "genre": "코미디",
+    "thumbnail": "https://...",
+    "runningTime": 103,
+    "releaseDate": "1991-07-06",
+    "theaters": ["강남점", "안양점"],
+    "showtimes": ["08:00 ~ 09:45", "10:00 ~ 11:45"]
+  }
+]
+```
+### 2. core
+> 공통으로 사용하는 Entity, DTO를 담당하는 모듈입니다.
+### 3. infrastructure
+> DB 인터페이스를 담당하는 모듈입니다. 
+> MySQL, Redis 연결을 담당하고 데이터 입출력 로직을 포함합니다. 
+> DB가 변경되어도 api, core 모듈의 코드는 최소로 변경합니다.
+
+## Architecture
+> 다른 도메인 확장성을 고려한 설계입니다.
+> 모든 api 모듈에서는 Entity -> DTO로 변환하여 리턴합니다.
+
+![arc](readme/arc.png)
+
+## Table Design
+![erd_db](readme/erd.png)

core/.gitignore

@@ -0,0 +1,36 @@
+../.gradle
+build/
+!gradle/wrapper/gradle-wrapper.jar
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+### STS ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+bin/
+!**/src/main/**/bin/
+!**/src/test/**/bin/
+
+### IntelliJ IDEA ###
+.idea
+*.iws
+*.iml
+*.ipr
+out/
+!**/src/main/**/out/
+!**/src/test/**/out/
+
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+
+### VS Code ###
+.vscode/

core/build.gradle

@@ -0,0 +1,34 @@
+plugins {
+    id 'java'
+    id 'org.springframework.boot' version '3.3.2'
+    id 'io.spring.dependency-management' version '1.1.6'
+}
+
+group = 'com.example'
+version = '0.0.1-SNAPSHOT'
+
+java {
+    toolchain {
+        languageVersion = JavaLanguageVersion.of(21)
+    }
+}
+
+repositories {
+    mavenCentral()
+}
+
+dependencies {
+    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
+    implementation 'org.springframework.boot:spring-boot-starter-validation'
+    implementation 'com.fasterxml.jackson.core:jackson-annotations:2.17.2'
+
+    compileOnly 'org.projectlombok:lombok'
+    annotationProcessor 'org.projectlombok:lombok'
+
+    testImplementation 'org.springframework.boot:spring-boot-starter-test'
+    testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
+}
+
+tasks.named('test') {
+    useJUnitPlatform()
+}

core/src/main/java/com/example/app/common/BaseEntity.java

@@ -0,0 +1,25 @@
+package com.example.app.common;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.EntityListeners;
+import jakarta.persistence.MappedSuperclass;
+import lombok.Data;
+import org.springframework.data.annotation.CreatedDate;
+import org.springframework.data.annotation.LastModifiedDate;
+import org.springframework.data.jpa.domain.support.AuditingEntityListener;
+
+import java.time.LocalDateTime;
+
+@Data
+@MappedSuperclass
+@EntityListeners(AuditingEntityListener.class)
+public class BaseEntity {
+
+    @LastModifiedDate
+    @Column(insertable = false)
+    private LocalDateTime updatedAt;
+
+    @CreatedDate
+    @Column(updatable = false)
+    private LocalDateTime createdAt;
+}

core/src/main/java/com/example/app/common/ErrorMessage.java

@@ -0,0 +1,4 @@
+package com.example.app.common;
+
+public record ErrorMessage(String errorCode, String errorMessage) {
+}

core/src/main/java/com/example/app/movie/dto/MovieDto.java

@@ -0,0 +1,55 @@
+package com.example.app.movie.dto;
+
+import com.example.app.movie.entity.Movie;
+import com.example.app.movie.entity.Showtime;
+import com.example.app.movie.entity.Theater;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+
+import java.time.LocalDate;
+import java.util.Comparator;
+import java.util.List;
+
+@Builder
+@Getter
+@AllArgsConstructor
+public class MovieDto {
+
+    private Long id;
+    private String title;
+    private String description;
+    private String rating;
+    private String genre;
+    private String thumbnail;
+    private int runningTime;
+    private LocalDate releaseDate;
+    private List<String> theaters;
+    private List<String> showtimes;
+
+    public static MovieDto toDto(Movie movie) {
+        var showtimes = movie.getShowtimes()
+                .stream()
+                .sorted(Comparator.comparing(Showtime::getStart))
+                .map(showtime -> String.format("%s ~ %s", showtime.getStart(), showtime.getEnd()))
+                .toList();
+
+        var theaters = movie.getTheaters()
+                .stream()
+                .map(Theater::getName)
+                .toList();
+
+        return MovieDto.builder()
+                .id(movie.getId())
+                .title(movie.getTitle())
+                .description(movie.getDescription())
+                .rating(movie.getRating().getDescription())
+                .genre(movie.getGenre().getDescription())
+                .thumbnail(movie.getThumbnail())
+                .runningTime(movie.getRunningTime())
+                .releaseDate(movie.getReleaseDate())
+                .theaters(theaters)
+                .showtimes(showtimes)
+                .build();
+    }
+}

core/src/main/java/com/example/app/movie/dto/SearchMovies.java

@@ -0,0 +1,10 @@
+package com.example.app.movie.dto;
+
+import jakarta.validation.constraints.NotNull;
+import java.time.LocalDate;
+
+public record SearchMovies (
+        @NotNull(message = "상영 날짜는 필수에요")
+        LocalDate showDate
+){
+}

core/src/main/java/com/example/app/movie/entity/Movie.java

@@ -0,0 +1,64 @@
+package com.example.app.movie.entity;
+
+import com.example.app.common.BaseEntity;
+import com.example.app.movie.type.MovieGenre;
+import com.example.app.movie.type.MovieRating;
+import com.example.app.movie.type.MovieStatus;
+import jakarta.persistence.*;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+
+import java.time.LocalDate;
+import java.util.ArrayList;
+import java.util.List;
+
+@Entity
+@Table(name="tb_movie")
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+public class Movie extends BaseEntity {
+
+    @Id
+    @Column(name = "movie_id")
+    @GeneratedValue(strategy = GenerationType.AUTO)
+    private Long id;
+
+    private String title;
+
+    private String description;
+
+    @Enumerated(EnumType.STRING)
+    private MovieStatus status;
+
+    @Enumerated(EnumType.STRING)
+    private MovieRating rating;
+
+    @Enumerated(EnumType.STRING)
+    private MovieGenre genre;
+
+    private String thumbnail;
+
+    @Column(name = "running_time")
+    private int runningTime;
+
+    @Column(name = "release_date")
+    private LocalDate releaseDate;
+
+    @OneToMany
+    @JoinTable(
+            name = "tb_movie_showtime",
+            joinColumns = @JoinColumn(name = "movie_id"),
+            inverseJoinColumns = @JoinColumn(name = "showtime_id"))
+    private List<Showtime> showtimes = new ArrayList<>();
+
+    @ManyToMany
+    @JoinTable(
+        name = "tb_movie_theater_rel",
+        joinColumns = @JoinColumn(name = "movie_id"),
+        inverseJoinColumns = @JoinColumn(name = "theater_id"))
+    private List<Theater> theaters = new ArrayList<>();
+}

core/src/main/java/com/example/app/movie/entity/Showtime.java

@@ -0,0 +1,26 @@
+package com.example.app.movie.entity;
+
+import com.example.app.common.BaseEntity;
+import jakarta.persistence.*;
+import lombok.*;
+
+@Entity
+@Table(name="tb_movie_showtime")
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+public class Showtime extends BaseEntity {
+
+    @Id
+    @Column(name = "showtime_id")
+    @GeneratedValue(strategy = GenerationType.AUTO)
+    private Long id;
+
+    @Column(name = "movie_id")
+    private Long movieId;
+
+    private String start;
+
+    private String end;
+}

core/src/main/java/com/example/app/movie/entity/Theater.java

@@ -0,0 +1,30 @@
+package com.example.app.movie.entity;
+
+import com.example.app.common.BaseEntity;
+import jakarta.persistence.*;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+
+import java.util.ArrayList;
+import java.util.List;
+
+@Entity
+@Table(name="tb_theater")
+@Getter
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
+public class Theater extends BaseEntity {
+
+    @Id
+    @Column(name = "theater_id")
+    @GeneratedValue(strategy = GenerationType.AUTO)
+    private Long id;
+
+    private String name;
+
+    @ManyToMany(mappedBy = "theaters")
+    private List<Movie> movies = new ArrayList<>();
+}

core/src/main/java/com/example/app/movie/type/MovieGenre.java

@@ -0,0 +1,17 @@
+package com.example.app.movie.type;
+
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+@Getter
+@RequiredArgsConstructor
+public enum MovieGenre {
+    ACTION("액션"),
+    COMEDY("코미디"),
+    FAMILY("가족"),
+    ROMANCE("로맨스"),
+    HORROR("호러"),
+    SF("SF");
+
+    private final String description;
+}

core/src/main/java/com/example/app/movie/type/MovieRating.java

@@ -0,0 +1,16 @@
+package com.example.app.movie.type;
+
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+@Getter
+@RequiredArgsConstructor
+public enum MovieRating {
+    ALL_AGES("전체관람가"),
+    TWELVE_ABOVE("12세 이상 관람가"),
+    FIFTEEN_ABOVE("15세 이상 관람가"),
+    NO_MINORS("청소년 관람불가"),
+    RESTRICTED("제한상영가");
+
+    private final String description;
+}