diff --git a/dap-gateway/src/main/java/io/shinhanlife/dap/mcg/presentation/ScaffoldingController.java b/dap-gateway/src/main/java/io/shinhanlife/dap/mcg/presentation/ScaffoldingController.java index 97816ea8..b53876b3 100644 --- a/dap-gateway/src/main/java/io/shinhanlife/dap/mcg/presentation/ScaffoldingController.java +++ b/dap-gateway/src/main/java/io/shinhanlife/dap/mcg/presentation/ScaffoldingController.java @@ -24,15 +24,37 @@ import java.io.File; import java.time.LocalDate; import java.time.format.DateTimeFormatter; import java.util.Arrays; +import java.util.LinkedHashSet; import java.util.List; +import java.util.Locale; import java.util.Map; +import java.util.Set; import java.util.stream.Collectors; +import org.springframework.ai.chat.client.ChatClient; +import org.springframework.http.ResponseEntity; import org.springframework.web.bind.annotation.*; @RestController @RequestMapping("/api/v1/scaffold") public class ScaffoldingController { + private static final Set SUPPORTED_FIELD_TYPES = Set.of( + "String", "Integer", "Long", "Double", "Boolean", "BigDecimal"); + private static final Set SUPPORTED_AI_MODELS = Set.of( + "inclusionai/ling-3.0-flash:free", + "openai/gpt-oss-20b:free", + "google/gemma-4-31b-it:free", + "nvidia/nemotron-3-nano-30b-a3b:free", + "cohere/north-mini-code:free"); + + private final ChatClient.Builder chatClientBuilder; + private final ObjectMapper objectMapper; + + public ScaffoldingController(ChatClient.Builder chatClientBuilder, ObjectMapper objectMapper) { + this.chatClientBuilder = chatClientBuilder; + this.objectMapper = objectMapper; + } + @PostMapping("/pod") public String scaffoldPod(@RequestBody Map req) { try { @@ -83,6 +105,78 @@ public class ScaffoldingController { } } + @PostMapping("/field-draft") + public ResponseEntity generateFieldDraft(@RequestBody Map req) { + String description = req.getOrDefault("description", "").trim(); + String target = req.getOrDefault("target", "inputFields"); + if (description.isBlank()) { + return ResponseEntity.badRequest().body(Map.of("error", "설명을 입력해주세요.")); + } + if (!"inputFields".equals(target) && !"outputFields".equals(target)) { + return ResponseEntity.badRequest().body(Map.of("error", "지원하지 않는 필드 대상입니다.")); + } + + try { + String targetLabel = "inputFields".equals(target) ? "INPUT request DTO" : "OUTPUT response DTO"; + String prompt = """ + Generate Java DTO fields for an MCP tool. + Return JSON only. Do not add Markdown, explanations, or code fences. + The response must have this exact shape: + {"fields":[{"name":"camelCaseName","type":"String","description":"short description","example":"example","required":true}]} + Allowed type values: String, Integer, Long, Double, Boolean, BigDecimal. + Generate fields only for the requested target: %s. + For OUTPUT fields, include resultCode and resultMessage when appropriate. + Keep field names valid Java camelCase identifiers. Generate at most 10 fields. + User description: %s + """.formatted(targetLabel, description); + + String response = generateAiContent(prompt, req.get("model")); + FieldDraft draft = objectMapper.readValue(stripCodeFence(response), FieldDraft.class); + List fields = validateFields(draft.fields()); + return ResponseEntity.ok(Map.of("fields", fields)); + } catch (Exception e) { + return ResponseEntity.internalServerError().body(Map.of("error", "AI 초안 생성 실패: " + safeMessage(e))); + } + } + + @PostMapping("/tool-draft") + public ResponseEntity generateToolDraft(@RequestBody Map req) { + String description = req.getOrDefault("description", "").trim(); + if (description.isBlank()) { + return ResponseEntity.badRequest().body(Map.of("error", "Tool 설명을 입력해주세요.")); + } + + try { + String prompt = """ + Generate an MCP Tool scaffold from the user request. + Return JSON only. Do not add Markdown, explanations, or code fences. + The response must have this exact shape: + {"baseName":"PascalCaseName","title":"short Korean title","description":"clear Korean LLM tool guidance","categoryKey":"cmm","routingType":"HTTP","httpApiName":"simple-api-name","inputFields":[{"name":"camelCaseName","type":"String","description":"short description","example":"example","required":true}],"outputFields":[{"name":"resultCode","type":"String","description":"result code","example":"SUCCESS","required":true}]} + categoryKey must be exactly three lowercase letters or digits. + routingType must be either HTTP or MCI. httpApiName can contain only letters, digits, hyphens, and underscores. + Allowed field type values: String, Integer, Long, Double, Boolean, BigDecimal. + Keep all field names valid Java camelCase identifiers. Generate at most 10 fields per list. + Do not generate interfaceId or clientSystemCode; those must come from a real integration contract. + User request: %s + """.formatted(description); + + String response = generateAiContent(prompt, req.get("model")); + ToolDraft draft = objectMapper.readValue(stripCodeFence(response), ToolDraft.class); + ToolDraft validatedDraft = validateToolDraft(draft); + return ResponseEntity.ok(Map.of( + "baseName", validatedDraft.baseName(), + "title", validatedDraft.title(), + "description", validatedDraft.description(), + "categoryKey", validatedDraft.categoryKey(), + "routingType", validatedDraft.routingType(), + "httpApiName", validatedDraft.httpApiName(), + "inputFields", validatedDraft.inputFields(), + "outputFields", validatedDraft.outputFields())); + } catch (Exception e) { + return ResponseEntity.internalServerError().body(Map.of("error", "AI Tool 초안 생성 실패: " + safeMessage(e))); + } + } + @PostMapping("/tool/update") public String updateTool(@RequestBody Map req) { try { @@ -122,6 +216,97 @@ public class ScaffoldingController { if (source == null || source.isBlank()) { return List.of(); } - return new ObjectMapper().readValue(source, new TypeReference>() { }); + return objectMapper.readValue(source, new TypeReference>() { }); + } + + private List validateFields(List source) { + if (source == null || source.isEmpty()) { + throw new IllegalArgumentException("AI가 필드를 생성하지 않았습니다."); + } + Set names = new LinkedHashSet<>(); + return source.stream() + .limit(10) + .filter(field -> field != null && field.name() != null && !field.name().isBlank()) + .map(field -> new ToolScaffolder.FieldDefinition( + field.name().trim(), + field.type() == null ? "String" : field.type().trim(), + field.description() == null ? "" : field.description().trim(), + field.example() == null ? "" : field.example().trim(), + field.required())) + .peek(field -> { + if (!field.name().matches("^[A-Za-z_$][A-Za-z0-9_$]*$")) { + throw new IllegalArgumentException("AI가 올바르지 않은 필드명을 생성했습니다: " + field.name()); + } + if (!SUPPORTED_FIELD_TYPES.contains(field.type())) { + throw new IllegalArgumentException("AI가 지원하지 않는 Type을 생성했습니다: " + field.type()); + } + if (!names.add(field.name())) { + throw new IllegalArgumentException("AI가 중복 필드명을 생성했습니다: " + field.name()); + } + }) + .toList(); + } + + private ToolDraft validateToolDraft(ToolDraft draft) { + if (draft == null || draft.baseName() == null || !draft.baseName().trim().matches("^[A-Z][A-Za-z0-9]*$")) { + throw new IllegalArgumentException("AI가 올바르지 않은 Base Name을 생성했습니다."); + } + String categoryKey = draft.categoryKey() == null ? "" : draft.categoryKey().trim().toLowerCase(Locale.ROOT); + if (!categoryKey.matches("^[a-z0-9]{3}$")) { + throw new IllegalArgumentException("AI가 올바르지 않은 Category Key를 생성했습니다."); + } + String routingType = draft.routingType() == null ? "" : draft.routingType().trim().toUpperCase(Locale.ROOT); + if (!Set.of("HTTP", "MCI").contains(routingType)) { + throw new IllegalArgumentException("AI가 지원하지 않는 Protocol을 생성했습니다."); + } + String httpApiName = draft.httpApiName() == null ? "sample" : draft.httpApiName().trim(); + if (!httpApiName.matches("^[A-Za-z0-9_-]+$")) { + throw new IllegalArgumentException("AI가 올바르지 않은 HTTP API Name을 생성했습니다."); + } + String title = draft.title() == null ? "" : draft.title().trim(); + String description = draft.description() == null ? "" : draft.description().trim(); + if (title.isBlank() || description.isBlank()) { + throw new IllegalArgumentException("AI가 Tool 제목 또는 설명을 생성하지 않았습니다."); + } + return new ToolDraft(draft.baseName().trim(), title, description, categoryKey, routingType, httpApiName, + validateFields(draft.inputFields()), validateFields(draft.outputFields())); + } + + private String generateAiContent(String prompt, String requestedModel) { + return chatClientBuilder.build().prompt() + .user(prompt) + .options(org.springframework.ai.openai.OpenAiChatOptions.builder() + .model(resolveModel(requestedModel)) + .build()) + .call() + .content(); + } + + private String resolveModel(String requestedModel) { + String model = requestedModel == null || requestedModel.isBlank() + ? "cohere/north-mini-code:free" : requestedModel.trim(); + if (!SUPPORTED_AI_MODELS.contains(model)) { + throw new IllegalArgumentException("지원하지 않는 AI 모델입니다."); + } + return model; + } + + private String stripCodeFence(String response) { + if (response == null) { + throw new IllegalArgumentException("AI 응답이 비어 있습니다."); + } + return response.trim().replaceFirst("^```(?:json)?\\s*", "").replaceFirst("\\s*```$", "").trim(); + } + + private String safeMessage(Exception e) { + return e.getMessage() == null ? e.getClass().getSimpleName() : e.getMessage(); + } + + private record FieldDraft(List fields) { + } + + private record ToolDraft(String baseName, String title, String description, String categoryKey, String routingType, + String httpApiName, List inputFields, + List outputFields) { } } diff --git a/dap-gateway/src/main/resources/static/admin/scaffold.html b/dap-gateway/src/main/resources/static/admin/scaffold.html index 9e2eb79d..9cf624dd 100644 --- a/dap-gateway/src/main/resources/static/admin/scaffold.html +++ b/dap-gateway/src/main/resources/static/admin/scaffold.html @@ -444,6 +444,27 @@
+
+ +
+
+ +
+
+ +
+
+ +
+
+
선택한 AI가 Tool 기본 정보와 Input/Output Fields를 채웁니다. Legacy Interface ID와 Client System Code는 실제 연계 명세를 확인해 직접 입력하세요.
+
@@ -482,11 +503,10 @@
- +
@@ -627,6 +647,22 @@

행을 추가해 필드를 입력하면 저장할 때 JSON으로 자동 변환됩니다.

+
+ 빠른 입력: + + + + + +
+
+ +
+ + +
+
Chat 화면과 같은 AI 모델이 문장을 분석해 현재 Input 또는 Output 필드 초안을 만듭니다.
+
@@ -643,6 +679,10 @@
+
+ + 

+        

       

       

         
@@ -784,6 +824,53 @@
     }
 
     const fieldTypes = ['String', 'Integer', 'Long', 'Double', 'Boolean', 'BigDecimal'];
+    const typeExamples = {
+        String: 'example',
+        Integer: '1',
+        Long: '1',
+        Double: '1.0',
+        Boolean: 'true',
+        BigDecimal: '1000.00'
+    };
+    const fieldTemplates = {
+        customer: {
+            inputFields: [
+                { name: 'customerId', type: 'String', description: 'Customer identifier', example: 'CUST00001', required: true }
+            ],
+            outputFields: [
+                { name: 'customerId', type: 'String', description: 'Customer identifier', example: 'CUST00001', required: true },
+                { name: 'customerName', type: 'String', description: 'Customer name', example: 'Hong Gildong', required: false }
+            ]
+        },
+        list: {
+            inputFields: [
+                { name: 'page', type: 'Integer', description: 'Page number', example: '1', required: false },
+                { name: 'pageSize', type: 'Integer', description: 'Items per page', example: '20', required: false }
+            ],
+            outputFields: [
+                { name: 'totalCount', type: 'Long', description: 'Total result count', example: '100', required: false }
+            ]
+        },
+        detail: {
+            inputFields: [
+                { name: 'id', type: 'String', description: 'Item identifier', example: 'ID00001', required: true }
+            ],
+            outputFields: [
+                { name: 'resultCode', type: 'String', description: 'Result code', example: 'SUCCESS', required: true },
+                { name: 'resultMessage', type: 'String', description: 'Result message', example: 'Completed', required: false }
+            ]
+        },
+        write: {
+            inputFields: [
+                { name: 'requestId', type: 'String', description: 'Request identifier', example: 'REQ00001', required: true },
+                { name: 'requestType', type: 'String', description: 'Registration or update type', example: 'CREATE', required: true }
+            ],
+            outputFields: [
+                { name: 'resultCode', type: 'String', description: 'Result code', example: 'SUCCESS', required: true },
+                { name: 'resultMessage', type: 'String', description: 'Result message', example: 'Completed', required: false }
+            ]
+        }
+    };
     let fieldEditorTargetId = null;
     let fieldEditorModalInstance = null;
 
@@ -807,6 +894,7 @@
         const body = document.getElementById('fieldEditorBody');
         body.replaceChildren();
         (fields.length ? fields : [{}]).forEach(addFieldEditorRow);
+        updateFieldEditorPreview();
 
         if (!fieldEditorModalInstance) {
             fieldEditorModalInstance = new bootstrap.Modal(document.getElementById('fieldEditorModal'));
@@ -838,6 +926,12 @@
             const option = new Option(type, type, false, (field.type || 'String') === type);
             typeSelect.add(option);
         });
+        typeSelect.addEventListener('change', () => {
+            if (!exampleInput.value.trim()) {
+                exampleInput.value = typeExamples[typeSelect.value];
+            }
+            updateFieldEditorPreview();
+        });
 
         const requiredSelect = document.createElement('select');
         requiredSelect.className = 'form-select form-select-sm';
@@ -845,6 +939,11 @@
         requiredSelect.add(new Option('Required', 'true', false, field.required === true || field.required === 'true'));
         requiredSelect.add(new Option('Optional', 'false', false, !(field.required === true || field.required === 'true')));
 
+        [nameInput, descriptionInput, exampleInput, requiredSelect].forEach(control => {
+            control.addEventListener('input', updateFieldEditorPreview);
+            control.addEventListener('change', updateFieldEditorPreview);
+        });
+
         [nameInput, typeSelect, descriptionInput, exampleInput, requiredSelect].forEach(control => {
             const cell = document.createElement('td');
             cell.appendChild(control);
@@ -855,19 +954,122 @@
         deleteButton.type = 'button';
         deleteButton.className = 'btn-secondary-action';
         deleteButton.textContent = '삭제';
-        deleteButton.addEventListener('click', () => row.remove());
+        deleteButton.addEventListener('click', () => {
+            row.remove();
+            updateFieldEditorPreview();
+        });
         deleteCell.appendChild(deleteButton);
         row.appendChild(deleteCell);
         document.getElementById('fieldEditorBody').appendChild(row);
+        updateFieldEditorPreview();
+    }
+
+    function currentEditorFields() {
+        return [...document.querySelectorAll('#fieldEditorBody tr')]
+            .map(row => ({
+                name: row.querySelector('[data-field="name"]').value.trim(),
+                type: row.querySelector('[data-field="type"]').value,
+                description: row.querySelector('[data-field="description"]').value.trim(),
+                example: row.querySelector('[data-field="example"]').value.trim(),
+                required: row.querySelector('[data-field="required"]').value === 'true'
+            }))
+            .filter(field => field.name);
+    }
+
+    function updateFieldEditorPreview() {
+        const preview = document.getElementById('fieldEditorPreview');
+        if (preview) preview.textContent = JSON.stringify(currentEditorFields(), null, 2);
+    }
+
+    function applyFieldTemplate(templateName) {
+        const body = document.getElementById('fieldEditorBody');
+        body.replaceChildren();
+        const fields = templateName === 'clear'
+            ? [{}]
+            : (fieldTemplates[templateName]?.[fieldEditorTargetId] || []);
+        (fields.length ? fields : [{}]).forEach(addFieldEditorRow);
+        updateFieldEditorPreview();
+    }
+
+    async function createNaturalFieldDraft() {
+        const source = document.getElementById('fieldNaturalLanguage').value.trim();
+        if (!source) {
+            alert('필드 초안을 만들 문장을 입력해주세요.');
+            return;
+        }
+        const button = document.getElementById('fieldDraftButton');
+        const originalLabel = button.textContent;
+        button.textContent = 'AI 생성 중...';
+        button.disabled = true;
+        try {
+            const response = await fetch('/api/v1/scaffold/field-draft', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ description: source, target: fieldEditorTargetId, model: selectedAiModel() })
+            });
+            const result = await response.json();
+            if (!response.ok) throw new Error(result.error || 'AI 초안 생성에 실패했습니다.');
+            if (!Array.isArray(result.fields) || result.fields.length === 0) {
+                throw new Error('AI가 사용할 수 있는 필드를 만들지 못했습니다.');
+            }
+            const body = document.getElementById('fieldEditorBody');
+            body.replaceChildren();
+            result.fields.forEach(addFieldEditorRow);
+            updateFieldEditorPreview();
+        } catch (error) {
+            alert(`AI 초안 생성 실패: ${error.message}`);
+        } finally {
+            button.textContent = originalLabel;
+            button.disabled = false;
+        }
+    }
+
+    function selectedAiModel() {
+        return document.getElementById('aiModelSelect').value;
+    }
+
+    async function createAiToolDraft() {
+        const source = document.getElementById('toolNaturalLanguage').value.trim();
+        if (!source) {
+            alert('AI가 만들 Tool 설명을 입력해주세요.');
+            return;
+        }
+        const button = document.getElementById('toolDraftButton');
+        const originalLabel = button.textContent;
+        button.textContent = 'AI 생성 중...';
+        button.disabled = true;
+        try {
+            const response = await fetch('/api/v1/scaffold/tool-draft', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ description: source, model: selectedAiModel() })
+            });
+            const result = await response.json();
+            if (!response.ok) throw new Error(result.error || 'AI Tool 초안 생성에 실패했습니다.');
+
+            const form = document.getElementById('toolForm');
+            form.elements.baseName.value = result.baseName || '';
+            form.elements.title.value = result.title || '';
+            form.elements.description.value = result.description || '';
+            form.elements.categoryKey.value = result.categoryKey || '';
+            form.elements.routingType.value = result.routingType || 'HTTP';
+            form.elements.httpApiName.value = result.httpApiName || 'sample';
+            document.getElementById('inputFields').value = JSON.stringify(result.inputFields || [], null, 2);
+            document.getElementById('outputFields').value = JSON.stringify(result.outputFields || [], null, 2);
+            alert('Tool 초안을 채웠습니다. Legacy Interface ID와 Client System Code는 실제 연계 명세를 확인해 입력해주세요.');
+        } catch (error) {
+            alert(`AI Tool 초안 생성 실패: ${error.message}`);
+        } finally {
+            button.textContent = originalLabel;
+            button.disabled = false;
+        }
     }
 
     function applyFieldEditor() {
-        const rows = [...document.querySelectorAll('#fieldEditorBody tr')];
         const names = new Set();
-        const fields = [];
-        for (const row of rows) {
-            const name = row.querySelector('[data-field="name"]').value.trim();
-            if (!name) continue;
+        const fields = currentEditorFields();
+        for (const field of fields) {
+            const name = field.name;
             if (!/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name)) {
                 alert(`필드명 "${name}"은(는) Java 필드명 형식으로 입력해주세요.`);
                 return;
@@ -877,13 +1079,6 @@
                 return;
             }
             names.add(name);
-            fields.push({
-                name,
-                type: row.querySelector('[data-field="type"]').value,
-                description: row.querySelector('[data-field="description"]').value.trim(),
-                example: row.querySelector('[data-field="example"]').value.trim(),
-                required: row.querySelector('[data-field="required"]').value === 'true'
-            });
         }
         document.getElementById(fieldEditorTargetId).value = JSON.stringify(fields, null, 2);
         fieldEditorModalInstance.hide();
diff --git a/dap-gateway/src/test/java/io/shinhanlife/dap/mcg/presentation/ScaffoldingControllerToolDraftTest.java b/dap-gateway/src/test/java/io/shinhanlife/dap/mcg/presentation/ScaffoldingControllerToolDraftTest.java
new file mode 100644
index 00000000..375387ae
--- /dev/null
+++ b/dap-gateway/src/test/java/io/shinhanlife/dap/mcg/presentation/ScaffoldingControllerToolDraftTest.java
@@ -0,0 +1,48 @@
+package io.shinhanlife.dap.mcg.presentation;
+
+import com.fasterxml.jackson.databind.ObjectMapper;
+import org.junit.jupiter.api.Test;
+import org.springframework.ai.chat.client.ChatClient;
+import org.springframework.ai.chat.prompt.ChatOptions;
+import org.springframework.http.MediaType;
+import org.springframework.http.converter.json.MappingJackson2HttpMessageConverter;
+import org.springframework.test.web.servlet.MockMvc;
+import org.springframework.test.web.servlet.setup.MockMvcBuilders;
+
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.anyString;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.when;
+import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
+
+class ScaffoldingControllerToolDraftTest {
+
+    @Test
+    void toolDraftEndpointIsAvailable() throws Exception {
+        ChatClient.Builder builder = mock(ChatClient.Builder.class);
+        ChatClient chatClient = mock(ChatClient.class);
+        ChatClient.ChatClientRequestSpec requestSpec = mock(ChatClient.ChatClientRequestSpec.class);
+        ChatClient.CallResponseSpec responseSpec = mock(ChatClient.CallResponseSpec.class);
+        when(builder.build()).thenReturn(chatClient);
+        when(chatClient.prompt()).thenReturn(requestSpec);
+        when(requestSpec.user(anyString())).thenReturn(requestSpec);
+        when(requestSpec.options(any(ChatOptions.class))).thenReturn(requestSpec);
+        when(requestSpec.call()).thenReturn(responseSpec);
+        when(responseSpec.content()).thenReturn("""
+                {"baseName":"CustomerContractStatus","title":"계약 상태 조회","description":"고객번호로 계약 상태를 조회합니다.","categoryKey":"cmm","routingType":"HTTP","httpApiName":"contract-status","inputFields":[{"name":"customerId","type":"String","description":"고객번호","example":"C123","required":true}],"outputFields":[{"name":"resultCode","type":"String","description":"결과 코드","example":"SUCCESS","required":true}]}
+                """);
+        MockMvc mockMvc = MockMvcBuilders.standaloneSetup(
+                new ScaffoldingController(builder, new ObjectMapper()))
+                .setMessageConverters(new MappingJackson2HttpMessageConverter())
+                .build();
+
+        mockMvc.perform(post("/api/v1/scaffold/tool-draft")
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .content("{\"description\":\"고객번호로 계약 상태를 조회\"}"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.baseName").value("CustomerContractStatus"))
+                .andExpect(jsonPath("$.inputFields[0].name").value("customerId"));
+    }
+}