본문으로 건너뛰기

동기화 큐

개념 설명

동기화 큐는 PDA에서 발생한 스캔과 작업 이벤트를 임시 저장하고 순차적으로 서버에 전송하는 구조입니다. 실패한 이벤트는 재시도하고, 성공한 이벤트는 완료 상태로 표시합니다.

왜 필요한가

현장 네트워크는 항상 안정적이지 않습니다. 큐가 없으면 요청 실패가 곧 데이터 손실이나 중복 입력으로 이어질 수 있습니다.

실무 흐름

스캔 이벤트를 pending으로 저장하고, 전송 중에는 syncing, 성공하면 synced, 실패하면 failed로 관리합니다. 재시도 횟수와 마지막 오류 메시지도 함께 저장합니다.

개발자가 주의할 점

큐 전송 순서가 업무적으로 중요한지 확인해야 합니다. 입고확정 이벤트가 개별 스캔 이벤트보다 먼저 전송되면 서버 검증이 실패할 수 있습니다.

예시

로케이션 스캔, 상품 스캔, 수량 확정 이벤트가 같은 작업에 묶여 있다면 작업 단위로 순서를 보장하는 큐가 필요합니다.

관련 문서 링크