pageInfo;\n\n";
+ }
+ } else if (pagingMode == PagingMode.SCROLL) {
+ excluded = Set.of("scrPageInfo");
+ if (!hasScrPageInfo) {
+ pagingImport = "import io.shinhanlife.glow.GlowTrgmField;\nimport io.shinhanlife.glow.db.dto.ScrPageInfo;\n";
+ pagingField = " @Schema(description = \"스크롤 페이지 정보\")\n @GlowTrgmField(order = 1, length = 306, description = \"스크롤 페이지 정보\")\n private ScrPageInfo scrPageInfo;\n\n";
+ }
+ }
+ }
return """
package %s.%s.io;
import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;
- %s%s
-
+ %s%s%s
@Data
public class %s {
- %s%s}
- """.formatted(BASE_PACKAGE, packageSuffix, listImport, patternImport, className, fieldLines(fields, Set.of(), className),
+ %s%s%s}
+ """.formatted(BASE_PACKAGE, packageSuffix, listImport, patternImport, pagingImport, className, pagingField, fieldLines(fields, excluded, className),
innerObjectListClasses(fields));
}
@@ -1834,7 +3117,8 @@ public class ToolScaffolder {
String httpResponseClass = baseName + "HttpResponse";
String httpClientClass = httpApiClass + "Client";
String clientVariable = Character.toLowerCase(httpClientClass.charAt(0)) + httpClientClass.substring(1);
- return """
+ String methodName = Character.toLowerCase(baseName.charAt(0)) + baseName.substring(1);
+ String result = """
package %s.usecase.impl;
import %s.converter.%sConverter;
@@ -1879,6 +3163,7 @@ public class ToolScaffolder {
baseName, baseName,
httpRequestClass, httpResponseClass, clientVariable, httpResponseClass,
baseName);
+ return result.replace("execute(", methodName + "(");
}
private static String httpClientContent(String httpPackage, String clientClass, String apiName) {
@@ -1936,9 +3221,10 @@ public class ToolScaffolder {
.replaceAll("^_+|_+$", "");
return normalized.isBlank() ? "http_api" : normalized;
}
- private static String mciConverterContent(String bizPackage, String baseName, String mciPackage, String interfaceId) {
+ private static String mciConverterContent(String converterPackage, String bizPackage, String baseName,
+ String mciPackage, String interfaceId, String converterClassName) {
return """
- package %s.converter;
+ package %s;
import %s.dto.%sRequest;
import %s.dto.%sResponse;
@@ -1949,16 +3235,27 @@ public class ToolScaffolder {
import org.mapstruct.ReportingPolicy;
@Mapper(componentModel = "spring", unmappedTargetPolicy = ReportingPolicy.IGNORE)
- public interface %sConverter {
+ public interface %s {
// Field names differ? Add mappings like this before the method.
// @Mapping(source = "sourceField", target = "targetField")
%s_I toLegacyRequest(%sRequest request);
+ default %s_I toRequest(%sRequest request) {
+ return toLegacyRequest(request);
+ }
%sRequest toRequest(%s_I mciRequest);
%sResponse toResponse(%s_O mciRes);
}
- """.formatted(bizPackage, bizPackage, baseName, bizPackage, baseName,
+ """.formatted(converterPackage, bizPackage, baseName, bizPackage, baseName,
BASE_PACKAGE, mciPackage, interfaceId, BASE_PACKAGE, mciPackage, interfaceId,
- baseName, interfaceId, baseName, baseName, interfaceId, baseName, interfaceId);
+ converterClassName, interfaceId, baseName, interfaceId, baseName, baseName, interfaceId, baseName, interfaceId);
+ }
+
+ private static String mciTargetSystemPackage(String clientSystemCode) {
+ if (clientSystemCode == null || clientSystemCode.length() != 9) {
+ return null;
+ }
+ String prefix = clientSystemCode.substring(1, 5).toLowerCase(Locale.ROOT);
+ return prefix.substring(0, 3) + "." + prefix.substring(3);
}
private static String legacyConverterContent(String bizPackage, String baseName) {
@@ -2006,10 +3303,10 @@ public class ToolScaffolder {
continue;
}
String type = javaFieldType(field, ownerClass);
- String description = richDescription(field).replace("\"", "\\\"");
+ String description = javaText(richDescription(field));
String example = "";
if (field.examples() != null && !field.examples().isEmpty()) {
- example = field.examples().get(0).replace("\"", "\\\"");
+ example = javaText(field.examples().get(0));
}
source.append(" @Schema(description = \"").append(description).append("\"");
if (!example.isEmpty()) {
@@ -2020,7 +3317,7 @@ public class ToolScaffolder {
}
source.append(")\n");
if (field.pattern() != null && !field.pattern().isBlank()) {
- source.append(" @Pattern(regexp = \"").append(field.pattern().replace("\"", "\\\"")).append("\")\n");
+ source.append(" @Pattern(regexp = \"").append(javaText(field.pattern())).append("\")\n");
}
source.append(" private ").append(type).append(' ').append(fieldName).append(";\n\n");
}
@@ -2032,9 +3329,6 @@ public class ToolScaffolder {
if (field.pattern() != null && !field.pattern().isBlank()) {
desc += " (형식: " + field.pattern() + ")";
}
- if (field.examples() != null && !field.examples().isEmpty()) {
- desc += " (예시: " + String.join(", ", field.examples()) + ")";
- }
return desc.trim();
}
@@ -2163,19 +3457,23 @@ public class ToolScaffolder {
action);
}
+ private static String abbreviatedMciSourceBaseName(String baseName) {
+ String[] words = baseName.split("(?<=[a-z])(?=[A-Z])|(?<=[A-Z])(?=[A-Z][a-z])");
+ if (words.length < 3) {
+ return baseName;
+ }
+ return abbreviatedWord(words[0], 4) + abbreviatedWord(words[1], 6);
+ }
+
+ private static String abbreviatedWord(String word, int maximumLength) {
+ int length = Math.min(word.length(), maximumLength);
+ return toPascalCase(word.substring(0, length).toLowerCase(Locale.ROOT));
+ }
+
private static String toPascalCase(String str) {
if (str == null || str.isEmpty()) {
return str;
}
-
- boolean hasLowercase = false;
- for (char c : str.toCharArray()) {
- if (Character.isLowerCase(c)) {
- hasLowercase = true;
- break;
- }
- }
-
StringBuilder result = new StringBuilder();
boolean capitalizeNext = true;
for (char c : str.toCharArray()) {
@@ -2185,7 +3483,7 @@ public class ToolScaffolder {
result.append(Character.toUpperCase(c));
capitalizeNext = false;
} else {
- result.append(hasLowercase ? c : Character.toLowerCase(c));
+ result.append(c);
}
}
if (result.length() > 0) {
diff --git a/dat-was-lib/src/main/resources/codes.csv b/dat-was-lib/src/main/resources/codes.csv
new file mode 100644
index 000000000..f268bc248
--- /dev/null
+++ b/dat-was-lib/src/main/resources/codes.csv
@@ -0,0 +1,17 @@
+그룹,코드,명칭
+COMPANY,005930,삼성전자
+COMPANY,035420,NAVER
+COMPANY,035720,카카오
+COMPANY,000660,SK하이닉스
+COMPANY,055550,신한지주
+COMPANY,086790,하나금융지주
+COMPANY,105560,KB금융
+COMPANY,316140,우리금융지주
+COMPANY,000810,삼성화재
+COMPANY,088350,한화생명
+COMPANY,005830,DB손해보험
+COMPANY,000030,우리은행
+STATUS,01,정상
+STATUS,02,비정상
+STATUS,03,해지
+STATUS,04,실효
\ No newline at end of file
diff --git a/dat-was-lib/src/test/java/io/shinhanlife/dat/lib/util/CommonCodeResolverTest.java b/dat-was-lib/src/test/java/io/shinhanlife/dat/lib/util/CommonCodeResolverTest.java
new file mode 100644
index 000000000..f16cbd45e
--- /dev/null
+++ b/dat-was-lib/src/test/java/io/shinhanlife/dat/lib/util/CommonCodeResolverTest.java
@@ -0,0 +1,62 @@
+package io.shinhanlife.dat.lib.util;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+import org.junit.jupiter.api.Test;
+
+/**
+ * @package io.shinhanlife.dat.lib.util
+ * @className CommonCodeResolverTest
+ * @description AX HUB 시스템 처리 클래스
+ * @author 0986406
+ * @create 2026.09.01
+ *
+ * ---------- 개정이력 ----------
+ * 수정일 수정자 수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01 0986406 최초생성
+ *
+ *
+ */
+class CommonCodeResolverTest {
+
+ @Test
+ void resolvesCompanyCodeFromExactName() {
+ assertEquals("005930", CommonCodeResolver.resolve("COMPANY", "삼성전자"));
+ assertEquals("035420", CommonCodeResolver.resolve("COMPANY", "NAVER"));
+ assertEquals("035720", CommonCodeResolver.resolve("COMPANY", "카카오"));
+ assertEquals("055550", CommonCodeResolver.resolve("COMPANY", "신한지주"));
+ }
+
+ @Test
+ void resolvesCompanyCodeWhenAlreadyCode() {
+ assertEquals("005930", CommonCodeResolver.resolve("COMPANY", "005930"));
+ assertEquals("035420", CommonCodeResolver.resolve("COMPANY", "035420"));
+ }
+
+ @Test
+ void resolvesCaseInsensitiveAndSpaceIgnored() {
+ assertEquals("035420", CommonCodeResolver.resolve("COMPANY", "naver"));
+ assertEquals("005930", CommonCodeResolver.resolve("COMPANY", "삼성 전자"));
+ }
+
+ @Test
+ void resolvesStatusGroupCode() {
+ assertEquals("01", CommonCodeResolver.resolve("STATUS", "정상"));
+ assertEquals("02", CommonCodeResolver.resolve("STATUS", "비정상"));
+ assertEquals("03", CommonCodeResolver.resolve("STATUS", "해지"));
+ assertEquals("01", CommonCodeResolver.resolve("STATUS", "01"));
+ }
+
+ @Test
+ void getsNameFromCode() {
+ assertEquals("삼성전자", CommonCodeResolver.getName("COMPANY", "005930"));
+ assertEquals("정상", CommonCodeResolver.getName("STATUS", "01"));
+ }
+
+ @Test
+ void returnsOriginalWhenNotFound() {
+ assertEquals("알수없는회사", CommonCodeResolver.resolve("COMPANY", "알수없는회사"));
+ assertEquals("99", CommonCodeResolver.resolve("STATUS", "99"));
+ }
+}
\ No newline at end of file
diff --git a/dat-was-pro/src/main/java/io/shinhanlife/dat/mcc/biz/pro/converter/RecruitmentFeeDisclosureDataConverter.java b/dat-was-pro/src/main/java/io/shinhanlife/dat/mcc/biz/pro/converter/RecruitmentFeeDisclosureDataConverter.java
index 2866e8598..c5b0c1f8b 100644
--- a/dat-was-pro/src/main/java/io/shinhanlife/dat/mcc/biz/pro/converter/RecruitmentFeeDisclosureDataConverter.java
+++ b/dat-was-pro/src/main/java/io/shinhanlife/dat/mcc/biz/pro/converter/RecruitmentFeeDisclosureDataConverter.java
@@ -1,5 +1,6 @@
package io.shinhanlife.dat.mcc.biz.pro.converter;
+import io.shinhanlife.dat.lib.util.CommonCodeResolver;
import io.shinhanlife.dat.mcc.biz.pro.dto.RecruitmentFeeDisclosureDataRequest;
import io.shinhanlife.dat.mcc.biz.pro.dto.RecruitmentFeeDisclosureDataResponse;
import io.shinhanlife.dat.mcc.infra.itrf.mci.nbt.i.io.ONBTI2370_I;
@@ -8,11 +9,30 @@ import org.mapstruct.Mapper;
import org.mapstruct.Mapping;
import org.mapstruct.ReportingPolicy;
+/**
+ * @package io.shinhanlife.dat.mcc.biz.pro.converter
+ * @className RecruitmentFeeDisclosureDataConverter
+ * @description AX HUB 시스템 처리 클래스
+ * @author 0986406
+ * @create 2026.09.01
+ *
+ * ---------- 개정이력 ----------
+ * 수정일 수정자 수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01 0986406 최초생성
+ *
+ *
+ */
@Mapper(componentModel = "spring", unmappedTargetPolicy = ReportingPolicy.IGNORE)
public interface RecruitmentFeeDisclosureDataConverter {
- // Field names differ? Add mappings like this before the method.
- // @Mapping(source = "sourceField", target = "targetField")
+
+ @Mapping(target = "companyCode", expression = "java(toCompanyCode(request.getCompanyCode()))")
ONBTI2370_I toLegacyRequest(RecruitmentFeeDisclosureDataRequest request);
+
+ default String toCompanyCode(String company) {
+ return CommonCodeResolver.resolve("COMPANY", company);
+ }
+
RecruitmentFeeDisclosureDataRequest toRequest(ONBTI2370_I mciRequest);
RecruitmentFeeDisclosureDataResponse toResponse(ONBTI2370_O mciRes);
}
diff --git a/dat-was-pro/src/main/java/io/shinhanlife/dat/mcc/biz/pro/dto/RecruitmentFeeDisclosureDataRequest.java b/dat-was-pro/src/main/java/io/shinhanlife/dat/mcc/biz/pro/dto/RecruitmentFeeDisclosureDataRequest.java
index f445b1098..fd8c633ac 100644
--- a/dat-was-pro/src/main/java/io/shinhanlife/dat/mcc/biz/pro/dto/RecruitmentFeeDisclosureDataRequest.java
+++ b/dat-was-pro/src/main/java/io/shinhanlife/dat/mcc/biz/pro/dto/RecruitmentFeeDisclosureDataRequest.java
@@ -6,11 +6,24 @@ import lombok.Data;
import jakarta.validation.constraints.Pattern;
+/**
+ * @package io.shinhanlife.dat.mcc.biz.pro.dto
+ * @className RecruitmentFeeDisclosureDataRequest
+ * @description AX HUB 시스템 처리 클래스
+ * @author 0986406
+ * @create 2026.09.01
+ *
+ * ---------- 개정이력 ----------
+ * 수정일 수정자 수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01 0986406 최초생성
+ *
+ *
+ */
@Data
@JsonInclude(JsonInclude.Include.NON_NULL)
public class RecruitmentFeeDisclosureDataRequest {
- @Schema(description = "조회할 회사의 코드 (형식: ^[0-9]{6}$) (예시: 005930, 035420)", example = "005930", requiredMode = Schema.RequiredMode.REQUIRED)
- @Pattern(regexp = "^[0-9]{6}$")
+ @Schema(description = "조회할 회사 코드 또는 회사명 (예시: 005930, 삼성전자, NAVER, 카카오)", example = "삼성전자", requiredMode = Schema.RequiredMode.REQUIRED)
private String companyCode;
@Schema(description = "조회할 연도 (형식: ^[0-9]{4}$) (예시: 2023, 2024)", example = "2023", requiredMode = Schema.RequiredMode.REQUIRED)
diff --git a/dat-was-pro/src/test/java/io/shinhanlife/dat/mcc/biz/pro/converter/RecruitmentFeeDisclosureDataConverterTest.java b/dat-was-pro/src/test/java/io/shinhanlife/dat/mcc/biz/pro/converter/RecruitmentFeeDisclosureDataConverterTest.java
new file mode 100644
index 000000000..09d94c701
--- /dev/null
+++ b/dat-was-pro/src/test/java/io/shinhanlife/dat/mcc/biz/pro/converter/RecruitmentFeeDisclosureDataConverterTest.java
@@ -0,0 +1,67 @@
+package io.shinhanlife.dat.mcc.biz.pro.converter;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+
+import io.shinhanlife.dat.mcc.biz.pro.dto.RecruitmentFeeDisclosureDataRequest;
+import io.shinhanlife.dat.mcc.infra.itrf.mci.nbt.i.io.ONBTI2370_I;
+import org.junit.jupiter.api.Test;
+import org.mapstruct.factory.Mappers;
+
+/**
+ * @package io.shinhanlife.dat.mcc.biz.pro.converter
+ * @className RecruitmentFeeDisclosureDataConverterTest
+ * @description AX HUB 시스템 처리 클래스
+ * @author 0986406
+ * @create 2026.09.01
+ *
+ * ---------- 개정이력 ----------
+ * 수정일 수정자 수정내용
+ * ---------- -------- ---------------------------
+ * 2026.09.01 0986406 최초생성
+ *
+ *
+ */
+class RecruitmentFeeDisclosureDataConverterTest {
+
+ private final RecruitmentFeeDisclosureDataConverter converter =
+ Mappers.getMapper(RecruitmentFeeDisclosureDataConverter.class);
+
+ @Test
+ void mapsCompanyNameToLegacyCompanyCode() {
+ RecruitmentFeeDisclosureDataRequest request = new RecruitmentFeeDisclosureDataRequest();
+ request.setCompanyCode("삼성전자");
+ request.setYear("2024");
+ request.setQuarter("1");
+
+ ONBTI2370_I legacyReq = converter.toLegacyRequest(request);
+
+ assertNotNull(legacyReq);
+ assertEquals("005930", legacyReq.getCompanyCode());
+ assertEquals("2024", legacyReq.getYear());
+ assertEquals("1", legacyReq.getQuarter());
+ }
+
+ @Test
+ void preservesCompanyCodeWhenAlreadyNumericCode() {
+ RecruitmentFeeDisclosureDataRequest request = new RecruitmentFeeDisclosureDataRequest();
+ request.setCompanyCode("035420");
+ request.setYear("2024");
+
+ ONBTI2370_I legacyReq = converter.toLegacyRequest(request);
+
+ assertNotNull(legacyReq);
+ assertEquals("035420", legacyReq.getCompanyCode());
+ }
+
+ @Test
+ void mapsNaverAndKakao() {
+ RecruitmentFeeDisclosureDataRequest requestNaver = new RecruitmentFeeDisclosureDataRequest();
+ requestNaver.setCompanyCode("NAVER");
+ assertEquals("035420", converter.toLegacyRequest(requestNaver).getCompanyCode());
+
+ RecruitmentFeeDisclosureDataRequest requestKakao = new RecruitmentFeeDisclosureDataRequest();
+ requestKakao.setCompanyCode("카카오");
+ assertEquals("035720", converter.toLegacyRequest(requestKakao).getCompanyCode());
+ }
+}
\ No newline at end of file