[1주차] 멀티모듈 구성 및 영화목록 조회 API 개발

.gitattributes

@@ -0,0 +1,3 @@
+/gradlew text eol=lf
+*.bat text eol=crlf
+*.jar binary

.gitignore

@@ -0,0 +1,37 @@
+HELP.md
+.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/

README.md

@@ -1,3 +1,60 @@
 ## [본 과정] 이커머스 핵심 프로세스 구현
 [단기 스킬업 Redis 교육 과정](https://hh-skillup.oopy.io/) 을 통해 상품 조회 및 주문 과정을 구현하며 현업에서 발생하는 문제를 Redis의 핵심 기술을 통해 해결합니다.
-> Indexing, Caching을 통한 성능 개선 / 단계별 락 구현을 통한 동시성 이슈 해결 (낙관적/비관적 락, 분산락 등)
+
+## 프로젝트 실행방법
+
+프로젝트를 받은 뒤
+> $ docker compose up -d 
+
+위 명령어를 실행하면 schema와 data가 자동으로 생성됩니다.
+
+그 후 api 모듈에 ApiApplication을 실행하면 프로젝트가 정상적을 작동합니다.
+
+## 멀티모듈 구성
+이 프로젝트는 **레이어드 아키텍처**를 기반으로 설계되었으며, 다음과 같이 3개의 모듈로 구성되어 있습니다.
+
+### **API 모듈**
+- **역할**  
+  사용자 및 외부 시스템과의 상호작용을 담당하며, HTTP 요청을 처리하고 응답을 반환하는 역할을 합니다.
+- **주요 책임**
+    - RESTful API 제공
+    - 요청 데이터 검증 및 변환
+    - Application 모듈에 의존하여 비즈니스 로직 호출
+- **의존성**
+    - `application` 모듈
+
+---
+
+### **Application 모듈**
+- **역할**  
+  비즈니스 로직을 구현하는 핵심 계층으로, 도메인 모델과 외부 인터페이스(API 모듈)를 연결합니다.
+- **주요 책임**
+    - 비즈니스 규칙 및 유스케이스 처리
+    - 트랜잭션 관리
+    - Domain 모듈과의 상호작용
+- **의존성**
+    - `domain` 모듈
+
+---
+
+### **Domain 모듈**
+- **역할**  
+  프로젝트의 핵심 엔티티와 데이터 접근 로직을 관리합니다.
+- **주요 책임**
+    - 도메인 엔티티 정의
+    - JPA 및 데이터베이스 접근
+    - 도메인 규칙을 보장하는 로직 포함
+- **의존성**
+    - 독립적이며 다른 모듈에 의존하지 않음
+
+---
+
+## 테이블 설계
+- **도메인**
+  ![](https://velog.velcdn.com/images/kimbro97/post/060397e0-2ff7-4997-93d7-5e7c9c5da022/image.png)
+- **테이블**
+  ![](https://velog.velcdn.com/images/kimbro97/post/f3028e77-5355-476c-86e6-98c9c01b1aca/image.png)
+
+Movie(영화)와 Theater(극장)은 M:N 관계이므로 MovieTheater로 일대다 다대일 관계로 설계하였습니다.
+Movie(영화)와 Screening(상영)은 1:N 관계이므로 일대다 관계로 설계하였습니다.
+Screening(상영)과 Seat(좌석)은 1:N 관계이므로 일대다 관계로 설계하였습니다.

api/build.gradle

@@ -0,0 +1,4 @@
+dependencies {
+    implementation project(':application')
+    implementation 'org.springframework.boot:spring-boot-starter-web'
+}

api/src/main/java/com/example/ApiApplication.java

@@ -0,0 +1,13 @@
+package com.example;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+public class ApiApplication {
+
+    public static void main(String[] args) {
+        SpringApplication.run(ApiApplication.class, args);
+    }
+
+}

api/src/main/java/com/example/MovieController.java

@@ -0,0 +1,20 @@
+package com.example;
+
+import com.example.response.MovieResponse;
+import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+@RestController
+@RequiredArgsConstructor
+public class MovieController {
+
+    private final MovieService movieService;
+
+    @GetMapping("/movies")
+    public List<MovieResponse> getMovies() {
+        return movieService.getMovies();
+    }
+}

api/src/main/resources/application.yml

@@ -0,0 +1,4 @@
+spring:
+  config:
+    import:
+      - application-domain.yml

api/src/test/java/com/example/ApiApplicationTest.java

@@ -0,0 +1,10 @@
+package com.example;
+
+import org.junit.jupiter.api.Test;
+import org.springframework.boot.test.context.SpringBootTest;
+
+@SpringBootTest
+class ApiApplicationTest {
+    @Test
+    void contextLoads() {}
+}

application/build.gradle

@@ -0,0 +1,3 @@
+dependencies {
+    implementation project(":domain")
+}

application/src/main/java/com/example/MovieService.java

@@ -0,0 +1,21 @@
+package com.example;
+
+import com.example.repository.MovieRepository;
+import com.example.response.MovieResponse;
+import com.example.response.MoviesServiceResponse;
+import lombok.RequiredArgsConstructor;
+import org.springframework.data.domain.Sort;
+import org.springframework.stereotype.Service;
+
+import java.util.List;
+
+@Service
+@RequiredArgsConstructor
+public class MovieService {
+
+    private final MovieRepository movieRepository;
+
+    public List<MovieResponse> getMovies() {
+        return MoviesServiceResponse.of(movieRepository.findMovieWithScreeningAndTheater(Sort.by(Sort.Order.desc("releaseDate"))));
+    }
+}

application/src/main/java/com/example/response/MovieResponse.java

@@ -0,0 +1,50 @@
+package com.example.response;
+
+import com.example.entity.Movie;
+import com.example.entity.MovieTheater;
+import com.example.entity.Screening;
+import com.example.entity.Theater;
+import lombok.Getter;
+
+import java.time.LocalDate;
+import java.time.format.DateTimeFormatter;
+import java.util.Comparator;
+import java.util.List;
+import java.util.stream.Collectors;
+
+@Getter
+public class MovieResponse {
+    private String title;
+    private String thumbnailUrl;
+    private String genre;
+    private String rating;
+    private LocalDate releaseDate;
+    private List<String> theaters;
+    private List<String> screenings;
+
+    MovieResponse(Movie movie) {
+        this.title = movie.getTitle();
+        this.thumbnailUrl = movie.getThumbnailUrl();
+        this.genre = movie.getGenre().getDescription();
+        this.rating = movie.getRating().getDescription();
+        this.releaseDate = movie.getReleaseDate();
+        this.theaters = createTheaters(movie);
+        this.screenings = createScreening(movie);
+    }
+
+    private static List<String> createTheaters(Movie movie) {
+        return movie.getMovieTheaters().stream()
+                .map(MovieTheater::getTheater)
+                .map(Theater::getName)
+                .collect(Collectors.toList());
+    }
+
+    private static List<String> createScreening(Movie movie) {
+        return movie.getScreenings().stream()
+                .sorted(Comparator.comparing(Screening::getStartedAt))
+                .map(screening -> screening.getStartedAt().format(DateTimeFormatter.ofPattern("HH:mm"))
+                        + " ~ "
+                        + screening.getEndedAt().format(DateTimeFormatter.ofPattern("HH:mm")))
+                .collect(Collectors.toList());
+    }
+}

application/src/main/java/com/example/response/MoviesServiceResponse.java

@@ -0,0 +1,15 @@
+package com.example.response;
+
+import com.example.entity.Movie;
+import lombok.Getter;
+
+import java.util.List;
+
+@Getter
+public class MoviesServiceResponse {
+    public static List<MovieResponse> of(List<Movie> movies) {
+        return movies.stream()
+                .map(MovieResponse::new)
+                .toList();
+    }
+}

application/src/main/resources/application.yml

@@ -0,0 +1,4 @@
+spring:
+  config:
+    import:
+      - application-domain.yml

application/src/test/java/com/example/ApplicationTest.java

@@ -0,0 +1,11 @@
+package com.example;
+
+import org.junit.jupiter.api.Test;
+import org.springframework.boot.test.context.SpringBootTest;
+
+@SpringBootTest
+public class ApplicationTest {
+
+    @Test
+    void contextLoad() {}
+}

build.gradle

@@ -0,0 +1,45 @@
+plugins {
+	id 'java'
+	id 'org.springframework.boot' version '3.4.1'
+	id 'io.spring.dependency-management' version '1.1.7'
+}
+
+bootJar.enabled = false
+
+subprojects {
+	apply plugin: 'java'
+	apply plugin: 'java-library'
+	apply plugin: 'org.springframework.boot'
+	apply plugin: 'io.spring.dependency-management'
+
+	group = 'com.example'
+	version = '0.0.1-SNAPSHOT'
+
+	repositories {
+		mavenCentral()
+	}
+
+	java {
+		toolchain {
+			languageVersion = JavaLanguageVersion.of(21)
+		}
+	}
+
+	configurations {
+		compileOnly {
+			extendsFrom annotationProcessor
+		}
+	}
+
+	dependencies {
+		implementation 'org.springframework.boot:spring-boot-starter'
+		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()
+	}
+}

docker-compose.yml

@@ -0,0 +1,14 @@
+services:
+  my-db:
+    container_name: theater_mysql
+    image: mysql
+    environment:
+      MYSQL_ROOT_PASSWORD: 1234
+      MYSQL_DATABASE: theater
+      TZ: Asia/Seoul
+      CHARACTER_SET_SERVER: utf8mb4
+    ports:
+      - 3306:3306
+    volumes:
+      - ./init:/docker-entrypoint-initdb.d/
+    restart: always

domain/build.gradle

@@ -0,0 +1,5 @@
+dependencies {
+    api 'org.springframework.boot:spring-boot-starter-data-jpa'
+    runtimeOnly 'com.mysql:mysql-connector-j'
+    runtimeOnly 'com.h2database:h2'
+}

domain/src/main/java/com/example/entity/BaseEntity.java

@@ -0,0 +1,20 @@
+package com.example.entity;
+
+import jakarta.persistence.EntityListeners;
+import jakarta.persistence.MappedSuperclass;
+import org.springframework.data.annotation.CreatedDate;
+import org.springframework.data.annotation.LastModifiedDate;
+import org.springframework.data.jpa.domain.support.AuditingEntityListener;
+
+import java.time.LocalDateTime;
+
+@MappedSuperclass
+@EntityListeners(AuditingEntityListener.class)
+public abstract class BaseEntity {
+
+    @CreatedDate
+    private LocalDateTime createdAt;
+
+    @LastModifiedDate
+    private LocalDateTime updatedAt;
+}

domain/src/main/java/com/example/entity/Genre.java

@@ -0,0 +1,15 @@
+package com.example.entity;
+
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+@Getter
+@RequiredArgsConstructor
+public enum Genre {
+    ACTION("액션"),
+    SF("SF"),
+    ROMANCE("로멘스"),
+    HORROR("호로");
+
+    private final String description;
+}