BengkelPro adalah aplikasi manajemen operasional bengkel motor dan mobil, untuk satu bengkel maupun banyak cabang. Aplikasi ini mencakup seluruh alur kerja bengkel: penerimaan kendaraan, pemeriksaan, estimasi, persetujuan pelanggan, penugasan mekanik, pemakaian suku cadang yang terhubung ke stok, tagihan, dan pembayaran. Riwayat servis setiap kendaraan juga tercatat.

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

---

✨ Keunggulan

1. Alur work order lengkap dan terkontrol
   Work order punya 7 status dengan aturan transisi yang jelas. Alurnya dimulai dari penerimaan kendaraan, lalu pemeriksaan dan estimasi. Setelah pelanggan setuju, pekerjaan dikerjakan, kemudian ditagih dan diserahkan. Pekerjaan tambahan wajib disetujui pelanggan lebih dulu.
2. Multi cabang dalam satu aplikasi
   Setiap cabang punya work order, stok, tagihan, pengeluaran, dan mekanik sendiri, sementara pelanggan, kendaraan, dan katalog dipakai bersama. Owner berpindah cabang dari sidebar atau melihat gabungan semua cabang; staf hanya melihat cabangnya. Suku cadang bisa ditransfer antar cabang, nomor dokumen memuat kode cabang, dan alamat cabang tercetak di invoice.
3. Stok terhubung langsung ke pekerjaan
   Suku cadang yang dipakai di work order otomatis memotong stok cabangnya. Semua mutasi tercatat di ledger yang tidak dapat diubah. HPP dihitung dengan harga modal rata-rata tertimbang bergerak per cabang.
4. Pendapatan sesuai uang yang diterima
   Laporan pendapatan dihitung dari pembayaran aktual, bukan total tagihan. Pembayaran bisa sebagian, dengan metode tunai, transfer, QRIS, atau kartu. Refund dan pembatalan tagihan butuh izin khusus.
5. Dashboard yang langsung bicara
   Kartu ringkasan dengan perbandingan periode sebelumnya, grafik pendapatan & work order harian, komposisi pendapatan jasa vs suku cadang, jasa terlaris, mekanik terproduktif, dan performa per cabang.
6. Tidak ada histori yang hilang
   Transaksi stok, pembayaran, dan perubahan status tidak pernah dihapus. Koreksi dilakukan dengan pembalikan, refund, atau pembatalan beralasan. Data master diarsipkan, bukan dihapus. Setiap perubahan tercatat di audit log.
7. Hak akses per tindakan
   Tersedia 5 peran bawaan: Super Admin, Owner, Service Advisor, Mekanik, dan Gudang. Setiap permission bisa diatur ulang per peran dan selalu diperiksa di backend. Mekanik hanya melihat pekerjaan yang ditugaskan kepadanya.
8. Notifikasi WhatsApp ke pelanggan (opsional)
   Kabar progres servis, invoice PDF, dan kwitansi pembayaran terkirim otomatis ke WhatsApp pelanggan. Pesan baru dianggap terkirim setelah dikonfirmasi server WhatsApp, dan panel admin memberi peringatan bila koneksi bermasalah. Baca peringatan di bawah sebelum memakainya.
9. Panduan bergambar di dalam aplikasi
   Menu Panduan berisi langkah demi langkah dengan screenshot asli, untuk semua peran.

---

🚀 Fitur & Modul

Modul	Isi
Dashboard	Kartu ringkasan dengan perbandingan periode sebelumnya, grafik area pendapatan & work order, donat komposisi pendapatan atau status work order, antrean, mekanik bertugas, stok minimum, jasa terlaris, mekanik terproduktif, performa per cabang.
Multi Cabang	Pengaturan cabang (kode, alamat, telepon), pemilih cabang di sidebar dan tampilan "Semua cabang", staf terkunci di cabangnya, stok & mekanik per cabang, transfer stok antar cabang, nomor dokumen berkode cabang (WO-PST-...), alamat cabang di cetakan.
Work Order	Penerimaan kendaraan (sekaligus daftar pelanggan/kendaraan baru), checklist pemeriksaan dengan foto, estimasi jasa & suku cadang, persetujuan pelanggan, penugasan beberapa mekanik, cetak/PDF bukti penerimaan.
Inventaris	Stok dan harga modal per cabang, ledger mutasi stok, penerimaan barang, pengeluaran & pengembalian barang untuk work order, penyesuaian stok beralasan, transfer stok antar cabang, peringatan stok minimum.
Tagihan & Pembayaran	Tagihan dari item yang disetujui, diskon berizin, pajak yang dapat dikonfigurasi, pembayaran sebagian, refund, cetak/PDF invoice.
WhatsApp	Notifikasi otomatis (kendaraan diterima, estimasi siap, mulai dikerjakan, menunggu suku cadang, selesai, diserahkan), invoice PDF, kwitansi pembayaran, tombol Kirim WA manual, template pesan yang bisa diubah, riwayat pesan, cek kesehatan otomatis, tombol sambung ulang & kirim ulang.
Data Master	Pelanggan (banyak kendaraan), kendaraan (cari nomor polisi, riwayat servis), mekanik, katalog jasa & suku cadang.
Pengeluaran	Biaya operasional per kategori dengan bukti transaksi.
Laporan	Pendapatan, work order, jasa, mekanik, pemakaian suku cadang, stok, penjualan suku cadang (HPP & margin), piutang, pengeluaran, kendaraan. Filter periode dan cabang, ekspor CSV (Excel) dan PDF.
Sistem	Role & permission, pengguna, menu dinamis, pengaturan bengkel (identitas, logo, pajak), audit log, mode gelap.

---

💬 Notifikasi WhatsApp (Baileys)

Pesan dikirim lewat layanan kecil whatsapp-gateway/ (Node.js) yang ikut di source code. Gateway bisa dijalankan dengan Docker atau PM2, lalu nomor disambungkan 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 bengkel.
• 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.
• Pesan hanya dikirim ke pelanggan yang dicentang setuju menerima notifikasi.
• Ada jeda acak antar pesan dan batas pesan per hari.
• Semua pesan dan status pengirimannya tercatat.

Pengaman dari "gagal diam-diam" (koneksi tampak tersambung, tetapi pesan tidak sampai):

• Pesan baru dianggap terkirim setelah server WhatsApp mengonfirmasi. Tanpa konfirmasi, koneksi disambung ulang dan pesan dicoba lagi hingga 5 kali.
• Watchdog memeriksa koneksi tiap 3 menit, dan koneksi disambung ulang otomatis setiap hari tanpa pindai QR.
• Cek kesehatan tiap 5 menit menampilkan banner peringatan di panel admin bila gateway mati, nomor terputus, atau pesan tertahan.
• Tombol Sambung ulang dan Kirim ulang pesan gagal di halaman Pengaturan › WhatsApp.

Fitur ini sepenuhnya opsional. BengkelPro tetap berjalan normal tanpa gateway WhatsApp.

---

💻 Kebutuhan Sistem

• PHP 8.4+ (ekstensi bcmath, gd, mbstring, pdo_mysql, dll.)
• Composer 2.2+
• Node.js 20.19+ atau 22.12+ (build aset dan gateway WhatsApp)
• MySQL 8.0+ atau MariaDB 10.6+
• Nginx atau Apache, atau Docker (tersedia Dockerfile dan docker-compose.prod.yml)

⚙️ Instalasi Singkat

composer install
npm install
cp .env.example .env
php artisan key:generate
php artisan migrate --seed
php artisan storage:link
php artisan app:demo-data   # opsional: data contoh realistis, 2 cabang
composer dev

Panduan production (Nginx, Supervisor, cron, HTTPS, Docker) dan backup tersedia lengkap di folder docs/. Mode APP_ENV=demo membuat aplikasi hanya-baca untuk demo publik.

Update dari versi sebelumnya: php artisan migrate --force lalu php artisan db:seed --force. Data lama otomatis masuk ke cabang "Cabang Utama".

🔑 Akun Demo (lokal)

Peran	Email	Password
Super Admin	superadmin@example.com	password
Owner (semua cabang)	owner@example.com	password
Service Advisor	advisor@example.com	password
Advisor Cabang Bekasi	advisor.bekasi@example.com	password
Mekanik	mekanik@example.com	password
Gudang	gudang@example.com	password

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.

• Lisensi disimpan sebagai file, bukan di database. 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 dengan kode yang sama.
• Satu lisensi berlaku untuk satu instalasi, berapa pun jumlah cabangnya.
• Pindah domain: hubungi RadhCloud untuk reset lisensi.

---

✅ Kualitas Kode

• 241 tes otomatis (Pest) untuk alur work order, stok, multi cabang & transfer, tagihan, laporan, hak akses, lisensi, mode demo, dan WhatsApp (termasuk cek kesehatan dan kirim ulang).
• Uang memakai DECIMAL dan dihitung dengan bcmath di server.
• Semua perubahan bisnis berjalan di service layer dengan transaksi database dan penguncian baris.