🦀

# JURAGAN KEPITING POS

## Panduan Penggunaan Aplikasi Kasir

https://delightful-solace-production.up.railway.app
Versi 1.0 | Juni 2026

## 1Cara Masuk (Login)

Buka aplikasi melalui browser (Chrome, Firefox, Edge) lalu masukkan username dan password Anda.

- Buka browser dan ketik alamat: https://delightful-solace-production.up.railway.app
- Masukkan Username dan Password Anda
- Klik tombol Masuk

💡
Tips: Jika halaman loading lama (30 detik) saat pertama kali dibuka, itu normal — server sedang menyala. Tunggu sebentar lalu coba lagi.
⚠️
Lupa password? Hubungi pemilik toko (Owner) untuk mereset password Anda.

## 2Halaman Utama (Dashboard)

Setelah login, Anda akan langsung masuk ke halaman Dashboard yang menampilkan ringkasan bisnis hari ini.

### Informasi yang ditampilkan:

Kartu Informasi | Penjelasan
--- | ---
💰 Penjualan Hari Ini | Total uang masuk dari transaksi hari ini
🛒 Transaksi | Jumlah transaksi yang sudah dilakukan hari ini
📦 Produk Aktif | Jumlah barang/produk yang sedang aktif dijual
⚠️ Stok Menipis | Jumlah produk yang stoknya sudah hampir habis

Di bagian bawah terdapat grafik penjualan 7 hari terakhir dan daftar produk terlaris.

## 3Transaksi Penjualan (Kasir)

Menu Kasir (POS) digunakan untuk melayani pelanggan dan mencatat setiap transaksi penjualan.

### Cara membuat transaksi baru:

- Klik menu Kasir di sidebar kiri
- Pilih tab Produk atau Paket sesuai pesanan pelanggan
- Klik barang/paket yang dipesan — barang otomatis masuk ke keranjang di sebelah kanan
- Untuk mengubah jumlah (qty), klik tombol + atau − di keranjang, atau ketik langsung di kotak angka
- Periksa total yang tertera di bawah keranjang
- Masukkan jumlah uang yang dibayar pelanggan di kolom Uang Bayar
- Kembalian akan dihitung otomatis
- Klik Proses Transaksi untuk menyelesaikan
- Struk/receipt akan muncul — klik Cetak Struk jika diperlukan

🔍
Cari barang cepat: Gunakan kotak pencarian di atas daftar produk untuk menemukan barang dengan mengetik nama.
❗
Perhatian: Pastikan stok barang mencukupi sebelum transaksi. Jika stok habis, barang tidak bisa dipilih dan akan terlihat redup/tidak aktif.

### Menghapus barang dari keranjang:

- Klik ikon 🗑 Hapus di samping barang yang ingin dihapus dari keranjang
- Atau klik tombol Kosongkan untuk menghapus semua barang sekaligus

## 4Kelola Barang / Produk

Menu Barang digunakan untuk menambah, mengubah, atau menonaktifkan produk yang dijual.

### Menambah barang baru:

- Klik menu Barang di sidebar
- Klik tombol + Tambah Barang (oranye)
- Isi formulir yang muncul:

Kolom | Keterangan | Contoh
--- | --- | ---
Nama Barang * | Nama produk yang dijual | Kepiting Jumbo
Kategori | Kelompok barang (isi bebas) | Kepiting, Minuman
Satuan * | Pilih satuan dari dropdown | Kg, Gram, Porsi, Pcs
Harga Pokok (HPP) | Harga beli/modal barang | 80.000
Harga Jual * | Harga yang dibayar pelanggan | 120.000
Stok Awal | Jumlah stok pertama kali | 50
Status | Aktif = bisa dijual; Nonaktif = tidak muncul di kasir | Aktif

- Klik Simpan untuk menyimpan barang baru

### Mengubah / mengedit barang:

- Cari barang yang ingin diubah menggunakan kolom pencarian
- Klik ikon ✏️ Edit di baris barang tersebut
- Ubah data yang diperlukan, lalu klik Simpan

⚠️
Nonaktifkan, bukan hapus: Daripada menghapus barang yang sudah pernah terjual, lebih baik ubah statusnya menjadi Nonaktif agar riwayat penjualan tetap tersimpan.

## 5Kelola Paket Menu

Paket adalah bundel beberapa produk yang dijual dengan satu harga. Contoh: Paket Keluarga berisi 1 kg kepiting + 4 porsi nasi + 4 gelas es teh.

### Membuat paket baru:

- Klik menu Paket di sidebar
- Klik tombol + Tambah Paket
- Isi nama paket, deskripsi (opsional), dan harga jual paket
- Tambahkan produk yang termasuk dalam paket: pilih produk dari dropdown, lalu isi jumlahnya (qty)
- Klik + Tambah Item untuk menambah produk berikutnya dalam paket
- Klik Simpan

💡
Tips: Saat paket terjual, stok semua produk di dalam paket akan berkurang otomatis sesuai jumlah yang sudah diset.

## 6Catat Pembelian / Stok Masuk

Menu Pembelian digunakan untuk mencatat setiap kali Anda membeli barang/bahan dari supplier, sehingga stok bertambah otomatis.

### Mencatat pembelian baru:

- Klik menu Pembelian di sidebar
- Klik tombol + Catat Pembelian
- Isi data pembelian:

Kolom | Keterangan
--- | ---
Tanggal | Tanggal pembelian dilakukan
Supplier | Nama toko/pemasok tempat membeli (opsional)
Catatan | Keterangan tambahan jika perlu
Barang | Pilih barang yang dibeli
Qty | Jumlah barang yang dibeli
Harga Beli | Harga per satuan saat beli

- Untuk membeli lebih dari 1 jenis barang, klik + Tambah Item
- Klik Simpan — stok barang akan bertambah otomatis

💡
Otomatis: Harga beli yang Anda masukkan akan digunakan sebagai acuan perhitungan HPP (Harga Pokok Penjualan) di laporan laba rugi.

## 7Manajemen Stok

Menu Stok memungkinkan Anda melakukan penyesuaian stok secara manual, misalnya jika ada barang rusak, hilang, atau koreksi hitung ulang stok.

### Cara menyesuaikan stok:

- Klik menu Stok di sidebar
- Cari barang yang stoknya ingin disesuaikan
- Klik tombol Sesuaikan Stok di baris barang tersebut
- Pilih jenis penyesuaian:
  - Penambahan — stok bertambah (contoh: stok fisik lebih dari sistem)
  - Pengurangan — stok berkurang (contoh: ada barang rusak/hilang)
- Masukkan jumlah penyesuaian dan alasan
- Klik Simpan

❗
Hati-hati: Setiap penyesuaian stok tercatat di riwayat dan tidak bisa dibatalkan. Pastikan jumlah yang dimasukkan sudah benar.

## 8Riwayat Pergerakan Stok

Menu Riwayat Stok menampilkan semua catatan pergerakan stok: stok masuk (pembelian), stok keluar (penjualan), dan penyesuaian manual.

Gunakan filter di bagian atas untuk menyaring berdasarkan:

- Nama barang — cari pergerakan stok barang tertentu
- Jenis — semua / masuk / keluar
- Tanggal — pilih rentang tanggal yang ingin dilihat

Setiap baris menampilkan: tanggal, nama barang, jenis pergerakan, jumlah, dan keterangan.

## 9Riwayat Transaksi Penjualan

Menu Riwayat Jual menampilkan semua transaksi penjualan yang pernah dilakukan, lengkap dengan detail item dan total bayar.

### Cara menggunakan:

- Klik menu Riwayat Jual di sidebar
- Gunakan filter tanggal untuk memilih periode tertentu
- Klik baris transaksi untuk melihat detail item yang terjual
- Klik Cetak Ulang Struk jika perlu mencetak kembali struk lama

💡
Cari transaksi: Gunakan kolom pencarian untuk mencari berdasarkan nomor transaksi atau nama kasir yang memproses.

## 10Laporan Penjualan

Menu Laporan Jual menampilkan rekap penjualan dalam periode tertentu, disertai grafik visual.

### Informasi yang tersedia:

Informasi | Keterangan
--- | ---
Total Penjualan | Jumlah uang dari semua transaksi di periode dipilih
Jumlah Transaksi | Berapa kali transaksi terjadi
Rata-rata per Transaksi | Rata-rata nilai belanja per transaksi
Grafik Harian | Tren penjualan per hari dalam grafik batang
Produk Terlaris | Daftar barang yang paling banyak terjual

### Filter laporan:

- Pilih tanggal mulai dan tanggal akhir untuk melihat periode tertentu
- Klik Tampilkan untuk memuat data

## 11Laporan Laba Rugi

Menu Laba Rugi menampilkan perhitungan keuntungan bersih berdasarkan selisih harga jual dan harga pokok (HPP).

Istilah | Artinya
--- | ---
Total Penjualan | Total uang yang diterima dari pelanggan
Total HPP | Total modal/harga beli barang yang terjual
Laba Kotor | Penjualan dikurangi HPP
% Margin | Persentase keuntungan dari total penjualan

💡
Akurasi HPP: Agar laporan laba rugi akurat, pastikan selalu mengisi Harga Pokok (HPP) saat menambah barang dan mengisi Harga Beli saat mencatat pembelian.

## 12Kelola Pengguna

Menu Pengguna hanya bisa diakses oleh Owner. Digunakan untuk menambah, mengubah, atau menonaktifkan akun karyawan.

### Menambah karyawan baru:

- Klik menu Pengguna di sidebar
- Klik tombol + Tambah Pengguna
- Isi nama lengkap, username (untuk login), password, dan pilih role/jabatan
- Klik Simpan

### Mengubah password karyawan:

- Cari nama karyawan di daftar
- Klik ikon ✏️ Edit
- Isi kolom Password Baru dan konfirmasi
- Klik Simpan

## 13Ringkasan Hak Akses

Setiap pengguna memiliki peran (role) yang menentukan menu apa saja yang bisa diakses.

Menu / Fitur | Owner | Admin | Kasir
--- | --- | --- | ---
Dashboard | ✅ | ✅ | ✅
Kasir (Transaksi) | ✅ | ✅ | ✅
Kelola Barang | ✅ | ✅ | ❌
Kelola Paket | ✅ | ✅ | ❌
Catat Pembelian | ✅ | ✅ | ❌
Manajemen Stok | ✅ | ✅ | ❌
Riwayat Stok | ✅ | ✅ | ❌
Riwayat Penjualan | ✅ | ✅ | ✅
Laporan Penjualan | ✅ | ✅ | ❌
Laporan Laba Rugi | ✅ | ❌ | ❌
Kelola Pengguna | ✅ | ❌ | ❌

🔐
Keamanan akun: Segera ganti password default setelah pertama kali login. Jangan bagikan password Anda kepada siapapun.