İçeriğe geç
eneskucukpehlivan.com
← Minenin Dünyası

Teknik not · Enes Küçükpehlivan

Mobil ve web için ortak .NET API

Minenin Dünyası mimarisi üzerinden istemciler, iş kuralları ve veri erişimi arasındaki sınırlar.

Ortak API sınırı
  1. Flutter / Vue
  2. Web API
  3. Business
  4. Dapper / PostgreSQL

Birden fazla istemci, ortak iş kuralları

Minenin Dünyası’nda Flutter ve Vue istemcileri ASP.NET Core 8 Web API üzerinden aynı iş katmanına bağlanır. Bu ayrım, bir kuralı mobil ve web içinde ayrı ayrı uygulamak yerine sunucuda merkezileştirmeye imkân verir.

API sözleşmesi ve kimlik doğrulama

JWT Bearer kimlik doğrulama ve Swagger/OpenAPI API katmanında yer alır. Kimlik doğrulama kullanıcının kim olduğunu belirler; kaynak bazlı yetkilendirme ayrıca ele alınmalıdır. OpenAPI ise istemciler arasında ortak bir sözleşmenin okunmasını ve denenmesini kolaylaştırır.

Business / DB / Models ayrımı

Projede iş katmanı, veri erişimi ve modeller ayrılmıştır. Dapper ve Npgsql, PostgreSQL erişiminde kullanılır. Dapper sorgular üzerinde doğrudan kontrol verir; bunun karşılığında sorgu bakımı ve eşlemelerin açıkça yönetilmesi gerekir. Tek başına bir veri erişim aracı seçimi performans sonucu garanti etmez.

İstemcilerin sorumluluğu

Flutter tarafında Dio ve Riverpod; Vue tarafında Axios ve Pinia kullanılır. İstemciler, sunum ve yerel durum yönetimine odaklanırken ortak iş kuralları API tarafında tutulur. Firebase Admin ve FCM bildirim akışında yer alır.

Bu yaklaşımın sınırları

Ortak API, istemcileri sözleşmeye bağımlı hâle getirir. Gelecekteki değişikliklerde geriye uyumluluk, hata yanıtları ve sürüm geçişleri tasarımın parçası olmalıdır. Buradaki not mimari kapsamı açıklar; yük testi veya ölçülmüş performans iddiası içermez.

Bu mimari üzerine konuşalım →