Ana içeriğe geç

Hotspot Yönetim Sistemi

Otel ve kafeler için WiFi hotspot yönetim sistemi. Bu sistem, WiFi erişimlerini yönetmenize, kullanıcı oturumlarını takip etmenize ve detaylı raporlar almanıza olanak sağlar.

🚀 Özellikler​

  • Mekan Yönetimi: Otel ve kafeler için ayrı mekanlar oluşturma ve yönetme
  • Kullanıcı Yönetimi: Rol tabanlı kullanıcı sistemi (Admin, Mekan Admin, Personel)
  • Oturum Takibi: WiFi kullanıcı oturumlarını görüntüleme ve yönetme
  • Raporlama: Detaylı istatistikler ve analiz raporları
  • Modern UI: React ve Tailwind CSS ile modern ve responsive admin paneli
  • API Entegrasyonu: RESTful API v1 ile programatik erişim
  • Esnek Yapı: İster kendi sunucunuzda self-hosted olarak kullanın, ister bulut altyapımızda güvenle yönetin

📋 Sistem Gereksinimleri​

Geliştirme Ortamı​

  • Node.js (v18 veya üzeri)
  • MongoDB (v5 veya üzeri)
  • Redis (queue yönetimi için)
  • npm veya yarn

Docker ile Çalıştırma​

  • Docker Engine 20.10+
  • Docker Compose 2.0+
  • En az 2GB RAM (önerilen: 4GB+)

🛠️ Hızlı Başlangıç​

Docker ile Kurulum (Önerilen)​

Docker ile tüm sistemi tek komutla çalıştırabilirsiniz:

docker-compose up -d

Detaylı kurulum bilgileri için proje README dosyasına bakabilirsiniz.

🎯 İlk Kullanım​

Sistem ilk çalıştırıldığında otomatik olarak kurulum sihirbazı açılacaktır:

  1. Admin Hesabı: İlk admin hesabınızı oluşturun
  2. Site Ayarları: Site adınızı girin
  3. SMTP Ayarları (Opsiyonel): Email gönderimi için SMTP ayarlarını yapılandırın

Kurulum tamamlandıktan sonra otomatik olarak admin paneline yönlendirilirsiniz.

📚 Dokümantasyon İçeriği​

Bu dokümantasyon aşağıdaki konuları kapsar:

  • Sistem Tanıtımı: Genel sistem özellikleri ve mimarisi
  • API v1 Kullanımı: RESTful API endpoint'leri ve kullanım örnekleri
  • Kimlik Doğrulama: API token yönetimi ve güvenlik
  • Hotspot Kullanıcı Yönetimi: Kullanıcı oluşturma, güncelleme ve silme işlemleri

🔐 Güvenlik​

  • Tüm API endpoint'leri API token ile korunmaktadır
  • Token'lar farklı izin seviyelerine sahip olabilir (read, write, delete)
  • Production ortamında güvenli token yönetimi yapılmalıdır

📖 Sonraki Adımlar​