📖 Manual Dokumentasi Aplikasi

1. Tentang Aplikasi

POS Kasir adalah aplikasi Point of Sale (kasir) modern berbasis web yang dibangun dengan framework Laravel. Aplikasi ini dirancang untuk mempermudah bisnis retail mengelola transaksi harian, inventaris barang, data pemasok, pelanggan, hingga laporan keuangan secara real-time.

Aplikasi ini juga dilengkapi dengan **Aplikasi Android** yang dirancang sebagai antarmuka kasir portable berbasis WebView yang terhubung langsung ke server.

2. Persyaratan Sistem

Untuk menjalankan aplikasi dengan lancar, pastikan perangkat Anda memenuhi spesifikasi berikut:

Spesifikasi Web Server (Lokal/Hosting)

Spesifikasi Perangkat Android

3. Instalasi & Konfigurasi (Server Lokal)

Berikut adalah langkah-langkah untuk menjalankan aplikasi ini di komputer lokal menggunakan XAMPP:

1. Aktifkan modul Apache dan MySQL pada XAMPP Control Panel.
2. Letakkan folder proyek kasir ke dalam direktori C:\xampp\htdocs\.
3. Buka phpMyAdmin (http://localhost/phpmyadmin) lalu buat database baru dengan nama kasir.
4. Duplikat file .env.example dan ubah namanya menjadi .env. Sesuaikan baris database berikut:

   DB_DATABASE=kasir
   DB_USERNAME=root
   DB_PASSWORD=

5. Buka terminal CMD di folder C:\xampp\htdocs\kasir dan jalankan perintah:

   composer install
   php artisan key:generate
   php artisan migrate --seed

6. Akses aplikasi melalui browser: http://localhost/kasir.

4. Login & Hak Akses

Halaman masuk (login) digunakan untuk memverifikasi pengguna berdasarkan role yang dimilikinya (Admin atau Kasir).

Gambar 4.1: Antarmuka Halaman Login Aplikasi

Gunakan kredensial yang didaftarkan oleh administrator untuk masuk. Tingkat hak akses dibagi menjadi:

• Admin: Memiliki akses penuh ke seluruh sistem termasuk Laporan, Laba Bersih, Manajemen Pengguna, dan Konfigurasi Toko.
• Kasir: Hanya memiliki akses ke halaman Dashboard ringkasan (tanpa informasi laba keuangan), transaksi penjualan (POS), dan data produk.

5. Dashboard

Dashboard menyajikan statistik harian performa penjualan toko Anda. Bagian ini memuat grafik penjualan 7 hari terakhir serta alarm untuk produk dengan stok menipis.

Gambar 5.1: Halaman Dashboard Utama (Tampilan Admin)

6. Modul POS Kasir

Modul POS Kasir dirancang secara interaktif untuk kasir melakukan transaksi penjualan dengan cepat.

Gambar 6.1: Antarmuka Point of Sale (POS) Kasir

Cara Melakukan Transaksi:

1. Cari produk menggunakan fitur pencarian di sebelah kiri, lalu klik produk untuk menambahkannya ke keranjang.
2. Sesuaikan kuantitas (jumlah barang) di keranjang pembayaran sebelah kanan.
3. Jika pelanggan merupakan member terdaftar, masukkan nomor HP member pada kolom pencarian member untuk mendapatkan potongan harga/diskon otomatis.
4. Pilih metode pembayaran: CASH, QRIS, atau DEBIT.
5. Masukkan jumlah uang yang diterima, lalu klik Proses Pembayaran. Struk belanja akan terbuka secara otomatis untuk dicetak.

7. Manajemen Produk

Digunakan untuk mengelola daftar barang dagangan Anda, meliputi kode SKU, harga modal, harga jual, kategori, satuan, dan jumlah stok barang.

Gambar 7.1: Manajemen Inventaris Produk

8. Manajemen Pelanggan (Member)

Bagian ini digunakan untuk mencatat identitas pelanggan setia toko Anda. Dengan mendaftarkan pelanggan sebagai member, mereka berhak mendapatkan diskon khusus (misal 5% atau 10%) yang dapat diatur per individu pelanggan.

Saat transaksi di kasir, cukup ketik nomor telepon pelanggan tersebut untuk menerapkan diskon secara langsung pada total belanja.

9. Manajemen Supplier (Pemasok)

Mencatat daftar supplier/distributor tempat Anda membeli produk. Anda dapat melakukan pencatatan transaksi pembelian inventaris langsung dari detail data supplier untuk secara otomatis menambahkan stok produk ke dalam sistem secara tercatat.

10. Laporan Keuangan & Laba Rugi

Hanya dapat diakses oleh Admin. Halaman ini digunakan untuk melihat riwayat transaksi serta menganalisis keuntungan bersih.

Gambar 10.1: Laporan Penjualan dan Laba Bersih

Anda dapat memfilter laporan berdasarkan rentang tanggal tertentu, kasir yang bertugas, maupun metode pembayaran yang digunakan. Terdapat pula fitur Void (Batalkan Transaksi) yang jika diklik akan membatalkan penjualan dan mengembalikan stok barang ke inventaris asal.

11. Pengaturan Aplikasi

Halaman ini mempermudah kustomisasi identitas fisik toko Anda. Anda dapat merubah:

• Nama Toko: Akan tampil di bagian kop struk belanja, tab browser, dan sidebar.
• Alamat & Telepon Toko: Dicetak langsung pada bagian kop struk struk belanja kertas.

12. Aplikasi Android (Perangkat Kasir)

Aplikasi Android bertindak sebagai WebView yang dipasang pada tablet/HP kasir untuk mengakses server aplikasi.

Gambar 12.1: Halaman Konfigurasi Server pada Aplikasi Android

Cara Konfigurasi Aplikasi Android:

1. Instal file pos-kasir.apk yang berada di folder public/ ke perangkat Android Anda.
2. Buka aplikasi, lalu Anda akan dihadapkan pada layar konfigurasi server.
3. Masukkan alamat URL server aplikasi Anda:
   • Server Lokal (Wi-Fi): Masukkan IP komputer lokal Anda (contoh: http://192.168.1.15/kasir).
   • Server Online (Cloud): Masukkan domain hosting Anda (contoh: https://irilanwar.my.id/kasir).
4. Klik tombol Hubungkan & Simpan.