중복 스캔
개념 설명
중복 스캔은 같은 바코드나 같은 이벤트가 의도치 않게 두 번 이상 처리되는 상황입니다. 빠른 연속 입력, 네트워크 재시도, 작업자 실수에서 발생합니다.
왜 필요한가
중복 스캔을 막지 않으면 재고 수량이 실제보다 많이 입고되 거나 출고될 수 있습니다. 특히 오프라인 큐와 재시도 로직이 있을 때는 서버 멱등성이 필수입니다.
실무 흐름
클라이언트는 짧은 시간 내 동일 스캔을 감지하고, 서버는 이벤트 id 또는 작업별 순번으로 중복 반영을 막습니다. 업무상 반복 스캔이 정상인 경우에는 수량 증가 규칙을 명확히 둡니다.
개발자가 주의할 점
모든 동일 바코드가 중복 오류는 아닙니다. 낱개 10개를 스캔하는 작업에서는 같은 바코드 10번이 정상일 수 있습니다.
예시
검수 단계에서 박스 바코드는 한 번만 허용하고, 상품 바코드는 지시 수량만큼 반복 허용하는 식으로 규칙을 나눕니다.