Panduan — Laundry Management System

Langkah 1 — Satu kali saja

Setup Aplikasi

Buka folder project

Buka Windows Explorer, masuk ke folder Laundry tempat file-file aplikasi berada.

📁 Pastikan Anda melihat file setup.bat, start.bat, dan folder backend di dalamnya.

Jalankan setup.bat

Klik dua kali pada file setup.bat. Sebuah jendela hitam akan muncul — itu normal.

Anda akan diminta mengisi beberapa informasi database:

Username PostgreSQL → ketik: postgres (lalu Enter)

Password PostgreSQL → ketik password yang Anda buat saat install

Port → tekan Enter langsung (default: 5432)

Nama Database → tekan Enter langsung (default: laundry_db)

⏳ Proses ini memakan waktu 1–3 menit untuk mengunduh dependensi. Tunggu hingga muncul tulisan "SETUP SELESAI!"

Setup selesai!

Jika berhasil, Anda akan melihat pesan seperti ini di layar:

✓ SETUP SELESAI!
Login: admin@laundry.com / admin123

Setup cukup dilakukan sekali. Lain kali langsung gunakan start.bat saja.

Referensi

Ringkasan Fitur

📊

Dashboard

Omset hari ini & bulan ini, grafik penjualan, top pelanggan, transaksi terbaru.

🧾

Transaksi

Invoice otomatis, multi-layanan, diskon persen/nominal, voucher, pajak inclusive/exclusive.

💳

Pembayaran

Cash, Transfer, QRIS, E-Wallet. Bayar sebagian (hutang) & bayar bertahap.

📋

Piutang

Pantau hutang pelanggan, jatuh tempo, umur piutang, dan pembayaran parsial.

👥

Pelanggan

Tipe Cash / Hutang / Corporate. Membership Silver, Gold, Platinum. Riwayat transaksi.

🏢

Multi Cabang

Kelola beberapa cabang sekaligus. Laporan per cabang dan konsolidasi.

🏷️

Voucher

Buat kode diskon persen atau nominal, atur minimum transaksi dan kuota penggunaan.

📈

Laporan

Laporan penjualan, piutang, per cabang, per pegawai. Export Excel & PDF.

📦

Manajemen Stok

Kelola bahan baku & perlengkapan: stok masuk, keluar, koreksi, alert stok kritis.

🔍

Audit Trail

Catat semua perubahan: login, edit, hapus, void — lengkap dengan siapa dan kapan.

Status Progres Laundry

Diterima

→

Dicuci

→

Dikeringkan

→

Disetrika

→

Packing

→

Selesai

→

Diambil

Modul Tambahan

Manajemen Stok Bahan & Perlengkapan

Modul ini untuk mencatat keluar-masuk bahan cuci, packaging, dan peralatan laundry — sehingga Anda tahu kapan harus beli stok lagi sebelum habis.

Langkah 1 — Aktifkan Modul Stok (Sekali Saja)

Jalankan migrate_stock.bat

Klik dua kali pada file migrate_stock.bat di folder Laundry. File ini akan membuat tabel-tabel stok di database.

✅ Tunggu muncul pesan "Migrasi stok selesai!" di layar. Cukup jalankan sekali — tidak perlu diulang.

⚠️ Pastikan server tidak sedang berjalan (tutup dulu via stop.bat), lalu jalankan migrate_stock.bat, baru start.bat lagi.

Menu Stok muncul di sidebar

Setelah migrasi berhasil dan server distart ulang, menu 📦 Stok akan muncul di sidebar kiri aplikasi di bawah bagian "Operasional".

Langkah 2 — Setup Item Stok Pertama Kali

Setup Awal

1

Buka menu Stok → tab Kategori. Sudah ada 3 kategori bawaan: Bahan Cuci, Packaging, Peralatan. Tambah atau edit sesuai kebutuhan.
2

Klik tombol Tambah Item → isi nama item, kategori, satuan (kg/liter/pcs/botol…), stok minimum, dan stok awal.
3

Isi Stok Minimum — ini batas peringatan. Jika stok turun ke angka ini atau di bawahnya, sistem akan menampilkan alert merah.

Operasional Harian

4

Saat beli bahan baru → tab Stok Masuk → pilih item → isi jumlah dan harga beli → Simpan.
5

Saat pakai bahan operasional → tab Stok Keluar → pilih item → isi jumlah pemakaian → Simpan.
6

Saat stock opname bulanan → tombol koreksi (✏️) di baris item → isi jumlah aktual yang ada.

Penjelasan Tab-Tab di Menu Stok

📋

Daftar Stok

Lihat semua item stok beserta status (Aman / Rendah / Kritis / Habis). Kode warna: hijau = aman, kuning = rendah, merah = kritis/habis.

➕

Stok Masuk

Catat pembelian bahan baru. Isi supplier dan harga beli agar nilai stok tercatat akurat.

➖

Stok Keluar

Catat pemakaian bahan. Sistem cek otomatis agar stok tidak bisa minus. Ada peringatan jika stok mendekati minimum.

📜

Riwayat

Semua transaksi masuk-keluar tercatat lengkap: waktu, jumlah, siapa yang input, stok sebelum & sesudah.

🏷️

Kategori

Kelompokkan item stok (hanya Manager ke atas). Kategori memudahkan pencarian dan filter laporan stok.

Arti Warna Status Stok

🟢 Aman Stok di atas 1,5× batas minimum — kondisi normal.

🟡 Rendah Stok antara 1× dan 1,5× minimum — pertimbangkan pembelian segera.

🔴 Kritis Stok di bawah atau sama dengan batas minimum — segera beli!

🔴 Habis Stok = 0. Tampil sebagai alert di bagian atas halaman Stok dan Dashboard.

💡 Tips: Isi kolom Stok Minimum sesuai kebutuhan operasional minimal satu minggu. Misalnya jika dalam seminggu butuh 5 kg detergen, isi minimum = 5. Dengan begitu sistem bisa peringatkan Anda seminggu sebelum stok habis.

Pembaruan v1.2

Fitur Terbaru

📱

Tampilan Responsif

Aplikasi kini bekerja di smartphone dan tablet. Di layar kecil, sidebar bisa dibuka/ditutup dengan tombol ☰ (hamburger) di pojok kiri atas. Tabel digeser secara horizontal. Semua form dan modal menyesuaikan layar.

🦷

Print via Bluetooth

Di halaman invoice, tombol 🦷 Bluetooth memungkinkan cetak langsung ke printer thermal BLE (58mm/80mm) tanpa driver. Format ESC/POS dikirim otomatis. Gunakan Chrome atau Edge — belum tersedia di Firefox/Safari.

Cara pakai: Klik 🦷 Bluetooth → pilih printer dari daftar → cetak otomatis. Pastikan Bluetooth laptop aktif.

🚫

Batalkan Transaksi

Role Admin / Owner / Manager dapat membatalkan transaksi langsung dari daftar transaksi (tombol ✕ merah) atau dari halaman detail (tombol Void). Pembatalan memerlukan alasan yang wajib diisi.

⚠️ Perhatian: Pembatalan permanen dan tidak bisa dibatalkan. Hutang terkait akan otomatis ditutup.

↩️

Pengembalian Stok Otomatis

Jika saat transaksi ada stok yang dikeluarkan dan dicatat terhubung ke nomor transaksi tersebut, membatalkan transaksi akan mengembalikan stok secara otomatis. Riwayat pengembalian tercatat di tab Riwayat Stok.

Catatan: Jalankan migrate_void_stock.bat sekali untuk mengaktifkan fitur ini.

Manajemen Akses

Role & Hak Akses Pegawai

Setiap pegawai diberikan satu role. Role menentukan menu apa yang bisa diakses dan aksi apa yang boleh dilakukan.

Super Admin Owner

Akses penuh ke semua fitur, semua cabang, termasuk hapus data dan konfigurasi sistem.

Owner Owner

Sama seperti Super Admin kecuali beberapa pengaturan sistem tingkat lanjut.

Manager Manajemen

Kelola operasional cabang: transaksi, pegawai cabang, layanan, laporan cabang.

Akuntan Manajemen

Lihat dan export semua laporan keuangan, piutang, audit trail. Tidak bisa edit transaksi.

Kasir Operasional

Buat transaksi baru, terima pembayaran, update status laundry, kelola pelanggan.

Produksi Operasional

Lihat daftar transaksi dan update status proses laundry (cuci, setrika, packing).

Kurir Operasional

Update status pengambilan dan pengantaran laundry pelanggan.

Bantuan

Troubleshooting — Masalah Umum

Penyebab paling umum: Node.js atau PostgreSQL belum terinstall, atau psql belum ada di PATH Windows.

Cara cek: Buka Command Prompt (tekan Win+R → ketik cmd → Enter), lalu ketik:

node --version

psql --version

Jika salah satu gagal (muncul "'...' is not recognized"), install ulang software tersebut dan centang "Add to PATH" saat instalasi.

Artinya PostgreSQL tidak berjalan atau konfigurasi salah. Coba langkah berikut:

Buka Services Windows (Win+R → services.msc), cari postgresql-x64-XX, klik Start.
Atau cek file backend\.env — pastikan DB_PASS sesuai password PostgreSQL Anda.
Jika ragu, jalankan ulang setup.bat dan isi ulang konfigurasi.

Server belum berjalan. Pastikan jendela hitam start.bat masih terbuka dan menampilkan teks URL. Jangan tutup jendela itu selama menggunakan aplikasi.

Pastikan URL yang dibuka di browser tepat: http://localhost:3000 (bukan https, bukan localhost:8080)

Jalankan reset.bat — ini akan menghapus semua data dan membuat ulang akun admin bawaan.

⚠️ Semua transaksi dan pelanggan akan terhapus permanen. Backup data terlebih dahulu jika perlu.

Setelah reset:
Email: admin@laundry.com Password: admin123

Pastikan laptop terkoneksi internet saat menjalankan setup.bat — proses mengunduh pustaka dari internet.

Jika jaringan kantor memiliki proxy, hubungi admin IT untuk mengizinkan koneksi ke registry.npmjs.org.

Coba juga buka Command Prompt sebagai Administrator (klik kanan cmd → Run as administrator) lalu jalankan setup.bat dari sana.

Buka file backend\.env dengan Notepad, ubah baris PORT=3000 menjadi nomor lain, misalnya PORT=3001. Setelah itu akses aplikasi di http://localhost:3001.

Pastikan dua hal berikut:

Jalankan stop.bat terlebih dahulu, baru migrate_stock.bat, kemudian start.bat lagi. Jangan jalankan migrate saat server masih menyala.
Cek jendela migrate_stock.bat — pastikan muncul "Migrasi stok selesai!", bukan error. Jika ada error merah, kemungkinan password database di backend\.env tidak cocok.

Jika masih tidak muncul, coba tekan Ctrl+Shift+R (hard refresh) di browser.

Jumlah yang dimasukkan melebihi stok yang tercatat di sistem. Cek tab Daftar Stok untuk melihat angka stok saat ini yang sebenarnya.

Jika stok nyata di gudang lebih banyak dari yang tercatat di sistem (selisih karena belum diinput), gunakan fitur Koreksi Stok (tombol ✏️ di baris item) — masukkan jumlah stok aktual yang ada di gudang, sistem akan menyesuaikan otomatis.

Pastikan hal-hal berikut:

Gunakan browser Google Chrome atau Microsoft Edge terbaru. Firefox dan Safari belum mendukung Web Bluetooth.
Printer Bluetooth harus berupa BLE (Bluetooth Low Energy) — biasanya printer thermal mini (58mm/80mm). Printer Bluetooth Classic (pairing di Windows) tidak didukung oleh API ini.
Pastikan Bluetooth di laptop/komputer sudah aktif dan printer sudah menyala sebelum klik tombol.
Saat dialog muncul, pilih nama printer dari daftar (biasanya tertulis nama merek seperti "Xprinter", "Goojprt", dll.), lalu klik "Pasangkan".
Jika dialog langsung tertutup tanpa memilih, pastikan printer sudah dalam mode pairing (lampu berkedip). Coba nyalakan ulang printer.

Tombol batalkan (ikon ✕ merah) hanya muncul untuk role super_admin, owner, dan manager. Role kasir dan lainnya tidak memiliki akses membatalkan transaksi.

Jika Anda memiliki role tersebut tetapi tombol tidak muncul, coba logout dan login ulang agar sesi diperbarui.

Referensi File .bat

setup.bat

Instalasi awal. Jalankan sekali saat pertama kali.

start.bat

Jalankan setiap hari untuk membuka aplikasi.

stop.bat

Matikan server ketika selesai bekerja.

reset.bat

Reset semua data ke kondisi awal. Hati-hati!

migrate_stock.bat

Aktifkan modul stok. Jalankan sekali setelah setup awal.

migrate_void_stock.bat

Aktifkan fitur pengembalian stok saat transaksi dibatalkan. Jalankan sekali (setelah migrate_stock.bat).

Prasyarat — Apa yang Harus Dipasang Dahulu

Node.js

PostgreSQL

Browser Modern