Architecture Hybride : Le Meilleur des Deux Mondes avec Supabase et Spring Boot

@startuml
skinparam backgroundColor #FEFEFE
skinparam componentStyle rectangle

package "Geleneksel mimari" {
  actor Utilisateur as user
  component "Ön uç" as frontend #LightBlue
  component "Monolitik backend" as backend #LightCoral {
    [Authentification]
    [CRUD]
    [Logique Métier]
    [Jobs]
    [APIs Tierces]
  }
  database "Veritabanı" as db #LightGray

  user --> frontend
  frontend --> backend : Tüm istekler
  backend --> db
}

note right of backend
Her şey backend üzerinden geçer
basit işlemler bile
⚠️ Tek bir tıkanıklık noktası
⚠️ Başlangıç karmaşıklığı
⚠️ Güçlü bağlantı
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam componentStyle rectangle

package "Mimari BaaS sade" {
  actor Utilisateur as user
  component "ön uç" as frontend #LightBlue
  cloud "Supabase / Firebase" as baas #LightGreen {
    [Auth]
    [Database]
    [Storage]
    [Edge Functions]
  }

  user --> frontend
  frontend --> baas : Tüm işlemler
}

note right of baas
Hızlı geliştirme
Yönetilecek sunucu yok
⚠️ Karmaşık mantık için sınırlı
⚠️ Satıcı bağımlılığı
⚠️ Edge Functions için kısıtlamalar
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam componentStyle rectangle

actor Utilisateur as user #LightBlue

package "Frontend Katmanı" {
  component "Statik Site JBake" as frontend #SkyBlue
}

package "Basit Katman (Supabase)" #LightGreen {
  component "Kimlik Doğrulaması" as auth
  component "CRUD Temel" as crud
  component "Dosya Depolama" as storage
  component "Gerçek Zamanlı" as realtime
}

package "İş Katmanı (Spring Boot)" #Coral {
  component "Karmaşık Mantık" as logic
  component "Orkestreleme" as orchestration
  component "Zamanlanmış İşler" as jobs
  component "Entegrasyonlar" as integrations
}

database "PostgreSQL Paylaşılan" as db #LightGray

user --> frontend

frontend --> auth : OAuth2, JWT
frontend --> crud : Makaleler, Profiller
frontend --> storage : Resimler, Dosyalar
frontend --> realtime : Bildirimler

frontend --> logic : Hesaplamalar, Raporlar
frontend --> orchestration : İş akışları
logic --> integrations : Stripe, APIs
orchestration --> db
jobs --> db

crud --> db
auth --> db

note bottom of db
Tek bir doğruluk kaynağı Supabase ve Spring Boot arasında paylaşılan
end note

note right of auth
50k kullanıcıya kadar ücretsiz
Birkaç tıklama ile yapılandırma
OAuth2 çoklu sağlayıcı
end note

note right of logic
Etkinleştirildi sadece gerektiğinde
Kotlin + Coroutines
Karmaşık işlemler
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE

rectangle "Phase 1 : MVP" #LightGreen {
  component "JBake + Supabase" as mvp
  note right
✓ Gün içinde geliştirme
✓ Maliyet: 0€
✓ Kavram doğrulama
  end note
}

rectangle "**Phase 2 : Büyüme**" #LightYellow {
  component "JBake + Supabase\n+ Spring Boot (opsiyonel)" as growth
  note right
✓ İş mantığı ortaya çıkıyor
✓ İlk planlanmış işler
✓ Üçüncü taraf entegrasyonları
  end note
}

rectangle "**Phase 3 : Ölçek**" #LightCoral {
  component "Tam Mimari" as scale
  note right
✓ Karmaşık orkestrasyon
✓ İyileştirilmiş performans
✓ Dağıtılmış cache
  end note
}

mvp -down-> growth : Karmaşıklık gerekçelendiğinde
growth -down-> scale : Optimizasyon\ndevam
@enduml

@startmindmap
skinparam backgroundColor #FEFEFE
* Opérations\nApplicatives

left side

** Opérations Simples\n(Supabase)
***_ CRUD Standard
****_ Lecture
****_ Création
****_ Mise à jour
****_ Suppression
***_ Authentification
****_ Login/Logout
****_ OAuth2
****_ Gestion session
***_ Stockage
****_ Upload fichiers
****_ CDN automatique
***_ Temps Réel
****_ WebSocket
****_ Notifications

right side

** Opérations Complexes\n(Spring Boot)
***_ Logique Métier
****_ Calculs complexes
****_ Règles métier
****_ Validations avancées
***_ Orchestration
****_ Multi-services
****_ Transactions distribuées
****_ Saga patterns
***_ Tâches Planifiées
****_ Rapports périodiques
****_ Synchronisations
****_ Nettoyages
***_ Intégrations
****_ Paiements (Stripe)
****_ APIs tierces
****_ Services ML/AI

@endmindmap

@startuml
skinparam backgroundColor #FEFEFE

database "PostgreSQL" as db #LightGray {
  package "Şema: auth (Supabase)" #LightGreen {
    [users]
    [sessions]
    [identities]
  }

  package "public (paylaşılan)" #SkyBlue {
    [articles]
    [comments]
    [profiles]
  }

  package "Şema: iş (Spring Boot)" #Coral {
    [orders]
    [payments]
    [reports]
  }
}

component "Supabase" as supabase #LightGreen
component "Spring Boot" as spring #Coral

supabase -down-> users : Yönetir
supabase -down-> sessions : yönetir
supabase -down-> articles : Eriş
supabase -down-> comments : Eriş
supabase -down-> profiles : Eriş

spring -down-> articles : Eriş
spring -down-> profiles : Erişin
spring -down-> orders : Yönetir
spring -down-> payments : Yönetir
spring -down-> reports : Yönetir

note right of db
**Avantajlar :**
• Karmaşık senkronizasyon yok
• JOINs olası tablolar arasında
• Garantili tutarlılık
• Birleşik göçler
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE
autonumber

actor "Kullanıcı" as user
participant "JBake" as jbake
participant "Supabase Yetkilendirme" as auth
participant "Spring Boot" as spring
database "PostgreSQL" as db

== Authentification ==
user -> jbake : Clique "Giriş yap"
jbake -> auth : Yönlendirme OAuth2 (Google/GitHub)
auth -> user : Onay ekranı
user -> auth : Izini verir
auth -> auth : Üret JWT
auth -> jbake : JWT + Refresh Token'i döndürür
jbake -> jbake : Jetoları stokla (sessionStorage)

== Accès aux Ressources ==
group Opération Simple (CRUD)
  user -> jbake : Bir makale oluştur
  jbake -> db : POST ile JWT
  note right: Supabase Row Level Security\nOtomatik olarak JWT'i doğrular
  db -> jbake : Makale oluşturuldu
end

group Opération Complexe (Métier)
  user -> jbake : Bir rapor oluştur
  jbake -> spring : POST /api/reports\nile JWT
  spring -> spring : Doğrula JWT Supabase
  spring -> spring : Çıkarılan talepler (user_id, roller)
  spring -> db : Karmaşık sorgular
  spring -> jbake : Oluşturulan rapor
end

note over auth, spring
**JWT evrensel**
Supabase ET Spring Boot tarafından geçerli
double kimlik doğrulaması yok
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE
autonumber

actor "Müşteri" as user
participant "JBake" as jbake
participant "Spring Boot" as spring
participant "Supabase Veritabanı" as supadb
participant "Stripe API" as stripe
participant "Envanter Servisi" as inventory
participant "E-posta Servisi" as email
database "PostgreSQL" as db

user -> jbake : Sipariş ver
jbake -> spring : POST /api/orders/create

== Orchestration Spring Boot ==
spring -> db : BEGIN TRANSACTION

par Vérifications Parallèles
  spring -> inventory : Stok Kontrolü
  inventory -> spring : Stok OK
else
  spring -> db : Müşteri profilini kontrol et
  db -> spring : Doğrulanmış müşteri
end

spring -> stripe : Payment Intent Oluştur
stripe -> spring : Oluşturulan intent (ID: pi_xxx)

spring -> db : Oluştur Order (durum: PENDING)
db -> spring : Sipariş oluşturuldu

spring -> stripe : Ödemeyi onayla
stripe -> spring : Ödeme onaylandı

spring -> db : Siparişi Güncelle (durum: PAID)
spring -> inventory : Stok azalt
spring -> db : COMMIT TRANSACTION

par Notifications Asynchrones
  spring -> email : E-posta Onayı
else
  spring -> supadb : Bildirim ekle
  note right: Gerçek zamanlı bildirim\nvia Supabase Realtime
end

spring -> jbake : Sipariş onaylanmış
jbake -> user : Onay göster

note over spring
Spring Boot Sorumlulukları:
• İşlem ACID
• Çok hizmetli orkestrasyon
• Otomatik rollback hatada
• Sınır durumu yönetimi
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE

participant "Zamanlayıcı\n(Spring Boot)" as scheduler
participant "Rapor Hizmeti" as report
participant "PostgreSQL" as db
participant "Harici API" as api
participant "E-posta Hizmeti" as email
participant "Supabase Depolama" as storage

== Job Quotidien : 2 saat 00 ==
activate scheduler
scheduler -> report : Rapor üretimini tetikler

activate report
report -> db : Son 24 saatlik veriyi getir
db -> report : Veri seti

report -> report : Hesaplamalar & Toplamlar
report -> report : Üretim PDF

report -> storage : Yükle PDF
storage -> report : URL publique

report -> email : Yöneticilere gönder\nPDF linkiyle
deactivate report

== Job Hebdomadaire : Pazar 3:00 ==
scheduler -> report : dış senkronizasyon

activate report
report -> api : Harici verileri çek
api -> report : Yeni veriler

report -> db : Tablolar güncelleme
report -> db : Eski veri temizliği
deactivate report

== Job Mensuel : Ayın ilk günü ==
scheduler -> report : Fatura

activate report
report -> db : Aktif müşteri listesi
report -> report : Miktar hesaplama
report -> api : Fatura oluşturma (Stripe)
report -> email : Faturaların gönderimi
deactivate report

deactivate scheduler

note right of scheduler
Supabase ile yalnızca yapılamaz.
Edge Functions uygunsuz
Uzun ve yinelenen işler için
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE

start

:Uygulanacak yeni özellik;

if (CRUD simple ?) then (oui)
  :✅ **Supabase**;
  stop
else (non)
  if (Authentification ?) then (oui)
    :✅ **Supabase Kimlik Doğrulama;
    stop
  else (non)
    if (Upload fichiers ?) then (oui)
      :✅ **Supabase Depolama;
      stop
    else (non)
      if (Temps réel ?) then (oui)
        :✅ **Supabase Gerçek zamanlı;
        stop
      else (non)
        if (Row Level Security\nsuffisante ?) then (oui)
          :✅ **Supabase + Policies**;
          stop
        else (non)
          :⚠️ **Spring Boot'u düşünün**;
          #Coral:Passer à l'arbre\nde décision Spring Boot;
          stop
        endif
      endif
    endif
  endif
endif

@enduml

@startuml
skinparam backgroundColor #FEFEFE

start

:Yeni karmaşık özellik;

if (Orchestration\nmulti-services ?) then (oui)
  :✅ **Spring Boot**;
  stop
else (non)
  if (Transaction ACID\ncritique ?) then (oui)
    :✅ **Spring Boot**;
    stop
  else (non)
    if (Job planifié ?) then (oui)
      :Spring Boot Zamanlayıcı;
      stop
    else (non)
      if (Intégration API\ntierce complexe ?) then (oui)
        :✅ **Spring Boot**;
        stop
      else (non)
        if (Calculs lourds\n> 10 secondes ?) then (oui)
          :✅ Spring Boot;
          stop
        else (non)
          if (Cache distribué\nnécessaire ?) then (oui)
            :✅ **Spring Boot + Redis**;
            stop
          else (non)
            :Muhtemelen Supabase;
            #LightGreen:Revenir à l'arbre\nde décision Supabase;
            stop
          endif
        endif
      endif
    endif
  endif
endif

@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam componentStyle rectangle

package "Kişisel Blog - 95% Supabase" {
  component "JBake" as jbake #SkyBlue

  package "Supabase (Ücretsiz)" #LightGreen {
    [Auth: OAuth2 Google]
    [Articles (CRUD)]
    [Commentaires]
    [Images (Storage)]
    [Notifications Realtime]
  }

  package "Spring Boot (Opsiyonel)" #LightCoral {
    [Newsletter Mensuelle]
    note bottom: Sadece zamanlanmış iş
  }

  database "PostgreSQL" as db

  jbake --> [Auth: OAuth2 Google]
  jbake --> [Articles (CRUD)]
  jbake --> [Commentaires]
  jbake --> [Images (Storage)]
  jbake --> [Notifications Realtime]

  [Articles (CRUD)] --> db
  [Commentaires] --> db
  [Newsletter Mensuelle] --> db
}

note bottom of "Spring Boot (Opsiyonel)"
Spring Boot zorunlu değil
Bülten yönetilebilir
bir üçüncü taraf hizmet tarafından (Mailchimp)
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam componentStyle rectangle

package "Uygulama SaaS - Mimari Hibrit" {
  component "JBake / React" as frontend #SkyBlue

  package "Supabase" #LightGreen {
    [Auth Multi-tenant]
    [Profils Utilisateurs]
    [Données Simples]
    [Storage Documents]
  }

  package "Spring Boot" #Coral {
    [Facturation (Stripe)]
    [Analytics Avancées]
    [Rapports Mensuels]
    [Quotas & Limites]
    [Webhooks Stripe]
  }

  cloud "Servisler Harici" {
    [Stripe API]
    [SendGrid Email]
  }

  database "PostgreSQL Paylaşılmış" as db

  frontend --> [Auth Multi-tenant]
  frontend --> [Profils Utilisateurs]
  frontend --> [Données Simples]
  frontend --> [Facturation (Stripe)]
  frontend --> [Analytics Avancées]

  [Auth Multi-tenant] --> db
  [Profils Utilisateurs] --> db
  [Données Simples] --> db

  [Facturation (Stripe)] --> db
  [Facturation (Stripe)] --> [Stripe API]
  [Analytics Avancées] --> db
  [Rapports Mensuels] --> db
  [Rapports Mensuels] --> [SendGrid Email]
  [Webhooks Stripe] ..> [Stripe API] : Écoute
}

note right of "Spring Boot"
Gerekenler:
• Abonelik yönetimi
• Yinelenen faturalama
• Dinamik kotalar
• Karmaşık analizler
• Güvenilir webhook'lar
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam componentStyle rectangle

package "Elektronik Ticaret - %70 Spring Boot" {
  component "Mağaza önü (JBake/React)" as frontend #SkyBlue

  package "Supabase" #LightGreen {
    [Auth Clients]
    [Catalogue Produits\n(lecture seule)]
    [Images Produits]
  }

  package "Spring Boot (İşletme Çekirdeği)" #Coral {
    [Gestion Commandes]
    [Paiements Stripe]
    [Gestion Stock]
    [Calcul Frais Port]
    [Génération Factures]
    [Synchronisation ERP]
    [Emails Transactionnels]
  }

  cloud "Entegrasyonlar" {
    [Stripe]
    [Transporteur API]
    [ERP Externe]
  }

  database "PostgreSQL" as db

  frontend --> [Auth Clients]
  frontend --> [Catalogue Produits\n(lecture seule)]
  frontend --> [Gestion Commandes]

  [Auth Clients] --> db
  [Catalogue Produits\n(lecture seule)] --> db

  [Gestion Commandes] --> db
  [Paiements Stripe] --> [Stripe]
  [Gestion Stock] --> db
  [Calcul Frais Port] --> [Transporteur API]
  [Génération Factures] --> db
  [Synchronisation ERP] --> [ERP Externe]
  [Synchronisation ERP] --> db
}

note right of "Spring Boot (İşletme Çekirdeği)"
Spring Boot gereklidir:
• Kritik işlemler
• Karmaşık orkestrasyon
• Çoklu entegrasyonlar
• Yasal uyumluluk
• Senkronizasyon işleri
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE

package "Tahmini Aylık Maliyetler" {

  rectangle "Aşama MVP\n(0-1000 users)" #LightGreen {
    [JBake (GitHub Pages): 0€]
    [Supabase: 0€]
    [Spring Boot: N/A]
    note bottom: **Toplam: 0€/mois**
  }

  rectangle "Aşama Büyüme\n(1k-10k users)" #LightYellow {
    [JBake (GitHub Pages): 0€]
    [Supabase: 0€]
    [Spring Boot (Cloud Run): 20-50€]
    [PostgreSQL (si séparé): 0-30€]
    note bottom: Toplam: 20-80€/mois
  }

  rectangle "Aşama Ölçek\n(10k-100k users)" #LightCoral {
    [JBake (Netlify Pro): 19€]
    [Supabase Pro: 25€]
    [Spring Boot (instances multiples): 100-300€]
    [Redis Cache: 20-50€]
    [Monitoring: 20€]
    note bottom: **Toplam: 184-414€/mois**
  }
}

note right of "Aşama Ölçek\n(10k-100k users)"
Bu aşamada, gelirler maliyetleri geniş ölçüde haklı çıkarır
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE

package "Kim Ne Yönetiyor?" {

  rectangle "Supabase tarafından yönetiliyor (0 çaba)" #LightGreen {
    [Authentification]
    [Base de données]
    [Backups automatiques]
    [Scaling automatique]
    [Monitoring DB]
    [Sécurité DB]
  }

  rectangle "GitHub tarafından yönetiliyor (0 çaba)" #SkyBlue {
    [Hébergement site statique]
    [HTTPS/SSL]
    [CDN global]
    [Déploiement automatique]
  }

  rectangle "(Spring Boot) yönetimi" #LightCoral {
    [Déploiement application]
    [Monitoring APM]
    [Logs centralisés]
    [Scaling horizontal]
    [Mises à jour sécurité]
  }
}

note bottom of "(Spring Boot) yönetimi"
Minimize edilebilir:
• Cloud Run (sunucusuz)
• Kubernetes (gerekirse)
• Yönetilen hizmetler (RDS, vb.)
end note
@enduml

@startmindmap
skinparam backgroundColor #FEFEFE
* Architecture\nHybride

** Commencer Simple
***_ MVP avec Supabase
***_ 0€ de coût initial
***_ Validation rapide

** Évoluer Intelligemment
***_ Ajouter Spring Boot\nsi nécessaire
***_ Migration progressive
***_ Pas de refonte totale

** Exploiter les Forces
***_ Supabase: Simplicité
***_ Spring Boot: Puissance
***_ PostgreSQL: Source unique

** Minimiser la Complexité
***_ Pas de synchronisation
***_ Pas de duplication
***_ Architecture claire

** Optimiser les Coûts
***_ Gratuit au départ
***_ Scaling progressif
***_ ROI évident

@endmindmap

@startuml
skinparam backgroundColor #FEFEFE

package "Tam Hibrit Mimari" {

  actor "Kullanıcılar" as users

  rectangle "Frontend (Statik)" #SkyBlue {
    [JBake / GitHub Pages]
    note right: Ücretsiz, CDN global
  }

  rectangle "Basit Backend (Supabase)" #LightGreen {
    [Auth OAuth2]
    [CRUD APIs]
    [Storage]
    [Realtime]
    note right
50k kullanıcıya kadar ücretsiz
Ayarlama gerekmeyen sunucu
    end note
  }

  rectangle "İş Backend (Spring Boot)" #Coral {
    [Orchestration]
    [Jobs Planifiés]
    [Intégrations]
    [Transactions]
    note right
Sadece gerekirse aktif edilir
    end note
  }

  database "PostgreSQL\nSource Tek Kaynak Gerçeği" as db #LightGray

  users --> [JBake / GitHub Pages]

  [JBake / GitHub Pages] --> [Auth OAuth2]
  [JBake / GitHub Pages] --> [CRUD APIs]
  [JBake / GitHub Pages] --> [Storage]
  [JBake / GitHub Pages] --> [Realtime]
  [JBake / GitHub Pages] --> [Orchestration]

  [Auth OAuth2] --> db
  [CRUD APIs] --> db
  [Orchestration] --> db
  [Jobs Planifiés] --> db
  [Intégrations] --> db
}

note bottom of db
**Tek bir veri tabanı, iki tüketici**
• Supabase için basit
• Spring Boot için karmaşık
• Senkronizasyon gerekmez
end note

@enduml

@startuml
skinparam backgroundColor #FEFEFE

rectangle "Güncel Mimari" #SkyBlue {
  [JBake]
  [Supabase]
  [Spring Boot]
}

rectangle "Olası Gelişmeler" #LightYellow {

  package "Performans" {
    [Redis Cache]
    [CDN pour Assets]
    [PostgreSQL Replicas]
  }

  package "İzleme" {
    [Grafana]
    [Prometheus]
    [Sentry]
  }

  package "CI/CD" {
    [GitHub Actions]
    [Tests Automatisés]
    [Déploiement Continu]
  }

  package "Özellikler" {
    [Search (ElasticSearch)]
    [Queue (RabbitMQ)]
    [Event Sourcing]
  }
}

[Spring Boot] .down.> [Redis Cache] : Peut ajouter
[Spring Boot] .down.> [Queue (RabbitMQ)] : Peut ajouter
[Spring Boot] .down.> [Search (ElasticSearch)] : Peut ajouter

[Supabase] .down.> [PostgreSQL Replicas] : Peut ajouter

note bottom
Extensible mimari
Her ekleme bağımsızdır
Genel yeniden tasarım gerekmez
end note
@enduml

@startuml
skinparam backgroundColor #FEFEFE

package "Operasyon Dağılımı" {

  rectangle "80% - Standart İşlemler" #LightGreen {
    [Lecture de données]
    [Création d'entités]
    [Mise à jour simple]
    [Suppression]
    [Upload fichiers]
    [Authentification]

    note bottom: Yönetilen Supabase
  }

  rectangle "20% - İş Mantığı" #Coral {
    [Calculs complexes]
    [Workflows multi-étapes]
    [Transactions critiques]
    [Intégrations tierces]
    [Jobs planifiés]

    note bottom: Spring Boot tarafından yönetiliyor
  }
}

note right
Optimal fokus:
Geliştirme zamanınız
%20'yi odaklayan
Ürününüzü ayıran
end note
@enduml