Dokumentasi FoodScan

📖 Pengantar

FoodScan adalah Restaurant Operating System modern all-in-one. Dari QR menu sampai laporan keuangan, satu sistem terintegrasi.

🗂️ Struktur Menu Admin

Semua menu di panel admin dikelompokkan berdasarkan alur bisnis. Setiap menu punya icon Heroicon unik dan label bahasa Indonesia.

Total: 48 Resource + 22 Custom Page = 70 menu di sidebar admin.

🚀 Setup Pertama Kali

Prasyarat

• PHP 8.2+, MySQL 8+, Composer 2+, Node 18+
• Laragon (Windows) atau LAMP/LEMP (Linux)
• Browser modern (Chrome, Edge, Firefox)

Install Dependencies

cd foodscan
composer install
npm install
cp .env.example .env
php artisan key:generate
php artisan migrate
php artisan db:seed
php artisan storage:link
php artisan filament:assets

Konfigurasi Database

Edit .env:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=sq_food_scan
DB_USERNAME=root
DB_PASSWORD=

APP_URL=http://localhost:8000
APP_LOCALE=id
APP_TIMEZONE=Asia/Jakarta

BROADCAST_CONNECTION=reverb
QUEUE_CONNECTION=database

Jalankan Server

Buka 3 terminal:

Terminal 1 — Web server:

php artisan serve

Terminal 2 — Queue worker:

php artisan queue:work

Terminal 3 — Reverb (KDS realtime):

php artisan reverb:start

🔐 Akun & Login

Akun Demo (sudah ter-seed)

URL Login

• Customer / Staff: /login — redirect otomatis ke /admin (staff) atau /account (customer)
• Admin Panel: /admin/login
• Register Customer: /register — bonus 100 poin welcome
• Lupa Password: /forgot-password

🏪 Setup Restoran

A. Edit Outlet

Sidebar 🏪 Restoran → Outlet → klik outlet → tab General:

• Nama, alamat, telepon, email
• Jam operasional per hari
• Konfigurasi pajak (PPN 11%, service 5%)
• Kategori masakan (untuk pSEO + filter)
• Logo + foto cover
• Kemampuan: dine-in, takeaway, delivery, reservasi

B. Meja + Generate QR

Sidebar 🏪 Restoran → Meja → Tambah:

• Kode: T-09
• Kapasitas: 4
• Section: Indoor / Outdoor / VIP
• QR token auto-generate (40 karakter random)

Di list Meja, ada 4 aksi per baris:

• 👁️ Preview QR — modal preview QR + URL menu
• ⬇️ Download SVG — file qr-{outlet}-meja-{kode}.svg
• 🖨️ Print QR — buka tab baru, auto-print
• 📋 Copy URL Menu — salin URL ke clipboard

Bulk pilih → Print QR Sheet → 1 halaman A4 semua QR + label meja.

🍽️ Menu & Item

A. Kategori

Sidebar 🍽️ Menu → Kategori → Tambah: nama (id+en), ikon emoji, urutan.

B. Item Menu

Sidebar 🍽️ Menu → Item → Tambah:

• Nama (id + en) — translatable
• Foto (Spatie MediaLibrary)
• Tag diet: vegan, halal, gluten-free, pedas 0–5
• Harga jual (base_price) + harga modal (cost_price)
• Waktu persiapan (menit)
• Featured (muncul di beranda + pSEO)

Pro tip: klik 🌐 Translate via AI untuk auto-isi nama dan deskripsi bahasa Inggris.

C. Modifier Group

Sidebar 🍽️ Menu → Modifier — grup pilihan (level pedas, ukuran, topping) dengan opsi + harga tambahan.

D. Jadwal Menu

Atur ketersediaan item per hari/jam. Item di luar jadwal otomatis disembunyikan dari menu customer.

📱 Customer (QR Order)

Flow Customer di Meja

1. Scan QR meja → buka /menu/{slug}?t={token}
2. Browse menu per kategori, cari
3. Tap ❤️ simpan favorit (login dulu)
4. Tap item → pilih variasi/modifier → tambah ke keranjang
5. Tap keranjang → review → pilih metode bayar:
   • Tunai di kasir (default)
   • FoodScan Wallet (saldo cukup)
   • QRIS
6. Apply kode promo (opsional) + tip (0/5/10/15/20%)
7. Pesan → diarahkan ke halaman tracking status 6-langkah

Tipe Pesanan

Dashboard Akun

Login → /account:

• 👤 Profil — edit nama, telepon, bahasa, password
• 📦 Pesanan — riwayat, reorder 1-klik, beri ulasan
• ⭐ Poin Loyalty — saldo + tangga tier + riwayat
• 💳 Wallet — saldo + topup (preset Rp 50rb–2jt)
• 🗓️ Reservasi — daftar reservasi
• ❤️ Favorit — item & resto disukai
• 📍 Alamat — address book untuk delivery

💵 POS & Pembayaran

Flow Kasir

1. Login cashier@foodscan.test → 📦 Pesanan → Pesanan filter status pending
2. Klik baris pesanan → tombol 💵 Bayar
3. Form:
   • Metode: ketik bebas (tunai, qris, edc_bca, gopay, dll.)
   • Jumlah: auto-isi dari total
   • Referensi: opsional
4. Submit → event OrderPaid → 4 listener otomatis:
   • Kurangi stok bahan (resep → ingredient)
   • Tambah poin loyalty (× multiplier tier)
   • Kirim notifikasi ke customer
   • Trigger webhook outbound
5. Auto-redirect ke struk → tombol 🖨️ Cetak Struk

Distribusi Tip

Kalau customer kasih tip, klik 💝 Bagi Tip di detail pesanan → pilih karyawan → split otomatis.

Refund

Sidebar 📦 Pesanan → Refund → pilih pembayaran + jumlah + alasan. Workflow: pending → approve → process.

🍳 Kitchen Display (KDS)

Login kitchen@foodscan.test → buka /kds.

Layout 3 Kolom Kanban

Fitur

• Filter stasiun: 🌐 Semua / 🍳 Kitchen / 🍹 Bar
• Info per kartu: nomor pesanan, meja, item × qty, instruksi khusus
• Waktu berlalu → merah + animasi shimmer kalau >20 menit
• Tombol: Mulai Masak → Siap Antar → Sudah Diantar
• Polling 30 detik + Reverb realtime push + audio ping pesanan baru

🛎️ Reservasi

Customer Booking

Buka /reservasi:

• Pilih outlet, tanggal, jam (min 2 jam advance)
• Jumlah tamu: 1/2/4/6/8/10
• Nama, telepon, email auto-isi (jika login)
• Catatan khusus

Manager Konfirmasi

Sidebar 🛎️ Reservasi → filter "hari ini" atau "mendatang":

• Konfirmasi (pending → confirmed)
• Tamu Datang (confirmed → seated)
• Batal (any → cancelled)

⭐ Loyalty & Wallet

Tier Ladder

Perolehan Poin

Otomatis saat OrderPaid. Formula: poin = floor(subtotal × rate × multiplier_tier)

Rate default 0.001 (1 poin per Rp 1.000). Configurable di ⚙️ Settings → Loyalty.

Welcome Bonus

Customer baru otomatis dapat 100 poin saat daftar.

Referral

URL: /register?ref=ABC12345. Referrer dapat reward 200 poin setelah referred customer order pertama.

Wallet Topup

Customer: /account/wallet → pilih jumlah → pilih metode (Transfer Bank / QRIS / GoPay / OVO / DANA).

Bayar pakai wallet: di keranjang pilih FoodScan Wallet → saldo cukup → langsung paid + saldo terpotong.

📦 Inventory & Resep

Master Data

• Supplier — data vendor
• Bahan Baku — nama, unit, stok saat ini, level reorder, harga per unit
• Resep — link item menu ke bahan baku + jumlah pemakaian
• Wastage — log pemborosan dengan alasan
• Purchase Order — PO ke supplier

Auto-Deduct Saat Order Dibayar

Listener DeductIngredientStock otomatis:

1. Loop item pesanan
2. Cari resep untuk item
3. Kurangi ingredient.current_stock sebesar qty × order qty
4. Insert Stock record (type=sale, reference=Order)

Notifikasi Stok Rendah

Job CheckLowStock tiap hari jam 8 pagi — cari bahan dengan stok ≤ reorder level → notifikasi ke admin.

👨‍🍳 Staff & Shift

Karyawan

Sidebar 👨‍🍳 Staff → Karyawan → Tambah: link ke User, posisi (kasir/waiter/dapur/manager/chef/dll.), tarif per jam, komisi per item (Rp), tanggal mulai.

Shift

Sub-menu Shift: buka shift dengan saldo awal → tutup shift dengan saldo akhir → selisih auto-kalkulasi.

Absensi

Absensi: jam masuk / jam pulang / menit istirahat.

💳 Ringkasan Menu Keuangan

Group 💰 Keuangan mencakup semua fitur finansial — dari pengeluaran harian sampai laporan laba rugi:

🧾 Pengeluaran (Expense)

Catat semua pengeluaran operasional harian: beli bahan, listrik, sewa, gaji, dll.

Input Pengeluaran

Sidebar 💰 Keuangan → Pengeluaran → Tambah:

• Tanggal
• Kategori: bebas (bahan baku, listrik, sewa, transport, dll.)
• Deskripsi: apa yang dibeli (contoh: "Susu GREENFIELDS 2 kotak")
• Qty + Satuan + Harga Satuan
• Total: auto-hitung qty × harga satuan, atau input manual
• Outlet: opsional, untuk filter per cabang

Laporan Pengeluaran

Sidebar 💰 Keuangan → Laporan Pengeluaran:

• Filter tanggal dari → sampai
• Kartu total pengeluaran
• Tabel per kategori: jumlah transaksi + total
• Tabel per hari: ringkasan harian

Data expense langsung terhubung ke Laba Rugi (P&L) secara otomatis.

💸 Payroll & Komisi

Setup Komisi Karyawan

Sidebar 👨‍🍳 Staff → Karyawan → edit → isi Komisi per Item (misal: Rp 2.000).

Contoh: karyawan jual 100 gelas kopi → komisi = 100 × Rp 2.000 = Rp 200.000.

Ambil Gaji (Uang Muka)

Sidebar 💰 Keuangan → Ambil Gaji → Tambah:

• Pilih karyawan
• Tanggal
• Jumlah (Rp)
• Catatan (opsional)

Kalkulasi Payroll Bulanan

Sidebar 💰 Keuangan → Payroll — pilih bulan:

📊 Laba Rugi (P&L)

Sidebar 💰 Keuangan → Laba Rugi (P&L). Laporan bottom-line menggabungkan semua data:

Fitur

• Filter tanggal dari → sampai
• 5 kartu stat di atas: Pendapatan, HPP, Laba Kotor, Pengeluaran, Gaji
• 3 kartu besar: Total Pesanan + Revenue, Laba Kotor + Margin %, Laba Bersih + Margin %
• Tabel detail harian: revenue, HPP, laba kotor, pengeluaran, gaji, laba bersih — per hari

🔒 EOD Reconciliation

Sidebar 💰 Keuangan → EOD Reconciliation. Tutup hari kasir:

1. Pilih outlet + tanggal
2. Sistem tampilkan: total pesanan, revenue kotor, diskon, refund, pajak, service charge, breakdown per metode bayar, ekspektasi kas
3. Kasir input Uang Tunai Aktual di laci
4. Klik Tutup Hari Ini → sistem simpan EOD record + hitung selisih

📈 Laporan Lainnya

Laporan Penjualan

Sidebar ⚙️ Settings → Laporan — filter tanggal:

• Revenue total, total pesanan, rata-rata nilai pesanan
• Revenue per hari (tabel)
• Top 10 menu (qty + revenue)
• Breakdown per metode bayar
• Top 10 customer LTV

Laporan Pajak

💰 Keuangan → Laporan Pajak: PPn 11% dan PB1 10% per transaksi. Siap export untuk laporan pajak bulanan.

HPP & Margin

💰 Keuangan → HPP & Margin: kalkulasi HPP per item dari resep + harga bahan baku terkini. Tampilkan margin % tiap item.

Cash Flow Forecast

💰 Keuangan → Cash Flow Forecast: proyeksi revenue 30 hari ke depan berdasarkan rata-rata per hari-dalam-minggu dari 8 minggu terakhir.

Investor Dashboard

📊 Analytics → Investor Dashboard: MRR, growth vs bulan lalu, top 10 item, grafik revenue 6 bulan. Cocok untuk presentasi ke investor.

🤖 AI Provider (BYOK — Bawa Key Sendiri)

Anti-pattern: tidak ada hardcode provider, model, atau API key. Semua input user sendiri.

Setup Provider

1. Sidebar 🤖 AI Provider → Provider → Tambah
2. Isi:
   • Nama: bebas ("OpenAI Saya", "DeepSeek Murah", "Local Ollama")
   • Format API: openai_compatible / anthropic / gemini
   • Base URL: bebas — https://api.openai.com/v1, http://localhost:11434/v1, dll.
   • API Key: paste, otomatis terenkripsi
3. Model → tambah model dengan model_id bebas + harga
4. Feature Mapping → assign provider untuk fitur apa:
   • demand_forecast — prediksi permintaan
   • translate — terjemahan menu
   • sentiment — analisis ulasan
   • seo_content — generate konten pSEO

Format Adapter

AI Demand Forecast

🤖 AI Provider → Demand Forecast → pilih outlet → Generate. AI prediksi 7 hari ke depan.

AI Translate Menu

Edit item → klik 🌐 Translate via AI → auto-isi nama + deskripsi bahasa Inggris (cache 7 hari).

💬 AI Chatbot (RAG)

Chatbot mengambang di semua halaman storefront. AI menjawab berdasarkan data nyata dari database (RAG — Retrieval-Augmented Generation), bukan halusinasi.

Cara Kerja

1. Customer ketik pertanyaan di widget chat
2. Sistem ambil data dari DB: info outlet, daftar item & harga, FAQ owner, riwayat pesanan customer
3. Data + pertanyaan dikirim ke AI Provider
4. AI jawab berdasarkan data nyata
5. Bot bisa sarankan item → klik langsung tambah ke keranjang

Setup Chatbot

1. 🤖 AI Provider → Chatbot Config
2. Set nama bot, persona, FAQ
3. Pilih AI Provider dari dropdown
4. Toggle aktif → simpan

Histori Chat

🤖 AI Provider → Chat History — lihat percakapan lengkap per customer. Berguna untuk quality control.

💌 Marketing Automation

Tiga jenis campaign berjalan otomatis via Scheduler — tanpa trigger manual.

1. Birthday Campaign (Tiap Hari 08:00)

Auto kirim voucher ke customer yang berulang tahun bulan ini. Setup: 💌 Marketing → Birthday Campaign.

2. Win-Back Campaign (Tiap Hari 09:30)

Target customer tidak order >30 hari. Auto-buat voucher tarik balik. Setup: 💌 Marketing → Win-Back Campaign — set threshold hari, diskon, minimum order.

3. Drip Campaign (Tiap Hari 10:00)

Email sequence berdasarkan 5 trigger: register, first_order, inactive_7d, inactive_14d, birthday_month. Setup: 💌 Marketing → Drip Campaign.

🎮 Gamifikasi & Streak

Streak Order

Customer order setiap hari berturut-turut → multiplier poin naik. Setiap 5 hari streak = +0.1 (max 2.0×). Skip 1 hari = reset ke 1.

Challenges (Tantangan)

Setup: 🎮 Gamifikasi → Challenge — 4 tipe target:

• order_count — selesaikan X pesanan
• spend_amount — total belanja Rp X
• streak_days — streak X hari
• try_categories — coba X kategori berbeda

Reward: loyalty points. Evaluasi otomatis setiap ada pesanan baru.

Leaderboard

Customer bisa toggle tampil di leaderboard dari profil. Owner lihat top spender di Analytics.

📊 RFM Segmentation & Churn

RFM Scoring

Sistem otomatis menilai setiap customer 1–5:

Segmen: champions, loyal, at_risk, cant_lose, new_customers, lost, promising.

Lihat: 📊 Analytics → RFM Segmentation. Klik "Recalculate" untuk update manual.

Churn Dashboard

📊 Analytics → Churn Dashboard. Tiga grup risiko: 🟢 Safe (>60), 🟠 At Risk (30–60), 🔴 Churned (<30). Bisa langsung arahkan ke Win-Back Campaign.

💰 Dynamic Pricing & A/B Test

Dynamic Pricing

Harga item naik/turun otomatis berdasarkan kondisi: peak hours, hari tertentu, stok rendah.

Setup: 🤖 AI Provider → Dynamic Pricing Rule — pilih outlet → condition type → multiplier (1.2 = +20%, 0.9 = -10%).

A/B Testing

Test dua versi item (nama, harga, foto) bersamaan. Setup: 📊 Analytics → A/B Test — pilih item → isi Variant B → aktifkan. Hasil: impressions A/B, conversions A/B, conversion rate, winner otomatis.

🤝 Affiliate, Split Bill & Meal Plan

Affiliate Program

Link referral untuk influencer: /ref/{kode}. Setup: 🎮 Gamifikasi → Affiliate — set nama, komisi %, kode unik 8 karakter.

Split Bill

Satu meja patungan — tiap orang bayar item masing-masing. URL: /split-bill/{orderId}. Assign item ke nama → submit → total per orang.

Meal Plan Subscription

Langganan paket makan harian/mingguan. Setup: 🎮 Gamifikasi → Meal Plan — pilih customer, hari, jam, harga per makan. Order dibuat otomatis setiap pagi jam 07:00.

🔔 Order Tracking & Review Gate

Order Tracking Real-Time

URL: /track/{token}. Status stepper: Confirmed → Preparing → Ready → Served → Completed. Auto-update setiap 5 detik.

Review Gate

Saat status Completed: customer beri bintang 1–5.

• ≥4 bintang → redirect ke Google Review outlet (boost rating Google)
• <4 bintang → form feedback internal — owner bisa baca & follow-up

Setup: edit Outlet → isi Google Review URL.

📺 Digital Signage & Kiosk

Digital Signage (TV)

URL: /signage/{slug}. Buka di browser TV → F11 fullscreen. Item berganti otomatis tiap 8 detik (animasi fade). Promo berjalan di ticker bawah.

Self-Order Kiosk (Tablet)

URL: /menu/{slug}?table=X. Layout fullscreen, no navigation. 3 menit idle → auto-reset ke halaman awal.

🏢 Corporate & Catering + Delivery

Corporate Account

Untuk perusahaan yang rutin order besar — sistem kredit, bayar akhir bulan. 🏭 Operasional → Corporate Account.

Catering Order

Order event/akad dengan DP tracking. 🏭 Operasional → Catering Order — isi klien, tanggal event, item, DP, jatuh tempo. remainingBalance() otomatis.

Delivery Zone

🌐 Ekosistem → Delivery Zone — atur zona per outlet: nama, radius km, biaya kirim, minimum order, estimasi menit.

💼 SaaS Multi-Tenant

Harga Standalone (Source Code)

Mode Standalone vs SaaS (Teknis)

• Standalone: LICENSE_MODE=standalone — tidak ada deteksi tenant, tenant_id nullable
• SaaS: LICENSE_MODE=saas — ResolveTenant middleware detect via subdomain/domain/header, TenantScope filter semua query

Menu SaaS

Sidebar 💼 SaaS: Plans (tier harga), Tenants (pelanggan), Subscriptions (status langganan), Invoices (tagihan), Usage Metrics (pemakaian per tenant).

🔍 Programmatic SEO

Route Patterns

Setiap halaman punya: JSON-LD schema (LocalBusiness/ItemList/FAQPage), full meta tags, konten 300+ kata unik, auto-included di /sitemap.xml.

🪝 Webhook & API

Webhook

⚙️ Settings → Webhook: URL target, pilih event (order.paid, *), secret untuk HMAC signature. Delivery log + retry.

API Key

⚙️ Settings → API Key: nama + abilities (orders.read, customers.write) + expires_at. Raw key tampil 1× saja.

🛠️ Troubleshooting

KDS Kosong

Filter stasiun terlalu sempit → klik 🌐 Semua. Pastikan item pesanan berstatus pending/preparing/ready.

Receipt PDF Error

php artisan storage:link
chmod -R 775 storage   # Linux only

Reverb Tidak Konek

Cek port 8080 tidak diblok firewall. Set REVERB_HOST=127.0.0.1 di .env.

Filament Panel Blank

php artisan filament:assets
php artisan view:clear
composer dump-autoload

Query Lambat Data 10rb+

Index sudah ada di kolom yang sering di-query. Jalankan php artisan optimize untuk production.

❓ FAQ