BLE 체크인 미들웨어

행사장에서 BLE 비콘 기반으로 출입·체크인을 처리하는 미들웨어다. 현장의 BLE 게이트웨이 장비가 TCP로 원시 데이터를 보내면 이를 필터링·중복 제거한 뒤 체크인 이벤트로 정제해 백엔드 REST API로 전달하는 중계 서버 역할을 한다.

초기엔 CSV 필드 순서를 가정하고 파싱을 짰지만, 실제 장비 데이터를 로깅해보니 필드 순서가 문서와 달라 인덱스를 재매핑했다. 이후 파싱 실패 시 서버 전체가 죽지 않도록 recover 안전망을 추가하고, TCP 단편화로 필드가 일부만 들어오는 경우를 별도로 처리해 경고만 남기고 다음 패킷을 계속 처리하도록 했다.

• Go 1.21 — 경량 TCP 서버, 표준 라이브러리 위주로 의존성을 최소화
• Redis(go-redis) — 비콘 중복 체크인 디바운싱과 게이트웨이별 라우팅 테이블
• 고루틴 + sync.WaitGroup — 연결별 동시성 처리와 graceful shutdown

TCP 서버, RSSI 필터, 디바운싱, 다중 행사 라우팅까지 MVP 코드는 완성했고, 실제 현장 장비 연동 테스트까지 완료했다.