🗓️ Randevu Sistemi Pro v1.0.0

Profesyonel Randevu Yönetim Sistemi - Modern, bulut tabanlı randevu kuyruk yönetim çözümü

📦 Sürüm Dosyaları

🖥️ Windows Çalıştırılabilir Dosyalar (Hazır Kurulum)

Paket	Açıklama	Boyut
RandevuAdmin_v1.0.0.zip	🔴 Yönetici İstemcisi - Resepsiyon/Yönetim arayüzü	~100 MB
RandevuGuest_v1.0.0.zip	🟢 Misafir İstemcisi - Müşteri self-servis kiosk arayüzü	~100 MB

📁 Paket İçeriği

Her paket şunları içerir:

✅ Tek başına çalışan .exe dosyası (onedir yapısı)
✅ Önceden yapılandırılmış ses dosyaları (SND01-sine-sound-pack/)
✅ Ortam şablonu (.env.template)
✅ Kurulum kılavuzu (README.txt)
✅ Tüm çalışma zamanı bağımlılıkları (_internal/)

✨ Temel Özellikler

🔴 Yönetici İstemcisi

Gerçek Zamanlı Dashboard: Otomatik yenilemeli canlı randevu kuyruğu
Akıllı Bildirimler: Yeni randevular için sesli uyarılar
İstatistik Paneli: Toplam, bekleme, kabul edilen, reddedilen sayıları
Sıralama Seçenekleri: Yeniden-eskiye ve eskiden-yeniye sıralama
Eylem Kontrolleri: Anında kabul et, reddet, sil işlemleri
Gizli Ayarlar: Güvenli Supabase yapılandırma arayüzü
Profesyonel UI: Animasyonlu modern koyu tema

🟢 Misafir İstemcisi

Self-Servis Kiosk: Müşteri odaklı randevu oluşturma
Sıra Numarası Sistemi: Otomatik artan numaralandırma
Not Desteği: İsteğe bağlı randevu notları
Başarı Geri Bildirimi: Animasyonlu onay ekranı
Gizli Admin Ayarları: Supabase yapılandırması için footer sağ tık
Bağlantı Testi: Kaydetmeden önce Supabase bağlantısını doğrulama

🏗️ Mimari

Teknoloji Yığını

Frontend:     PyQt6 (Modern Qt6 Python bağlayıcıları)
Backend:      Supabase PostgreSQL (Bulut tabanlı)
Gerçek Zaman: Yoklama mekanizması (3 saniyede bir yenileme)
Ses:          QMediaPlayer WAV desteği
Yapılandırma: python-dotenv ortam yönetimi
Paketleme:    PyInstaller (onedir modu)

Sistem Gereksinimleri

Bileşen	Minimum	Önerilen
İşletim Sistemi	Windows 10 64-bit	Windows 11 64-bit
RAM	2 GB	4 GB
Depolama	100 MB	200 MB
Ağ	İnternet erişimi	Kararlı genişbant

🚀 Hızlı Başlangıç

1. İndir ve Çıkar

Yönetici Bilgisayarı (Resepsiyon/Ofis):

# C:\RandevuAdmin\ klasörüne çıkar
Expand-Archive -Path RandevuAdmin_v1.0.0.zip -DestinationPath C:\RandevuAdmin

Misafir Bilgisayarı (Kiosk/Müşteri Alanı):

# C:\RandevuGuest\ klasörüne çıkar
Expand-Archive -Path RandevuGuest_v1.0.0.zip -DestinationPath C:\RandevuGuest

2. Ortamı Yapılandır

.env.template dosyasını her iki istemci klasöründe .env olarak kopyalayın:

# Supabase Yapılandırması
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_KEY=your-anon-key-here

🔑 Kimlik bilgilerini şuradan alın: Supabase Dashboard → Project Settings → API

3. Uygulamaları Başlat

Sadece .exe dosyalarına çift tıklayın:

RandevuAdmin.exe - Yönetim arayüzü
RandevuGuest.exe - Müşteri kiosk arayüzü

⚙️ Yapılandırma Kılavuzu

Supabase Kurulumu

Proje Oluştur: supabase.com
API Anahtarlarını Al:
- URL: https://<proje>.supabase.co
- Anahtar: anon public anahtarı (service role DEĞİL!)
Şema Çalıştır: setup_supabase.sql dosyasını çalıştırın
RLS'yi Etkinleştir: Satır Düzeyi Güvenlik ilkeleri önceden yapılandırılmıştır

Ağ Gereksinimleri

Protokol	Port	Amaç
HTTPS	443	Supabase API iletişimi
TCP	5432	PostgreSQL (doğrudan bağlantı kullanılıyorsa)

⚠️ Not: İstemciler arasında LAN bağlantısı gerekmez. Her ikisi de bağımsız olarak Supabase bulutuna bağlanır.

🔐 Güvenlik Özellikleri

RLS İlkeleri: Veritabanı düzeyinde erişim kontrolü
Anonim Anahtarlar: Herkese açık API kimlik bilgileri
Yerel Depolama Yok: Tüm veriler şifreli bulutta
Otomatik Güncelleme Tetikleyicisi: Otomatik updated_at zaman damgaları
Bağlantı Doğrulama: API bağlantı testleri

🐛 Sorun Giderme

Antivirüs Uyarıları

Windows Defender EXE dosyasını işaretleyebilir. "Daha fazla bilgi" → "Yine de çalıştır" seçeneğine tıklayın.

Bu PyInstaller çalıştırılabilir dosyaları için normaldir. Tüm dosyalar güvenlidir ve açık kaynaklıdır.

Bağlantı Sorunları

❌ "Bağlantı başarısız" hatası
✅ .env dosyasındaki URL/Anahtar'ı kontrol edin
✅ İnternet bağlantısını doğrulayın
✅ Supabase projesinin aktif olduğundan emin olun

Ses Çalmıyor

❌ Sesli bildirim yok
✅ SND01-sine-sound-pack/ klasörünün EXE ile aynı konumda olduğunu kontrol edin
✅ Windows ses karıştırıcısını kontrol edin
✅ WAV dosyalarının bozuk olmadığını doğrulayın

UI Yüklenmiyor

❌ Siyah/boş pencere
✅ Grafik sürücülerini güncelleyin
✅ Gerekirse Windows 8 uyumluluk modunda çalıştırın
✅ Windows ekran ölçeklendirmesini kontrol edin (%100 önerilir)

📋 Değişiklik Günlüğü

v1.0.0 (2024-03-17)

✨ Yeni Özellikler

İlk Sürüm: Tam randevu yönetim sistemi
Çift İstemci Mimarisi: Ayrı Yönetici ve Misafir arayüzleri
Bulut Veritabanı: Supabase PostgreSQL entegrasyonu
Gerçek Zamanlı Güncellemeler: Yenileme tabanlı canlı güncelleme
Sesli Bildirimler: Yeni randevular için zil sesi uyarıları
Sıralama Geçişi: Yeniden-eskiye / eskiden-yeniye sıralama
Gizli Ayarlar: Her iki istemcide güvenli yapılandırma arayüzü

🎨 UI/UX

Modern koyu tema tasarımı
Animasyonlu butonlar ve geçişler
Tüm ekran boyutlarına duyarlı düzen
Profesyonel Türkçe yerelleştirme
Büyük yazı tipi ile sıra numarası gösterimi

🔧 Teknik

PyQt6 tabanlı GUI çerçevesi
python-dotenv ortam yönetimi
PyInstaller onedir paketleme
Farklı makinelere dağıtıma hazır
Kurulum gerektirmez (taşınabilir)

📝 Ek Kaynaklar

Dokümantasyon

Kaynak Kod

git clone https://github.com/yourusername/RandevuPy.git
cd RandevuPy
python install.py  # Geliştirme ortamı kurulumu

Destek

📜 Lisans

MIT Lisansı

Telif Hakkı (c) 2024 RandevuPy Geliştirme Ekibi

Bu yazılımın ve ilgili dokümantasyon dosyalarının ("Yazılım") bir kopyasını
ücretsiz olarak elde eden herhangi bir kişiye, kullanma, kopyalama, değiştirme,
birleştirme, yayımlama, dağıtma, alt lisans verme ve/veya satma hakları dahil
olmak üzere herhangi bir kısıtlama olmaksızın Yazılımı işleme izni verilir.

Yukarıdaki telif hakkı bildirimi ve bu izin bildirimi, Yazılımın tüm kopyalarına
veya önemli bölümlerine dahil edilecektir.

YAZILIM "OLDUĞU GİBİ" SAĞLANIR, HİÇBİR GARANTİ OLMAKSIZIN, AÇIK VEYA ZIMNİ,
PAZARLANABİLİRLİK, BELİRLİ BİR AMACA UYGUNLUK VE İHLAL ETMEME GARANTİLERİ
DAHİL ANCAK BUNLARLA SINIRLI OLMAMAK ÜZERE.

🙏 Teşekkürler

PyQt6 - Riverbank Computing tarafından Qt6 Python bağlayıcıları
Supabase - Açık kaynak Firebase alternatifi
SND01 Sine Sound Pack - UI ses efektleri https://snd.dev/
Python Topluluğu - Mükemmel kütüphaneler ve destek için

Releases: JustLachin/RandevuPy

v1.0.0