Proje Yapısı

Monorepo dizin yapısı: katmanlar, BuildingBlocks, SPA’lar ve devops dosyaları

Şablon bir monorepo’dur. Backend (Clean Architecture katmanları), iki frontend SPA ve tüm devops dosyaları tek repoda yaşar. Çözüm dosyası DiyanetCleanArchitecture.slnx (yeni XML tabanlı .slnx formatı).

Üst düzey dizinler

diyanet-clean-architecture/
├── src/                      # Tüm kaynak kod (backend + frontend)
├── test/                     # Birim ve fonksiyonel testler
├── docker/                   # Keycloak temaları, Grafana/Prometheus/RabbitMQ config, init SQL
├── scripts/                  # Keycloak yardımcıları + Hetzner deploy script'leri
├── docs/                     # Bu Mintlify dokümantasyonu
├── .template.config/         # dotnet new şablon tanımı (template.json)
├── docker-compose*.yml       # Ortam bazlı compose dosyaları
├── .env*.example             # Ortam değişkeni şablonları
└── DiyanetCleanArchitecture.slnx

src/ — kaynak kod

src/
├── DiyanetCleanArchitecture.API                      # ASP.NET Core 10 host (Controllers, Program.cs)
├── DiyanetCleanArchitecture.Application              # CQRS: Features, Handlers, Behaviors
├── DiyanetCleanArchitecture.Domain                   # Aggregate'ler, Entity'ler, Domain Event'ler
├── DiyanetCleanArchitecture.Domain.SharedKernel      # EntityBase, ValueObject, Enumeration, ...
├── DiyanetCleanArchitecture.Infrastructure.EFCore    # DbContext, Repository, Migrations
├── DiyanetCleanArchitecture.Infrastructure.Jobs.Hangfire
├── DiyanetCleanArchitecture.Infrastructure.Services.Email
├── DiyanetCleanArchitecture.Infrastructure.Services.Sms
├── DiyanetCleanArchitecture.Infrastructure.Services.Notification
├── DiyanetCleanArchitecture.Infrastructure.Services.OAuth
├── DiyanetCleanArchitecture.Infrastructure.Services.Authenticator
├── DiyanetCleanArchitecture.Presentation.Website     # React 19 + Vite SPA → / (vatandaş)
├── DiyanetCleanArchitecture.Presentation.Admin       # React 19 + Vite SPA → /admin (personel)
└── BuildingBlocks/                                    # 20 yeniden kullanılabilir altyapı paketi

Katmanların sorumlulukları

Domain

İş kuralları. Hiçbir dış katmanı bilmez. Aggregate, Entity, Value Object, Domain Event, Factory, Domain Service.

Application

Use-case orkestrasyonu. MediatR Command/Query + Handler, Pipeline Behavior, Validator, DTO.

Infrastructure

Application arayüzlerinin somut implementasyonu: EF Core, RabbitMQ, Redis, Email, SMS, OAuth, TOTP, Hangfire.

API + Presentation

İnce controller’lar (sadece MediatR’a iletir) + iki React SPA.

Bağımlılık yönü her zaman içe doğrudur: API → Application → Domain. Infrastructure, Application arayüzlerini implemente eder. Detay: Mimari › Bağımlılık Akışı.

BuildingBlocks/ — altyapı paketleri

Uygulamadan bağımsız, başka projelere de taşınabilen 20 paket. Öne çıkanlar:

Paket	İçerik
BuildingBlocks.Caching (+.Redis)	HybridCache (L1+L2), distributed lock, tag invalidation
BuildingBlocks.EventBus.MassTransit.RabbitMq	MassTransit + RabbitMQ + EF Outbox event bus
BuildingBlocks.Keycloak	Çift-realm Keycloak SSO + claims transformation
BuildingBlocks.Jwt	Çok-şemalı JWT (Backoffice + OTP Challenge)
BuildingBlocks.OAuth	OAuth2 / PKCE soyutlaması (Google, Meta, Keycloak)
BuildingBlocks.Otp	HMAC-SHA256 OTP üretim/doğrulama
BuildingBlocks.Specification	Generic Specification (Ardalis tabanlı)
BuildingBlocks.DeviceDetector	IP çözümleme, cihaz parmak izi, güven skoru
BuildingBlocks.Observability	OpenTelemetry metrik/trace + health→gauge köprüsü
BuildingBlocks.HealthChecks	K8s uyumlu live/ready/external endpoint’leri

Tam liste ve API’ler: BuildingBlocks › Genel Bakış.

test/ — testler

test/
├── DiyanetCleanArchitecture.Domain.UnitTests
├── DiyanetCleanArchitecture.API.Authorization.UnitTests
├── DiyanetCleanArchitecture.Caching.Redis.UnitTests
├── DiyanetCleanArchitecture.Infrastructure.Services.Email.UnitTests
├── DiyanetCleanArchitecture.Infrastructure.Services.Sms.UnitTests
└── BuildingBlocks.EventBus.MassTransit.RabbitMq.FunctionalTests

docker/ — container yardımcıları

docker/
├── keycloak/         # Özel Keycloak imajı + Türkçe temalar (diyanet-website, diyanet-admin)
├── grafana/          # Datasource + dashboard provisioning (diyanet-health.json)
├── prometheus/       # prometheus.yml scrape config (/metrics)
├── rabbitmq/         # enabled_plugins (management + delayed_message_exchange)
├── init/             # Postgres init SQL (keycloak şeması, tenant'lar)
└── init-hetzner/     # Çok-proje veritabanı oluşturma

Compose ve ortam dosyaları

Dosya	Amaç
docker-compose.yml	Base: API + Website + Admin
docker-compose.override.yml	Dev — tüm altyapı + host port’ları (otomatik yüklenir)
docker-compose.stage.yml	Stage — nginx-proxy + acme-companion + Let’s Encrypt
docker-compose.prod.yml	Prod — aynı yapı, prod realm/sertifika
docker-compose.stage.local.yml	Local’de stage simülasyonu (HTTP-only)
docker-compose.platform.yml / .shared-infra.yml / .app.yml	Hetzner çok-proje dağıtımı

Detay: Operasyon › Genel Bakış.

Sonraki adım

Mimari Genel Bakış

Katmanlar ve bağımlılık yönü.

Çözüm Yapısı

.slnx içindeki projeler ve referans grafiği.