📦 오피킹 조회 시스템
🌐 온라인
데이터 미로드
1. 인벤토리 데이터
페이지를 열면 저장된 재고로 바로 조회되고, 뒤이어 최신 재고를 자동으로 받아옵니다.
2. 바코드 조회
숫자를 넣으면 바코드 조회, 글자를 넣으면 상품명·SKU 검색으로 자동 전환됩니다.
3. 조회 결과
바코드를 스캔하거나 입력하면 여기에 결과가 표시됩니다.
🔁 오피킹 다발
같은 품목·셀이 반복해서 조회된다 = 그 자리에서 오피킹이 반복된다는 신호입니다.
아직 오늘 조회 기록이 없습니다.
⚙️ 고급: 팀 백엔드 (Google Apps Script) 연결
팀 통계를 공유하려면 Google Apps Script 웹앱 URL을 입력하세요.
셋업 가이드는
google_apps_script.gs 파일 상단 주석 참고.
현재 적용 중인 URL:
연결 테스트가 404 로 실패할 때
→ Apps Script 편집기에서 배포 → 배포 관리 → 편집(연필) → 버전: 새 버전 → 배포.
→ 새로 나온
→ 액세스 권한은 "모든 사용자", 실행은 "나" 여야 합니다.
→ Apps Script 편집기에서 배포 → 배포 관리 → 편집(연필) → 버전: 새 버전 → 배포.
→ 새로 나온
.../exec URL 을 위 칸에 붙여넣고 [저장 & 새로고침].→ 액세스 권한은 "모든 사용자", 실행은 "나" 여야 합니다.
⚙️ 고급: 컬럼 매핑 설정
파일의 헤더 컬럼명을 자동 감지합니다. 다른 WMS 파일을 사용한다면 아래에서 컬럼명을 직접 지정할 수 있습니다.
📖 사용법
1) 페이지를 열면 저장된 캐시로 즉시 조회 가능하고, 뒤이어 GAS 동기화가 자동 실행됩니다.
2) 카메라 스캔 / 사진 업로드 / 직접 입력 중 편한 방법으로 바코드를 입력합니다.
3) 결과 카드에 상품명·SKU·로케이션·현재고·비가용·가용수량이 표시됩니다.
4) 같은 바코드가 여러 셀에 있는 경우 셀별 내역이 함께 표시됩니다.
사진 업로드 시 자동 인식 흐름
• 1차: ZXing이 검정 줄무늬 바코드를 시도 (즉시 인식)
• 2차: 실패 시 Tesseract OCR이 숫자를 추출 (손글씨·인쇄 숫자)
• 추출된 값은 입력칸에 자동으로 채워지며, 잘못 인식된 글자는 직접 수정 후 [조회] 누르면 됩니다.
• OCR 엔진은 최초 1회만 다운로드 (약 10MB)되고 이후 캐시됩니다.
수량 계산
• 가용수량 = 현재고 − 할당수량 − 보류수량
• 비가용수량 = 할당+보류 합산 (이동 중인 재고)
2026-09 업데이트
• 오프라인 조회: 한 번 동기화하면 기기에 캐시가 남아 전파가 없어도 조회됩니다.
• 재고 기준시각 바: 화면 최상단. 8시간 경과 🟡 / 20시간 경과 🛑 로 경고합니다.
• 상품명·SKU 검색: 입력칸에 글자를 넣으면 부분검색으로 자동 전환 (가용 적은 순).
• 연속 스캔 + 플래시: 여러 건 연속 확인, 어두운 랙 앞에서 🔦 사용.
• 마스터 미등록 바코드 기록: 인벤토리 시트에 없는 바코드도 통계에 남아 누락 품목을 찾을 수 있습니다.
• 중복 조회 알림: 오늘 2번 이상 조회한 품목은 결과 카드에 🔁 로 표시됩니다.
• 소비기한: 조회 시 배너로 D-day 표시, 셀이 여러 개면 기한 빠른 셀이 맨 위로 정렬되고 「먼저」 배지가 붙습니다 (선입선출). 기한 경과 시 진동 + 출고 금지 안내.
• 인벤토리 자동 갱신: PC의
확장
• DB·API·WMS 연동은
• 컬럼명이 다른 WMS 양식은 ⚙️ 고급 매핑에서 직접 지정 가능.
2) 카메라 스캔 / 사진 업로드 / 직접 입력 중 편한 방법으로 바코드를 입력합니다.
3) 결과 카드에 상품명·SKU·로케이션·현재고·비가용·가용수량이 표시됩니다.
4) 같은 바코드가 여러 셀에 있는 경우 셀별 내역이 함께 표시됩니다.
사진 업로드 시 자동 인식 흐름
• 1차: ZXing이 검정 줄무늬 바코드를 시도 (즉시 인식)
• 2차: 실패 시 Tesseract OCR이 숫자를 추출 (손글씨·인쇄 숫자)
• 추출된 값은 입력칸에 자동으로 채워지며, 잘못 인식된 글자는 직접 수정 후 [조회] 누르면 됩니다.
• OCR 엔진은 최초 1회만 다운로드 (약 10MB)되고 이후 캐시됩니다.
수량 계산
• 가용수량 = 현재고 − 할당수량 − 보류수량
• 비가용수량 = 할당+보류 합산 (이동 중인 재고)
2026-09 업데이트
• 오프라인 조회: 한 번 동기화하면 기기에 캐시가 남아 전파가 없어도 조회됩니다.
• 재고 기준시각 바: 화면 최상단. 8시간 경과 🟡 / 20시간 경과 🛑 로 경고합니다.
• 상품명·SKU 검색: 입력칸에 글자를 넣으면 부분검색으로 자동 전환 (가용 적은 순).
• 연속 스캔 + 플래시: 여러 건 연속 확인, 어두운 랙 앞에서 🔦 사용.
• 마스터 미등록 바코드 기록: 인벤토리 시트에 없는 바코드도 통계에 남아 누락 품목을 찾을 수 있습니다.
• 중복 조회 알림: 오늘 2번 이상 조회한 품목은 결과 카드에 🔁 로 표시됩니다.
• 소비기한: 조회 시 배너로 D-day 표시, 셀이 여러 개면 기한 빠른 셀이 맨 위로 정렬되고 「먼저」 배지가 붙습니다 (선입선출). 기한 경과 시 진동 + 출고 금지 안내.
• 인벤토리 자동 갱신: PC의
build_oppicking_inv.py 가 OneDrive RAW 를 읽어
1시간마다 자동 업로드합니다. 관리자가 시트에 붙여넣을 필요가 없습니다.확장
• DB·API·WMS 연동은
DataSource 클래스를 상속해 추가 (소스 주석 참조).• 컬럼명이 다른 WMS 양식은 ⚙️ 고급 매핑에서 직접 지정 가능.