v1.6.0 - The SaaS & Loyalty Evolution 🚀

v1.6.0 - SaaS Architecture, Super Admin & Loyalty System

Versi v1.6.0 adalah milestone terbesar LaraCarte yang mengubah sistem dari aplikasi restoran tunggal menjadi platform SaaS (Software as a Service) yang matang. Pembaruan ini memperkenalkan arsitektur Multi-Tenancy, modul Super Admin yang kuat, serta sistem loyalitas pelanggan yang terintegrasi penuh.

---

🚀 Fitur Baru & Perubahan Besar

🏢 Arsitektur SaaS (Multi-Tenancy)

• Single Database Multi-Tenancy: Implementasi isolasi data otomatis sehingga satu instalasi dapat menangani ribuan tenant (restoran) secara aman.
• Tenant Scoping: Penanganan otomatis tenant_id pada seluruh model bisnis (Produk, Order, Stok, dll).
• Unique Merchant Slugs: Akses halaman menu yang dipersonalisasi untuk setiap restoran (contoh: app.com/menu/restoran-a).

👑 Modul Super Admin (Platform Governance)

• Financial & Analytics Dashboard: Pantau performa finansial seluruh ekosistem dalam satu tampilan terpusat.
• Tenant Management: Kontrol penuh untuk aktivasi, suspensi, dan monitoring merchant.
• Direct Impersonation: Fitur login sebagai Owner untuk dukungan teknis instan tanpa perlu meminta kredensial pengguna.

🎁 Sistem Loyalitas & Keanggotaan

• Membership Cardless: Pendaftaran member otomatis hanya menggunakan nomor WhatsApp saat checkout.
• Flexible Point Logic: Konfigurasi rasio perolehan poin dan nilai tukar poin yang dapat disesuaikan per tenant.
• Direct Point Redemption: Fitur potong harga otomatis menggunakan poin loyalitas langsung di halaman checkout.

👨‍🍳 Operasional & KDS

• Real-time Engine (Laravel Reverb): Sinkronisasi instan antara pesanan pelanggan, dashboard kasir, dan monitor dapur.
• Low Stock Alerts: Notifikasi otomatis kepada owner saat bahan baku resep mencapai ambang batas minimum.

---

🛠️ Perbaikan & Optimasi

• RBAC Refinement: Perbaikan logika middleware untuk mendukung multi-role (Kitchen, Cashier, Waiter) dalam konteks tenant.
• Dashboard Cleanup: Menghilangkan error "property on null" saat Super Admin mengakses dashboard umum.
• Database Seeding: Penambahan seeder yang lebih kaya untuk pengujian skenario SaaS yang kompleks.

---

📘 Dokumentasi Baru

Kami telah menambahkan berkas administratif lengkap untuk standarisasi repositori:

• 📄 LICENSE (MIT)
• 🤝 CONTRIBUTING.md & CODE_OF_CONDUCT.md
• 🚀 DEPLOY.md (Panduan VPS, Supervisor, & SSL)
• 🛡️ SECURITY.md (Kebijakan pelaporan kerentanan)
• 📜 CITATION.cff

---

📦 Cara Update

Jalankan perintah berikut di terminal server Anda untuk memperbarui sistem:

# 1. Tarik perubahan terbaru
git pull origin main

# 2. Install dependensi (Backend & Frontend)
composer install && npm install

# 3. Jalankan migrasi database
php artisan migrate

# 4. Build assets
npm run build

# 5. Restart Reverb (Untuk Real-time)
php artisan reverb:start

v1.3.0 - Enterprise Features: Automated Payments, Recipe Inventory & Loyalty System

v1.3.0 - Enterprise Features: Automated Payments, Recipe Inventory & Loyalty System

Release Description

🌟 Fitur Utama (New Features)

• 💳 Integrasi Midtrans Snap: Pembayaran otomatis via QRIS, E-Wallet, dan VA dengan verifikasi instan melalui Webhook (Status pesanan otomatis berubah jadi Paid).
• 🥦 Manajemen Resep (Ingredients): Sistem inventaris bahan baku. Stok bahan mentah (gram, ml, butir) akan terpotong secara otomatis setiap kali menu terjual berdasarkan resep yang diatur.
• 🎁 CRM & Loyalty Program: Sistem member berbasis nomor WhatsApp. Pelanggan mendapatkan poin otomatis di setiap transaksi yang dapat digunakan untuk meningkatkan loyalitas.
• 🏷️ Promo & Diskon Otomatis: Admin dapat membuat aturan diskon (persentase/nominal) yang akan diterapkan sistem secara otomatis jika syarat minimal belanja terpenuhi.
• 💵 Cash Shift Management: Kontrol keuangan kasir lebih ketat dengan fitur Buka Shift (Modal Awal) dan Tutup Shift (Rekonsiliasi Uang Fisik vs Sistem).
• 🛎️ Expo / Runner Screen: Layar khusus untuk staf pelayan agar makanan yang sudah jadi di dapur dapat segera diantar ke meja pelanggan dengan efisien.
• 🖥️ Kiosk Tablet Mode: Tampilan antarmuka yang dioptimalkan khusus untuk perangkat tablet (Self-Order Kiosk).
• 📱 WhatsApp Digital Receipt: Fitur pengiriman struk belanja digital langsung ke nomor WhatsApp pelanggan melalui link dinamis.

🛠️ Perbaikan & Peningkatan

• Branding Baru: Pembaruan logo LaraCarte di seluruh sistem (Favicon, Login, Sidebar, dan Layout).
• UI Dashboard: Widget statistik baru untuk memantau "Stok Menipis" dan "Produk Terlaris Hari Ini".
• Fix Syntax Errors: Perbaikan rute yang konflik dan masalah null pointer pada format tanggal shift.
• Security: Penambahan pengecekan CSRF khusus untuk endpoint Webhook Midtrans.

---

Ver.1.4.0. Production Ready: Real-time KDS, Thermal Printing & Advanced Reports

Release Notes: Real-time KDS, Printing & Advanced Reporting 🚀

Update ini menghadirkan fitur Real-time untuk dapur, dukungan printer thermal, serta laporan keuangan yang lebih komprehensif.

🚀 Fitur Baru (Major Features)

🍳 Real-time Kitchen Display System (KDS)

• Integrasi Laravel Reverb (WebSocket): Pesanan masuk secara instan di layar dapur tanpa perlu refresh halaman manual.

🖨️ Thermal Printing Support

• Direct Print (ESC/POS): Dukungan cetak langsung ke printer thermal dari sisi server.
• Popup Print: Desain struk 58mm yang rapi via browser popup.

📊 Laporan & Analitik Lanjutan

• Export Excel (.xlsx): Download data transaksi lengkap untuk audit.
• Export PDF: Download laporan penjualan siap cetak.
• Filter Dinamis: Filter tanggal kustom untuk grafik dan ringkasan omzet.

⚙️ Pengaturan Toko Dinamis

• Admin Settings: Halaman admin baru untuk mengubah Nama Toko, Alamat, Pajak (%), dan Service Charge (%) tanpa menyentuh kodingan.

📱 Generator QR Code Meja

• Table QR: Cetak kartu meja profesional dengan QR Code unik untuk pemesanan mandiri pelanggan.

---

⚡ Optimasi Performa

• SPA Mode: Implementasi wire:navigate membuat navigasi Admin Panel terasa instan (seperti aplikasi native).
• Database Indexing: Penambahan index pada kolom krusial (status, created_at) untuk query yang jauh lebih cepat.
• Lazy Loading: Optimasi pemuatan gambar produk di halaman pelanggan.

🛠️ Perbaikan & Refactoring

• Route Cleanup: Merapikan struktur routes/web.php dengan grup prefix /admin.
• Stock Logic: Verifikasi dan perbaikan logika pengurangan stok otomatis saat pesanan dibuat/dibayar.
• UI/UX: Standardisasi tampilan menggunakan Tailwind CSS dan ikon Heroicons.

---

🚀 v1.3.0 - Inventory System, Tax Calculation & QRIS Integration

v1.3.0 - Inventory System, Tax Calculation & QRIS Integration 🚀

Rilis ini membawa pembaruan besar pada sisi operasional dan finansial restoran, mengubah aplikasi dari sekadar pencatat pesanan menjadi sistem manajemen restoran (POS) yang siap pakai.

✨ Fitur Utama (Key Features)

📦 Manajemen Stok & Inventaris (Inventory)

• Real-time Stock Tracking: Menambahkan kolom stock dan min_stock pada produk.
• Auto-Decrement: Stok otomatis berkurang saat pesanan diproses di Dapur (Served) atau dibayar di Kasir (Paid).
• Low Stock Alert: Indikator visual stok menipis (merah/berkedip) di Admin Panel dan halaman Pelanggan ("Sisa X porsi").
• Stock Validation: Mencegah pelanggan memesan melebihi stok yang tersedia.

💸 Kalkulasi Pajak & Service (Financial)

• Automated Calculation: Sistem otomatis menghitung rincian biaya:
  • Subtotal (Harga Item)
  • Service Charge (5%)
  • PB1 / PPN (11%)
• Grand Total Accuracy: Pembulatan dan perhitungan total yang presisi untuk struk pembayaran.

📱 Integrasi Pembayaran QRIS (Manual Verification)

• Multi-Payment Method: Pelanggan dapat memilih opsi "Bayar di Kasir" atau "Scan QRIS" langsung dari meja.
• QR Display: Modal checkout menampilkan kode QR toko untuk memudahkan transfer.
• Cashier Workflow:
  • Indikator khusus "Via QRIS" pada daftar pesanan masuk.
  • Tombol konfirmasi pembayaran satu-klik (Payment Received) setelah kasir memverifikasi mutasi.

💅 Peningkatan UI/UX

• Fixed Checkout Modal: Header dan Footer modal checkout sekarang bersifat fixed, mencegah tombol "Kirim Pesanan" tertutup konten pada layar HP kecil.
• Thermal Receipt Printing: Cetak struk menggunakan metode iframe sehingga halaman tidak perlu reload setelah mencetak.
• Payment Badges: Visualisasi status pembayaran yang lebih jelas di tabel kasir.

⚙️ Perubahan Database (Migrations)

Update ini memerlukan perubahan skema database:

• products: Penambahan kolom stock (int) dan min_stock (int).
• orders: Penambahan kolom payment_method (string), subtotal (decimal), tax_amount (decimal), service_charge (decimal).

🚀 Cara Update (Upgrade Guide)

Jika Anda melakukan update dari versi v1.2.0, jalankan perintah berikut di terminal:

# 1. Update struktur database
php artisan migrate

# 2. Bersihkan cache view (untuk memperbarui tampilan modal & struk)
php artisan view:clear

🚀 LaraCarte v1.2.0 — POS, Kitchen Display & Reporting System

🎉 What's New in This Release?

This update brings LaraCarte to a fully functional Restaurant Management System, completing the loop from Customer Ordering -> Kitchen Processing -> Cashier Payment.

💻 1. Point of Sales (POS) / Kasir

• New Cashier Interface: Dedicated page for cashiers to manage incoming orders.
• Payment Processing: Calculate total, input payment amount, and auto-calculate change (kembalian).
• Status Management: Orders marked as Served (from Kitchen) are ready for payment. Once paid, status updates to Paid (Lunas).

🖨️ 2. Thermal Receipt Printing

• 58mm Thermal Support: Optimized CSS layout for standard thermal printers.
• Seamless Printing: Implemented Iframe Printing Technique, allowing receipts to be printed without reloading the page or losing state.
• Invoice Details: Includes Order ID, Time (WIB), Table, Items, and Total.

👨‍🍳 3. Kitchen Display System (KDS)

• Real-time Monitoring: Kitchen staff can see orders instantly via Livewire Polling.
• Workflow Status:
  • Pending (Red): New order.
  • Cooking (Orange): Chef starts cooking.
  • Served (Blue): Food is ready & served to table.
• Visual Indicators: Clear color-coded cards for different order statuses.

📊 4. Reports & Analytics

• Transaction History: specific page for "Paid" orders with Date & Search filters.
• CSV Export: Added ability to download daily/filtered sales reports as .csv files for accounting.
• Dashboard Stats: Quick view of Total Revenue and Transaction Counts.

🐛 Fixes & Improvements

• Timezone Fix: Forced application timezone to Asia/Jakarta (WIB) for accurate reporting and receipt timestamps.
• Search Optimization: Added .debounce to search inputs to reduce server load.
• UI/UX: Improved badges visibility and responsive table layouts.

---

📦 How to Update

1. Pull the latest changes: git pull origin main
2. Run migrations (if fresh install): php artisan migrate:fresh --seed
3. Clear config cache (for timezone fix): php artisan config:clear

v1.0.0 - Initial Release

LaraCarte v1.0.0 🚀

Modern Restaurant Management System (Self-Order & Kitchen Display)

LaraCarte adalah aplikasi manajemen restoran end-to-end yang memungkinkan pelanggan memesan makanan langsung dari meja mereka menggunakan QR Code, tanpa perlu memanggil pelayan.

Fitur Unggulan:

• 📱 Customer Self-Order: Tampilan mobile-app native untuk pelanggan memesan menu.
• 👨‍🍳 Real-time Kitchen Display: Layar khusus dapur yang otomatis berbunyi/muncul saat pesanan masuk.
• 🖨️ POS Features: Cetak struk pembayaran dan laporan riwayat transaksi harian.
• 📊 Smart Dashboard: Pantau omzet harian, meja terisi, dan item terlaris.
• 🪑 QR Code Generator: Otomatis membuat QR Code unik untuk setiap meja baru.

Tech Stack:

• Framework: Laravel 12
• Frontend: Blade & Tailwind CSS
• Interactivity: Livewire 3 & Alpine.js
• Database: MySQL

---

Full Changelog: https://github.com/aryadians/laracarte/commits/v1.0.0