🔀
PayStream Kafka 토픽 & 이벤트 흐름
프로젝트 개요에서 그림 수준으로 정리한 MSA 구조를, Kafka 토픽·이벤트 계약·서비스 간 흐름까지 내려서 문서화한 글입니다. 동기 API(게이트웨이 REST)와 비동기 이벤트(Kafka)의 역할을 구분하고, 알림 서비스가 어떤 이벤트를 구독하는지까지 한곳에 모았습니다. 범위 안내 토픽 이름·페이로드는 팀 합의 기준의 설계안입니다. 일부는 백엔드 구현과 1:1로 맞춰 가는 중이며, 변경 시 이 문서를 함께 갱신합니다. 1. 전체 구조 1-1. 레이어 구분 경로 용도 예시 동기 (REST) 사용자 요청·즉시 응답이 필요한 작업 주문 생성, 결제 요청, 알림 목록 조회 비동기 (Kafka) 다른 서비스 상태 변경 전파, 부하 분리 재고 차감, 결제 완료, 알림 발송 트리거 프론트는 게이트웨이 단일 URL만 호출합니다. ( → notification-service — 연동 기록 참고) 1-2. 게이트웨이 라우팅 (알림 기준) 클라이언트 경로 게이트웨이 백엔드 서비스 인증 예외 n…
2026.06.18