💰 Urusan Uang & Stok Barang: Haram Hukumnya Percaya 100% pada Browser!
Saat membuat aplikasi Point of Sale (Kasir Toko/Koperasi), Sistem Iuran Kas Warga, atau Aplikasi Pengadaan (PO), tampilan yang keren hanyalah nomor dua. Nomor satu yang paling krusial adalah: Angka rupiah dan jumlah stok tidak boleh meleset satu perak pun!
Sayangnya, banyak programmer pemula (atau pembuat aplikasi instan berbasis AI) menaruh rumus perkalian harga, diskon, dan pengurangan stok di dalam kode JavaScript Browser (Frontend) lalu langsung mengirim hasil akhirnya ke database. Apa bahayanya, dan bagaimana cara membangun sistem kasir yang 100% anti-selisih? Mari kita bedah lewat 4 diagram workflow!
1. Bahaya Menghitung Uang di Browser: Jebakan "Inspect Element (F12)"
Ingat aturan utama keamanan web: Segala sesuatu yang tampil di browser pengguna (HTML & JavaScript) berada di bawah kendali pengguna tersebut!
Jika aplikasi Anda menghitung Total Bayar = Harga x Jumlah di JavaScript lalu mengirim angka total_bayar tersebut ke server, orang yang mengerti sedikit teknik web cukup menekan tombol F12 (Inspect Element), mengubah angka harga dari Rp 50.000 menjadi Rp 100, lalu klik Bayar!
📊 Workflow 1: Cara Kerja Aplikasi Rawan Manipulasi vs Aplikasi Kasir Aman (Server-Side)
💡 Lalu Apakah JavaScript Tidak Boleh Menghitung Sama Sekali? Boleh! JavaScript di browser tetap bertugas menghitung angka Subtotal di layar agar kasir bisa melihat estimasi kembalian secara cepat (Realtime UI). TETAPI saat tombol "Simpan Transaksi" ditekan, Laravel wajib menghitung ulang dari nol berdasarkan harga resmi di dalam tabel MySQL!
2. Prinsip "Zero-Formula View" pada Aplikasi Kas Warga & Google Sheets
Bukan hanya di aplikasi Laravel + MySQL, aturan ini juga berlaku mutlak saat Anda membuat Aplikasi Monitoring Kas & Iuran Warga berbasis Google Apps Script (GAS) + Google Sheets.
Kesalahan yang sering terjadi adalah menaruh rumus =SUM(), =VLOOKUP(), atau =QUERY() yang rumit langsung di lembar kerja yang diakses oleh tampilan warga. Akibatnya: saat baris baru ditambahkan dari web, rumus sering bergeser, loading menjadi sangat lambat, dan angka rekap bisa berantakan!
📊 Workflow 2: Arsitektur "Tanpa Rumus di Tampilan Klien" (Backend Calculation)
3. Jurus Anti-Selisih Pertama: Database Transaction (All-or-Nothing!)
Dalam sebuah aplikasi Kasir (POS) atau Pengadaan, 1 kali klik tombol "Bayar" sebenarnya melakukan 3 pekerjaan beruntun di database MySQL:
1) Mencatat nota di tabel penjualan, 2) Mencatat rincian barang di detail_penjualan, dan 3) Mengurangi jumlah stok di tabel barang.
Bayangkan jika setelah langkah ke-1 berhasil, tiba-tiba listrik mati atau koneksi putus sebelum langkah ke-3 jalan! Nota sudah tercetak, tapi stok barang tidak berkurang! Untuk mencegah bencana ini, kita wajib membungkus ketiganya dengan fitur DB::transaction() di Laravel.
📊 Workflow 3: Cara Kerja DB Transaction (Commit vs Rollback Otomatis)
4. Jurus Anti-Selisih Kedua: Menangkal "Tabrakan 2 Kasir" (Race Condition)
Pernahkah Anda melihat stok barang di aplikasi tiba-tiba menjadi minus (-1)? Itu terjadi karena Race Condition (Balapan Akses): Sisa stok beras tinggal 1 karung, namun Kasir A dan Kasir B mengklik tombol "Bayar" pada detik yang sama persis!
Solusinya di Laravel sangat mudah: tambahkan fungsi lockForUpdate() saat mengecek stok. Maka MySQL akan menyuruh Kasir B mengantre 0,05 detik sampai transaksi Kasir A selesai!
// Contoh Kode Kasir (POS) Anti-Selisih & Anti-Minus di Laravel
use IlluminateSupportFacadesDB;
public function prosesBayar(Request $request) {
return DB::transaction(function () use ($request) {
// 1. Kunci baris barang selama 0,05 detik agar tidak diserobot kasir lain!
$barang = DB::table("barang")
->where("id", $request->id_barang)
->lockForUpdate()
->first();
// 2. Cek apakah stok masih cukup
if ($barang->stok < $request->qty) {
throw new Exception("Maaf, stok barang baru saja habis terjual!");
}
// 3. Hitung total harga MURNI DI SERVER (Jangan percaya angka dari browser!)
$totalHarusDibayar = $barang->harga_jual * $request->qty;
// 4. Potong stok & catat transaksi dengan aman
DB::table("barang")->where("id", $barang->id)->decrement("stok", $request->qty);
DB::table("transaksi")->insert([
"barang_id" => $barang->id,
"qty" => $request->qty,
"total_harga" => $totalHarusDibayar,
"created_at" => now()
]);
return response()->json(["status" => "sukses", "total" => $totalHarusDibayar]);
});
}
📊 Workflow 4: Cara Kerja "lockForUpdate()" Mencegah Stok Minus Saat 2 Kasir Klik Bersamaan
5. Tabel Checklist Wajib Sebelum Aplikasi Kasir / Keuangan Dipakai
| Bagian Sistem | ❌ Kebiasaan Buruk (Rawan Selisih) | ✅ Standar Aman (Anti-Selisih) |
|---|---|---|
| Perhitungan Harga & Diskon | Dihitung di JS Browser lalu dikirim ke DB | Wajib dihitung ulang di PHP Controller dari harga DB |
| Tipe Kolom Rupiah di MySQL | Pakai FLOAT / DOUBLE (Rawan koma aneh) |
Pakai BIGINT atau DECIMAL(15,2) |
| Simpan Banyak Tabel Sekaligus | Insert satu-satu tanpa pelindung | Bungkus dengan DB::transaction() |
| Potong Stok Barang / Saldo | Langsung kurangi tanpa kunci baris | Gunakan lockForUpdate() & decrement() |
| Jejak Audit (Shift / Log) | Data lama langsung ditimpa / dihapus permanen | Catat di tabel mutasi_stok / log_kasir |
📌 Pesan Penutup MasAnam:
Membangun aplikasi yang berhubungan dengan uang amanah warga, SHU koperasi, maupun stok barang toko membutuhkan disiplin arsitektur: Gunakan Browser (HTML + Vanilla JS) murni sebagai etalase tampilan yang cepat dan interaktif, tetapi serahkan 100% wewenang perhitungan uang dan penguncian stok kepada mesin Backend (Laravel + MySQL)! Dengan menerapkan rumus di sisi server, DB::transaction, dan lockForUpdate, Anda bisa tidur nyenyak karena laporan keuangan dijamin akurat setiap saat.