# Panduan Pengguna Lakasir

## Tentang Aplikasi

**Lakasir** adalah sistem Point of Sale (POS) yang komprehensif untuk bisnis retail dan restoran. Aplikasi ini menyediakan berbagai fitur untuk mengelola penjualan, inventory, pembelian, dan keuangan bisnis Anda.

---

## Daftar Isi

1. [Fitur Utama](#fitur-utama)
2. [Modul Penjualan & Kasir](#modul-penjualan--kasir)
3. [Manajemen Produk & Inventory](#manajemen-produk--inventory)
4. [Pembelian & Supplier](#pembelian--supplier)
5. [Piutang](#piutang)
6. [Keuangan](#keuangan)
7. [Voucher & Promosi](#voucher--promosi)
8. [Manajemen Pengguna](#manajemen-pengguna)
9. [Laporan & Analitik](#laporan--analitik)
10. [Pengaturan Aplikasi](#pengaturan-aplikasi)

---

## Fitur Utama

### 🛒 Point of Sale (POS)
- **Dua Tampilan POS**: POS klasik dan POS V2 dengan fitur pencarian canggih
- **Pencarian Produk**: Cari berdasarkan nama, SKU, atau barcode
- **Keranjang Belanja**: Tambah/kurangi item dengan mudah
- **Multiple Payment Method**: Terima pembayaran tunai, debit, kredit, atau wallet
- **Diskon Fleksibel**: Berikan diskon per item atau total transaksi
- **Voucher Otomatis**: Sistem otomatis menyarankan voucher yang bisa digunakan
- **Perhitungan Pajak**: Pajak otomatis ditambahkan ke transaksi
- **Manajemen Meja**: Untuk bisnis restoran (dine-in)
- **Cetak Struk**: Cetak struk otomatis setelah transaksi

### 📦 Manajemen Inventory
- **Stok Real-time**: Pantau stok produk secara langsung
- **Multiple Unit Pricing**: Harga berbeda untuk satuan berbeda (eceran, grosir, dll)
- **Stock Opname**: Hitung fisik inventory dan rekonsiliasi
- **Peringatan Stok Minimum**: Notifikasi otomatis saat stok menipis
- **Tracking Kadaluarsa**: Monitor produk yang akan kadaluarsa

### 💰 Keuangan
- **Laci Kasir**: Kelola pembukaan dan penutupan kasir
- **Laporan Lengkap**: Laporan penjualan, produk, kasir, dan pembelian
- **Dashboard Analytics**: Metrik real-time pendapatan dan penjualan
- **Tracking Piutang**: Pantau dan kelola piutang pelanggan

---

## Modul Penjualan & Kasir

### Halaman Kasir (`/member/cashier`)

**Fungsi Utama:**
1. **Memproses Transaksi Penjualan**
- Scan atau cari produk
- Tambahkan ke keranjang
- Atur jumlah dan diskon
- Pilih metode pembayaran
- Selesaikan transaksi

2. **Manajemen Laci Kasir**
- Buka laci kasir dengan nominal awal
- Catat siapa yang membuka kasir
- Tutup laci kasir dengan perhitungan akhir

3. **Fitur Tambahan**
- Link penjualan ke member (pelanggan terdaftar)
- Pilih meja untuk transaksi dine-in
- Terapkan voucher diskon
- Tambahkan catatan transaksi

### POS V2 (`/member/p-o-s`)

**Keunggulan:**
- Pencarian produk yang lebih cepat
- Filter berdasarkan kategori
- Tampilan produk yang lebih visual
- Dukungan multi-barcode
- Interface yang lebih modern

### Riwayat Penjualan

**Akses:** Menu "Selling" di panel admin

**Fitur:**
- Lihat semua transaksi penjualan
- Filter berdasarkan:
- Tanggal
- Kasir
- Metode pembayaran
- Status pembayaran
- Detail transaksi lengkap:
- Item yang dibeli
- Harga dan diskon
- Total pembayaran
- Informasi pelanggan
- Cetak ulang struk

---

## Manajemen Produk & Inventory

### Produk

**Akses:** Menu "Products" di panel admin

**Fitur Produk:**

1. **Informasi Dasar**
- Nama produk
- SKU (Stock Keeping Unit)
- Kategori
- Foto produk
- Deskripsi

2. **Harga & Stok**
- Harga beli (cost)
- Harga jual
- Multiple harga (eceran, grosir, koli, dll)
- Stok tersedia
- Stok minimum

3. **Barcode**
- Barcode utama
- Barcode tambahan
- Aktifkan/nonaktifkan barcode
- Cetak label barcode

4. **Pengaturan Lanjutan**
- Tipe produk
- Tracking kadaluarsa
- Non-stock item (untuk jasa)
- Metode perhitungan stok (FIFO/LIFO/Normal)

**Aksi:**
- Tambah produk baru
- Edit produk
- Hapus produk (soft delete)
- Import produk bulk (jika fitur aktif)
- Cetak label produk
- Lihat riwayat stok
- Lihat riwayat penjualan

### Kategori

**Akses:** Menu "Categories" di panel admin

**Fungsi:**
- Organisasi produk berdasarkan kategori
- Mempermudah pencarian di POS
- Analisis penjualan per kategori

### Stock Opname (Perhitungan Fisik Inventory)

**Akses:** Menu "Stock Opname" di panel admin

**Proses:**

1. **Buat Stock Opname Baru**
- Pilih tanggal perhitungan
- Tambahkan produk yang akan dihitung
- Masukkan jumlah fisik aktual

2. **Review Perbedaan**
- Sistem menampilkan:
- Stok sistem (expected)
- Stok fisik (actual)
- Selisih
- Analisis penyebab perbedaan

3. **Approval & Adjustment**
- Review hasil perhitungan
- Approve untuk update stok sistem
- Stok otomatis disesuaikan

4. **Dokumentasi**
- Upload foto/dokumen pendukung
- Catatan adjustment

**Status Workflow:**
- Pending → Reviewing → Approved

---

## Pembelian & Supplier

### Supplier (Pemasok)

**Akses:** Menu "Suppliers" di panel admin

**Informasi Supplier:**
- Nama supplier
- Kontak (telepon, email)
- Alamat lengkap
- Riwayat pembelian

**Fungsi:**
- Tambah supplier baru
- Edit informasi supplier
- Lihat total pembelian dari supplier
- Track supplier performance

### Purchasing (Pembelian)

**Akses:** Menu "Purchasings" di panel admin

**Proses Pembelian:**

1. **Buat Purchase Order (PO)**
- Pilih supplier
- Pilih tanggal pembelian
- Tentukan tanggal jatuh tempo
- Tambahkan produk yang dibeli
- Masukkan:
- Quantity
- Harga beli
- Subtotal
- Tambahkan pajak jika ada

2. **Terima Barang**
- Catat penerimaan barang
- Stok otomatis bertambah
- Sistem mencatat cost per unit

3. **Tracking Pembayaran**
- Status: Lunas / Belum Lunas
- Catat pembayaran ke supplier
- Monitor hutang dagang

**Fitur Tambahan:**
- Upload dokumen pembelian
- Lihat riwayat pembelian per supplier
- Laporan pembelian

---

## Piutang

### Receivables (Piutang Pelanggan)

**Akses:** Menu "Receivables" di panel admin

**Fungsi Utama:**
Kelola penjualan kredit dan piutang pelanggan

**Fitur:**

1. **Buat Piutang**
- Link ke penjualan kredit
- Pilih pelanggan/member
- Tentukan tanggal jatuh tempo
- Catat total piutang
- Breakdown item yang dibeli

2. **Tracking Pembayaran**
- Catat pembayaran cicilan
- Lihat sisa piutang
- Status: Lunas / Belum Lunas
- Pilih metode pembayaran

3. **Reminder Pembayaran**
- Kirim reminder via WhatsApp
- Monitor piutang jatuh tempo
- Lihat piutang terlambat

4. **Laporan Piutang**
- Total piutang per pelanggan
- Aging analysis
- Riwayat pembayaran

---

## Keuangan

### Metode Pembayaran

**Akses:** Menu "Payment Methods" di panel admin

**Tipe Pembayaran:**
- **Cash (Tunai)** - Pembayaran cash
- **Debit** - Kartu debit
- **Credit** - Kartu kredit
- **Wallet** - E-wallet (GoPay, OVO, Dana, dll)

**Pengaturan:**
- Nama metode pembayaran
- Tipe pembayaran
- Icon/logo
- Status aktif/nonaktif

### Laci Kasir (Cash Drawer)

**Fungsi:**
- **Buka Kasir**
- Catat modal awal
- Nama operator kasir
- Waktu pembukaan

- **Tutup Kasir**
- Hitung saldo akhir
- Bandingkan dengan transaksi
- Catat selisih (jika ada)
- Waktu penutupan

**Manfaat:**
- Audit trail keuangan
- Akuntabilitas kasir
- Deteksi kekurangan/kelebihan uang

---

## Voucher & Promosi

### Voucher Diskon

**Akses:** Menu "Vouchers" di panel admin

**Fitur Voucher:**

1. **Tipe Diskon**
- Persentase (%) - contoh: 10% off
- Nominal (Rp) - contoh: Rp 50.000 off

2. **Kode Voucher**
- Buat kode unik
- Contoh: PROMO2025, NATAL50K

3. **Syarat & Ketentuan**
- Minimal pembelian
- Masa berlaku (tanggal mulai - akhir)
- Quota/batas penggunaan
- Status aktif/nonaktif

4. **Penggunaan di POS**
- Otomatis muncul jika memenuhi syarat
- Kasir bisa apply manual
- Validasi otomatis

**Cara Kerja:**
1. Pelanggan belanja
2. Jika total belanja ≥ minimal pembelian
3. Sistem otomatis suggest voucher
4. Diskon otomatis dipotong

---

## Manajemen Pengguna

### User (Pengguna/Karyawan)

**Akses:** Menu "Users" di panel admin

**Informasi User:**
- Nama lengkap
- Email (untuk login)
- Password
- Nomor telepon
- Foto profil
- Alamat
- Role (peran)

**Tipe User:**
- **Owner** - Akses penuh ke semua fitur
- **Manager** - Akses terbatas (konfigurasi)
- **Kasir** - Hanya akses POS
- **Staff** - Akses sesuai role

### Role & Permission (Peran & Hak Akses)

**Akses:** Menu "Roles" dan "Permissions"

**Fungsi:**
- Buat role custom
- Tentukan permission untuk setiap role
- Kontrol akses ke fitur tertentu

**Contoh Role:**
- Kasir: Hanya bisa transaksi POS
- Manager Inventory: Bisa kelola produk dan stok
- Finance: Bisa lihat laporan keuangan

**Permission Granular:**
- View (lihat)
- Create (buat)
- Update (edit)
- Delete (hapus)
- Per modul (Products, Selling, Purchasing, dll)

### Member (Pelanggan)

**Akses:** Menu "Members" di panel admin

**Informasi Member:**
- Nama pelanggan
- Nomor identitas (KTP/SIM)
- Tipe identitas
- Email
- Alamat
- Tanggal bergabung
- Kode member unik

**Manfaat:**
- Program loyalitas
- Tracking pembelian pelanggan
- Link dengan piutang
- Analisis pelanggan setia

---

## Laporan & Analitik

### Dashboard

**Akses:** Halaman pertama setelah login

**Widget Dashboard:**

1. **Produk Terlaris Hari Ini**
- Top 5 produk
- Jumlah terjual
- Total revenue

2. **Peringatan Produk Kadaluarsa**
- Produk yang akan kadaluarsa (20 hari ke depan)
- Tanggal kadaluarsa
- Stok tersisa

3. **Ringkasan Penjualan**
- Total penjualan hari ini
- Total revenue
- Total gross profit
- Jumlah transaksi

4. **Metrik Stok**
- Total produk
- Produk stok rendah
- Nilai inventory

### Laporan Kasir

**Akses:** Menu "Reports" → "Cashier Report"

**Isi Laporan:**
- Tanggal transaksi
- Nomor invoice
- Nama kasir
- Total penjualan
- Metode pembayaran
- Diskon diberikan
- Pajak
- Grand total

**Filter:**
- Range tanggal
- Kasir tertentu
- Metode pembayaran

**Export:**
- PDF dengan pagination
- Footer total summary

### Laporan Penjualan

**Akses:** Menu "Reports" → "Selling Report"

**Analisis:**
- Penjualan per periode
- Penjualan per produk
- Penjualan per kategori
- Penjualan per kasir
- Penjualan per member

**Metrik:**
- Quantity terjual
- Revenue (pendapatan)
- Gross profit (keuntungan kotor)
- Rata-rata transaksi

### Laporan Produk

**Akses:** Menu "Reports" → "Product Report"

**Informasi:**
- Produk terlaris
- Produk slow-moving
- Profitabilitas per produk
- Pergerakan stok
- Cost vs Selling price

### Laporan Pembelian

**Akses:** Menu "Reports" → "Purchasing Report"

**Analisis:**
- Total pembelian per supplier
- Cost analysis
- Spending trend
- Payment status
- Outstanding payables

---

## Pengaturan Aplikasi

### General Settings (Pengaturan Umum)

**Akses:** Menu "Settings" atau "General Setting"

**Konfigurasi Bisnis:**

1. **Informasi Toko**
- Nama bisnis
- Tipe bisnis (retail/restoran/dll)
- Alamat lengkap
- Kontak

2. **Currency & Locale**
- Mata uang (default: IDR)
- Timezone
- Format tanggal
- Format angka

3. **Pajak**
- Tax rate default
- Aktifkan/nonaktifkan pajak

4. **Inventory**
- Metode perhitungan stok:
- **FIFO** (First In First Out)
- **LIFO** (Last In First Out)
- **Normal** (Average)
- Peringatan stok minimum

5. **Laci Kasir**
- Wajib buka laci sebelum transaksi
- Mode cash drawer

6. **Keamanan**
- Password protect harga modal
- Secure initial price

### Feature Flags (Fitur On/Off)

**Fungsi:**
Aktifkan/nonaktifkan fitur sesuai kebutuhan bisnis

**Fitur yang Bisa Di-toggle:**
- ✅ Supplier management
- ✅ Modul purchasing
- ✅ Piutang (receivables)
- ✅ Stock opname
- ✅ Voucher system
- ✅ Diskon
- ✅ Payment shortcuts
- ✅ Barcode produk
- ✅ SKU produk
- ✅ Tracking stok
- ✅ Tipe produk
- ✅ Peringatan kadaluarsa
- ✅ Tampilkan harga modal
- ✅ Manajemen role
- ✅ Manajemen permission
- ✅ Manajemen user
- ✅ Member/loyalitas
- ✅ Manajemen metode pembayaran
- ✅ Pajak penjualan
- ✅ Kolom total revenue
- ✅ POS V2
- ✅ Cetak label produk
- ✅ Cetak struk A5
- ✅ Import produk

**Cara Menggunakan:**
1. Masuk menu Settings
2. Cari fitur yang ingin diaktifkan/nonaktifkan
3. Toggle switch on/off
4. Fitur langsung aktif/nonaktif

### Printer Settings

**Akses:** Menu "Printer"

**Konfigurasi Printer Thermal:**

1. **Tipe Koneksi**
- USB Printer
- IP/Network Printer

2. **Driver Settings**
- Nama driver
- Port komunikasi
- IP address (untuk network printer)

3. **Printer Actions**
- Test print
- Set as default
- Aktifkan/nonaktifkan

**Supported:**
- Thermal printer
- Receipt printer
- Label printer

---

## Tips & Best Practices

### 💡 Tips Menggunakan POS

1. **Gunakan Barcode Scanner**
- Lebih cepat daripada input manual
- Kurangi kesalahan entry

2. **Manfaatkan Shortcut Payment**
- Quick access ke metode pembayaran favorit
- Percepat proses checkout

3. **Aktifkan Laci Kasir**
- Untuk audit dan akuntabilitas
- Deteksi selisih uang lebih cepat

4. **Link Transaksi ke Member**
- Build database pelanggan
- Track repeat customers
- Analisis pelanggan setia

### 📊 Tips Manajemen Inventory

1. **Set Stok Minimum**
- Dapat notifikasi sebelum kehabisan
- Prevent stockout

2. **Lakukan Stock Opname Rutin**
- Minimal 1x sebulan
- Deteksi kehilangan/shrinkage
- Akurasi data stok

3. **Monitor Produk Kadaluarsa**
- Cek dashboard warning
- Jual/diskon sebelum kadaluarsa
- Minimize loss

4. **Gunakan Multi-unit Pricing**
- Harga eceran vs grosir
- Increase average transaction
- Fleksibilitas pricing

### 📈 Tips Laporan & Analisis

1. **Review Dashboard Setiap Hari**
- Monitor performa harian
- Deteksi anomali
- Quick decision making

2. **Analisis Produk Terlaris**
- Stock lebih banyak
- Promosi bundling
- Fokus pada high movers

3. **Track Slow-Moving Items**
- Buat promo clearance
- Stop restock
- Optimize inventory

4. **Monitor Gross Profit Margin**
- Pastikan profitabilitas
- Review pricing strategy
- Identifikasi loss items

### 🔐 Tips Keamanan

1. **Gunakan Role & Permission**
- Berikan akses sesuai kebutuhan
- Jangan semua user jadi admin
- Regular audit access

2. **Ganti Password Berkala**
- Minimal 3 bulan sekali
- Gunakan password kuat
- Jangan share akun

3. **Aktifkan Secure Initial Price**
- Kasir tidak bisa lihat cost
- Protect profit margin
- Hanya manager/owner yang tahu

4. **Regular Backup Data**
- Backup database rutin
- Store di tempat aman
- Test restore procedure

---

## Troubleshooting

### Masalah Umum & Solusi

**1. Stok tidak update setelah transaksi**
- ✅ Cek apakah fitur "Product stock tracking" aktif
- ✅ Pastikan produk bukan "non-stock item"
- ✅ Periksa stock record di menu Product detail

**2. Barcode tidak terbaca**
- ✅ Pastikan barcode status "Active"
- ✅ Cek scanner terkoneksi dengan baik
- ✅ Test dengan barcode lain

**3. Voucher tidak muncul/tidak bisa digunakan**
- ✅ Cek masa berlaku voucher
- ✅ Pastikan total belanja ≥ minimal pembelian
- ✅ Cek quota voucher masih tersedia
- ✅ Voucher status aktif

**4. Tidak bisa login**
- ✅ Cek email dan password
- ✅ Pastikan user status aktif
- ✅ Contact administrator untuk reset password

**5. Laporan tidak muncul/kosong**
- ✅ Periksa filter tanggal
- ✅ Pastikan ada data di periode tersebut
- ✅ Coba refresh halaman

**6. Printer tidak berfungsi**
- ✅ Cek koneksi USB/network
- ✅ Pastikan driver terinstall
- ✅ Test print dari pengaturan printer
- ✅ Restart aplikasi/printer

---

## Dukungan & Bantuan

### Butuh Bantuan?

Jika mengalami masalah atau pertanyaan:

1. **Baca dokumentasi ini** - Kebanyakan pertanyaan sudah terjawab di sini
2. **Cek menu Help** - Ada panduan interaktif di aplikasi
3. **Contact Support** - Hubungi tim support untuk bantuan teknis
4. **Training** - Minta training untuk tim Anda

### Informasi Teknis

- **Versi Laravel:** 11.45.1
- **Versi Filament:** 3.3.4
- **PHP:** 8.3.27
- **Database:** MySQL 5.7+

---

## Changelog & Updates

Aplikasi ini terus dikembangkan dengan fitur-fitur baru.

**Fitur Terbaru:**
- ✨ POS V2 dengan search yang lebih cepat
- ✨ Support multi-barcode per produk
- ✨ WhatsApp reminder untuk piutang
- ✨ Enhanced dashboard dengan lebih banyak widget
- ✨ Product label printing
- ✨ A5 receipt printing
- ✨ Bulk product import

**Rencana Pengembangan:**
- 🔄 Mobile app optimization
- 🔄 Advanced analytics & forecasting
- 🔄 Customer loyalty program
- 🔄 Integration dengan e-commerce
- 🔄 Multi-warehouse support

---

## Kesimpulan

Lakasir adalah solusi POS yang lengkap dan powerful untuk bisnis retail dan restoran Anda. Dengan fitur-fitur yang komprehensif mulai dari penjualan, inventory, keuangan, hingga analitik, Lakasir membantu Anda mengelola bisnis dengan lebih efisien dan efektif.

**Mulai gunakan Lakasir sekarang dan rasakan kemudahan mengelola bisnis Anda!**

---

*Dokumen ini dibuat pada: 26 November 2025*
*Versi Aplikasi: Lakasir POS System*
*Untuk pertanyaan dan dukungan, silakan hubungi tim support Anda.*