Membuat Kasir Petshop dengan Laravel: Stok Anti Minus, Slot Booking Grooming & Kandang Pet Hotel
Aplikasi petshop kelihatannya sederhana: jual pakan, terima grooming, titip kucing. Tapi begitu dipakai sungguhan, masalahnya muncul satu per satu. Stok di sistem minus karena dua kasir menjual barang terakhir bersamaan, jam grooming jam 10 terisi lima ekor padahal groomer cuma dua, dan kandang nomor 3 ternyata dipesan dua orang di tanggal yang sama.
Di tutorial ini kita bahas lima teknik inti dari aplikasi manajemen petshop berbasis Laravel 12 dan MySQL yang menyelesaikan masalah-masalah itu.
1. Semua perubahan stok lewat satu pintu
Kesalahan paling umum adalah mengubah kolom stok langsung di banyak tempat: di kasir, di form edit produk, di pembatalan. Akibatnya tidak ada jejak kenapa stok berubah. Solusinya: buat satu fungsi yang mengubah stok sekaligus mencatat mutasinya.
// app/Models/StokMutasi.php
public static function catat(Produk $p, string $jenis, int $qty, ?string $ket = null, ?int $user = null): self
{
$p->stok += $qty;
$p->save();
return self::create([
'produk_id' => $p->id, 'user_id' => $user ?? auth()->id(), 'jenis' => $jenis,
'qty' => $qty, 'stok_akhir' => $p->stok, 'keterangan' => $ket, 'waktu' => now(),
]);
}
Jenisnya cukup lima: masuk, keluar, penyesuaian (stok opname), penjualan, dan batal. Form edit produk sengaja tidak punya kolom stok, jadi pemilik toko selalu bisa menelusuri ke mana barangnya pergi.
Stok opname juga lewat jalur yang sama. Yang diisi adalah jumlah sebenarnya di rak, lalu selisihnya dihitung otomatis: $qty = $d['qty'] - $p->stok;.
2. Kasir: kunci baris produk agar stok tidak minus
Kasir mengirim keranjang lewat fetch dalam bentuk JSON. Browser hanya mengirim id, tipe, dan jumlah. Harga diambil ulang dari database supaya tidak bisa diakali dari DevTools. Bagian terpenting ada di lockForUpdate():
$t = DB::transaction(function () use ($d) {
$idProduk = collect($d['item'])->where('tipe', 'produk')->pluck('id')->unique()->all();
$produk = Produk::whereIn('id', $idProduk)->where('aktif', true)->lockForUpdate()->get()->keyBy('id');
// ... susun baris & jumlah kebutuhan per produk ($butuh)
foreach ($butuh as $id => $q) {
if ($q > $produk[$id]->stok) {
throw ValidationException::withMessages(['item' => 'Stok ' . $produk[$id]->nama . ' tinggal ' . $produk[$id]->stok . '.']);
}
}
// simpan transaksi, item, lalu StokMutasi::catat($produk[$id], 'penjualan', -$qty, $t->nomor)
});
Dengan lockForUpdate(), kasir kedua yang menjual produk yang sama harus menunggu transaksi pertama selesai. Saat gilirannya tiba, ia membaca stok yang sudah berkurang dan otomatis ditolak bila tidak cukup. ValidationException yang dilempar di dalam closure juga membatalkan seluruh transaksi database, jadi tidak ada transaksi setengah jadi.
Nomor struk dibuat di dalam transaksi yang sama dengan lockForUpdate() pada nomor terakhir hari itu, sehingga tidak ada dua struk bernomor sama.
3. Slot jam grooming dengan kapasitas
Jam layanan disimpan sebagai teks sederhana di pengaturan, misalnya 09:00,10:00,11:00,13:00, bersama kapasitas per jam (biasanya sama dengan jumlah groomer). Sisa kuota dihitung dari booking yang masih aktif:
public static function slot(string $tanggal, string $kategori): array
{
$kap = max(1, (int) Petshop::get('kapasitas_slot'));
$pakai = Booking::query()->join('layanan', 'layanan.id', '=', 'booking.layanan_id')
->where('layanan.kategori', $kategori)->whereDate('booking.tanggal', $tanggal)
->whereIn('booking.status', ['menunggu', 'dikonfirmasi', 'dikerjakan'])
->groupBy('booking.jam')->selectRaw('booking.jam, count(*) as n')->pluck('n', 'jam');
return collect(Petshop::slot())->map(fn ($j) => [
'jam' => ,
=> (, - () ([] ?? )),
=> ::( . . )->(()),
])->();
}
Fungsi yang sama dipakai dua kali: sebagai endpoint JSON untuk form booking (tombol jam yang penuh tampil dicoret), dan sebagai pemeriksaan akhir di server saat booking disimpan. Pemeriksaan akhir itu dibungkus DB::transaction dengan baris layanan sekategori dikunci, sehingga dua orang yang menekan "Kirim booking" bersamaan untuk slot terakhir tidak sama-sama lolos.
4. Kandang pet hotel: deteksi tumpang tindih tanggal
Untuk penitipan, kuncinya adalah rumus irisan dua rentang tanggal. Booking lama bentrok dengan booking baru [masuk, keluar) bila tanggal_lama < keluar dan jemput_lama > masuk:
public static function kandangKosong(string $masuk, string $keluar): array
{
$n = max(1, (int) Petshop::get('jumlah_kandang'));
$isi = Booking::whereNotNull('kandang')->whereIn('status', ['menunggu', 'dikonfirmasi', 'dikerjakan'])
->whereDate('tanggal', '<', $keluar)->whereDate('tanggal_keluar', '>', $masuk)
->pluck('kandang')->all();
return array_values(array_diff(range(1, $n), $isi));
}
Perhatikan tanda < dan > yang ketat. Kucing yang dijemput tanggal 30 dan kucing lain yang check-in tanggal 30 bisa memakai kandang yang sama, karena pagi kandangnya dibersihkan lalu siang diisi lagi. Booking baru otomatis mendapat nomor kandang kosong pertama, dan denah kandang di panel cukup membaca kolom kandang per tanggal.
5. Booking ditagih di kasir, dan bisa dibatalkan dengan rapi
Booking grooming belum dibayar sampai hewannya dijemput. Tombol "Tagih di kasir" membuka kasir dengan layanan sudah ada di keranjang, berikut id booking-nya. Saat transaksi disimpan, server memastikan booking itu belum dibayar dan layanannya cocok, lalu menautkannya:
if ($b->transaksi_id || $b->status === 'batal' || (int) $b->layanan_id !== (int) $l->id) {
throw ValidationException::withMessages(['item' => 'Booking sudah dibayar atau tidak cocok dengan layanannya.']);
}
// setelah transaksi tersimpan:
Booking::whereKey($b->id)->update(['transaksi_id' => $t->id, 'status' => 'selesai']);
Untuk pet hotel, jumlah item otomatis diisi jumlah malam ($tanggal->diffInDays($tanggal_keluar)). Bila admin membatalkan transaksi, stok produk dikembalikan lewat StokMutasi::catat($p, 'batal', $qty) dan transaksi_id booking dikosongkan lagi, sehingga booking bisa ditagih ulang dengan benar.
Bonus: link WhatsApp siap kirim
Setiap perubahan status booking dan setiap vaksin yang jatuh tempo punya tombol WhatsApp berisi pesan yang sudah terisi. Nomor dinormalkan dulu (0812... menjadi 62812...), lalu dibuat link https://wa.me/62...?text= + rawurlencode($pesan). Tanpa API berbayar, pelanggan tetap merasa dilayani dengan personal.
Ringkasan
- Semua perubahan stok lewat satu fungsi yang sekaligus mencatat mutasi.
- Transaksi kasir memakai
DB::transaction+lockForUpdate()dan harga diambil dari database. - Slot jam dihitung dari booking aktif dan diperiksa ulang di server saat disimpan.
- Kandang pet hotel memakai rumus irisan rentang tanggal
masuk < keluar_lamadankeluar > masuk_lama. - Booking dan transaksi saling tertaut sehingga pembayaran dan pembatalan tetap konsisten.
Download source code lengkapnya
Source code lengkap, termasuk website publik, booking online, kasir, stok, jadwal grooming, denah pet hotel, kartu hewan & vaksin, laporan, data contoh, dan skrip instalasi XAMPP, bisa diunduh gratis:
Download Source Code Aplikasi Manajemen Petshop Laravel di Papicode
Source code lengkapnya gratis
Lihat semua yang dibahas di artikel ini langsung berjalan.