← 포트폴리오 목록

행사 현장 통역 배정 관제 시스템

통역사 QR 출퇴근 관리, 실시간 출퇴근 현황판, 바이어-통역사 호출 매칭을 하나의 관제 대시보드로 통합한 행사 현장 운영 시스템을 설계합니다.

QR 스캔 이벤트 파이프라인 구축QR 발급-스캔-지각판정을 단일 이벤트 체인으로 연결, Redis Set 기반 5분 중복 스캔 방지 로직 구현
호출 배정 상태 머신 설계대기/응답/확정/취소 4단계 상태 머신으로 통역사 호출 매칭을 모델링, 중복 배정을 원천 차단하는 구조 구현
실시간 관제 대시보드 아키텍처 구현Socket.io 단일 채널로 출퇴근·호출·상담 이벤트를 통합 브로드캐스트하는 관제 화면 구조 설계
서비스 타입Web
업종모니터링
기술 스택
ReactTypeScriptTailwind CSSNode.jsExpressSocket.ioPostgreSQLPrisma
주요 기능
  • 행사 현장 통합 관제 대시보드
  • 통역사 QR 출퇴근 관리
  • 바이어-통역사 호출 매칭
  • 상담일지 QR 자동 입력
Overview

프로젝트 개요

범위: 개발, 디자인, 기획

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

작업 범위

  • 행사 현장 통합 관제 대시보드: 운영자가 출퇴근 현황, 호출 상태, 우선 대응 항목을 한 화면에서 실시간으로 확인할 수 있는 통합 관제 대시보드
  • 통역사 QR 출퇴근 관리: 통역사별 명찰 QR 발급, 스캔을 통한 출퇴근 자동 기록, 중복 스캔 방지 및 지각 자동 판정
  • 바이어-통역사 호출 매칭: 바이어 도착 QR 스캔 시 통역사 호출 요청 발생, 실시간 응답 및 배정/변경/중복 배정 확인
  • 상담일지 QR 자동 입력: 셀러 명찰 QR 스캔 시 상담 매칭 정보 자동 입력, 상담일지 임시저장 및 입력값 유지

주요 업무

  • 행사 현장 통합 관제 대시보드 화면: 슬림 상태바 + 핵심 타임라인/보드 + 우선 대응 큐로 구성된 관제탑형 레이아웃
  • 통역사 QR 출퇴근 관리 화면: QR 발급 API + 스캔 이벤트 처리 + 지각 판정 규칙 엔진
  • 바이어-통역사 호출 매칭 화면: 호출 요청 큐 + 실시간 응답 처리 + 배정 상태 머신
  • 상담일지 QR 자동 입력 화면: QR 기반 상담 세션 매칭 + debounce 임시저장 + 복구
행사 현장 통역 배정 관제 시스템
요구사항 정의

프로젝트 핵심 과제

프로젝트 진행 시 해결한 핵심 기술 과제입니다.

동시접속 400명 환경에서 WebSocket 커넥션과 이벤트 브로드캐스트 부하를 분산하는 구조 설계

QR 스캔 중복 처리와 네트워크 지연이 겹칠 때 출퇴근 기록의 정합성을 보장하는 멱등성 처리

바이어-통역사 호출 매칭 시 동시 응답 경쟁 상태(race condition)를 방지하는 트랜잭션 격리 설계

행사 당일 현장 네트워크 불안정 상황에서도 상담일지 입력값 손실을 막는 오프라인 대응 로직

구현 내용

핵심 기능 상세

핵심 기능 1

행사 현장 통합 관제 대시보드

운영자가 출퇴근 현황, 호출 상태, 우선 대응 항목을 한 화면에서 실시간으로 확인할 수 있는 통합 관제 대시보드. 슬림 상태바 + 핵심 타임라인/보드 + 우선 대응 큐로 구성된 관제탑형 레이아웃.

  • Socket.io room 기반 이벤트 브로드캐스트로 출퇴근·호출·상담 상태를 하나의 채널에 통합
  • 슬림 상태바(status-strip)에 인라인 지표를 배치하여 큰 KPI 카드 행 없이 정보 밀도 유지
  • 우선 대응 큐(priority-rail)를 마감/우선순위 스코어 기준으로 정렬하는 프론트 로직 구현

WebSocket 단일 채널로 출퇴근/호출/상담 이벤트를 통합 브로드캐스트하는 관제 대시보드 아키텍처를 설계합니다.

행사 현장 통합 관제 대시보드
행사 현장 통합 관제 대시보드 실제 화면
핵심 기능 2

통역사 QR 출퇴근 관리

통역사별 명찰 QR 발급, 스캔을 통한 출퇴근 자동 기록, 중복 스캔 방지 및 지각 자동 판정. QR 발급 API + 스캔 이벤트 처리 + 지각 판정 규칙 엔진.

  • QR 코드 생성 라이브러리로 통역사별 고유 토큰을 인코딩한 명찰 QR 발급
  • 스캔 이벤트에 5분 윈도우 중복 방지 로직 적용, Redis Set으로 최근 스캔 기록 캐싱
  • 지정 출근 시각 대비 스캔 시각을 비교하는 지각 자동 판정 규칙 엔진 구현

QR 스캔부터 출퇴근 기록, 지각 판정까지 이어지는 이벤트 파이프라인을 구현하며, 엑셀 내보내기로 기록 관리 화면을 함께 설계합니다.

통역사 QR 출퇴근 관리
통역사 QR 출퇴근 관리 실제 화면
핵심 기능 3

바이어-통역사 호출 매칭

바이어 도착 QR 스캔 시 통역사 호출 요청 발생, 실시간 응답 및 배정/변경/중복 배정 확인. 호출 요청 큐 + 실시간 응답 처리 + 배정 상태 머신.

  • 바이어 도착 QR 스캔 이벤트를 호출 요청 큐에 적재하고 대기 가능한 통역사에게 실시간 알림 전송
  • 통역사 응답을 낙관적 UI로 즉시 반영하고 서버 확정 시 최종 배정 상태로 전환
  • 동일 통역사 중복 배정을 막는 배정 상태 머신(대기/응답/확정/취소) 구현

실시간 호출 시스템을 상태 머신으로 모델링하여 중복 배정 없이 매칭 변경까지 처리하는 구조를 구현합니다.

바이어-통역사 호출 매칭
바이어-통역사 호출 매칭 실제 화면
핵심 기능 4

상담일지 QR 자동 입력

셀러 명찰 QR 스캔 시 상담 매칭 정보 자동 입력, 상담일지 임시저장 및 입력값 유지. QR 기반 상담 세션 매칭 + debounce 임시저장 + 복구.

  • 셀러 QR 스캔 시 매칭된 상담 세션 정보(바이어·통역사·시간)를 폼에 자동 프리필
  • 입력값을 3초 debounce로 로컬스토리지 + 서버에 임시저장하여 페이지 이탈 후 복구
  • AI 상담일지 생성 요청을 별도 워커 큐로 분리하여 접속 오류 시에도 폼 입력은 유지

QR 스캔 기반 상담 세션 자동 매칭과 debounce 임시저장을 결합하여 입력 유실 없는 상담일지 작성 흐름을 구현합니다.

상담일지 QR 자동 입력
상담일지 QR 자동 입력 실제 화면
구현 과정

프로젝트 진행 단계

STEP 1

행사 운영 도메인 분석 및 실시간 이벤트 스키마 설계 · 2026.09

출퇴근·호출·상담 이벤트 흐름 분석, PostgreSQL 테이블 12개 및 Socket.io 이벤트 스키마 정의

STEP 2

QR 발급/스캔 및 호출 매칭 API 개발 · 2026.09

Express 기반 QR 발급·스캔·호출 매칭 API 20여개 엔드포인트 구현, 배정 상태 머신 설계

STEP 3

관제 대시보드 및 현장 UI 개발 · 2026.09

React 기반 상태바·타임라인·우선큐 화면 구현, Socket.io 클라이언트 실시간 반영

STEP 4

부하 테스트 및 통합 검증 · 2026.09

동시접속 400명 시나리오 부하 테스트, WebSocket 재연결·중복 스캔 방지 통합 검증

프로젝트 성과

주요 성과

QR 스캔 이벤트 파이프라인 구축QR 발급-스캔-지각판정을 단일 이벤트 체인으로 연결, Redis Set 기반 5분 중복 스캔 방지 로직 구현
호출 배정 상태 머신 설계대기/응답/확정/취소 4단계 상태 머신으로 통역사 호출 매칭을 모델링, 중복 배정을 원천 차단하는 구조 구현
실시간 관제 대시보드 아키텍처 구현Socket.io 단일 채널로 출퇴근·호출·상담 이벤트를 통합 브로드캐스트하는 관제 화면 구조 설계
부하 대응 이벤트 배치 처리 구현동시접속 400명 시나리오에서 이벤트 배치(batch) 브로드캐스트로 서버 부하를 분산하는 구조 구현
Highlights

기술적 주안점

  • WebSocket 단일 채널로 출퇴근/호출/상담 이벤트를 통합 브로드캐스트하는 관제 대시보드 아키텍처를 설계합니다
  • QR 스캔부터 출퇴근 기록, 지각 판정까지 이어지는 이벤트 파이프라인을 구현하며, 엑셀 내보내기로 기록 관리 화면을 함께 설계합니다
  • 실시간 호출 시스템을 상태 머신으로 모델링하여 중복 배정 없이 매칭 변경까지 처리하는 구조를 구현합니다

유사한 프로젝트를 기획하고 계신가요?

FIRSTPIP이 개발 범위와 로드맵을 함께 정리해드립니다

무료 상담 시작하기