SSE 운영 구현 글 추가 — 시리즈 2편

[kmg733]

개요

realtime-communication 시리즈 2편. 1편(#142, develop 병합 완료)에서 뗀 실무 사례를 앞에 두고, SSE를 실제 운영에 올리며 부딪힌 문제들을 순서대로 다룬다.

신규 글: sse-production-implementation.md

제목: SseEmitter를 반환하고 나서 시작된 일들

컨트롤러에서 SseEmitter를 반환하면 화면은 뜨지만, 그 코드는 "동작하는 코드"일 뿐 "운영에 올릴 수 있는 코드"는 아니다. 그 간극을 실제로 부딪힌 순서대로 정리했다.

구성

부분	내용
두 화면은 왜 갈렸나	1편에서 분리한 사례(처리 현황=SSE, 요약 대시보드=폴링)를 압축 복원
동작하는 코드는 30줄	가장 단순한 SseEmitter 구현과, 이 코드에 없는 것들
1. 부하	구독자 검사, dedup, 유휴 백오프, 권한별 직렬화 캐시
2. 격리	send는 블로킹이므로 전송을 전용 풀로 분리
3. 순서	전체 스냅샷 병렬 전송의 역전을 시퀀스 + CAS로 차단
4. 종료	complete와 send의 락 경합, 종료 전용 풀 분리
5. 세션	스트림은 세션을 못 살려 주기적 핑으로 유지
6. 재연결	백오프 + jitter + 탭 가시성으로 동시 폭주 방지
7. 정확성	dedup 최적화가 권한 회수 반영을 막는 충돌 해소

특징

• 뒤의 절반이 앞의 절반이 만든 문제라는 흐름(전송 격리 → 순서 역전, dedup → 권한 회수 누락)이 글의 매듭
• 사내 구현체 내용은 화면 이름·클래스·경로·필드를 익명화해 패턴 수준으로 재작성
• 다이어그램 5종(구조 분리·Executor 격리·순서 역전·세션 유휴·최종 구조)을 light/dark 쌍으로 사전 렌더링
• 용어 툴팁 6개 (sse-emitter, back-pressure, cas, broken-pipe, async-dispatch, idempotent)
• 썸네일은 1편과 동일 이미지 사용

테스트

npx next build   ✓ 31/31 정적 페이지
npm test         ✓ 52 suites / 551 tests

수동 확인: 용어 6개 각 1회, 이미지 12개 전부 실제 파일과 일치, 그림 1~6 순차