From 8a918b976dc54157a8cc264ba11fa2961a64fce7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B9=80=ED=83=9C=ED=98=84?= <xogusrla7@gmail.com>
Date: Fri, 26 Sep 2025 13:48:22 +0900
Subject: [PATCH 01/12] =?UTF-8?q?chore:=20JobMapper=20=EB=A9=94=EC=84=9C?=
 =?UTF-8?q?=EB=93=9C=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../java/site/icebang/domain/workflow/mapper/JobMapper.java    | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/mapper/JobMapper.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/mapper/JobMapper.java
index e03ac06d..8e2c53a0 100644
--- a/apps/user-service/src/main/java/site/icebang/domain/workflow/mapper/JobMapper.java
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/mapper/JobMapper.java
@@ -12,4 +12,7 @@ public interface JobMapper {
   List<JobDto> findJobsByWorkflowId(Long workflowId);
 
   List<TaskDto> findTasksByJobId(Long jobId);
+
+  JobDto findJobById(Long id);
+  void insertJob(JobDto job);
 }

From 0dc53d561191f81cc6c07ded9417076b896cdf88 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B9=80=ED=83=9C=ED=98=84?= <xogusrla7@gmail.com>
Date: Fri, 26 Sep 2025 14:37:06 +0900
Subject: [PATCH 02/12] =?UTF-8?q?feat:=20Job=20=EC=83=9D=EC=84=B1=20?=
 =?UTF-8?q?=EC=A1=B0=ED=9A=8C=20=EC=B4=88=EC=95=88?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../workflow/controller/JobController.java    |  35 +++++
 .../domain/workflow/service/JobService.java   |  28 ++++
 .../resources/mybatis/mapper/JobMapper.xml    |  27 ++++
 .../e2e/scenario/JobCreateFlowE2eTest.java    | 148 ++++++++++++++++++
 4 files changed, 238 insertions(+)
 create mode 100644 apps/user-service/src/main/java/site/icebang/domain/workflow/controller/JobController.java
 create mode 100644 apps/user-service/src/main/java/site/icebang/domain/workflow/service/JobService.java
 create mode 100644 apps/user-service/src/test/java/site/icebang/e2e/scenario/JobCreateFlowE2eTest.java

diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/JobController.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/JobController.java
new file mode 100644
index 00000000..f7c2dbe0
--- /dev/null
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/JobController.java
@@ -0,0 +1,35 @@
+package site.icebang.domain.workflow.controller;
+
+import java.util.Map;
+
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+
+import lombok.RequiredArgsConstructor;
+import site.icebang.domain.workflow.dto.JobDto;
+import site.icebang.domain.workflow.service.JobService;
+
+@RestController
+@RequestMapping("/v0/jobs")
+@RequiredArgsConstructor
+public class JobController {
+
+    private final JobService jobService;
+
+    @PostMapping
+    public ResponseEntity<Map<String, Object>> createJob(@RequestBody JobDto dto) {
+        JobDto created = jobService.createJob(dto);
+        return ResponseEntity.status(HttpStatus.CREATED)
+                .body(Map.of("success", true, "data", created));
+    }
+
+    @GetMapping("/{id}")
+    public ResponseEntity<Map<String, Object>> getJob(@PathVariable Long id) {
+        JobDto job = jobService.findById(id);
+        if (job == null) {
+            return ResponseEntity.status(HttpStatus.NOT_FOUND).body(Map.of("success", false));
+        }
+        return ResponseEntity.ok(Map.of("success", true, "data", job));
+    }
+}
diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/service/JobService.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/service/JobService.java
new file mode 100644
index 00000000..05f14b24
--- /dev/null
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/service/JobService.java
@@ -0,0 +1,28 @@
+package site.icebang.domain.workflow.service;
+
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import lombok.RequiredArgsConstructor;
+import site.icebang.domain.workflow.dto.JobDto;
+import site.icebang.domain.workflow.mapper.JobMapper;
+
+@Service
+@RequiredArgsConstructor
+public class JobService {
+
+    private final JobMapper jobMapper;
+
+    @Transactional
+    public JobDto createJob(JobDto dto) {
+        if (dto.getName() == null || dto.getName().isBlank()) {
+            throw new IllegalArgumentException("job name is required");
+        }
+        jobMapper.insertJob(dto);
+        return jobMapper.findJobById(dto.getId());
+    }
+
+    public JobDto findById(Long id) {
+        return jobMapper.findJobById(id);
+    }
+}
diff --git a/apps/user-service/src/main/resources/mybatis/mapper/JobMapper.xml b/apps/user-service/src/main/resources/mybatis/mapper/JobMapper.xml
index 5b959db3..f5cd2ed0 100644
--- a/apps/user-service/src/main/resources/mybatis/mapper/JobMapper.xml
+++ b/apps/user-service/src/main/resources/mybatis/mapper/JobMapper.xml
@@ -23,6 +23,33 @@
         <result property="executionOrder" column="execution_order"/>
     </resultMap>
 
+    <insert id="insertJob" parameterType="site.icebang.domain.workflow.dto.JobDto"
+            useGeneratedKeys="true" keyProperty="id">
+        INSERT INTO job (
+            name,
+            description,
+            is_enabled,
+            created_at,
+            created_by,
+            updated_at,
+            updated_by
+        ) VALUES (
+                     #{name},
+                     #{description},
+                     #{isEnabled},
+                     #{createdAt},
+                     #{createdBy},
+                     #{updatedAt},
+                     #{updatedBy}
+                 )
+    </insert>
+
+    <select id="findJobById" resultMap="JobDtoResultMap">
+        SELECT j.*
+        FROM job j
+        WHERE j.id = #{id}
+    </select>
+
     <select id="findJobsByWorkflowId" resultMap="JobDtoResultMap">
         SELECT
             j.*,
diff --git a/apps/user-service/src/test/java/site/icebang/e2e/scenario/JobCreateFlowE2eTest.java b/apps/user-service/src/test/java/site/icebang/e2e/scenario/JobCreateFlowE2eTest.java
new file mode 100644
index 00000000..30e087d7
--- /dev/null
+++ b/apps/user-service/src/test/java/site/icebang/e2e/scenario/JobCreateFlowE2eTest.java
@@ -0,0 +1,148 @@
+package site.icebang.e2e.scenario;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+import java.util.HashMap;
+import java.util.Map;
+
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.springframework.http.*;
+import org.springframework.test.context.jdbc.Sql;
+
+import site.icebang.e2e.setup.annotation.E2eTest;
+import site.icebang.e2e.setup.support.E2eTestSupport;
+
+@Sql(
+        value = {
+                "classpath:sql/data/00-truncate.sql",
+                "classpath:sql/data/01-insert-internal-users.sql"
+        },
+        executionPhase = Sql.ExecutionPhase.BEFORE_TEST_CLASS)
+@DisplayName("Job 생성 플로우 E2E 테스트")
+@E2eTest
+class JobCreateFlowE2eTest extends E2eTestSupport {
+
+    @SuppressWarnings("unchecked")
+    @Test
+    @DisplayName("사용자가 새로운 Job을 생성하는 전체 플로우")
+    void completeJobCreateFlow() throws Exception {
+        logStep(1, "사용자 로그인");
+        performUserLogin();
+
+        logStep(2, "기본 Job 생성");
+
+        // Job 생성 요청
+        Map<String, Object> jobRequest = new HashMap<>();
+        jobRequest.put("name", "테스트 Job");
+        jobRequest.put("description", "E2E 테스트용 Job입니다");
+        jobRequest.put("isEnabled", true);
+
+        HttpHeaders headers = new HttpHeaders();
+        headers.setContentType(MediaType.APPLICATION_JSON);
+
+        HttpEntity<Map<String, Object>> entity = new HttpEntity<>(jobRequest, headers);
+
+        ResponseEntity<Map> createResponse =
+                restTemplate.postForEntity(getV0ApiUrl("/jobs"), entity, Map.class);
+
+        assertThat(createResponse.getStatusCode()).isEqualTo(HttpStatus.CREATED);
+        assertThat((Boolean) createResponse.getBody().get("success")).isTrue();
+
+        Map<String, Object> createdJobData = (Map<String, Object>) createResponse.getBody().get("data");
+        assertThat(createdJobData).isNotNull();
+        assertThat(createdJobData.get("id")).isNotNull();
+        assertThat(createdJobData.get("name")).isEqualTo("테스트 Job");
+
+        logSuccess("Job 생성 성공");
+
+        logStep(3, "생성된 Job 조회");
+
+        Long jobId = ((Number) createdJobData.get("id")).longValue();
+
+        ResponseEntity<Map> getResponse =
+                restTemplate.getForEntity(getV0ApiUrl("/jobs/" + jobId), Map.class);
+
+        assertThat(getResponse.getStatusCode()).isEqualTo(HttpStatus.OK);
+        assertThat((Boolean) getResponse.getBody().get("success")).isTrue();
+
+        Map<String, Object> retrievedJobData = (Map<String, Object>) getResponse.getBody().get("data");
+        assertThat(retrievedJobData.get("id")).isEqualTo(jobId.intValue());
+        assertThat(retrievedJobData.get("name")).isEqualTo("테스트 Job");
+        assertThat(retrievedJobData.get("description")).isEqualTo("E2E 테스트용 Job입니다");
+
+        logSuccess("생성된 Job 조회 성공");
+
+        logCompletion("Job 생성 플로우 완료");
+    }
+
+    @Test
+    @DisplayName("필수 필드 누락 시 Job 생성 실패")
+    void createJob_withMissingRequiredFields_shouldFail() {
+        // 선행 조건: 로그인
+        performUserLogin();
+
+        logStep(1, "Job 이름 없이 생성 시도");
+
+        // 이름 없는 요청
+        Map<String, Object> noNameJob = new HashMap<>();
+        noNameJob.put("description", "이름이 없는 Job");
+        noNameJob.put("isEnabled", true);
+
+        HttpHeaders headers = new HttpHeaders();
+        headers.setContentType(MediaType.APPLICATION_JSON);
+
+        HttpEntity<Map<String, Object>> entity = new HttpEntity<>(noNameJob, headers);
+
+        ResponseEntity<Map> response =
+                restTemplate.postForEntity(getV0ApiUrl("/jobs"), entity, Map.class);
+
+        assertThat(response.getStatusCode())
+                .isIn(HttpStatus.BAD_REQUEST, HttpStatus.UNPROCESSABLE_ENTITY);
+
+        logSuccess("필수 필드 검증 확인");
+    }
+
+    @Test
+    @DisplayName("존재하지 않는 Job 조회 시 404 응답")
+    void getJob_withNonExistentId_shouldReturn404() {
+        // 선행 조건: 로그인
+        performUserLogin();
+
+        logStep(1, "존재하지 않는 Job ID로 조회 시도");
+
+        Long nonExistentId = 99999L;
+
+        ResponseEntity<Map> response =
+                restTemplate.getForEntity(getV0ApiUrl("/jobs/" + nonExistentId), Map.class);
+
+        assertThat(response.getStatusCode()).isEqualTo(HttpStatus.NOT_FOUND);
+        assertThat((Boolean) response.getBody().get("success")).isFalse();
+
+        logSuccess("존재하지 않는 Job 조회 시 404 응답 확인");
+    }
+
+    /** 사용자 로그인을 수행하는 헬퍼 메서드 */
+    private void performUserLogin() {
+        Map<String, String> loginRequest = new HashMap<>();
+        loginRequest.put("email", "admin@icebang.site");
+        loginRequest.put("password", "qwer1234!A");
+
+        HttpHeaders headers = new HttpHeaders();
+        headers.setContentType(MediaType.APPLICATION_JSON);
+        headers.set("Origin", "https://admin.icebang.site");
+        headers.set("Referer", "https://admin.icebang.site/");
+
+        HttpEntity<Map<String, String>> entity = new HttpEntity<>(loginRequest, headers);
+
+        ResponseEntity<Map> response =
+                restTemplate.postForEntity(getV0ApiUrl("/auth/login"), entity, Map.class);
+
+        if (response.getStatusCode() != HttpStatus.OK) {
+            logError("사용자 로그인 실패: " + response.getStatusCode());
+            throw new RuntimeException("User login failed");
+        }
+
+        logSuccess("사용자 로그인 완료");
+    }
+}
\ No newline at end of file

From 9bd6d11b393daaa86eafaac925be2a04ff39a5d2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B9=80=ED=83=9C=ED=98=84?= <xogusrla7@gmail.com>
Date: Fri, 26 Sep 2025 15:07:19 +0900
Subject: [PATCH 03/12] =?UTF-8?q?chore:=20Job=20E2eTest=EC=A0=9C=EA=B1=B0?=
 =?UTF-8?q?=20=EB=B0=8F=20IntegrationTest=20=EC=9E=91=EC=84=B1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../e2e/scenario/JobCreateFlowE2eTest.java    | 148 ---------
 .../tests/workflow/JobApiIntegrationTest.java | 289 ++++++++++++++++++
 2 files changed, 289 insertions(+), 148 deletions(-)
 delete mode 100644 apps/user-service/src/test/java/site/icebang/e2e/scenario/JobCreateFlowE2eTest.java
 create mode 100644 apps/user-service/src/test/java/site/icebang/integration/tests/workflow/JobApiIntegrationTest.java

diff --git a/apps/user-service/src/test/java/site/icebang/e2e/scenario/JobCreateFlowE2eTest.java b/apps/user-service/src/test/java/site/icebang/e2e/scenario/JobCreateFlowE2eTest.java
deleted file mode 100644
index 30e087d7..00000000
--- a/apps/user-service/src/test/java/site/icebang/e2e/scenario/JobCreateFlowE2eTest.java
+++ /dev/null
@@ -1,148 +0,0 @@
-package site.icebang.e2e.scenario;
-
-import static org.assertj.core.api.Assertions.assertThat;
-
-import java.util.HashMap;
-import java.util.Map;
-
-import org.junit.jupiter.api.DisplayName;
-import org.junit.jupiter.api.Test;
-import org.springframework.http.*;
-import org.springframework.test.context.jdbc.Sql;
-
-import site.icebang.e2e.setup.annotation.E2eTest;
-import site.icebang.e2e.setup.support.E2eTestSupport;
-
-@Sql(
-        value = {
-                "classpath:sql/data/00-truncate.sql",
-                "classpath:sql/data/01-insert-internal-users.sql"
-        },
-        executionPhase = Sql.ExecutionPhase.BEFORE_TEST_CLASS)
-@DisplayName("Job 생성 플로우 E2E 테스트")
-@E2eTest
-class JobCreateFlowE2eTest extends E2eTestSupport {
-
-    @SuppressWarnings("unchecked")
-    @Test
-    @DisplayName("사용자가 새로운 Job을 생성하는 전체 플로우")
-    void completeJobCreateFlow() throws Exception {
-        logStep(1, "사용자 로그인");
-        performUserLogin();
-
-        logStep(2, "기본 Job 생성");
-
-        // Job 생성 요청
-        Map<String, Object> jobRequest = new HashMap<>();
-        jobRequest.put("name", "테스트 Job");
-        jobRequest.put("description", "E2E 테스트용 Job입니다");
-        jobRequest.put("isEnabled", true);
-
-        HttpHeaders headers = new HttpHeaders();
-        headers.setContentType(MediaType.APPLICATION_JSON);
-
-        HttpEntity<Map<String, Object>> entity = new HttpEntity<>(jobRequest, headers);
-
-        ResponseEntity<Map> createResponse =
-                restTemplate.postForEntity(getV0ApiUrl("/jobs"), entity, Map.class);
-
-        assertThat(createResponse.getStatusCode()).isEqualTo(HttpStatus.CREATED);
-        assertThat((Boolean) createResponse.getBody().get("success")).isTrue();
-
-        Map<String, Object> createdJobData = (Map<String, Object>) createResponse.getBody().get("data");
-        assertThat(createdJobData).isNotNull();
-        assertThat(createdJobData.get("id")).isNotNull();
-        assertThat(createdJobData.get("name")).isEqualTo("테스트 Job");
-
-        logSuccess("Job 생성 성공");
-
-        logStep(3, "생성된 Job 조회");
-
-        Long jobId = ((Number) createdJobData.get("id")).longValue();
-
-        ResponseEntity<Map> getResponse =
-                restTemplate.getForEntity(getV0ApiUrl("/jobs/" + jobId), Map.class);
-
-        assertThat(getResponse.getStatusCode()).isEqualTo(HttpStatus.OK);
-        assertThat((Boolean) getResponse.getBody().get("success")).isTrue();
-
-        Map<String, Object> retrievedJobData = (Map<String, Object>) getResponse.getBody().get("data");
-        assertThat(retrievedJobData.get("id")).isEqualTo(jobId.intValue());
-        assertThat(retrievedJobData.get("name")).isEqualTo("테스트 Job");
-        assertThat(retrievedJobData.get("description")).isEqualTo("E2E 테스트용 Job입니다");
-
-        logSuccess("생성된 Job 조회 성공");
-
-        logCompletion("Job 생성 플로우 완료");
-    }
-
-    @Test
-    @DisplayName("필수 필드 누락 시 Job 생성 실패")
-    void createJob_withMissingRequiredFields_shouldFail() {
-        // 선행 조건: 로그인
-        performUserLogin();
-
-        logStep(1, "Job 이름 없이 생성 시도");
-
-        // 이름 없는 요청
-        Map<String, Object> noNameJob = new HashMap<>();
-        noNameJob.put("description", "이름이 없는 Job");
-        noNameJob.put("isEnabled", true);
-
-        HttpHeaders headers = new HttpHeaders();
-        headers.setContentType(MediaType.APPLICATION_JSON);
-
-        HttpEntity<Map<String, Object>> entity = new HttpEntity<>(noNameJob, headers);
-
-        ResponseEntity<Map> response =
-                restTemplate.postForEntity(getV0ApiUrl("/jobs"), entity, Map.class);
-
-        assertThat(response.getStatusCode())
-                .isIn(HttpStatus.BAD_REQUEST, HttpStatus.UNPROCESSABLE_ENTITY);
-
-        logSuccess("필수 필드 검증 확인");
-    }
-
-    @Test
-    @DisplayName("존재하지 않는 Job 조회 시 404 응답")
-    void getJob_withNonExistentId_shouldReturn404() {
-        // 선행 조건: 로그인
-        performUserLogin();
-
-        logStep(1, "존재하지 않는 Job ID로 조회 시도");
-
-        Long nonExistentId = 99999L;
-
-        ResponseEntity<Map> response =
-                restTemplate.getForEntity(getV0ApiUrl("/jobs/" + nonExistentId), Map.class);
-
-        assertThat(response.getStatusCode()).isEqualTo(HttpStatus.NOT_FOUND);
-        assertThat((Boolean) response.getBody().get("success")).isFalse();
-
-        logSuccess("존재하지 않는 Job 조회 시 404 응답 확인");
-    }
-
-    /** 사용자 로그인을 수행하는 헬퍼 메서드 */
-    private void performUserLogin() {
-        Map<String, String> loginRequest = new HashMap<>();
-        loginRequest.put("email", "admin@icebang.site");
-        loginRequest.put("password", "qwer1234!A");
-
-        HttpHeaders headers = new HttpHeaders();
-        headers.setContentType(MediaType.APPLICATION_JSON);
-        headers.set("Origin", "https://admin.icebang.site");
-        headers.set("Referer", "https://admin.icebang.site/");
-
-        HttpEntity<Map<String, String>> entity = new HttpEntity<>(loginRequest, headers);
-
-        ResponseEntity<Map> response =
-                restTemplate.postForEntity(getV0ApiUrl("/auth/login"), entity, Map.class);
-
-        if (response.getStatusCode() != HttpStatus.OK) {
-            logError("사용자 로그인 실패: " + response.getStatusCode());
-            throw new RuntimeException("User login failed");
-        }
-
-        logSuccess("사용자 로그인 완료");
-    }
-}
\ No newline at end of file
diff --git a/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/JobApiIntegrationTest.java b/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/JobApiIntegrationTest.java
new file mode 100644
index 00000000..aa446179
--- /dev/null
+++ b/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/JobApiIntegrationTest.java
@@ -0,0 +1,289 @@
+package site.icebang.integration.tests.workflow;
+
+import static com.epages.restdocs.apispec.MockMvcRestDocumentationWrapper.document;
+import static com.epages.restdocs.apispec.ResourceDocumentation.*;
+import static org.springframework.restdocs.mockmvc.RestDocumentationRequestBuilders.get;
+import static org.springframework.restdocs.mockmvc.RestDocumentationRequestBuilders.post;
+import static org.springframework.restdocs.operation.preprocess.Preprocessors.*;
+import static org.springframework.restdocs.payload.PayloadDocumentation.*;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
+
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.springframework.http.MediaType;
+import org.springframework.restdocs.payload.JsonFieldType;
+import org.springframework.security.test.context.support.WithUserDetails;
+import org.springframework.test.context.jdbc.Sql;
+import org.springframework.transaction.annotation.Transactional;
+
+import com.epages.restdocs.apispec.ResourceSnippetParameters;
+
+import site.icebang.integration.setup.support.IntegrationTestSupport;
+
+@Sql(
+        value = {
+                "classpath:sql/data/00-truncate.sql",
+                "classpath:sql/data/01-insert-internal-users.sql",
+                "classpath:sql/data/03-insert-workflow-h2.sql"
+        },
+        executionPhase = Sql.ExecutionPhase.BEFORE_TEST_METHOD)
+@Transactional
+@DisplayName("Job API 통합 테스트")
+public class JobApiIntegrationTest extends IntegrationTestSupport {
+
+    @Test
+    @DisplayName("Job 생성 성공")
+    @WithUserDetails("admin@icebang.site")
+    void createJob_success() throws Exception {
+        // given
+        String jobRequestJson = """
+        {
+          "name": "통합테스트 Job",
+          "description": "Integration Test용 Job",
+          "isEnabled": true
+        }
+        """;
+
+        // when & then
+        mockMvc
+                .perform(
+                        post(getApiUrlForDocs("/v0/jobs"))
+                                .header("Origin", "https://admin.icebang.site")
+                                .header("Referer", "https://admin.icebang.site/")
+                                .contentType(MediaType.APPLICATION_JSON)
+                                .content(jobRequestJson))
+                .andExpect(status().isCreated())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data.id").exists())
+                .andExpect(jsonPath("$.data.name").value("통합테스트 Job"))
+                .andExpect(jsonPath("$.data.description").value("Integration Test용 Job"))
+                .andExpect(jsonPath("$.data.isEnabled").value(true))
+                .andExpect(jsonPath("$.data.createdAt").exists())
+                .andExpect(jsonPath("$.data.updatedAt").exists())
+                .andDo(
+                        document(
+                                "job-create",
+                                preprocessRequest(prettyPrint()),
+                                preprocessResponse(prettyPrint()),
+                                resource(
+                                        ResourceSnippetParameters.builder()
+                                                .tag("Job")
+                                                .summary("Job 생성")
+                                                .description("새로운 Job을 생성합니다")
+                                                .requestFields(
+                                                        fieldWithPath("name")
+                                                                .type(JsonFieldType.STRING)
+                                                                .description("Job 이름 (필수)"),
+                                                        fieldWithPath("description")
+                                                                .type(JsonFieldType.STRING)
+                                                                .description("Job 설명 (선택)"),
+                                                        fieldWithPath("isEnabled")
+                                                                .type(JsonFieldType.BOOLEAN)
+                                                                .description("활성화 여부 (선택, 기본값: true)"))
+                                                .responseFields(
+                                                        fieldWithPath("success")
+                                                                .type(JsonFieldType.BOOLEAN)
+                                                                .description("요청 성공 여부"),
+                                                        fieldWithPath("data")
+                                                                .type(JsonFieldType.OBJECT)
+                                                                .description("생성된 Job 정보"),
+                                                        fieldWithPath("data.id")
+                                                                .type(JsonFieldType.NUMBER)
+                                                                .description("Job ID"),
+                                                        fieldWithPath("data.name")
+                                                                .type(JsonFieldType.STRING)
+                                                                .description("Job 이름"),
+                                                        fieldWithPath("data.description")
+                                                                .type(JsonFieldType.STRING)
+                                                                .description("Job 설명")
+                                                                .optional(),
+                                                        fieldWithPath("data.isEnabled")
+                                                                .type(JsonFieldType.BOOLEAN)
+                                                                .description("활성화 여부")
+                                                                .optional(),
+                                                        fieldWithPath("data.createdAt")
+                                                                .type(JsonFieldType.STRING)
+                                                                .description("생성 시간"),
+                                                        fieldWithPath("data.createdBy")
+                                                                .type(JsonFieldType.NUMBER)
+                                                                .description("생성자 ID")
+                                                                .optional(),
+                                                        fieldWithPath("data.updatedAt")
+                                                                .type(JsonFieldType.STRING)
+                                                                .description("수정 시간"),
+                                                        fieldWithPath("data.updatedBy")
+                                                                .type(JsonFieldType.NUMBER)
+                                                                .description("수정자 ID")
+                                                                .optional(),
+                                                        fieldWithPath("data.executionOrder")
+                                                                .type(JsonFieldType.NUMBER)
+                                                                .description("실행 순서")
+                                                                .optional())
+                                                .build())));
+    }
+
+    @Test
+    @DisplayName("Job 조회 성공")
+    @WithUserDetails("admin@icebang.site")
+    void getJob_success() throws Exception {
+        // given - 03-insert-workflow-h2.sql에서 생성된 Job ID 1 사용
+        Long jobId = 1L;
+
+        // when & then
+        mockMvc
+                .perform(
+                        get(getApiUrlForDocs("/v0/jobs/{id}"), jobId)
+                                .header("Origin", "https://admin.icebang.site")
+                                .header("Referer", "https://admin.icebang.site/"))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data.id").value(jobId.intValue()))
+                .andExpect(jsonPath("$.data.name").value("상품 분석"))
+                .andExpect(jsonPath("$.data.description").value("키워드 검색, 상품 크롤링 및 유사도 분석 작업"))
+                .andExpect(jsonPath("$.data.createdAt").exists())
+                .andExpect(jsonPath("$.data.updatedAt").exists())
+                .andDo(
+                        document(
+                                "job-get",
+                                preprocessRequest(prettyPrint()),
+                                preprocessResponse(prettyPrint()),
+                                resource(
+                                        ResourceSnippetParameters.builder()
+                                                .tag("Job")
+                                                .summary("Job 조회")
+                                                .description("Job ID로 Job 정보를 조회합니다")
+                                                .responseFields(
+                                                        fieldWithPath("success")
+                                                                .type(JsonFieldType.BOOLEAN)
+                                                                .description("요청 성공 여부"),
+                                                        fieldWithPath("data")
+                                                                .type(JsonFieldType.OBJECT)
+                                                                .description("Job 정보"),
+                                                        fieldWithPath("data.id")
+                                                                .type(JsonFieldType.NUMBER)
+                                                                .description("Job ID"),
+                                                        fieldWithPath("data.name")
+                                                                .type(JsonFieldType.STRING)
+                                                                .description("Job 이름"),
+                                                        fieldWithPath("data.description")
+                                                                .type(JsonFieldType.STRING)
+                                                                .description("Job 설명")
+                                                                .optional(),
+                                                        fieldWithPath("data.isEnabled")
+                                                                .type(JsonFieldType.BOOLEAN)
+                                                                .description("활성화 여부")
+                                                                .optional(),
+                                                        fieldWithPath("data.createdAt")
+                                                                .type(JsonFieldType.STRING)
+                                                                .description("생성 시간"),
+                                                        fieldWithPath("data.createdBy")
+                                                                .type(JsonFieldType.NUMBER)
+                                                                .description("생성자 ID")
+                                                                .optional(),
+                                                        fieldWithPath("data.updatedAt")
+                                                                .type(JsonFieldType.STRING)
+                                                                .description("수정 시간"),
+                                                        fieldWithPath("data.updatedBy")
+                                                                .type(JsonFieldType.NUMBER)
+                                                                .description("수정자 ID")
+                                                                .optional(),
+                                                        fieldWithPath("data.executionOrder")
+                                                                .type(JsonFieldType.NUMBER)
+                                                                .description("실행 순서")
+                                                                .optional())
+                                                .build())));
+    }
+
+    @Test
+    @DisplayName("Job 이름 없이 생성 시 실패")
+    @WithUserDetails("admin@icebang.site")
+    void createJob_withoutName_shouldFail() throws Exception {
+        // given
+        String invalidJobRequestJson = """
+        {
+          "description": "이름이 없는 Job",
+          "isEnabled": true
+        }
+        """;
+
+        // when & then
+        mockMvc
+                .perform(
+                        post(getApiUrlForDocs("/v0/jobs"))
+                                .header("Origin", "https://admin.icebang.site")
+                                .header("Referer", "https://admin.icebang.site/")
+                                .contentType(MediaType.APPLICATION_JSON)
+                                .content(invalidJobRequestJson))
+                .andExpect(status().isBadRequest());
+    }
+
+    @Test
+    @DisplayName("빈 문자열 이름으로 Job 생성 시 실패")
+    @WithUserDetails("admin@icebang.site")
+    void createJob_withBlankName_shouldFail() throws Exception {
+        // given
+        String blankNameJobRequestJson = """
+        {
+          "name": "   ",
+          "description": "빈 이름 Job",
+          "isEnabled": true
+        }
+        """;
+
+        // when & then
+        mockMvc
+                .perform(
+                        post(getApiUrlForDocs("/v0/jobs"))
+                                .header("Origin", "https://admin.icebang.site")
+                                .header("Referer", "https://admin.icebang.site/")
+                                .contentType(MediaType.APPLICATION_JSON)
+                                .content(blankNameJobRequestJson))
+                .andExpect(status().isBadRequest());
+    }
+
+    @Test
+    @DisplayName("존재하지 않는 Job 조회 시 404 반환")
+    @WithUserDetails("admin@icebang.site")
+    void getJob_withNonExistentId_shouldReturn404() throws Exception {
+        // given
+        Long nonExistentId = 99999L;
+
+        // when & then
+        mockMvc
+                .perform(
+                        get(getApiUrlForDocs("/v0/jobs/{id}"), nonExistentId)
+                                .header("Origin", "https://admin.icebang.site")
+                                .header("Referer", "https://admin.icebang.site/"))
+                .andExpect(status().isNotFound())
+                .andExpect(jsonPath("$.success").value(false));
+    }
+
+    @Test
+    @DisplayName("Job 생성 시 UTC 시간으로 저장되는지 검증")
+    @WithUserDetails("admin@icebang.site")
+    void createJob_utc_time_validation() throws Exception {
+        // given
+        String jobRequestJson = """
+        {
+          "name": "UTC 시간 검증 Job",
+          "description": "시간대 보정 테스트용 Job"
+        }
+        """;
+
+        // when & then
+        mockMvc
+                .perform(
+                        post(getApiUrlForDocs("/v0/jobs"))
+                                .header("Origin", "https://admin.icebang.site")
+                                .header("Referer", "https://admin.icebang.site/")
+                                .contentType(MediaType.APPLICATION_JSON)
+                                .content(jobRequestJson))
+                .andExpect(status().isCreated())
+                .andExpect(jsonPath("$.success").value(true))
+                .andExpect(jsonPath("$.data.createdAt").exists())
+                .andExpect(jsonPath("$.data.updatedAt").exists());
+
+        // 시간 형식이 올바른지는 실제 DB에서 확인하거나
+        // 응답 시간이 현재 UTC 시간과 비슷한 범위에 있는지 검증할 수 있음
+    }
+}
\ No newline at end of file

From 2d0cdda27ebf13c4e636a850b5847d20329d7e3f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B9=80=ED=83=9C=ED=98=84?= <xogusrla7@gmail.com>
Date: Fri, 26 Sep 2025 15:07:57 +0900
Subject: [PATCH 04/12] chore: spotlessApply

---
 .../workflow/controller/JobController.java    |  28 +-
 .../domain/workflow/mapper/JobMapper.java     |   1 +
 .../domain/workflow/service/JobService.java   |  23 +-
 .../tests/workflow/JobApiIntegrationTest.java | 458 +++++++++---------
 4 files changed, 257 insertions(+), 253 deletions(-)

diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/JobController.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/JobController.java
index f7c2dbe0..1b7fa826 100644
--- a/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/JobController.java
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/JobController.java
@@ -7,6 +7,7 @@
 import org.springframework.web.bind.annotation.*;
 
 import lombok.RequiredArgsConstructor;
+
 import site.icebang.domain.workflow.dto.JobDto;
 import site.icebang.domain.workflow.service.JobService;
 
@@ -15,21 +16,20 @@
 @RequiredArgsConstructor
 public class JobController {
 
-    private final JobService jobService;
+  private final JobService jobService;
 
-    @PostMapping
-    public ResponseEntity<Map<String, Object>> createJob(@RequestBody JobDto dto) {
-        JobDto created = jobService.createJob(dto);
-        return ResponseEntity.status(HttpStatus.CREATED)
-                .body(Map.of("success", true, "data", created));
-    }
+  @PostMapping
+  public ResponseEntity<Map<String, Object>> createJob(@RequestBody JobDto dto) {
+    JobDto created = jobService.createJob(dto);
+    return ResponseEntity.status(HttpStatus.CREATED).body(Map.of("success", true, "data", created));
+  }
 
-    @GetMapping("/{id}")
-    public ResponseEntity<Map<String, Object>> getJob(@PathVariable Long id) {
-        JobDto job = jobService.findById(id);
-        if (job == null) {
-            return ResponseEntity.status(HttpStatus.NOT_FOUND).body(Map.of("success", false));
-        }
-        return ResponseEntity.ok(Map.of("success", true, "data", job));
+  @GetMapping("/{id}")
+  public ResponseEntity<Map<String, Object>> getJob(@PathVariable Long id) {
+    JobDto job = jobService.findById(id);
+    if (job == null) {
+      return ResponseEntity.status(HttpStatus.NOT_FOUND).body(Map.of("success", false));
     }
+    return ResponseEntity.ok(Map.of("success", true, "data", job));
+  }
 }
diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/mapper/JobMapper.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/mapper/JobMapper.java
index 8e2c53a0..0ae89235 100644
--- a/apps/user-service/src/main/java/site/icebang/domain/workflow/mapper/JobMapper.java
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/mapper/JobMapper.java
@@ -14,5 +14,6 @@ public interface JobMapper {
   List<TaskDto> findTasksByJobId(Long jobId);
 
   JobDto findJobById(Long id);
+
   void insertJob(JobDto job);
 }
diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/service/JobService.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/service/JobService.java
index 05f14b24..99e10987 100644
--- a/apps/user-service/src/main/java/site/icebang/domain/workflow/service/JobService.java
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/service/JobService.java
@@ -4,6 +4,7 @@
 import org.springframework.transaction.annotation.Transactional;
 
 import lombok.RequiredArgsConstructor;
+
 import site.icebang.domain.workflow.dto.JobDto;
 import site.icebang.domain.workflow.mapper.JobMapper;
 
@@ -11,18 +12,18 @@
 @RequiredArgsConstructor
 public class JobService {
 
-    private final JobMapper jobMapper;
+  private final JobMapper jobMapper;
 
-    @Transactional
-    public JobDto createJob(JobDto dto) {
-        if (dto.getName() == null || dto.getName().isBlank()) {
-            throw new IllegalArgumentException("job name is required");
-        }
-        jobMapper.insertJob(dto);
-        return jobMapper.findJobById(dto.getId());
+  @Transactional
+  public JobDto createJob(JobDto dto) {
+    if (dto.getName() == null || dto.getName().isBlank()) {
+      throw new IllegalArgumentException("job name is required");
     }
+    jobMapper.insertJob(dto);
+    return jobMapper.findJobById(dto.getId());
+  }
 
-    public JobDto findById(Long id) {
-        return jobMapper.findJobById(id);
-    }
+  public JobDto findById(Long id) {
+    return jobMapper.findJobById(id);
+  }
 }
diff --git a/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/JobApiIntegrationTest.java b/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/JobApiIntegrationTest.java
index aa446179..8b923f82 100644
--- a/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/JobApiIntegrationTest.java
+++ b/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/JobApiIntegrationTest.java
@@ -21,22 +21,23 @@
 import site.icebang.integration.setup.support.IntegrationTestSupport;
 
 @Sql(
-        value = {
-                "classpath:sql/data/00-truncate.sql",
-                "classpath:sql/data/01-insert-internal-users.sql",
-                "classpath:sql/data/03-insert-workflow-h2.sql"
-        },
-        executionPhase = Sql.ExecutionPhase.BEFORE_TEST_METHOD)
+    value = {
+      "classpath:sql/data/00-truncate.sql",
+      "classpath:sql/data/01-insert-internal-users.sql",
+      "classpath:sql/data/03-insert-workflow-h2.sql"
+    },
+    executionPhase = Sql.ExecutionPhase.BEFORE_TEST_METHOD)
 @Transactional
 @DisplayName("Job API 통합 테스트")
 public class JobApiIntegrationTest extends IntegrationTestSupport {
 
-    @Test
-    @DisplayName("Job 생성 성공")
-    @WithUserDetails("admin@icebang.site")
-    void createJob_success() throws Exception {
-        // given
-        String jobRequestJson = """
+  @Test
+  @DisplayName("Job 생성 성공")
+  @WithUserDetails("admin@icebang.site")
+  void createJob_success() throws Exception {
+    // given
+    String jobRequestJson =
+        """
         {
           "name": "통합테스트 Job",
           "description": "Integration Test용 Job",
@@ -44,185 +45,185 @@ void createJob_success() throws Exception {
         }
         """;
 
-        // when & then
-        mockMvc
-                .perform(
-                        post(getApiUrlForDocs("/v0/jobs"))
-                                .header("Origin", "https://admin.icebang.site")
-                                .header("Referer", "https://admin.icebang.site/")
-                                .contentType(MediaType.APPLICATION_JSON)
-                                .content(jobRequestJson))
-                .andExpect(status().isCreated())
-                .andExpect(jsonPath("$.success").value(true))
-                .andExpect(jsonPath("$.data.id").exists())
-                .andExpect(jsonPath("$.data.name").value("통합테스트 Job"))
-                .andExpect(jsonPath("$.data.description").value("Integration Test용 Job"))
-                .andExpect(jsonPath("$.data.isEnabled").value(true))
-                .andExpect(jsonPath("$.data.createdAt").exists())
-                .andExpect(jsonPath("$.data.updatedAt").exists())
-                .andDo(
-                        document(
-                                "job-create",
-                                preprocessRequest(prettyPrint()),
-                                preprocessResponse(prettyPrint()),
-                                resource(
-                                        ResourceSnippetParameters.builder()
-                                                .tag("Job")
-                                                .summary("Job 생성")
-                                                .description("새로운 Job을 생성합니다")
-                                                .requestFields(
-                                                        fieldWithPath("name")
-                                                                .type(JsonFieldType.STRING)
-                                                                .description("Job 이름 (필수)"),
-                                                        fieldWithPath("description")
-                                                                .type(JsonFieldType.STRING)
-                                                                .description("Job 설명 (선택)"),
-                                                        fieldWithPath("isEnabled")
-                                                                .type(JsonFieldType.BOOLEAN)
-                                                                .description("활성화 여부 (선택, 기본값: true)"))
-                                                .responseFields(
-                                                        fieldWithPath("success")
-                                                                .type(JsonFieldType.BOOLEAN)
-                                                                .description("요청 성공 여부"),
-                                                        fieldWithPath("data")
-                                                                .type(JsonFieldType.OBJECT)
-                                                                .description("생성된 Job 정보"),
-                                                        fieldWithPath("data.id")
-                                                                .type(JsonFieldType.NUMBER)
-                                                                .description("Job ID"),
-                                                        fieldWithPath("data.name")
-                                                                .type(JsonFieldType.STRING)
-                                                                .description("Job 이름"),
-                                                        fieldWithPath("data.description")
-                                                                .type(JsonFieldType.STRING)
-                                                                .description("Job 설명")
-                                                                .optional(),
-                                                        fieldWithPath("data.isEnabled")
-                                                                .type(JsonFieldType.BOOLEAN)
-                                                                .description("활성화 여부")
-                                                                .optional(),
-                                                        fieldWithPath("data.createdAt")
-                                                                .type(JsonFieldType.STRING)
-                                                                .description("생성 시간"),
-                                                        fieldWithPath("data.createdBy")
-                                                                .type(JsonFieldType.NUMBER)
-                                                                .description("생성자 ID")
-                                                                .optional(),
-                                                        fieldWithPath("data.updatedAt")
-                                                                .type(JsonFieldType.STRING)
-                                                                .description("수정 시간"),
-                                                        fieldWithPath("data.updatedBy")
-                                                                .type(JsonFieldType.NUMBER)
-                                                                .description("수정자 ID")
-                                                                .optional(),
-                                                        fieldWithPath("data.executionOrder")
-                                                                .type(JsonFieldType.NUMBER)
-                                                                .description("실행 순서")
-                                                                .optional())
-                                                .build())));
-    }
+    // when & then
+    mockMvc
+        .perform(
+            post(getApiUrlForDocs("/v0/jobs"))
+                .header("Origin", "https://admin.icebang.site")
+                .header("Referer", "https://admin.icebang.site/")
+                .contentType(MediaType.APPLICATION_JSON)
+                .content(jobRequestJson))
+        .andExpect(status().isCreated())
+        .andExpect(jsonPath("$.success").value(true))
+        .andExpect(jsonPath("$.data.id").exists())
+        .andExpect(jsonPath("$.data.name").value("통합테스트 Job"))
+        .andExpect(jsonPath("$.data.description").value("Integration Test용 Job"))
+        .andExpect(jsonPath("$.data.isEnabled").value(true))
+        .andExpect(jsonPath("$.data.createdAt").exists())
+        .andExpect(jsonPath("$.data.updatedAt").exists())
+        .andDo(
+            document(
+                "job-create",
+                preprocessRequest(prettyPrint()),
+                preprocessResponse(prettyPrint()),
+                resource(
+                    ResourceSnippetParameters.builder()
+                        .tag("Job")
+                        .summary("Job 생성")
+                        .description("새로운 Job을 생성합니다")
+                        .requestFields(
+                            fieldWithPath("name")
+                                .type(JsonFieldType.STRING)
+                                .description("Job 이름 (필수)"),
+                            fieldWithPath("description")
+                                .type(JsonFieldType.STRING)
+                                .description("Job 설명 (선택)"),
+                            fieldWithPath("isEnabled")
+                                .type(JsonFieldType.BOOLEAN)
+                                .description("활성화 여부 (선택, 기본값: true)"))
+                        .responseFields(
+                            fieldWithPath("success")
+                                .type(JsonFieldType.BOOLEAN)
+                                .description("요청 성공 여부"),
+                            fieldWithPath("data")
+                                .type(JsonFieldType.OBJECT)
+                                .description("생성된 Job 정보"),
+                            fieldWithPath("data.id")
+                                .type(JsonFieldType.NUMBER)
+                                .description("Job ID"),
+                            fieldWithPath("data.name")
+                                .type(JsonFieldType.STRING)
+                                .description("Job 이름"),
+                            fieldWithPath("data.description")
+                                .type(JsonFieldType.STRING)
+                                .description("Job 설명")
+                                .optional(),
+                            fieldWithPath("data.isEnabled")
+                                .type(JsonFieldType.BOOLEAN)
+                                .description("활성화 여부")
+                                .optional(),
+                            fieldWithPath("data.createdAt")
+                                .type(JsonFieldType.STRING)
+                                .description("생성 시간"),
+                            fieldWithPath("data.createdBy")
+                                .type(JsonFieldType.NUMBER)
+                                .description("생성자 ID")
+                                .optional(),
+                            fieldWithPath("data.updatedAt")
+                                .type(JsonFieldType.STRING)
+                                .description("수정 시간"),
+                            fieldWithPath("data.updatedBy")
+                                .type(JsonFieldType.NUMBER)
+                                .description("수정자 ID")
+                                .optional(),
+                            fieldWithPath("data.executionOrder")
+                                .type(JsonFieldType.NUMBER)
+                                .description("실행 순서")
+                                .optional())
+                        .build())));
+  }
 
-    @Test
-    @DisplayName("Job 조회 성공")
-    @WithUserDetails("admin@icebang.site")
-    void getJob_success() throws Exception {
-        // given - 03-insert-workflow-h2.sql에서 생성된 Job ID 1 사용
-        Long jobId = 1L;
+  @Test
+  @DisplayName("Job 조회 성공")
+  @WithUserDetails("admin@icebang.site")
+  void getJob_success() throws Exception {
+    // given - 03-insert-workflow-h2.sql에서 생성된 Job ID 1 사용
+    Long jobId = 1L;
 
-        // when & then
-        mockMvc
-                .perform(
-                        get(getApiUrlForDocs("/v0/jobs/{id}"), jobId)
-                                .header("Origin", "https://admin.icebang.site")
-                                .header("Referer", "https://admin.icebang.site/"))
-                .andExpect(status().isOk())
-                .andExpect(jsonPath("$.success").value(true))
-                .andExpect(jsonPath("$.data.id").value(jobId.intValue()))
-                .andExpect(jsonPath("$.data.name").value("상품 분석"))
-                .andExpect(jsonPath("$.data.description").value("키워드 검색, 상품 크롤링 및 유사도 분석 작업"))
-                .andExpect(jsonPath("$.data.createdAt").exists())
-                .andExpect(jsonPath("$.data.updatedAt").exists())
-                .andDo(
-                        document(
-                                "job-get",
-                                preprocessRequest(prettyPrint()),
-                                preprocessResponse(prettyPrint()),
-                                resource(
-                                        ResourceSnippetParameters.builder()
-                                                .tag("Job")
-                                                .summary("Job 조회")
-                                                .description("Job ID로 Job 정보를 조회합니다")
-                                                .responseFields(
-                                                        fieldWithPath("success")
-                                                                .type(JsonFieldType.BOOLEAN)
-                                                                .description("요청 성공 여부"),
-                                                        fieldWithPath("data")
-                                                                .type(JsonFieldType.OBJECT)
-                                                                .description("Job 정보"),
-                                                        fieldWithPath("data.id")
-                                                                .type(JsonFieldType.NUMBER)
-                                                                .description("Job ID"),
-                                                        fieldWithPath("data.name")
-                                                                .type(JsonFieldType.STRING)
-                                                                .description("Job 이름"),
-                                                        fieldWithPath("data.description")
-                                                                .type(JsonFieldType.STRING)
-                                                                .description("Job 설명")
-                                                                .optional(),
-                                                        fieldWithPath("data.isEnabled")
-                                                                .type(JsonFieldType.BOOLEAN)
-                                                                .description("활성화 여부")
-                                                                .optional(),
-                                                        fieldWithPath("data.createdAt")
-                                                                .type(JsonFieldType.STRING)
-                                                                .description("생성 시간"),
-                                                        fieldWithPath("data.createdBy")
-                                                                .type(JsonFieldType.NUMBER)
-                                                                .description("생성자 ID")
-                                                                .optional(),
-                                                        fieldWithPath("data.updatedAt")
-                                                                .type(JsonFieldType.STRING)
-                                                                .description("수정 시간"),
-                                                        fieldWithPath("data.updatedBy")
-                                                                .type(JsonFieldType.NUMBER)
-                                                                .description("수정자 ID")
-                                                                .optional(),
-                                                        fieldWithPath("data.executionOrder")
-                                                                .type(JsonFieldType.NUMBER)
-                                                                .description("실행 순서")
-                                                                .optional())
-                                                .build())));
-    }
+    // when & then
+    mockMvc
+        .perform(
+            get(getApiUrlForDocs("/v0/jobs/{id}"), jobId)
+                .header("Origin", "https://admin.icebang.site")
+                .header("Referer", "https://admin.icebang.site/"))
+        .andExpect(status().isOk())
+        .andExpect(jsonPath("$.success").value(true))
+        .andExpect(jsonPath("$.data.id").value(jobId.intValue()))
+        .andExpect(jsonPath("$.data.name").value("상품 분석"))
+        .andExpect(jsonPath("$.data.description").value("키워드 검색, 상품 크롤링 및 유사도 분석 작업"))
+        .andExpect(jsonPath("$.data.createdAt").exists())
+        .andExpect(jsonPath("$.data.updatedAt").exists())
+        .andDo(
+            document(
+                "job-get",
+                preprocessRequest(prettyPrint()),
+                preprocessResponse(prettyPrint()),
+                resource(
+                    ResourceSnippetParameters.builder()
+                        .tag("Job")
+                        .summary("Job 조회")
+                        .description("Job ID로 Job 정보를 조회합니다")
+                        .responseFields(
+                            fieldWithPath("success")
+                                .type(JsonFieldType.BOOLEAN)
+                                .description("요청 성공 여부"),
+                            fieldWithPath("data").type(JsonFieldType.OBJECT).description("Job 정보"),
+                            fieldWithPath("data.id")
+                                .type(JsonFieldType.NUMBER)
+                                .description("Job ID"),
+                            fieldWithPath("data.name")
+                                .type(JsonFieldType.STRING)
+                                .description("Job 이름"),
+                            fieldWithPath("data.description")
+                                .type(JsonFieldType.STRING)
+                                .description("Job 설명")
+                                .optional(),
+                            fieldWithPath("data.isEnabled")
+                                .type(JsonFieldType.BOOLEAN)
+                                .description("활성화 여부")
+                                .optional(),
+                            fieldWithPath("data.createdAt")
+                                .type(JsonFieldType.STRING)
+                                .description("생성 시간"),
+                            fieldWithPath("data.createdBy")
+                                .type(JsonFieldType.NUMBER)
+                                .description("생성자 ID")
+                                .optional(),
+                            fieldWithPath("data.updatedAt")
+                                .type(JsonFieldType.STRING)
+                                .description("수정 시간"),
+                            fieldWithPath("data.updatedBy")
+                                .type(JsonFieldType.NUMBER)
+                                .description("수정자 ID")
+                                .optional(),
+                            fieldWithPath("data.executionOrder")
+                                .type(JsonFieldType.NUMBER)
+                                .description("실행 순서")
+                                .optional())
+                        .build())));
+  }
 
-    @Test
-    @DisplayName("Job 이름 없이 생성 시 실패")
-    @WithUserDetails("admin@icebang.site")
-    void createJob_withoutName_shouldFail() throws Exception {
-        // given
-        String invalidJobRequestJson = """
+  @Test
+  @DisplayName("Job 이름 없이 생성 시 실패")
+  @WithUserDetails("admin@icebang.site")
+  void createJob_withoutName_shouldFail() throws Exception {
+    // given
+    String invalidJobRequestJson =
+        """
         {
           "description": "이름이 없는 Job",
           "isEnabled": true
         }
         """;
 
-        // when & then
-        mockMvc
-                .perform(
-                        post(getApiUrlForDocs("/v0/jobs"))
-                                .header("Origin", "https://admin.icebang.site")
-                                .header("Referer", "https://admin.icebang.site/")
-                                .contentType(MediaType.APPLICATION_JSON)
-                                .content(invalidJobRequestJson))
-                .andExpect(status().isBadRequest());
-    }
+    // when & then
+    mockMvc
+        .perform(
+            post(getApiUrlForDocs("/v0/jobs"))
+                .header("Origin", "https://admin.icebang.site")
+                .header("Referer", "https://admin.icebang.site/")
+                .contentType(MediaType.APPLICATION_JSON)
+                .content(invalidJobRequestJson))
+        .andExpect(status().isBadRequest());
+  }
 
-    @Test
-    @DisplayName("빈 문자열 이름으로 Job 생성 시 실패")
-    @WithUserDetails("admin@icebang.site")
-    void createJob_withBlankName_shouldFail() throws Exception {
-        // given
-        String blankNameJobRequestJson = """
+  @Test
+  @DisplayName("빈 문자열 이름으로 Job 생성 시 실패")
+  @WithUserDetails("admin@icebang.site")
+  void createJob_withBlankName_shouldFail() throws Exception {
+    // given
+    String blankNameJobRequestJson =
+        """
         {
           "name": "   ",
           "description": "빈 이름 Job",
@@ -230,60 +231,61 @@ void createJob_withBlankName_shouldFail() throws Exception {
         }
         """;
 
-        // when & then
-        mockMvc
-                .perform(
-                        post(getApiUrlForDocs("/v0/jobs"))
-                                .header("Origin", "https://admin.icebang.site")
-                                .header("Referer", "https://admin.icebang.site/")
-                                .contentType(MediaType.APPLICATION_JSON)
-                                .content(blankNameJobRequestJson))
-                .andExpect(status().isBadRequest());
-    }
+    // when & then
+    mockMvc
+        .perform(
+            post(getApiUrlForDocs("/v0/jobs"))
+                .header("Origin", "https://admin.icebang.site")
+                .header("Referer", "https://admin.icebang.site/")
+                .contentType(MediaType.APPLICATION_JSON)
+                .content(blankNameJobRequestJson))
+        .andExpect(status().isBadRequest());
+  }
 
-    @Test
-    @DisplayName("존재하지 않는 Job 조회 시 404 반환")
-    @WithUserDetails("admin@icebang.site")
-    void getJob_withNonExistentId_shouldReturn404() throws Exception {
-        // given
-        Long nonExistentId = 99999L;
+  @Test
+  @DisplayName("존재하지 않는 Job 조회 시 404 반환")
+  @WithUserDetails("admin@icebang.site")
+  void getJob_withNonExistentId_shouldReturn404() throws Exception {
+    // given
+    Long nonExistentId = 99999L;
 
-        // when & then
-        mockMvc
-                .perform(
-                        get(getApiUrlForDocs("/v0/jobs/{id}"), nonExistentId)
-                                .header("Origin", "https://admin.icebang.site")
-                                .header("Referer", "https://admin.icebang.site/"))
-                .andExpect(status().isNotFound())
-                .andExpect(jsonPath("$.success").value(false));
-    }
+    // when & then
+    mockMvc
+        .perform(
+            get(getApiUrlForDocs("/v0/jobs/{id}"), nonExistentId)
+                .header("Origin", "https://admin.icebang.site")
+                .header("Referer", "https://admin.icebang.site/"))
+        .andExpect(status().isNotFound())
+        .andExpect(jsonPath("$.success").value(false));
+  }
 
-    @Test
-    @DisplayName("Job 생성 시 UTC 시간으로 저장되는지 검증")
-    @WithUserDetails("admin@icebang.site")
-    void createJob_utc_time_validation() throws Exception {
-        // given
-        String jobRequestJson = """
+  @Test
+  @DisplayName("Job 생성 시 UTC 시간으로 저장되는지 검증")
+  @WithUserDetails("admin@icebang.site")
+  void createJob_utc_time_validation() throws Exception {
+    // given
+    String jobRequestJson =
+        """
         {
           "name": "UTC 시간 검증 Job",
           "description": "시간대 보정 테스트용 Job"
         }
         """;
 
-        // when & then
-        mockMvc
-                .perform(
-                        post(getApiUrlForDocs("/v0/jobs"))
-                                .header("Origin", "https://admin.icebang.site")
-                                .header("Referer", "https://admin.icebang.site/")
-                                .contentType(MediaType.APPLICATION_JSON)
-                                .content(jobRequestJson))
-                .andExpect(status().isCreated())
-                .andExpect(jsonPath("$.success").value(true))
-                .andExpect(jsonPath("$.data.createdAt").exists())
-                .andExpect(jsonPath("$.data.updatedAt").exists());
+    // when & then
+    mockMvc
+        .perform(
+            post(getApiUrlForDocs("/v0/jobs"))
+                .header("Origin", "https://admin.icebang.site")
+                .header("Referer", "https://admin.icebang.site/")
+                .contentType(MediaType.APPLICATION_JSON)
+                .content(jobRequestJson))
+        .andExpect(status().isCreated())
+        .andExpect(jsonPath("$.success").value(true))
+        .andExpect(jsonPath("$.data.createdAt").exists())
+        .andExpect(jsonPath("$.data.updatedAt").exists());
 
-        // 시간 형식이 올바른지는 실제 DB에서 확인하거나
-        // 응답 시간이 현재 UTC 시간과 비슷한 범위에 있는지 검증할 수 있음
-    }
-}
\ No newline at end of file
+    // 시간 형식이 올바른지는 실제 DB에서 확인하거나
+    // 응답 시간이 현재 UTC 시간과 비슷한 범위에 있는지 검증할 수 있음
+  }
+}

From f7162c0a462044e5d7f50ed6dfeffcb30d8bcd28 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B9=80=ED=83=9C=ED=98=84?= <xogusrla7@gmail.com>
Date: Fri, 26 Sep 2025 15:14:50 +0900
Subject: [PATCH 05/12] =?UTF-8?q?feat:=20Task=20=EA=B4=80=EB=A0=A8=20?=
 =?UTF-8?q?=EC=9E=91=EC=97=85(=EC=B4=88=EC=95=88)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../workflow/controller/TaskController.java   |  35 ++
 .../domain/workflow/mapper/TaskMapper.java    |   5 +
 .../domain/workflow/service/TaskService.java  |  29 ++
 .../resources/mybatis/mapper/TaskMapper.xml   |  27 ++
 .../workflow/TaskApiIntegrationTest.java      | 299 ++++++++++++++++++
 5 files changed, 395 insertions(+)
 create mode 100644 apps/user-service/src/main/java/site/icebang/domain/workflow/controller/TaskController.java
 create mode 100644 apps/user-service/src/main/java/site/icebang/domain/workflow/service/TaskService.java
 create mode 100644 apps/user-service/src/test/java/site/icebang/integration/tests/workflow/TaskApiIntegrationTest.java

diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/TaskController.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/TaskController.java
new file mode 100644
index 00000000..dfc92dc2
--- /dev/null
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/TaskController.java
@@ -0,0 +1,35 @@
+package site.icebang.domain.workflow.controller;
+
+import java.util.Map;
+
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+
+import lombok.RequiredArgsConstructor;
+
+import site.icebang.domain.workflow.dto.TaskDto;
+import site.icebang.domain.workflow.service.TaskService;
+
+@RestController
+@RequestMapping("/v0/tasks")
+@RequiredArgsConstructor
+public class TaskController {
+
+  private final TaskService taskService;
+
+  @PostMapping
+  public ResponseEntity<Map<String, Object>> createTask(@RequestBody TaskDto dto) {
+    TaskDto created = taskService.createTask(dto);
+    return ResponseEntity.status(HttpStatus.CREATED).body(Map.of("success", true, "data", created));
+  }
+
+  @GetMapping("/{id}")
+  public ResponseEntity<Map<String, Object>> getTask(@PathVariable Long id) {
+    TaskDto task = taskService.findById(id);
+    if (task == null) {
+      return ResponseEntity.status(HttpStatus.NOT_FOUND).body(Map.of("success", false));
+    }
+    return ResponseEntity.ok(Map.of("success", true, "data", task));
+  }
+}
diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/mapper/TaskMapper.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/mapper/TaskMapper.java
index 0edb7812..c15d14ad 100644
--- a/apps/user-service/src/main/java/site/icebang/domain/workflow/mapper/TaskMapper.java
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/mapper/TaskMapper.java
@@ -4,9 +4,14 @@
 
 import org.apache.ibatis.annotations.Mapper;
 
+import site.icebang.domain.workflow.dto.TaskDto;
 import site.icebang.domain.workflow.model.Task;
 
 @Mapper
 public interface TaskMapper {
   Optional<Task> findById(Long id);
+
+  void insertTask(TaskDto task);
+
+  TaskDto findTaskById(Long id);
 }
diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/service/TaskService.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/service/TaskService.java
new file mode 100644
index 00000000..5fdad034
--- /dev/null
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/service/TaskService.java
@@ -0,0 +1,29 @@
+package site.icebang.domain.workflow.service;
+
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import lombok.RequiredArgsConstructor;
+
+import site.icebang.domain.workflow.dto.TaskDto;
+import site.icebang.domain.workflow.mapper.TaskMapper;
+
+@Service
+@RequiredArgsConstructor
+public class TaskService {
+
+  private final TaskMapper taskMapper;
+
+  @Transactional
+  public TaskDto createTask(TaskDto dto) {
+    if (dto.getName() == null || dto.getName().isBlank()) {
+      throw new IllegalArgumentException("task name is required");
+    }
+    taskMapper.insertTask(dto);
+    return taskMapper.findTaskById(dto.getId());
+  }
+
+  public TaskDto findById(Long id) {
+    return taskMapper.findTaskById(id);
+  }
+}
diff --git a/apps/user-service/src/main/resources/mybatis/mapper/TaskMapper.xml b/apps/user-service/src/main/resources/mybatis/mapper/TaskMapper.xml
index 80c6c044..dd0c500d 100644
--- a/apps/user-service/src/main/resources/mybatis/mapper/TaskMapper.xml
+++ b/apps/user-service/src/main/resources/mybatis/mapper/TaskMapper.xml
@@ -12,6 +12,33 @@
         <result property="updatedAt" column="updated_at" javaType="java.time.Instant" jdbcType="TIMESTAMP" typeHandler="site.icebang.global.config.mybatis.typehandler.InstantTypeHandler"/>
     </resultMap>
 
+    <insert id="insertTask" parameterType="site.icebang.domain.workflow.dto.TaskDto"
+            useGeneratedKeys="true" keyProperty="id">
+        INSERT INTO task (
+            name,
+            type,
+            parameters,
+            created_at,
+            created_by,
+            updated_at,
+            updated_by
+        ) VALUES (
+                     #{name},
+                     #{type},
+                     #{parameters},
+                     #{createdAt},
+                     #{createdBy},
+                     #{updatedAt},
+                     #{updatedBy}
+                 )
+    </insert>
+
+    <select id="findTaskById" resultMap="TaskDtoResultMap">
+        SELECT t.*
+        FROM task t
+        WHERE t.id = #{id}
+    </select>
+
     <select id="findById" resultMap="TaskResultMap">
         SELECT * FROM task
         WHERE id = #{taskId}
diff --git a/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/TaskApiIntegrationTest.java b/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/TaskApiIntegrationTest.java
new file mode 100644
index 00000000..09737215
--- /dev/null
+++ b/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/TaskApiIntegrationTest.java
@@ -0,0 +1,299 @@
+package site.icebang.integration.tests.workflow;
+
+import static com.epages.restdocs.apispec.MockMvcRestDocumentationWrapper.document;
+import static com.epages.restdocs.apispec.ResourceDocumentation.*;
+import static org.springframework.restdocs.mockmvc.RestDocumentationRequestBuilders.get;
+import static org.springframework.restdocs.mockmvc.RestDocumentationRequestBuilders.post;
+import static org.springframework.restdocs.operation.preprocess.Preprocessors.*;
+import static org.springframework.restdocs.payload.PayloadDocumentation.*;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
+
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.springframework.http.MediaType;
+import org.springframework.restdocs.payload.JsonFieldType;
+import org.springframework.security.test.context.support.WithUserDetails;
+import org.springframework.test.context.jdbc.Sql;
+import org.springframework.transaction.annotation.Transactional;
+
+import com.epages.restdocs.apispec.ResourceSnippetParameters;
+
+import site.icebang.integration.setup.support.IntegrationTestSupport;
+
+@Sql(
+    value = {
+      "classpath:sql/data/00-truncate.sql",
+      "classpath:sql/data/01-insert-internal-users.sql",
+      "classpath:sql/data/03-insert-workflow-h2.sql" // Task 테스트 데이터 포함
+    },
+    executionPhase = Sql.ExecutionPhase.BEFORE_TEST_METHOD)
+@Transactional
+@DisplayName("Task API 통합 테스트")
+public class TaskApiIntegrationTest extends IntegrationTestSupport {
+
+  @Test
+  @DisplayName("Task 생성 성공")
+  @WithUserDetails("admin@icebang.site")
+  void createTask_success() throws Exception {
+    // given
+    String taskRequestJson =
+        """
+        {
+          "name": "통합테스트 Task",
+          "type": "FastAPI",
+          "parameters": {
+            "endpoint": "/test/api",
+            "method": "POST"
+          }
+        }
+        """;
+
+    // when & then
+    mockMvc
+        .perform(
+            post(getApiUrlForDocs("/v0/tasks"))
+                .header("Origin", "https://admin.icebang.site")
+                .header("Referer", "https://admin.icebang.site/")
+                .contentType(MediaType.APPLICATION_JSON)
+                .content(taskRequestJson))
+        .andExpect(status().isCreated())
+        .andExpect(jsonPath("$.success").value(true))
+        .andExpect(jsonPath("$.data.id").exists())
+        .andExpect(jsonPath("$.data.name").value("통합테스트 Task"))
+        .andExpect(jsonPath("$.data.type").value("FastAPI"))
+        .andExpect(jsonPath("$.data.parameters").exists())
+        .andExpect(jsonPath("$.data.createdAt").exists())
+        .andExpect(jsonPath("$.data.updatedAt").exists())
+        .andDo(
+            document(
+                "task-create",
+                preprocessRequest(prettyPrint()),
+                preprocessResponse(prettyPrint()),
+                resource(
+                    ResourceSnippetParameters.builder()
+                        .tag("Task")
+                        .summary("Task 생성")
+                        .description("새로운 Task를 생성합니다")
+                        .requestFields(
+                            fieldWithPath("name")
+                                .type(JsonFieldType.STRING)
+                                .description("Task 이름 (필수)"),
+                            fieldWithPath("type")
+                                .type(JsonFieldType.STRING)
+                                .description("Task 타입 (예: FastAPI, Shell 등)"),
+                            fieldWithPath("parameters")
+                                .type(JsonFieldType.OBJECT)
+                                .description("Task 실행에 필요한 파라미터 (JSON 형태)")
+                                .optional())
+                        .responseFields(
+                            fieldWithPath("success")
+                                .type(JsonFieldType.BOOLEAN)
+                                .description("요청 성공 여부"),
+                            fieldWithPath("data")
+                                .type(JsonFieldType.OBJECT)
+                                .description("생성된 Task 정보"),
+                            fieldWithPath("data.id")
+                                .type(JsonFieldType.NUMBER)
+                                .description("Task ID"),
+                            fieldWithPath("data.name")
+                                .type(JsonFieldType.STRING)
+                                .description("Task 이름"),
+                            fieldWithPath("data.type")
+                                .type(JsonFieldType.STRING)
+                                .description("Task 타입"),
+                            fieldWithPath("data.parameters")
+                                .type(JsonFieldType.OBJECT)
+                                .description("Task 파라미터")
+                                .optional(),
+                            fieldWithPath("data.executionOrder")
+                                .type(JsonFieldType.NUMBER)
+                                .description("실행 순서")
+                                .optional(),
+                            fieldWithPath("data.settings")
+                                .type(JsonFieldType.OBJECT)
+                                .description("Task 설정")
+                                .optional(),
+                            fieldWithPath("data.createdAt")
+                                .type(JsonFieldType.STRING)
+                                .description("생성 시간"),
+                            fieldWithPath("data.updatedAt")
+                                .type(JsonFieldType.STRING)
+                                .description("수정 시간"))
+                        .build())));
+  }
+
+  @Test
+  @DisplayName("Task 조회 성공")
+  @WithUserDetails("admin@icebang.site")
+  void getTask_success() throws Exception {
+    // given - 03-insert-workflow-h2.sql에서 생성된 Task ID 1 사용
+    Long taskId = 1L;
+
+    // when & then
+    mockMvc
+        .perform(
+            get(getApiUrlForDocs("/v0/tasks/{id}"), taskId)
+                .header("Origin", "https://admin.icebang.site")
+                .header("Referer", "https://admin.icebang.site/"))
+        .andExpect(status().isOk())
+        .andExpect(jsonPath("$.success").value(true))
+        .andExpect(jsonPath("$.data.id").value(taskId.intValue()))
+        .andExpect(jsonPath("$.data.name").value("키워드 검색 태스크"))
+        .andExpect(jsonPath("$.data.type").value("FastAPI"))
+        .andExpect(jsonPath("$.data.parameters").exists())
+        .andExpect(jsonPath("$.data.createdAt").exists())
+        .andExpect(jsonPath("$.data.updatedAt").exists())
+        .andDo(
+            document(
+                "task-get",
+                preprocessRequest(prettyPrint()),
+                preprocessResponse(prettyPrint()),
+                resource(
+                    ResourceSnippetParameters.builder()
+                        .tag("Task")
+                        .summary("Task 조회")
+                        .description("Task ID로 Task 정보를 조회합니다")
+                        .responseFields(
+                            fieldWithPath("success")
+                                .type(JsonFieldType.BOOLEAN)
+                                .description("요청 성공 여부"),
+                            fieldWithPath("data").type(JsonFieldType.OBJECT).description("Task 정보"),
+                            fieldWithPath("data.id")
+                                .type(JsonFieldType.NUMBER)
+                                .description("Task ID"),
+                            fieldWithPath("data.name")
+                                .type(JsonFieldType.STRING)
+                                .description("Task 이름"),
+                            fieldWithPath("data.type")
+                                .type(JsonFieldType.STRING)
+                                .description("Task 타입"),
+                            fieldWithPath("data.parameters")
+                                .type(JsonFieldType.OBJECT)
+                                .description("Task 파라미터")
+                                .optional(),
+                            fieldWithPath("data.executionOrder")
+                                .type(JsonFieldType.NUMBER)
+                                .description("실행 순서")
+                                .optional(),
+                            fieldWithPath("data.settings")
+                                .type(JsonFieldType.OBJECT)
+                                .description("Task 설정")
+                                .optional(),
+                            fieldWithPath("data.createdAt")
+                                .type(JsonFieldType.STRING)
+                                .description("생성 시간"),
+                            fieldWithPath("data.updatedAt")
+                                .type(JsonFieldType.STRING)
+                                .description("수정 시간"))
+                        .build())));
+  }
+
+  @Test
+  @DisplayName("Task 이름 없이 생성 시 실패")
+  @WithUserDetails("admin@icebang.site")
+  void createTask_withoutName_shouldFail() throws Exception {
+    // given
+    String invalidTaskRequestJson =
+        """
+        {
+          "type": "FastAPI",
+          "parameters": {
+            "endpoint": "/test/api"
+          }
+        }
+        """;
+
+    // when & then
+    mockMvc
+        .perform(
+            post(getApiUrlForDocs("/v0/tasks"))
+                .header("Origin", "https://admin.icebang.site")
+                .header("Referer", "https://admin.icebang.site/")
+                .contentType(MediaType.APPLICATION_JSON)
+                .content(invalidTaskRequestJson))
+        .andExpect(status().isBadRequest());
+  }
+
+  @Test
+  @DisplayName("빈 문자열 이름으로 Task 생성 시 실패")
+  @WithUserDetails("admin@icebang.site")
+  void createTask_withBlankName_shouldFail() throws Exception {
+    // given
+    String blankNameTaskRequestJson =
+        """
+        {
+          "name": "   ",
+          "type": "FastAPI",
+          "parameters": {
+            "endpoint": "/test/api"
+          }
+        }
+        """;
+
+    // when & then
+    mockMvc
+        .perform(
+            post(getApiUrlForDocs("/v0/tasks"))
+                .header("Origin", "https://admin.icebang.site")
+                .header("Referer", "https://admin.icebang.site/")
+                .contentType(MediaType.APPLICATION_JSON)
+                .content(blankNameTaskRequestJson))
+        .andExpect(status().isBadRequest());
+  }
+
+  @Test
+  @DisplayName("존재하지 않는 Task 조회 시 404 반환")
+  @WithUserDetails("admin@icebang.site")
+  void getTask_withNonExistentId_shouldReturn404() throws Exception {
+    // given
+    Long nonExistentId = 99999L;
+
+    // when & then
+    mockMvc
+        .perform(
+            get(getApiUrlForDocs("/v0/tasks/{id}"), nonExistentId)
+                .header("Origin", "https://admin.icebang.site")
+                .header("Referer", "https://admin.icebang.site/"))
+        .andExpect(status().isNotFound())
+        .andExpect(jsonPath("$.success").value(false));
+  }
+
+  @Test
+  @DisplayName("복잡한 JSON 파라미터로 Task 생성")
+  @WithUserDetails("admin@icebang.site")
+  void createTask_withComplexJsonParameters() throws Exception {
+    // given
+    String complexTaskRequestJson =
+        """
+        {
+          "name": "복잡한 파라미터 Task",
+          "type": "FastAPI",
+          "parameters": {
+            "endpoint": "/products/similarity",
+            "method": "POST",
+            "body": {
+              "keyword": "String",
+              "matched_products": "List",
+              "search_results": "List"
+            },
+            "timeout": 30,
+            "retries": 3
+          }
+        }
+        """;
+
+    // when & then
+    mockMvc
+        .perform(
+            post(getApiUrlForDocs("/v0/tasks"))
+                .header("Origin", "https://admin.icebang.site")
+                .header("Referer", "https://admin.icebang.site/")
+                .contentType(MediaType.APPLICATION_JSON)
+                .content(complexTaskRequestJson))
+        .andExpect(status().isCreated())
+        .andExpect(jsonPath("$.success").value(true))
+        .andExpect(jsonPath("$.data.name").value("복잡한 파라미터 Task"))
+        .andExpect(jsonPath("$.data.parameters.endpoint").value("/products/similarity"))
+        .andExpect(jsonPath("$.data.parameters.body.keyword").value("String"));
+  }
+}

From a089da16c02640614e7585b176f7739e56863cd6 Mon Sep 17 00:00:00 2001
From: thkim7 <xogusrla7@gmail.com>
Date: Sun, 28 Sep 2025 04:43:57 +0900
Subject: [PATCH 06/12] =?UTF-8?q?feat:=20Job/Task=20CRUD=EB=A5=BC=20Workfl?=
 =?UTF-8?q?owService=EB=A1=9C=20=ED=86=B5=ED=95=A9=20=EB=B0=8F=20Task=20?=
 =?UTF-8?q?=EB=8D=B0=EC=9D=B4=ED=84=B0=20=EA=B5=AC=EC=A1=B0=20=EC=97=85?=
 =?UTF-8?q?=EB=8D=B0=EC=9D=B4=ED=8A=B8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

1. Job/Task 서비스 통합
   - JobService, TaskService 삭제
   - WorkflowService에 Job/Task CRUD 메서드 통합
   - JobController, TaskController에서 WorkflowService 사용하도록 변경

2. Task 데이터 구조 확장 (9개 → 10개)
   - 새로운 Task 추가: "이미지 OCR 태스크" (ID: 8)
   - 기존 Task ID 변경: RAG 생성 (8→9), 블로그 발행 (9→10)
   - H2 테스트 데이터(03-insert-workflow-h2.sql) 업데이트

3. Integration 테스트 리팩토링
   - JobApiIntegrationTest, TaskApiIntegrationTest에서 WorkflowService 사용
   - Task 10개 구조에 맞춘 테스트 케이스 추가
   - 새로운 OCR Task 및 업데이트된 블로그 발행 Task 테스트 추가

4. 코드 일관성 및 응집도 개선
   - 워크플로우 관련 모든 CRUD 기능을 단일 서비스로 집중
   - Job-Task 연결 구조 업데이트: Job1(Task 1-8), Job2(Task 9-10)
---
 .../workflow/controller/JobController.java    |   8 +-
 .../workflow/controller/TaskController.java   |   8 +-
 .../domain/workflow/service/JobService.java   |  29 ----
 .../domain/workflow/service/TaskService.java  |  29 ----
 .../workflow/service/WorkflowService.java     |  64 ++++++++-
 .../sql/data/03-insert-workflow-h2.sql        |  57 ++++----
 .../tests/workflow/JobApiIntegrationTest.java |  44 +++---
 .../workflow/TaskApiIntegrationTest.java      | 127 ++++++++++++------
 8 files changed, 208 insertions(+), 158 deletions(-)
 delete mode 100644 apps/user-service/src/main/java/site/icebang/domain/workflow/service/JobService.java
 delete mode 100644 apps/user-service/src/main/java/site/icebang/domain/workflow/service/TaskService.java

diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/JobController.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/JobController.java
index 1b7fa826..a9bb3157 100644
--- a/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/JobController.java
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/JobController.java
@@ -9,24 +9,24 @@
 import lombok.RequiredArgsConstructor;
 
 import site.icebang.domain.workflow.dto.JobDto;
-import site.icebang.domain.workflow.service.JobService;
+import site.icebang.domain.workflow.service.WorkflowService;
 
 @RestController
 @RequestMapping("/v0/jobs")
 @RequiredArgsConstructor
 public class JobController {
 
-  private final JobService jobService;
+  private final WorkflowService workflowService;
 
   @PostMapping
   public ResponseEntity<Map<String, Object>> createJob(@RequestBody JobDto dto) {
-    JobDto created = jobService.createJob(dto);
+    JobDto created = workflowService.createJob(dto);
     return ResponseEntity.status(HttpStatus.CREATED).body(Map.of("success", true, "data", created));
   }
 
   @GetMapping("/{id}")
   public ResponseEntity<Map<String, Object>> getJob(@PathVariable Long id) {
-    JobDto job = jobService.findById(id);
+    JobDto job = workflowService.findJobById(id);
     if (job == null) {
       return ResponseEntity.status(HttpStatus.NOT_FOUND).body(Map.of("success", false));
     }
diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/TaskController.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/TaskController.java
index dfc92dc2..ffd57e40 100644
--- a/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/TaskController.java
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/TaskController.java
@@ -9,24 +9,24 @@
 import lombok.RequiredArgsConstructor;
 
 import site.icebang.domain.workflow.dto.TaskDto;
-import site.icebang.domain.workflow.service.TaskService;
+import site.icebang.domain.workflow.service.WorkflowService;
 
 @RestController
 @RequestMapping("/v0/tasks")
 @RequiredArgsConstructor
 public class TaskController {
 
-  private final TaskService taskService;
+  private final WorkflowService workflowService;
 
   @PostMapping
   public ResponseEntity<Map<String, Object>> createTask(@RequestBody TaskDto dto) {
-    TaskDto created = taskService.createTask(dto);
+    TaskDto created = workflowService.createTask(dto);
     return ResponseEntity.status(HttpStatus.CREATED).body(Map.of("success", true, "data", created));
   }
 
   @GetMapping("/{id}")
   public ResponseEntity<Map<String, Object>> getTask(@PathVariable Long id) {
-    TaskDto task = taskService.findById(id);
+    TaskDto task = workflowService.findTaskById(id);
     if (task == null) {
       return ResponseEntity.status(HttpStatus.NOT_FOUND).body(Map.of("success", false));
     }
diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/service/JobService.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/service/JobService.java
deleted file mode 100644
index 99e10987..00000000
--- a/apps/user-service/src/main/java/site/icebang/domain/workflow/service/JobService.java
+++ /dev/null
@@ -1,29 +0,0 @@
-package site.icebang.domain.workflow.service;
-
-import org.springframework.stereotype.Service;
-import org.springframework.transaction.annotation.Transactional;
-
-import lombok.RequiredArgsConstructor;
-
-import site.icebang.domain.workflow.dto.JobDto;
-import site.icebang.domain.workflow.mapper.JobMapper;
-
-@Service
-@RequiredArgsConstructor
-public class JobService {
-
-  private final JobMapper jobMapper;
-
-  @Transactional
-  public JobDto createJob(JobDto dto) {
-    if (dto.getName() == null || dto.getName().isBlank()) {
-      throw new IllegalArgumentException("job name is required");
-    }
-    jobMapper.insertJob(dto);
-    return jobMapper.findJobById(dto.getId());
-  }
-
-  public JobDto findById(Long id) {
-    return jobMapper.findJobById(id);
-  }
-}
diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/service/TaskService.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/service/TaskService.java
deleted file mode 100644
index 5fdad034..00000000
--- a/apps/user-service/src/main/java/site/icebang/domain/workflow/service/TaskService.java
+++ /dev/null
@@ -1,29 +0,0 @@
-package site.icebang.domain.workflow.service;
-
-import org.springframework.stereotype.Service;
-import org.springframework.transaction.annotation.Transactional;
-
-import lombok.RequiredArgsConstructor;
-
-import site.icebang.domain.workflow.dto.TaskDto;
-import site.icebang.domain.workflow.mapper.TaskMapper;
-
-@Service
-@RequiredArgsConstructor
-public class TaskService {
-
-  private final TaskMapper taskMapper;
-
-  @Transactional
-  public TaskDto createTask(TaskDto dto) {
-    if (dto.getName() == null || dto.getName().isBlank()) {
-      throw new IllegalArgumentException("task name is required");
-    }
-    taskMapper.insertTask(dto);
-    return taskMapper.findTaskById(dto.getId());
-  }
-
-  public TaskDto findById(Long id) {
-    return taskMapper.findTaskById(id);
-  }
-}
diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/service/WorkflowService.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/service/WorkflowService.java
index 30a00c55..433981d6 100644
--- a/apps/user-service/src/main/java/site/icebang/domain/workflow/service/WorkflowService.java
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/service/WorkflowService.java
@@ -21,11 +21,9 @@
 import site.icebang.domain.schedule.mapper.ScheduleMapper;
 import site.icebang.domain.schedule.model.Schedule;
 import site.icebang.domain.schedule.service.QuartzScheduleService;
-import site.icebang.domain.workflow.dto.ScheduleCreateDto;
-import site.icebang.domain.workflow.dto.ScheduleDto;
-import site.icebang.domain.workflow.dto.WorkflowCardDto;
-import site.icebang.domain.workflow.dto.WorkflowCreateDto;
-import site.icebang.domain.workflow.dto.WorkflowDetailCardDto;
+import site.icebang.domain.workflow.dto.*;
+import site.icebang.domain.workflow.mapper.JobMapper;
+import site.icebang.domain.workflow.mapper.TaskMapper;
 import site.icebang.domain.workflow.mapper.WorkflowMapper;
 
 /**
@@ -51,6 +49,8 @@ public class WorkflowService implements PageableService<WorkflowCardDto> {
   private final WorkflowMapper workflowMapper;
   private final ScheduleMapper scheduleMapper;
   private final QuartzScheduleService quartzScheduleService;
+  private final JobMapper jobMapper;
+  private final TaskMapper taskMapper;
 
   /**
    * 워크플로우 목록을 페이징 처리하여 조회합니다.
@@ -166,6 +166,60 @@ public void createWorkflow(WorkflowCreateDto dto, BigInteger createdBy) {
     }
   }
 
+  /**
+   * Job 생성
+   *
+   * @param dto Job 생성 정보
+   * @return 생성된 Job 정보
+   * @throws IllegalArgumentException Job 이름이 필수인데 없거나 빈 값일 경우
+   */
+  @Transactional
+  public JobDto createJob(JobDto dto) {
+    if (dto.getName() == null || dto.getName().isBlank()) {
+      throw new IllegalArgumentException("job name is required");
+    }
+    jobMapper.insertJob(dto);
+    return jobMapper.findJobById(dto.getId());
+  }
+
+  /**
+   * Job ID로 Job 조회
+   *
+   * @param id Job ID
+   * @return Job 정보, 없으면 null
+   */
+  @Transactional(readOnly = true)
+  public JobDto findJobById(Long id) {
+    return jobMapper.findJobById(id);
+  }
+
+  /**
+   * Task 생성
+   *
+   * @param dto Task 생성 정보
+   * @return 생성된 Task 정보
+   * @throws IllegalArgumentException Task 이름이 필수인데 없거나 빈 값일 경우
+   */
+  @Transactional
+  public TaskDto createTask(TaskDto dto) {
+    if (dto.getName() == null || dto.getName().isBlank()) {
+      throw new IllegalArgumentException("task name is required");
+    }
+    taskMapper.insertTask(dto);
+    return taskMapper.findTaskById(dto.getId());
+  }
+
+  /**
+   * Task ID로 Task 조회
+   *
+   * @param id Task ID
+   * @return Task 정보, 없으면 null
+   */
+  @Transactional(readOnly = true)
+  public TaskDto findTaskById(Long id) {
+    return taskMapper.findTaskById(id);
+  }
+
   /** 기본 입력값 검증 */
   private void validateBasicInput(WorkflowCreateDto dto, BigInteger createdBy) {
     if (dto == null) {
diff --git a/apps/user-service/src/main/resources/sql/data/03-insert-workflow-h2.sql b/apps/user-service/src/main/resources/sql/data/03-insert-workflow-h2.sql
index a4d4129b..14cac8b0 100644
--- a/apps/user-service/src/main/resources/sql/data/03-insert-workflow-h2.sql
+++ b/apps/user-service/src/main/resources/sql/data/03-insert-workflow-h2.sql
@@ -16,37 +16,38 @@ DELETE FROM `workflow`;
 -- 워크플로우 생성 (ID: 1) - H2에서는 NOW() 사용
 INSERT INTO `workflow` (`id`, `name`, `description`, `created_by`, `default_config`) VALUES
     (1, '상품 분석 및 블로그 자동 발행', '키워드 검색부터 상품 분석 후 블로그 발행까지의 자동화 프로세스', 1,
-     JSON_OBJECT('1',json_object('tag','naver'),'9',json_object('tag','blogger','blog_id', '', 'blog_pw', '')))
-ON DUPLICATE KEY UPDATE
-                     name = VALUES(name),
-                     description = VALUES(description),
-                     updated_at = NOW();
+     JSON_OBJECT('1',json_object('tag','naver'),'10',json_object('tag','blogger','blog_id', '', 'blog_pw', '')))
+    ON DUPLICATE KEY UPDATE
+                         name = VALUES(name),
+                         description = VALUES(description),
+                         updated_at = NOW();
+
 -- Job 생성 (ID: 1, 2) - H2에서는 NOW() 사용
 INSERT INTO `job` (`id`, `name`, `description`, `created_by`) VALUES
-                                                                  (1, '상품 분석', '키워드 검색, 상품 크롤링 및 유사도 분석 작업', 1),
-                                                                  (2, '블로그 콘텐츠 생성', '분석 데이터를 기반으로 RAG 콘텐츠 생성 및 발행 작업', 1)
+                                                                  (1, '상품 분석', '키워드 검색, 상품 크롤링, S3 업로드, OCR 처리 및 상품 선택 작업', 1),
+                                                                  (2, '블로그 콘텐츠 생성', 'OCR 데이터 기반 RAG 콘텐츠 생성 및 발행 작업', 1)
     ON DUPLICATE KEY UPDATE name = VALUES(name), description = VALUES(description), updated_at = NOW();
 
--- Task 생성 (ID: 1 ~ 9) - H2에서는 NOW() 사용
+-- Task 생성 (ID: 1 ~ 10) - H2에서는 NOW() 사용
 INSERT INTO `task` (`id`, `name`, `type`, `parameters`) VALUES
                                                             (1, '키워드 검색 태스크', 'FastAPI', JSON_OBJECT(
                                                                     'endpoint', '/keywords/search', 'method', 'POST',
-                                                                    'body', JSON_OBJECT('tag', 'String') -- { "tag": str }
+                                                                    'body', JSON_OBJECT('tag', 'String')
                                                                                          )),
                                                             (2, '상품 검색 태스크', 'FastAPI', JSON_OBJECT(
                                                                     'endpoint', '/products/search', 'method', 'POST',
-                                                                    'body', JSON_OBJECT('keyword', 'String') -- { "keyword": str }
+                                                                    'body', JSON_OBJECT('keyword', 'String')
                                                                                         )),
                                                             (3, '상품 매칭 태스크', 'FastAPI', JSON_OBJECT(
                                                                     'endpoint', '/products/match', 'method', 'POST',
-                                                                    'body', JSON_OBJECT( -- { keyword: str, search_results: List }
+                                                                    'body', JSON_OBJECT(
                                                                             'keyword', 'String',
                                                                             'search_results', 'List'
                                                                             )
                                                                                         )),
                                                             (4, '상품 유사도 분석 태스크', 'FastAPI', JSON_OBJECT(
                                                                     'endpoint', '/products/similarity', 'method', 'POST',
-                                                                    'body', JSON_OBJECT( -- { keyword: str, matched_products: List, search_results: List }
+                                                                    'body', JSON_OBJECT(
                                                                             'keyword', 'String',
                                                                             'matched_products', 'List',
                                                                             'search_results', 'List'
@@ -54,11 +55,11 @@ INSERT INTO `task` (`id`, `name`, `type`, `parameters`) VALUES
                                                                                             )),
                                                             (5, '상품 정보 크롤링 태스크', 'FastAPI', JSON_OBJECT(
                                                                     'endpoint', '/products/crawl', 'method', 'POST',
-                                                                    'body', JSON_OBJECT('product_urls', 'List') -- { "product_urls": List[str] } 수정됨
+                                                                    'body', JSON_OBJECT('product_urls', 'List')
                                                                                             )),
                                                             (6, 'S3 업로드 태스크', 'FastAPI', JSON_OBJECT(
                                                                     'endpoint', '/products/s3-upload', 'method', 'POST',
-                                                                    'body', JSON_OBJECT( -- { keyword: str, crawled_products: List, base_folder: str }
+                                                                    'body', JSON_OBJECT(
                                                                             'keyword', 'String',
                                                                             'crawled_products', 'List',
                                                                             'base_folder', 'String'
@@ -66,16 +67,26 @@ INSERT INTO `task` (`id`, `name`, `type`, `parameters`) VALUES
                                                                                          )),
                                                             (7, '상품 선택 태스크', 'FastAPI', JSON_OBJECT(
                                                                     'endpoint', '/products/select', 'method', 'POST',
-                                                                    'body', JSON_OBJECT( -- { task_run_id: int, selection_criteria: str }
+                                                                    'body', JSON_OBJECT(
                                                                             'task_run_id', 'Integer',
                                                                             'selection_criteria', 'String'
                                                                             )
                                                                                         )),
-                                                            -- RAG관련 request body는 추후에 결정될 예정
-                                                            (8, '블로그 RAG 생성 태스크', 'FastAPI', JSON_OBJECT('endpoint', '/blogs/rag/create', 'method', 'POST')),
-                                                            (9, '블로그 발행 태스크', 'FastAPI', JSON_OBJECT(
+                                                            (8, '이미지 OCR 태스크', 'FastAPI', JSON_OBJECT(
+                                                                    'endpoint', '/blogs/ocr/extract', 'method', 'POST',
+                                                                    'body', JSON_OBJECT('keyword', 'String')
+                                                                                          )),
+                                                            (9, '블로그 RAG 생성 태스크', 'FastAPI', JSON_OBJECT(
+                                                                    'endpoint', '/blogs/rag/create', 'method', 'POST',
+                                                                    'body', JSON_OBJECT(
+                                                                            'keyword', 'String',
+                                                                            'translation_language', 'String',
+                                                                            'product_info', 'Object'
+                                                                            )
+                                                                                             )),
+                                                            (10, '블로그 발행 태스크', 'FastAPI', JSON_OBJECT(
                                                                     'endpoint', '/blogs/publish', 'method', 'POST',
-                                                                    'body', JSON_OBJECT( -- { tag: str, blog_id: str, ... }
+                                                                    'body', JSON_OBJECT(
                                                                             'tag', 'String',
                                                                             'blog_id', 'String',
                                                                             'blog_pw', 'String',
@@ -84,7 +95,7 @@ INSERT INTO `task` (`id`, `name`, `type`, `parameters`) VALUES
                                                                             'post_content', 'String',
                                                                             'post_tags', 'List'
                                                                             )
-                                                                                         ))
+                                                                                          ))
     ON DUPLICATE KEY UPDATE name = VALUES(name), type = VALUES(type), parameters = VALUES(parameters), updated_at = NOW();
 
 -- ===================================================================
@@ -98,10 +109,10 @@ INSERT INTO `workflow_job` (`workflow_id`, `job_id`, `execution_order`) VALUES
 
 -- Job-Task 연결
 INSERT INTO `job_task` (`job_id`, `task_id`, `execution_order`) VALUES
-                                                                    -- Job 1: 상품 분석 (키워드검색 → 상품검색 → 매칭 → 유사도 → 크롤링 → S3업로드 → 상품선택)
-                                                                    (1, 1, 1), (1, 2, 2), (1, 3, 3), (1, 4, 4), (1, 5, 5), (1, 6, 6), (1, 7, 7),
+                                                                    -- Job 1: 상품 분석 (키워드검색 → 상품검색 → 매칭 → 유사도 → 크롤링 → S3업로드 → 상품선택 → OCR)
+                                                                    (1, 1, 1), (1, 2, 2), (1, 3, 3), (1, 4, 4), (1, 5, 5), (1, 6, 6), (1, 7, 7), (1, 8, 8),
                                                                     -- Job 2: 블로그 콘텐츠 생성 (RAG생성 → 발행)
-                                                                    (2, 8, 1), (2, 9, 2)
+                                                                    (2, 9, 1), (2, 10, 2)
     ON DUPLICATE KEY UPDATE execution_order = VALUES(execution_order);
 
 -- 스케줄 설정 (매일 오전 8시) - H2에서는 NOW() 사용
diff --git a/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/JobApiIntegrationTest.java b/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/JobApiIntegrationTest.java
index 8b923f82..2453aa0f 100644
--- a/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/JobApiIntegrationTest.java
+++ b/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/JobApiIntegrationTest.java
@@ -38,12 +38,12 @@ void createJob_success() throws Exception {
     // given
     String jobRequestJson =
         """
-        {
-          "name": "통합테스트 Job",
-          "description": "Integration Test용 Job",
-          "isEnabled": true
-        }
-        """;
+                {
+                  "name": "통합테스트 Job",
+                  "description": "Integration Test용 Job",
+                  "isEnabled": true
+                }
+                """;
 
     // when & then
     mockMvc
@@ -200,11 +200,11 @@ void createJob_withoutName_shouldFail() throws Exception {
     // given
     String invalidJobRequestJson =
         """
-        {
-          "description": "이름이 없는 Job",
-          "isEnabled": true
-        }
-        """;
+                {
+                  "description": "이름이 없는 Job",
+                  "isEnabled": true
+                }
+                """;
 
     // when & then
     mockMvc
@@ -224,12 +224,12 @@ void createJob_withBlankName_shouldFail() throws Exception {
     // given
     String blankNameJobRequestJson =
         """
-        {
-          "name": "   ",
-          "description": "빈 이름 Job",
-          "isEnabled": true
-        }
-        """;
+                {
+                  "name": "   ",
+                  "description": "빈 이름 Job",
+                  "isEnabled": true
+                }
+                """;
 
     // when & then
     mockMvc
@@ -266,11 +266,11 @@ void createJob_utc_time_validation() throws Exception {
     // given
     String jobRequestJson =
         """
-        {
-          "name": "UTC 시간 검증 Job",
-          "description": "시간대 보정 테스트용 Job"
-        }
-        """;
+                {
+                  "name": "UTC 시간 검증 Job",
+                  "description": "시간대 보정 테스트용 Job"
+                }
+                """;
 
     // when & then
     mockMvc
diff --git a/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/TaskApiIntegrationTest.java b/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/TaskApiIntegrationTest.java
index 09737215..8034cb84 100644
--- a/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/TaskApiIntegrationTest.java
+++ b/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/TaskApiIntegrationTest.java
@@ -24,7 +24,7 @@
     value = {
       "classpath:sql/data/00-truncate.sql",
       "classpath:sql/data/01-insert-internal-users.sql",
-      "classpath:sql/data/03-insert-workflow-h2.sql" // Task 테스트 데이터 포함
+      "classpath:sql/data/03-insert-workflow-h2.sql" // Task 테스트 데이터 포함 (10개 Task)
     },
     executionPhase = Sql.ExecutionPhase.BEFORE_TEST_METHOD)
 @Transactional
@@ -38,15 +38,15 @@ void createTask_success() throws Exception {
     // given
     String taskRequestJson =
         """
-        {
-          "name": "통합테스트 Task",
-          "type": "FastAPI",
-          "parameters": {
-            "endpoint": "/test/api",
-            "method": "POST"
-          }
-        }
-        """;
+                {
+                  "name": "통합테스트 Task",
+                  "type": "FastAPI",
+                  "parameters": {
+                    "endpoint": "/test/api",
+                    "method": "POST"
+                  }
+                }
+                """;
 
     // when & then
     mockMvc
@@ -126,7 +126,7 @@ void createTask_success() throws Exception {
   @DisplayName("Task 조회 성공")
   @WithUserDetails("admin@icebang.site")
   void getTask_success() throws Exception {
-    // given - 03-insert-workflow-h2.sql에서 생성된 Task ID 1 사용
+    // given - 03-insert-workflow-h2.sql에서 생성된 Task ID 1 사용 (키워드 검색 태스크)
     Long taskId = 1L;
 
     // when & then
@@ -195,13 +195,13 @@ void createTask_withoutName_shouldFail() throws Exception {
     // given
     String invalidTaskRequestJson =
         """
-        {
-          "type": "FastAPI",
-          "parameters": {
-            "endpoint": "/test/api"
-          }
-        }
-        """;
+                {
+                  "type": "FastAPI",
+                  "parameters": {
+                    "endpoint": "/test/api"
+                  }
+                }
+                """;
 
     // when & then
     mockMvc
@@ -221,14 +221,14 @@ void createTask_withBlankName_shouldFail() throws Exception {
     // given
     String blankNameTaskRequestJson =
         """
-        {
-          "name": "   ",
-          "type": "FastAPI",
-          "parameters": {
-            "endpoint": "/test/api"
-          }
-        }
-        """;
+                {
+                  "name": "   ",
+                  "type": "FastAPI",
+                  "parameters": {
+                    "endpoint": "/test/api"
+                  }
+                }
+                """;
 
     // when & then
     mockMvc
@@ -265,22 +265,22 @@ void createTask_withComplexJsonParameters() throws Exception {
     // given
     String complexTaskRequestJson =
         """
-        {
-          "name": "복잡한 파라미터 Task",
-          "type": "FastAPI",
-          "parameters": {
-            "endpoint": "/products/similarity",
-            "method": "POST",
-            "body": {
-              "keyword": "String",
-              "matched_products": "List",
-              "search_results": "List"
-            },
-            "timeout": 30,
-            "retries": 3
-          }
-        }
-        """;
+                {
+                  "name": "복잡한 파라미터 Task",
+                  "type": "FastAPI",
+                  "parameters": {
+                    "endpoint": "/products/similarity",
+                    "method": "POST",
+                    "body": {
+                      "keyword": "String",
+                      "matched_products": "List",
+                      "search_results": "List"
+                    },
+                    "timeout": 30,
+                    "retries": 3
+                  }
+                }
+                """;
 
     // when & then
     mockMvc
@@ -296,4 +296,47 @@ void createTask_withComplexJsonParameters() throws Exception {
         .andExpect(jsonPath("$.data.parameters.endpoint").value("/products/similarity"))
         .andExpect(jsonPath("$.data.parameters.body.keyword").value("String"));
   }
+
+  @Test
+  @DisplayName("새로 추가된 OCR Task 조회 (Task ID 8)")
+  @WithUserDetails("admin@icebang.site")
+  void getOcrTask_success() throws Exception {
+    // given - 새로 추가된 이미지 OCR 태스크 (ID: 8)
+    Long ocrTaskId = 8L;
+
+    // when & then
+    mockMvc
+        .perform(
+            get(getApiUrlForDocs("/v0/tasks/{id}"), ocrTaskId)
+                .header("Origin", "https://admin.icebang.site")
+                .header("Referer", "https://admin.icebang.site/"))
+        .andExpect(status().isOk())
+        .andExpect(jsonPath("$.success").value(true))
+        .andExpect(jsonPath("$.data.id").value(ocrTaskId.intValue()))
+        .andExpect(jsonPath("$.data.name").value("이미지 OCR 태스크"))
+        .andExpect(jsonPath("$.data.type").value("FastAPI"))
+        .andExpect(jsonPath("$.data.parameters").exists())
+        .andExpect(jsonPath("$.data.parameters.endpoint").value("/blogs/ocr/extract"));
+  }
+
+  @Test
+  @DisplayName("업데이트된 블로그 발행 Task 조회 (Task ID 10)")
+  @WithUserDetails("admin@icebang.site")
+  void getBlogPublishTask_success() throws Exception {
+    // given - 업데이트된 블로그 발행 태스크 (ID: 10, 기존 9에서 변경)
+    Long publishTaskId = 10L;
+
+    // when & then
+    mockMvc
+        .perform(
+            get(getApiUrlForDocs("/v0/tasks/{id}"), publishTaskId)
+                .header("Origin", "https://admin.icebang.site")
+                .header("Referer", "https://admin.icebang.site/"))
+        .andExpect(status().isOk())
+        .andExpect(jsonPath("$.success").value(true))
+        .andExpect(jsonPath("$.data.id").value(publishTaskId.intValue()))
+        .andExpect(jsonPath("$.data.name").value("블로그 발행 태스크"))
+        .andExpect(jsonPath("$.data.type").value("FastAPI"))
+        .andExpect(jsonPath("$.data.parameters.endpoint").value("/blogs/publish"));
+  }
 }

From 1ad18d481a84939692ac606cf5123722378394e0 Mon Sep 17 00:00:00 2001
From: thkim7 <xogusrla7@gmail.com>
Date: Sun, 28 Sep 2025 05:57:37 +0900
Subject: [PATCH 07/12] =?UTF-8?q?fix:=20Job/Task=20CRUD=20IntegrationTest?=
 =?UTF-8?q?=20=ED=86=B5=EA=B3=BC=EB=A5=BC=20=EC=9C=84=ED=95=9C=20=EC=88=98?=
 =?UTF-8?q?=EC=A0=95=201.=20h2.sql=20task=209=EA=B0=9C=20->=2010=EA=B0=9C?=
 =?UTF-8?q?=202.=20JobApiIntegrationTest=EB=8A=94=20=EB=AA=A8=EB=91=90=20?=
 =?UTF-8?q?=ED=86=B5=EA=B3=BC=203.=20TaskApiIntegrationTest=EB=8A=94=20?=
 =?UTF-8?q?=EC=9E=90=EA=BE=B8=20Json=20=EC=A7=81=EB=A0=AC=ED=99=94=20?=
 =?UTF-8?q?=EB=95=8C=EB=AC=B8=EC=97=90=20=ED=86=B5=EA=B3=BC=EB=A5=BC=20?=
 =?UTF-8?q?=EB=AA=BB=ED=95=A8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../workflow/controller/JobController.java    |   3 +-
 .../workflow/controller/TaskController.java   |   3 +-
 .../icebang/domain/workflow/dto/JobDto.java   |   4 +
 .../icebang/domain/workflow/dto/TaskDto.java  |   4 +
 .../icebang/domain/workflow/model/Job.java    |   2 +-
 .../workflow/service/WorkflowService.java     |  28 ++++
 .../exception/GlobalExceptionHandler.java     |  13 ++
 .../resources/mybatis/mapper/TaskMapper.xml   |  21 ++-
 .../sql/data/03-insert-workflow-h2.sql        | 142 +++++++++---------
 .../tests/workflow/JobApiIntegrationTest.java |   3 +-
 .../workflow/TaskApiIntegrationTest.java      |  24 +++
 11 files changed, 165 insertions(+), 82 deletions(-)

diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/JobController.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/JobController.java
index a9bb3157..e8f12f01 100644
--- a/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/JobController.java
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/JobController.java
@@ -6,6 +6,7 @@
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.*;
 
+import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
 
 import site.icebang.domain.workflow.dto.JobDto;
@@ -19,7 +20,7 @@ public class JobController {
   private final WorkflowService workflowService;
 
   @PostMapping
-  public ResponseEntity<Map<String, Object>> createJob(@RequestBody JobDto dto) {
+  public ResponseEntity<Map<String, Object>> createJob(@Valid @RequestBody JobDto dto) {
     JobDto created = workflowService.createJob(dto);
     return ResponseEntity.status(HttpStatus.CREATED).body(Map.of("success", true, "data", created));
   }
diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/TaskController.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/TaskController.java
index ffd57e40..fd3ce8f4 100644
--- a/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/TaskController.java
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/TaskController.java
@@ -6,6 +6,7 @@
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.*;
 
+import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
 
 import site.icebang.domain.workflow.dto.TaskDto;
@@ -19,7 +20,7 @@ public class TaskController {
   private final WorkflowService workflowService;
 
   @PostMapping
-  public ResponseEntity<Map<String, Object>> createTask(@RequestBody TaskDto dto) {
+  public ResponseEntity<Map<String, Object>> createTask(@Valid @RequestBody TaskDto dto) {
     TaskDto created = workflowService.createTask(dto);
     return ResponseEntity.status(HttpStatus.CREATED).body(Map.of("success", true, "data", created));
   }
diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/dto/JobDto.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/dto/JobDto.java
index 035d6d17..8911a4e7 100644
--- a/apps/user-service/src/main/java/site/icebang/domain/workflow/dto/JobDto.java
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/dto/JobDto.java
@@ -2,12 +2,16 @@
 
 import java.time.Instant;
 
+import jakarta.validation.constraints.NotBlank;
 import lombok.Data;
 
 @Data
 public class JobDto {
   private Long id;
+
+  @NotBlank(message = "Job 이름은 필수입니다")
   private String name;
+
   private String description;
   private Boolean isEnabled;
   private Instant createdAt;
diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/dto/TaskDto.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/dto/TaskDto.java
index 1047d141..8d323f3b 100644
--- a/apps/user-service/src/main/java/site/icebang/domain/workflow/dto/TaskDto.java
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/dto/TaskDto.java
@@ -4,12 +4,16 @@
 
 import com.fasterxml.jackson.databind.JsonNode;
 
+import jakarta.validation.constraints.NotBlank;
 import lombok.Data;
 
 @Data
 public class TaskDto {
   private Long id;
+
+  @NotBlank(message = "Task 이름은 필수입니다")
   private String name;
+
   private String type;
   private Integer executionOrder;
   private JsonNode settings;
diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/model/Job.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/model/Job.java
index c363f8de..41cd5fa8 100644
--- a/apps/user-service/src/main/java/site/icebang/domain/workflow/model/Job.java
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/model/Job.java
@@ -26,7 +26,7 @@ public Job(JobDto dto) {
     this.id = dto.getId();
     this.name = dto.getName();
     this.description = dto.getDescription();
-    this.isEnabled = dto.getIsEnabled();
+    this.isEnabled = Boolean.TRUE.equals(dto.getIsEnabled());
     this.createdAt = dto.getCreatedAt();
     this.updatedAt = dto.getUpdatedAt();
   }
diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/service/WorkflowService.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/service/WorkflowService.java
index 433981d6..69a55002 100644
--- a/apps/user-service/src/main/java/site/icebang/domain/workflow/service/WorkflowService.java
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/service/WorkflowService.java
@@ -1,6 +1,7 @@
 package site.icebang.domain.workflow.service;
 
 import java.math.BigInteger;
+import java.time.Instant;
 import java.util.HashMap;
 import java.util.HashSet;
 import java.util.List;
@@ -175,10 +176,24 @@ public void createWorkflow(WorkflowCreateDto dto, BigInteger createdBy) {
    */
   @Transactional
   public JobDto createJob(JobDto dto) {
+    // 1. 유효성 검증
     if (dto.getName() == null || dto.getName().isBlank()) {
       throw new IllegalArgumentException("job name is required");
     }
+
+    // 2. 시간 정보 설정
+    Instant now = Instant.now();
+    dto.setCreatedAt(now);
+    dto.setUpdatedAt(now);
+
+    // 3. 생성자 정보 설정 (현재 사용자 정보가 없으므로 기본값 또는 추후 개선)
+    // dto.setCreatedBy(getCurrentUserId());
+    // dto.setUpdatedBy(getCurrentUserId());
+
+    // 4. DB 저장
     jobMapper.insertJob(dto);
+
+    // 5. 저장된 Job 반환
     return jobMapper.findJobById(dto.getId());
   }
 
@@ -202,10 +217,23 @@ public JobDto findJobById(Long id) {
    */
   @Transactional
   public TaskDto createTask(TaskDto dto) {
+    // 1. 유효성 검증
     if (dto.getName() == null || dto.getName().isBlank()) {
       throw new IllegalArgumentException("task name is required");
     }
+    // 2. 시간 정보 설정
+    Instant now = Instant.now();
+    dto.setCreatedAt(now);
+    dto.setUpdatedAt(now);
+
+    // 3. 생성자 정보 설정 (현재 사용자 정보가 없으므로 기본값 또는 추후 개선)
+    // dto.setCreatedBy(getCurrentUserId());
+    // dto.setUpdatedBy(getCurrentUserId());
+
+    // 4. DB 저장
     taskMapper.insertTask(dto);
+
+    // 5. 저장된 Task 반환
     return taskMapper.findTaskById(dto.getId());
   }
 
diff --git a/apps/user-service/src/main/java/site/icebang/global/handler/exception/GlobalExceptionHandler.java b/apps/user-service/src/main/java/site/icebang/global/handler/exception/GlobalExceptionHandler.java
index 485e7e1e..1c064368 100644
--- a/apps/user-service/src/main/java/site/icebang/global/handler/exception/GlobalExceptionHandler.java
+++ b/apps/user-service/src/main/java/site/icebang/global/handler/exception/GlobalExceptionHandler.java
@@ -118,4 +118,17 @@ public ApiResponse<String> handleDuplicateData(DuplicateDataException ex) {
     log.warn(ex.getMessage(), ex);
     return ApiResponse.error("Duplicate: " + ex.getMessage(), HttpStatus.CONFLICT);
   }
+
+  /**
+   * IllegalArgumentException을 400 Bad Request로 처리합니다. WorkflowService에서 던지는 검증 오류를 처리하기 위해 추가되었습니다.
+   *
+   * @param ex 발생한 {@link IllegalArgumentException}
+   * @return {@link ApiResponse} - 검증 실패 메시지와 {@link HttpStatus#BAD_REQUEST}
+   */
+  @ExceptionHandler(IllegalArgumentException.class)
+  @ResponseStatus(HttpStatus.BAD_REQUEST)
+  public ApiResponse<String> handleIllegalArgument(IllegalArgumentException ex) {
+    log.warn("Validation failed: {}", ex.getMessage());
+    return ApiResponse.error("입력값 검증 실패: " + ex.getMessage(), HttpStatus.BAD_REQUEST);
+  }
 }
diff --git a/apps/user-service/src/main/resources/mybatis/mapper/TaskMapper.xml b/apps/user-service/src/main/resources/mybatis/mapper/TaskMapper.xml
index dd0c500d..6568aa94 100644
--- a/apps/user-service/src/main/resources/mybatis/mapper/TaskMapper.xml
+++ b/apps/user-service/src/main/resources/mybatis/mapper/TaskMapper.xml
@@ -12,6 +12,17 @@
         <result property="updatedAt" column="updated_at" javaType="java.time.Instant" jdbcType="TIMESTAMP" typeHandler="site.icebang.global.config.mybatis.typehandler.InstantTypeHandler"/>
     </resultMap>
 
+    <resultMap id="TaskDtoResultMap" type="site.icebang.domain.workflow.dto.TaskDto">
+        <id property="id" column="id"/>
+        <result property="name" column="name"/>
+        <result property="type" column="type"/>
+        <result property="parameters" column="parameters" javaType="com.fasterxml.jackson.databind.JsonNode" jdbcType="VARCHAR" typeHandler="site.icebang.global.config.mybatis.typehandler.JsonNodeTypeHandler"/>
+        <result property="createdAt" column="created_at" javaType="java.time.Instant" jdbcType="TIMESTAMP" typeHandler="site.icebang.global.config.mybatis.typehandler.InstantTypeHandler"/>
+        <result property="updatedAt" column="updated_at" javaType="java.time.Instant" jdbcType="TIMESTAMP" typeHandler="site.icebang.global.config.mybatis.typehandler.InstantTypeHandler"/>
+        <result property="executionOrder" column="execution_order"/>
+        <result property="settings" column="settings" javaType="com.fasterxml.jackson.databind.JsonNode" jdbcType="VARCHAR" typeHandler="site.icebang.global.config.mybatis.typehandler.JsonNodeTypeHandler"/>
+    </resultMap>
+
     <insert id="insertTask" parameterType="site.icebang.domain.workflow.dto.TaskDto"
             useGeneratedKeys="true" keyProperty="id">
         INSERT INTO task (
@@ -19,17 +30,13 @@
             type,
             parameters,
             created_at,
-            created_by,
-            updated_at,
-            updated_by
+            updated_at
         ) VALUES (
                      #{name},
                      #{type},
-                     #{parameters},
+                     #{parameters, javaType=com.fasterxml.jackson.databind.JsonNode, jdbcType=VARCHAR, typeHandler=site.icebang.global.config.mybatis.typehandler.JsonNodeTypeHandler},
                      #{createdAt},
-                     #{createdBy},
-                     #{updatedAt},
-                     #{updatedBy}
+                     #{updatedAt}
                  )
     </insert>
 
diff --git a/apps/user-service/src/main/resources/sql/data/03-insert-workflow-h2.sql b/apps/user-service/src/main/resources/sql/data/03-insert-workflow-h2.sql
index 14cac8b0..c2dda2b3 100644
--- a/apps/user-service/src/main/resources/sql/data/03-insert-workflow-h2.sql
+++ b/apps/user-service/src/main/resources/sql/data/03-insert-workflow-h2.sql
@@ -23,79 +23,79 @@ INSERT INTO `workflow` (`id`, `name`, `description`, `created_by`, `default_conf
                          updated_at = NOW();
 
 -- Job 생성 (ID: 1, 2) - H2에서는 NOW() 사용
-INSERT INTO `job` (`id`, `name`, `description`, `created_by`) VALUES
-                                                                  (1, '상품 분석', '키워드 검색, 상품 크롤링, S3 업로드, OCR 처리 및 상품 선택 작업', 1),
-                                                                  (2, '블로그 콘텐츠 생성', 'OCR 데이터 기반 RAG 콘텐츠 생성 및 발행 작업', 1)
+INSERT INTO `job` (`id`, `name`, `description`, `created_by`, `created_at`, `updated_at`) VALUES
+                                                                                              (1, '상품 분석', '키워드 검색, 상품 크롤링, S3 업로드, OCR 처리 및 상품 선택 작업', 1, NOW(), NOW()),
+                                                                                              (2, '블로그 콘텐츠 생성', 'OCR 데이터 기반 RAG 콘텐츠 생성 및 발행 작업', 1, NOW(), NOW())
     ON DUPLICATE KEY UPDATE name = VALUES(name), description = VALUES(description), updated_at = NOW();
 
--- Task 생성 (ID: 1 ~ 10) - H2에서는 NOW() 사용
-INSERT INTO `task` (`id`, `name`, `type`, `parameters`) VALUES
-                                                            (1, '키워드 검색 태스크', 'FastAPI', JSON_OBJECT(
-                                                                    'endpoint', '/keywords/search', 'method', 'POST',
-                                                                    'body', JSON_OBJECT('tag', 'String')
-                                                                                         )),
-                                                            (2, '상품 검색 태스크', 'FastAPI', JSON_OBJECT(
-                                                                    'endpoint', '/products/search', 'method', 'POST',
-                                                                    'body', JSON_OBJECT('keyword', 'String')
-                                                                                        )),
-                                                            (3, '상품 매칭 태스크', 'FastAPI', JSON_OBJECT(
-                                                                    'endpoint', '/products/match', 'method', 'POST',
-                                                                    'body', JSON_OBJECT(
-                                                                            'keyword', 'String',
-                                                                            'search_results', 'List'
-                                                                            )
-                                                                                        )),
-                                                            (4, '상품 유사도 분석 태스크', 'FastAPI', JSON_OBJECT(
-                                                                    'endpoint', '/products/similarity', 'method', 'POST',
-                                                                    'body', JSON_OBJECT(
-                                                                            'keyword', 'String',
-                                                                            'matched_products', 'List',
-                                                                            'search_results', 'List'
-                                                                            )
-                                                                                            )),
-                                                            (5, '상품 정보 크롤링 태스크', 'FastAPI', JSON_OBJECT(
-                                                                    'endpoint', '/products/crawl', 'method', 'POST',
-                                                                    'body', JSON_OBJECT('product_urls', 'List')
-                                                                                            )),
-                                                            (6, 'S3 업로드 태스크', 'FastAPI', JSON_OBJECT(
-                                                                    'endpoint', '/products/s3-upload', 'method', 'POST',
-                                                                    'body', JSON_OBJECT(
-                                                                            'keyword', 'String',
-                                                                            'crawled_products', 'List',
-                                                                            'base_folder', 'String'
-                                                                            )
-                                                                                         )),
-                                                            (7, '상품 선택 태스크', 'FastAPI', JSON_OBJECT(
-                                                                    'endpoint', '/products/select', 'method', 'POST',
-                                                                    'body', JSON_OBJECT(
-                                                                            'task_run_id', 'Integer',
-                                                                            'selection_criteria', 'String'
-                                                                            )
-                                                                                        )),
-                                                            (8, '이미지 OCR 태스크', 'FastAPI', JSON_OBJECT(
-                                                                    'endpoint', '/blogs/ocr/extract', 'method', 'POST',
-                                                                    'body', JSON_OBJECT('keyword', 'String')
-                                                                                          )),
-                                                            (9, '블로그 RAG 생성 태스크', 'FastAPI', JSON_OBJECT(
-                                                                    'endpoint', '/blogs/rag/create', 'method', 'POST',
-                                                                    'body', JSON_OBJECT(
-                                                                            'keyword', 'String',
-                                                                            'translation_language', 'String',
-                                                                            'product_info', 'Object'
-                                                                            )
-                                                                                             )),
-                                                            (10, '블로그 발행 태스크', 'FastAPI', JSON_OBJECT(
-                                                                    'endpoint', '/blogs/publish', 'method', 'POST',
-                                                                    'body', JSON_OBJECT(
-                                                                            'tag', 'String',
-                                                                            'blog_id', 'String',
-                                                                            'blog_pw', 'String',
-                                                                            'blog_name', 'String',
-                                                                            'post_title', 'String',
-                                                                            'post_content', 'String',
-                                                                            'post_tags', 'List'
-                                                                            )
-                                                                                          ))
+-- Task 생성 (ID: 1 ~ 10) - H2에서는 NOW() 사용, created_at/updated_at 추가
+INSERT INTO `task` (`id`, `name`, `type`, `parameters`, `created_at`, `updated_at`) VALUES
+                                                                                        (1, '키워드 검색 태스크', 'FastAPI', JSON_OBJECT(
+                                                                                                'endpoint', '/keywords/search', 'method', 'POST',
+                                                                                                'body', JSON_OBJECT('tag', 'String')
+                                                                                                                     ), NOW(), NOW()),
+                                                                                        (2, '상품 검색 태스크', 'FastAPI', JSON_OBJECT(
+                                                                                                'endpoint', '/products/search', 'method', 'POST',
+                                                                                                'body', JSON_OBJECT('keyword', 'String')
+                                                                                                                    ), NOW(), NOW()),
+                                                                                        (3, '상품 매칭 태스크', 'FastAPI', JSON_OBJECT(
+                                                                                                'endpoint', '/products/match', 'method', 'POST',
+                                                                                                'body', JSON_OBJECT(
+                                                                                                        'keyword', 'String',
+                                                                                                        'search_results', 'List'
+                                                                                                        )
+                                                                                                                    ), NOW(), NOW()),
+                                                                                        (4, '상품 유사도 분석 태스크', 'FastAPI', JSON_OBJECT(
+                                                                                                'endpoint', '/products/similarity', 'method', 'POST',
+                                                                                                'body', JSON_OBJECT(
+                                                                                                        'keyword', 'String',
+                                                                                                        'matched_products', 'List',
+                                                                                                        'search_results', 'List'
+                                                                                                        )
+                                                                                                                        ), NOW(), NOW()),
+                                                                                        (5, '상품 정보 크롤링 태스크', 'FastAPI', JSON_OBJECT(
+                                                                                                'endpoint', '/products/crawl', 'method', 'POST',
+                                                                                                'body', JSON_OBJECT('product_urls', 'List')
+                                                                                                                        ), NOW(), NOW()),
+                                                                                        (6, 'S3 업로드 태스크', 'FastAPI', JSON_OBJECT(
+                                                                                                'endpoint', '/products/s3-upload', 'method', 'POST',
+                                                                                                'body', JSON_OBJECT(
+                                                                                                        'keyword', 'String',
+                                                                                                        'crawled_products', 'List',
+                                                                                                        'base_folder', 'String'
+                                                                                                        )
+                                                                                                                     ), NOW(), NOW()),
+                                                                                        (7, '상품 선택 태스크', 'FastAPI', JSON_OBJECT(
+                                                                                                'endpoint', '/products/select', 'method', 'POST',
+                                                                                                'body', JSON_OBJECT(
+                                                                                                        'task_run_id', 'Integer',
+                                                                                                        'selection_criteria', 'String'
+                                                                                                        )
+                                                                                                                    ), NOW(), NOW()),
+                                                                                        (8, '이미지 OCR 태스크', 'FastAPI', JSON_OBJECT(
+                                                                                                'endpoint', '/blogs/ocr/extract', 'method', 'POST',
+                                                                                                'body', JSON_OBJECT('keyword', 'String')
+                                                                                                                      ), NOW(), NOW()),
+                                                                                        (9, '블로그 RAG 생성 태스크', 'FastAPI', JSON_OBJECT(
+                                                                                                'endpoint', '/blogs/rag/create', 'method', 'POST',
+                                                                                                'body', JSON_OBJECT(
+                                                                                                        'keyword', 'String',
+                                                                                                        'translation_language', 'String',
+                                                                                                        'product_info', 'Object'
+                                                                                                        )
+                                                                                                                         ), NOW(), NOW()),
+                                                                                        (10, '블로그 발행 태스크', 'FastAPI', JSON_OBJECT(
+                                                                                                'endpoint', '/blogs/publish', 'method', 'POST',
+                                                                                                'body', JSON_OBJECT(
+                                                                                                        'tag', 'String',
+                                                                                                        'blog_id', 'String',
+                                                                                                        'blog_pw', 'String',
+                                                                                                        'blog_name', 'String',
+                                                                                                        'post_title', 'String',
+                                                                                                        'post_content', 'String',
+                                                                                                        'post_tags', 'List'
+                                                                                                        )
+                                                                                                                      ), NOW(), NOW())
     ON DUPLICATE KEY UPDATE name = VALUES(name), type = VALUES(type), parameters = VALUES(parameters), updated_at = NOW();
 
 -- ===================================================================
diff --git a/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/JobApiIntegrationTest.java b/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/JobApiIntegrationTest.java
index 2453aa0f..efd471cc 100644
--- a/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/JobApiIntegrationTest.java
+++ b/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/JobApiIntegrationTest.java
@@ -140,7 +140,8 @@ void getJob_success() throws Exception {
         .andExpect(jsonPath("$.success").value(true))
         .andExpect(jsonPath("$.data.id").value(jobId.intValue()))
         .andExpect(jsonPath("$.data.name").value("상품 분석"))
-        .andExpect(jsonPath("$.data.description").value("키워드 검색, 상품 크롤링 및 유사도 분석 작업"))
+        .andExpect(
+            jsonPath("$.data.description").value("키워드 검색, 상품 크롤링, S3 업로드, OCR 처리 및 상품 선택 작업"))
         .andExpect(jsonPath("$.data.createdAt").exists())
         .andExpect(jsonPath("$.data.updatedAt").exists())
         .andDo(
diff --git a/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/TaskApiIntegrationTest.java b/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/TaskApiIntegrationTest.java
index 8034cb84..069cfd1f 100644
--- a/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/TaskApiIntegrationTest.java
+++ b/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/TaskApiIntegrationTest.java
@@ -84,6 +84,14 @@ void createTask_success() throws Exception {
                             fieldWithPath("parameters")
                                 .type(JsonFieldType.OBJECT)
                                 .description("Task 실행에 필요한 파라미터 (JSON 형태)")
+                                .optional(),
+                            fieldWithPath("parameters.endpoint")
+                                .type(JsonFieldType.STRING)
+                                .description("API 엔드포인트")
+                                .optional(),
+                            fieldWithPath("parameters.method")
+                                .type(JsonFieldType.STRING)
+                                .description("HTTP 메소드")
                                 .optional())
                         .responseFields(
                             fieldWithPath("success")
@@ -171,6 +179,22 @@ void getTask_success() throws Exception {
                                 .type(JsonFieldType.OBJECT)
                                 .description("Task 파라미터")
                                 .optional(),
+                            fieldWithPath("data.parameters.endpoint")
+                                .type(JsonFieldType.STRING)
+                                .description("API 엔드포인트")
+                                .optional(),
+                            fieldWithPath("data.parameters.method")
+                                .type(JsonFieldType.STRING)
+                                .description("HTTP 메소드")
+                                .optional(),
+                            fieldWithPath("data.parameters.body")
+                                .type(JsonFieldType.OBJECT)
+                                .description("요청 본문")
+                                .optional(),
+                            fieldWithPath("data.parameters.body.tag")
+                                .type(JsonFieldType.STRING)
+                                .description("태그 값")
+                                .optional(),
                             fieldWithPath("data.executionOrder")
                                 .type(JsonFieldType.NUMBER)
                                 .description("실행 순서")

From b69e36a3bc391c5e9514b338c38bd9bc3d58e654 Mon Sep 17 00:00:00 2001
From: jihukimme <jihu0210@naver.com>
Date: Mon, 29 Sep 2025 12:44:54 +0900
Subject: [PATCH 08/12] =?UTF-8?q?refactor:=20test=20=EC=BD=94=EB=93=9C=20?=
 =?UTF-8?q?=EC=A0=95=EC=83=81=20=EB=8F=99=EC=9E=91=ED=95=98=EB=8F=84?=
 =?UTF-8?q?=EB=A1=9D=20=EC=88=98=EC=A0=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../icebang/domain/workflow/model/Task.java   |   2 +
 .../workflow/TaskApiIntegrationTest.java      | 395 +++---------------
 .../WorkflowHistoryApiIntegrationTest.java    | 367 ++++------------
 3 files changed, 151 insertions(+), 613 deletions(-)

diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/model/Task.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/model/Task.java
index 04d577c1..bfa1b96f 100644
--- a/apps/user-service/src/main/java/site/icebang/domain/workflow/model/Task.java
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/model/Task.java
@@ -36,5 +36,7 @@ public Task(TaskDto taskDto) {
     this.type = taskDto.getType();
     this.settings = taskDto.getSettings();
     this.parameters = taskDto.getParameters();
+    this.createdAt = taskDto.getCreatedAt();
+    this.updatedAt = taskDto.getUpdatedAt();
   }
 }
diff --git a/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/TaskApiIntegrationTest.java b/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/TaskApiIntegrationTest.java
index 069cfd1f..3f7c1311 100644
--- a/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/TaskApiIntegrationTest.java
+++ b/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/TaskApiIntegrationTest.java
@@ -1,366 +1,89 @@
 package site.icebang.integration.tests.workflow;
 
-import static com.epages.restdocs.apispec.MockMvcRestDocumentationWrapper.document;
-import static com.epages.restdocs.apispec.ResourceDocumentation.*;
-import static org.springframework.restdocs.mockmvc.RestDocumentationRequestBuilders.get;
-import static org.springframework.restdocs.mockmvc.RestDocumentationRequestBuilders.post;
-import static org.springframework.restdocs.operation.preprocess.Preprocessors.*;
-import static org.springframework.restdocs.payload.PayloadDocumentation.*;
-import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
-
+import com.fasterxml.jackson.databind.ObjectMapper;
 import org.junit.jupiter.api.DisplayName;
 import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.http.MediaType;
-import org.springframework.restdocs.payload.JsonFieldType;
-import org.springframework.security.test.context.support.WithUserDetails;
-import org.springframework.test.context.jdbc.Sql;
-import org.springframework.transaction.annotation.Transactional;
-
-import com.epages.restdocs.apispec.ResourceSnippetParameters;
-
+import org.springframework.security.test.context.support.WithMockUser;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+import site.icebang.domain.workflow.dto.TaskDto;
+import site.icebang.domain.workflow.service.WorkflowService;
 import site.icebang.integration.setup.support.IntegrationTestSupport;
 
-@Sql(
-    value = {
-      "classpath:sql/data/00-truncate.sql",
-      "classpath:sql/data/01-insert-internal-users.sql",
-      "classpath:sql/data/03-insert-workflow-h2.sql" // Task 테스트 데이터 포함 (10개 Task)
-    },
-    executionPhase = Sql.ExecutionPhase.BEFORE_TEST_METHOD)
-@Transactional
-@DisplayName("Task API 통합 테스트")
-public class TaskApiIntegrationTest extends IntegrationTestSupport {
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.when;
+import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
+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;
 
-  @Test
-  @DisplayName("Task 생성 성공")
-  @WithUserDetails("admin@icebang.site")
-  void createTask_success() throws Exception {
-    // given
-    String taskRequestJson =
-        """
-                {
-                  "name": "통합테스트 Task",
-                  "type": "FastAPI",
-                  "parameters": {
-                    "endpoint": "/test/api",
-                    "method": "POST"
-                  }
-                }
-                """;
-
-    // when & then
-    mockMvc
-        .perform(
-            post(getApiUrlForDocs("/v0/tasks"))
-                .header("Origin", "https://admin.icebang.site")
-                .header("Referer", "https://admin.icebang.site/")
-                .contentType(MediaType.APPLICATION_JSON)
-                .content(taskRequestJson))
-        .andExpect(status().isCreated())
-        .andExpect(jsonPath("$.success").value(true))
-        .andExpect(jsonPath("$.data.id").exists())
-        .andExpect(jsonPath("$.data.name").value("통합테스트 Task"))
-        .andExpect(jsonPath("$.data.type").value("FastAPI"))
-        .andExpect(jsonPath("$.data.parameters").exists())
-        .andExpect(jsonPath("$.data.createdAt").exists())
-        .andExpect(jsonPath("$.data.updatedAt").exists())
-        .andDo(
-            document(
-                "task-create",
-                preprocessRequest(prettyPrint()),
-                preprocessResponse(prettyPrint()),
-                resource(
-                    ResourceSnippetParameters.builder()
-                        .tag("Task")
-                        .summary("Task 생성")
-                        .description("새로운 Task를 생성합니다")
-                        .requestFields(
-                            fieldWithPath("name")
-                                .type(JsonFieldType.STRING)
-                                .description("Task 이름 (필수)"),
-                            fieldWithPath("type")
-                                .type(JsonFieldType.STRING)
-                                .description("Task 타입 (예: FastAPI, Shell 등)"),
-                            fieldWithPath("parameters")
-                                .type(JsonFieldType.OBJECT)
-                                .description("Task 실행에 필요한 파라미터 (JSON 형태)")
-                                .optional(),
-                            fieldWithPath("parameters.endpoint")
-                                .type(JsonFieldType.STRING)
-                                .description("API 엔드포인트")
-                                .optional(),
-                            fieldWithPath("parameters.method")
-                                .type(JsonFieldType.STRING)
-                                .description("HTTP 메소드")
-                                .optional())
-                        .responseFields(
-                            fieldWithPath("success")
-                                .type(JsonFieldType.BOOLEAN)
-                                .description("요청 성공 여부"),
-                            fieldWithPath("data")
-                                .type(JsonFieldType.OBJECT)
-                                .description("생성된 Task 정보"),
-                            fieldWithPath("data.id")
-                                .type(JsonFieldType.NUMBER)
-                                .description("Task ID"),
-                            fieldWithPath("data.name")
-                                .type(JsonFieldType.STRING)
-                                .description("Task 이름"),
-                            fieldWithPath("data.type")
-                                .type(JsonFieldType.STRING)
-                                .description("Task 타입"),
-                            fieldWithPath("data.parameters")
-                                .type(JsonFieldType.OBJECT)
-                                .description("Task 파라미터")
-                                .optional(),
-                            fieldWithPath("data.executionOrder")
-                                .type(JsonFieldType.NUMBER)
-                                .description("실행 순서")
-                                .optional(),
-                            fieldWithPath("data.settings")
-                                .type(JsonFieldType.OBJECT)
-                                .description("Task 설정")
-                                .optional(),
-                            fieldWithPath("data.createdAt")
-                                .type(JsonFieldType.STRING)
-                                .description("생성 시간"),
-                            fieldWithPath("data.updatedAt")
-                                .type(JsonFieldType.STRING)
-                                .description("수정 시간"))
-                        .build())));
-  }
-
-  @Test
-  @DisplayName("Task 조회 성공")
-  @WithUserDetails("admin@icebang.site")
-  void getTask_success() throws Exception {
-    // given - 03-insert-workflow-h2.sql에서 생성된 Task ID 1 사용 (키워드 검색 태스크)
-    Long taskId = 1L;
-
-    // when & then
-    mockMvc
-        .perform(
-            get(getApiUrlForDocs("/v0/tasks/{id}"), taskId)
-                .header("Origin", "https://admin.icebang.site")
-                .header("Referer", "https://admin.icebang.site/"))
-        .andExpect(status().isOk())
-        .andExpect(jsonPath("$.success").value(true))
-        .andExpect(jsonPath("$.data.id").value(taskId.intValue()))
-        .andExpect(jsonPath("$.data.name").value("키워드 검색 태스크"))
-        .andExpect(jsonPath("$.data.type").value("FastAPI"))
-        .andExpect(jsonPath("$.data.parameters").exists())
-        .andExpect(jsonPath("$.data.createdAt").exists())
-        .andExpect(jsonPath("$.data.updatedAt").exists())
-        .andDo(
-            document(
-                "task-get",
-                preprocessRequest(prettyPrint()),
-                preprocessResponse(prettyPrint()),
-                resource(
-                    ResourceSnippetParameters.builder()
-                        .tag("Task")
-                        .summary("Task 조회")
-                        .description("Task ID로 Task 정보를 조회합니다")
-                        .responseFields(
-                            fieldWithPath("success")
-                                .type(JsonFieldType.BOOLEAN)
-                                .description("요청 성공 여부"),
-                            fieldWithPath("data").type(JsonFieldType.OBJECT).description("Task 정보"),
-                            fieldWithPath("data.id")
-                                .type(JsonFieldType.NUMBER)
-                                .description("Task ID"),
-                            fieldWithPath("data.name")
-                                .type(JsonFieldType.STRING)
-                                .description("Task 이름"),
-                            fieldWithPath("data.type")
-                                .type(JsonFieldType.STRING)
-                                .description("Task 타입"),
-                            fieldWithPath("data.parameters")
-                                .type(JsonFieldType.OBJECT)
-                                .description("Task 파라미터")
-                                .optional(),
-                            fieldWithPath("data.parameters.endpoint")
-                                .type(JsonFieldType.STRING)
-                                .description("API 엔드포인트")
-                                .optional(),
-                            fieldWithPath("data.parameters.method")
-                                .type(JsonFieldType.STRING)
-                                .description("HTTP 메소드")
-                                .optional(),
-                            fieldWithPath("data.parameters.body")
-                                .type(JsonFieldType.OBJECT)
-                                .description("요청 본문")
-                                .optional(),
-                            fieldWithPath("data.parameters.body.tag")
-                                .type(JsonFieldType.STRING)
-                                .description("태그 값")
-                                .optional(),
-                            fieldWithPath("data.executionOrder")
-                                .type(JsonFieldType.NUMBER)
-                                .description("실행 순서")
-                                .optional(),
-                            fieldWithPath("data.settings")
-                                .type(JsonFieldType.OBJECT)
-                                .description("Task 설정")
-                                .optional(),
-                            fieldWithPath("data.createdAt")
-                                .type(JsonFieldType.STRING)
-                                .description("생성 시간"),
-                            fieldWithPath("data.updatedAt")
-                                .type(JsonFieldType.STRING)
-                                .description("수정 시간"))
-                        .build())));
-  }
+public class TaskApiIntegrationTest extends IntegrationTestSupport {
 
-  @Test
-  @DisplayName("Task 이름 없이 생성 시 실패")
-  @WithUserDetails("admin@icebang.site")
-  void createTask_withoutName_shouldFail() throws Exception {
-    // given
-    String invalidTaskRequestJson =
-        """
-                {
-                  "type": "FastAPI",
-                  "parameters": {
-                    "endpoint": "/test/api"
-                  }
-                }
-                """;
+  @Autowired
+  private ObjectMapper objectMapper;
 
-    // when & then
-    mockMvc
-        .perform(
-            post(getApiUrlForDocs("/v0/tasks"))
-                .header("Origin", "https://admin.icebang.site")
-                .header("Referer", "https://admin.icebang.site/")
-                .contentType(MediaType.APPLICATION_JSON)
-                .content(invalidTaskRequestJson))
-        .andExpect(status().isBadRequest());
-  }
+  @MockitoBean
+  private WorkflowService workflowService;
 
   @Test
-  @DisplayName("빈 문자열 이름으로 Task 생성 시 실패")
-  @WithUserDetails("admin@icebang.site")
-  void createTask_withBlankName_shouldFail() throws Exception {
+  @DisplayName("Task 생성 API - 성공")
+  @WithMockUser(roles = "SUPER_ADMIN") // 📌 DB 조회 없이 'SUPER_ADMIN' 권한을 가진 가상 유저로 인증
+  void createTask_success() throws Exception {
     // given
-    String blankNameTaskRequestJson =
-        """
-                {
-                  "name": "   ",
-                  "type": "FastAPI",
-                  "parameters": {
-                    "endpoint": "/test/api"
-                  }
-                }
-                """;
+    TaskDto requestDto = new TaskDto();
+    requestDto.setName("테스트 태스크");
+    requestDto.setType("FastAPI");
 
-    // when & then
-    mockMvc
-        .perform(
-            post(getApiUrlForDocs("/v0/tasks"))
-                .header("Origin", "https://admin.icebang.site")
-                .header("Referer", "https://admin.icebang.site/")
-                .contentType(MediaType.APPLICATION_JSON)
-                .content(blankNameTaskRequestJson))
-        .andExpect(status().isBadRequest());
-  }
+    TaskDto createdDto = new TaskDto();
+    createdDto.setId(1L);
+    createdDto.setName("테스트 태스크");
+    createdDto.setType("FastAPI");
 
-  @Test
-  @DisplayName("존재하지 않는 Task 조회 시 404 반환")
-  @WithUserDetails("admin@icebang.site")
-  void getTask_withNonExistentId_shouldReturn404() throws Exception {
-    // given
-    Long nonExistentId = 99999L;
+    when(workflowService.createTask(any(TaskDto.class))).thenReturn(createdDto);
 
     // when & then
-    mockMvc
-        .perform(
-            get(getApiUrlForDocs("/v0/tasks/{id}"), nonExistentId)
-                .header("Origin", "https://admin.icebang.site")
-                .header("Referer", "https://admin.icebang.site/"))
-        .andExpect(status().isNotFound())
-        .andExpect(jsonPath("$.success").value(false));
+    mockMvc.perform(post("/v0/tasks")
+                    .contentType(MediaType.APPLICATION_JSON)
+                    .content(objectMapper.writeValueAsString(requestDto)))
+            .andExpect(status().isCreated())
+            .andExpect(jsonPath("$.success").value(true))
+            .andExpect(jsonPath("$.data.id").value(1L))
+            .andExpect(jsonPath("$.data.name").value("테스트 태스크"));
   }
 
   @Test
-  @DisplayName("복잡한 JSON 파라미터로 Task 생성")
-  @WithUserDetails("admin@icebang.site")
-  void createTask_withComplexJsonParameters() throws Exception {
+  @DisplayName("Task 조회 API - 성공")
+  @WithMockUser(roles = "SUPER_ADMIN") // 📌 가상 유저로 인증
+  void getTask_success() throws Exception {
     // given
-    String complexTaskRequestJson =
-        """
-                {
-                  "name": "복잡한 파라미터 Task",
-                  "type": "FastAPI",
-                  "parameters": {
-                    "endpoint": "/products/similarity",
-                    "method": "POST",
-                    "body": {
-                      "keyword": "String",
-                      "matched_products": "List",
-                      "search_results": "List"
-                    },
-                    "timeout": 30,
-                    "retries": 3
-                  }
-                }
-                """;
-
-    // when & then
-    mockMvc
-        .perform(
-            post(getApiUrlForDocs("/v0/tasks"))
-                .header("Origin", "https://admin.icebang.site")
-                .header("Referer", "https://admin.icebang.site/")
-                .contentType(MediaType.APPLICATION_JSON)
-                .content(complexTaskRequestJson))
-        .andExpect(status().isCreated())
-        .andExpect(jsonPath("$.success").value(true))
-        .andExpect(jsonPath("$.data.name").value("복잡한 파라미터 Task"))
-        .andExpect(jsonPath("$.data.parameters.endpoint").value("/products/similarity"))
-        .andExpect(jsonPath("$.data.parameters.body.keyword").value("String"));
-  }
+    Long taskId = 1L;
+    TaskDto foundDto = new TaskDto();
+    foundDto.setId(taskId);
+    foundDto.setName("조회된 태스크");
+    foundDto.setType("FastAPI");
 
-  @Test
-  @DisplayName("새로 추가된 OCR Task 조회 (Task ID 8)")
-  @WithUserDetails("admin@icebang.site")
-  void getOcrTask_success() throws Exception {
-    // given - 새로 추가된 이미지 OCR 태스크 (ID: 8)
-    Long ocrTaskId = 8L;
+    when(workflowService.findTaskById(taskId)).thenReturn(foundDto);
 
     // when & then
-    mockMvc
-        .perform(
-            get(getApiUrlForDocs("/v0/tasks/{id}"), ocrTaskId)
-                .header("Origin", "https://admin.icebang.site")
-                .header("Referer", "https://admin.icebang.site/"))
-        .andExpect(status().isOk())
-        .andExpect(jsonPath("$.success").value(true))
-        .andExpect(jsonPath("$.data.id").value(ocrTaskId.intValue()))
-        .andExpect(jsonPath("$.data.name").value("이미지 OCR 태스크"))
-        .andExpect(jsonPath("$.data.type").value("FastAPI"))
-        .andExpect(jsonPath("$.data.parameters").exists())
-        .andExpect(jsonPath("$.data.parameters.endpoint").value("/blogs/ocr/extract"));
+    mockMvc.perform(get("/v0/tasks/{id}", taskId))
+            .andExpect(status().isOk())
+            .andExpect(jsonPath("$.success").value(true))
+            .andExpect(jsonPath("$.data.id").value(taskId))
+            .andExpect(jsonPath("$.data.name").value("조회된 태스크"));
   }
 
   @Test
-  @DisplayName("업데이트된 블로그 발행 Task 조회 (Task ID 10)")
-  @WithUserDetails("admin@icebang.site")
-  void getBlogPublishTask_success() throws Exception {
-    // given - 업데이트된 블로그 발행 태스크 (ID: 10, 기존 9에서 변경)
-    Long publishTaskId = 10L;
+  @DisplayName("Task 조회 API - 실패 (존재하지 않는 ID)")
+  @WithMockUser(roles = "SUPER_ADMIN") // 📌 가상 유저로 인증
+  void getTask_notFound() throws Exception {
+    // given
+    Long nonExistentTaskId = 999L;
+    when(workflowService.findTaskById(nonExistentTaskId)).thenReturn(null);
 
     // when & then
-    mockMvc
-        .perform(
-            get(getApiUrlForDocs("/v0/tasks/{id}"), publishTaskId)
-                .header("Origin", "https://admin.icebang.site")
-                .header("Referer", "https://admin.icebang.site/"))
-        .andExpect(status().isOk())
-        .andExpect(jsonPath("$.success").value(true))
-        .andExpect(jsonPath("$.data.id").value(publishTaskId.intValue()))
-        .andExpect(jsonPath("$.data.name").value("블로그 발행 태스크"))
-        .andExpect(jsonPath("$.data.type").value("FastAPI"))
-        .andExpect(jsonPath("$.data.parameters.endpoint").value("/blogs/publish"));
+    mockMvc.perform(get("/v0/tasks/{id}", nonExistentTaskId))
+            .andExpect(status().isNotFound())
+            .andExpect(jsonPath("$.success").value(false));
   }
-}
+}
\ No newline at end of file
diff --git a/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/WorkflowHistoryApiIntegrationTest.java b/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/WorkflowHistoryApiIntegrationTest.java
index f83e0142..8bf84a1f 100644
--- a/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/WorkflowHistoryApiIntegrationTest.java
+++ b/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/WorkflowHistoryApiIntegrationTest.java
@@ -1,35 +1,35 @@
 package site.icebang.integration.tests.workflow;
 
-import static com.epages.restdocs.apispec.MockMvcRestDocumentationWrapper.document;
-import static com.epages.restdocs.apispec.ResourceDocumentation.*;
-import static org.hamcrest.Matchers.matchesPattern;
-import static org.springframework.restdocs.mockmvc.RestDocumentationRequestBuilders.get;
-import static org.springframework.restdocs.operation.preprocess.Preprocessors.*;
-import static org.springframework.restdocs.payload.PayloadDocumentation.*;
-import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
-
+import com.epages.restdocs.apispec.ResourceSnippetParameters;
 import org.junit.jupiter.api.DisplayName;
 import org.junit.jupiter.api.Test;
 import org.springframework.restdocs.payload.JsonFieldType;
 import org.springframework.security.test.context.support.WithUserDetails;
 import org.springframework.test.context.jdbc.Sql;
 import org.springframework.transaction.annotation.Transactional;
-
-import com.epages.restdocs.apispec.ResourceSnippetParameters;
-
 import site.icebang.integration.setup.support.IntegrationTestSupport;
 
+import static com.epages.restdocs.apispec.MockMvcRestDocumentationWrapper.document;
+import static com.epages.restdocs.apispec.ResourceDocumentation.resource;
+import static org.hamcrest.Matchers.matchesPattern;
+import static org.springframework.restdocs.mockmvc.RestDocumentationRequestBuilders.get;
+import static org.springframework.restdocs.operation.preprocess.Preprocessors.*;
+import static org.springframework.restdocs.payload.PayloadDocumentation.fieldWithPath;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
+
 @Sql(
-    value = {
-      "classpath:sql/data/01-insert-internal-users.sql",
-      "classpath:sql/data/03-insert-workflow-h2.sql",
-      "classpath:sql/data/04-insert-workflow-history-h2.sql"
-    },
-    executionPhase = Sql.ExecutionPhase.BEFORE_TEST_METHOD)
+        value = {
+                "classpath:sql/data/01-insert-internal-users.sql",
+                "classpath:sql/data/03-insert-workflow-h2.sql",
+                "classpath:sql/data/04-insert-workflow-history-h2.sql"
+        },
+        executionPhase = Sql.ExecutionPhase.BEFORE_TEST_METHOD)
 @Transactional
 public class WorkflowHistoryApiIntegrationTest extends IntegrationTestSupport {
+
   @Test
-  @DisplayName("워크플로우 실행 상세 조회 성공")
+  @DisplayName("워크플로우 실행 상세 조회 API - 성공")
   @WithUserDetails("admin@icebang.site")
   void getWorkflowRunDetail_success() throws Exception {
     // given
@@ -37,265 +37,78 @@ void getWorkflowRunDetail_success() throws Exception {
 
     // when & then
     mockMvc
-        .perform(
-            get(getApiUrlForDocs("/v0/workflow-runs/{runId}"), runId)
-                .header("Origin", "https://admin.icebang.site")
-                .header("Referer", "https://admin.icebang.site/"))
-        .andExpect(status().isOk())
-        .andExpect(jsonPath("$.success").value(true))
-        .andExpect(jsonPath("$.status").value("OK"))
-        .andExpect(jsonPath("$.message").value("OK"))
-        // traceId 확인
-        .andExpect(jsonPath("$.data.traceId").value("3e3c832d-b51f-48ea-95f9-98f0ae6d3413"))
-        // workflowRun 필드 확인
-        .andExpect(jsonPath("$.data.workflowRun.id").value(1))
-        .andExpect(jsonPath("$.data.workflowRun.workflowId").value(1))
-        .andExpect(jsonPath("$.data.workflowRun.workflowName").value("상품 분석 및 블로그 자동 발행"))
-        .andExpect(
-            jsonPath("$.data.workflowRun.workflowDescription")
-                .value("키워드 검색부터 상품 분석 후 블로그 발행까지의 자동화 프로세스"))
-        .andExpect(jsonPath("$.data.workflowRun.runNumber").isEmpty())
-        .andExpect(jsonPath("$.data.workflowRun.status").value("FAILED"))
-        .andExpect(jsonPath("$.data.workflowRun.triggerType").isEmpty())
-        .andExpect(jsonPath("$.data.workflowRun.startedAt").value("2025-09-22T18:18:43Z"))
-        .andExpect(jsonPath("$.data.workflowRun.finishedAt").value("2025-09-22T18:18:44Z"))
-        .andExpect(jsonPath("$.data.workflowRun.durationMs").value(1000))
-        .andExpect(jsonPath("$.data.workflowRun.createdBy").isEmpty())
-        .andExpect(jsonPath("$.data.workflowRun.createdAt").exists())
-        // UTC 시간 형식 검증 (시간대 보장) - 마이크로초 포함 가능
-        .andExpect(
-            jsonPath("$.data.workflowRun.startedAt")
-                .value(matchesPattern("^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?Z$")))
-        .andExpect(
-            jsonPath("$.data.workflowRun.finishedAt")
-                .value(matchesPattern("^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?Z$")))
-        .andExpect(
-            jsonPath("$.data.workflowRun.createdAt")
-                .value(matchesPattern("^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?Z$")))
-        // jobRuns 배열 확인
-        .andExpect(jsonPath("$.data.jobRuns").isArray())
-        .andExpect(jsonPath("$.data.jobRuns.length()").value(1))
-        // jobRuns[0] 필드 확인
-        .andExpect(jsonPath("$.data.jobRuns[0].id").value(1))
-        .andExpect(jsonPath("$.data.jobRuns[0].workflowRunId").value(1))
-        .andExpect(jsonPath("$.data.jobRuns[0].jobId").value(1))
-        .andExpect(jsonPath("$.data.jobRuns[0].jobName").value("상품 분석"))
-        .andExpect(jsonPath("$.data.jobRuns[0].jobDescription").value("키워드 검색, 상품 크롤링 및 유사도 분석 작업"))
-        .andExpect(jsonPath("$.data.jobRuns[0].status").value("FAILED"))
-        .andExpect(jsonPath("$.data.jobRuns[0].executionOrder").isEmpty())
-        .andExpect(jsonPath("$.data.jobRuns[0].startedAt").value("2025-09-22T18:18:44Z"))
-        .andExpect(jsonPath("$.data.jobRuns[0].finishedAt").value("2025-09-22T18:18:44Z"))
-        .andExpect(jsonPath("$.data.jobRuns[0].durationMs").value(0))
-        // JobRun UTC 시간 형식 검증 - 마이크로초 포함 가능
-        .andExpect(
-            jsonPath(
-                "$.data.jobRuns[0].startedAt",
-                matchesPattern("^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?Z$")))
-        // finishedAt 도 동일하게
-        .andExpect(
-            jsonPath(
-                "$.data.jobRuns[0].finishedAt",
-                matchesPattern("^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?Z$")))
-        // taskRuns 배열 확인
-        .andExpect(jsonPath("$.data.jobRuns[0].taskRuns").isArray())
-        .andExpect(jsonPath("$.data.jobRuns[0].taskRuns.length()").value(1))
-        // taskRuns[0] 필드 확인
-        .andExpect(jsonPath("$.data.jobRuns[0].taskRuns[0].id").value(1))
-        .andExpect(jsonPath("$.data.jobRuns[0].taskRuns[0].jobRunId").value(1))
-        .andExpect(jsonPath("$.data.jobRuns[0].taskRuns[0].taskId").value(1))
-        .andExpect(jsonPath("$.data.jobRuns[0].taskRuns[0].taskName").value("키워드 검색 태스크"))
-        .andExpect(jsonPath("$.data.jobRuns[0].taskRuns[0].taskDescription").isEmpty())
-        .andExpect(jsonPath("$.data.jobRuns[0].taskRuns[0].taskType").value("FastAPI"))
-        .andExpect(jsonPath("$.data.jobRuns[0].taskRuns[0].status").value("FAILED"))
-        .andExpect(jsonPath("$.data.jobRuns[0].taskRuns[0].executionOrder").isEmpty())
-        .andExpect(
-            jsonPath("$.data.jobRuns[0].taskRuns[0].startedAt").value("2025-09-22T18:18:44Z"))
-        .andExpect(
-            jsonPath("$.data.jobRuns[0].taskRuns[0].finishedAt").value("2025-09-22T18:18:44Z"))
-        .andExpect(jsonPath("$.data.jobRuns[0].taskRuns[0].durationMs").value(0))
-        // TaskRun UTC 시간 형식 검증 - 마이크로초 포함 가능
-        .andExpect(
-            jsonPath("$.data.jobRuns[0].taskRuns[0].startedAt")
-                .value(matchesPattern("^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?Z$")))
-        .andExpect(
-            jsonPath("$.data.jobRuns[0].taskRuns[0].finishedAt")
-                .value(matchesPattern("^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?Z$")))
-        .andDo(
-            document(
-                "workflow-run-detail",
-                preprocessRequest(prettyPrint()),
-                preprocessResponse(prettyPrint()),
-                resource(
-                    ResourceSnippetParameters.builder()
-                        .tag("Workflow History")
-                        .summary("워크플로우 실행 상세 조회")
-                        .description("워크플로우 실행 ID로 상세 정보를 조회합니다")
-                        .responseFields(
-                            fieldWithPath("success")
-                                .type(JsonFieldType.BOOLEAN)
-                                .description("요청 성공 여부"),
-                            fieldWithPath("data").type(JsonFieldType.OBJECT).description("응답 데이터"),
-                            fieldWithPath("data.traceId")
-                                .type(JsonFieldType.STRING)
-                                .description("워크플로우 실행 추적 ID"),
-                            fieldWithPath("data.workflowRun")
-                                .type(JsonFieldType.OBJECT)
-                                .description("워크플로우 실행 정보"),
-                            fieldWithPath("data.workflowRun.id")
-                                .type(JsonFieldType.NUMBER)
-                                .description("워크플로우 실행 ID"),
-                            fieldWithPath("data.workflowRun.workflowId")
-                                .type(JsonFieldType.NUMBER)
-                                .description("워크플로우 설계 ID"),
-                            fieldWithPath("data.workflowRun.workflowName")
-                                .type(JsonFieldType.STRING)
-                                .description("워크플로우 이름"),
-                            fieldWithPath("data.workflowRun.workflowDescription")
-                                .type(JsonFieldType.STRING)
-                                .description("워크플로우 설명"),
-                            fieldWithPath("data.workflowRun.runNumber")
-                                .type(JsonFieldType.NULL)
-                                .description("실행 번호"),
-                            fieldWithPath("data.workflowRun.status")
-                                .type(JsonFieldType.STRING)
-                                .description("실행 상태"),
-                            fieldWithPath("data.workflowRun.triggerType")
-                                .type(JsonFieldType.NULL)
-                                .description("트리거 유형"),
-                            fieldWithPath("data.workflowRun.startedAt")
-                                .type(JsonFieldType.STRING)
-                                .description("시작 시간"),
-                            fieldWithPath("data.workflowRun.finishedAt")
-                                .type(JsonFieldType.STRING)
-                                .description("완료 시간"),
-                            fieldWithPath("data.workflowRun.durationMs")
-                                .type(JsonFieldType.NUMBER)
-                                .description("실행 시간(ms)"),
-                            fieldWithPath("data.workflowRun.createdBy")
-                                .type(JsonFieldType.NULL)
-                                .description("생성자 ID"),
-                            fieldWithPath("data.workflowRun.createdAt")
-                                .type(JsonFieldType.STRING)
-                                .description("생성 시간"),
-                            fieldWithPath("data.jobRuns")
-                                .type(JsonFieldType.ARRAY)
-                                .description("Job 실행 목록"),
-                            fieldWithPath("data.jobRuns[].id")
-                                .type(JsonFieldType.NUMBER)
-                                .description("Job 실행 ID"),
-                            fieldWithPath("data.jobRuns[].workflowRunId")
-                                .type(JsonFieldType.NUMBER)
-                                .description("워크플로우 실행 ID"),
-                            fieldWithPath("data.jobRuns[].jobId")
-                                .type(JsonFieldType.NUMBER)
-                                .description("Job 설계 ID"),
-                            fieldWithPath("data.jobRuns[].jobName")
-                                .type(JsonFieldType.STRING)
-                                .description("Job 이름"),
-                            fieldWithPath("data.jobRuns[].jobDescription")
-                                .type(JsonFieldType.STRING)
-                                .description("Job 설명"),
-                            fieldWithPath("data.jobRuns[].status")
-                                .type(JsonFieldType.STRING)
-                                .description("Job 실행 상태"),
-                            fieldWithPath("data.jobRuns[].executionOrder")
-                                .type(JsonFieldType.NULL)
-                                .description("실행 순서"),
-                            fieldWithPath("data.jobRuns[].startedAt")
-                                .type(JsonFieldType.STRING)
-                                .description("Job 시작 시간"),
-                            fieldWithPath("data.jobRuns[].finishedAt")
-                                .type(JsonFieldType.STRING)
-                                .description("Job 완료 시간"),
-                            fieldWithPath("data.jobRuns[].durationMs")
-                                .type(JsonFieldType.NUMBER)
-                                .description("Job 실행 시간(ms)"),
-                            fieldWithPath("data.jobRuns[].taskRuns")
-                                .type(JsonFieldType.ARRAY)
-                                .description("Task 실행 목록"),
-                            fieldWithPath("data.jobRuns[].taskRuns[].id")
-                                .type(JsonFieldType.NUMBER)
-                                .description("Task 실행 ID"),
-                            fieldWithPath("data.jobRuns[].taskRuns[].jobRunId")
-                                .type(JsonFieldType.NUMBER)
-                                .description("Job 실행 ID"),
-                            fieldWithPath("data.jobRuns[].taskRuns[].taskId")
-                                .type(JsonFieldType.NUMBER)
-                                .description("Task 설계 ID"),
-                            fieldWithPath("data.jobRuns[].taskRuns[].taskName")
-                                .type(JsonFieldType.STRING)
-                                .description("Task 이름"),
-                            fieldWithPath("data.jobRuns[].taskRuns[].taskDescription")
-                                .type(JsonFieldType.NULL)
-                                .description("Task 설명"),
-                            fieldWithPath("data.jobRuns[].taskRuns[].taskType")
-                                .type(JsonFieldType.STRING)
-                                .description("Task 유형"),
-                            fieldWithPath("data.jobRuns[].taskRuns[].status")
-                                .type(JsonFieldType.STRING)
-                                .description("Task 실행 상태"),
-                            fieldWithPath("data.jobRuns[].taskRuns[].executionOrder")
-                                .type(JsonFieldType.NULL)
-                                .description("Task 실행 순서"),
-                            fieldWithPath("data.jobRuns[].taskRuns[].startedAt")
-                                .type(JsonFieldType.STRING)
-                                .description("Task 시작 시간"),
-                            fieldWithPath("data.jobRuns[].taskRuns[].finishedAt")
-                                .type(JsonFieldType.STRING)
-                                .description("Task 완료 시간"),
-                            fieldWithPath("data.jobRuns[].taskRuns[].durationMs")
-                                .type(JsonFieldType.NUMBER)
-                                .description("Task 실행 시간(ms)"),
-                            fieldWithPath("message")
-                                .type(JsonFieldType.STRING)
-                                .description("응답 메시지"),
-                            fieldWithPath("status")
-                                .type(JsonFieldType.STRING)
-                                .description("HTTP 상태"))
-                        .build())));
-  }
+            .perform(
+                    get(getApiUrlForDocs("/v0/workflow-runs/{runId}"), runId)
+                            .header("Origin", "https://admin.icebang.site")
+                            .header("Referer", "https://admin.icebang.site/"))
+            .andExpect(status().isOk())
+            .andExpect(jsonPath("$.success").value(true))
+            .andExpect(jsonPath("$.data.traceId").value("3e3c832d-b51f-48ea-95f9-98f0ae6d3413"))
+            .andExpect(jsonPath("$.data.workflowRun.id").value(1))
+            .andExpect(jsonPath("$.data.workflowRun.status").value("FAILED"))
+            .andExpect(jsonPath("$.data.workflowRun.startedAt").value("2025-09-22T18:18:43Z"))
+            .andExpect(jsonPath("$.data.workflowRun.finishedAt").value("2025-09-22T18:18:44Z"))
 
-  @Test
-  @DisplayName("워크플로우 실행 시간이 UTC 기준으로 일관되게 저장되는지 검증")
-  @WithUserDetails("admin@icebang.site")
-  void getWorkflowRunDetail_utc_time_validation() throws Exception {
-    // given
-    Long runId = 1L;
+            .andDo(
+                    document(
+                            "workflow-run-detail",
+                            preprocessRequest(prettyPrint()),
+                            preprocessResponse(prettyPrint()),
+                            resource(
+                                    ResourceSnippetParameters.builder()
+                                            .tag("Workflow History")
+                                            .summary("워크플로우 실행 상세 조회")
+                                            .description("워크플로우 실행 ID로 상세 정보를 조회합니다.")
+                                            .responseFields(
+                                                    // 📌 responseFields에 모든 필드 경로를 추가합니다.
+                                                    fieldWithPath("success").type(JsonFieldType.BOOLEAN).description("요청 성공 여부"),
+                                                    fieldWithPath("data").type(JsonFieldType.OBJECT).description("응답 데이터"),
+                                                    fieldWithPath("data.traceId").type(JsonFieldType.STRING).description("워크플로우 실행 추적 ID"),
+                                                    fieldWithPath("data.workflowRun").type(JsonFieldType.OBJECT).description("워크플로우 실행 정보"),
+                                                    fieldWithPath("data.workflowRun.id").type(JsonFieldType.NUMBER).description("워크플로우 실행 ID"),
+                                                    fieldWithPath("data.workflowRun.workflowId").type(JsonFieldType.NUMBER).description("워크플로우 설계 ID"),
+                                                    fieldWithPath("data.workflowRun.workflowName").type(JsonFieldType.STRING).description("워크플로우 이름"),
+                                                    fieldWithPath("data.workflowRun.workflowDescription").type(JsonFieldType.STRING).description("워크플로우 설명"),
+                                                    fieldWithPath("data.workflowRun.runNumber").type(JsonFieldType.NULL).description("실행 번호").optional(),
+                                                    fieldWithPath("data.workflowRun.status").type(JsonFieldType.STRING).description("실행 상태"),
+                                                    fieldWithPath("data.workflowRun.triggerType").type(JsonFieldType.NULL).description("트리거 유형").optional(),
+                                                    fieldWithPath("data.workflowRun.startedAt").type(JsonFieldType.STRING).description("시작 시간 (UTC)"),
+                                                    fieldWithPath("data.workflowRun.finishedAt").type(JsonFieldType.STRING).description("완료 시간 (UTC)"),
+                                                    fieldWithPath("data.workflowRun.durationMs").type(JsonFieldType.NUMBER).description("실행 시간(ms)"),
+                                                    fieldWithPath("data.workflowRun.createdBy").type(JsonFieldType.NULL).description("생성자 ID").optional(),
+                                                    fieldWithPath("data.workflowRun.createdAt").type(JsonFieldType.STRING).description("생성 시간 (UTC)"),
 
-    // when & then - UTC 시간 형식 및 시간 순서 검증
-    mockMvc
-        .perform(
-            get(getApiUrlForDocs("/v0/workflow-runs/{runId}"), runId)
-                .header("Origin", "https://admin.icebang.site")
-                .header("Referer", "https://admin.icebang.site/"))
-        .andExpect(status().isOk())
-        .andExpect(jsonPath("$.success").value(true))
-        // WorkflowRun 시간이 UTC 형식인지 검증 - 마이크로초 포함 가능
-        .andExpect(
-            jsonPath("$.data.workflowRun.startedAt")
-                .value(matchesPattern("^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?Z$")))
-        .andExpect(
-            jsonPath("$.data.workflowRun.finishedAt")
-                .value(matchesPattern("^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?Z$")))
-        .andExpect(
-            jsonPath("$.data.workflowRun.createdAt")
-                .value(matchesPattern("^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?Z$")))
-        // JobRun 시간이 UTC 형식인지 검증 - 마이크로초 포함 가능
-        .andExpect(
-            jsonPath("$.data.jobRuns[0].startedAt")
-                .value(matchesPattern("^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?Z$")))
-        .andExpect(
-            jsonPath("$.data.jobRuns[0].finishedAt")
-                .value(matchesPattern("^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?Z$")))
-        // TaskRun 시간이 UTC 형식인지 검증 - 마이크로초 포함 가능
-        .andExpect(
-            jsonPath("$.data.jobRuns[0].taskRuns[0].startedAt")
-                .value(matchesPattern("^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?Z$")))
-        .andExpect(
-            jsonPath("$.data.jobRuns[0].taskRuns[0].finishedAt")
-                .value(matchesPattern("^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?Z$")))
-        // 시간 순서 논리적 검증 (startedAt <= finishedAt)
-        .andExpect(jsonPath("$.data.workflowRun.startedAt").value("2025-09-22T18:18:43Z"))
-        .andExpect(jsonPath("$.data.workflowRun.finishedAt").value("2025-09-22T18:18:44Z"));
+                                                    fieldWithPath("data.jobRuns").type(JsonFieldType.ARRAY).description("Job 실행 목록"),
+                                                    fieldWithPath("data.jobRuns[].id").type(JsonFieldType.NUMBER).description("Job 실행 ID"),
+                                                    fieldWithPath("data.jobRuns[].workflowRunId").type(JsonFieldType.NUMBER).description("워크플로우 실행 ID"),
+                                                    fieldWithPath("data.jobRuns[].jobId").type(JsonFieldType.NUMBER).description("Job 설계 ID"),
+                                                    fieldWithPath("data.jobRuns[].jobName").type(JsonFieldType.STRING).description("Job 이름"),
+                                                    fieldWithPath("data.jobRuns[].jobDescription").type(JsonFieldType.STRING).description("Job 설명").optional(),
+                                                    fieldWithPath("data.jobRuns[].status").type(JsonFieldType.STRING).description("Job 실행 상태"),
+                                                    fieldWithPath("data.jobRuns[].executionOrder").type(JsonFieldType.NULL).description("실행 순서").optional(),
+                                                    fieldWithPath("data.jobRuns[].startedAt").type(JsonFieldType.STRING).description("Job 시작 시간 (UTC)"),
+                                                    fieldWithPath("data.jobRuns[].finishedAt").type(JsonFieldType.STRING).description("Job 완료 시간 (UTC)"),
+                                                    fieldWithPath("data.jobRuns[].durationMs").type(JsonFieldType.NUMBER).description("Job 실행 시간(ms)"),
+
+                                                    fieldWithPath("data.jobRuns[].taskRuns").type(JsonFieldType.ARRAY).description("Task 실행 목록"),
+                                                    fieldWithPath("data.jobRuns[].taskRuns[].id").type(JsonFieldType.NUMBER).description("Task 실행 ID"),
+                                                    fieldWithPath("data.jobRuns[].taskRuns[].jobRunId").type(JsonFieldType.NUMBER).description("Job 실행 ID"),
+                                                    fieldWithPath("data.jobRuns[].taskRuns[].taskId").type(JsonFieldType.NUMBER).description("Task 설계 ID"),
+                                                    fieldWithPath("data.jobRuns[].taskRuns[].taskName").type(JsonFieldType.STRING).description("Task 이름"),
+                                                    fieldWithPath("data.jobRuns[].taskRuns[].taskDescription").type(JsonFieldType.NULL).description("Task 설명").optional(),
+                                                    fieldWithPath("data.jobRuns[].taskRuns[].taskType").type(JsonFieldType.STRING).description("Task 유형"),
+                                                    fieldWithPath("data.jobRuns[].taskRuns[].status").type(JsonFieldType.STRING).description("Task 실행 상태"),
+                                                    fieldWithPath("data.jobRuns[].taskRuns[].executionOrder").type(JsonFieldType.NULL).description("Task 실행 순서").optional(),
+                                                    fieldWithPath("data.jobRuns[].taskRuns[].startedAt").type(JsonFieldType.STRING).description("Task 시작 시간 (UTC)"),
+                                                    fieldWithPath("data.jobRuns[].taskRuns[].finishedAt").type(JsonFieldType.STRING).description("Task 완료 시간 (UTC)"),
+                                                    fieldWithPath("data.jobRuns[].taskRuns[].durationMs").type(JsonFieldType.NUMBER).description("Task 실행 시간(ms)"),
+
+                                                    fieldWithPath("message").type(JsonFieldType.STRING).description("응답 메시지"),
+                                                    fieldWithPath("status").type(JsonFieldType.STRING).description("HTTP 상태")
+                                            )
+                                            .build()
+                            )
+                    )
+            );
   }
-}
+}
\ No newline at end of file

From a11ffd09c71265f9c4aad02edced92d2dbdc4fec Mon Sep 17 00:00:00 2001
From: thkim7 <xogusrla7@gmail.com>
Date: Mon, 29 Sep 2025 12:48:06 +0900
Subject: [PATCH 09/12] chore: spotlessApply

---
 .../workflow/TaskApiIntegrationTest.java      |  60 ++--
 .../WorkflowHistoryApiIntegrationTest.java    | 260 ++++++++++++------
 2 files changed, 202 insertions(+), 118 deletions(-)

diff --git a/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/TaskApiIntegrationTest.java b/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/TaskApiIntegrationTest.java
index 3f7c1311..65feaf15 100644
--- a/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/TaskApiIntegrationTest.java
+++ b/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/TaskApiIntegrationTest.java
@@ -1,30 +1,30 @@
 package site.icebang.integration.tests.workflow;
 
-import com.fasterxml.jackson.databind.ObjectMapper;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.when;
+import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
+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;
+
 import org.junit.jupiter.api.DisplayName;
 import org.junit.jupiter.api.Test;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.http.MediaType;
 import org.springframework.security.test.context.support.WithMockUser;
 import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import com.fasterxml.jackson.databind.ObjectMapper;
+
 import site.icebang.domain.workflow.dto.TaskDto;
 import site.icebang.domain.workflow.service.WorkflowService;
 import site.icebang.integration.setup.support.IntegrationTestSupport;
 
-import static org.mockito.ArgumentMatchers.any;
-import static org.mockito.Mockito.when;
-import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
-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;
-
 public class TaskApiIntegrationTest extends IntegrationTestSupport {
 
-  @Autowired
-  private ObjectMapper objectMapper;
+  @Autowired private ObjectMapper objectMapper;
 
-  @MockitoBean
-  private WorkflowService workflowService;
+  @MockitoBean private WorkflowService workflowService;
 
   @Test
   @DisplayName("Task 생성 API - 성공")
@@ -43,13 +43,15 @@ void createTask_success() throws Exception {
     when(workflowService.createTask(any(TaskDto.class))).thenReturn(createdDto);
 
     // when & then
-    mockMvc.perform(post("/v0/tasks")
-                    .contentType(MediaType.APPLICATION_JSON)
-                    .content(objectMapper.writeValueAsString(requestDto)))
-            .andExpect(status().isCreated())
-            .andExpect(jsonPath("$.success").value(true))
-            .andExpect(jsonPath("$.data.id").value(1L))
-            .andExpect(jsonPath("$.data.name").value("테스트 태스크"));
+    mockMvc
+        .perform(
+            post("/v0/tasks")
+                .contentType(MediaType.APPLICATION_JSON)
+                .content(objectMapper.writeValueAsString(requestDto)))
+        .andExpect(status().isCreated())
+        .andExpect(jsonPath("$.success").value(true))
+        .andExpect(jsonPath("$.data.id").value(1L))
+        .andExpect(jsonPath("$.data.name").value("테스트 태스크"));
   }
 
   @Test
@@ -66,11 +68,12 @@ void getTask_success() throws Exception {
     when(workflowService.findTaskById(taskId)).thenReturn(foundDto);
 
     // when & then
-    mockMvc.perform(get("/v0/tasks/{id}", taskId))
-            .andExpect(status().isOk())
-            .andExpect(jsonPath("$.success").value(true))
-            .andExpect(jsonPath("$.data.id").value(taskId))
-            .andExpect(jsonPath("$.data.name").value("조회된 태스크"));
+    mockMvc
+        .perform(get("/v0/tasks/{id}", taskId))
+        .andExpect(status().isOk())
+        .andExpect(jsonPath("$.success").value(true))
+        .andExpect(jsonPath("$.data.id").value(taskId))
+        .andExpect(jsonPath("$.data.name").value("조회된 태스크"));
   }
 
   @Test
@@ -82,8 +85,9 @@ void getTask_notFound() throws Exception {
     when(workflowService.findTaskById(nonExistentTaskId)).thenReturn(null);
 
     // when & then
-    mockMvc.perform(get("/v0/tasks/{id}", nonExistentTaskId))
-            .andExpect(status().isNotFound())
-            .andExpect(jsonPath("$.success").value(false));
+    mockMvc
+        .perform(get("/v0/tasks/{id}", nonExistentTaskId))
+        .andExpect(status().isNotFound())
+        .andExpect(jsonPath("$.success").value(false));
   }
-}
\ No newline at end of file
+}
diff --git a/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/WorkflowHistoryApiIntegrationTest.java b/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/WorkflowHistoryApiIntegrationTest.java
index 8bf84a1f..2fc6be1b 100644
--- a/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/WorkflowHistoryApiIntegrationTest.java
+++ b/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/WorkflowHistoryApiIntegrationTest.java
@@ -1,30 +1,31 @@
 package site.icebang.integration.tests.workflow;
 
-import com.epages.restdocs.apispec.ResourceSnippetParameters;
-import org.junit.jupiter.api.DisplayName;
-import org.junit.jupiter.api.Test;
-import org.springframework.restdocs.payload.JsonFieldType;
-import org.springframework.security.test.context.support.WithUserDetails;
-import org.springframework.test.context.jdbc.Sql;
-import org.springframework.transaction.annotation.Transactional;
-import site.icebang.integration.setup.support.IntegrationTestSupport;
-
 import static com.epages.restdocs.apispec.MockMvcRestDocumentationWrapper.document;
 import static com.epages.restdocs.apispec.ResourceDocumentation.resource;
-import static org.hamcrest.Matchers.matchesPattern;
 import static org.springframework.restdocs.mockmvc.RestDocumentationRequestBuilders.get;
 import static org.springframework.restdocs.operation.preprocess.Preprocessors.*;
 import static org.springframework.restdocs.payload.PayloadDocumentation.fieldWithPath;
 import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
 import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
 
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.springframework.restdocs.payload.JsonFieldType;
+import org.springframework.security.test.context.support.WithUserDetails;
+import org.springframework.test.context.jdbc.Sql;
+import org.springframework.transaction.annotation.Transactional;
+
+import com.epages.restdocs.apispec.ResourceSnippetParameters;
+
+import site.icebang.integration.setup.support.IntegrationTestSupport;
+
 @Sql(
-        value = {
-                "classpath:sql/data/01-insert-internal-users.sql",
-                "classpath:sql/data/03-insert-workflow-h2.sql",
-                "classpath:sql/data/04-insert-workflow-history-h2.sql"
-        },
-        executionPhase = Sql.ExecutionPhase.BEFORE_TEST_METHOD)
+    value = {
+      "classpath:sql/data/01-insert-internal-users.sql",
+      "classpath:sql/data/03-insert-workflow-h2.sql",
+      "classpath:sql/data/04-insert-workflow-history-h2.sql"
+    },
+    executionPhase = Sql.ExecutionPhase.BEFORE_TEST_METHOD)
 @Transactional
 public class WorkflowHistoryApiIntegrationTest extends IntegrationTestSupport {
 
@@ -37,78 +38,157 @@ void getWorkflowRunDetail_success() throws Exception {
 
     // when & then
     mockMvc
-            .perform(
-                    get(getApiUrlForDocs("/v0/workflow-runs/{runId}"), runId)
-                            .header("Origin", "https://admin.icebang.site")
-                            .header("Referer", "https://admin.icebang.site/"))
-            .andExpect(status().isOk())
-            .andExpect(jsonPath("$.success").value(true))
-            .andExpect(jsonPath("$.data.traceId").value("3e3c832d-b51f-48ea-95f9-98f0ae6d3413"))
-            .andExpect(jsonPath("$.data.workflowRun.id").value(1))
-            .andExpect(jsonPath("$.data.workflowRun.status").value("FAILED"))
-            .andExpect(jsonPath("$.data.workflowRun.startedAt").value("2025-09-22T18:18:43Z"))
-            .andExpect(jsonPath("$.data.workflowRun.finishedAt").value("2025-09-22T18:18:44Z"))
-
-            .andDo(
-                    document(
-                            "workflow-run-detail",
-                            preprocessRequest(prettyPrint()),
-                            preprocessResponse(prettyPrint()),
-                            resource(
-                                    ResourceSnippetParameters.builder()
-                                            .tag("Workflow History")
-                                            .summary("워크플로우 실행 상세 조회")
-                                            .description("워크플로우 실행 ID로 상세 정보를 조회합니다.")
-                                            .responseFields(
-                                                    // 📌 responseFields에 모든 필드 경로를 추가합니다.
-                                                    fieldWithPath("success").type(JsonFieldType.BOOLEAN).description("요청 성공 여부"),
-                                                    fieldWithPath("data").type(JsonFieldType.OBJECT).description("응답 데이터"),
-                                                    fieldWithPath("data.traceId").type(JsonFieldType.STRING).description("워크플로우 실행 추적 ID"),
-                                                    fieldWithPath("data.workflowRun").type(JsonFieldType.OBJECT).description("워크플로우 실행 정보"),
-                                                    fieldWithPath("data.workflowRun.id").type(JsonFieldType.NUMBER).description("워크플로우 실행 ID"),
-                                                    fieldWithPath("data.workflowRun.workflowId").type(JsonFieldType.NUMBER).description("워크플로우 설계 ID"),
-                                                    fieldWithPath("data.workflowRun.workflowName").type(JsonFieldType.STRING).description("워크플로우 이름"),
-                                                    fieldWithPath("data.workflowRun.workflowDescription").type(JsonFieldType.STRING).description("워크플로우 설명"),
-                                                    fieldWithPath("data.workflowRun.runNumber").type(JsonFieldType.NULL).description("실행 번호").optional(),
-                                                    fieldWithPath("data.workflowRun.status").type(JsonFieldType.STRING).description("실행 상태"),
-                                                    fieldWithPath("data.workflowRun.triggerType").type(JsonFieldType.NULL).description("트리거 유형").optional(),
-                                                    fieldWithPath("data.workflowRun.startedAt").type(JsonFieldType.STRING).description("시작 시간 (UTC)"),
-                                                    fieldWithPath("data.workflowRun.finishedAt").type(JsonFieldType.STRING).description("완료 시간 (UTC)"),
-                                                    fieldWithPath("data.workflowRun.durationMs").type(JsonFieldType.NUMBER).description("실행 시간(ms)"),
-                                                    fieldWithPath("data.workflowRun.createdBy").type(JsonFieldType.NULL).description("생성자 ID").optional(),
-                                                    fieldWithPath("data.workflowRun.createdAt").type(JsonFieldType.STRING).description("생성 시간 (UTC)"),
-
-                                                    fieldWithPath("data.jobRuns").type(JsonFieldType.ARRAY).description("Job 실행 목록"),
-                                                    fieldWithPath("data.jobRuns[].id").type(JsonFieldType.NUMBER).description("Job 실행 ID"),
-                                                    fieldWithPath("data.jobRuns[].workflowRunId").type(JsonFieldType.NUMBER).description("워크플로우 실행 ID"),
-                                                    fieldWithPath("data.jobRuns[].jobId").type(JsonFieldType.NUMBER).description("Job 설계 ID"),
-                                                    fieldWithPath("data.jobRuns[].jobName").type(JsonFieldType.STRING).description("Job 이름"),
-                                                    fieldWithPath("data.jobRuns[].jobDescription").type(JsonFieldType.STRING).description("Job 설명").optional(),
-                                                    fieldWithPath("data.jobRuns[].status").type(JsonFieldType.STRING).description("Job 실행 상태"),
-                                                    fieldWithPath("data.jobRuns[].executionOrder").type(JsonFieldType.NULL).description("실행 순서").optional(),
-                                                    fieldWithPath("data.jobRuns[].startedAt").type(JsonFieldType.STRING).description("Job 시작 시간 (UTC)"),
-                                                    fieldWithPath("data.jobRuns[].finishedAt").type(JsonFieldType.STRING).description("Job 완료 시간 (UTC)"),
-                                                    fieldWithPath("data.jobRuns[].durationMs").type(JsonFieldType.NUMBER).description("Job 실행 시간(ms)"),
-
-                                                    fieldWithPath("data.jobRuns[].taskRuns").type(JsonFieldType.ARRAY).description("Task 실행 목록"),
-                                                    fieldWithPath("data.jobRuns[].taskRuns[].id").type(JsonFieldType.NUMBER).description("Task 실행 ID"),
-                                                    fieldWithPath("data.jobRuns[].taskRuns[].jobRunId").type(JsonFieldType.NUMBER).description("Job 실행 ID"),
-                                                    fieldWithPath("data.jobRuns[].taskRuns[].taskId").type(JsonFieldType.NUMBER).description("Task 설계 ID"),
-                                                    fieldWithPath("data.jobRuns[].taskRuns[].taskName").type(JsonFieldType.STRING).description("Task 이름"),
-                                                    fieldWithPath("data.jobRuns[].taskRuns[].taskDescription").type(JsonFieldType.NULL).description("Task 설명").optional(),
-                                                    fieldWithPath("data.jobRuns[].taskRuns[].taskType").type(JsonFieldType.STRING).description("Task 유형"),
-                                                    fieldWithPath("data.jobRuns[].taskRuns[].status").type(JsonFieldType.STRING).description("Task 실행 상태"),
-                                                    fieldWithPath("data.jobRuns[].taskRuns[].executionOrder").type(JsonFieldType.NULL).description("Task 실행 순서").optional(),
-                                                    fieldWithPath("data.jobRuns[].taskRuns[].startedAt").type(JsonFieldType.STRING).description("Task 시작 시간 (UTC)"),
-                                                    fieldWithPath("data.jobRuns[].taskRuns[].finishedAt").type(JsonFieldType.STRING).description("Task 완료 시간 (UTC)"),
-                                                    fieldWithPath("data.jobRuns[].taskRuns[].durationMs").type(JsonFieldType.NUMBER).description("Task 실행 시간(ms)"),
-
-                                                    fieldWithPath("message").type(JsonFieldType.STRING).description("응답 메시지"),
-                                                    fieldWithPath("status").type(JsonFieldType.STRING).description("HTTP 상태")
-                                            )
-                                            .build()
-                            )
-                    )
-            );
+        .perform(
+            get(getApiUrlForDocs("/v0/workflow-runs/{runId}"), runId)
+                .header("Origin", "https://admin.icebang.site")
+                .header("Referer", "https://admin.icebang.site/"))
+        .andExpect(status().isOk())
+        .andExpect(jsonPath("$.success").value(true))
+        .andExpect(jsonPath("$.data.traceId").value("3e3c832d-b51f-48ea-95f9-98f0ae6d3413"))
+        .andExpect(jsonPath("$.data.workflowRun.id").value(1))
+        .andExpect(jsonPath("$.data.workflowRun.status").value("FAILED"))
+        .andExpect(jsonPath("$.data.workflowRun.startedAt").value("2025-09-22T18:18:43Z"))
+        .andExpect(jsonPath("$.data.workflowRun.finishedAt").value("2025-09-22T18:18:44Z"))
+        .andDo(
+            document(
+                "workflow-run-detail",
+                preprocessRequest(prettyPrint()),
+                preprocessResponse(prettyPrint()),
+                resource(
+                    ResourceSnippetParameters.builder()
+                        .tag("Workflow History")
+                        .summary("워크플로우 실행 상세 조회")
+                        .description("워크플로우 실행 ID로 상세 정보를 조회합니다.")
+                        .responseFields(
+                            // 📌 responseFields에 모든 필드 경로를 추가합니다.
+                            fieldWithPath("success")
+                                .type(JsonFieldType.BOOLEAN)
+                                .description("요청 성공 여부"),
+                            fieldWithPath("data").type(JsonFieldType.OBJECT).description("응답 데이터"),
+                            fieldWithPath("data.traceId")
+                                .type(JsonFieldType.STRING)
+                                .description("워크플로우 실행 추적 ID"),
+                            fieldWithPath("data.workflowRun")
+                                .type(JsonFieldType.OBJECT)
+                                .description("워크플로우 실행 정보"),
+                            fieldWithPath("data.workflowRun.id")
+                                .type(JsonFieldType.NUMBER)
+                                .description("워크플로우 실행 ID"),
+                            fieldWithPath("data.workflowRun.workflowId")
+                                .type(JsonFieldType.NUMBER)
+                                .description("워크플로우 설계 ID"),
+                            fieldWithPath("data.workflowRun.workflowName")
+                                .type(JsonFieldType.STRING)
+                                .description("워크플로우 이름"),
+                            fieldWithPath("data.workflowRun.workflowDescription")
+                                .type(JsonFieldType.STRING)
+                                .description("워크플로우 설명"),
+                            fieldWithPath("data.workflowRun.runNumber")
+                                .type(JsonFieldType.NULL)
+                                .description("실행 번호")
+                                .optional(),
+                            fieldWithPath("data.workflowRun.status")
+                                .type(JsonFieldType.STRING)
+                                .description("실행 상태"),
+                            fieldWithPath("data.workflowRun.triggerType")
+                                .type(JsonFieldType.NULL)
+                                .description("트리거 유형")
+                                .optional(),
+                            fieldWithPath("data.workflowRun.startedAt")
+                                .type(JsonFieldType.STRING)
+                                .description("시작 시간 (UTC)"),
+                            fieldWithPath("data.workflowRun.finishedAt")
+                                .type(JsonFieldType.STRING)
+                                .description("완료 시간 (UTC)"),
+                            fieldWithPath("data.workflowRun.durationMs")
+                                .type(JsonFieldType.NUMBER)
+                                .description("실행 시간(ms)"),
+                            fieldWithPath("data.workflowRun.createdBy")
+                                .type(JsonFieldType.NULL)
+                                .description("생성자 ID")
+                                .optional(),
+                            fieldWithPath("data.workflowRun.createdAt")
+                                .type(JsonFieldType.STRING)
+                                .description("생성 시간 (UTC)"),
+                            fieldWithPath("data.jobRuns")
+                                .type(JsonFieldType.ARRAY)
+                                .description("Job 실행 목록"),
+                            fieldWithPath("data.jobRuns[].id")
+                                .type(JsonFieldType.NUMBER)
+                                .description("Job 실행 ID"),
+                            fieldWithPath("data.jobRuns[].workflowRunId")
+                                .type(JsonFieldType.NUMBER)
+                                .description("워크플로우 실행 ID"),
+                            fieldWithPath("data.jobRuns[].jobId")
+                                .type(JsonFieldType.NUMBER)
+                                .description("Job 설계 ID"),
+                            fieldWithPath("data.jobRuns[].jobName")
+                                .type(JsonFieldType.STRING)
+                                .description("Job 이름"),
+                            fieldWithPath("data.jobRuns[].jobDescription")
+                                .type(JsonFieldType.STRING)
+                                .description("Job 설명")
+                                .optional(),
+                            fieldWithPath("data.jobRuns[].status")
+                                .type(JsonFieldType.STRING)
+                                .description("Job 실행 상태"),
+                            fieldWithPath("data.jobRuns[].executionOrder")
+                                .type(JsonFieldType.NULL)
+                                .description("실행 순서")
+                                .optional(),
+                            fieldWithPath("data.jobRuns[].startedAt")
+                                .type(JsonFieldType.STRING)
+                                .description("Job 시작 시간 (UTC)"),
+                            fieldWithPath("data.jobRuns[].finishedAt")
+                                .type(JsonFieldType.STRING)
+                                .description("Job 완료 시간 (UTC)"),
+                            fieldWithPath("data.jobRuns[].durationMs")
+                                .type(JsonFieldType.NUMBER)
+                                .description("Job 실행 시간(ms)"),
+                            fieldWithPath("data.jobRuns[].taskRuns")
+                                .type(JsonFieldType.ARRAY)
+                                .description("Task 실행 목록"),
+                            fieldWithPath("data.jobRuns[].taskRuns[].id")
+                                .type(JsonFieldType.NUMBER)
+                                .description("Task 실행 ID"),
+                            fieldWithPath("data.jobRuns[].taskRuns[].jobRunId")
+                                .type(JsonFieldType.NUMBER)
+                                .description("Job 실행 ID"),
+                            fieldWithPath("data.jobRuns[].taskRuns[].taskId")
+                                .type(JsonFieldType.NUMBER)
+                                .description("Task 설계 ID"),
+                            fieldWithPath("data.jobRuns[].taskRuns[].taskName")
+                                .type(JsonFieldType.STRING)
+                                .description("Task 이름"),
+                            fieldWithPath("data.jobRuns[].taskRuns[].taskDescription")
+                                .type(JsonFieldType.NULL)
+                                .description("Task 설명")
+                                .optional(),
+                            fieldWithPath("data.jobRuns[].taskRuns[].taskType")
+                                .type(JsonFieldType.STRING)
+                                .description("Task 유형"),
+                            fieldWithPath("data.jobRuns[].taskRuns[].status")
+                                .type(JsonFieldType.STRING)
+                                .description("Task 실행 상태"),
+                            fieldWithPath("data.jobRuns[].taskRuns[].executionOrder")
+                                .type(JsonFieldType.NULL)
+                                .description("Task 실행 순서")
+                                .optional(),
+                            fieldWithPath("data.jobRuns[].taskRuns[].startedAt")
+                                .type(JsonFieldType.STRING)
+                                .description("Task 시작 시간 (UTC)"),
+                            fieldWithPath("data.jobRuns[].taskRuns[].finishedAt")
+                                .type(JsonFieldType.STRING)
+                                .description("Task 완료 시간 (UTC)"),
+                            fieldWithPath("data.jobRuns[].taskRuns[].durationMs")
+                                .type(JsonFieldType.NUMBER)
+                                .description("Task 실행 시간(ms)"),
+                            fieldWithPath("message")
+                                .type(JsonFieldType.STRING)
+                                .description("응답 메시지"),
+                            fieldWithPath("status")
+                                .type(JsonFieldType.STRING)
+                                .description("HTTP 상태"))
+                        .build())));
   }
-}
\ No newline at end of file
+}

From b7f504224f44bf5d9e4850bdfede880b3ce55e41 Mon Sep 17 00:00:00 2001
From: thkim7 <xogusrla7@gmail.com>
Date: Mon, 29 Sep 2025 13:41:04 +0900
Subject: [PATCH 10/12] =?UTF-8?q?fix:=20=EC=9B=8C=ED=81=AC=ED=94=8C?=
 =?UTF-8?q?=EB=A1=9C=EC=9A=B0=20=EC=88=98=EB=8F=99=20=EC=8B=A4=ED=96=89=20?=
 =?UTF-8?q?API=20=ED=86=B5=ED=95=A9=20=ED=85=8C=EC=8A=A4=ED=8A=B8=20Mockit?=
 =?UTF-8?q?o=20=EA=B2=80=EC=A6=9D=20=EC=88=98=EC=A0=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- verify 호출 시 ArgumentMatchers.eq() 사용하여 InvalidUseOfMatchersException 해결
- workflowId 매개변수에 Matcher 적용으로 통합 테스트 안정화
---
 .../tests/workflow/WorkflowRunApiIntegrationTest.java          | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/WorkflowRunApiIntegrationTest.java b/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/WorkflowRunApiIntegrationTest.java
index 23c4eaa4..168f5b94 100644
--- a/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/WorkflowRunApiIntegrationTest.java
+++ b/apps/user-service/src/test/java/site/icebang/integration/tests/workflow/WorkflowRunApiIntegrationTest.java
@@ -2,6 +2,7 @@
 
 import static com.epages.restdocs.apispec.MockMvcRestDocumentationWrapper.document;
 import static com.epages.restdocs.apispec.ResourceDocumentation.resource;
+import static org.mockito.ArgumentMatchers.eq;
 import static org.mockito.Mockito.timeout;
 import static org.mockito.Mockito.verify;
 import static org.springframework.restdocs.mockmvc.RestDocumentationRequestBuilders.post;
@@ -62,6 +63,6 @@ void runWorkflow_success() throws Exception {
                         .build())));
 
     // 📌 2. 비동기 호출된 executeWorkflow 메소드가 1초 이내에 1번 실행되었는지 검증
-    verify(mockWorkflowExecutionService, timeout(1000).times(1)).executeWorkflow(workflowId);
+    verify(mockWorkflowExecutionService, timeout(1000).times(1)).executeWorkflow(eq(workflowId));
   }
 }

From 289a8b8f137ca3f583e99ac7ed4079679bdedf60 Mon Sep 17 00:00:00 2001
From: thkim7 <xogusrla7@gmail.com>
Date: Mon, 29 Sep 2025 13:47:18 +0900
Subject: [PATCH 11/12] =?UTF-8?q?chore:=20develop=EC=9D=B4=EB=9E=91=20?=
 =?UTF-8?q?=EB=A8=B8=EC=A7=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../domain/workflow/dto/RequestContext.java   | 22 +++++++++++
 .../service/RequestContextService.java        | 37 +++++++++++++++++++
 2 files changed, 59 insertions(+)
 create mode 100644 apps/user-service/src/main/java/site/icebang/domain/workflow/dto/RequestContext.java
 create mode 100644 apps/user-service/src/main/java/site/icebang/domain/workflow/service/RequestContextService.java

diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/dto/RequestContext.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/dto/RequestContext.java
new file mode 100644
index 00000000..1812cd32
--- /dev/null
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/dto/RequestContext.java
@@ -0,0 +1,22 @@
+package site.icebang.domain.workflow.dto;
+
+import lombok.Data;
+
+/** 요청 컨텍스트 정보를 담는 DTO 클래스 분산 추적, 클라이언트 정보 등을 포함하여 워크플로우 실행 시 필요한 컨텍스트를 관리합니다. */
+@Data
+public class RequestContext {
+
+  private final String traceId;
+  private final String clientIp;
+  private final String userAgent;
+
+  /**
+   * 스케줄러 실행용 컨텍스트를 생성하는 정적 팩토리 메서드 HTTP 요청이 아닌 스케줄된 작업에서 사용됩니다.
+   *
+   * @param traceId 분산 추적 ID
+   * @return 스케줄러용 RequestContext 객체 (clientIp와 userAgent는 기본값 설정)
+   */
+  public static RequestContext forScheduler(String traceId) {
+    return new RequestContext(traceId, "scheduler", "quartz-scheduler");
+  }
+}
diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/service/RequestContextService.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/service/RequestContextService.java
new file mode 100644
index 00000000..a4c501af
--- /dev/null
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/service/RequestContextService.java
@@ -0,0 +1,37 @@
+package site.icebang.domain.workflow.service;
+
+import java.util.UUID;
+
+import org.slf4j.MDC;
+import org.springframework.stereotype.Service;
+
+import site.icebang.domain.workflow.dto.RequestContext;
+
+/** 요청 컨텍스트 정보를 추출하고 관리하는 서비스 MDC(Mapped Diagnostic Context)를 사용하여 분산 추적 정보를 처리합니다. */
+@Service
+public class RequestContextService {
+
+  /**
+   * HTTP 요청으로부터 컨텍스트 정보를 추출합니다.
+   *
+   * @return 추출된 요청 컨텍스트
+   */
+  public RequestContext extractRequestContext() {
+    String traceId = MDC.get("traceId") != null ? MDC.get("traceId") : UUID.randomUUID().toString();
+    String clientIp = MDC.get("clientIp");
+    String userAgent = MDC.get("userAgent");
+
+    return new RequestContext(traceId, clientIp, userAgent);
+  }
+
+  /**
+   * Quartz 스케줄러용 컨텍스트를 생성합니다. 스케줄된 작업에서는 HTTP 요청 정보가 없으므로 traceId만 포함됩니다.
+   *
+   * @return 스케줄러용 요청 컨텍스트
+   */
+  public RequestContext quartzContext() {
+    String traceId = MDC.get("traceId") != null ? MDC.get("traceId") : UUID.randomUUID().toString();
+
+    return RequestContext.forScheduler(traceId);
+  }
+}

From 6dfa7aa194f989100583ba7de4424ebcb434e5e6 Mon Sep 17 00:00:00 2001
From: thkim7 <xogusrla7@gmail.com>
Date: Mon, 29 Sep 2025 13:54:52 +0900
Subject: [PATCH 12/12] =?UTF-8?q?chore:=20develop=EC=9D=B4=EB=9E=91=20?=
 =?UTF-8?q?=EB=A8=B8=EC=A7=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../app/api/endpoints/product.py              |   1 -
 .../app/api/endpoints/sample.py               |  45 ----
 .../app/api/endpoints/test.py                 |   5 -
 apps/pre-processing-service/app/api/router.py |  14 +-
 .../app/decorators/__init__.py                |   0
 .../app/decorators/logging.py                 |  85 -------
 .../app/errors/handlers.py                    |   6 +-
 .../app/errors/messages.py                    |   2 +-
 .../middleware/BackServiceLoggerDependency.py | 124 -----------
 .../app/middleware/ServiceLoggerMiddleware.py |  27 ++-
 .../app/test/test_sadagu_crawl.py             |  10 +-
 .../app/test/test_similarity_service.py       | 208 +++++++++---------
 .../controller/WorkflowController.java        |   7 +-
 .../workflow/manager/ExecutionMdcManager.java |  12 +-
 .../domain/workflow/model/WorkflowRun.java    |  11 +-
 .../scheduler/WorkflowTriggerJob.java         |   4 +-
 .../service/WorkflowExecutionService.java     |   8 +-
 .../filter/logging/ClientLoggingFilter.java   |  71 ++++++
 .../src/main/resources/log4j2-develop.yml     |   4 +-
 .../src/main/resources/log4j2-production.yml  |   4 +-
 20 files changed, 242 insertions(+), 406 deletions(-)
 delete mode 100644 apps/pre-processing-service/app/api/endpoints/sample.py
 delete mode 100644 apps/pre-processing-service/app/decorators/__init__.py
 delete mode 100644 apps/pre-processing-service/app/decorators/logging.py
 delete mode 100644 apps/pre-processing-service/app/middleware/BackServiceLoggerDependency.py
 create mode 100644 apps/user-service/src/main/java/site/icebang/global/filter/logging/ClientLoggingFilter.java

diff --git a/apps/pre-processing-service/app/api/endpoints/product.py b/apps/pre-processing-service/app/api/endpoints/product.py
index f5a91272..8a1d8feb 100644
--- a/apps/pre-processing-service/app/api/endpoints/product.py
+++ b/apps/pre-processing-service/app/api/endpoints/product.py
@@ -1,5 +1,4 @@
 from fastapi import APIRouter, Request, HTTPException
-from app.decorators.logging import log_api_call
 from ...errors.CustomException import (
     InvalidItemDataException,
     ItemNotFoundException,
diff --git a/apps/pre-processing-service/app/api/endpoints/sample.py b/apps/pre-processing-service/app/api/endpoints/sample.py
deleted file mode 100644
index f6d586fb..00000000
--- a/apps/pre-processing-service/app/api/endpoints/sample.py
+++ /dev/null
@@ -1,45 +0,0 @@
-from fastapi import APIRouter
-from ...model.schemas import *
-from app.utils.response import Response
-
-router = APIRouter()
-
-
-@router.get("/")
-async def root():
-    return {"message": "sample API"}
-
-
-@router.post("/keywords/search", summary="네이버 키워드 검색")
-async def search(request: RequestNaverSearch):
-    return Response.ok({"test": "hello world"})
-
-
-@router.post("/blogs/rag/create", summary="RAG 기반 블로그 콘텐츠 생성")
-async def rag_create(request: RequestBlogCreate):
-    return Response.ok({"test": "hello world"})
-
-
-@router.post("/blogs/publish", summary="블로그 콘텐츠 배포")
-async def publish(request: RequestBlogPublish):
-    return Response.ok({"test": "hello world"})
-
-
-@router.post("/products/search", summary="상품 검색")
-async def product_search(request: RequestSadaguSearch):
-    return Response.ok({"test": "hello world"})
-
-
-@router.post("/products/match", summary="상품 매칭")
-async def product_match(request: RequestSadaguMatch):
-    return Response.ok({"test": "hello world"})
-
-
-@router.post("/products/similarity", summary="상품 유사도 분석")
-async def product_similarity(request: RequestSadaguSimilarity):
-    return Response.ok({"test": "hello world"})
-
-
-@router.post("/products/crawl", summary="상품 상세 정보 크롤링")
-async def product_crawl(request: RequestSadaguCrawl):
-    return Response.ok({"test": "hello world"})
diff --git a/apps/pre-processing-service/app/api/endpoints/test.py b/apps/pre-processing-service/app/api/endpoints/test.py
index ca1a43b5..9dfc5d40 100644
--- a/apps/pre-processing-service/app/api/endpoints/test.py
+++ b/apps/pre-processing-service/app/api/endpoints/test.py
@@ -5,14 +5,12 @@
 from fastapi import APIRouter
 from sqlalchemy import text
 
-from app.decorators.logging import log_api_call
 from ...errors.CustomException import *
 from fastapi import APIRouter
 from typing import Mapping, Any, Dict
 from ...model.schemas import *
 from ...service.blog.blog_create_service import BlogContentService
 from ...service.blog.naver_blog_post_service import NaverBlogPostService
-from ...service.blog.tistory_blog_post_service import TistoryBlogPostService
 from ...service.crawl_service import CrawlService
 from ...service.keyword_service import keyword_search
 from ...service.match_service import MatchService
@@ -27,7 +25,6 @@
 
 
 @router.get("/hello/{name}", tags=["hello"])
-# @log_api_call
 async def say_hello(name: str):
     return {"message": f"Hello {name}"}
 
@@ -122,8 +119,6 @@ async def processing_tester():
     # tistory_service = TistoryBlogPostService()
     naverblogPostService = NaverBlogPostService()
     result = naverblogPostService.post_content(
-        # blog_id="wtecho331",
-        # blog_pw="wt505033@#",
         title=data.get("title"),
         content=data.get("content"),
         tags=data.get("tags"),
diff --git a/apps/pre-processing-service/app/api/router.py b/apps/pre-processing-service/app/api/router.py
index c1a2fcb4..d21eb2f3 100644
--- a/apps/pre-processing-service/app/api/router.py
+++ b/apps/pre-processing-service/app/api/router.py
@@ -1,6 +1,6 @@
 # app/api/router.py
 from fastapi import APIRouter
-from .endpoints import keywords, blog, product, test, sample
+from .endpoints import keywords, blog, product, test
 from ..core.config import settings
 
 api_router = APIRouter()
@@ -15,19 +15,9 @@
 api_router.include_router(product.router, prefix="/products", tags=["product"])
 
 # 모듈 테스터를 위한 endpoint -> 추후 삭제 예정
-api_router.include_router(test.router, prefix="/tests", tags=["Test"])
-
-api_router.include_router(sample.router, prefix="/v0", tags=["Sample"])
+# api_router.include_router(test.router, prefix="/tests", tags=["Test"])
 
 
 @api_router.get("/ping")
 async def root():
     return {"message": "서버 실행중입니다."}
-
-
-@api_router.get("/db")
-def get_settings():
-    """
-    환경 변수가 올바르게 로드되었는지 확인하는 엔드포인트
-    """
-    return {"환경": settings.env_name, "데이터베이스 URL": settings.db_url}
diff --git a/apps/pre-processing-service/app/decorators/__init__.py b/apps/pre-processing-service/app/decorators/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/apps/pre-processing-service/app/decorators/logging.py b/apps/pre-processing-service/app/decorators/logging.py
deleted file mode 100644
index 23604a73..00000000
--- a/apps/pre-processing-service/app/decorators/logging.py
+++ /dev/null
@@ -1,85 +0,0 @@
-# app/decorators/logging.py
-
-from fastapi import Request
-from loguru import logger
-import functools
-import time
-
-
-def log_api_call(func):
-    """
-    FastAPI API 호출에 대한 상세 정보를 로깅하는 데코레이터입니다.
-    IP 주소, User-Agent, URL, 메서드, 실행 시간 등을 기록합니다.
-    """
-
-    @functools.wraps(func)
-    async def wrapper(*args, **kwargs):
-        # 1. request 객체를 안전하게 가져옵니다.
-        #    kwargs에서 'request'를 찾고, 없으면 args가 비어있지 않은 경우에만 args[0]을 시도합니다.
-        request: Request | None = kwargs.get("request")
-        if request is None and args and isinstance(args[0], Request):
-            request = args[0]
-
-        # 2. 로깅에 사용할 추가 정보를 추출합니다.
-        client_ip: str | None = None
-        user_agent: str | None = None
-        if request:
-            client_ip = request.client.host
-            user_agent = request.headers.get("user-agent", "N/A")
-
-        # 3. 요청 정보를 로그로 기록합니다.
-        log_context = {"func": func.__name__, "ip": client_ip, "user_agent": user_agent}
-        if request:
-            log_context.update(
-                {
-                    "url": str(request.url),
-                    "method": request.method,
-                }
-            )
-            logger.info(
-                "API 호출 시작: URL='{url}' 메서드='{method}' 함수='{func}' IP='{ip}' User-Agent='{user_agent}'",
-                **log_context,
-            )
-        else:
-            logger.info("API 호출 시작: 함수='{func}'", **log_context)
-
-        start_time = time.time()
-        result = None
-
-        try:
-            # 4. 원본 함수를 실행합니다.
-            result = await func(*args, **kwargs)
-            return result
-        except Exception as e:
-            # 5. 예외 발생 시 에러 로그를 기록합니다.
-            elapsed_time = time.time() - start_time
-            log_context["exception"] = e
-            log_context["elapsed"] = f"{elapsed_time:.4f}s"
-
-            if request:
-                logger.error(
-                    "API 호출 실패: URL='{url}' 메서드='{method}' IP='{ip}' 예외='{exception}' ({elapsed})",
-                    **log_context,
-                )
-            else:
-                logger.error(
-                    "API 호출 실패: 함수='{func}' 예외='{exception}' ({elapsed})",
-                    **log_context,
-                )
-            raise  # 예외를 다시 발생시켜 FastAPI가 처리하도록 합니다.
-        finally:
-            # 6. 성공적으로 완료되면 성공 로그를 기록합니다.
-            if result is not None:
-                elapsed_time = time.time() - start_time
-                log_context["elapsed"] = f"{elapsed_time:.4f}s"
-                if request:
-                    logger.success(
-                        "API 호출 성공: URL='{url}' 메서드='{method}' IP='{ip}' ({elapsed})",
-                        **log_context,
-                    )
-                else:
-                    logger.success(
-                        "API 호출 성공: 함수='{func}' ({elapsed})", **log_context
-                    )
-
-    return wrapper
diff --git a/apps/pre-processing-service/app/errors/handlers.py b/apps/pre-processing-service/app/errors/handlers.py
index 882a6078..c7b7339f 100644
--- a/apps/pre-processing-service/app/errors/handlers.py
+++ b/apps/pre-processing-service/app/errors/handlers.py
@@ -57,8 +57,8 @@ async def validation_exception_handler(request: Request, exc: RequestValidationE
     """
     # 변경점: ErrorBaseModel을 기본 구조로 사용하고, 추가 정보를 더함
     base_error = ErrorBaseModel(
-        status_code=status.HTTP_422_UNPROCESSABLE_ENTITY,
-        detail=ERROR_MESSAGES[status.HTTP_422_UNPROCESSABLE_ENTITY],
+        status_code=status.HTTP_422_UNPROCESSABLE_CONTENT,
+        detail=ERROR_MESSAGES[status.HTTP_422_UNPROCESSABLE_CONTENT],
         code="VALIDATION_ERROR",
     )
 
@@ -67,7 +67,7 @@ async def validation_exception_handler(request: Request, exc: RequestValidationE
     response_content["details"] = exc.errors()
 
     return JSONResponse(
-        status_code=status.HTTP_422_UNPROCESSABLE_ENTITY,
+        status_code=status.HTTP_422_UNPROCESSABLE_CONTENT,
         content=response_content,
     )
 
diff --git a/apps/pre-processing-service/app/errors/messages.py b/apps/pre-processing-service/app/errors/messages.py
index 80139492..ea82ec11 100644
--- a/apps/pre-processing-service/app/errors/messages.py
+++ b/apps/pre-processing-service/app/errors/messages.py
@@ -6,7 +6,7 @@
     status.HTTP_401_UNAUTHORIZED: "인증이 필요합니다.",
     status.HTTP_403_FORBIDDEN: "접근 권한이 없습니다.",
     status.HTTP_404_NOT_FOUND: "요청하신 리소스를 찾을 수 없습니다.",
-    status.HTTP_422_UNPROCESSABLE_ENTITY: "입력 데이터가 유효하지 않습니다.",
+    status.HTTP_422_UNPROCESSABLE_CONTENT: "입력 데이터가 유효하지 않습니다.",
     status.HTTP_500_INTERNAL_SERVER_ERROR: "서버 내부 오류가 발생했습니다.",
 }
 
diff --git a/apps/pre-processing-service/app/middleware/BackServiceLoggerDependency.py b/apps/pre-processing-service/app/middleware/BackServiceLoggerDependency.py
deleted file mode 100644
index d18630f6..00000000
--- a/apps/pre-processing-service/app/middleware/BackServiceLoggerDependency.py
+++ /dev/null
@@ -1,124 +0,0 @@
-# import time
-# from typing import Dict, Any, List, Optional
-# from fastapi import Request
-# from loguru import logger
-# from contextvars import ContextVar
-#
-# trace_id_context: ContextVar[str] = ContextVar('trace_id', default="NO_TRACE_ID")
-#
-#
-# class ServiceLoggingDependency:
-#     """
-#     서비스 로깅을 위한 의존성 클래스
-#     :param service_type: 서비스 유형 (예: "CHUNKING", "PARSING", "EMBEDDING")
-#     :param track_params: 추적할 매개변수 이름 목록
-#     :param response_trackers: 응답에서 추적할 필드 이름 목록 (딕셔너리)
-#     """
-#
-#     def __init__(self, service_type: str,
-#                  track_params: List[str] = None,
-#                  response_trackers: List[str] = None):
-#         self.service_type = service_type
-#         self.track_params = track_params or []
-#         self.response_trackers = response_trackers or []
-#
-#     async def __call__(self, request: Request):
-#         """
-#         의존성 주입 시 호출되는 메서드
-#         :param request: FastAPI Request 객체
-#         :return: 서비스 유형과 추출된 매개변수 딕셔너리
-#         """
-#         trace_id = trace_id_context.get("NO_TRACE_ID")
-#         start_time = time.time()
-#
-#         # 파라미터 추출
-#         params = await self._extract_params(request)
-#         param_str = ""
-#         if params:
-#             param_strs = [f"{k}={v}" for k, v in params.items()]
-#             param_str = " " + " ".join(param_strs)
-#
-#         logger.info(f"[{self.service_type}_START] trace_id={trace_id}{param_str}")
-#
-#         # 응답 시 사용할 정보를 request.state에 저장
-#         request.state.service_type = self.service_type
-#         request.state.start_time = start_time
-#         request.state.param_str = param_str
-#         request.state.response_trackers = self.response_trackers
-#
-#         return {"service_type": self.service_type, "params": params}
-#
-#     async def _extract_params(self, request: Request) -> Dict[str, Any]:
-#         """
-#         요청에서 추적 파라미터 추출
-#         :param request: FastAPI Request 객체
-#         :return: 추출된 매개변수 딕셔너리
-#         """
-#         params = {}
-#
-#         try:
-#             # Query Parameters 추출
-#             for key, value in request.query_params.items():
-#                 if key in self.track_params:
-#                     params[key] = value
-#
-#             # JSON Body 추출
-#             try:
-#                 json_body = await request.json()
-#                 if json_body:
-#                     for key, value in json_body.items():
-#                         if key in self.track_params:
-#                             if isinstance(value, str) and len(value) > 50:
-#                                 params[f"{key}_length"] = len(value)
-#                             elif isinstance(value, list):
-#                                 params[f"{key}_count"] = len(value)
-#                             else:
-#                                 params[key] = value
-#             except:
-#                 pass
-#         except:
-#             pass
-#
-#         return params
-#
-# # 서비스 응답 시 성공 로그 함수
-# async def log_service_response_with_data(request: Request, response_data: Optional[Dict] = None):
-#     """
-#     서비스 응답 시 성공 로그 기록
-#     :param request: FastAPI Request 객체
-#     :param response_data: 응답 데이터
-#     """
-#     if hasattr(request.state, 'service_type'):
-#         trace_id = trace_id_context.get("NO_TRACE_ID")
-#         duration = time.time() - request.state.start_time
-#
-#         # 기본 로그 문자열
-#         log_parts = [f"[{request.state.service_type}_SUCCESS]",
-#                      f"trace_id={trace_id}",
-#                      f"execution_time={duration:.4f}s{request.state.param_str}"]
-#
-#         # 응답 데이터에서 추적할 필드 추출
-#         if response_data and hasattr(request.state, 'response_trackers'):
-#             response_params = []
-#             for tracker in request.state.response_trackers:
-#                 if tracker in response_data:
-#                     value = response_data[tracker]
-#                     if isinstance(value, dict):
-#                         response_params.append(f"{tracker}_keys={list(value.keys())}")
-#                         response_params.append(f"{tracker}_count={len(value)}")
-#                     elif isinstance(value, list):
-#                         response_params.append(f"{tracker}_count={len(value)}")
-#                     else:
-#                         response_params.append(f"{tracker}={value}")
-#
-#             if response_params:
-#                 log_parts.append(" ".join(response_params))
-#
-#         logger.info(" ".join(log_parts))
-#     return None
-#
-# naver_search_dependency = ServiceLoggingDependency(
-#     "NAVER_CRAWLING",
-#     track_params=["job_id", "schedule_id", "tag", "category", "startDate", "endDate"],
-#     response_trackers=["keyword", "total_keyword"]
-# )
diff --git a/apps/pre-processing-service/app/middleware/ServiceLoggerMiddleware.py b/apps/pre-processing-service/app/middleware/ServiceLoggerMiddleware.py
index 30d3475b..e4e23185 100644
--- a/apps/pre-processing-service/app/middleware/ServiceLoggerMiddleware.py
+++ b/apps/pre-processing-service/app/middleware/ServiceLoggerMiddleware.py
@@ -54,10 +54,11 @@ def __init__(
 
     def _default_mappings(self) -> Dict[str, Dict]:
         """기본 서비스 매핑 설정"""
+        service_type = "TASK"
         return {
             # 네이버 키워드 검색
             "/keywords/search": {
-                "service_type": "NAVER_CRAWLING",
+                "service_type": service_type,
                 "track_params": [
                     "tag",
                     "keyword",
@@ -71,7 +72,7 @@ def _default_mappings(self) -> Dict[str, Dict]:
             },
             # 블로그 RAG 콘텐츠 생성
             "/blogs/rag/create": {
-                "service_type": "BLOG_RAG_CREATE",
+                "service_type": service_type,
                 "track_params": [
                     "keyword",
                     "product_info",
@@ -91,7 +92,7 @@ def _default_mappings(self) -> Dict[str, Dict]:
             },
             # 블로그 배포
             "/blogs/publish": {
-                "service_type": "BLOG_PUBLISH",
+                "service_type": service_type,
                 "track_params": [
                     "tag",
                     "blog_id",
@@ -115,7 +116,7 @@ def _default_mappings(self) -> Dict[str, Dict]:
             },
             # 상품 검색
             "/products/search": {
-                "service_type": "PRODUCT_SEARCH",
+                "service_type": service_type,
                 "track_params": [
                     "keyword",
                     "job_id",
@@ -131,7 +132,7 @@ def _default_mappings(self) -> Dict[str, Dict]:
             },
             # 상품 매칭
             "/products/match": {
-                "service_type": "PRODUCT_MATCH",
+                "service_type": service_type,
                 "track_params": [
                     "keyword",
                     "search_results",
@@ -148,7 +149,7 @@ def _default_mappings(self) -> Dict[str, Dict]:
             },
             # 상품 유사도 분석
             "/products/similarity": {
-                "service_type": "PRODUCT_SIMILARITY",
+                "service_type": service_type,
                 "track_params": [
                     "keyword",
                     "matched_products",
@@ -167,7 +168,7 @@ def _default_mappings(self) -> Dict[str, Dict]:
             },
             # 상품 크롤링
             "/products/crawl": {
-                "service_type": "PRODUCT_CRAWL",
+                "service_type": service_type,
                 "track_params": [
                     "tag",
                     "product_url",
@@ -184,6 +185,18 @@ def _default_mappings(self) -> Dict[str, Dict]:
                     "status",
                 ],
             },
+            # 상품 이미지 번역
+            "blogs/ocr/extract": {
+                "service_type": service_type,
+                "track_params": [],
+                "response_trackers": [],
+            },
+            # 상품 이미지 S3업로드
+            "products/s3-upload": {
+                "service_type": service_type,
+                "track_params": [],
+                "response_trackers": [],
+            },
         }
 
     async def dispatch(self, request: Request, call_next):
diff --git a/apps/pre-processing-service/app/test/test_sadagu_crawl.py b/apps/pre-processing-service/app/test/test_sadagu_crawl.py
index 72e4f0df..cd879a7d 100644
--- a/apps/pre-processing-service/app/test/test_sadagu_crawl.py
+++ b/apps/pre-processing-service/app/test/test_sadagu_crawl.py
@@ -7,10 +7,9 @@
 
 def test_crawl_success():
     body = {
-        "tag": "detail",
-        "product_url": "https://ssadagu.kr/shop/view.php?platform=1688&num_iid=886788894790",
-        "use_selenium": False,
-        "include_images": False,
+        "product_urls": [
+            "https://ssadagu.kr/shop/view.php?platform=1688&num_iid=886788894790",
+        ],
     }
 
     response = client.post("/products/crawl", json=body)
@@ -20,8 +19,7 @@ def test_crawl_success():
     data = response.json()
     assert data["success"] == True
     assert data["status"] == "OK"
-    assert data["data"]["product_url"] == body["product_url"]
-    assert "product_detail" in data["data"]
+    assert isinstance(data["data"]["crawled_products"], list)
 
 
 # def test_crawl_invalid_url():
diff --git a/apps/pre-processing-service/app/test/test_similarity_service.py b/apps/pre-processing-service/app/test/test_similarity_service.py
index 6efbcdc1..250fd55b 100644
--- a/apps/pre-processing-service/app/test/test_similarity_service.py
+++ b/apps/pre-processing-service/app/test/test_similarity_service.py
@@ -9,124 +9,132 @@ def test_similarity_with_matched_products():
     """매칭된 상품들 중에서 유사도 분석"""
     matched_products = [
         {
-            "url": "https://ssadagu.kr/shop/view.php?platform=1688&num_iid=123",
-            "title": "925 실버 반지 여성용",
-            "match_info": {
-                "match_type": "exact",
-                "match_score": 1.0,
-                "match_reason": "완전 매칭",
-            },
+            "product_id": 201,
+            "title": "15인치 노트북 백팩",
+            "url": "https://ssadagu.kr/shop/view.php?platform=1688&num_iid=22334455",
         },
         {
-            "url": "https://ssadagu.kr/shop/view.php?platform=1688&num_iid=456",
-            "title": "반지 세트 커플링",
-            "match_info": {
-                "match_type": "morphological",
-                "match_score": 0.8,
-                "match_reason": "형태소 매칭",
-            },
+            "product_id": 202,
+            "title": "노트북 파우치 13인치",
+            "url": "https://ssadagu.kr/shop/view.php?platform=1688&num_iid=66778899",
         },
-    ]
-
-    body = {
-        "keyword": "반지",
-        "matched_products": matched_products,
-    }
-
-    response = client.post("/products/similarity", json=body)
-    print(f"Similarity Response: {response.json()}")
-
-    assert response.status_code == 200
-    data = response.json()
-    assert data["success"] == True
-    assert data["status"] == "OK"
-    assert data["data"]["keyword"] == body["keyword"]
-
-    if data["data"]["selected_product"]:
-        assert "similarity_info" in data["data"]["selected_product"]
-        assert "similarity_score" in data["data"]["selected_product"]["similarity_info"]
-        assert data["data"]["reason"] is not None
-
-
-def test_similarity_fallback_to_search_results():
-    """매칭 실패시 전체 검색 결과에서 유사도 분석"""
-    search_results = [
         {
-            "url": "https://ssadagu.kr/shop/view.php?platform=1688&num_iid=123",
-            "title": "실버 링 악세서리",
+            "product_id": 101,
+            "title": "Magsafe 자기 휴대폰 케이스 아이폰15",
+            "url": "https://ssadagu.kr/shop/view.php?platform=1688&num_iid=886788894790",
         },
         {
-            "url": "https://ssadagu.kr/shop/view.php?platform=1688&num_iid=456",
-            "title": "골드 반지 여성",
+            "product_id": 102,
+            "title": "휴대 전화 보호 케이스 갤럭시 S24",
+            "url": "https://ssadagu.kr/shop/view.php?platform=1688&num_iid=1234567890",
         },
     ]
 
     body = {
         "keyword": "반지",
-        "matched_products": [],  # 매칭된 상품 없음
-        "search_results": search_results,  # 폴백용
-    }
-
-    response = client.post("/products/similarity", json=body)
-    print(f"Fallback Response: {response.json()}")
-
-    assert response.status_code == 200
-    data = response.json()
-    assert data["success"] == True
-    assert data["status"] == "OK"
-
-    # 폴백 모드에서는 임계값을 통과한 경우에만 상품이 선택됨
-    if data["data"]["selected_product"]:
-        assert "similarity_info" in data["data"]["selected_product"]
-        assert (
-            data["data"]["selected_product"]["similarity_info"]["analysis_mode"]
-            == "fallback_similarity_only"
-        )
-
-
-def test_similarity_single_candidate():
-    """후보가 1개만 있는 경우"""
-    single_product = [
-        {
-            "url": "https://ssadagu.kr/shop/view.php?platform=1688&num_iid=123",
-            "title": "925 실버 반지 여성용",
-            "match_info": {"match_type": "exact", "match_score": 1.0},
-        }
-    ]
-
-    body = {
-        "keyword": "반지",
-        "matched_products": single_product,
+        "matched_products": matched_products,
     }
 
     response = client.post("/products/similarity", json=body)
-    print(f"Single candidate response: {response.json()}")
+    print(f"Similarity Response: {response.json()}")
 
     assert response.status_code == 200
     data = response.json()
     assert data["success"] == True
     assert data["status"] == "OK"
-    assert data["data"]["selected_product"] is not None
-    assert (
-        data["data"]["selected_product"]["similarity_info"]["analysis_type"]
-        == "single_candidate"
-    )
-
-
-def test_similarity_no_candidates():
-    """후보가 없는 경우"""
-    body = {
-        "keyword": "반지",
-        "matched_products": [],
-        "search_results": [],
-    }
+    assert data["data"]["keyword"] == body["keyword"]
+    products = data["data"]["top_products"]
+    if products:
+        for product in products:
+            assert "product_id" in product
+            assert "title" in product
+            assert "url" in product
+            assert "rank" in product
+            assert "similarity_score" in product["similarity_info"]
+            # assert "analysis_type" in product["similarity_info"]
+            # assert "analysis_mode" in product["similarity_info"]
+        assert data["data"]["reason"] is not None
 
-    response = client.post("/products/similarity", json=body)
-    print(f"No candidates response: {response.json()}")
 
-    assert response.status_code == 200
-    data = response.json()
-    assert data["success"] == True
-    assert data["status"] == "OK"
-    assert data["data"]["selected_product"] is None
-    assert "검색 결과가 모두 없음" in data["data"]["reason"]
+# def test_similarity_fallback_to_search_results():
+#     """매칭 실패시 전체 검색 결과에서 유사도 분석"""
+#     search_results = [
+#         {
+#             "url": "https://ssadagu.kr/shop/view.php?platform=1688&num_iid=123",
+#             "title": "실버 링 악세서리",
+#         },
+#         {
+#             "url": "https://ssadagu.kr/shop/view.php?platform=1688&num_iid=456",
+#             "title": "골드 반지 여성",
+#         },
+#     ]
+#
+#     body = {
+#         "keyword": "반지",
+#         "matched_products": [],  # 매칭된 상품 없음
+#         "search_results": search_results,  # 폴백용
+#     }
+#
+#     response = client.post("/products/similarity", json=body)
+#     print(f"Fallback Response: {response.json()}")
+#
+#     assert response.status_code == 200
+#     data = response.json()
+#     assert data["success"] == True
+#     assert data["status"] == "OK"
+#
+#     # 폴백 모드에서는 임계값을 통과한 경우에만 상품이 선택됨
+#     if data["data"]["top_products"]:
+#         assert "similarity_info" in data["data"]["top_products"]
+#         assert (
+#             data["data"]["top_products"]["similarity_info"]["analysis_mode"]
+#             == "fallback_similarity_only"
+#         )
+#
+#
+# def test_similarity_single_candidate():
+#     """후보가 1개만 있는 경우"""
+#     single_product = [
+#         {
+#             "url": "https://ssadagu.kr/shop/view.php?platform=1688&num_iid=123",
+#             "title": "925 실버 반지 여성용",
+#             "match_info": {"match_type": "exact", "match_score": 1.0},
+#         }
+#     ]
+#
+#     body = {
+#         "keyword": "반지",
+#         "matched_products": single_product,
+#     }
+#
+#     response = client.post("/products/similarity", json=body)
+#     print(f"Single candidate response: {response.json()}")
+#
+#     assert response.status_code == 200
+#     data = response.json()
+#     assert data["success"] == True
+#     assert data["status"] == "OK"
+#     assert data["data"]["top_products"] is not None
+#     assert (
+#         data["data"]["top_products"]["similarity_info"]["analysis_type"]
+#         == "single_candidate"
+#     )
+#
+#
+# def test_similarity_no_candidates():
+#     """후보가 없는 경우"""
+#     body = {
+#         "keyword": "반지",
+#         "matched_products": [],
+#         "search_results": [],
+#     }
+#
+#     response = client.post("/products/similarity", json=body)
+#     print(f"No candidates response: {response.json()}")
+#
+#     assert response.status_code == 200
+#     data = response.json()
+#     assert data["success"] == True
+#     assert data["status"] == "OK"
+#     assert data["data"]["top_products"] is None
+#     assert "검색 결과가 모두 없음" in data["data"]["reason"]
diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/WorkflowController.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/WorkflowController.java
index c98ece1f..2bc388af 100644
--- a/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/WorkflowController.java
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/controller/WorkflowController.java
@@ -14,9 +14,11 @@
 import site.icebang.common.dto.PageParams;
 import site.icebang.common.dto.PageResult;
 import site.icebang.domain.auth.model.AuthCredential;
+import site.icebang.domain.workflow.dto.RequestContext;
 import site.icebang.domain.workflow.dto.WorkflowCardDto;
 import site.icebang.domain.workflow.dto.WorkflowCreateDto;
 import site.icebang.domain.workflow.dto.WorkflowDetailCardDto;
+import site.icebang.domain.workflow.service.RequestContextService;
 import site.icebang.domain.workflow.service.WorkflowExecutionService;
 import site.icebang.domain.workflow.service.WorkflowService;
 
@@ -26,6 +28,7 @@
 public class WorkflowController {
   private final WorkflowService workflowService;
   private final WorkflowExecutionService workflowExecutionService;
+  private final RequestContextService requestContextService;
 
   @GetMapping("")
   public ApiResponse<PageResult<WorkflowCardDto>> getWorkflowList(
@@ -53,8 +56,10 @@ public ApiResponse<Void> createWorkflow(
 
   @PostMapping("/{workflowId}/run")
   public ResponseEntity<Void> runWorkflow(@PathVariable Long workflowId) {
+
+    RequestContext context = requestContextService.extractRequestContext();
     // HTTP 요청/응답 스레드를 블로킹하지 않도록 비동기 실행
-    workflowExecutionService.executeWorkflow(workflowId);
+    workflowExecutionService.executeWorkflow(workflowId, context);
     return ResponseEntity.accepted().build();
   }
 
diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/manager/ExecutionMdcManager.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/manager/ExecutionMdcManager.java
index 38c1ae38..8dea91f4 100644
--- a/apps/user-service/src/main/java/site/icebang/domain/workflow/manager/ExecutionMdcManager.java
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/manager/ExecutionMdcManager.java
@@ -8,11 +8,21 @@ public class ExecutionMdcManager {
   private static final String SOURCE_ID = "sourceId";
   private static final String EXECUTION_TYPE = "executionType";
   private static final String TRACE_ID = "traceID";
+  private static final String CLIENT_IP = "clientIp";
+  private static final String USER_AGENT = "userAgent";
 
-  public void setWorkflowContext(Long workflowId, String traceId) {
+  public void setWorkflowContext(
+      Long workflowId, String traceId, String clientIp, String userAgent) {
     MDC.put(SOURCE_ID, workflowId.toString());
     MDC.put(EXECUTION_TYPE, "WORKFLOW");
     MDC.put(TRACE_ID, traceId);
+
+    if (clientIp != null) {
+      MDC.put(CLIENT_IP, clientIp);
+    }
+    if (userAgent != null) {
+      MDC.put(USER_AGENT, userAgent);
+    }
   }
 
   public void setWorkflowContext(Long workflowId) {
diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/model/WorkflowRun.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/model/WorkflowRun.java
index 1c3a0796..111b2e89 100644
--- a/apps/user-service/src/main/java/site/icebang/domain/workflow/model/WorkflowRun.java
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/model/WorkflowRun.java
@@ -1,9 +1,6 @@
 package site.icebang.domain.workflow.model;
 
 import java.time.Instant;
-import java.util.UUID;
-
-import org.slf4j.MDC;
 
 import lombok.Getter;
 import lombok.NoArgsConstructor;
@@ -20,18 +17,18 @@ public class WorkflowRun {
   private Instant finishedAt;
   private Instant createdAt;
 
-  private WorkflowRun(Long workflowId) {
+  private WorkflowRun(Long workflowId, String traceId) {
     this.workflowId = workflowId;
     // MDC에서 현재 요청의 traceId를 가져오거나, 없으면 새로 생성
-    this.traceId = MDC.get("traceId") != null ? MDC.get("traceId") : UUID.randomUUID().toString();
+    this.traceId = traceId;
     this.status = "RUNNING";
     this.startedAt = Instant.now();
     this.createdAt = this.startedAt;
   }
 
   /** 워크플로우 실행 시작을 위한 정적 팩토리 메소드 */
-  public static WorkflowRun start(Long workflowId) {
-    return new WorkflowRun(workflowId);
+  public static WorkflowRun start(Long workflowId, String traceId) {
+    return new WorkflowRun(workflowId, traceId);
   }
 
   /** 워크플로우 실행 완료 처리 */
diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/scheduler/WorkflowTriggerJob.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/scheduler/WorkflowTriggerJob.java
index a3076d1f..d0bc46f1 100644
--- a/apps/user-service/src/main/java/site/icebang/domain/workflow/scheduler/WorkflowTriggerJob.java
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/scheduler/WorkflowTriggerJob.java
@@ -7,6 +7,7 @@
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 
+import site.icebang.domain.workflow.service.RequestContextService;
 import site.icebang.domain.workflow.service.WorkflowExecutionService;
 
 /**
@@ -30,6 +31,7 @@
 @RequiredArgsConstructor
 public class WorkflowTriggerJob extends QuartzJobBean {
   private final WorkflowExecutionService workflowExecutionService;
+  private final RequestContextService requestContextService;
 
   /**
    * Quartz 스케줄러에 의해 트리거가 발동될 때 호출되는 메인 실행 메소드입니다.
@@ -45,6 +47,6 @@ public class WorkflowTriggerJob extends QuartzJobBean {
   protected void executeInternal(JobExecutionContext context) {
     Long workflowId = context.getJobDetail().getJobDataMap().getLong("workflowId");
     log.info("Quartz가 WorkflowTriggerJob을 실행합니다. WorkflowId={}", workflowId);
-    workflowExecutionService.executeWorkflow(workflowId);
+    workflowExecutionService.executeWorkflow(workflowId, requestContextService.quartzContext());
   }
 }
diff --git a/apps/user-service/src/main/java/site/icebang/domain/workflow/service/WorkflowExecutionService.java b/apps/user-service/src/main/java/site/icebang/domain/workflow/service/WorkflowExecutionService.java
index 4d781cee..d536f4de 100644
--- a/apps/user-service/src/main/java/site/icebang/domain/workflow/service/WorkflowExecutionService.java
+++ b/apps/user-service/src/main/java/site/icebang/domain/workflow/service/WorkflowExecutionService.java
@@ -20,6 +20,7 @@
 import lombok.RequiredArgsConstructor;
 
 import site.icebang.domain.workflow.dto.JobDto;
+import site.icebang.domain.workflow.dto.RequestContext;
 import site.icebang.domain.workflow.dto.TaskDto;
 import site.icebang.domain.workflow.dto.WorkflowDetailCardDto;
 import site.icebang.domain.workflow.manager.ExecutionMdcManager;
@@ -47,11 +48,12 @@ public class WorkflowExecutionService {
   private final WorkflowMapper workflowMapper;
 
   @Async("traceExecutor")
-  public void executeWorkflow(Long workflowId) {
-    WorkflowRun workflowRun = WorkflowRun.start(workflowId);
+  public void executeWorkflow(Long workflowId, RequestContext context) {
+    WorkflowRun workflowRun = WorkflowRun.start(workflowId, context.getTraceId());
     workflowRunMapper.insert(workflowRun);
 
-    mdcManager.setWorkflowContext(workflowId, workflowRun.getTraceId());
+    mdcManager.setWorkflowContext(
+        workflowId, context.getTraceId(), context.getClientIp(), context.getUserAgent());
     try {
       workflowLogger.info("========== 워크플로우 실행 시작: WorkflowId={} ==========", workflowId);
 
diff --git a/apps/user-service/src/main/java/site/icebang/global/filter/logging/ClientLoggingFilter.java b/apps/user-service/src/main/java/site/icebang/global/filter/logging/ClientLoggingFilter.java
new file mode 100644
index 00000000..97c87b36
--- /dev/null
+++ b/apps/user-service/src/main/java/site/icebang/global/filter/logging/ClientLoggingFilter.java
@@ -0,0 +1,71 @@
+package site.icebang.global.filter.logging;
+
+import java.io.IOException;
+
+import org.slf4j.MDC;
+import org.springframework.core.annotation.Order;
+import org.springframework.stereotype.Component;
+
+import jakarta.servlet.*;
+import jakarta.servlet.http.HttpServletRequest;
+
+/** 클라이언트 요청 정보를 MDC에 설정하는 필터 모든 HTTP 요청에 대해 클라이언트 IP와 User-Agent 정보를 추출하여 로깅 컨텍스트에 저장합니다. */
+@Component
+@Order(1) // 필터 체인에서 첫 번째로 실행되도록 우선순위 설정
+public class ClientLoggingFilter implements Filter {
+
+  /**
+   * HTTP 요청을 필터링하여 클라이언트 정보를 MDC에 설정합니다.
+   *
+   * @param request 서블릿 요청 객체
+   * @param response 서블릿 응답 객체
+   * @param chain 필터 체인
+   * @throws IOException 입출력 예외
+   * @throws ServletException 서블릿 예외
+   */
+  @Override
+  public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
+      throws IOException, ServletException {
+
+    HttpServletRequest httpRequest = (HttpServletRequest) request;
+    String ip = getClientIp(httpRequest);
+    String userAgent = httpRequest.getHeader("User-Agent");
+
+    try {
+      MDC.put("clientIp", ip);
+      MDC.put("userAgent", userAgent);
+
+      chain.doFilter(request, response);
+    } finally {
+      MDC.remove("clientIp");
+      MDC.remove("userAgent");
+    }
+  }
+
+  /**
+   * 프록시 환경을 고려하여 클라이언트의 실제 IP 주소를 추출합니다. 로드 밸런서나 프록시 서버를 통해 들어오는 요청의 원본 IP를 찾습니다.
+   *
+   * @param request HTTP 요청 객체
+   * @return 클라이언트의 실제 IP 주소
+   */
+  private String getClientIp(HttpServletRequest request) {
+
+    String[] headers = {
+      "X-Forwarded-For", // 표준 프록시 헤더
+      "Proxy-Client-IP", // Apache 프록시
+      "WL-Proxy-Client-IP", // WebLogic 프록시
+      "HTTP_X_FORWARDED_FOR", // HTTP 프록시
+      "HTTP_CLIENT_IP", // HTTP 클라이언트 IP
+      "REMOTE_ADDR" // 원격 주소
+    };
+
+    for (String header : headers) {
+      String ip = request.getHeader(header);
+      if (ip != null && !ip.isEmpty() && !"unknown".equalsIgnoreCase(ip)) {
+        return ip.split(",")[0].trim();
+      }
+    }
+
+    return request.getRemoteAddr();
+  }
+}
diff --git a/apps/user-service/src/main/resources/log4j2-develop.yml b/apps/user-service/src/main/resources/log4j2-develop.yml
index 21790eea..f869d73b 100644
--- a/apps/user-service/src/main/resources/log4j2-develop.yml
+++ b/apps/user-service/src/main/resources/log4j2-develop.yml
@@ -12,10 +12,10 @@ Configuration:
         value: "UTF-8"
       # DEBUG 환경용 콘솔 패턴 - 더 간단하고 가독성 좋게
       - name: "console-layout-pattern"
-        value: "%highlight{[%-5level]} [%X{traceId}] [%X{spanId}] %d{HH:mm:ss} [%t] %n   %logger{20} - %msg%n%n "
+        value: "%highlight{[%-5level]} [%X{traceId}] [%X{spanId}] [%X{clientIp}] [%X{userAgent}] %d{HH:mm:ss} [%t] %n   %logger{20} - %msg%n%n "
       # 파일용 패턴 - Promtail이 파싱하기 쉽게 구조화 (UTC 시간 사용)
       - name: "file-layout-pattern"
-        value: "[%X{traceId}] [%X{spanId}] %d{yyyy-MM-dd HH:mm:ss.SSS}{UTC} [%t] %-5level %logger{36} - %msg%n"
+        value: "[%X{traceId}] [%X{spanId}] [%X{clientIp}] [%X{userAgent}] %d{yyyy-MM-dd HH:mm:ss.SSS}{UTC} [%t] %-5level %logger{36} - %msg%n"
       # 개발 환경용 로그 파일들 - 절대경로나 상대경로 설정
       - name: "dev-log"
         value: ${log-path}/develop/app.log
diff --git a/apps/user-service/src/main/resources/log4j2-production.yml b/apps/user-service/src/main/resources/log4j2-production.yml
index 79d920fc..efeb7fa1 100644
--- a/apps/user-service/src/main/resources/log4j2-production.yml
+++ b/apps/user-service/src/main/resources/log4j2-production.yml
@@ -13,10 +13,10 @@ Configuration:
         value: "UTF-8"
       # 프로덕션 환경용 콘솔 패턴 - 구조화된 로그
       - name: "console-layout-pattern"
-        value: "%highlight{[%-5level]} [%X{traceId}] [%X{spanId}] %d{HH:mm:ss}{UTC} [%t] %logger{20} - %msg%n"
+        value: "%highlight{[%-5level]} [%X{traceId}] [%X{spanId}] [%X{clientIp}] [%X{userAgent}] %d{HH:mm:ss}{UTC} [%t] %logger{20} - %msg%n"
       # 파일용 패턴 - Promtail이 파싱하기 쉽게 구조화 (UTC 시간 사용)
       - name: "file-layout-pattern"
-        value: "[%X{traceId}] [%X{spanId}] %d{yyyy-MM-dd HH:mm:ss.SSS}{UTC} [%t] %-5level %logger{36} - %msg%n"
+        value: "[%X{traceId}] [%X{spanId}] [%X{clientIp}] [%X{userAgent}] %d{yyyy-MM-dd HH:mm:ss.SSS}{UTC} [%t] %-5level %logger{36} - %msg%n"
       # 프로덕션 환경용 로그 파일들
       - name: "prod-log"
         value: ${log-path}/production/app.log