İyi yazılım budur
- QR kodun yönlendirdiği tam URL’yi ve masa/şube tokenını telefonda doğrudan açarak test edin.
- HTTPS, alan adı, yönlendirme, kamera izni ve mobil tarayıcı önbelleğini ayrı değerlendirin.
- Sipariş gönderiminde ağ isteği, doğrulama, stok, ödeme ve tekrar gönderme korumasını inceleyin.
- Sipariş kaydolduğu hâlde mutfağa gitmiyorsa QR Menü ile mutfak entegrasyonunu ayrı izleyin.
QR Menü neden açılmaz veya sipariş göndermez?
QR Menü sorunları üç ana aşamada görülür: QR kodun doğru bağlantıya yönlendirmemesi, menü uygulamasının telefonda yüklenememesi ve menü açıldığı hâlde sipariş isteğinin sunucuya kaydedilememesi. “QR çalışmıyor” demeden önce hatanın hangi aşamada olduğunu netleştirin.
Telefon kamerası QR kodu hiç algılamıyorsa baskı kalitesi, ışık ve kod boyutu incelenir. Kamera bağlantıyı gösteriyor fakat sayfa açılmıyorsa URL, alan adı ve HTTPS kontrol edilir. Menü açılıyor ancak “Sipariş ver” butonu sonuç üretmiyorsa tarayıcı geliştirici kayıtları, API cevabı ve sipariş doğrulama kuralları gerekir.
QR kodun hedef URL’sini ve masa tokenını doğrulayın
QR görseli yalnızca bir bağlantı taşır. Kod eski alan adına, test sunucusuna, silinmiş masa kaydına veya süresi dolmuş tokena yönleniyorsa yeni menü sistemi doğru çalışsa bile müşteri hata görür. QR kodu taradıktan sonra çıkan tam adresi kopyalayıp farklı telefonlarda doğrudan açın.
- URL doğru alan adı ve HTTPS ile mi başlıyor?
- Şube, masa veya ekran kimliği doğru mu?
- Token kalıcı mı, süreli mi ve hâlâ geçerli mi?
- Eski QR görselleri masalarda kalmış mı?
- Yönlendirme döngüsü veya 404 oluşuyor mu?
- URL’de Türkçe karakter, boşluk veya eksik parametre var mı?
Masa değiştirildiğinde eski QR kodun yeni masaya elle taşınması siparişleri yanlış masaya düşürebilir. Her fiziksel masa ile sistemdeki masa kaydı eşleştirilmelidir.
HTTPS, kamera izni ve mobil tarayıcı davranışı
QR kodu telefonun standart kamera uygulamasıyla taramak için web sitesinin kamera erişimine ihtiyacı yoktur. Ancak web sayfası içinde kamera ile QR tarama özelliği sunuluyorsa getUserMedia() kullanılır. MDN’ye göre bu API kullanıcı izni ister ve güvenli bağlamda, yani genellikle HTTPS üzerinde çalışır. Ayrıntılar MediaDevices.getUserMedia() belgesinde yer alır.
Alan adı sertifikasının süresi dolmuşsa, ara sertifika eksikse veya sayfada güvensiz içerik bulunuyorsa bazı telefonlar bağlantıyı engelleyebilir. Wi-Fi giriş sayfası, işletme ağı DNS filtresi veya mobil veri kısıtı da aynı belirtileri oluşturabilir.
Önbellek ve eski menü sürümünü kontrol edin
QR Menü uygulaması PWA veya service worker kullanıyorsa eski HTML, JavaScript ya da ürün verisi telefonda önbellekten gelebilir. web.dev’in PWA önbellekleme rehberi, Cache Storage’ın ağdan bağımsız içerik sunabildiğini açıklar. Yanlış önbellek stratejisi yeni menü sürümünün görünmesini geciktirebilir.
- Dosya adlarında veya URL’de sürüm parametresi kullanılıyor mu?
- Service worker yeni sürümde etkinleşiyor mu?
- API cevapları gereğinden uzun süre cache ediliyor mu?
- Pasif ürün eski listede görünmeye devam ediyor mu?
- Sepet eski ürün fiyatıyla yeni sipariş göndermeye çalışıyor mu?
Gizli sekmede veya site verilerini temizleyerek yapılan test sorunu çözüyor fakat normal sekmede çözmüyorsa önbellek sürümü önemli bir işarettir.
Sipariş gönderim isteğini ve sunucu cevabını inceleyin
“Sipariş ver” butonuna basıldıktan sonra tarayıcı genellikle bir API isteği gönderir. İstek hiç oluşmuyorsa JavaScript hatası, devre dışı buton veya eksik form doğrulaması vardır. İstek oluşup 4xx cevabı alıyorsa masa tokenı, ürün, stok, minimum tutar veya müşteri alanı reddedilmiş olabilir. 5xx cevapları sunucu ve veritabanı tarafını işaret eder.
Kaydedilmesi gereken tanılama alanları
- İstek zamanı ve benzersiz istemci sipariş anahtarı
- Şube, masa, oturum ve sepet kimliği
- Ürün/ekstra satırları ve istemcide görünen toplam
- HTTP durum kodu ve kullanıcıya gösterilen mesaj
- Sunucudaki doğrulama veya veritabanı hatası
- Oluştuysa yerel sipariş numarası
Kullanıcıya yalnızca “Bir hata oluştu” göstermek yerine yeniden deneyip denememesi gerektiğini belirten anlaşılır mesaj verilmelidir.
Masa, şube ve ürün eşleşmesini doğrulayın
QR bağlantısı doğru sayfayı açsa bile masa kaydı pasif, başka şubeye taşınmış veya işletme kapalı saat kuralında olabilir. Ürün tarafında ise QR menüde görünen dış kimlik ile sipariş sistemindeki ürün kimliği uyuşmayabilir.
- Masa aktif ve siparişe açık mı?
- Şubenin çalışma saatleri ve online sipariş ayarı uygun mu?
- Ürün ve varyant hâlâ aktif mi?
- Fiyat ve vergi hesaplaması sunucudaki değerle eşleşiyor mu?
- Zorunlu ekstra seçimi tamamlandı mı?
- Stoksuz ürün için sipariş engeli açık mı?
İstemcide görünen fiyat ile sunucunun hesapladığı fiyat farklıysa sunucu siparişi reddetmelidir; ancak kullanıcıya hangi ürünün güncellendiği açıkça gösterilmelidir.
Ödeme ve tekrar gönderme koruması
Online ödeme kullanılan QR siparişinde ödeme işlemi ile sipariş kaydı ayrı aşamalardır. Ödeme başarılı olup sipariş oluşturulamazsa otomatik mutabakat gerekir. Kullanıcı butona iki kez basarsa veya zayıf bağlantıda tekrar denerse aynı siparişin iki kere oluşmaması için istemci sipariş anahtarı kullanılmalıdır.
Sipariş kaydoluyor fakat mutfağa gitmiyorsa
QR Menü sipariş numarası oluşturmuşsa menü tarafı temel görevini tamamlamış olabilir. Bundan sonraki sorun şube, ürün istasyonu, mutfak kuyruğu veya yazıcıdadır. QR siparişleri için otomatik kabul ve otomatik yazdırma seçeneklerinin ayrı olduğunu unutmayın.
- QR siparişi beklemede mi, otomatik kabul edildi mi?
- Ürünlerin mutfak/bar istasyonları mevcut mu?
- QR kaynağı için yazdırma kuralı açık mı?
- Şube yazıcısı çevrimiçi mi?
- Mutfağa gönderim görevi ve hata kaydı oluştu mu?
QR Menü sorunları neden–çözüm tablosu
| Belirti | Muhtemel neden | Çözüm |
|---|---|---|
| Kamera QR kodu görmüyor | Küçük/bozuk baskı, düşük kontrast veya ışık | Kodu yeniden üretip farklı telefonla test edin |
| Bağlantı 404 açıyor | Eski URL, masa veya token silinmiş | QR hedefini güncel masa kaydıyla yeniden oluşturun |
| Wi-Fi’da açılmıyor, mobil veride açılıyor | DNS, captive portal veya ağ filtresi | İşletme ağı ve DNS yapılandırmasını kontrol edin |
| Eski ürünler görünüyor | Service worker veya API önbelleği | Cache sürümünü yükseltip eski kayıtları temizleyin |
| Sipariş butonu dönüp kalıyor | API isteği yanıtlanmıyor veya JS hatası | Ağ isteği, konsol ve sunucu loglarını inceleyin |
| 422 doğrulama hatası | Masa tokenı, stok, fiyat veya zorunlu alan | API hata alanını kullanıcı mesajıyla eşleştirin |
| Sipariş oluşuyor, mutfağa gitmiyor | İstasyon, otomatik kabul veya yazdırma kuralı | Mutfak aktarım zincirini ayrı test edin |
| Aynı sipariş iki kez oluşuyor | Çift tıklama veya güvenli olmayan tekrar deneme | Idempotency anahtarı ve buton kilidi kullanın |
Adım adım QR Menü test planı
- QR kodun tam URL’sini kopyalayıp doğrudan açın.
- Android/iPhone ve Wi-Fi/mobil veri kombinasyonlarında test edin.
- Gizli sekmede menü ve ürün sürümünü karşılaştırın.
- Tek ürünlü, ekstra içermeyen basit sipariş gönderin.
- Tarayıcı ağ kaydında sipariş isteği ve durum kodunu inceleyin.
- Sunucuda sipariş ve doğrulama kayıtlarını bulun.
- Sipariş oluştuysa mutfak görevini ve yazıcı sonucunu kontrol edin.
- Aynı siparişi çift tıklama ve zayıf bağlantı senaryosunda test edin.
- Başarılı test sonrası eski masa QR’larını değiştirin.
Hangi durumda teknik destek gerekir?
- QR URL’si doğru olduğu hâlde farklı cihazlarda sürekli açılmıyorsa
- Menü önbelleği yeni ürün ve fiyatları güvenilir biçimde yenilemiyorsa
- API 4xx/5xx hataları kullanıcıya anlaşılır açıklama vermiyorsa
- Ödeme alınmış fakat sipariş oluşmamış kayıtlar varsa
- QR siparişleri yanlış masa, şube veya mutfak istasyonuna gidiyorsa
- Çift sipariş veya kayıp sipariş vakaları tekrarlanıyorsa
Sık sorulan sorular
QR Menü için müşterinin uygulama indirmesi gerekir mi?
Web tabanlı QR Menüde genellikle gerekmez. Telefon kamerası bağlantıyı açar ve menü tarayıcıda çalışır.
QR kod değişmeden menü adresi değiştirilebilir mi?
QR kod doğrudan eski URL’yi içeriyorsa yönlendirme ile geçiş yapılabilir. Kalıcı kısa URL kullanmak gelecekteki değişiklikleri kolaylaştırır.
İnternet kesilince QR sipariş alınabilir mi?
Menü varlıkları önbellekten gösterilebilir; ancak siparişin sunucuya kaydedilmesi için güvenilir bağlantı veya çevrimdışı kuyruk ve sonradan senkronizasyon tasarımı gerekir.
QR Menü sipariş akışını baştan sona doğrulayın
QR hedefi, masa tokenı, mobil önbellek, sipariş API’si ve mutfak aktarımını tek test planında inceleyerek müşteri tarafındaki kesintiyi kalıcı biçimde giderelim.
QR Menü ve Restoran Yazılımını İnceleyin