이벤트 기반 메시징 (Spring Boot 3)

무엇을 해주나

Claude가 Spring Boot 3 메시징 코드를 만들거나 리뷰할 때 따라야 할 규칙 세트를 주입합니다.

• 이벤트 계약: eventId, eventType, occurredAt, schemaVersion + payload로 구성된 불변 엔벌로프 사용, 스키마를 API처럼 하위 호환 유지, 상관관계(correlation)·인과(causation) ID를 헤더/엔벌로프에 배치
• 프로듀서: 상태 변경이 영속화된 뒤 발행, DB와 브로커 정합성이 필요하면 트랜잭셔널 아웃박스, 집합체 단위 순서가 중요하면 결정적 파티션 키, delivery timeout·ack 명시
• 컨슈머: 처리 이력 테이블 또는 본질적 멱등 쓰기로 핸들러 멱등화, 상태 변경과 멱등 마커를 한 트랜잭션에, 일시/영구 실패 분류 후 백오프 제한 재시도, 독성 메시지는 DLQ로 (원본·실패 사유·시도 횟수 보존)
• 테스트: 직렬화 호환성, 멱등성, Testcontainers 브로커 통합 테스트, 중복·순서 뒤바뀜·지연·독성 메시지 시나리오
• 함정 목록: "브로커가 트랜잭션을 지원하니 exactly-once"라는 착각, 검증 실패 무한 재시도, 아웃박스 없이 DB 트랜잭션 안에서 발행, 랜덤 파티션 키, JPA 엔티티로 직접 역직렬화 등

이런 분께 추천

• Kafka/RabbitMQ 기반 마이크로서비스를 운영하는 Spring Boot(Java/Kotlin) 백엔드 개발자
• 중복 처리, 메시지 유실, 순서 깨짐 이슈로 고생 중인 팀
• 메시징 코드 리뷰 기준을 팀 공통 규칙으로 고정하고 싶은 테크 리드

활용 예시

1. "주문 생성 시 OrderCreated 이벤트를 Kafka로 발행해줘" → 아웃박스 테이블 + 스키마 버전이 붙은 엔벌로프 형태로 구현 제안
2. "이 @KafkaListener 코드 리뷰해줘" → 멱등성 마커 부재, 재시도 무한 루프, DLQ 미설정 지적
3. "결제 컨슈머 통합 테스트 작성해줘" → Testcontainers로 브로커를 띄우고 중복·지연·독성 메시지 케이스 테스트 생성

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/rrezartprebreza/spring-boot-skills/HEAD/skills/spring-boot-3/event-driven-messaging/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 rrezartprebreza/spring-boot-skills 의 skills/spring-boot-3/event-driven-messaging 폴더를 내 ~/.claude/skills/event-driven-messaging/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.