Smash'd Burger - Full-Stack QR Ordering and KDS System

Smash'd Burger, modern restoran işletmeleri için uçtan uca tasarlanmış bir QR Menü ve Mutfak Yönetim Sistemi (KDS) çözümüdür. Sistem, müşterilerin masadaki QR kod aracılığıyla sipariş vermesini ve mutfak ekibinin bu siparişleri anlık olarak takip edip yönetmesini sağlar.

---

Özellikler

Müşteri Paneli (Mobile-First)

• Dinamik Masa Tanımlama: URL parametreleri aracılığıyla masa numarası tespiti.
• Kategorize Edilmiş Menü: Ürünlerin kategorilere göre filtrelenmesi ve listelenmesi.
• Ürün Detay ve Özelleştirme: Seçilen ürünler için ek seçeneklerin belirlenmesi.
• Kalıcı Sepet Yönetimi: Zustand ve Persist Middleware ile tarayıcı yenilense dahi korunan sepet verileri.
• Sipariş Onay Süreci: Ödeme simülasyonu ve başarılı sipariş bildirimi.

Mutfak Yönetim Ekranı (KDS)

• Gerçek Zamanlı Veri Senkronizasyonu: Supabase Realtime ile sayfa yenilenmeden sipariş takibi.
• Sesli Bildirim Sistemi: Yeni sipariş girişlerinde mutfak ekibine yönelik sesli uyarı.
• İş Akış Yönetimi: Sipariş durumlarının (Bekliyor, Hazırlanıyor, Tamamlandı) takibi.
• Performans Takibi: Her sipariş kartı için canlı bekleme süresi sayacı.

Güvenlik ve Altyapı

• Yetkilendirme: Supabase Auth ile korunan yönetici paneli.
• Veri Güvenliği: Row Level Security (RLS) ile tablo bazlı erişim kısıtlamaları.
• QR Kod Üretimi: Her masa için benzersiz bağlantı içeren QR kod oluşturucu.
• Veritabanı Bakımı: Zamanlanmış görevler (Cron Jobs) ile eski verilerin otomatik temizlenmesi.

---

Gelecek Planlaması ve Planlanan Özellikler

Sistemin geliştirme aşamasında eklenmesi planlanan özellikler:

• Gelişmiş Landing Page: Marka kimliğini yansıtan, animasyonlu ve bilgilendirici ana sayfa tasarımı.
• Yönetici Dashboard (Analytics): Satış verilerinin Chart.js veya Recharts kullanılarak grafiklerle görselleştirilmesi ve ciro takibi.
• Detaylı Malzeme Düzenleme: Müşterilerin ürün içerisindeki malzemeleri (çıkarma/ekleme) detaylı olarak yönetebileceği gelişmiş özelleştirme modülü.
• Çoklu Dil Desteği: Uluslararası müşteriler için i18n entegrasyonu.

---

Teknoloji Yığını

• Framework: Next.js (App Router)
• Programlama Dili: TypeScript
• Backend ve Veritabanı: Supabase (PostgreSQL)
• State Management: Zustand
• Arayüz Bileşenleri: Shadcn/UI (Radix UI)
• CSS Framework: Tailwind CSS
• İkon Seti: Lucide React
• QR Kütüphanesi: next-qrcode

---

Kurulum Talimatları

1. Projeyi yerel makinenize klonlayın:

git clone https://github.com/kullaniciadi/smashd-burger.git
cd smashd-burger

2. Gerekli bağımlılıkları yükleyin:

npm install

3. Çevre değişkenlerini .env.local dosyasına ekleyin:

NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key

4. Uygulamayı geliştirme modunda çalıştırın:

npm run dev

---

Veritabanı Yapısı

Sistem aşağıdaki tablolar üzerinde çalışmaktadır:

• categories: Ürün gruplandırmaları.
• products: Satıştaki ürünlerin tüm detayları.
• orders: Sipariş detayları, masa bilgisi ve canlı durum verileri.

---

Ekran Görüntüleri

Giriş Ekranı

Menü Paneli

Mutfak Ekranı

Masa QR Ekranı

---

Lisans

MIT

---

Developed by [Ender Karan]