RoundWaitFirebaseMigration
RoundWait Firebase 마이그레이션 — 인프라 전면 교체
2026. 6. 3.2분 읽기
배경
RoundWait는 행사 현장 대기열 관리 시스템이다. 부스별 예약, 현장 호출, 알림톡 발송까지 한 번에 처리한다. 기존 시스템의 실시간 처리 한계 때문에 Firebase RTDB로의 마이그레이션이 결정됐다.
5월 18일 기반 작업을 시작해서 6월 초까지 이어진 꽤 긴 마이그레이션이었다.
마이그레이션 전략
처음부터 전면 교체가 아니라 Dual Write 방식을 선택했다. 기존 시스템에 쓰는 동시에 Firebase RTDB에도 미러링하면서 검증하는 단계를 거쳤다.
5월 18일에 기반 코드를 올렸다.
- Firebase RTDB 실시간 게시 헬퍼
- 이벤트 스코프 기반 예약 페이로드 미러링
- Firebase Auth 클라이언트 기반 코드
5월 19일에는 백엔드 연결을 마무리했고, k6로 부하 테스트를 돌려 error rate 4.4%를 확인했다.
기능 구현 (5/25 ~ 6/3)
인프라가 안정되자 기능 구현을 병렬로 진행했다.
- 부스 예약 시스템: 이벤트 스코프 부스 카테고리, 반복 예약 실시간 처리, 예약 한도 설정
- SSO 연동: 고객사 시스템 로그인 유저를 RoundWait에 자동 진입
- 호스트 관리: 호스트 액세스 키 통합 인쇄 기능, 이미지/썸네일 관리 화면
- 부스 구역: 구역(Zone) 단위 부스 묶음 기능, 부스 숨김 처리
- PIN 인증 플로우: PIN 번호 기반 입장 제한
Github Actions CI/CD도 이 기간에 셋업됐다.
알림톡 (6/11)
6월 11일에 카카오 알림톡 관련 작업이 몰렸다.
- 호출 알림톡: 부스명에 구역명이 포함되도록 변경.
[구역명] 부스명형식. - 재호출 알림톡: 재호출 시에도 동일 템플릿으로 발송
- 노쇼 자동취소 알림톡: 일정 시간 내 미체크인 시 예약이 자동 취소되는데, 이때 참여자에게 알림톡이 발송되도록 추가
알림톡 템플릿은 카카오 비즈플러스에 등록된 내용과 정확히 맞아야 하기 때문에 변수명 하나하나 확인하면서 수정했다.
다국어(영어) 지원도 이벤트 상세 화면과 보고서에 추가됐다.