[RELEASE] dev → main (2026-01-21)

build.gradle

@@ -1,50 +1,59 @@
 plugins {
-	id 'java'
-	id 'org.springframework.boot' version '3.3.3'
-	id 'io.spring.dependency-management' version '1.1.6'
+    id 'java'
+    id 'org.springframework.boot' version '3.3.3'
+    id 'io.spring.dependency-management' version '1.1.6'
 }
 
 group = 'com.numberone'
 version = '0.0.1-SNAPSHOT'
 
 java {
-	toolchain {
-		languageVersion = JavaLanguageVersion.of(21)
-	}
+    toolchain {
+        languageVersion = JavaLanguageVersion.of(21)
+    }
 }
 
 repositories {
-	mavenCentral()
+    mavenCentral()
+}
+
+dependencyManagement {
+    imports {
+        mavenBom("org.springframework.cloud:spring-cloud-dependencies:2023.0.4")
+    }
 }
 
 dependencies {
 
-	// ====================================== prod ======================================
-	// lombok
-	compileOnly 'org.projectlombok:lombok'
-	annotationProcessor 'org.projectlombok:lombok'
-	annotationProcessor 'org.springframework.boot:spring-boot-configuration-processor'
+    // ====================================== prod ======================================
+    // lombok
+    compileOnly 'org.projectlombok:lombok'
+    annotationProcessor 'org.projectlombok:lombok'
+    annotationProcessor 'org.springframework.boot:spring-boot-configuration-processor'
+
+    // db
+    implementation 'org.springframework.boot:spring-boot-starter-data-jdbc'
+    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
+    implementation "com.mysql:mysql-connector-j"
 
-	// db
-	implementation 'org.springframework.boot:spring-boot-starter-data-jdbc'
-	implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
-	implementation "com.mysql:mysql-connector-j"
+    // web
+    implementation 'org.springframework.boot:spring-boot-starter-web'
+    implementation 'org.springframework.boot:spring-boot-starter-validation'
 
-	// web
-	implementation 'org.springframework.boot:spring-boot-starter-web'
-	implementation 'org.springframework.boot:spring-boot-starter-validation'
+    // open feign
+    implementation 'org.springframework.cloud:spring-cloud-starter-openfeign'
 
-	// swagger
-	implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.0.2'
+    // swagger
+    implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.0.2'
 
-	// ====================================== test ======================================
-	// spring
-	testImplementation 'org.springframework.boot:spring-boot-starter-test'
+    // ====================================== test ======================================
+    // spring
+    testImplementation 'org.springframework.boot:spring-boot-starter-test'
 
-	// junit
-	testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
+    // junit
+    testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
 }
 
 tasks.named('test') {
-	useJUnitPlatform()
+    useJUnitPlatform()
 }

src/main/java/com/numberone/daepiro/config/SwaggerConfig.java

@@ -30,7 +30,7 @@ public OpenAPI openAPI() {
 	public GroupedOpenApi readyToUseGroup() {
 		return GroupedOpenApi.builder()
 			.group("1) ready to use")
-			.pathsToMatch("")
+			.pathsToMatch("/api/v1/bbiyoung/**")
 			.build();
 	}
 

src/main/java/com/numberone/daepiro/config/WebConfig.java

@@ -0,0 +1,25 @@
+package com.numberone.daepiro.config;
+
+import java.util.List;
+
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.web.servlet.config.annotation.CorsRegistry;
+import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
+
+// TODO: Spring Security 넣을 때 방법 변경하기
+@Configuration
+public class WebConfig implements WebMvcConfigurer {
+
+	@Value("${cors.allowed-origins}")
+	private List<String> allowedOrigins;
+
+	@Override
+	public void addCorsMappings(CorsRegistry registry) {
+		registry.addMapping("/**")
+			.allowedOriginPatterns(allowedOrigins.toArray(String[]::new))
+			.allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS")
+			.allowedHeaders("*")
+			.allowCredentials(true);
+	}
+}

src/main/java/com/numberone/daepiro/config/feign/FeignConfig.java

@@ -0,0 +1,9 @@
+package com.numberone.daepiro.config.feign;
+
+import org.springframework.cloud.openfeign.EnableFeignClients;
+import org.springframework.context.annotation.Configuration;
+
+@Configuration
+@EnableFeignClients(basePackages = "com.numberone.daepiro")
+class FeignConfig {
+}

src/main/java/com/numberone/daepiro/config/feign/UpstageFeignConfig.java

@@ -0,0 +1,22 @@
+package com.numberone.daepiro.config.feign;
+
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+import feign.RequestInterceptor;
+
+@Configuration
+public class UpstageFeignConfig {
+
+	@Value("${upstage.api-key}")
+	private String apiKey;
+
+	@Bean
+	public RequestInterceptor authInterceptor() {
+		return template -> {
+			template.header("Authorization", "Bearer " + apiKey);
+			template.header("Content-Type", "application/json");
+		};
+	}
+}

src/main/java/com/numberone/daepiro/domain/bbiyong/ai/dto/response/EvaluationResponse.java

@@ -0,0 +1,17 @@
+package com.numberone.daepiro.domain.bbiyong.ai.dto.response;
+
+import java.util.List;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.numberone.daepiro.domain.bbiyong.dto.response.EvaluationItemResultResponse;
+
+public record EvaluationResponse(
+
+	@JsonProperty("total-score")
+	double totalScore,
+
+	@JsonProperty("item-scores")
+	List<EvaluationItemResultResponse> itemScores,
+	String comment
+) {
+}

src/main/java/com/numberone/daepiro/domain/bbiyong/ai/factory/EvaluationPromptFactory.java

@@ -0,0 +1,29 @@
+package com.numberone.daepiro.domain.bbiyong.ai.factory;
+
+import java.util.List;
+
+import com.numberone.daepiro.domain.bbiyong.ai.util.PromptBuilder;
+import com.numberone.daepiro.domain.bbiyong.dto.request.QAndARequest;
+import com.numberone.daepiro.domain.bbiyong.vo.EvaluationItemInfo;
+
+public final class EvaluationPromptFactory {
+
+	private EvaluationPromptFactory() {
+	}
+
+	public static String createSystemPrompt(
+		String situationTitle,
+		List<EvaluationItemInfo> evaluationItems
+	) {
+		return PromptBuilder.buildSystemPrompt(
+			situationTitle,
+			evaluationItems
+		);
+	}
+
+	public static String createUserPrompt(
+		List<QAndARequest> script
+	) {
+		return PromptBuilder.buildUserPrompt(script);
+	}
+}

src/main/java/com/numberone/daepiro/domain/bbiyong/ai/factory/JsonSchemaFactory.java

@@ -0,0 +1,39 @@
+package com.numberone.daepiro.domain.bbiyong.ai.factory;
+
+import java.util.List;
+import java.util.Map;
+
+import com.numberone.daepiro.global.feign.dto.request.UpstageChatRequest;
+
+public final class JsonSchemaFactory {
+	private JsonSchemaFactory() {
+	}
+
+	public static UpstageChatRequest.JsonSchema evaluationScript() {
+
+		Map<String, Object> properties = Map.of(
+			"total-score", Map.of("type", "number"),
+			"item-scores", Map.of(
+				"type", "array",
+				"items", Map.of(
+					"type", "object",
+					"properties", Map.of(
+						"title", Map.of("type", "string"),
+						"score", Map.of("type", "number")
+					),
+					"required", List.of("title", "score")
+				)
+			),
+			"comment", Map.of("type", "string")
+		);
+
+		return new UpstageChatRequest.JsonSchema(
+			"evaluation_result",
+			new UpstageChatRequest.Schema(
+				"object",
+				properties,
+				List.of("total-score", "item-scores", "comment")
+			)
+		);
+	}
+}

src/main/java/com/numberone/daepiro/domain/bbiyong/ai/mapper/EvaluationMapper.java

@@ -0,0 +1,34 @@
+package com.numberone.daepiro.domain.bbiyong.ai.mapper;
+
+import org.springframework.stereotype.Component;
+
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.numberone.daepiro.domain.bbiyong.ai.dto.response.EvaluationResponse;
+import com.numberone.daepiro.global.exception.CustomErrorContext;
+import com.numberone.daepiro.global.exception.CustomException;
+
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+
+@Slf4j
+@Component
+@RequiredArgsConstructor
+public class EvaluationMapper {
+
+	private final ObjectMapper objectMapper;
+
+	public EvaluationResponse fromJson(String content) {
+		try {
+			return objectMapper.readValue(content, EvaluationResponse.class);
+		} catch (JsonProcessingException e) {
+			log.error(
+				"[UPSTAGE JSON PARSING ERROR] content={}",
+				content,
+				e
+			);
+			throw new CustomException(CustomErrorContext.UNCAUGHT_ERROR);
+		}
+	}
+
+}

src/main/java/com/numberone/daepiro/domain/bbiyong/ai/util/PromptBuilder.java

@@ -0,0 +1,116 @@
+package com.numberone.daepiro.domain.bbiyong.ai.util;
+
+import java.util.List;
+
+import com.numberone.daepiro.domain.bbiyong.dto.request.QAndARequest;
+import com.numberone.daepiro.domain.bbiyong.vo.EvaluationItemInfo;
+
+public final class PromptBuilder {
+	private PromptBuilder() {
+	}
+
+	public static String buildSystemPrompt(
+		String situationTitle,
+		List<EvaluationItemInfo> evaluationItems
+	) {
+		return buildSystemRole()
+			+ buildSituation(situationTitle)
+			+ buildEvaluationCriteria(evaluationItems);
+	}
+
+	public static String buildUserPrompt(List<QAndARequest> script) {
+		StringBuilder sb = new StringBuilder();
+
+		sb.append("""
+			User Response:
+			"""
+		);
+		sb.append("\n\"\"\"\n");
+
+		for (QAndARequest qandA : script) {
+			sb.append(qandA.getQuestion())
+				.append("\n")
+				.append(qandA.getAnswer())
+				.append("\n\n");
+		}
+
+		sb.append("\"\"\"");
+
+		return sb.toString();
+	}
+
+	private static String buildSystemRole() {
+		return """
+			You are an AI evaluator responsible for assessing emergency call responses.
+
+			Your role is to objectively evaluate how appropriate and effective the user's response is,
+			based strictly on the provided situation and evaluation criteria.
+
+			You must follow these rules:
+
+			Evaluation rules:
+			- Evaluate each evaluation item independently.
+			- Do not invent new evaluation items.
+			- Do not omit any evaluation item.
+
+			- Each item score must be a real number between 0.0 and 1.0.
+			- An item score around 0.7 means the child mostly understood the concept.
+			- An item score around 0.9 means the child did well.
+			- An item score of 1.0 means the child did an excellent job.
+			- Avoid giving item scores below 0.4 unless the item was almost entirely missing.
+
+			- The totalScore must reflect the overall effort positively.
+			- Minor weaknesses in one or two items should not significantly reduce the totalScore.
+			- When most item scores are 0.6 or higher,
+			  the totalScore should generally fall in the 70–95 range.
+
+			Comment rules:
+			- Respond in Korean.
+			- The final comment must be a single warm, and encouraging sentence written for children.
+			- The comment should praise what the user did well and gently suggest one simple improvement.
+			- The tone must be kind, supportive, and reassuring, as if speaking to a child who tried their best.
+			- The comment must be 40 characters or fewer.
+			---
+			""";
+	}
+
+	private static String buildSituation(String situationTitle) {
+		return """
+			Situation:
+			- Title: %s
+
+			This situation assumes that the user is making an emergency report to a dispatcher.
+
+			---
+			""".formatted(situationTitle);
+	}
+
+	private static String buildEvaluationCriteria(
+		List<EvaluationItemInfo> evaluationItems
+	) {
+		StringBuilder sb = new StringBuilder("""
+			Evaluation Criteria:
+			The following items define what a good response means in this situation.
+			Each item includes a title and a description explaining how it should be evaluated.
+
+			""");
+
+		int index = 1;
+		for (EvaluationItemInfo item : evaluationItems) {
+			sb.append("""
+				%d. %s
+				Description:
+				%s
+
+				""".formatted(
+				index++,
+				item.title(),
+				item.description()
+			));
+		}
+
+		sb.append("---\n");
+		return sb.toString();
+	}
+
+}