Altyapı Servisleri

Altyapı servisleri, Application katmanının ihtiyaç duyduğu dış dünya entegrasyonlarını (e-posta, SMS, OAuth sağlayıcıları, TOTP üreteci, arka plan iş kuyruğu, gerçek-zamanlı bildirim) sağlayan ayrı projelerdir. Her biri src/DiyanetCleanArchitecture.Infrastructure.Services.* ya da src/DiyanetCleanArchitecture.Infrastructure.Jobs.* altında yaşar.

Ortak desen

Tüm servisler aynı üç kuralı izler:

Application arayüzünü implemente eder

Servis sınıfı, Application/Domain katmanının tanımladığı (ya da kendi projesindeki) bir arayüzü implemente eder: IEmailService, IOtpSmsService, IAuthenticationTotpService, IOAuthClient<TUserInfo>, IAdminNotificationBroadcaster. Tüketici kod somut sınıfı değil arayüzü inject eder.

Bir Add*Service extension'ı ile kaydedilir

Her projenin kök DependencyInjection.cs dosyasında Add* adında bir IServiceCollection extension metodu vardır. Program.cs bunları sırayla çağırır:

builder.Services.AddHangfireServers(builder.Configuration);
builder.Services.AddSmsService(builder.Configuration);
builder.Services.AddEmailService(builder.Configuration);
builder.Services.AddAuthenticatorService(builder.Configuration);
builder.Services.AddOAuthProviders(builder.Configuration);
builder.Services.AddNotificationService(builder.Configuration);

Config Services:* altında bind edilir

Servis ayarları appsettings.json içinde Services:<Ad> bölümünden bind edilir (OAuth ve Keycloak istisna — kök seviyede OAuth ve Keycloak bölümlerini kullanır). Bind, services.Configure<TOptions>(o => configuration.GetSection("Services:...").Bind(o)) deseni ile yapılır.

Çoğu servis Polly ile resilience (retry / circuit-breaker) ve bir health check ekler. Dış sağlayıcı health check’leri [External] tag’i taşır: sağlayıcı çökse de /health/ready bozulmaz, sadece /health/external degraded olur. Mantık: e-posta/SMS sağlayıcısı geçici çökerse API çalışmaya devam etmeli.

Servis matrisi

Servis	Provider / Teknoloji	Ana arayüz	Config anahtarı	DI extension
Email	Brevo SMTP (MailKit + Scriban)	`IEmailService`	`Services:Email`	`AddEmailService`
SMS	NetGSM REST v2 OTP	`IOtpSmsService`	`Services:Sms`	`AddSmsService`
Notification	SSE (in-memory Channel)	`IAdminNotificationBroadcaster`	`Services:Notification`	`AddNotificationService`
OAuth	Google / Meta / Keycloak	`IOAuthClient<TUserInfo>`	`OAuth`, `Keycloak`	`AddOAuthProviders`
Authenticator	OtpNet (TOTP / RFC 6238)	`IAuthenticationTotpService`	`Services:Authenticator`	`AddAuthenticatorService`
Hangfire	Hangfire + PostgreSQL	`ICommandBus` / `IEventBus`	`Services:Hangfire`	`AddHangfireServers`

Resilience ve health check özeti

Servis	Resilience	Health check (tag)
Email	Polly retry (`RetryCount`, exponential) + circuit-breaker (6 hata / 1 dk)	`smtp` — `[External]`
SMS	Polly HTTP retry (`RetryCount`, lineer backoff)	`sms-provider` — `[External]`
OAuth	Polly HTTP retry (3×, exponential)	—
Hangfire	Postgres storage retry + DLX kuyrukları	`hangfire` — `[Ready]`
Notification	Bounded Channel `DropOldest` (backpressure)	—
Authenticator	Saf hesaplama (dış bağımlılık yok)	—

Servis detayları

Email

Brevo SMTP üzerinden Scriban şablonlu e-posta; ResilientEmailGateway ile Polly koruması.

SMS

NetGSM REST v2 OTP entegrasyonu; ASCII-only mesaj, ortam bazlı telefon çözümleme.

Notification

SSE tabanlı, rol-hedefli admin bildirimleri; HMAC stream-token ile kimlik.

OAuth

Google, Meta ve Keycloak; PKCE (S256) tabanlı backend-driven akış.

Authenticator (TOTP)

OtpNet ile RFC 6238 TOTP; QR üretimi, drift toleranslı doğrulama.

Hangfire

PostgreSQL destekli arka plan iş kuyruğu; MediatR command/event köprüsü.

Başlarken

Mimari

Domain Katmanı (DDD)

Application Katmanı (CQRS)

Veri Katmanı (EF Core)

BuildingBlocks

Kimlik ve Yetki

Keycloak

Cache Mimarisi

Event-Driven Akış

API ve Frontend

Operasyon

Senaryo Playbook'ları

Referans

Altyapı Servisleri — Genel Bakış

Ortak desen

Servis matrisi

Resilience ve health check özeti

Servis detayları

Email

SMS

Notification

OAuth

Authenticator (TOTP)

Hangfire

​Ortak desen

​Servis matrisi

​Resilience ve health check özeti

​Servis detayları

Email

SMS

Notification

OAuth

Authenticator (TOTP)

Hangfire

Ortak desen

Servis matrisi

Resilience ve health check özeti

Servis detayları