title: “Barcode System” description: “Generate, scan, dan print barcode 1D/2D dengan dukungan hardware scanner, mobile camera, dan batch processing.”

Barcode System

Sistem barcode Quinn of Spicy mendukung seluruh siklus operasional barcode — dari generate otomatis berdasarkan SKU, print label dalam jumlah besar, hingga scan untuk stock operation dan transaksi POS. Sistem mendukung barcode 1D (Code 128, EAN-13, UPC-A) dan 2D (QR Code, DataMatrix), dengan kompatibilitas hardware scanner USB/Bluetooth/wireless maupun kamera mobile.

Arsitektur Barcode System

Format Barcode

SKU-Based Barcode (Default)

Setiap produk otomatis mendapat barcode berdasarkan SKU:

Komponen	Format	Contoh
Prefix	QOS	QOS
Kategori	3 huruf kode	SMB (Sambal), KRP (Keripik)
Sequence	3 digit angka	001, 002, 003
Full Format	QOS--	QOS-SMB-001

Custom Barcode

Jika tidak ingin menggunakan format default:

Buka detail produk
Klik Set Custom Barcode
Input kode custom (maks 20 karakter)
Sistem cek duplikat
Generate barcode image

Barcode per Variant

Setiap variant produk bisa memiliki barcode riêng:

Produk	Variant	SKU	Barcode
Ayam Suwir Petir	150g	QOS-ASP-150	QOS-ASP-150
Ayam Suwir Petir	300g	QOS-ASP-300	QOS-ASP-300
Ayam Suwir Petir	500g	QOS-ASP-500	QOS-ASP-500
Sambal Matah	100ml	QOS-SMB-100	QOS-SMB-100
Sambal Matah	250ml	QOS-SMB-250	QOS-SMB-250

Jenis Barcode yang Didukung

1D Barcode

Tipe	Karakter	Panjang	Penggunaan
Code 128	ASCII lengkap	Variabel	Default untuk produk (SKU-based)
Code 39	A-Z, 0-9, beberapa simbol	Variabel	Alternatif jika perlu alfanumerik
EAN-13	13 digit angka	13	Standar retail internasional
UPC-A	12 digit angka	12	Standar retail Amerika Utara

2D Barcode

Tipe	Kapasitas	Penggunaan
QR Code	4.296 karakter alfanumerik	Link ke detail produk, URL, info lengkap
DataMatrix	2.335 karakter	Label kecil, encoding padat
PDF417	1.108 byte	Dokumen, kartu identitas

Print Barcode Label

Konfigurasi Label

Parameter	Opsi	Default
Ukuran Label	30x20mm, 40x30mm, 50x30mm, 70x50mm	40x30mm
Konten	Barcode, Nama Produk, Harga, SKU	Barcode + Nama
Quantity	1-1000 label	1
Orientasi	Portrait, Landscape	Portrait
Border	Ya/Tidak	Tidak

Single Print

Buka halaman produk (/companyproducts)
Pilih produk
Klik Print Barcode
Pilih quantity label, ukuran, konten
Klik Print

Batch Print

Buka daftar produk (/companyproducts)
Pilih beberapa produk (checkbox)
Klik Batch Print Barcode
Konfigurasi label (ukuran, konten, qty per produk)
Preview label
Klik Print All

Contoh Label

┌──────────────────────────────┐
│  ██████ █  █ ██ ████ █  █   │  ← Barcode
│  QOS-SMB-001                 │  ← SKU
│  Sambal Matah 100ml          │  ← Nama Produk
│  Rp 15.000                   │  ← Harga (opsional)
└──────────────────────────────┘

Scan Barcode

Hardware Scanner

Tipe	Koneksi	Jarak	Kecepatan	Cocok Untuk
USB Scanner	Kabel USB	< 30cm	Instant	Kasir desktop
Bluetooth Scanner	Bluetooth	< 10m	< 1 detik	Gudang, mobile
Wireless Scanner	RF 2.4GHz	< 30m	< 1 detik	Gudang besar
Mobile Scanner	WiFi/Cellular	Unlimited	1-2 detik	Lapangan

Mobile Camera

Scan barcode via kamera HP:

Buka aplikasi Quinn of Spicy di mobile
Pilih menu “Scan Barcode”
Arahkan kamera ke barcode
Auto-detect dan identifikasi produk
Pilih aksi: lihat detail, stock in/out, atau tambah ke cart

Penggunaan di Berbagai Skenario

Skenario	Cara Scan	Aksi Setelah Scan
POS Transaction	Scan di kasir	Produk masuk cart otomatis
Stock In	Scan di gudang	Form stock in terbuka, produk terisi
Stock Out	Scan di gudang	Form stock out terbuka
Stock Opname	Scan saat hitung fisik	Input qty fisik untuk produk tersebut
Stock Transfer	Scan produk	Form transfer terbuka
Product Lookup	Scan di mana saja	Detail produk ditampilkan

Validasi Barcode

Duplicate Check

Format Validation

Check	Deskripsi	Error jika Gagal
Length	Panjang barcode sesuai tipe	”Barcode terlalu pendek/panjang”
Characters	Karakter valid untuk tipe yang dipilih	”Karakter tidak valid”
Checksum	Checksum digit terakhir (EAN/UPC)	“Checksum tidak valid”
Uniqueness	Tidak ada barcode sama di sistem	”Barcode sudah digunakan”

Reporting

Barcode Usage Report

Metrik	Deskripsi
Total Generated	Jumlah barcode yang sudah di-generate
Total Scanned	Jumlah scan per hari/minggu/bulan
Scan Success Rate	% scan berhasil vs gagal
Top Scanned Products	10 produk yang paling sering discan
Scan by Location	Distribusi scan per lokasi

Barcode Error Report

Metrik	Deskripsi
Failed Scans	Jumlah scan yang gagal
Invalid Barcodes	Barcode yang tidak valid terdeteksi
Duplicate Barcodes	Barcode duplikat yang ditemukan
Resolution	Tindakan yang sudah diambil

Best Practices

Label Placement

Aturan	Alasan
Tempel di tempat yang mudah discan	Mempercepat operasional
Hindari lipatan atau kerutan	Barcode rusak = gagal scan
Gunakan label tahan air/minyak	Lingkungan F&B rentan kotoran
Replace label yang rusak	Cegah gagal scan
Konsisten di posisi yang sama	Staff terbiasa, lebih cepat

Scanner Maintenance

Tugas	Frekuensi	Detail
Clean lens	Mingguan	Lap lensa dengan kain lembut
Check battery	Harian (wireless)	Isi ulang sebelum shift
Test scanner	Tiap awal shift	Test scan 1 produk
Backup scanner	Selalu punya cadangan	Min. 1 backup per lokasi

Barcode Quality

Aspek	Standar
Resolusi print	Min. 300 DPI
Kontras	Hitam di putih (paling reliable)
Ukuran min.	Lebar 20mm, tinggi 15mm
Quiet zone	5mm margin di kiri-kanan barcode
Test scan	Test setiap batch print

Entity Schema & Diagram

ER Diagram — Barcode & Serial Number

Tabel Schema — CompanyPOSProduct (Field Barcode & Fisik)

Field	Tipe	Wajib	Default	Deskripsi
`company_id`	`string`	Ya	—	ID perusahaan pemilik produk
`name`	`string`	Ya	—	Nama produk
`sku`	`string`	Tidak	—	SKU unik produk
`barcode`	`string`	Tidak	—	Barcode / QR Code produk (format EAN-13)
`product_type`	`enum`	Tidak	`finished_good`	Tipe produk: `finished_good`, `raw_material`, `semi_finished`, `packaging_material`, `bundle`
`packaging_type`	`enum`	Tidak	—	Jenis kemasan: `jar_glass`, `pouch_zipper`, `pouch_sealed`, `toples_plastic`, `bottle_plastic`, `bulk`, `other`
`net_weight_grams`	`number`	Tidak	—	Berat bersih isi produk dalam gram
`gross_weight_grams`	`number`	Tidak	—	Berat kotor termasuk kemasan dalam gram
`storage_condition`	`enum`	Tidak	`room_temperature`	Kondisi penyimpanan: `room_temperature`, `chilled`, `frozen`
`price`	`number`	Ya	—	Harga jual produk
`cost`	`number`	Tidak	—	Harga modal/beli produk
`stock`	`number`	Tidak	`0`	Stok saat ini
`min_stock`	`number`	Tidak	`5`	Minimum stok untuk notifikasi alert
`unit`	`string`	Tidak	`pcs`	Satuan produk
`is_active`	`boolean`	Tidak	`true`	Status produk aktif/nonaktif
`is_bundle`	`boolean`	Tidak	`false`	Menandakan paket bundle virtual
`is_locked`	`boolean`	Tidak	`false`	Data terkunci karena sudah ada transaksi
`sold_count`	`number`	Tidak	`0`	Total jumlah produk terjual

Tabel Schema — SerialNumber (Semua Field)

Field	Tipe	Wajib	Default	Deskripsi
`company_id`	`string`	Ya	—	ID perusahaan
`serial_number`	`string`	Ya	—	Serial number unik (PK bisnis)
`product_id`	`string`	Ya	—	ID produk yang terkait (FK ke CompanyPOSProduct)
`product_name`	`string`	Tidak	—	Nama produk (denormalized untuk performa)
`lot_id`	`string`	Tidak	—	ID lot/batch produksi
`manufacture_date`	`date`	Tidak	—	Tanggal produksi
`warranty_expiry`	`date`	Tidak	—	Tanggal kadaluarsa garansi
`status`	`enum`	Tidak	`in_stock`	Status siklus hidup: `in_stock`, `sold`, `warranty_claim`, `scrapped`
`location_id`	`string`	Tidak	—	ID lokasi gudang penyimpanan
`location_name`	`string`	Tidak	—	Nama lokasi (denormalized)
`sold_to_customer_id`	`string`	Tidak	—	ID customer yang membeli
`sold_date`	`datetime`	Tidak	—	Tanggal dan waktu penjualan
`invoice_id`	`string`	Tidak	—	Referensi invoice penjualan
`warranty_info`	`object`	Tidak	—	Informasi garansi (nested)
`warranty_info.warranty_months`	`number`	—	—	Durasi garansi dalam bulan
`warranty_info.warranty_start`	`date`	—	—	Tanggal mulai garansi
`warranty_info.warranty_end`	`date`	—	—	Tanggal akhir garansi
`warranty_info.covered_by`	`string`	—	—	Pihak yang menanggung garansi
`service_history`	`array`	Tidak	—	Riwayat servis (nested)
`service_history[].date`	`datetime`	—	—	Tanggal kejadian servis
`service_history[].type`	`enum`	—	—	Jenis: `repair`, `maintenance`, `inspection`
`service_history[].performed_by`	`string`	—	—	Petugas yang melakukan
`service_history[].notes`	`string`	—	—	Catatan servis
`service_history[].cost`	`number`	—	—	Biaya servis
`notes`	`string`	Tidak	—	Catatan umum

State Machine — Siklus Hidup Serial Number

Sequence Diagram — Barcode Scan → Product Lookup

Sequence Diagram — Serial Number Generation

Enum Tables

`barcode_format` — Format Barcode yang Didukung

Nilai Enum	Deskripsi	Panjang	Contoh
`code_128`	Code 128 — barcode 1D default untuk produk SKU-based	Variabel	`QOS-SMB-001`
`code_39`	Code 39 — alternatif alfanumerik	Variabel	`QOSASP001`
`ean_13`	EAN-13 — standar retail internasional	13 digit	`8991234567890`
`upc_a`	UPC-A — standar retail Amerika Utara	12 digit	`012345678905`
`qr_code`	QR Code — barcode 2D, kapasitas tinggi	s/d 4.296 karakter	URL / data JSON
`datamatrix`	DataMatrix — barcode 2D padat, untuk label kecil	s/d 2.335 karakter	Encoded data
`pdf417`	PDF417 — untuk dokumen / kartu	s/d 1.108 byte	Data terstruktur

`identity_status` — Status Serial Number

Nilai Enum	Deskripsi	Trigger Transisi
`in_stock`	Serial number aktif di gudang, belum terjual	Default saat generate / produksi
`sold`	Sudah terjual ke customer	Transaksi POS / penjualan (field `sold_date` & `invoice_id` terisi)
`warranty_claim`	Sedang dalam proses klaim garansi	Customer mengajukan klaim garansi setelah pembelian
`scrapped`	Dimusnahkan / tidak bisa digunakan lagi	Rusak, expired, atau klaim garansi disetujui

`product_type` — Tipe Produk

Nilai Enum	Deskripsi
`finished_good`	Produk jadi, siap dijual (default)
`raw_material`	Bahan baku untuk produksi
`semi_finished`	Produk setengah jadi
`packaging_material`	Material kemasan
`bundle`	Paket bundle virtual (komposisi dari beberapa SKU)

`storage_condition` — Kondisi Penyimpanan

Nilai Enum	Deskripsi	Contoh Produk
`room_temperature`	Suhu ruang (default)	Sambal kemasan, keripik
`chilled`	Dingin (2-8°C)	Produk segar
`frozen`	Beku (< -18°C)	Produk frozen

RBAC — Hak Akses Modul Barcode

Role	Generate Barcode	Print Label	Scan Barcode	Kelola Serial Number	Stock Opname via Scan	Hapus Serial Number
Super Admin	✅	✅	✅	✅	✅	✅
Admin	✅	✅	✅	✅	✅	❌
Manager	✅	✅	✅	✅ (read-only)	✅	❌
Staff Gudang	❌	✅	✅	✅ (update status)	✅	❌
Kasir	❌	❌	✅	❌	❌	❌
Viewer	❌	❌	❌	❌ (read-only)	❌	❌

Catatan RBAC:

Generate Barcode hanya bisa dilakukan oleh role yang memiliki hak tulis pada CompanyPOSProduct.

Kelola Serial Number — Admin penuh (create/update/delete), Staff Gudang hanya update status (in_stock → sold / scrapped).

Kasir hanya bisa scan barcode untuk transaksi POS, tidak bisa mengakses modul serial number.

Data yang sudah terkunci (is_locked = true) tidak bisa diubah oleh siapapun kecuali Super Admin dengan reason code (DQ-01).

​title: “Barcode System” description: “Generate, scan, dan print barcode 1D/2D dengan dukungan hardware scanner, mobile camera, dan batch processing.”

​Barcode System

​Arsitektur Barcode System

​Format Barcode

​SKU-Based Barcode (Default)

​Custom Barcode

​Barcode per Variant

​Jenis Barcode yang Didukung

​1D Barcode

​2D Barcode

​Print Barcode Label

​Konfigurasi Label

​Single Print

​Batch Print

​Contoh Label

​Scan Barcode

​Hardware Scanner

​Mobile Camera

​Penggunaan di Berbagai Skenario

​Validasi Barcode

​Duplicate Check

​Format Validation

​Reporting

​Barcode Usage Report

​Barcode Error Report

​Best Practices

​Label Placement

​Scanner Maintenance

​Barcode Quality

​Entity Schema & Diagram

​ER Diagram — Barcode & Serial Number

​Tabel Schema — CompanyPOSProduct (Field Barcode & Fisik)

​Tabel Schema — SerialNumber (Semua Field)

​State Machine — Siklus Hidup Serial Number

​Sequence Diagram — Barcode Scan → Product Lookup

​Sequence Diagram — Serial Number Generation

​Enum Tables

​barcode_format — Format Barcode yang Didukung

​identity_status — Status Serial Number

​product_type — Tipe Produk

​storage_condition — Kondisi Penyimpanan

​RBAC — Hak Akses Modul Barcode