Content Service 기능 개발 완료

- Redis 연동 구현 (패스워드 인증 지원) - RedisConfig에 password 설정 추가 - RedisGateway에 ContentReader/Writer 인터페이스 구현 - application-dev.yml 프로파일 추가 - 이미지 삭제 기능 구현 - DeleteImageUseCase 인터페이스 추가 - DeleteImageService 구현 - ContentWriter.deleteImageById() 메서드 추가 - RedisGateway 및 MockRedisGateway 삭제 로직 구현 - 이미지 필터링 기능 추가 - GetImageListUseCase에 style, platform 파라미터 추가 - GetImageListService에 Stream filter 로직 구현 - ContentController에서 String → Enum 변환 처리 - Mock 서비스 dev 프로파일 지원 - MockGenerateImagesService dev 프로파일 추가 - MockRegenerateImageService dev 프로파일 추가 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-27 09:45:21 +09:00 · 2025-10-27 09:45:21 +09:00 · f838c689ed
commit f838c689ed
parent ff83dca1a1
14 changed files with 563 additions and 11 deletions
--- a/content-service/src/main/java/com/kt/event/content/biz/service/DeleteImageService.java
+++ b/content-service/src/main/java/com/kt/event/content/biz/service/DeleteImageService.java
@ -0,0 +1,38 @@
+package com.kt.event.content.biz.service;
+
+import com.kt.event.common.exception.BusinessException;
+import com.kt.event.common.exception.ErrorCode;
+import com.kt.event.content.biz.usecase.in.DeleteImageUseCase;
+import com.kt.event.content.biz.usecase.out.ContentReader;
+import com.kt.event.content.biz.usecase.out.ContentWriter;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+/**
+ * 이미지 삭제 서비스
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+@Transactional
+public class DeleteImageService implements DeleteImageUseCase {
+
+    private final ContentReader contentReader;
+    private final ContentWriter contentWriter;
+
+    @Override
+    public void execute(Long imageId) {
+        log.info("[DeleteImageService] 이미지 삭제 요청: imageId={}", imageId);
+
+        // 이미지 존재 확인
+        contentReader.findImageById(imageId)
+                .orElseThrow(() -> new BusinessException(ErrorCode.COMMON_001, "이미지를 찾을 수 없습니다"));
+
+        // 이미지 삭제
+        contentWriter.deleteImageById(imageId);
+
+        log.info("[DeleteImageService] 이미지 삭제 완료: imageId={}", imageId);
+    }
+}
--- a/content-service/src/main/java/com/kt/event/content/biz/service/GetImageListService.java
+++ b/content-service/src/main/java/com/kt/event/content/biz/service/GetImageListService.java
@ -1,6 +1,8 @@
 package com.kt.event.content.biz.service;

 import com.kt.event.content.biz.domain.GeneratedImage;
+import com.kt.event.content.biz.domain.ImageStyle;
+import com.kt.event.content.biz.domain.Platform;
 import com.kt.event.content.biz.dto.ImageInfo;
 import com.kt.event.content.biz.usecase.in.GetImageListUseCase;
 import com.kt.event.content.biz.usecase.out.ContentReader;
@ -24,9 +26,15 @@ public class GetImageListService implements GetImageListUseCase {
    private final ContentReader contentReader;

    @Override
-    public List<ImageInfo> execute(Long eventDraftId) {
+    public List<ImageInfo> execute(Long eventDraftId, ImageStyle style, Platform platform) {
+        log.info("이미지 목록 조회: eventDraftId={}, style={}, platform={}", eventDraftId, style, platform);
+
        List<GeneratedImage> images = contentReader.findImagesByEventDraftId(eventDraftId);
+
+        // 필터링 적용
        return images.stream()
+                .filter(image -> style == null || image.getStyle() == style)
+                .filter(image -> platform == null || image.getPlatform() == platform)
                .map(ImageInfo::from)
                .collect(Collectors.toList());
    }
--- a/content-service/src/main/java/com/kt/event/content/biz/service/mock/MockGenerateImagesService.java
+++ b/content-service/src/main/java/com/kt/event/content/biz/service/mock/MockGenerateImagesService.java
@ -29,7 +29,7 @@ import java.util.UUID;
 */
@Slf4j
@Service
-@Profile({"local", "test"})
+@Profile({"local", "test", "dev"})
@RequiredArgsConstructor
 public class MockGenerateImagesService implements GenerateImagesUseCase {

--- a/content-service/src/main/java/com/kt/event/content/biz/service/mock/MockRegenerateImageService.java
+++ b/content-service/src/main/java/com/kt/event/content/biz/service/mock/MockRegenerateImageService.java
@ -19,7 +19,7 @@ import java.util.UUID;
 */
@Slf4j
@Service
-@Profile({"local", "test"})
+@Profile({"local", "test", "dev"})
@RequiredArgsConstructor
 public class MockRegenerateImageService implements RegenerateImageUseCase {

--- a/content-service/src/main/java/com/kt/event/content/biz/usecase/in/DeleteImageUseCase.java
+++ b/content-service/src/main/java/com/kt/event/content/biz/usecase/in/DeleteImageUseCase.java
@ -0,0 +1,14 @@
+package com.kt.event.content.biz.usecase.in;
+
+/**
+ * 이미지 삭제 UseCase
+ */
+public interface DeleteImageUseCase {
+
+    /**
+     * 이미지 삭제
+     *
+     * @param imageId 삭제할 이미지 ID
+     */
+    void execute(Long imageId);
+}
--- a/content-service/src/main/java/com/kt/event/content/biz/usecase/in/GetImageListUseCase.java
+++ b/content-service/src/main/java/com/kt/event/content/biz/usecase/in/GetImageListUseCase.java
@ -1,5 +1,7 @@
 package com.kt.event.content.biz.usecase.in;

+import com.kt.event.content.biz.domain.ImageStyle;
+import com.kt.event.content.biz.domain.Platform;
 import com.kt.event.content.biz.dto.ImageInfo;

 import java.util.List;
@ -10,10 +12,12 @@ import java.util.List;
 public interface GetImageListUseCase {

    /**
-     * 이벤트의 이미지 목록 조회
+     * 이벤트의 이미지 목록 조회 (필터링 지원)
     *
     * @param eventDraftId 이벤트 초안 ID
+     * @param style 이미지 스타일 필터 (null이면 전체)
+     * @param platform 플랫폼 필터 (null이면 전체)
     * @return 이미지 정보 목록
     */
-    List<ImageInfo> execute(Long eventDraftId);
+    List<ImageInfo> execute(Long eventDraftId, ImageStyle style, Platform platform);
 }
--- a/content-service/src/main/java/com/kt/event/content/biz/usecase/out/ContentWriter.java
+++ b/content-service/src/main/java/com/kt/event/content/biz/usecase/out/ContentWriter.java
@ -23,4 +23,11 @@ public interface ContentWriter {
     * @return 저장된 이미지
     */
    GeneratedImage saveImage(GeneratedImage image);
+
+    /**
+     * 이미지 ID로 이미지 삭제
+     *
+     * @param imageId 이미지 ID
+     */
+    void deleteImageById(Long imageId);
 }
--- a/content-service/src/main/java/com/kt/event/content/infra/config/RedisConfig.java
+++ b/content-service/src/main/java/com/kt/event/content/infra/config/RedisConfig.java
@ -25,9 +25,18 @@ public class RedisConfig {
    @Value("${spring.data.redis.port}")
    private int port;

+    @Value("${spring.data.redis.password:}")
+    private String password;
+
    @Bean
    public RedisConnectionFactory redisConnectionFactory() {
        RedisStandaloneConfiguration config = new RedisStandaloneConfiguration(host, port);
+
+        // 패스워드가 있는 경우에만 설정
+        if (password != null && !password.isEmpty()) {
+            config.setPassword(password);
+        }
+
        return new LettuceConnectionFactory(config);
    }

--- a/content-service/src/main/java/com/kt/event/content/infra/gateway/RedisGateway.java
+++ b/content-service/src/main/java/com/kt/event/content/infra/gateway/RedisGateway.java
@ -1,12 +1,15 @@
 package com.kt.event.content.infra.gateway;

 import com.fasterxml.jackson.databind.ObjectMapper;
+import com.kt.event.content.biz.domain.Content;
 import com.kt.event.content.biz.domain.GeneratedImage;
 import com.kt.event.content.biz.domain.ImageStyle;
 import com.kt.event.content.biz.domain.Job;
 import com.kt.event.content.biz.domain.Platform;
 import com.kt.event.content.biz.dto.RedisImageData;
 import com.kt.event.content.biz.dto.RedisJobData;
+import com.kt.event.content.biz.usecase.out.ContentReader;
+import com.kt.event.content.biz.usecase.out.ContentWriter;
 import com.kt.event.content.biz.usecase.out.ImageReader;
 import com.kt.event.content.biz.usecase.out.ImageWriter;
 import com.kt.event.content.biz.usecase.out.JobReader;
@ -36,7 +39,7 @@ import java.util.stream.Collectors;
@Component
@Profile({"!local", "!test"})
@RequiredArgsConstructor
-public class RedisGateway implements RedisAIDataReader, RedisImageWriter, ImageWriter, ImageReader, JobWriter, JobReader {
+public class RedisGateway implements RedisAIDataReader, RedisImageWriter, ImageWriter, ImageReader, JobWriter, JobReader, ContentReader, ContentWriter {

    private final RedisTemplate<String, Object> redisTemplate;
    private final ObjectMapper objectMapper;
@ -338,4 +341,190 @@ public class RedisGateway implements RedisAIDataReader, RedisImageWriter, ImageW
        String value = getString(map, key);
        return value != null && !value.isEmpty() ? LocalDateTime.parse(value) : null;
    }
+
+    // ==================== ContentReader 구현 ====================
+
+    private static final String CONTENT_META_KEY_PREFIX = "content:meta:";
+    private static final String IMAGE_BY_ID_KEY_PREFIX = "content:image:id:";
+    private static final String IMAGE_IDS_SET_KEY_PREFIX = "content:images:";
+
+    @Override
+    public Optional<Content> findByEventDraftIdWithImages(Long eventDraftId) {
+        try {
+            String contentKey = CONTENT_META_KEY_PREFIX + eventDraftId;
+            Map<Object, Object> contentFields = redisTemplate.opsForHash().entries(contentKey);
+
+            if (contentFields.isEmpty()) {
+                log.warn("Content를 찾을 수 없음: eventDraftId={}", eventDraftId);
+                return Optional.empty();
+            }
+
+            // 이미지 목록 조회
+            List<GeneratedImage> images = findImagesByEventDraftId(eventDraftId);
+
+            // Content 재구성
+            Content content = Content.builder()
+                    .id(getLong(contentFields, "id"))
+                    .eventDraftId(getLong(contentFields, "eventDraftId"))
+                    .eventTitle(getString(contentFields, "eventTitle"))
+                    .eventDescription(getString(contentFields, "eventDescription"))
+                    .images(images)
+                    .createdAt(getLocalDateTime(contentFields, "createdAt"))
+                    .updatedAt(getLocalDateTime(contentFields, "updatedAt"))
+                    .build();
+
+            return Optional.of(content);
+        } catch (Exception e) {
+            log.error("Content 조회 실패: eventDraftId={}", eventDraftId, e);
+            return Optional.empty();
+        }
+    }
+
+    @Override
+    public Optional<GeneratedImage> findImageById(Long imageId) {
+        try {
+            String key = IMAGE_BY_ID_KEY_PREFIX + imageId;
+            Object data = redisTemplate.opsForValue().get(key);
+
+            if (data == null) {
+                log.warn("이미지를 찾을 수 없음: imageId={}", imageId);
+                return Optional.empty();
+            }
+
+            GeneratedImage image = objectMapper.readValue(data.toString(), GeneratedImage.class);
+            return Optional.of(image);
+        } catch (Exception e) {
+            log.error("이미지 조회 실패: imageId={}", imageId, e);
+            return Optional.empty();
+        }
+    }
+
+    @Override
+    public List<GeneratedImage> findImagesByEventDraftId(Long eventDraftId) {
+        try {
+            String setKey = IMAGE_IDS_SET_KEY_PREFIX + eventDraftId;
+            var imageIdSet = redisTemplate.opsForSet().members(setKey);
+
+            if (imageIdSet == null || imageIdSet.isEmpty()) {
+                log.info("이미지 목록이 비어있음: eventDraftId={}", eventDraftId);
+                return new ArrayList<>();
+            }
+
+            List<GeneratedImage> images = new ArrayList<>();
+            for (Object imageIdObj : imageIdSet) {
+                Long imageId = Long.valueOf(imageIdObj.toString());
+                findImageById(imageId).ifPresent(images::add);
+            }
+
+            log.info("이미지 목록 조회 완료: eventDraftId={}, count={}", eventDraftId, images.size());
+            return images;
+        } catch (Exception e) {
+            log.error("이미지 목록 조회 실패: eventDraftId={}", eventDraftId, e);
+            return new ArrayList<>();
+        }
+    }
+
+    // ==================== ContentWriter 구현 ====================
+
+    private static Long nextContentId = 1L;
+    private static Long nextImageId = 1L;
+
+    @Override
+    public Content save(Content content) {
+        try {
+            Long id = content.getId() != null ? content.getId() : nextContentId++;
+            String contentKey = CONTENT_META_KEY_PREFIX + content.getEventDraftId();
+
+            // Content 메타 정보 저장
+            Map<String, String> contentFields = new java.util.HashMap<>();
+            contentFields.put("id", String.valueOf(id));
+            contentFields.put("eventDraftId", String.valueOf(content.getEventDraftId()));
+            contentFields.put("eventTitle", content.getEventTitle() != null ? content.getEventTitle() : "");
+            contentFields.put("eventDescription", content.getEventDescription() != null ? content.getEventDescription() : "");
+            contentFields.put("createdAt", content.getCreatedAt() != null ? content.getCreatedAt().toString() : LocalDateTime.now().toString());
+            contentFields.put("updatedAt", content.getUpdatedAt() != null ? content.getUpdatedAt().toString() : LocalDateTime.now().toString());
+
+            redisTemplate.opsForHash().putAll(contentKey, contentFields);
+            redisTemplate.expire(contentKey, DEFAULT_TTL);
+
+            // Content 재구성하여 반환
+            Content savedContent = Content.builder()
+                    .id(id)
+                    .eventDraftId(content.getEventDraftId())
+                    .eventTitle(content.getEventTitle())
+                    .eventDescription(content.getEventDescription())
+                    .images(content.getImages())
+                    .createdAt(content.getCreatedAt())
+                    .updatedAt(content.getUpdatedAt())
+                    .build();
+
+            log.info("Content 저장 완료: contentId={}, eventDraftId={}", id, content.getEventDraftId());
+            return savedContent;
+        } catch (Exception e) {
+            log.error("Content 저장 실패: eventDraftId={}", content.getEventDraftId(), e);
+            throw new RuntimeException("Content 저장 실패", e);
+        }
+    }
+
+    @Override
+    public GeneratedImage saveImage(GeneratedImage image) {
+        try {
+            Long imageId = image.getId() != null ? image.getId() : nextImageId++;
+
+            // GeneratedImage 저장
+            String imageKey = IMAGE_BY_ID_KEY_PREFIX + imageId;
+            GeneratedImage savedImage = GeneratedImage.builder()
+                    .id(imageId)
+                    .eventDraftId(image.getEventDraftId())
+                    .style(image.getStyle())
+                    .platform(image.getPlatform())
+                    .cdnUrl(image.getCdnUrl())
+                    .prompt(image.getPrompt())
+                    .selected(image.isSelected())
+                    .createdAt(image.getCreatedAt() != null ? image.getCreatedAt() : LocalDateTime.now())
+                    .updatedAt(image.getUpdatedAt() != null ? image.getUpdatedAt() : LocalDateTime.now())
+                    .build();
+
+            String json = objectMapper.writeValueAsString(savedImage);
+            redisTemplate.opsForValue().set(imageKey, json, DEFAULT_TTL);
+
+            // Image ID를 Set에 추가
+            String setKey = IMAGE_IDS_SET_KEY_PREFIX + image.getEventDraftId();
+            redisTemplate.opsForSet().add(setKey, imageId);
+            redisTemplate.expire(setKey, DEFAULT_TTL);
+
+            log.info("이미지 저장 완료: imageId={}, eventDraftId={}", imageId, image.getEventDraftId());
+            return savedImage;
+        } catch (Exception e) {
+            log.error("이미지 저장 실패: eventDraftId={}", image.getEventDraftId(), e);
+            throw new RuntimeException("이미지 저장 실패", e);
+        }
+    }
+
+    @Override
+    public void deleteImageById(Long imageId) {
+        try {
+            // 이미지 조회
+            Optional<GeneratedImage> imageOpt = findImageById(imageId);
+            if (imageOpt.isEmpty()) {
+                log.warn("삭제할 이미지를 찾을 수 없음: imageId={}", imageId);
+                return;
+            }
+
+            GeneratedImage image = imageOpt.get();
+
+            // Image 삭제
+            String imageKey = IMAGE_BY_ID_KEY_PREFIX + imageId;
+            redisTemplate.delete(imageKey);
+
+            // Set에서 Image ID 제거
+            String setKey = IMAGE_IDS_SET_KEY_PREFIX + image.getEventDraftId();
+            redisTemplate.opsForSet().remove(setKey, imageId);
+
+            log.info("이미지 삭제 완료: imageId={}, eventDraftId={}", imageId, image.getEventDraftId());
+        } catch (Exception e) {
+            log.error("이미지 삭제 실패: imageId={}", imageId, e);
+            throw new RuntimeException("이미지 삭제 실패", e);
+        }
+    }
 }
--- a/content-service/src/main/java/com/kt/event/content/infra/gateway/mock/MockRedisGateway.java
+++ b/content-service/src/main/java/com/kt/event/content/infra/gateway/mock/MockRedisGateway.java
@ -398,4 +398,33 @@ public class MockRedisGateway implements RedisAIDataReader, RedisImageWriter, Im
            throw e;
        }
    }
+
+    /**
+     * 이미지 ID로 이미지 삭제
+     */
+    @Override
+    public void deleteImageById(Long imageId) {
+        try {
+            // imageByIdStorage에서 이미지 조회
+            GeneratedImage image = imageByIdStorage.get(imageId);
+
+            if (image == null) {
+                log.warn("[MOCK] 삭제할 이미지를 찾을 수 없음: imageId={}", imageId);
+                return;
+            }
+
+            // imageByIdStorage에서 삭제
+            imageByIdStorage.remove(imageId);
+
+            // imageStorage에서도 삭제 (Redis 캐시 스토리지)
+            String key = buildImageKey(image.getEventDraftId(), image.getStyle(), image.getPlatform());
+            imageStorage.remove(key);
+
+            log.info("[MOCK] 이미지 삭제 완료: imageId={}, eventDraftId={}, style={}, platform={}",
+                    imageId, image.getEventDraftId(), image.getStyle(), image.getPlatform());
+        } catch (Exception e) {
+            log.error("[MOCK] 이미지 삭제 실패: imageId={}", imageId, e);
+            throw e;
+        }
+    }
 }
--- a/content-service/src/main/java/com/kt/event/content/infra/web/controller/ContentController.java
+++ b/content-service/src/main/java/com/kt/event/content/infra/web/controller/ContentController.java
@ -1,9 +1,12 @@
 package com.kt.event.content.infra.web.controller;

+import com.kt.event.content.biz.domain.ImageStyle;
+import com.kt.event.content.biz.domain.Platform;
 import com.kt.event.content.biz.dto.ContentCommand;
 import com.kt.event.content.biz.dto.ContentInfo;
 import com.kt.event.content.biz.dto.ImageInfo;
 import com.kt.event.content.biz.dto.JobInfo;
+import com.kt.event.content.biz.usecase.in.DeleteImageUseCase;
 import com.kt.event.content.biz.usecase.in.GenerateImagesUseCase;
 import com.kt.event.content.biz.usecase.in.GetEventContentUseCase;
 import com.kt.event.content.biz.usecase.in.GetImageDetailUseCase;
@ -38,6 +41,7 @@ public class ContentController {
    private final GetImageListUseCase getImageListUseCase;
    private final GetImageDetailUseCase getImageDetailUseCase;
    private final RegenerateImageUseCase regenerateImageUseCase;
+    private final DeleteImageUseCase deleteImageUseCase;

    /**
     * POST /content/images/generate
@ -104,8 +108,11 @@ public class ContentController {
            @RequestParam(required = false) String platform) {
        log.info("이미지 목록 조회: eventDraftId={}, style={}, platform={}", eventDraftId, style, platform);

-        // TODO: 필터링 기능 추가 (현재는 전체 목록 반환)
-        List<ImageInfo> images = getImageListUseCase.execute(eventDraftId);
+        // String -> Enum 변환
+        ImageStyle imageStyle = style != null ? ImageStyle.valueOf(style.toUpperCase()) : null;
+        Platform imagePlatform = platform != null ? Platform.valueOf(platform.toUpperCase()) : null;
+
+        List<ImageInfo> images = getImageListUseCase.execute(eventDraftId, imageStyle, imagePlatform);

        return ResponseEntity.ok(images);
    }
@ -137,8 +144,7 @@ public class ContentController {
    public ResponseEntity<Void> deleteImage(@PathVariable Long imageId) {
        log.info("이미지 삭제 요청: imageId={}", imageId);

-        // TODO: DeleteImageUseCase 구현 필요
-        // deleteImageUseCase.execute(imageId);
+        deleteImageUseCase.execute(imageId);

        return ResponseEntity.noContent().build();
    }
--- a/content-service/src/main/resources/application-dev.yml
+++ b/content-service/src/main/resources/application-dev.yml
@ -0,0 +1,34 @@
+spring:
+  application:
+    name: content-service
+
+  data:
+    redis:
+      host: 20.214.210.71
+      port: 6379
+      password: Hi5Jessica!
+
+  kafka:
+    bootstrap-servers: 20.249.125.115:9092
+    consumer:
+      group-id: content-service-consumers
+      auto-offset-reset: earliest
+      key-deserializer: org.apache.kafka.common.serialization.StringDeserializer
+      value-deserializer: org.apache.kafka.common.serialization.StringDeserializer
+
+server:
+  port: 8084
+
+jwt:
+  secret: kt-event-marketing-jwt-secret-key-for-authentication-and-authorization-2025
+  access-token-validity: 3600000
+  refresh-token-validity: 604800000
+
+azure:
+  storage:
+    connection-string: ${AZURE_STORAGE_CONNECTION_STRING:}
+    container-name: event-images
+
+logging:
+  level:
+    com.kt.event: DEBUG
--- a/content-service/src/main/resources/application.yml
+++ b/content-service/src/main/resources/application.yml
@ -4,8 +4,9 @@ spring:

  data:
    redis:
-      host: 4.217.131.139
+      host: 20.214.210.71
      port: 6379
+      password: Hi5Jessica!

  kafka:
    bootstrap-servers: 20.249.125.115:9092
--- a/develop/dev/content-service-api-mapping.md
+++ b/develop/dev/content-service-api-mapping.md
@ -0,0 +1,213 @@
+# Content Service API 매핑표
+
+**작성일**: 2025-10-24
+**서비스**: content-service
+**비교 대상**: ContentController.java ↔ content-service-api.yaml
+
+## 1. API 매핑 테이블
+
+| No | Controller 메서드 | HTTP 메서드 | 경로 | API 명세 operationId | 유저스토리 | 구현 상태 | 비고 |
+|----|------------------|-------------|------|---------------------|-----------|-----------|------|
+| 1 | generateImages | POST | /content/images/generate | generateImages | US-CT-001 | ✅ 구현완료 | 이미지 생성 요청, Job ID 즉시 반환 |
+| 2 | getJobStatus | GET | /content/images/jobs/{jobId} | getImageGenerationStatus | US-CT-001 | ✅ 구현완료 | Job 상태 폴링용 |
+| 3 | getContentByEventId | GET | /content/events/{eventDraftId} | getContentByEventId | US-CT-002 | ✅ 구현완료 | 이벤트 콘텐츠 조회 |
+| 4 | getImages | GET | /content/events/{eventDraftId}/images | getImages | US-CT-003 | ✅ 구현완료 | 이미지 목록 조회 (스타일/플랫폼 필터링 지원) |
+| 5 | getImageById | GET | /content/images/{imageId} | getImageById | US-CT-003 | ✅ 구현완료 | 특정 이미지 상세 조회 |
+| 6 | deleteImage | DELETE | /content/images/{imageId} | deleteImage | US-CT-004 | ⚠️ TODO | 이미지 삭제 (미구현) |
+| 7 | regenerateImage | POST | /content/images/{imageId}/regenerate | regenerateImage | US-CT-005 | ✅ 구현완료 | 이미지 재생성 요청 |
+
+## 2. API 상세 비교
+
+### 2.1. POST /content/images/generate (이미지 생성 요청)
+
+**Controller 구현**:
+```java
+@PostMapping("/images/generate")
+public ResponseEntity<JobInfo> generateImages(@RequestBody ContentCommand.GenerateImages command)
+```
+
+**API 명세**:
+- operationId: `generateImages`
+- Request Body: `GenerateImagesRequest`
+  - eventDraftId (Long, required)
+  - styles (List<String>, optional)
+  - platforms (List<String>, optional)
+- Response: 202 Accepted → `JobResponse`
+
+**매핑 상태**: ✅ 완전 일치
+
+---
+
+### 2.2. GET /content/images/jobs/{jobId} (Job 상태 조회)
+
+**Controller 구현**:
+```java
+@GetMapping("/images/jobs/{jobId}")
+public ResponseEntity<JobInfo> getJobStatus(@PathVariable String jobId)
+```
+
+**API 명세**:
+- operationId: `getImageGenerationStatus`
+- Path Parameter: `jobId` (String, required)
+- Response: 200 OK → `JobResponse`
+
+**매핑 상태**: ✅ 완전 일치
+
+---
+
+### 2.3. GET /content/events/{eventDraftId} (이벤트 콘텐츠 조회)
+
+**Controller 구현**:
+```java
+@GetMapping("/events/{eventDraftId}")
+public ResponseEntity<ContentInfo> getContentByEventId(@PathVariable Long eventDraftId)
+```
+
+**API 명세**:
+- operationId: `getContentByEventId`
+- Path Parameter: `eventDraftId` (Long, required)
+- Response: 200 OK → `ContentResponse`
+
+**매핑 상태**: ✅ 완전 일치
+
+---
+
+### 2.4. GET /content/events/{eventDraftId}/images (이미지 목록 조회)
+
+**Controller 구현**:
+```java
+@GetMapping("/events/{eventDraftId}/images")
+public ResponseEntity<List<ImageInfo>> getImages(
+    @PathVariable Long eventDraftId,
+    @RequestParam(required = false) String style,
+    @RequestParam(required = false) String platform)
+```
+
+**API 명세**:
+- operationId: `getImages`
+- Path Parameter: `eventDraftId` (Long, required)
+- Query Parameters:
+  - style (String, optional)
+  - platform (String, optional)
+- Response: 200 OK → Array of `ImageResponse`
+
+**매핑 상태**: ✅ 완전 일치
+
+---
+
+### 2.5. GET /content/images/{imageId} (이미지 상세 조회)
+
+**Controller 구현**:
+```java
+@GetMapping("/images/{imageId}")
+public ResponseEntity<ImageInfo> getImageById(@PathVariable Long imageId)
+```
+
+**API 명세**:
+- operationId: `getImageById`
+- Path Parameter: `imageId` (Long, required)
+- Response: 200 OK → `ImageResponse`
+
+**매핑 상태**: ✅ 완전 일치
+
+---
+
+### 2.6. DELETE /content/images/{imageId} (이미지 삭제)
+
+**Controller 구현**:
+```java
+@DeleteMapping("/images/{imageId}")
+public ResponseEntity<Void> deleteImage(@PathVariable Long imageId) {
+    // TODO: 이미지 삭제 기능 구현 필요
+    throw new UnsupportedOperationException("이미지 삭제 기능은 아직 구현되지 않았습니다");
+}
+```
+
+**API 명세**:
+- operationId: `deleteImage`
+- Path Parameter: `imageId` (Long, required)
+- Response: 204 No Content
+
+**매핑 상태**: ⚠️ **메서드 선언만 존재, 실제 로직 미구현**
+
+**미구현 사유**:
+- Phase 3 작업 범위는 JPA → Redis 전환
+- 이미지 삭제 기능은 향후 구현 예정
+- API 명세와 Controller 시그니처는 일치하나 내부 로직은 UnsupportedOperationException 발생
+
+---
+
+### 2.7. POST /content/images/{imageId}/regenerate (이미지 재생성)
+
+**Controller 구현**:
+```java
+@PostMapping("/images/{imageId}/regenerate")
+public ResponseEntity<JobInfo> regenerateImage(
+    @PathVariable Long imageId,
+    @RequestBody(required = false) ContentCommand.RegenerateImage requestBody)
+```
+
+**API 명세**:
+- operationId: `regenerateImage`
+- Path Parameter: `imageId` (Long, required)
+- Request Body: `RegenerateImageRequest` (optional)
+  - style (String, optional)
+  - platform (String, optional)
+- Response: 202 Accepted → `JobResponse`
+
+**매핑 상태**: ✅ 완전 일치
+
+---
+
+## 3. 추가된 API 분석
+
+**결과**: API 명세에 없는 추가 API는 **존재하지 않음**
+
+- Controller에 구현된 모든 7개 엔드포인트는 API 명세서(content-service-api.yaml)에 정의되어 있음
+- API 명세서의 모든 6개 경로(7개 operation)가 Controller에 구현되어 있음
+
+## 4. 구현 상태 요약
+
+### 4.1. 구현 완료 (6개)
+1. ✅ POST /content/images/generate - 이미지 생성 요청
+2. ✅ GET /content/images/jobs/{jobId} - Job 상태 조회
+3. ✅ GET /content/events/{eventDraftId} - 이벤트 콘텐츠 조회
+4. ✅ GET /content/events/{eventDraftId}/images - 이미지 목록 조회
+5. ✅ GET /content/images/{imageId} - 이미지 상세 조회
+6. ✅ POST /content/images/{imageId}/regenerate - 이미지 재생성
+
+### 4.2. 미구현 (1개)
+1. ⚠️ DELETE /content/images/{imageId} - 이미지 삭제
+   - **사유**: Phase 3은 JPA → Redis 전환 작업만 포함
+   - **향후 계획**: Phase 4 또는 추후 기능 개발 단계에서 구현 예정
+   - **현재 동작**: `UnsupportedOperationException` 발생
+
+## 5. 검증 결과
+
+### ✅ API 명세 준수도: 85.7% (6/7 구현)
+
+- API 설계서와 Controller 구현이 **완전히 일치**함
+- 모든 경로, HTTP 메서드, 파라미터 타입이 명세와 동일
+- Response 타입도 명세의 스키마 정의와 일치
+- 미구현 1건은 명시적으로 TODO 주석으로 표시되어 추후 구현 가능
+
+### 권장 사항
+
+1. **DELETE /content/images/{imageId} 구현 완료**
+   - ImageWriter 포트에 deleteImage 메서드 추가
+   - RedisGateway 및 MockRedisGateway에 구현
+   - Service 레이어 생성 (DeleteImageService)
+   - Controller의 TODO 제거
+
+2. **통합 테스트 작성**
+   - 모든 구현된 API에 대한 통합 테스트 추가
+   - Mock 환경에서 전체 플로우 검증
+
+3. **API 문서 동기화 유지**
+   - 향후 API 변경 시 명세서와 Controller 동시 업데이트
+   - OpenAPI Spec 자동 검증 도구 도입 고려
+
+---
+
+**문서 작성자**: Claude
+**검증 완료**: 2025-10-24