Müşteriler için
Bir dakikadan kısa sürede rezervasyon
Uygulamanın ilk nesli, yanına bir rezervasyon formu iliştirilmiş bir sadakat kartıydı. Yenisi ziyaretin kendisi etrafında kuruldu: ana ekran güncel cashback bakiyesini ve tek dokunuşla “Tekrar rezervasyon yap” seçenekli son ziyareti gösterir; rezervasyon bir hizmetten ya da bir berberden başlayabilir — müşterinin aklına hangisi önce gelirse.
İki giriş yolu
Hizmetten ya da berberden başlayın. Berberler seviyelerini (Junior, Barber, Senior, Top, Chief), puanlarını ve yorum sayılarını taşır; “herhangi bir berber” seçeneği atamayı salona bırakır.
Gerçek boş saatler
Sabah, öğleden sonra ve akşam slotları salonun canlı takviminden gelir; uygulama, resepsiyonun sonradan taşımak zorunda kalacağı bir saati asla önermez.
Kaydırarak rezervasyon
Onay ekranı berberi, saati, hizmetleri, fiyat aralığını, kabul edilen ödeme yöntemlerini (nakit, kart, Apple Pay, Google Pay) ve faturanın ne kadarının cashback bakiyesiyle karşılanabileceğini listeler.
Misafir rezervasyonu
Bir ziyaret yalnızca ad ve telefon numarasıyla ayırtılabilir. Giriş — telefona tek kullanımlık kod, şifre yok — yalnızca rezervasyonları görmek, taşımak veya iptal etmek için gerekir.
Cashback sadakat
Zeus cashback kartı güncel bakiyesiyle ana ekranda durur; seviyeler ve ilerleme uygulamada yeniden yazılmak yerine salonun kendi sadakat programından okunur.
Yorumlar ve salon
Müşteriler ziyaretten sonraki 14 gün boyunca puan verir, salonun yorumlarını okur; çalışma saatleri, yol tarifi, arama, mesaj ve web sitesi tek yerde. Bulgarca ve İngilizce hazır gelir.
Ekranlar
Yayındaki rezervasyon akışı
Aynı kod Android’de de çalışıyor. Aşağıda: Bulgarca Android build’i.
Kaputun altında
CRM’i geride bırakan bir middleware
Uygulama CRM ile asla doğrudan konuşmaz. Bir Ktor middleware — Zeus backend — mobil API sözleşmesinin sahibidir ve onu salonun bugün kullandığı sisteme çevirir. Sözleşme donduruldu ve testlerle korunuyor; bir CRM değişikliği, sıfır uygulama yayını gerektiren bir backend değişikliğidir.
Tek sözleşme, 26 endpoint
Mobil API, dokümantasyonla test düzeyinde eşit bir OpenAPI export’u olan sürümlü, belgelenmiş bir spesifikasyondur. DTO’lar onu bayt bayt yansıtır; hata kataloğu testlerle zorlanır.
Port’ların arkasında CRM
Şubeler, hizmetler, personel, müsaitlik, müşteriler, kayıtlar, sadakat ve yorumlar sekiz port’tur. CRM adaptörü vendor’ı bilmesine izin verilen tek modüldür; mimari testi bunu korur.
Sağlayıcının hesapladığı müsaitlik
Boş slotlar CRM tarafından hesaplanır ve Zeus tarafından normalize edilir; stale-while-revalidate önbellekleri ve istek birleştirme sayesinde yoğun bir cumartesi sabahı CRM kesintisine dönüşmez.
Content overlay
CRM’de olmayan zengin alanlar — yerelleştirilmiş açıklamalar, seviyeler, BlurHash placeholder’lı hero görselleri, çalışma saati metinleri — Zeus’un kendi deposunda yaşar ve locale’e göre birleştirilir.
Güvenli yazmalar
Her rezervasyon yazması bir idempotency anahtarı taşır, yeniden denemeler orijinal yanıtı döndürür; salon tarafındaki değişiklikler (resepsiyonda taşıma, yerinde iptal) bir delta-poll işiyle yakalanır.
Şifresiz kimlik
Giriş telefona tek kullanımlık koddur; oturumlar rotasyon ve hırsızlık tespiti olan Ed25519 imzalı token’lardır. Cihaz ve IP başına rate limit’ler anonim endpoint’leri korur.
Mühendislik
Ne gerekti
- ●Uçtan uca Kotlin. Uygulama her iki platformda Compose Multiplatform UI’lı Kotlin Multiplatform; backend PostgreSQL ile Ktor üzerinde Kotlin. Mobil ve sunucu için tek dil, tek mimari (VISCE), tek konvansiyon seti.
- ●Özel tasarım sistemi. Material yok: UI, Zeus’un kendi token’ları üzerinde Composables UI primitifleri ve Lucide ikonlarıyla kuruldu; uygulama bir framework gibi değil, marka gibi görünüyor.
- ●Contract-first. Mobil API ilk backend aşamasından önce yazıldı, review edildi ve donduruldu; route testleri hem sahte bir CRM’e hem de gerçeğinin kaydedilmiş fixture’larına karşı çalışır.
- ●İlk günden production-grade. Telefon numaraları maskelenmiş yapılandırılmış loglar, Prometheus metrikleri, CRM etrafında circuit breaker ve bulkhead, bulguları kapatılmış bir güvenlik denetimi, runbook’lar ve launch checklist — 200+ otomatik test bunu dürüst tutuyor.
- ●Mağazaya hazır. İngilizce ve Bulgarca çerçeveli mağaza ekran görüntüleri, CRM’e asla ulaşmayan mağaza inceleme sandbox hesapları ve Docker’lı bir release pipeline.
Kullanılabilirlik
Yeni uygulama, mevcut uygulamanın güncellemesi olarak App Store ve Google Play’de Zeus Barbershop müşterilerine sunuluyor; middleware 16 Eylül 2026’dan beri production’da canlı. Hikayenin tamamını Zeus Barbershop proje sayfasında okuyun.