LaundryFlow adalah aplikasi manajemen operasional laundry untuk UMKM, untuk satu outlet maupun banyak cabang. Aplikasi ini mencakup seluruh alur kerja laundry:

• penerimaan cucian kiloan dan satuan dengan harga yang dihitung otomatis;
• papan pengerjaan per tahap;
• pembayaran DP dan cicilan;
• nota siap cetak;
• notifikasi WhatsApp ke pelanggan;
• laporan pendapatan.

Yang Anda beli adalah source code lengkap, bukan langganan. Pasang di server dan domain Anda sendiri, bayar sekali, dan data laundry tetap milik Anda.

Dibangun dengan Laravel 13, Inertia.js 2, Vue 3 (TypeScript), dan Tailwind CSS sebagai satu aplikasi monolit yang mudah dipasang dan dikembangkan.

---

✨ Keunggulan

1. Order cepat, harga otomatis
   • Pilih pelanggan dan layanan, lalu isi berat atau jumlah.
   • Harga kiloan dihitung dengan minimal berat. Diskon, biaya tambahan, DP, dan estimasi selesai juga dihitung otomatis.
   • Simpan & Cetak Nota langsung ke printer thermal 58/80 mm atau A4.
2. Papan pengerjaan yang jelas
   • Setiap tahap punya kolom sendiri, dari diterima sampai siap diambil.
   • Kartu dipindah dengan seret-lepas atau tombol lanjut.
   • Order express dan order yang lewat estimasi langsung terlihat.
   • Tahap bisa diaktifkan, dimatikan, dan diganti namanya.
3. Multi cabang dalam satu aplikasi
   • Setiap cabang punya order, kas, dan papan pengerjaan sendiri. Pelanggan dan layanan dipakai bersama.
   • Tarif khusus bisa diatur per cabang. Nomor order memuat kode cabang.
   • Cucian bisa diambil dan dilunasi di cabang lain.
   • Owner bisa melihat gabungan semua cabang.
4. Kas yang tidak bisa diubah diam-diam
   • Pembayaran bisa tunai, transfer, atau QRIS, dengan DP, cicilan, dan refund.
   • Pembatalan dicatat sebagai catatan pembalik, bukan dengan menghapus data.
   • Order yang sudah dibayar tidak bisa dihapus.
5. Notifikasi WhatsApp ke pelanggan (opsional)
   • Pelanggan dikabari otomatis saat order diterima, siap diambil, pembayaran diterima, dan cucian diserahkan.
   • Pesan baru dianggap terkirim setelah dikonfirmasi server WhatsApp. Owner diberi tahu bila koneksi bermasalah.
   • Baca peringatan di bawah sebelum memakainya.
6. Dashboard & laporan yang langsung bicara
   • Dashboard: order hari ini, cucian siap diambil, pemasukan harian dan bulanan, tagihan belum lunas, dan tren 14 hari.
   • Laporan per metode bayar, layanan terlaris, dan pelanggan teratas, dengan ekspor CSV.
7. Hak akses per tindakan
   • Tersedia 3 peran bawaan: Owner, Kasir, dan Operator. Permission bisa diatur ulang per peran.
   • Hak akses selalu diperiksa di server. Operator tidak melihat angka uang di dashboard.
8. Panduan bergambar di dalam aplikasi
   • Menu Panduan berisi langkah demi langkah dengan screenshot asli.

---

🚀 Fitur & Modul

Modul	Isi
Dashboard	Order hari ini, menunggu, diproses, siap diambil, lewat estimasi, pemasukan harian/bulanan, tunggakan, tren 14 hari, status cucian berjalan
Buat Order	Cari/tambah pelanggan atau pelanggan umum, layanan kiloan & satuan, biaya tambahan, diskon (Rp/%), DP, estimasi otomatis, express, Simpan & Cetak Nota
Papan Pengerjaan	Kolom per tahap, seret-lepas, tombol lanjut, penanda express & terlambat
Order Laundry	Filter status/tanggal/pembayaran, detail, riwayat status (siapa & kapan), pembatalan beralasan, cetak ulang nota
Pembayaran	Tunai/transfer/QRIS, DP, cicilan, refund, pembatalan dengan catatan pembalik, wajib lunas saat diambil (opsional)
Multi Cabang	Outlet dengan kode, alamat & telepon nota, tarif per cabang, order/kas/papan per cabang, ambil & lunasi lintas cabang, perbandingan cabang
Pelanggan	Data, riwayat order, total transaksi, tagihan, persetujuan notifikasi WhatsApp
Layanan & Tarif	Kiloan & satuan, minimal berat, estimasi jam, express, aktif/nonaktif, harga tersimpan sebagai snapshot per order
Laporan	Pemasukan vs nilai order, per metode, per status, layanan terlaris, pelanggan teratas, tunggakan, ekspor CSV
WhatsApp	Notifikasi otomatis 4 peristiwa, template pesan, jeda acak & batas harian, kirim tes, riwayat pesan, kirim ulang, sambung ulang, cek kesehatan otomatis, tombol wa.me manual
Sistem	Pengguna, role & permission, menu dinamis, pengaturan usaha (logo nota, zona waktu, prefix nomor, tahapan, ukuran nota), audit log, notifikasi lonceng, mode gelap

---

💬 Notifikasi WhatsApp (Baileys)

Pesan dikirim lewat layanan kecil whatsapp-gateway/ (Node.js) yang ikut di dalam source code. Jalankan gateway dengan PM2, lalu sambungkan nomor dengan memindai QR dari HP di menu Pengaturan › WhatsApp.

⚠️ Peringatan penting

Gateway memakai Baileys, pustaka tidak resmi yang meniru WhatsApp Web. Cara ini melanggar Ketentuan Layanan WhatsApp. Akibatnya, nomor pengirim bisa diblokir sementara atau permanen kapan saja, tanpa peringatan.

• Gunakan nomor khusus untuk notifikasi, bukan nomor utama laundry.
• Jangan dipakai untuk promosi, broadcast, atau pesan massal.
• Untuk kebutuhan resmi atau volume besar, gunakan WhatsApp Business Platform (Cloud API) dari Meta.
• Risiko pemakaian sepenuhnya ditanggung pembeli.

Pengaman bawaan:

• WhatsApp mati secara default dan baru bisa diaktifkan setelah Owner mencentang pernyataan risiko.
• Pelanggan bisa menolak notifikasi lewat data pelanggan.
• Ada jeda acak antar pesan dan batas pesan per hari.
• Semua pesan dan status pengirimannya tercatat.
• Pesan dianggap terkirim hanya setelah server WhatsApp mengonfirmasi. Koneksi dipantau watchdog, disambung ulang otomatis setiap hari tanpa pindai QR, dan dicek tiap 5 menit. Owner mendapat notifikasi bila ada masalah.

Fitur ini sepenuhnya opsional. LaundryFlow tetap berjalan normal tanpa gateway, dan tombol WhatsApp manual (wa.me) tetap tersedia.

---

💻 Kebutuhan Sistem

• PHP 8.4+ dengan ekstensi bcmath, pdo_mysql, mbstring, xml, curl, dan fileinfo
• Composer 2
• MySQL 8.0+. SQLite bisa dipakai untuk uji coba lokal.
• Node.js 20.19+ atau 22.12+: untuk build ulang aset dan gateway WhatsApp. Aset siap pakai (public/build) sudah disertakan.
• Nginx atau Apache

⚙️ Instalasi Singkat

composer install
npm install
cp .env.example .env
php artisan key:generate
php artisan migrate --seed
php artisan storage:link
npm run build
php artisan serve

Panduan production (Nginx, PHP-FPM, Supervisor, cron, HTTPS) dan backup tersedia lengkap di folder docs/. Di production, php artisan laundryflow:install membuat usaha dan akun Owner pertama. Mode APP_ENV=demo membuat aplikasi hanya-baca untuk demo publik.

🔑 Akun Demo (lokal)

Peran	Email	Password
Owner	owner@laundryflow.test	password
Kasir	kasir@laundryflow.test	password
Operator	operator@laundryflow.test	password
Kasir Cabang Antapani	kasir.antapani@laundryflow.test	password

Data demo berisi 2 cabang, 8 layanan, 40 pelanggan, dan ±120 order. Akun demo tidak dibuat bila APP_ENV=production.

---

🔐 Lisensi

Setelah pembelian, Anda mendapat kode lisensi RL-XXXX-XXXX-XXXX-XXXX di halaman Unduhan akun RadhCloud dan di email pembelian. Kode dimasukkan sekali saat aplikasi pertama dibuka. Internet hanya dibutuhkan saat aktivasi.

• Satu lisensi berlaku untuk satu domain produksi, berapa pun jumlah cabangnya.
• Source code boleh diubah untuk kebutuhan Anda, tetapi tidak boleh dijual ulang atau dibagikan. Ketentuan lengkap ada di LICENSE.md.
• Lisensi disimpan sebagai file, bukan di database, jadi migrate:fresh atau key:generate tidak menghapusnya.
• File lisensi bisa diunduh sebagai cadangan dan dipulihkan di server baru. Install ulang di domain yang sama cukup memakai kode yang sama.
• Untuk pindah domain, hubungi RadhCloud agar lisensi direset.

---

✅ Kualitas Kode

• 224 tes otomatis (Pest) mencakup:
  • kalkulasi harga, transisi status, pembayaran & pembatalan;
  • multi cabang, isolasi data antar usaha, hak akses, laporan, lisensi;
  • WhatsApp, termasuk cek kesehatan dan kirim ulang.
• Uang disimpan sebagai DECIMAL dan dihitung di server.
• Semua perubahan bisnis berjalan di service layer, dengan transaksi database dan penguncian baris.