저울 라벨 앱 (Scale)

개요

ktpv5-scale 은 안드로이드 태블릿용 저울 라벨 앱입니다. 상품을 저울에 올려 무게를 재고 가격 라벨을 출력하면, 그 라벨을 매장 POS의 판매 화면에서 그대로 스캔해 판매합니다. 상품·가격 데이터는 POS와 같은 서버를 사용합니다.

POS 본체 앱과는 별개의 앱입니다. (가로 화면 전용 안드로이드 앱)

처음 설정 (장치)

설정(Settings) → Devices 에서 연결 장치를 등록합니다. 등록 전에는 앱이 진행되지 않습니다.

• USB 저울 은 처음 연결 시 USB 권한 허용이 필요합니다.
• 설정 화면의 Connection Test / Network Test 로 연결을 확인할 수 있습니다.

사용 흐름

1. 홈(Home) 탭에서 상품을 검색(키워드/브랜드)하거나 목록에서 찾습니다.
2. 상품을 누르면 저울 화면이 열립니다.
3. 저울에 올리면 무게가 자동으로 표시됩니다.
4. 단가·프로모가를 확인하고, 필요하면 가격 변경이나 할인(%/금액) 을 적용합니다.
5. 저울 라벨 또는 원재료 라벨 출력 버튼을 누릅니다.

무게 상품은 총액 = 무게(kg) × 단가 로 계산됩니다.

라벨과 POS 연동

출력되는 라벨에는 두 가지 바코드 방식이 있습니다.

• 1D 바코드 — PLU(앞 7자리) + 내장 가격(5자리). POS가 이 가격을 그대로 인식합니다.
• 2D QR (PP 바코드) — 가격·무게·할인 정보를 담은 코드(00:로 시작). POS가 그 정보를 그대로 사용해 한 줄을 만듭니다.

두 방식 모두 POS 판매 화면에서 스캔하면 자동으로 담깁니다. (POS가 인식하는 규칙은 상품 검색·가격 참고)

동기화 (Sync)

홈 화면 또는 Settings → Sync 의 Sync 버튼(↻ 아이콘) 을 누르면 본사에서 최신 상품·가격을 받아옵니다. POS의 동기화와 같은 개념입니다. (상품은 평소 검색할 때마다 서버에서 실시간으로 조회됩니다.)

자주 겪는 문제

앱 업데이트

OTA 업데이트(EAS Update)를 지원합니다. JS/화면 변경은 OTA로 배포되고, 네이티브· 설정 변경은 새 빌드(EAS Build)가 필요합니다.