Kafka 토픽은 이벤트 이름보다 재처리 계약을 먼저 정한다

이벤트는 한 번 흘려보내는 알림이 아니라, 나중에 다시 읽고 여러 소비자가 나눠 처리할 운영 기록입니다.

Topic업무 사건 단위

`user_created`처럼 발생한 사실을 이름으로 둡니다.

Key순서를 묶는 기준

같은 사용자 이벤트가 같은 partition에 가도록 key를 정합니다.

Payload소비자가 필요한 최소 정보

변경 사실과 식별자를 담고, 큰 조회 데이터는 줄입니다.

Consumer group처리 책임 단위

메일, 분석, 감사 로그가 서로 독립적으로 읽을 수 있습니다.

설계 항목정할 것놓치면 생기는 문제
파티션 키같은 순서가 필요한 이벤트 묶음사용자별 이벤트 순서가 뒤섞임
보관 기간재처리 가능한 retention 기간장애 후 복구할 이벤트가 사라짐
중복 처리같은 이벤트가 두 번 와도 안전한 처리메일 중복 발송이나 정산 중복 반영

판단 기준: 토픽을 만들 때는 “누가 읽는가”보다 “어떤 사실을 얼마나 오래, 어떤 순서로 다시 읽을 수 있어야 하는가”를 먼저 정합니다.