🚀 릴리즈: Staging to Main

src/main/java/com/springboot/api/common/config/security/SecurityConfig.java

@@ -64,7 +64,8 @@ public CorsConfigurationSource corsConfigurationSource() {
         configuration.setAllowCredentials(true);
         configuration.setExposedHeaders(
             List.of("Authorization", "Access-Token", "Uid", "Refresh-Token", "Access-Control-Expose-Headers",
-                "Upload-Offset, Location, Upload-Length, Tus-Version, Tus-Resumable, Tus-Max-Size, Tus-Extension, Upload-Metadata"));
+                "Upload-Offset", "Location", "Upload-Length", "Tus-Version", "Tus-Resumable", "Tus-Max-Size",
+                "Tus-Extension", "Upload-Metadata"));
         UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
         source.registerCorsConfiguration("/**", configuration);
         return source;

src/main/java/com/springboot/api/common/exception/NoContentException.java

@@ -2,13 +2,26 @@
 
 import com.springboot.api.common.message.ExceptionMessages;
 
+/**
+ * 콘텐츠가 없을 때 발생하는 예외
+ * 스택트레이스를 생성하지 않아 성능을 최적화하고 정확한 정보만 전달합니다.
+ */
 public class NoContentException extends RuntimeException {
 
     public NoContentException() {
-        super(ExceptionMessages.NO_CONTENT);
+        super(ExceptionMessages.NO_CONTENT, null, false, false);
     }
 
     public NoContentException(String message) {
-        super(message);
+        super(message, null, false, false);
+    }
+
+    /**
+     * 원인과 함께 예외를 생성하는 생성자
+     * @param message 예외 메시지
+     * @param cause 원인 예외
+     */
+    public NoContentException(String message, Throwable cause) {
+        super(message, cause, false, false);
     }
 }

src/main/java/com/springboot/api/common/util/AiResponseParseUtil.java

@@ -0,0 +1,88 @@
+package com.springboot.api.common.util;
+
+import java.util.Optional;
+
+import org.springframework.stereotype.Component;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import com.springboot.api.common.exception.NoContentException;
+
+import lombok.extern.slf4j.Slf4j;
+
+/**
+ * AI 응답 파싱을 위한 유틸리티 클래스
+ * ChatResponse JSON 구조에서 안전하게 데이터를 추출합니다.
+ */
+@Component
+@Slf4j
+public class AiResponseParseUtil {
+
+    private static final String RESULT_PATH = "result";
+    private static final String OUTPUT_PATH = "output";
+    private static final String TEXT_PATH = "text";
+
+    /**
+     * ChatResponse JsonNode에서 분석된 텍스트를 안전하게 추출합니다.
+     * 
+     * @param taResult ChatResponse가 JSON으로 변환된 JsonNode
+     * @return 분석된 텍스트
+     * @throws NoContentException taResult가 null이거나 텍스트를 찾을 수 없는 경우
+     */
+    public String extractAnalysedText(JsonNode taResult) {
+        if (taResult == null || taResult.isNull()) {
+            log.warn("taResult is null or empty");
+            throw new NoContentException();
+        }
+
+        return Optional.ofNullable(taResult.get(RESULT_PATH))
+            .map(result -> result.get(OUTPUT_PATH))
+            .map(output -> output.get(TEXT_PATH))
+            .filter(text -> !text.isNull())
+            .map(JsonNode::asText)
+            .filter(text -> !text.trim().isEmpty())
+            .orElseThrow(() -> {
+                log.warn("Failed to extract text from taResult: missing result.output.text path");
+                return new NoContentException();
+            });
+    }
+
+    /**
+     * ChatResponse JsonNode에서 분석된 텍스트를 안전하게 추출합니다. (Optional 반환)
+     * 
+     * @param taResult ChatResponse가 JSON으로 변환된 JsonNode
+     * @return 분석된 텍스트 Optional
+     */
+    public Optional<String> extractAnalysedTextSafely(JsonNode taResult) {
+        try {
+            return Optional.of(extractAnalysedText(taResult));
+        } catch (NoContentException e) {
+            log.debug("Could not extract analysed text from taResult", e);
+            return Optional.empty();
+        }
+    }
+
+    /**
+     * JsonNode가 유효한 AI 분석 결과인지 검증합니다.
+     * 
+     * @param taResult 검증할 JsonNode
+     * @return 유효한 AI 분석 결과인지 여부
+     */
+    public boolean isValidAiResponse(JsonNode taResult) {
+        if (taResult == null || taResult.isNull()) {
+            return false;
+        }
+
+        JsonNode result = taResult.get(RESULT_PATH);
+        if (result == null || result.isNull()) {
+            return false;
+        }
+
+        JsonNode output = result.get(OUTPUT_PATH);
+        if (output == null || output.isNull()) {
+            return false;
+        }
+
+        JsonNode text = output.get(TEXT_PATH);
+        return text != null && !text.isNull() && !text.asText().trim().isEmpty();
+    }
+} 

src/main/java/com/springboot/api/common/util/FileUtil.java

@@ -5,6 +5,7 @@
 import jakarta.validation.constraints.NotNull;
 import java.io.File;
 import java.io.IOException;
+import java.io.UncheckedIOException;
 import java.net.MalformedURLException;
 import java.nio.file.Files;
 import java.nio.file.Path;
@@ -14,6 +15,7 @@
 import lombok.RequiredArgsConstructor;
 import net.bramp.ffmpeg.FFmpeg;
 import net.bramp.ffmpeg.builder.FFmpegBuilder;
+import org.apache.commons.io.FileUtils;
 import org.slf4j.LoggerFactory;
 import org.springframework.core.io.Resource;
 import org.springframework.core.io.UrlResource;
@@ -121,4 +123,26 @@ public Resource getUrlResource(Path path) {
             throw new RuntimeException("잘못된 파일 경로: " + path, e);
         }
     }
+
+    public void deleteDirectory(String directoryPath) {
+        File directory = new File(directoryPath);
+
+        if (!directory.exists()) {
+            log.warn("삭제 시도한 디렉토리가 존재하지 않습니다: {}", directoryPath);
+            return;
+        }
+
+        if (!directory.isDirectory()) {
+            throw new IllegalArgumentException("경로가 디렉토리가 아닙니다: " + directoryPath);
+        }
+
+        try {
+            FileUtils.cleanDirectory(directory);
+            if (!directory.delete()) {
+                throw new IOException("디렉토리 삭제 실패: " + directoryPath);
+            }
+        } catch (IOException e) {
+            throw new UncheckedIOException("디렉토리 삭제 중 오류 발생", e);
+        }
+    }
 }

src/main/java/com/springboot/api/counselcard/controller/CounselCardController.java

@@ -1,13 +1,5 @@
 package com.springboot.api.counselcard.controller;
 
-import java.util.List;
-import org.springframework.http.ResponseEntity;
-import org.springframework.web.bind.annotation.DeleteMapping;
-import org.springframework.web.bind.annotation.GetMapping;
-import org.springframework.web.bind.annotation.PathVariable;
-import org.springframework.web.bind.annotation.PutMapping;
-import org.springframework.web.bind.annotation.RequestBody;
-import org.springframework.web.bind.annotation.RequestParam;
 import com.springboot.api.common.annotation.ApiController;
 import com.springboot.api.common.annotation.RoleSecured;
 import com.springboot.api.common.annotation.ValidEnum;
@@ -19,6 +11,10 @@
 import com.springboot.api.counselcard.dto.response.CounselCardIdRes;
 import com.springboot.api.counselcard.dto.response.CounselCardIndependentLifeInformationRes;
 import com.springboot.api.counselcard.dto.response.CounselCardLivingInformationRes;
+import com.springboot.api.counselcard.dto.response.MainCounselBaseInformationRes;
+import com.springboot.api.counselcard.dto.response.MainCounselHealthInformationRes;
+import com.springboot.api.counselcard.dto.response.MainCounselIndependentLifeInformationRes;
+import com.springboot.api.counselcard.dto.response.MainCounselLivingInformationRes;
 import com.springboot.api.counselcard.dto.response.TimeRecordedRes;
 import com.springboot.api.counselcard.service.CounselCardService;
 import com.springboot.enums.CounselCardRecordType;
@@ -27,7 +23,15 @@
 import jakarta.validation.Valid;
 import jakarta.validation.constraints.NotBlank;
 import jakarta.validation.constraints.Size;
+import java.util.List;
 import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestParam;
 
 @ApiController(path = "/v1/counsel/card", name = "CounselCardController", description = "상담카드 관련 API를 제공하는 Controller")
 @RequiredArgsConstructor
@@ -37,7 +41,7 @@ public class CounselCardController {
     private final CounselCardService counselCardService;
 
     @GetMapping("/{counselSessionId}/base-information")
-    @Operation(summary = "상담 카드 기본 정보 조회", tags = {"상담 카드 작성", "본상담 - 상담 카드"})
+    @Operation(summary = "기초 설문용 상담 카드 기본 정보 조회", tags = {"상담 카드 작성"})
     @RoleSecured({RoleType.ROLE_ASSISTANT, RoleType.ROLE_ADMIN, RoleType.ROLE_USER})
     ResponseEntity<CommonRes<CounselCardBaseInformationRes>> selectCounselCardBaseInformation(
         @PathVariable @NotBlank(message = "상담 세션 ID는 필수 입력값입니다") @Size(min = 26, max = 26, message = "상담 세션 ID는 26자여야 합니다") String counselSessionId) {
@@ -46,7 +50,7 @@ ResponseEntity<CommonRes<CounselCardBaseInformationRes>> selectCounselCardBaseIn
     }
 
     @GetMapping("/{counselSessionId}/health-information")
-    @Operation(summary = "상담 카드 건강 정보 조회", tags = {"상담 카드 작성", "본상담 - 상담 카드"})
+    @Operation(summary = "기초 설문용 상담 카드 건강 정보 조회", tags = {"상담 카드 작성"})
     @RoleSecured({RoleType.ROLE_ASSISTANT, RoleType.ROLE_ADMIN, RoleType.ROLE_USER})
     ResponseEntity<CommonRes<CounselCardHealthInformationRes>> selectCounselCardHealthInformation(
         @PathVariable @NotBlank(message = "상담 세션 ID는 필수 입력값입니다") @Size(min = 26, max = 26, message = "상담 세션 ID는 26자여야 합니다") String counselSessionId) {
@@ -55,7 +59,7 @@ ResponseEntity<CommonRes<CounselCardHealthInformationRes>> selectCounselCardHeal
     }
 
     @GetMapping("/{counselSessionId}/living-information")
-    @Operation(summary = "상담 카드 생활 정보 조회", tags = {"상담 카드 작성", "본상담 - 상담 카드"})
+    @Operation(summary = "기초 설문용 상담 카드 생활 정보 조회", tags = {"상담 카드 작성"})
     @RoleSecured({RoleType.ROLE_ASSISTANT, RoleType.ROLE_ADMIN, RoleType.ROLE_USER})
     ResponseEntity<CommonRes<CounselCardLivingInformationRes>> selectCounselCardLivingInformation(
         @PathVariable @NotBlank(message = "상담 세션 ID는 필수 입력값입니다") @Size(min = 26, max = 26, message = "상담 세션 ID는 26자여야 합니다") String counselSessionId) {
@@ -64,7 +68,7 @@ ResponseEntity<CommonRes<CounselCardLivingInformationRes>> selectCounselCardLivi
     }
 
     @GetMapping("/{counselSessionId}/independent-information")
-    @Operation(summary = "상담 카드 자립생활 역량 조회", tags = {"상담 카드 작성", "본상담 - 상담 카드"})
+    @Operation(summary = "기초 설문용 상담 카드 자립생활 역량 조회", tags = {"상담 카드 작성"})
     @RoleSecured({RoleType.ROLE_ASSISTANT, RoleType.ROLE_ADMIN, RoleType.ROLE_USER})
     ResponseEntity<CommonRes<CounselCardIndependentLifeInformationRes>> selectCounselCardIndependentLifeInformation(
         @PathVariable @NotBlank(message = "상담 세션 ID는 필수 입력값입니다") @Size(min = 26, max = 26, message = "상담 세션 ID는 26자여야 합니다") String counselSessionId) {
@@ -106,6 +110,7 @@ ResponseEntity<CommonRes<CounselCardIdRes>> deleteCounselCard(
             new CommonRes<>(counselCardService.deleteCounselCard(counselSessionId)));
     }
 
+    @Deprecated
     @GetMapping("/{counselSessionId}/previous/item/list")
     @Operation(summary = "이전 상담 카드 item 목록 조회", tags = {"본상담 - 상담 카드"})
     @RoleSecured({RoleType.ROLE_ASSISTANT, RoleType.ROLE_ADMIN, RoleType.ROLE_USER})
@@ -117,4 +122,45 @@ ResponseEntity<CommonRes<List<TimeRecordedRes<Object>>>> selectPreviousItemListB
             new CommonRes<>(
                 counselCardService.selectPreviousRecordsByType(counselSessionId, type)));
     }
+
+    @GetMapping("/main-counsel/{counselSessionId}/base-information")
+    @Operation(summary = "본 상담용 상담 카드 기본 정보 조회", tags = {"본상담 - 기초 설문"})
+    @RoleSecured({RoleType.ROLE_ASSISTANT, RoleType.ROLE_ADMIN, RoleType.ROLE_USER})
+    ResponseEntity<CommonRes<MainCounselBaseInformationRes>> selectMainCounselBaseInformation(
+        @PathVariable @NotBlank(message = "상담 세션 ID는 필수 입력값입니다") @Size(min = 26, max = 26, message = "상담 세션 ID는 26자여야 합니다") String counselSessionId) {
+
+        MainCounselBaseInformationRes mainCounselBaseInformationRes = counselCardService.selectMainCounselBaseInformation(
+            counselSessionId);
+
+        return ResponseEntity.ok(
+            new CommonRes<>(mainCounselBaseInformationRes));
+    }
+
+    @GetMapping("/main-counsel/{counselSessionId}/health-information")
+    @Operation(summary = "본 상담용 상담 카드 건강 정보 조회", tags = {"본상담 - 기초 설문"})
+    @RoleSecured({RoleType.ROLE_ASSISTANT, RoleType.ROLE_ADMIN, RoleType.ROLE_USER})
+    ResponseEntity<CommonRes<MainCounselHealthInformationRes>> selectMainCounselHealthInformation(
+        @PathVariable @NotBlank(message = "상담 세션 ID는 필수 입력값입니다") @Size(min = 26, max = 26, message = "상담 세션 ID는 26자여야 합니다") String counselSessionId) {
+        return ResponseEntity.ok(
+            new CommonRes<>(counselCardService.selectMainCounselHealthInformation(counselSessionId)));
+    }
+
+    @GetMapping("/main-counsel/{counselSessionId}/living-information")
+    @Operation(summary = "본 상담용 상담 카드 생활 정보 조회", tags = {"본상담 - 기초 설문"})
+    @RoleSecured({RoleType.ROLE_ASSISTANT, RoleType.ROLE_ADMIN, RoleType.ROLE_USER})
+    ResponseEntity<CommonRes<MainCounselLivingInformationRes>> selectMainCounselLivingInformation(
+        @PathVariable @NotBlank(message = "상담 세션 ID는 필수 입력값입니다") @Size(min = 26, max = 26, message = "상담 세션 ID는 26자여야 합니다") String counselSessionId) {
+        return ResponseEntity.ok(
+            new CommonRes<>(counselCardService.selectMainCounselLivingInformation(counselSessionId)));
+    }
+
+    @GetMapping("/main-counsel/{counselSessionId}/independent-information")
+    @Operation(summary = "본 상담용 상담 카드 자립생활 역량 조회", tags = {"본상담 - 기초 설문"})
+    @RoleSecured({RoleType.ROLE_ASSISTANT, RoleType.ROLE_ADMIN, RoleType.ROLE_USER})
+    ResponseEntity<CommonRes<MainCounselIndependentLifeInformationRes>> selectMainCounselIndependentLifeInformation(
+        @PathVariable @NotBlank(message = "상담 세션 ID는 필수 입력값입니다") @Size(min = 26, max = 26, message = "상담 세션 ID는 26자여야 합니다") String counselSessionId) {
+        return ResponseEntity.ok(
+            new CommonRes<>(
+                counselCardService.selectMainCounselIndependentLifeInformation(counselSessionId)));
+    }
 }

src/main/java/com/springboot/api/counselcard/dto/response/MainCounselBaseInformationRes.java

@@ -0,0 +1,14 @@
+package com.springboot.api.counselcard.dto.response;
+
+import com.springboot.enums.CounselPurposeType;
+import java.util.List;
+
+public record MainCounselBaseInformationRes(
+    MainCounselRecord<List<CounselPurposeType>> counselPurpose,
+    MainCounselRecord<String> significantNote,
+    MainCounselRecord<String> medicationNote
+) {
+
+}
+
+

src/main/java/com/springboot/api/counselcard/dto/response/MainCounselHealthInformationRes.java

@@ -0,0 +1,18 @@
+package com.springboot.api.counselcard.dto.response;
+
+import com.springboot.api.counselcard.dto.information.health.AllergyDTO;
+import com.springboot.api.counselcard.dto.information.health.MedicationSideEffectDTO;
+import com.springboot.enums.DiseaseType;
+import java.util.List;
+
+public record MainCounselHealthInformationRes(
+    MainCounselRecord<List<DiseaseType>> diseases,
+    MainCounselRecord<String> historyNote,
+    MainCounselRecord<String> mainInconvenienceNote,
+    MainCounselRecord<MedicationSideEffectDTO> medicationSideEffect,
+    MainCounselRecord<AllergyDTO> allergy
+) {
+
+}
+
+

src/main/java/com/springboot/api/counselcard/dto/response/MainCounselIndependentLifeInformationRes.java

@@ -0,0 +1,15 @@
+package com.springboot.api.counselcard.dto.response;
+
+import com.springboot.api.counselcard.dto.information.independentlife.CommunicationDTO;
+import com.springboot.api.counselcard.dto.information.independentlife.EvacuationDTO;
+import com.springboot.api.counselcard.dto.information.independentlife.WalkingDTO;
+
+public record MainCounselIndependentLifeInformationRes(
+    MainCounselRecord<CommunicationDTO> communication,
+    MainCounselRecord<EvacuationDTO> evacuation,
+    MainCounselRecord<WalkingDTO> walking
+) {
+
+}
+
+

src/main/java/com/springboot/api/counselcard/dto/response/MainCounselLivingInformationRes.java

@@ -0,0 +1,19 @@
+package com.springboot.api.counselcard.dto.response;
+
+import com.springboot.api.counselcard.dto.information.living.ExerciseDTO;
+import com.springboot.api.counselcard.dto.information.living.MedicationManagementDTO;
+import com.springboot.api.counselcard.dto.information.living.NutritionDTO;
+import com.springboot.api.counselcard.dto.information.living.SmokingDTO;
+import com.springboot.enums.DrinkingAmount;
+
+public record MainCounselLivingInformationRes(
+    MainCounselRecord<SmokingDTO> smoking,
+    MainCounselRecord<DrinkingAmount> drinkingAmount,
+    MainCounselRecord<ExerciseDTO> exercise,
+    MainCounselRecord<MedicationManagementDTO> medicationManagement,
+    MainCounselRecord<NutritionDTO> nutrition
+) {
+
+}
+
+

src/main/java/com/springboot/api/counselcard/dto/response/MainCounselRecord.java

@@ -0,0 +1,12 @@
+package com.springboot.api.counselcard.dto.response;
+
+import java.util.List;
+
+public record MainCounselRecord<T>(
+    T currentState,
+    List<TimeRecordedRes<T>> history
+) {
+
+}
+
+