hostadmin
/
hosting-platform
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
hosting-platform/README_WORKFLOW.md

5.8 KiB
Raw Blame History

🚀 Hosting Platform - İş Akışı Dokümantasyonu

Müşteri ve Admin panellerinin tüm iş akışlarını görsel diyagramlar ve detaylı açıklamalarla içeren kapsamlı dokümantasyon.

📚 Dokümantasyon Dosyaları

1. 📊 WORKFLOW_DIAGRAMS.md

Tüm görsel diyagramların açıklamaları ve kullanım kılavuzu.

İçerik:

  • Genel iş akışları (Müşteri + Admin)
  • Domain setup detaylı sequence diagram
  • API endpoint yapısı
  • Veritabanı şemaları (ER diagrams)
  • Sistem mimarisi

2. 📖 WORKFLOW_DOCUMENTATION.md

Detaylı teknik dokümantasyon ve API referansı.

İçerik:

  • Proje genel bakış
  • Müşteri panel iş akışları (adım adım)
  • Admin panel iş akışları (adım adım)
  • Tüm API endpoint'lerin detaylı açıklaması
  • Veritabanı SQL şemaları
  • Sistem mimarisi ve deployment
  • Güvenlik yapılandırması
  • Monitoring ve logging

🎯 Hızlı Başlangıç

Müşteri Panel İş Akışı Özeti

1. Kayıt/Giriş → JWT Token
2. Dashboard → Domain Listesi
3. Domain Ekle:
   ├─ Domain Doğrula
   ├─ CF Hesap Seç (Company/Own)
   ├─ Zone Doğrula
   ├─ NS Kontrolü
   ├─ DNS Önizleme
   ├─ DNS Uygula
   ├─ SSL Yapılandır
   └─ Kaydet
4. Container Deploy (opsiyonel)
5. Plan Yükselt (opsiyonel)

Admin Panel İş Akışı Özeti

1. Admin Giriş → JWT + Audit Log
2. Dashboard → İstatistikler
3. Yönetim:
   ├─ Müşteriler (Liste, Detay, Plan Güncelle)
   ├─ Planlar (CRUD, Limit Ayarla)
   ├─ CF Hesapları (CRUD, Token Şifrele)
   └─ Audit Logs (Görüntüle, Filtrele)

🔍 Görsel Diyagramlar

Tüm diyagramlar interaktif Mermaid formatında oluşturulmuştur ve düzenlenebilir.

Mevcut Diyagramlar

  1. Müşteri Panel - Genel İş Akışı

    • Kimlik doğrulama
    • Dashboard navigasyonu
    • Domain yönetimi (8 adım)
    • Container deployment
    • Abonelik yönetimi

  2. Admin Panel - Genel İş Akışı

    • Admin authentication
    • Müşteri yönetimi
    • Plan yönetimi
    • CF hesap yönetimi
    • Audit sistemi

  3. Domain Setup - Sequence Diagram

    • Kullanıcı → Frontend → API → Database → Cloudflare
    • Tüm adımların detaylı akışı
    • Hata senaryoları

  4. API Endpoint Yapısı - Müşteri Panel

    • 5 ana kategori
    • 20+ endpoint

  5. API Endpoint Yapısı - Admin Panel

    • 5 ana kategori
    • 15+ endpoint

  6. Veritabanı Şeması - Müşteri Panel

    • 5 ana tablo
    • İlişkiler (ER diagram)

  7. Veritabanı Şeması - Admin Panel

    • 4 ana tablo
    • İlişkiler (ER diagram)

  8. Sistem Mimarisi - Genel Bakış

    • 6 katman
    • Tüm bileşenler ve bağlantılar

  9. Kimlik Doğrulama Akışı

    • Müşteri vs Admin karşılaştırması
    • Güvenlik katmanları

  10. Data Flow - Sistem Geneli

    • Kullanıcıdan infrastructure'a veri akışı
    • Tüm servisler arası iletişim

🛠️ Diyagramları Düzenleme

Tüm diyagramlar Mermaid syntax ile oluşturulmuştur. Düzenlemek için:

Online Editör

  1. Mermaid Live Editor açın
  2. Diyagram kodunu kopyalayın
  3. Düzenleyin ve önizleyin
  4. Export edin (PNG, SVG, PDF)

VS Code

  1. "Markdown Preview Mermaid Support" eklentisini yükleyin
  2. Markdown dosyasını açın
  3. Preview'da diyagramları görün

Örnek Mermaid Kodu

graph TB
    A[Başlangıç] --> B{Karar}
    B -->|Evet| C[İşlem 1]
    B -->|Hayır| D[İşlem 2]
    C --> E[Son]
    D --> E

📋 API Endpoint Hızlı Referans

Müşteri Panel (Port 5000)

Kategori Endpoint Method Açıklama
Auth /api/auth/register POST Yeni kullanıcı kaydı
Auth /api/auth/login POST Kullanıcı girişi
Customer /api/customer/domains GET Domain listesi
DNS /api/dns/validate-domain POST Domain doğrulama
DNS /api/dns/apply-changes POST DNS değişikliklerini uygula

Admin Panel (Port 5001)

Kategori Endpoint Method Açıklama
Auth /api/auth/login POST Admin girişi
Plans /api/plans GET/POST Plan listesi/oluştur
CF Accounts /api/cf-accounts GET/POST CF hesap yönetimi
Customers /api/customers GET Müşteri listesi
Audit /api/audit/logs GET Audit log listesi

🔒 Güvenlik Özeti

  • Authentication: JWT tokens (24 saat geçerlilik)
  • Password: bcrypt hashing
  • API Tokens: Fernet encryption
  • CORS: Domain-specific policies
  • Database: Separate databases (isolation)
  • HTTPS: Cloudflare SSL (Full mode)

📊 Veritabanı Özeti

Müşteri Panel (hosting_db)

  • users: 5 tablo
  • customers: Kullanıcı hesapları
  • domains: Müşteri profilleri
  • dns_records: Domain kayıtları
  • cloudflare_accounts: DNS detayları

Admin Panel (admin_hosting_db)

  • admin_users: 4 tablo
  • subscription_plans: Admin hesapları
  • cloudflare_accounts: Abonelik planları
  • audit_logs: Audit kayıtları

🚀 Deployment Özeti

# Frontend Build
cd MusteriPanel/frontend && npm run build
cd AdminPanel/frontend && npm run build

# Database Migration
cd MusteriPanel/backend && flask db upgrade
cd AdminPanel/backend && flask db upgrade

# Start Services
sudo supervisorctl start all

📞 İletişim ve Destek

Son Güncelleme: 2024-01-12
Versiyon: 1.0.0
Durum: ✅ Production Ready