[Feat] 온보딩 OCR API 구현

src/main/java/org/sopt/kareer/domain/jobposting/util/ResumeContextService.java

@@ -2,11 +2,10 @@
 
 import lombok.RequiredArgsConstructor;
 import org.sopt.kareer.domain.jobposting.exception.JobPostingException;
-import org.sopt.kareer.global.external.clova.service.DocumentProcessingService;
+import org.sopt.kareer.global.document.service.DocumentProcessingService;
 import org.springframework.stereotype.Service;
 import org.springframework.web.multipart.MultipartFile;
 
-import java.io.File;
 import java.util.List;
 
 import static org.sopt.kareer.domain.jobposting.exception.JobPostingErrorCode.RESUME_CONTEXT_FAILED;
@@ -32,24 +31,15 @@ public String buildContext(List<MultipartFile> files) {
         sb.append("[RESUME_COVER_LETTER]\n");
 
         for (MultipartFile file : files) {
-            File temp = null;
-
             try {
-                temp = File.createTempFile("resume_", ".pdf");
-                file.transferTo(temp);
-
-                String text = documentProcessingService.extractTextWithOcr(temp);
+                String text = documentProcessingService.extractText(file);
 
                 sb.append("----- FILE START -----\n");
                 sb.append(text).append("\n");
                 sb.append("----- FILE END -----\n\n");
 
             } catch (Exception e) {
                 throw new JobPostingException(RESUME_CONTEXT_FAILED, e.getMessage());
-            } finally {
-                if (temp != null && temp.exists()) {
-                    temp.delete();
-                }
             }
         }
 

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

@@ -1,8 +1,6 @@
 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;
@@ -12,7 +10,9 @@
 import org.sopt.kareer.domain.member.dto.request.MemberOnboardRequest;
 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.*;
+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.roadmap.dto.response.RoadmapTestResponse;
@@ -23,9 +23,13 @@
 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.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
@@ -155,4 +159,21 @@ public ResponseEntity<BaseResponse<Void>> deleteMember(@AuthenticationPrincipal
                 .body(BaseResponse.ok("회원 탈퇴에 성공하였습니다."));
     }
 
+    @Operation(summary = "온보딩 비자 OCR API", description = "온보딩 과정에서 유저의 비자 문서를 분석하여 정보를 추출합니다.")
+    @PostMapping(value = "/onboard/ocr/visa", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
+    public ResponseEntity<BaseResponse<OcrVisaResponse>> getVisaInfo(
+            @RequestPart("file") MultipartFile file){
+        return ResponseEntity.status(HttpStatus.OK)
+                .body(BaseResponse.ok(memberService.getVisaOcr(file), "사용자 비자 정보 추출에 성공했습니다."));
+    }
+
+    @Operation(summary = "온보딩 여권 OCR API", description = "온보딩 과정에서 유저의 여권을 분석하여 정보를 추출합니다.")
+    @PostMapping(value = "/onboard/ocr/passport", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
+    public ResponseEntity<BaseResponse<OcrPassportResponse>> getPassportInfo(
+            @RequestPart("file") MultipartFile file){
+        return ResponseEntity.status(HttpStatus.OK)
+                .body(BaseResponse.ok(memberService.getPassportOcr(file), "사용자 여권 정보 추출에 성공했습니다."));
+    }
+
+
 }

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

@@ -0,0 +1,28 @@
+package org.sopt.kareer.domain.member.dto.response;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Builder;
+import org.sopt.kareer.domain.member.entity.enums.Country;
+import org.sopt.kareer.domain.member.util.PassportOcrParser;
+
+import java.time.LocalDate;
+
+@Builder
+public record OcrPassportResponse(
+        @Schema(description = "Full Name", example = "Hong Seungwon")
+        String fullName,
+
+        @Schema(description = "국가", example = "AFGHANISTAN")
+        Country country,
+
+        @Schema(description = "생년월일")
+        LocalDate birthDate
+) {
+   public static OcrPassportResponse from(PassportOcrParser.PassportInfo passportInfo) {
+           return OcrPassportResponse.builder()
+                   .fullName(passportInfo.fullName())
+                   .country(passportInfo.country())
+                   .birthDate(passportInfo.birthDate())
+                   .build();
+   }
+}

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

@@ -0,0 +1,29 @@
+package org.sopt.kareer.domain.member.dto.response;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Builder;
+import org.sopt.kareer.domain.member.entity.enums.VisaType;
+import org.sopt.kareer.domain.member.util.VisaOcrParser;
+
+import java.time.LocalDate;
+
+@Builder
+public record OcrVisaResponse(
+        @Schema(description = "비자 유형")
+        VisaType visaType,
+
+        @Schema(description = "비자 발급일")
+        LocalDate visaStartDate,
+
+        @Schema(description = "비자 만료일")
+        LocalDate visaExpiredAt
+){
+   public static OcrVisaResponse from(VisaOcrParser.VisaInfo visaInfo) {
+        return OcrVisaResponse.builder()
+                .visaType(visaInfo.visaType())
+                .visaStartDate(visaInfo.visaStartDate())
+                .visaExpiredAt(visaInfo.visaExpiredAt())
+                .build();
+   }
+}
+

src/main/java/org/sopt/kareer/domain/member/entity/enums/VisaType.java

@@ -12,4 +12,25 @@ public enum VisaType {
     ;
 
     private final String description;
+
+    public static VisaType from(String originalText) {
+        if (originalText == null || originalText.isBlank()) {
+            return null;
+        }
+
+        String normalized = normalize(originalText);
+
+        for (VisaType visaType : values()) {
+            if (normalize(visaType.name()).equals(normalized)
+                || normalize(visaType.description).equals(normalized)) {
+                return visaType;
+            }
+        }
+
+        return null;
+    }
+
+    private static String normalize(String value) {
+        return value.replaceAll("[^A-Za-z0-9]", "").toUpperCase();
+    }
 }

src/main/java/org/sopt/kareer/domain/member/service/MemberService.java

@@ -1,19 +1,29 @@
 package org.sopt.kareer.domain.member.service;
 
 import lombok.RequiredArgsConstructor;
-import org.sopt.kareer.domain.member.dto.request.*;
+import org.sopt.kareer.domain.member.dto.request.MemberOnboardRequest;
+import org.sopt.kareer.domain.member.dto.request.MemberOnboardV2Request;
 import org.sopt.kareer.domain.member.dto.response.*;
-import org.sopt.kareer.domain.member.entity.*;
+import org.sopt.kareer.domain.member.entity.Member;
+import org.sopt.kareer.domain.member.entity.MemberVisa;
 import org.sopt.kareer.domain.member.entity.enums.MemberStatus;
-import org.sopt.kareer.domain.member.exception.*;
-import org.sopt.kareer.domain.member.repository.*;
+import org.sopt.kareer.domain.member.exception.MemberErrorCode;
+import org.sopt.kareer.domain.member.exception.MemberException;
+import org.sopt.kareer.domain.member.repository.MemberRepository;
+import org.sopt.kareer.domain.member.repository.MemberVisaRepository;
 import org.sopt.kareer.domain.member.service.dto.request.MypageCommand;
+import org.sopt.kareer.domain.member.util.PassportOcrParser;
+import org.sopt.kareer.domain.member.util.VisaOcrParser;
+import org.sopt.kareer.global.document.exception.DocumentErrorCode;
+import org.sopt.kareer.global.document.exception.DocumentException;
+import org.sopt.kareer.global.document.service.DocumentProcessingService;
 import org.sopt.kareer.global.exception.customexception.GlobalException;
 import org.sopt.kareer.global.exception.errorcode.GlobalErrorCode;
 import org.sopt.kareer.global.oauth.dto.OAuthAttributes;
 import org.springframework.dao.DataIntegrityViolationException;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
+import org.springframework.web.multipart.MultipartFile;
 
 @Service
 @RequiredArgsConstructor
@@ -23,6 +33,9 @@ public class MemberService {
     private final MemberRepository memberRepository;
     private final MemberVisaRepository memberVisaRepository;
     private final MemberDeletionService memberDeletionService;
+    private final DocumentProcessingService documentProcessingService;
+    private final VisaOcrParser visaOcrParser;
+    private final PassportOcrParser passportOcrParser;
 
     public Member getById(Long memberId) {
         return memberRepository.findById(memberId)
@@ -166,4 +179,35 @@ public void deleteMember(Long memberId) {
         Member member = getById(memberId);
         memberDeletionService.deleteMember(member);
     }
+
+
+    public OcrVisaResponse getVisaOcr(MultipartFile file){
+        try {
+            String text = documentProcessingService.extractText(file);
+            VisaOcrParser.VisaInfo visaInfo = visaOcrParser.parse(text);
+
+            return OcrVisaResponse.from(visaInfo);
+        } catch (DocumentException e) {
+            throw e;
+        } catch(Exception e) {
+            throw new DocumentException(
+                    DocumentErrorCode.OCR_PROCESSING_FAILED
+            );
+        }
+    }
+
+    public OcrPassportResponse getPassportOcr(MultipartFile file) {
+        try {
+            String text = documentProcessingService.extractText(file);
+            PassportOcrParser.PassportInfo passportInfo = passportOcrParser.parse(text);
+
+            return OcrPassportResponse.from(passportInfo);
+        } catch (DocumentException e) {
+            throw e;
+        } catch(Exception e) {
+            throw new DocumentException(
+                    DocumentErrorCode.OCR_PROCESSING_FAILED
+            );
+        }
+    }
 }

src/main/java/org/sopt/kareer/domain/member/util/CountryResolver.java

@@ -0,0 +1,51 @@
+package org.sopt.kareer.domain.member.util;
+
+import org.sopt.kareer.domain.member.entity.enums.Country;
+import org.springframework.stereotype.Component;
+
+import java.util.HashMap;
+import java.util.Locale;
+import java.util.Map;
+
+@Component
+public class CountryResolver {
+
+    private final Map<String, Country> ISO3_MAP;
+
+    public CountryResolver() {
+        ISO3_MAP = buildIso3Map();
+    }
+
+    private Map<String, Country> buildIso3Map() {
+        Map<String, Country> map = new HashMap<>();
+
+        for (Country country : Country.values()) {
+            try {
+                Locale locale = findLocaleByCountryName(country.getCountryName());
+
+                if (locale != null) {
+                    String iso3 = locale.getISO3Country();
+                    map.put(iso3, country);
+                }
+
+            } catch (Exception ignored) {
+            }
+        }
+
+        return map;
+    }
+
+    private Locale findLocaleByCountryName(String countryName) {
+        for (Locale locale : Locale.getAvailableLocales()) {
+            if (countryName.equalsIgnoreCase(locale.getDisplayCountry(Locale.ENGLISH))) {
+                return locale;
+            }
+        }
+        return null;
+    }
+
+    public Country resolveIso3(String iso3) {
+        if (iso3 == null) return null;
+        return ISO3_MAP.get(iso3.toUpperCase());
+    }
+}