kt-event-marketing/develop/mq/mq-exec-dev.md
doyeon 9039424c40 WinnerController Swagger 문서화 추가 및 이벤트/참여자 예외 처리 개선
- WinnerController에 Swagger 어노테이션 추가 (Operation, Parameter, ParameterObject)
- 당첨자 목록 조회 API 기본 정렬 설정 (winnerRank ASC, size=20)
- ParticipationService에서 이벤트/참여자 구분 로직 개선
  - 이벤트 없음: EventNotFoundException 발생
  - 참여자 없음: ParticipantNotFoundException 발생
- EventCacheService 제거 (Redis 기반 검증에서 DB 기반 검증으로 변경)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-27 11:15:04 +09:00

2.0 KiB

MQ 설치 결과서 (개발 환경)

설치 정보

Kafka 브로커 정보

  • Host: 4.217.131.59
  • Port: 9095
  • Broker 주소: 4.217.131.59:9095

Consumer Group ID 설정

서비스 Consumer Group ID 설명
ai ai AI 서비스용 Consumer Group
analytic analytic 분석 서비스용 Consumer Group

연결 설정 예시

Spring Boot 설정 (application.yml)

spring:
  kafka:
    bootstrap-servers: 4.230.50.63:9092
    consumer:
      group-id: ai  # 또는 analytic
      auto-offset-reset: earliest
      key-deserializer: org.apache.kafka.common.serialization.StringDeserializer
      value-deserializer: org.apache.kafka.common.serialization.StringDeserializer
    producer:
      key-serializer: org.apache.kafka.common.serialization.StringSerializer
      value-serializer: org.apache.kafka.common.serialization.StringSerializer

환경 변수 설정

export KAFKA_BOOTSTRAP_SERVERS=20.249.182.13:9095,4.217.131.59:9095
export KAFKA_CONSUMER_GROUP_ID=ai  # 또는 analytic

설치 확인

연결 테스트

# Kafka 브로커 연결 확인
kafka-broker-api-versions --bootstrap-server 4.230.50.63:9092

# 토픽 목록 확인
kafka-topics --bootstrap-server 4.230.50.63:9092 --list

# Consumer Group 목록 확인
kafka-consumer-groups --bootstrap-server 4.230.50.63:9092 --list

토픽 설정

AI 서비스 관련 토픽

  • ai-request: AI 요청 메시지 토픽
  • ai-response: AI 응답 메시지 토픽
  • ai-schedule: AI 일정 생성 메시지 토픽

Analytic 서비스 관련 토픽

  • analytic-event: 분석 이벤트 메시지 토픽
  • analytic-result: 분석 결과 메시지 토픽

설치 날짜

  • 작성일: 2025-10-23

비고

  • 개발 환경(dev)용 Kafka 설정
  • 각 서비스별 Consumer Group ID가 분리되어 독립적인 메시지 소비 가능
  • 필요시 추가 토픽 생성 및 Consumer Group 추가 가능