[Feat] 시나리오 DTO작성

Author: johnbosco0414

.gitignore

@@ -4,4 +4,7 @@ db.txt
 log.txt
 
 # Claude Code
-CLAUDE.md
+CLAUDE.md
+
+# DB
+db_dev.mv.db

back/src/main/java/com/back/domain/scenario/dto/BaselineListResponse.java

@@ -0,0 +1,37 @@
+package com.back.domain.scenario.dto;
+
+import com.back.domain.node.entity.BaseLine;
+import io.swagger.v3.oas.annotations.media.Schema;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * 베이스라인 목록 조회 응답 DTO.
+ * 사용자의 현재 삶 시작점들을 목록으로 제공합니다.
+ */
+
+public record BaselineListResponse(
+        @Schema(description = "베이스라인 ID", example = "1001")
+        Long baselineId,
+
+        @Schema(description = "베이스라인 제목", example = "대학 졸업 후 진로 선택")
+        String title,
+
+        @Schema(description = "베이스라인 관련 태그", example = "[\"교육\", \"진로\", \"취업\"]")
+        List<String> tags,
+
+        @Schema(description = "베이스라인 생성일", example = "2024-09-17T14:30:00")
+        LocalDateTime createdDate
+) {
+    /**
+     * BaseLine 엔티티로부터 BaselineListResponse를 생성합니다.
+     * @param baseLine BaseLine 엔티티
+     * @param tags 관련 태그 목록
+     * @return BaselineListResponse
+     */
+
+    public static BaselineListResponse from(BaseLine baseLine, List<String> tags) {
+        throw new UnsupportedOperationException("구현 예정");
+    }
+}

back/src/main/java/com/back/domain/scenario/dto/ScenarioCompareResponse.java

@@ -0,0 +1,53 @@
+package com.back.domain.scenario.dto;
+
+import com.back.domain.scenario.entity.Scenario;
+import com.back.domain.scenario.entity.SceneCompare;
+import com.back.domain.scenario.entity.SceneType;
+import com.back.domain.scenario.entity.Type;
+import io.swagger.v3.oas.annotations.media.Schema;
+
+import java.util.List;
+
+/**                                                                                                                                                                                                                  │ │
+ * 두 시나리오 간의 비교 분석 결과를 담는 응답 DTO.                                                                                                                                                                  │ │
+ * 기준 시나리오와 비교 시나리오의 5개 지표별 점수 비교와 AI 분석 결과를 제공합니다.                                                                                                                                 │ ││ │
+ */
+
+public record ScenarioCompareResponse(
+        @Schema(description = "비교 기준이 되는 시나리오 ID", example = "1001")
+        Long baseScenarioId,
+
+        @Schema(description = "비교 대상 시나리오 ID", example = "1002")
+        Long compareScenarioId,
+
+        @Schema(description = "AI가 생성한 두 시나리오의 종합 비교 분석", example = "평행우주에서는 창업을 선택하여 더 높은 경제적 성과와 성취감을 얻었지만, 초기 불안정성과 스트레스가 증가했습니다. 전반적으로 위험을 감수한 만큼 더 큰 보상을 얻은 결과를 보여줍니다.")
+        String overallAnalysis,
+
+        @Schema(description = "5개 지표별 상세 비교 결과", example = "[{\"type\":\"경제\",\"baseScore\":65,\"compareScore\":85,\"analysis\":\"창업 성공으로 20점 향상\"}]")
+        List<IndicatorComparison> indicators
+) {
+
+    public record IndicatorComparison(
+            @Schema(description = "비교 지표 유형", example = "경제")
+            Type type,
+
+            @Schema(description = "기준 시나리오의 해당 지표 점수", example = "65")
+            int baseScore,
+
+            @Schema(description = "비교 시나리오의 해당 지표 점수", example = "85")
+            int compareScore,
+
+            @Schema(description = "해당 지표에 대한 AI 비교 분석", example = "창업 성공으로 인한 수익 증가와 자산 형성으로 경제 지표가 크게 향상되었습니다.")
+            String analysis
+    ) {}
+
+    public static ScenarioCompareResponse from(
+            Scenario baseScenario,
+            Scenario compareScenario,
+            List<SceneCompare> compareResults,
+            List<SceneType> baseIndicators,
+            List<SceneType> compareIndicators
+    ) {
+        throw new UnsupportedOperationException("구현 예정");
+    }
+}

back/src/main/java/com/back/domain/scenario/dto/ScenarioCreateRequest.java

@@ -0,0 +1,16 @@
+package com.back.domain.scenario.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+
+/**
+ * 시나리오 생성 요청 DTO.
+ * DecisionLine을 기반으로 AI 시나리오 생성을 요청합니다.
+ */
+
+public record ScenarioCreateRequest(
+        @Schema(description = "시나리오 생성의 기반이 될 대체선택 라인 ID", example = "1001")
+        @NotNull(message = "대체선택 라인 ID는 필수입니다.")
+        Long decisionLineId
+) {
+}

back/src/main/java/com/back/domain/scenario/dto/ScenarioDetailResponse.java

@@ -0,0 +1,41 @@
+package com.back.domain.scenario.dto;
+
+import com.back.domain.scenario.entity.ScenarioStatus;
+import io.swagger.v3.oas.annotations.media.Schema;
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * 시나리오 상세 조회 응답 DTO.
+ * AI가 생성한 시나리오의 모든 상세 정보와 5개 지표 분석 결과를 포함합니다.
+ */
+
+public record ScenarioDetailResponse(
+        @Schema(description = "시나리오 ID", example = "1001")
+        Long scenarioId,
+
+        @Schema(description = "시나리오 생성 상태", example = "COMPLETED")
+        ScenarioStatus status,
+
+        @Schema(description = "시나리오 최종 직업", example = "AI 연구원")
+        String job,
+
+        @Schema(description = "시나리오 지표 점수 총합", example = "500")
+        int total,
+
+        @Schema(description = "시나리오 결과 요약", example = "당신은 성공적인 AI 연구자가 되어 학계와 업계에서 인정받으며, 균형 잡힌 삶을 살고 있습니다.")
+        String summary,
+
+        @Schema(description = "시나리오 결과 상세", example = "10년 후, 당신은 세계적으로 인정받는 AI 연구소의 수석 연구원이 되었습니다. 혁신적인 연구 성과로 다수의 논문을 발표하며, 안정적인 수입과 함께 의미 있는 일을 하고 있습니다. 또한 규칙적인 운동과 취미 생활로 건강하고 행복한 일상을 유지하고 있습니다.")
+        String description,
+
+        @Schema(description = "시나리오 결과 이미지 URL", example = "https://example.com/scenario-images/successful-researcher.jpg")
+        String img,
+
+        @Schema(description = "시나리오 생성일자", example = "2024-01-15T14:30:00")
+        LocalDateTime createdDate,
+
+        @Schema(description = "시나리오 결과 지표 정보", example = "[{\"type\":\"경제\",\"point\":85,\"analysis\":\"안정적인 연구직 수입\"}, {\"type\":\"행복\",\"point\":90,\"analysis\":\"의미 있는 일을 통한 성취감\"}]")
+        List<ScenarioTypeDto> indicators
+) {
+}

back/src/main/java/com/back/domain/scenario/dto/ScenarioStatusResponse.java

@@ -0,0 +1,21 @@
+package com.back.domain.scenario.dto;
+
+import com.back.domain.scenario.entity.ScenarioStatus;
+import io.swagger.v3.oas.annotations.media.Schema;
+
+/**
+ * 시나리오 생성 상태 조회 응답 DTO.
+ * 폴링 방식의 실시간 상태 확인을 위한 경량화된 응답 구조입니다.
+ */
+
+public record ScenarioStatusResponse(
+        @Schema(description = "시나리오 ID", example = "1001")
+        Long scenarioId,
+
+        @Schema(description = "시나리오 생성 상태", example = "PROCESSING")
+        ScenarioStatus status,
+
+        @Schema(description = "상태별 안내 메시지", example = "AI가 대체선택 라인을 분석 중입니다...")
+        String message
+) {
+}

back/src/main/java/com/back/domain/scenario/dto/ScenarioTypeDto.java

@@ -0,0 +1,21 @@
+package com.back.domain.scenario.dto;
+
+import com.back.domain.scenario.entity.Type;
+import io.swagger.v3.oas.annotations.media.Schema;
+
+/**
+ * 시나리오 지표별 분석 결과 DTO.
+ * 경제, 행복, 관계, 직업, 건강 각 지표의 점수와 상세 분석을 포함합니다.
+ */
+
+public record ScenarioTypeDto(
+        @Schema(description = "시나리오 결과 지표 유형", example = "경제")
+        Type type,
+
+        @Schema(description = "시나리오 결과 지표 유형별 점수", example = "50")
+        int point,
+
+        @Schema(description = "시나리오 결과 지표 유형별 분석", example = "연구 성과로 인한 안정적인 수입과 지속적인 성장 기회를 확보했습니다.")
+        String analysis
+) {
+}

back/src/main/java/com/back/domain/scenario/dto/TimelineResponse.java

@@ -0,0 +1,38 @@
+package com.back.domain.scenario.dto;
+
+import com.back.domain.node.entity.DecisionNode;
+import io.swagger.v3.oas.annotations.media.Schema;
+import java.util.List;
+
+/**
+ * 시나리오의 타임라인 정보를 담는 응답 DTO.
+ * DecisionLine의 DecisionNode들을 시간순으로 정렬한 이벤트 목록을 제공합니다.
+ * 비교 화면에서는 이 API를 두 번 호출하여 클라이언트에서 조합합니다.
+ */
+
+public record TimelineResponse(
+        @Schema(description = "타임라인이 속한 시나리오 ID", example = "1001")
+        Long scenarioId,
+
+        @Schema(description = "시간순으로 정렬된 타임라인 이벤트 목록", example = "[{\\\"year\\\":2020,\\\"title\\\":\\\"창업 도전\\\"},{\\\"year\\\":2022,\\\"title\\\":\\\"해외 진출\\\"},{\\\"year\\\":2025,\\\"title\\\":\\\"상장 성공\\\"}]")
+        List<TimelineEvent> events
+) {
+    public record TimelineEvent(
+            @Schema(description = "이벤트 발생 연도", example = "2022")
+            int year,
+
+            @Schema(description = "AI가 생성한 이벤트 제목 (3-5단어)\", example = \"해외 진출 성공")
+            String title
+    ) {}
+
+    /**
+     * Scenario의 DecisionLine으로부터 TimelineResponse를 생성합니다.
+     * @param scenarioId 시나리오 ID
+     * @param decisionNodes DecisionLine의 DecisionNode 목록 (시간순 정렬됨)
+     * @return TimelineResponse
+     */
+
+    public static TimelineResponse from(Long scenarioId, List<DecisionNode> decisionNodes) {
+        throw new UnsupportedOperationException("구현 예정");
+    }
+}

back/src/main/java/com/back/domain/scenario/entity/Scenario.java

@@ -5,14 +5,9 @@
 import com.back.domain.user.entity.User;
 import com.back.global.baseentity.BaseEntity;
 import jakarta.persistence.*;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Getter;
-import lombok.NoArgsConstructor;
-import lombok.Setter;
+import lombok.*;
 import org.springframework.data.annotation.LastModifiedDate;
 
-import java.math.BigDecimal;
 import java.time.LocalDateTime;
 
 /**
@@ -49,7 +44,7 @@ public class Scenario extends BaseEntity {
 
     // 시나리오 상태 변경 시점 추적용
     @LastModifiedDate
-    private LocalDateTime updatedAt;
+    private LocalDateTime updatedDate;
 
     // 시나리오와 연결된 게시글 (시나리오 공유 시 생성)
     @ManyToOne(fetch = FetchType.LAZY)
@@ -61,7 +56,7 @@ public class Scenario extends BaseEntity {
     private String job;
 
     // 종합 점수 (5개 지표의 합계)
-    private BigDecimal total;
+    private int total;
 
     // AI가 생성한 시나리오 요약
     @Column(columnDefinition = "TEXT")