[Feat] 다국어 처리 구조 구현

src/main/java/org/sopt/kareer/domain/member/controller/MemberController.java

@@ -1,37 +1,29 @@
 package org.sopt.kareer.domain.member.controller;
 
 
+import static org.sopt.kareer.global.config.swagger.SwaggerResponseDescription.*;
+
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.tags.Tag;
-import jakarta.servlet.http.HttpServletRequest;
-import jakarta.servlet.http.HttpServletResponse;
+import jakarta.servlet.http.*;
 import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
 import org.sopt.kareer.domain.member.dto.request.MemberOnboardRequest;
 import org.sopt.kareer.domain.member.dto.request.MemberTermsRequest;
 import org.sopt.kareer.domain.member.dto.request.MypageRequest;
 import org.sopt.kareer.domain.member.dto.response.*;
-import org.sopt.kareer.domain.member.entity.constants.Field;
-import org.sopt.kareer.domain.member.entity.constants.Major;
-import org.sopt.kareer.domain.member.entity.constants.University;
-import org.sopt.kareer.domain.member.entity.enums.Country;
-import org.sopt.kareer.domain.member.service.MemberService;
+import org.sopt.kareer.domain.member.service.*;
 import org.sopt.kareer.domain.roadmap.dto.response.RoadmapTestResponse;
-import org.sopt.kareer.domain.roadmap.service.RoadMapService;
-import org.sopt.kareer.domain.roadmap.service.RoadmapAsyncService;
+import org.sopt.kareer.domain.roadmap.service.*;
 import org.sopt.kareer.global.annotation.CustomExceptionDescription;
 import org.sopt.kareer.global.auth.service.AuthService;
 import org.sopt.kareer.global.config.swagger.SwaggerResponseDescription;
 import org.sopt.kareer.global.response.BaseResponse;
-import org.springframework.http.HttpStatus;
-import org.springframework.http.MediaType;
-import org.springframework.http.ResponseEntity;
+import org.springframework.http.*;
 import org.springframework.security.core.annotation.AuthenticationPrincipal;
 import org.springframework.web.bind.annotation.*;
 import org.springframework.web.multipart.MultipartFile;
 
-import static org.sopt.kareer.global.config.swagger.SwaggerResponseDescription.*;
-
 @RestController
 @RequiredArgsConstructor
 @RequestMapping("/api/v1/members")
@@ -42,6 +34,7 @@ public class MemberController {
     private final RoadMapService roadMapService;
     private final RoadmapAsyncService roadmapAsyncService;
     private final AuthService authService;
+    private final LocalizedOnboardQueryService localizedOnboardQueryService;
 
     @GetMapping("/me")
     @Operation(summary = "회원 정보 조회", description = "로그인한 회원의 정보를 조회합니다.")
@@ -68,7 +61,7 @@ public ResponseEntity<BaseResponse<Void>> onboardMember(@AuthenticationPrincipal
     public ResponseEntity<BaseResponse<OnboardUniversitiesResponse>> getOnboardUniversities() {
         return ResponseEntity
                 .status(HttpStatus.OK)
-                .body(BaseResponse.ok(OnboardUniversitiesResponse.from(University.UNIVERSITY_LIST),
+                .body(BaseResponse.ok(localizedOnboardQueryService.getUniversities(),
                         "온보딩 대학교 목록 조회에 성공하였습니다."));
     }
 
@@ -78,7 +71,7 @@ public ResponseEntity<BaseResponse<OnboardCountriesResponse>> getOnboardCountrie
         return ResponseEntity
                 .status(HttpStatus.OK)
                 .body(BaseResponse.ok(
-                        OnboardCountriesResponse.from(Country.getCountries()),
+                        localizedOnboardQueryService.getCountries(),
                         "온보딩 국가 목록 조회에 성공하였습니다."));
     }
 
@@ -87,17 +80,15 @@ public ResponseEntity<BaseResponse<OnboardCountriesResponse>> getOnboardCountrie
     public ResponseEntity<BaseResponse<OnboardMajorsResponse>> getOnboardMajors() {
         return ResponseEntity
                 .status(HttpStatus.OK)
-                .body(BaseResponse.ok(OnboardMajorsResponse.from(Major.MAJOR_LIST), "온보딩 전공 목록 조회에 성공하였습니다.")
-                );
+                .body(BaseResponse.ok(localizedOnboardQueryService.getMajors(), "온보딩 전공 목록 조회에 성공하였습니다."));
     }
 
     @GetMapping("/onboard/fields")
     @Operation(summary = "온보딩 관심 분야 목록 조회", description = "회원 온보딩 시 선택할 수 있는 관심 분야 목록을 조회합니다.")
     public ResponseEntity<BaseResponse<OnboardFieldsResponse>> getOnboardFields() {
         return ResponseEntity
                 .status(HttpStatus.OK)
-                .body(BaseResponse.ok(OnboardFieldsResponse.from(Field.FIELD_LIST), "온보딩 관심 분야 목록 조회에 성공하였습니다.")
-                );
+                .body(BaseResponse.ok(localizedOnboardQueryService.getFields(), "온보딩 관심 분야 목록 조회에 성공하였습니다."));
     }
 
     @Operation(summary = "AI 로드맵 생성 API", description = "사용자가 온보딩에 입력한 정보를 통해 로드맵을 생성합니다.")

src/main/java/org/sopt/kareer/domain/member/dto/request/MemberOnboardV2Request.java

@@ -13,11 +13,11 @@ public record MemberOnboardV2Request(
         @NotNull(message = "생년월일은 필수 입력값입니다.")
         LocalDate birthDate,
 
-        @NotNull(message = "대학교는 필수 입력값입니다.")
-        String university,
+        @NotNull(message = "대학교 코드는 필수 입력값입니다.")
+        String universityCode,
 
-        @NotNull(message = "국가는 필수 입력값입니다.")
-        Country country,
+        @NotNull(message = "국가 코드는 필수 입력값입니다.")
+        String countryCode,
 
         @NotNull(message = "언어 능력은 필수 입력값입니다.")
         LanguageLevel languageLevel,
@@ -40,11 +40,8 @@ public record MemberOnboardV2Request(
         @NotNull(message = "비자 만료일은 필수 입력값입니다.")
         LocalDate visaExpiredAt,
 
-        @Schema(description = "비자 점수, D10 비자인 경우만", example = "50")
-        Integer visaPoint,
-
-        @NotBlank(message = "제1전공은 필수 입력값입니다.")
-        String primaryMajor,
+        @NotBlank(message = "제1전공 코드는 필수 입력값입니다.")
+        String primaryMajorCode,
 
         String secondaryMajor,
 
@@ -63,15 +60,4 @@ public record MemberOnboardV2Request(
         @Size(max = 1000, message = "개인 배경은 최대 1000자까지 입력할 수 있습니다.")
         String personalBackground
 ) {
-    @AssertTrue(message = "visaPoint는 D10 비자인 경우에만 입력할 수 있습니다.")
-    @Schema(hidden = true)
-    public boolean isVisaPointValid() {
-        if (visaType == null) {
-            return visaPoint == null;
-        }
-        if (visaType == VisaType.D10) {
-            return visaPoint != null;
-        }
-        return visaPoint == null;
-    }
 }

src/main/java/org/sopt/kareer/domain/member/dto/request/MypageRequest.java

@@ -19,20 +19,20 @@ public record MypageRequest(
         LocalDate birthDate,
 
         @Schema(description = "국가", example = "Afghanistan")
-        @NotNull(message = "국가는 필수 입력값입니다.")
-        Country country,
+        @NotNull(message = "국가코드는 필수 입력값입니다.")
+        String countryCode,
 
         @Schema(description = "학위", example = "DOMESTIC_ASSOCIATE")
         @NotNull(message = "학위는 필수 입력값입니다.")
         Degree degree,
 
         @Schema(description = "대학", example = "Konkuk University")
-        @NotBlank(message = "대학은 필수 입력값입니다.")
-        String university,
+        @NotBlank(message = "대학코드는 필수 입력값입니다.")
+        String universityCode,
 
         @Schema(description = "전공", example = "Computer Science")
-        @NotBlank(message = "전공은 필수 입력값입니다.")
-        String primaryMajor,
+        @NotBlank(message = "전공코드는 필수 입력값입니다.")
+        String primaryMajorCode,
 
         @Schema(description = "부전공", example = "Statistic")
         @NotBlank(message = "부전공은 필수 입력값입니다.")
@@ -55,8 +55,8 @@ public record MypageRequest(
         EnglishLevel englishLevel
 ) {
         public MypageCommand toCommand(){
-                return new MypageCommand(this.targetJob, this.birthDate, this.country,
-                        this.degree, this.university, this.primaryMajor, this.secondaryMajor, this.visaType,
+                return new MypageCommand(this.targetJob, this.birthDate, this.countryCode,
+                        this.degree, this.universityCode, this.primaryMajorCode, this.secondaryMajor, this.visaType,
                         this.visaExpiredAt, this.languageLevel, this.englishLevel);
         }
 }

src/main/java/org/sopt/kareer/domain/member/dto/response/LocalizedItemResponse.java

@@ -0,0 +1,3 @@
+package org.sopt.kareer.domain.member.dto.response;
+
+public record LocalizedItemResponse(String code, String label) {}

src/main/java/org/sopt/kareer/domain/member/dto/response/MemberInfoResponse.java

@@ -2,11 +2,8 @@
 
 import io.swagger.v3.oas.annotations.media.Schema;
 import java.time.LocalDate;
-import org.sopt.kareer.domain.member.entity.Member;
-import org.sopt.kareer.domain.member.entity.MemberVisa;
-import org.sopt.kareer.domain.member.entity.enums.Country;
-import org.sopt.kareer.domain.member.entity.enums.LanguageLevel;
-import org.sopt.kareer.domain.member.entity.enums.VisaType;
+import org.sopt.kareer.domain.member.entity.*;
+import org.sopt.kareer.domain.member.entity.enums.*;
 
 @Schema(description = "회원 정보 응답")
 public record MemberInfoResponse(
@@ -26,7 +23,7 @@ public record MemberInfoResponse(
         LocalDate birthDate,
 
         @Schema(description = "거주 국가")
-        Country country,
+        String country,
 
         @Schema(description = "주 전공", example = "Computer Science")
         String primaryMajor,
@@ -37,6 +34,9 @@ public record MemberInfoResponse(
         @Schema(description = "타겟 직무", example = "Backend Engineer")
         String targetJob,
 
+        @Schema(description = "대학교", example = "Seoul National University")
+        String university,
+
         @Schema(description = "졸업일", example = "2026-02-11")
         LocalDate graduationDate,
 
@@ -49,27 +49,37 @@ public record MemberInfoResponse(
         @Schema(description = "학위", example = "Bachelor")
         String degree,
 
+        @Schema(description = "영어 수준", example = "Upper Intermediate")
+        String englishLevel,
+
         @Schema(description = "타겟 직무 스킬", example = "Java, Spring")
         String targetJobSkill,
 
         @Schema(description = "비자 유형")
         VisaType visaType
 ) {
-    public static MemberInfoResponse from(Member member, MemberVisa memberVisa) {
+    public static MemberInfoResponse of(Member member, MemberVisa memberVisa,
+                                        String countryLabel,
+                                        String primaryMajorLabel,
+                                        String universityLabel,
+                                        String degreeLabel,
+                                        String englishLevelLabel) {
         return new MemberInfoResponse(
                 member.getId(),
                 member.getName(),
                 member.getEmail(),
                 member.getProfileImageUrl(),
                 member.getBirthDate(),
-                member.getCountry(),
-                member.getPrimaryMajor(),
+                countryLabel,
+                primaryMajorLabel,
                 member.getSecondaryMajor(),
                 member.getTargetJob(),
+                universityLabel,
                 member.getGraduationDate(),
                 member.getExpectedGraduationDate(),
                 member.getLanguageLevel(),
-                member.getDegree().getDescription(),
+                degreeLabel,
+                englishLevelLabel,
                 member.getTargetJobSkill(),
                 memberVisa.getVisaType()
         );

src/main/java/org/sopt/kareer/domain/member/dto/response/MypageResponse.java

@@ -51,21 +51,26 @@ public record MypageResponse(
         String englishLevel
 
 ) {
-    public static MypageResponse from(Member member, MemberVisa memberVisa) {
+    public static MypageResponse of(Member member, MemberVisa memberVisa,
+                                    String countryLabel,
+                                    String primaryMajorLabel,
+                                    String universityLabel,
+                                    String degreeLabel,
+                                    String englishLevelLabel) {
         return MypageResponse.builder()
                 .name(member.getName())
                 .profileImageUrl(member.getProfileImageUrl())
                 .targetJob(member.getTargetJob())
                 .birthDate(member.getBirthDate())
-                .country(member.getCountry().getCountryName())
-                .degree(member.getDegree().getDescription())
-                .university(member.getUniversity())
-                .primaryMajor(member.getPrimaryMajor())
+                .country(countryLabel)
+                .degree(degreeLabel)
+                .university(universityLabel)
+                .primaryMajor(primaryMajorLabel)
                 .secondaryMajor(member.getSecondaryMajor())
                 .visaType(memberVisa.getVisaType().getDescription())
                 .visaExpiredAt(memberVisa.getVisaExpiredAt())
                 .languageLevel(member.getLanguageLevel())
-                .englishLevel(member.getEnglishLevel().getDescription())
+                .englishLevel(englishLevelLabel)
                 .build();
     }
 }

src/main/java/org/sopt/kareer/domain/member/dto/response/OnboardCountriesResponse.java

@@ -3,9 +3,9 @@
 import java.util.List;
 
 public record OnboardCountriesResponse(
-        List<String> countries
+        List<LocalizedItemResponse> countries
 ) {
-    public static OnboardCountriesResponse from(List<String> countries) {
+    public static OnboardCountriesResponse of(List<LocalizedItemResponse> countries) {
         return new OnboardCountriesResponse(countries);
     }
 }

src/main/java/org/sopt/kareer/domain/member/dto/response/OnboardFieldsResponse.java

@@ -3,9 +3,9 @@
 import java.util.List;
 
 public record OnboardFieldsResponse(
-        List<String> fields
+        List<LocalizedItemResponse> fields
 ) {
-    public static OnboardFieldsResponse from(List<String> fields) {
+    public static OnboardFieldsResponse of(List<LocalizedItemResponse> fields) {
         return new OnboardFieldsResponse(fields);
     }
 }

src/main/java/org/sopt/kareer/domain/member/dto/response/OnboardMajorsResponse.java

@@ -3,9 +3,9 @@
 import java.util.List;
 
 public record OnboardMajorsResponse(
-        List<String> majors
+        List<LocalizedItemResponse> majors
 ) {
-    public static OnboardMajorsResponse from(List<String> majorList) {
+    public static OnboardMajorsResponse of(List<LocalizedItemResponse> majorList) {
         return new OnboardMajorsResponse(majorList);
     }
 }

src/main/java/org/sopt/kareer/domain/member/dto/response/OnboardUniversitiesResponse.java

@@ -3,9 +3,9 @@
 import java.util.List;
 
 public record OnboardUniversitiesResponse(
-        List<String> universities
+        List<LocalizedItemResponse> universities
 ) {
-    public static OnboardUniversitiesResponse from(List<String> universities) {
+    public static OnboardUniversitiesResponse of(List<LocalizedItemResponse> universities) {
         return new OnboardUniversitiesResponse(universities);
     }
 }