통역사 QR 출퇴근 관리, 실시간 출퇴근 현황판, 바이어-통역사 호출 매칭을 하나의 관제 대시보드로 통합한 행사 현장 운영 시스템을 설계합니다.
통역사 QR 출퇴근 관리, 실시간 출퇴근 현황판, 바이어-통역사 호출 매칭을 하나의 관제 대시보드로 통합한 행사 현장 운영 시스템을 설계합니다. Socket.io 기반 실시간 이벤트 브로드캐스트와 QR 스캔 워크플로우로 동시접속 400명 규모의 현장에서도 안정적으로 동작하는 구조를 구현합니다. 본 프로젝트의 요구사항을 기반으로 직접 구현한 맞춤 데모이며.
작업 범위
주요 업무



운영자가 출퇴근 현황, 호출 상태, 우선 대응 항목을 한 화면에서 실시간으로 확인할 수 있는 통합 관제 대시보드. 슬림 상태바 + 핵심 타임라인/보드 + 우선 대응 큐로 구성된 관제탑형 레이아웃.
WebSocket 단일 채널로 출퇴근/호출/상담 이벤트를 통합 브로드캐스트하는 관제 대시보드 아키텍처를 설계합니다.


통역사별 명찰 QR 발급, 스캔을 통한 출퇴근 자동 기록, 중복 스캔 방지 및 지각 자동 판정. QR 발급 API + 스캔 이벤트 처리 + 지각 판정 규칙 엔진.
QR 스캔부터 출퇴근 기록, 지각 판정까지 이어지는 이벤트 파이프라인을 구현하며, 엑셀 내보내기로 기록 관리 화면을 함께 설계합니다.


바이어 도착 QR 스캔 시 통역사 호출 요청 발생, 실시간 응답 및 배정/변경/중복 배정 확인. 호출 요청 큐 + 실시간 응답 처리 + 배정 상태 머신.
실시간 호출 시스템을 상태 머신으로 모델링하여 중복 배정 없이 매칭 변경까지 처리하는 구조를 구현합니다.


셀러 명찰 QR 스캔 시 상담 매칭 정보 자동 입력, 상담일지 임시저장 및 입력값 유지. QR 기반 상담 세션 매칭 + debounce 임시저장 + 복구.
QR 스캔 기반 상담 세션 자동 매칭과 debounce 임시저장을 결합하여 입력 유실 없는 상담일지 작성 흐름을 구현합니다.


출퇴근·호출·상담 이벤트 흐름 분석, PostgreSQL 테이블 12개 및 Socket.io 이벤트 스키마 정의
Express 기반 QR 발급·스캔·호출 매칭 API 20여개 엔드포인트 구현, 배정 상태 머신 설계
React 기반 상태바·타임라인·우선큐 화면 구현, Socket.io 클라이언트 실시간 반영
동시접속 400명 시나리오 부하 테스트, WebSocket 재연결·중복 스캔 방지 통합 검증