4단계 - 수강신청(요구사항 변경)

docs/step4요구사항.md

@@ -0,0 +1,30 @@
+# 변경된 기능 요구사항 정리
+
+## 1 강의 상태 분리
+### 기존
+- 강의 진행 상태와 모집 상태가 결합되어 있음
+- 모집중 상태일 때만 수강신청 가능
+
+### 변경점
+- [ ] 강의 진행 상태(ProgressStatus): 준비중, 진행중, 종료
+- [ ] 모집 상태(RecruitmentStatus): 비모집중, 모집중
+- [ ] 강의가 진행중 이여도 모집중이라면 수강신청 가능
+
+## 2 강의 커버 이미지 여러개
+### 기존
+- Session은 하나의 SessionImage만 가짐
+- session테이블에 image_id가 FK 존재
+
+### 변경점
+- [ ] Session은 하나 이상의 커버 이미지를 가질 수 있음
+- [ ] DB에 데이터가 존재한다는 가정하에  진행해야 하므로 session테이블의 image_id는 대표이미지로 변경
+- [ ] 등록되는 여러개의 이미지는 별도 테이블로 추가로 관리해야할듯
+
+## 3 수강 승인기능 추가
+### 기존
+- 모집중이고 결제금액과 수강료가 일치하고 최대 수강인원을 넘지 않으면 수강 가능
+
+### 변경점
+- [ ] 수강신청을 받으면 대기 상태가 되고 
+- [ ] 강사가 선발된 인원에 대해 승인 (승인된 인원만 수강 가능)
+- [ ] 강사가 선발되지 않은 인원 수강 취소

src/main/java/nextstep/courses/domain/session/Enrollment.java

@@ -3,29 +3,28 @@
 import nextstep.payments.domain.Payment;
 
 import java.util.Collections;
-import java.util.HashSet;
 import java.util.List;
-import java.util.Set;
 
 public class Enrollment {
     private final Long sessionId;
-    private final SessionStatus status;
+    private final RecruitmentStatus recruitmentStatus;
     private final SessionType sessionType;
     private final List<EnrolledStudent> enrolledStudents;
 
-    public Enrollment(SessionStatus status, SessionType sessionType) {
-        this(null, status, sessionType, Collections.emptyList());
+    public Enrollment(RecruitmentStatus recruitmentStatus, SessionType sessionType) {
+        this(null, recruitmentStatus, sessionType, Collections.emptyList());
     }
 
-    public Enrollment(Long sessionId, SessionStatus status, SessionType sessionType, List<EnrolledStudent> enrolledStudents) {
+
+    public Enrollment(Long sessionId, RecruitmentStatus recruitmentStatus, SessionType sessionType, List<EnrolledStudent> enrolledStudents) {
         this.sessionId = sessionId;
-        this.status = status;
+        this.recruitmentStatus = recruitmentStatus;
         this.sessionType = sessionType;
         this.enrolledStudents = enrolledStudents;
     }
 
     public EnrolledStudent enroll(Long nsUserId, Payment payment) {
-        if (!status.canEnroll()) {
+        if (!recruitmentStatus.canEnroll()) {
             throw new IllegalStateException("모집중인 강의만 수강 신청할 수 있다");
         }
         if (!sessionType.isValidPayment(payment)) {
@@ -35,14 +34,33 @@ public EnrolledStudent enroll(Long nsUserId, Payment payment) {
         if (sessionType.isOverCapacity(enrolledStudents.size())) {
             throw new IllegalStateException("최대 수강 인원을 초과했습니다.");
         }
-        return new EnrolledStudent(sessionId,nsUserId);
+        return new EnrolledStudent(sessionId, nsUserId);
     }
 
-    public SessionStatus getStatus() {
-        return status;
+    public EnrollmentApplication apply(Long nsUserId, Payment payment) {
+        if (!recruitmentStatus.canEnroll()) {
+            throw new IllegalStateException("모집중인 강의만 수강 신청할 수 있습니다.");
+        }
+        if (!sessionType.isValidPayment(payment)) {
+            throw new IllegalArgumentException("결제 금액이 수강료와 일치하지 않습니다.");
+        }
+        if (sessionType.isOverCapacity(enrolledStudents.size())) {
+            throw new IllegalStateException("최대 수강 인원을 초과했습니다.");
+        }
+        return new EnrollmentApplication(sessionId, nsUserId, payment);
+    }
+
+    public EnrolledStudent approve(EnrollmentApplication application, Long adminId) {
+        application.approve(adminId);
+        return new EnrolledStudent(application.getSessionId(), application.getNsUserId());
     }
 
+
     public SessionType getSessionType() {
         return sessionType;
     }
+
+    public RecruitmentStatus getRecruitmentStatus() {
+        return recruitmentStatus;
+    }
 }

src/main/java/nextstep/courses/domain/session/EnrollmentApplication.java

@@ -0,0 +1,67 @@
+package nextstep.courses.domain.session;
+
+import nextstep.payments.domain.Payment;
+
+import java.time.LocalDateTime;
+
+public class EnrollmentApplication {
+    private final Long sessionId;
+    private final Long nsUserId;
+    private final Payment payment;
+    private EnrollmentStatus status;
+    private LocalDateTime approvedAt;
+    private Long approvedBy;
+
+    public EnrollmentApplication(Long sessionId, Long nsUserId, Payment payment) {
+        this(sessionId, nsUserId, payment, EnrollmentStatus.PENDING, LocalDateTime.now(), null);
+    }
+
+    public EnrollmentApplication(Long sessionId, Long nsUserId, Payment payment, EnrollmentStatus status, LocalDateTime approvedAt, Long approvedBy) {
+        this.sessionId = sessionId;
+        this.nsUserId = nsUserId;
+        this.payment = payment;
+        this.status = status;
+        this.approvedAt = approvedAt;
+        this.approvedBy = approvedBy;
+    }
+
+    public void approve(Long adminId) {
+        if (!status.isPending()) {
+            throw new IllegalStateException("대기 중인 신청만 승인 가능합니다.");
+        }
+        this.status = EnrollmentStatus.APPROVED;
+        this.approvedAt = LocalDateTime.now();
+        this.approvedBy = adminId;
+    }
+
+    public void cancel() {
+        if (!status.isPending()) {
+            throw new IllegalStateException("대기 중인 신청만 취소 가능합니다.");
+        }
+        this.status = EnrollmentStatus.CANCELLED;
+    }
+
+    public Long getSessionId() {
+        return sessionId;
+    }
+
+    public Long getNsUserId() {
+        return nsUserId;
+    }
+
+    public Payment getPayment() {
+        return payment;
+    }
+
+    public EnrollmentStatus getStatus() {
+        return status;
+    }
+
+    public LocalDateTime getApprovedAt() {
+        return approvedAt;
+    }
+
+    public Long getApprovedBy() {
+        return approvedBy;
+    }
+}

src/main/java/nextstep/courses/domain/session/EnrollmentRepository.java

@@ -3,8 +3,11 @@
 import java.util.List;
 
 public interface EnrollmentRepository {
-    void save (EnrolledStudent enrolledStudent);
+    void save(EnrolledStudent enrolledStudent);
 
     List<EnrolledStudent> findBySessionId(Long sessionId);
 
+    void saveApplication(EnrollmentApplication application);
+
+    void updateApplication(EnrollmentApplication application);
 }

src/main/java/nextstep/courses/domain/session/EnrollmentStatus.java

@@ -0,0 +1,34 @@
+package nextstep.courses.domain.session;
+
+import java.util.Arrays;
+
+public enum EnrollmentStatus {
+    PENDING("대기중"),
+    APPROVED("승인됨"),
+    CANCELLED("취소됨");
+
+    private final String value;
+
+    EnrollmentStatus(String value) {
+        this.value = value;
+    }
+
+    public static EnrollmentStatus from(String description) {
+        return Arrays.stream(values())
+                .filter(status -> status.value.equals(description))
+                .findFirst()
+                .orElseThrow(() -> new IllegalArgumentException("잘못된 수강신청 상태입니다: " + description));
+    }
+
+    public boolean isApproved() {
+        return this == APPROVED;
+    }
+
+    public boolean isPending() {
+        return this == PENDING;
+    }
+
+    public String getValue() {
+        return value;
+    }
+}

src/main/java/nextstep/courses/domain/session/ProgressStatus.java

@@ -0,0 +1,26 @@
+package nextstep.courses.domain.session;
+
+import java.util.Arrays;
+
+public enum ProgressStatus {
+    PREPARING("준비중"),
+    IN_PROGRESS("진행중"),
+    CLOSED("종료");
+
+    private final String value;
+
+    ProgressStatus(String value) {
+        this.value = value;
+    }
+
+    public static ProgressStatus from(String description) {
+        return Arrays.stream(values())
+                .filter(status -> status.value.equals(description))
+                .findFirst()
+                .orElseThrow(() -> new IllegalArgumentException("잘못된 진행 상태입니다: " + description));
+    }
+
+    public String getValue() {
+        return value;
+    }
+}

src/main/java/nextstep/courses/domain/session/RecruitmentStatus.java

@@ -0,0 +1,29 @@
+package nextstep.courses.domain.session;
+
+import java.util.Arrays;
+
+public enum RecruitmentStatus {
+    NOT_RECRUITING("비모집중"),
+    RECRUITING("모집중");
+
+    private final String value;
+
+    RecruitmentStatus(String value) {
+        this.value = value;
+    }
+
+    public static RecruitmentStatus from(String description) {
+        return Arrays.stream(values())
+                .filter(status -> status.value.equals(description))
+                .findFirst()
+                .orElseThrow(() -> new IllegalArgumentException("잘못된 모집 상태입니다: " + description));
+    }
+
+    public boolean canEnroll() {
+        return this == RECRUITING;
+    }
+
+    public String getValue() {
+        return value;
+    }
+}