Restoran ve Kafeler İçin Ücretsiz QR Menü Sistemi - Açık Kaynak (MIT)
Sektör için geliştirdiğim QR menü sistemini ücretsiz olarak paylaşıyorum:GitHub: https://github.com/trhero/QRMasa
Bu sistem sadece bir QR menü değil. İçerisinde masa ve adisyon takibi, mutfak ekranı (KDS), kasa yönetimi, denetim kayıtları ve paket servis modülü de bulunuyor.
ÖNEMLİ BİLGİLENDİRME
- Bu yazılım deneysel bir projedir, bitmiş ticari bir ürün değildir.
- Kodların tamamı yapay zeka (Claude) desteği ile geliştirilmiştir.
- Gerçek bir işletmede uzun süreli test edilmemiştir. Canlı ortamda kullanmadan önce mutlaka kendi testlerinizi yapın.
Kullanıcı Adı: demo
Şifre: demo1234
Kurulum: PHP 8+, Framework yok, Composer / npm gerektirmez. SQLite veya MySQL ile çalışır. cPanel'e yükleyip 2 adımlı kurulum sihirbazı ile direkt çalıştırabilirsiniz.
Öne Çıkan Özellikler: Linkte masa numarası görünmez, sadece güvenli token ile çalışır. Siparişler önce garson onayına düşer. Mutfak ekranı sesli uyarı verir ve siparişleri gruplu kartlarda gösterir. Kısmi ve karma ödeme alma, gün sonu Z raporu ile kasa mutabakatı ve tüm işlemler için kim ne yaptı logu tutar. Otomatik yedekleme mevcuttur.
Sizden ricam, sahada en çok ihtiyaç duyulan nedir? Eksik gördüğünüz noktaları yazarsanız önceliklendirip ekleyebilirim. (Şimdilik online ödeme, ESC/POS yazıcı ve çoklu şube desteği yok - sizce hangisi önce gelmeli?)
Ayrıca canlı demoyu ayakta tutabilmek için küçük bir hosting / VPS sponsor desteği arıyorum. PHP 8 destekleyen en küçük paket bile yeterli. Sponsor olan kişinin / firmanın ismini GitHub README ve demo sayfasında belirteceğim.
Sistemde Neler Var?
1. Müşteri / QR Menü TarafıMasaya özel QR ile mobil menü açılır. URL içinde masa no yok, sadece panelden yenilenebilen güvenli token var. Alerjen, vejetaryen/vegan filtresi, kalori bilgisi ve ürün araması mevcut. Ürün adları ve açıklamaları dahil çok dilli yapı (TR/EN). Sepet, porsiyon / ekstra malzeme gibi varyantlar ve ürün bazlı not ekleme var. Sipariş garson onayından sonra müşteri tarafında "Hazırlanıyor / Hazır" olarak takip edilebiliyor. Hesabım, garson çağır ve hesap iste butonları eklendi. 3 farklı tema, büyük yazı modu ve PWA desteği ile ana ekrana eklenebilir.
2. Garson Ekranı
Canlı masa planı ile onay bekleyen masalar yanıp sönerek uyarı verir, garson çağrısı sesli ve titreşimli bildirim olarak gelir. Adisyon üzerinde kalem ekle/sil, adet bazlı silme/ikram ("3 çayın 1'ini ikram et"), masa taşıma, birleştirme ve bölme yapılabilir. İndirim, ikram, kuver ücreti ve kupon kodu uygulanabilir. Tüm işlemler pop-up olmadan dokunmatik modallar ile yapılır. Ürün ekleme ekranında hızlı arama, kategori sekmeleri ve çok satanlar listesi var. Tamamen mobil uyumlu.
3. Mutfak Ekranı (KDS)
Koyu tema, yeni sipariş geldiğinde sesli uyarı ve masalara göre gruplanmış sipariş kartları. Sipariş durumu: Bekliyor > Hazırlanıyor > Hazır > Servis Edildi olarak ilerler, kısmi hazırlama desteklenir. Geciken siparişler için renk değiştiren yaş sayacı ve istasyona göre filtreleme (sadece içecekler gibi) var. İptal edilen ürünler kaybolmaz, 60 saniye boyunca kırmızı "İPTAL" olarak görünür. Mutfaktan "stok bitti" işaretlenebilir ve tabletin uyumaması için Wake Lock özelliği mevcut.
4. Kasa ve Muhasebe
Kısmi ve karma ödeme desteği var (Örn: 500 TL kart + 200 TL nakit). Adisyon, tutar tamamlandığında otomatik kapanır. Gün sonu Z raporu ve kasa sayım mutabakatı ile nakit farkı takibi yapılabilir. İş günü kesim saati ayarlanabilir (gece 02:00'de kapanan hesap bir önceki günün cirosuna yazılır). İade, tahsil edilemedi / kaçak olarak kapatma, KDV dökümü ve 80mm termal yazıcı fiş çıktısı var. Ciro, ödeme tipi, ürün satış, saatlik yoğunluk ve personel bazlı raporlar ve CSV dışa aktarım desteği.
5. Güvenlik ve Denetim Kaydı
İndirim, ikram, ürün silme, iptal ve ödeme gibi tüm kritik işlemler "kim, ne zaman, ne yaptı" şeklinde loglanır. Silinen kalemler soft-delete ile arşivlenir, rapordan düşer ama izi kalır. Tüm sorgular prepared statement ile yazıldı, her işlemde oturum, rol ve CSRF kontrolü yapılır. İki garsonun aynı adisyona aynı anda müdahalesini engelleyen çakışma koruması var. Rol sistemi: Yönetici / Kasiyer / Garson / Mutfak.
6. Paket Servis ve Sistem Araçları
Telefonla paket sipariş için müşteri adı, telefon, adres ve teslim saati ile kayıt ("her zamanki siparişinden" gibi). Cron gerektirmeden otomatik günlük yedek, tam sistem yedeği (veritabanı + görseller). Sistem durumu izleme ekranı ve elektrik kesintisi için açık adisyonların acil durum dökümü. CLI üzerinden admin şifre sıfırlama ve role özel yardım sayfaları.
Teknik Detaylar
PHP 8.0 ve üzeri, hiçbir framework kullanılmadı. Composer, npm veya build işlemi yok. Veritabanı olarak varsayılan SQLite (kurulum gerektirmez) veya MySQL seçilebilir. Frontend Vanilla JS, jQuery bile yok. Paylaşımlı hosting'e FTP ile atıp kurulumu tamamlayabilirsiniz. 603 adet uçtan uca test tek komutla çalıştırılabiliyor.Kısacası cPanel'i olan herkes ek bir ayar yapmadan kurup kullanabilir.