feat(#197/recruit): 기존 신규 멤버 가입 로직에 학기 추가

Author: kaswhy

src/main/java/inha/gdgoc/domain/recruit/dto/request/AnswerCreateRequest.java

@@ -0,0 +1,15 @@
+package inha.gdgoc.domain.recruit.dto.request;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@NoArgsConstructor
+@AllArgsConstructor
+@Getter
+public class AnswerCreateRequest {
+    private String surveyType;
+    private String inputType;
+    private JsonNode responseValue;
+}

src/main/java/inha/gdgoc/domain/recruit/dto/request/RecruitMemberRequest.java

@@ -3,6 +3,7 @@
 import inha.gdgoc.domain.recruit.entity.RecruitMember;
 import inha.gdgoc.domain.recruit.enums.EnrolledClassification;
 import inha.gdgoc.domain.recruit.enums.Gender;
+import inha.gdgoc.global.util.SemesterCalculator;
 import java.time.LocalDate;
 import lombok.AllArgsConstructor;
 import lombok.Builder;
@@ -41,6 +42,7 @@ public RecruitMember toEntity() {
                 .major(major)
                 .doubleMajor(doubleMajor)
                 .isPayed(false)
+                .admissionSemester(SemesterCalculator.currentSemester())
                 .build();
     }
 }

src/main/java/inha/gdgoc/domain/recruit/entity/RecruitMember.java

@@ -1,6 +1,7 @@
 package inha.gdgoc.domain.recruit.entity;
 
 import com.fasterxml.jackson.annotation.JsonFormat;
+import inha.gdgoc.domain.recruit.enums.AdmissionSemester;
 import inha.gdgoc.domain.recruit.enums.EnrolledClassification;
 import inha.gdgoc.domain.recruit.enums.Gender;
 import inha.gdgoc.global.entity.BaseEntity;
@@ -73,6 +74,10 @@ public class RecruitMember extends BaseEntity {
     @Column(name = "is_payed", nullable = false)
     private Boolean isPayed;
 
+    @Enumerated(EnumType.STRING)
+    @Column(name = "admission_semester", nullable = false, length = 10)
+    private AdmissionSemester admissionSemester;
+
     @Builder.Default
     @OneToMany(mappedBy = "recruitMember", cascade = CascadeType.ALL, orphanRemoval = true)
     private List<Answer> answers = new ArrayList<>();

src/main/java/inha/gdgoc/domain/recruit/enums/AdmissionSemester.java

@@ -0,0 +1,5 @@
+package inha.gdgoc.domain.recruit.enums;
+
+public enum AdmissionSemester {
+    Y25_1, Y25_2, Y26_1, Y26_2
+}

src/main/java/inha/gdgoc/global/util/SemesterCalculator.java

@@ -0,0 +1,45 @@
+package inha.gdgoc.global.util;
+
+import inha.gdgoc.domain.recruit.enums.AdmissionSemester;
+
+import java.time.LocalDate;
+import java.time.ZoneId;
+
+public final class SemesterCalculator {
+    private static final ZoneId KST = ZoneId.of("Asia/Seoul");
+
+    private SemesterCalculator() {}
+
+    public static AdmissionSemester currentSemester() {
+        return of(LocalDate.now(KST));
+    }
+
+    public static AdmissionSemester of(LocalDate date) {
+        int year = date.getYear();
+        int month = date.getMonthValue();
+
+        int yy;
+        int term;
+
+        if (month == 1) {
+            yy = (year - 1) % 100;
+            term = 2;
+        } else if (month <= 7) {
+            yy = year % 100;
+            term = 1;
+        } else {
+            yy = year % 100;
+            term = 2;
+        }
+
+        String enumName = String.format("Y%02d_%d", yy, term);
+        try {
+            return AdmissionSemester.valueOf(enumName);
+        } catch (Exception ex) {
+            throw new RuntimeException(
+                    "AdmissionSemester enum에 상수 " + enumName + " 이(가) 정의되어 있지 않습니다. " +
+                            "해당 연도/학기 상수를 추가하세요.", ex
+            );
+        }
+    }
+}

src/main/resources/db/migration/V20250826__admission_semester_add_backfill_enforce.sql

@@ -0,0 +1,24 @@
+-- 1) 컬럼 추가 (처음엔 NULL 허용)
+ALTER TABLE recruit_member
+    ADD COLUMN admission_semester VARCHAR(10);
+
+-- 2) 기존 데이터 백필
+-- 학기 규칙: 2~7월 = YYY_1, 8~12월 = YYY_2, 1월 = (전년도) YYY_2
+UPDATE recruit_member
+SET admission_semester = CASE
+                             WHEN EXTRACT(MONTH FROM created_at) BETWEEN 8 AND 12
+                                 THEN 'Y' || to_char(created_at, 'YY') || '_2'
+                             WHEN EXTRACT(MONTH FROM created_at) BETWEEN 2 AND 7
+                                 THEN 'Y' || to_char(created_at, 'YY') || '_1'
+                             WHEN EXTRACT(MONTH FROM created_at) = 1
+                                 THEN 'Y' || to_char(created_at - INTERVAL '1 year', 'YY') || '_2'
+    END
+WHERE admission_semester IS NULL;
+
+-- 3) NOT NULL 전환 (형식 제약은 생략 가능)
+ALTER TABLE recruit_member
+    ALTER COLUMN admission_semester SET NOT NULL;
+
+-- (선택) 인덱스
+CREATE INDEX idx_recruit_member_admission_semester
+    ON recruit_member (admission_semester);