Bölüm 1 — Mutfak ekranı (KDS)

Mutfak ekranı, mutfaktaki veya bardaki bir ekranda açılan ve sipariş fişlerini canlı olarak gösteren tarayıcı tabanlı bir sayfadır. Mutfak personeli bununla siparişleri "yeni"den "hazır"a doğru ilerletir. İnternete bağlıdır ve siparişleri anlık olarak alır.

⚠️ Uygulamanın dili: Bu uygulama varsayılan olarak Almanca açılır ve mutfağın Farsça çevirisi eksiktir — yani dili Farsça yapsanız bile bazı etiketler (örneğin Done, Preparing, Refresh) İngilizce kalır. Bu bölümde parantez içinde verilen etiketler, ekranda gerçekten gördüğünüz metnin ta kendisidir.

1-1. Giriş

• E-posta ve parola ile giriş yapın (kasadaki hesabın aynısı). Girişin bir telefon sekmesi de vardır ve iki adımlı doğrulama etkinse bir kod adımı da eklenir; sosyal giriş seçenekleri ile kayıt/parola sıfırlama sayfaları da mevcuttur.
• Kilit ekranı / hızlı PIN: Kasada olduğu gibi, kullanıcının bir PIN'i varsa panoyu kilitleyip PIN ile açabilir (tam çıkış yapmadan) ve listeden kullanıcı değiştirebilir ya da başka bir kasiyer ekleyebilir.

1-2. Şube ve istasyon seçimi (panodan önce)

Giriş yaptıktan sonra ayrı bir sayfa, bu ekranın şubesini (Location) ve istasyonunu (Station) seçmenizi ister:

• Başka bir kullanıcının daha önce aldığı her istasyon devre dışı olarak gösterilir.
• Seçimden sonra bir yüzdelik ilerleme çubuğu ilk verileri yükler, ardından panoya girersiniz. Verilerin bir kısmı önbelleğe alınamazsa, tekrar dene düğmesiyle birlikte "Pano açılıyor ama…" mesajı gelir.
• Sorun durumunda: "Mutfak oturumu yüklenemedi" (→ girişe git) veya "Şubeler yüklenemedi" (→ tekrar dene).

Bu adım, pano içindeki hedef seçimiyle (Destination) farklıdır; o, 1-3 bölümünde açıklanmıştır.

1-3. Sipariş panosu

Ana sayfa, her biri ayrı kaydırılan durum sütunlarına sahip bir panodur:

• Yeni (New): Yeni gelen siparişler.
• Hazırlanıyor (Preparing): Başlanmış işler.
• Hazır/Tamamlandı (Completed): Bitmiş işler.
• İptal edildi (Cancelled): İptal edilen siparişler (kırmızı).

Her sütunun başında o sütundaki fiş sayısı ve kalem sayısı gösterilir; boş sütunun kendine ait bir mesajı vardır ("No new work", "Nothing preparing", "No completed work", "Nothing cancelled").

Panonun üst çubuğu

• Hedef seçimi (Destination): Bu ekranın hangi mutfak monitörünü/istasyonunu göstereceğini seçmek (örneğin "sıcak mutfak" veya "bar"). Yalnızca tek bir hedef varsa otomatik seçilir ve son seçiminiz hatırlanır. Hiçbir hedef mevcut değilse bir yönlendirme mesajı gelir ve yüklemeden önce hedefi seçmeniz gerekir.
• Yenileme düğmesi (Refresh), yenileme sırasında "Refreshing" etiketi, son kontrol zamanı, fiş/kalem sayısı ve son canlı olay.
• Sayfalama bildirimi: Sunucuda yüklenenden daha fazlası varsa "Showing X of Y backend orders" gösterilir — yani sunucu tarafında filtre/sayfa değiştirdikten sonra yenileme yapın.

Her fişte ne görürsünüz

• Kaynak türü: Open cart (açık sepet), Finalized order (nihai hale getirilmiş sipariş) veya Kitchen dispatch (mutfak sevkiyatı); revizyon numarası ("Rev N").
• Sipariş başlığı, kaynak satırı, oluşturma ve güncelleme zamanı, ve durum etiketi.
• Kalem satırı: miktar xN biçiminde (iadeler için negatif sayı), ürün adı, notlar için "Note:", ekstralar, ve "Cross-sell for …" etiketli iç içe tamamlayıcı kalemler; ayarlanmışsa her ürünün renkli arka planı.

1-4. Siparişi ilerletme (Bump)

Her fişte yalnızca o duruma izin verilen düğmeler gösterilir:

• Hazırlığa başla (Start preparing) → yalnızca yeni durumundan → "hazırlanıyor"a geçer.
• Hazır (Done) → yalnızca hazırlanıyor durumundan → "hazır/tamamlandı"ya geçer.
• İptal (Cancel) → yeni veya hazırlanıyor durumundan → "iptal edildi"ye geçer (kırmızı düğme).

Her işlem sunucuya kaydedilir ve sayfa yenilenir; bir işlem kaydedilirken aynı fişin diğer düğmeleri gizlenir. İzin verilmeyen işlemlerin hiç düğmesi yoktur (devre dışı değil, gizli). Durum kaydı başarısız olursa, ayrı bir kırmızı çubuk ("Kitchen status could not be updated") gösterilir.

Fiş yazdırma (Print)

• Yalnızca yazdırılabilir fişlerde yazdırma düğmesi vardır.
• Başarılı: "Kitchen ticket sent to …".
• Yazdırma şablonu ayarlanmamışsa: "No kitchen print template is configured…" uyarısı.
• Hatalar nedenlerine göre ayrılır: şablon sorunu ("…template could not be prepared…") ile donanım sorunu ("…could not be printed… Check the printer connection").

1-5. Uyarı sesi

• Yeni bir iş veya değişiklik için bir bip/siren çalar; böylece ekrana bakmasanız bile fark edersiniz.
• Ses yalnızca gerçek bir sunucu onayından sonra çalar (yeni iş, daha yeni revizyon veya durum değişikliği) — sayfanın ilk açılışında ve yeniden bağlandıktan sonraki yenilemede değil. Art arda üst üste de yığılmaz (en az 1,5 saniye ara).
• Ses izni çubuğu: Tarayıcı ses çalma izni vermemişse, sayfanın altında "Enable kitchen sound" düğmesiyle birlikte sarı bir çubuk ("Kitchen alerts need sound permission") gösterilir.

💡 Ses çalmıyorsa, aynı "Enable kitchen sound" düğmesi veya ekrana yapılan bir dokunuş sorunu çözer.

1-6. Bağlantı durumu ve kurtarma

Sayfanın üstünde bir Live / Stale / Offline göstergesi vardır ("Stale", bağlantının yavaş/yeniden bağlanıyor olduğu anlamına gelir). Canlı bağlantı sorunlu olduğunda belirgin bir çubuk belirir:

• "Live order updates are offline" (kesildi)
• "Reconnecting to live order updates…" (yeniden bağlanıyor)
• "Live updates may be behind" (bir güncelleme kaçırıldı; pano kendi kendine otomatik yenilenir)

Canlı bağlantı kesilirse, güvenilir yol sayfanın üstündeki manuel yenileme (Refresh) düğmesidir. Pano, yenilemeler arasında mevcut fişleri korur ve yalnızca yeni durumu gösterir.

• "Şube belirleniyor" durumu kendine özel düğmesine ("Retry location") sahiptir; pano hiç yüklenmediyse "Refresh board" kurtarma sayfası gelir.
• İsteklerin bir zaman aşımı vardır (gecikirse "request timed out — use Refresh" mesajı).

1-7. Ayarlar

Kullanıcı menüsünden, profil, güvenlik, görünüm (tema), bildirim ve bağlantı sekmeleriyle hesap ayarları — ve çıkış. ⚠️ Bağlantı (Integration) sekmesi devre dışıdır ve açılmaz.

Sistem ayarları yalnızca iki sekmeye sahiptir: Katalog ve Satış ("general" bağlantısı da kataloğa gider). Yazma izniniz yoksa bir salt okunur çubuğuyla açılır; görüntüleme izniniz yoksa hiç açılmaz.