참가자 등록 시스템 상태값 설계 기준과 데이터 정합성 가이드

운영 데이터 정합성의 출발: 등록·결제 핵심 상태값 분류 기준

결제가 끝났다고 믿었던 참가자가 현장에서 "미결제"로 뜨는 순간, 운영진의 하루가 꼬이기 시작합니다. 이 문제의 뿌리는 대부분 상태값(State) 설계에 있습니다. "결제 완료"라는 단일 상태로 모든 케이스를 처리하려다가, 입금 지연·부분 취소·환불 요청이 겹치는 순간 참가자 이력이 분기되면서 복구 불가능한 상태에 빠지죠.

결제 프로세스에서 실제 부딪히는 예외 상황

참가자 등록은 "신청 → 결제 → 완료"라는 직선이 아닙니다. 현장에서 마주하게 되는 분기는 이런 것들입니다.

• 결제 대기: 가상계좌 발급 후 입금이 확인되기 전 상태. 참가자는 폼을 제출했지만, 결제 게이트웨이에서 승인 응답이 오기 전까지 시스템은 "미완료"로 보고 있어야 합니다.
• 입금 완료: 가상계좌 입금 또는 간편결제 승인이 확인된 시점. 이 상태 전환을 트리거로 QR 바우처 발송이 실행되어야 합니다.
• 부분 취소: 정회원에서 준회원으로 등급이 변경되거나, 조기등록 할인 기준일이 지난 뒤 재결제가 필요한 경우. 결제 금액과 등록 등급 사이의 정합성이 깨지기 쉬운 지점입니다.
• 환불 요청: 환불 정책에 따라 처리되지만, "요청 접수"와 "환불 완료"를 하나의 상태로 묶어두면, 환불 대기 중인 참가자가 QR 스캔으로 입장하는 사고가 생깁니다.

현장 방문 및 출석 체크: 세션 입퇴장·명찰(QR) 발급 트리거 설계

결제가 끝났는데 참가자 폰에 QR이 안 와서 접수대가 멈추는 순간, 그게 가장 흔한 현장 사고다. e-Regi는 등록 완료 즉시 QR 코드가 포함된 모바일 바우처를 카카오 알림톡으로 자동 발송한다. 여기서 핵심은 결제 게이트웨이(NICEPAY·토스페이먼츠) 응답 수신 → 상태값 "등록 완료" 전환 → 알림톡 발송 호출이 하나의 트리거 체인으로 묶여 있다는 점이다. 수동 개입이 끼어들 자리가 없어야 한다.

배포 방식별 트리거 조건

e-Regi 배지 시스템은 드래그앤드롭으로 이름·소속·QR·로고를 자유롭게 배치하고, 세 가지 방식으로 명찰을 배포한다. 각 방식마다 발급이 시작되는 시점이 다르다.

"사전에 보낼 것인가, 현장에서 찍을 것인가"를 행사 전에 확정해야 프린터 대기열과 용지 수량을 정확히 설계할 수 있다. 사전 발송으로 폰에 QR이 도달해 있으면 현장에서는 스캔 한 번으로 끝나지만, 현장 출력을 기본으로 잡으면 프린터 대수와 인쇄 속도까지 동선에 넣어야 한다.

흔하는 실수 vs 권장 기준: 상태 전환에 따른 데이터 무결성과 동시성 제어

현장 접수대에서 카드 결제가 승인되자마자 네임택을 발급하고 QR로 입장을 처리해야 하는 순간을 떠올려 보자. 이때 관리자 페이지 여러 창에서 한 참가자의 데이터가 동시에 업데이트되면, 결제는 완료됐는데 입장이 안 된 것으로 표시되는 등 상태가 꼬이는 사태가 벌어진다. 이런 문제는 참가자의 진행 단계를 단순한 참·거짓(True/False) 플래그로 처리할 때 발생한다. 상태가 얽히기 전에 '결제 대기 → 결제 완료 → 입장 완료'처럼 이전 상태에서 다음 상태로만 넘어갈 수 있는 명확한 상태 전환 규칙을 세워두어야 한다.

두 방식이 현장에서 어떤 차이를 만드는지 구체적인 항목으로 비교해 보았다.

상태값별 자동화 구축 및 사무국 체크리스트 요약

행사 당일, 접수 데스크에서 결제 여부를 일일이 확인하며 명찰을 찾느라 긴 대기열이 생기는 장면은 누구나 겪어봤을 것입니다. 이 문제를 해결하려면 참가자의 현재 단계를 시스템이 스스로 인식하고 다음 액션을 수행하는 '상태값(State) 자동화'가 핵심입니다.

상태값 변화에 따른 자동 알림 설계

결제가 완료되면 시스템 내 참가자의 상태값이 즉시 변경되어야 합니다. 이 신호를 캐치해 QR 코드가 포함된 모바일 바우처를 카카오 알림톡으로 자동 발송하도록 로직을 구성하면, 사무국의 개입 없이도 참가자는 입장 준비를 마칠 수 있습니다.

라이브 대시보드로 현황 통제하기

안내가 자동화되었다면, 다음으로는 현장의 흐름을 읽는 것이 중요합니다.