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.
- Flutter / Vue
- Web API
- Business
- 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.