9039424c40
- 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>
71 lines
2.0 KiB
Markdown
71 lines
2.0 KiB
Markdown
# 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)
|
|
```yaml
|
|
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
|
|
```
|
|
|
|
### 환경 변수 설정
|
|
```bash
|
|
export KAFKA_BOOTSTRAP_SERVERS=20.249.182.13:9095,4.217.131.59:9095
|
|
export KAFKA_CONSUMER_GROUP_ID=ai # 또는 analytic
|
|
```
|
|
|
|
## 설치 확인
|
|
|
|
### 연결 테스트
|
|
```bash
|
|
# 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 추가 가능
|