· Inventory Management

Minimum stok per produk, dari form sampai status persediaan

Catatan Inventory Management: kolom minStock, aturan status Tersedia/Cukup/Warning/Tidak Tersedia, hitungan stok rendah di dashboard, dan ekspor laporan.

Dari angka tetap ke nilai per produk

Sebelum commit 5267ba1, dashboard menghitung produk stok rendah dengan satu angka tetap: stockQuantity < 20 untuk semua produk. Barang yang laku cepat dan barang yang jarang keluar diperlakukan sama.

Commit ini menambahkan kolom minStock Int @default(20) di model Products pada schema Prisma. Nilai bawaan tetap 20, jadi data lama tidak berubah perilaku, tetapi setiap produk sekarang bisa punya batasnya sendiri.

Validasi di API dan form

Controller produk menerima minStock saat membuat dan mengubah produk. Nilai yang bukan angka atau negatif ditolak dengan HTTP 400 dan pesan Minimum stock must be a non-negative number. Saat update, nilai dibulatkan ke bawah dan dibatasi minimal 0.

Form produk baru dan form edit punya input minStock dengan nilai awal 20. Jika input kosong atau tidak bisa di-parse, form mengirim 20.

Aturan status persediaan

Aturan ditulis di client/src/lib/stockStatus.ts dan server/src/lib/stockStatus.ts: Tersedia jika stok > minStock + 5, Tidak Tersedia jika stok < minStock − 5, Warning jika stok tepat sama dengan minStock, dan Cukup untuk kondisi di antaranya.

Konsekuensinya menarik: stok yang sedikit di bawah minimum (misalnya minStock 20, stok 17) berlabel Cukup, sama seperti stok 23. Hanya angka yang tepat sama dengan minimum yang memicu Warning. Kalau itu memang aturan bisnis yang diminta, label ini sudah sesuai; kalau tidak, ini kasus batas yang layak diuji lebih dulu.

Dashboard tidak lagi memakai count dengan angka tetap. Ia mengambil stockQuantity dan minStock semua produk lalu menghitung lewat countLowStockProducts, sehingga angka di dashboard mengikuti aturan yang sama dengan badge di tabel.

Ekspor laporan

Commit yang sama menambahkan ExportReportMenu dan client/src/lib/exportReport.ts dengan empat format: CSV, Excel (xlsx), PDF (jspdf dan jspdf-autotable), dan cetak lewat jendela browser. Menu ini dipasang di halaman inventory, produk, pembelian, pemasok, pengeluaran, kategori, dan pengguna.

Tombol ekspor yang muncul belum membuktikan isi file benar. Kolom, nilai stok, dan filter yang aktif tetap perlu dicek di file hasil unduhan.

Batas bukti

Semua fakta di atas berasal dari diff commit yang ditautkan. Belum ada screenshot runtime terverifikasi untuk halaman inventory, dan tidak ada klaim dampak bisnis dari perubahan ini.

Sumber