Dokümantasyon
Özellikler & Teknik Detaylar
randevun.com.tr sisteminin tüm özellikleri, nasıl çalıştığı ve teknik detayları bu sayfada dokümante edilmiştir. Sorularınız için bize ulaşın.
randevun Nedir?
Berber & Kuaför için SaaS Randevu Sistemi
randevun.com.tr; berber, kuaför ve güzellik salonu işletmelerine özel geliştirilmiş, bulut tabanlı bir randevu ve yönetim platformudur. Müşterilerinizin 7/24 online randevu almasını sağlar, SMS ile doğrular ve hatırlatma gönderir. Siz admin panelinden tüm işletmenizi yönetirsiniz.
- Mobil uyumlu müşteri randevu sayfası
- Güçlü admin yönetim paneli
- SMS OTP doğrulama + otomatik hatırlatma
- Muhasebe, raporlama ve müşteri yönetimi
- Çoklu personel ve hizmet desteği
Teknik Mimari
| Katman | Teknoloji | Açıklama |
|---|---|---|
| Frontend | HTML5 / CSS3 / Vanilla JS | Framework bağımsız, hızlı yükleme. PWA uyumlu. |
| Backend | PHP 8+ | RESTful API mimarisi. CSRF korumalı endpoint'ler. |
| Veritabanı | MySQL / MariaDB | Normalize edilmiş şema. Prepared statement ile SQL injection koruması. |
| SMS | VatanSMS API | Türkiye'nin önde gelen SMS altyapısı. 1'e N mesajlaşma. OTP + bilgi SMS desteği. |
| Bot Koruması | Cloudflare Turnstile | Görünmez CAPTCHA. Sahte randevu bot saldırılarına karşı koruma. |
| Rate Limiting | PHP RateLimiter | OTP ve randevu endpoint'lerinde dakika bazlı istek sınırlandırma. |
| Tema Sistemi | CSS Variables + Data-attribute | 4 hazır tema. Logo + işletme adı kişiselleştirme. |
| CRON | Server Cron Job | Her 5–10 dakikada hatırlatma SMS kuyruğunu çalıştırır. |
SMS OTP Doğrulama
Önemli Özellik
Nasıl Çalışır?
Müşteri randevu özetini onaylamadan önce, girdiği telefon numarasına 6 haneli bir doğrulama kodu SMS ile gönderilir. Kodu doğru giren müşteri randevuyu tamamlayabilir. Bu sayede sahte numara ile randevu alınması engellenir.
- VatanSMS API üzerinden anlık SMS gönderimi
- 6 haneli zaman sınırlı OTP kodu
- Rate limiter: aynı numaraya dakikada maksimum istek sınırı
- Cloudflare Turnstile ile bot koruması ek katmanı
- Yanlış kod girildiğinde hata bildirimi
Faydası: Sahte veya yanlış telefon numarasıyla alınan randevular, hatırlatma SMS'i gönderilemeyen "hayalet randevular" oluşturur. OTP doğrulama bu sorunu tamamen ortadan kaldırır.
Otomatik SMS Hatırlatıcı
Önemli Özellik
Randevudan 1 Saat Önce Otomatik SMS
Sunucuda çalışan CRON job, her 5–10 dakikada bir "1 saat sonrası olan onaylı randevuları" tarar. Bu randevulardaki müşterilere işletme adınızla kişiselleştirilmiş hatırlatma SMS'i gönderir.
- Yalnızca "onaylı" statüsündeki randevular için çalışır
- Her randevuya sadece bir kez hatırlatma gönderilir (tekrar gönderim yok)
- SMS içeriğinde işletme adı dinamik olarak eklenir
- VatanSMS altyapısı: Türkiye geneli yüksek teslimat oranı
- Başarısız gönderimler loglanır
Etki: Hatırlatma SMS'i gönderilen işletmelerde "randevuya gelmeme" oranı %40–60 azalır. Boş saat = kaybedilen gelir. Bu özellik doğrudan kârlılığı artırır.
Online Randevu Sayfası
Müşteriye Özel Randevu Linki
Her işletmeye özel subdomain veya URL verilir. Müşteri bu sayfayı telefonundan açarak 5 adımda randevu alır. Sayfa tamamen mobil optimize edilmiştir; uygulama indirmeye gerek yoktur.
- Instagram bio, WhatsApp, web sitesi entegrasyonu
- Mobil uyumlu (responsive), PWA desteği
- İşletme logosu ve teması ile markalı görünüm
- Sadece aktif personeller ve müsait saatler gösterilir
- İptal tokenı ile müşteri kendi randevusunu iptal edebilir
Randevu Akışı — 5 Adım
| Adım | Ekran | Açıklama |
|---|---|---|
| 1 | Berber Seçimi | Aktif ve çalışan personeller listelenir. Müşteri birini seçer. |
| 2 | Hizmet Seçimi | Seçilen berberin sunduğu hizmetler fiyat ve süre ile gösterilir. Birden fazla seçilebilir. |
| 3 | Tarih & Saat | Müsait günler ve saatler hesaplanarak gösterilir. Dolu saatler kırmızı görünür. |
| 4 | İletişim Bilgileri | Ad, soyad, telefon numarası girilir. KVKK onayı alınır. |
| 5 | OTP Doğrulama & Onay | Telefona gelen 6 haneli SMS kodu girilir. Randevu tamamlanır, SMS onayı gönderilir. |
Hızlı Ajanda
Admin Paneli
Görsel Personel Ajandası
Tüm personellerin saatlik randevu durumu tek ekranda grid görünümünde izlenir. Her sütun bir personeli, her satır bir zaman dilimini temsil eder. Dolu hücreler randevu bilgilerini gösterir; boş hücreler tıklanabilirdir.
- İleri/geri tarih gezintisi
- Boş saate tıklayarak anında Quick Booking (Hızlı Randevu)
- Dolu randevuya tıklayarak düzenleme ve iptal
- Tarih seçici ile istenen güne atlama
- Onaylı randevular yeşil, bekleyenler sarı renkte
Quick Booking — Hızlı Randevu
Ajandada boş bir hücreye tıklandığında açılan bottom sheet ile müşteri adı, hizmet seçimi ve onay 3 adımda tamamlanır. Eski müşteri seçimi için anlık arama, yeni müşteri için form mevcut.
- Eski müşteri seçimi: tüm müşteriler ziyaret sayısına göre sıralı, arama destekli
- Yeni müşteri formu: ad, telefon, otomatik numara temizleme
- Birden fazla hizmet seçilebilir
- Telefon paste desteği: +90, 0 veya formatlanmış numaralar otomatik temizlenir
Manuel Randevu
Admin Paneli
Adım Adım Randevu Oluşturma
Telefon üzerinden gelen müşteriler için admin, 3 adımlı stepper formdan müşteri bilgisi → personel/hizmet → tarih/saat sırasıyla randevu oluşturur.
- Müşteri adı ve telefon girişi (paste desteği ile)
- Personel ve hizmet chip seçimi
- Müsait saatler otomatik listelenir, mesai dışı manuel saat de girilebilir
Randevu Düzenleme (Reschedule)
Mevcut randevuya tıklanarak tarih, başlangıç ve bitiş saati değiştirilebilir. Müsait saatler listelenir, manuel saat girişi de desteklenir.
- Yeni tarih seçimi ile müsait saatler yeniden yüklenir
- Bitiş saati otomatik hesaplanır, elle değiştirilebilir
- Randevu iptal butonu aynı ekranda
Muhasebe & Ciro Raporları
Önemli Özellik
Otomatik Muhasebe (Randevu Bazlı)
Tamamlanan randevuların hizmet fiyatları otomatik olarak muhasebe kayıtlarına işlenir. Anlık dashboard ile günlük, haftalık, aylık ve yıllık ciro özeti görüntülenir.
- Personel bazlı filtre: tek bir berberin cirosunu izle
- Tarih aralığı raporu: başlangıç–bitiş seçerek detaylı liste
- Gün bazlı randevu sayısı ve ciro dökümü
- Toplam hesaplama ve TL formatlaması
Manuel Muhasebe
Nakit satış, bahşiş veya ürün satışı gibi sisteme girmeyen gelirleri tarih bazlı manuel olarak kaydedebilirsiniz. Personel başına günlük net kazanç takibi.
Müşteri Yönetimi
Müşteri Listesi & Arama
Tüm müşterilerin listesi ziyaret sayısına göre sıralanmış şekilde görüntülenir. İsim veya telefon ile anlık arama. Personel filtresi ile "sadece bu berberin müşterileri" görünümü.
- Ziyaret sayısı, son ziyaret tarihi, iletişim bilgileri
- Personel bazlı filtreleme
- İsim veya telefon ile client-side anlık arama
Kara Liste & Ceza Sistemi
Gelir Koruma
Cezalı Müşteri Takibi
Randevuya gelmeyen müşteriler sistem tarafından otomatik olarak işaretlenir. Belirli sayıda gelmeme durumunda veya manuel kararla müşteri kalıcı olarak engellenir.
- Randevuya gelmeme detay sayfası (kaç kez, hangi tarihler)
- Tek tıkla engelleme veya engel kaldırma
- Manuel engelleme: telefon numarası girerek direkt blok
- Engellenen numara online randevu alamaz
- Engel listesi yönetimi: istendiğinde kaldırılabilir
Neden Önemli: Boş geçen randevu saati = direkt gelir kaybı. Kara liste sistemi, kronik olarak gelmeyen müşterilerin sizi boş oturmaya zorlamasını önler.
Personel Yönetimi
Sınırsız Personel
İstediğiniz sayıda personel ekleyebilirsiniz. Her personelin adı, unvanı ve randevu aralığı (5, 10, 15, 30 dk...) bağımsız tanımlanır.
- Aktif / Pasif durumu (pasif personel müşteride görünmez)
- Her personele özel hizmet listesi ve fiyatlar
- Randevu aralığı (time_interval): kaç dakikada bir slot açılacak
- Ad, unvan düzenleme; anlık liste yenileme
Hizmet Tanımlama
Personel Bazlı Hizmetler
Sisteme global hizmetler tanımlanır (Saç Kesimi, Sakal Tıraşı, Boya vs.). Her personel kendi sunacağı hizmetleri aktif eder ve kendi fiyat/süresini belirler.
- Hizmet adı, ikon seçimi (20+ hazır SVG ikon)
- Personel bazlı fiyat (farklı personeller farklı fiyat uygulayabilir)
- Süre (dakika): müsait slot hesaplamasında kullanılır
- Çoklu hizmet seçimi: müşteri aynı randevuya birden fazla hizmet ekleyebilir
Mesai & İzin Takvimi
Haftalık Çalışma Saatleri
Her personel için Pazartesi–Pazar günlük açılış/kapanış saatleri ayrı ayrı tanımlanır. Kapalı günler toggle ile işaretlenir.
- Gün bazlı başlangıç–bitiş saati
- İzinli gün toggle (o gün sistem randevu kabul etmez)
- Anlık kayıt, hemen geçerli
Özel İzin Günleri
Bayram, hastalık, kişisel izin gibi özel günler tarih ve açıklama ile eklenir. O günlerde sistem otomatik olarak randevu kabul etmez.
Rol Yönetimi
Admin & Personel Rolleri
İki farklı kullanıcı tipi mevcuttur. Admin tüm panele erişir; personel sadece kendi ajanda ve randevularını görür.
- Admin: Tüm modüller, muhasebe, kullanıcı yönetimi, ayarlar
- Personel: Kısıtlı erişim — ajanda ve randevu görüntüleme
- Sınırsız kullanıcı oluşturma
- Şifre değiştirme, rol güncelleme
Marka & Tema Kişiselleştirme
İşletme Kimliği
Müşteri randevu sayfası tamamen işletmenizin kimliğini yansıtır. Logo, isim, harita linki ve tema rengi admin panelinden kolayca değiştirilir.
- Logo yükleme (PNG/JPG/SVG)
- İşletme adı ve Google Maps linki
- İletişim telefonu
- 4 hazır tema: Modern (açık), Karanlık, Canlı (pembe), Klasik (krem)
Güvenlik
Çok Katmanlı Güvenlik
Sistem birden fazla güvenlik katmanıyla korunmaktadır.
- CSRF Token: Her admin API isteği token ile doğrulanır
- SQL Injection: Tüm sorgular Prepared Statement kullanır
- Rate Limiter: OTP ve randevu endpoint'lerinde dakika bazlı istek sınırı
- Cloudflare Turnstile: Bot randevularına karşı görünmez CAPTCHA
- SMS OTP: Gerçek telefon doğrulaması — sahte randevu sıfırlanır
- KVKK Uyumluluk: Müşteri onay metni, opt-out bağlantısı
Daha fazla teknik detay veya özel entegrasyon ihtiyacı için iletişime geçin.