🚀 2단계 - 수강신청(도메인 모델) (#796)

* 🚀 2단계 - 수강신청(도메인 모델) : TDD 1차 구현

* 🚀 2단계 - 수강신청(도메인 모델) : id, enroll 분리

* 패키지 분리, SessionType 분리

* 메서드명 변경 및 Registration 추가

* Enrollment 분리, 가변 객체화

* payAmount long 타입으로 변경

Author: Eundms

Step.md docs/Step01.mdStep.md renamed to docs/Step01.md

@@ -0,0 +1,38 @@
+## 수강 신청 기능 요구사항
+- 과정(Course)은 기수 단위로 운영하며, 여러 개의 강의(Session)를 가질 수 있다. 
+- 강의는 시작일과 종료일을 가진다. 
+- 강의는 강의 커버 이미지 정보를 가진다. 
+  - 이미지 크기는 1MB 이하여야 한다. 
+  - 이미지 타입은 gif, jpg(jpeg 포함),, png, svg만 허용한다. 
+  - 이미지의 width는 300픽셀, height는 200픽셀 이상이어야 하며, width와 height의 비율은 3:2여야 한다.
+- 강의는 무료 강의와 유료 강의로 나뉜다.
+  - 무료 강의는 최대 수강 인원 제한이 없다.
+  - 유료 강의는 강의 최대 수강 인원을 초과할 수 없다.
+  - 유료 강의는 수강생이 결제한 금액과 수강료가 일치할 때 수강 신청이 가능하다.
+- 강의 상태는 준비중, 모집중, 종료 3가지 상태를 가진다.
+- 강의 수강신청은 강의 상태가 모집중일 때만 가능하다.
+- 유료 강의의 경우 결제는 이미 완료한 것으로 가정하고 이후 과정을 구현한다. 
+  - 결제를 완료한 결제 정보는 payments 모듈을 통해 관리되며, 결제 정보는 Payment 객체에 담겨 반한된다.
+
+
+## 클래스 
+- `과정(Course)` : 1
+  - 기수
+
+- `강의(Session)` : N
+  - 금액 : 유료 / 무료
+    - 유료 강의
+      - 강의 최대 `수강 인원` 제한
+      - `결재 금액` = 수강료]
+    - 무료 강의
+      - 최대 수강인원 제한 없음
+  - 상태 : 준비중, 모집중, 종료
+  - 시작일, 종료일 
+  - 강의 커버 이미지 
+
+- `강의 커버 이미지 (SessionCoverImage)`
+  - 크기 : 1MB
+  - 타입 : gif, jpg(jpeg), png, svg
+  - dimension 
+    - width >= 300, height >= 200
+    - width : height = 3 : 2

docs/Step02.md

@@ -0,0 +1,36 @@
+package nextstep.courses.domain;
+
+import java.time.LocalDateTime;
+
+public abstract class BaseEntity {
+    private Long id;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+
+    protected BaseEntity() {
+        this.createdAt = LocalDateTime.now();
+    }
+
+    protected BaseEntity(Long id) {
+        this.id = id;
+        this.createdAt = LocalDateTime.now();
+    }
+
+    protected BaseEntity(Long id, LocalDateTime createdAt, LocalDateTime updatedAt) {
+        this.id = id;
+        this.createdAt = createdAt;
+        this.updatedAt = updatedAt;
+    }
+
+    public Long getId() {
+        return id;
+    }
+
+    public LocalDateTime getCreatedAt() {
+        return createdAt;
+    }
+
+    public LocalDateTime getUpdatedAt() {
+        return updatedAt;
+    }
+}

src/main/java/nextstep/courses/domain/BaseEntity.java

@@ -0,0 +1,61 @@
+package nextstep.courses.domain.course;
+
+import java.time.LocalDateTime;
+import java.util.Objects;
+import nextstep.courses.domain.BaseEntity;
+
+public class Course extends BaseEntity {
+    private String title;
+    private Long creatorId;
+
+    public Course() {
+    }
+
+    public Course(String title, Long creatorId) {
+        this(null, title, creatorId);
+    }
+
+    public Course(Long id, String title, Long creatorId) {
+        super(id);
+        this.title = title;
+        this.creatorId = creatorId;
+    }
+
+    public Course(Long id, String title, Long creatorId, LocalDateTime createdAt, LocalDateTime updatedAt) {
+        super(id, createdAt, updatedAt);
+        this.title = title;
+        this.creatorId = creatorId;
+    }
+
+    public String getTitle() {
+        return title;
+    }
+
+    public Long getCreatorId() {
+        return creatorId;
+    }
+
+    @Override
+    public String toString() {
+        return "Course{" +
+                "id=" + getId() +
+                ", title='" + title + '\'' +
+                ", creatorId=" + creatorId +
+                ", createdAt=" + getCreatedAt() +
+                '}';
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (o == null || getClass() != o.getClass()) {
+            return false;
+        }
+        Course course = (Course) o;
+        return Objects.equals(getId(), course.getId());
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hashCode(getId());
+    }
+}

src/main/java/nextstep/courses/domain/Course.java

@@ -1,4 +1,4 @@
-package nextstep.courses.domain;
+package nextstep.courses.domain.course;
 
 public interface CourseRepository {
     int save(Course course);

src/main/java/nextstep/courses/domain/course/Course.java

@@ -0,0 +1,17 @@
+package nextstep.courses.domain.image;
+
+public class SessionCoverImage {
+  private final SessionImageDimension dimension;
+  private final SessionImageExtension extension;
+  private final SessionImageCapacity capacity;
+
+  public SessionCoverImage(int width, int height, String extension, long bytes) {
+    this(new SessionImageDimension(width, height), SessionImageExtension.from(extension), new SessionImageCapacity(bytes));
+  }
+
+  public SessionCoverImage(SessionImageDimension dimension, SessionImageExtension extension, SessionImageCapacity capacity) {
+    this.dimension = dimension;
+    this.extension = extension;
+    this.capacity = capacity;
+  }
+}

…tep/courses/domain/CourseRepository.java …rses/domain/course/CourseRepository.javasrc/main/java/nextstep/courses/domain/CourseRepository.java renamed to src/main/java/nextstep/courses/domain/course/CourseRepository.java src/main/java/nextstep/courses/domain/CourseRepository.java renamed to src/main/java/nextstep/courses/domain/course/CourseRepository.java

@@ -0,0 +1,29 @@
+package nextstep.courses.domain.image;
+
+public class SessionImageCapacity {
+  private static final long MAX_CAPACITY_BYTES = 1024 * 1024; // 1MB
+  private final long bytes;
+
+  public SessionImageCapacity(long bytes) {
+    validate(bytes);
+    this.bytes = bytes;
+  }
+
+  public static SessionImageCapacity ofKB(long kb) {
+    return new SessionImageCapacity(kb * 1024);
+  }
+
+  public static SessionImageCapacity ofMB(long mb) {
+    return new SessionImageCapacity(mb * 1024 * 1024);
+  }
+
+  private void validate(long bytes) {
+    if (bytes <= 0) {
+      throw new IllegalArgumentException("이미지 크기는 0보다 커야 합니다.");
+    }
+    if (bytes > MAX_CAPACITY_BYTES) {
+      throw new IllegalArgumentException("이미지 크기는 1MB 이하여야 합니다.");
+    }
+  }
+
+}

src/main/java/nextstep/courses/domain/image/SessionCoverImage.java

@@ -0,0 +1,38 @@
+package nextstep.courses.domain.image;
+
+public class SessionImageDimension {
+  private static final int MIN_WIDTH = 300;
+  private static final int MIN_HEIGHT = 200;
+  private static final int RATIO_W = 3;
+  private static final int RATIO_H = 2;
+
+  private int width;
+  private int height;
+
+  public SessionImageDimension(int width, int height) {
+    validateMinLength(width, height);
+    validateRatio(width, height);
+    this.width = width;
+    this.height = height;
+  }
+  private void validateMinLength(int width, int height){
+    if(!(width >= MIN_WIDTH && height >= MIN_HEIGHT)) {
+      throw new IllegalArgumentException("이미지는 가로 300이상, 세로 200 이상이어야 합니다.");
+    }
+  }
+
+  private void validateRatio(int width, int height){
+    int gcd = gcd(width, height);
+    int ratioW = width / gcd;
+    int ratioH = height / gcd;
+    if(!(ratioW == RATIO_W && ratioH == RATIO_H)){
+      throw new IllegalArgumentException("이미지는 가로 x 세로 3대 2이어야 합니다.");
+    }
+  }
+
+  private int gcd(int a, int b) {
+    return b == 0 ? a : gcd(b, a % b);
+  }
+
+
+}

src/main/java/nextstep/courses/domain/image/SessionImageCapacity.java

@@ -0,0 +1,27 @@
+package nextstep.courses.domain.image;
+
+import java.util.ArrayList;
+import java.util.List;
+
+public enum SessionImageExtension {
+  GIF("gif"),
+  JPG("jpg", "jpeg"),
+  PNG("png"),
+  SVG("svg");
+
+  private List<String> names;
+
+  SessionImageExtension(String... names){
+    this.names = new ArrayList<>(List.of(names));
+  }
+
+  public static SessionImageExtension from(String extension) {
+    String lowerExt = extension.toLowerCase();
+    for (SessionImageExtension type : values()) {
+      if (type.names.contains(lowerExt)) {
+        return type;
+      }
+    }
+    throw new IllegalArgumentException("지원하지 않는 이미지 확장자입니다: " + extension);
+  }
+}