👁 Image
BulutBusiness.Core 10.0.8

BulutBusiness.Core

.NET 10 tabanlı kurumsal iş uygulamaları için paylaşımlı altyapı kütüphanesi. Clean Architecture, CQRS ve Repository Pattern prensiplerine uygun olarak tasarlanmıştır.

Kurulum

dotnet add package BulutBusiness.Core

Modüller

Persistence — Repository & Entity

Generic EF Core repository implementasyonu. Tüm CRUD operasyonları, soft delete, sayfalama ve dinamik filtreleme desteklenir.

// Entity base sınıfı
public class Order : Entity<int> { ... }

// Repository
public class OrderRepository : EfRepositoryBase<Order, int, AppDbContext>, IOrderRepository { }

EfRepositoryBase<TEntity, TEntityId, TContext> metodları:

Soft Delete: DeletedDate set edilerek kayıt gizlenir. Cascade soft delete ilişkili kayıtlara otomatik uygulanır.

Timestamp davranışı: CreatedDate, UpdatedDate, DeletedDate alanları DateTime.Now ile set edilir. Container'da TZ ortam değişkeni ayarlıysa (örn. TZ=Europe/Istanbul) doğru yerel saat kaydedilir.

Sayfalama:

var result = await _orderRepository.GetListAsync(
 predicate: o => o.Status == OrderStatus.Active,
 orderBy: q => q.OrderByDescending(o => o.CreatedDate),
 index: 0,
 size: 20
);
// result.Items, result.Count, result.Pages, result.HasNext

Dinamik filtreleme:

var result = await _repository.GetListByDynamicAsync(
 dynamic: new DynamicQuery
 {
 Filter = new Filter { Field = "Status", Operator = "eq", Value = "1" },
 Sort = [new Sort { Field = "CreatedDate", Dir = "desc" }]
 }
);

Security — JWT & Kimlik Doğrulama

JWT token üretimi, refresh token yönetimi, şifre hashleme ve iki faktörlü kimlik doğrulama (Email OTP / TOTP).

// appsettings.json
{
 "TokenOptions": {
 "Audience": "myapp.com",
 "Issuer": "myapp.com",
 "AccessTokenExpiration": 60,
 "SecurityKey": "your-secret-key-min-32-chars"
 }
}

// Program.cs
builder.Services.AddSecurityServices();

Bileşenler:

Hazır Security Entity'leri: User, OperationClaim, UserOperationClaim, RoleGroup, RoleGroupOperationClaim, UserRoleGroup, RefreshToken, EmailAuthenticator, OtpAuthenticator

Yetki Grubu (RoleGroup)

10.0.7 ile eklenen grup tabanlı yetkilendirme sistemi. Kullanıcılara tek tek claim atamak yerine, claim'leri gruplar halinde yönetip kullanıcılara gruplar atanabilir. Bir kullanıcı birden fazla gruba üye olabilir; token oluşturulurken tüm grupların claim'leri düzleştirilerek (flatten) birleştirilir.

RoleGroup ("Satın Alma Yöneticisi")
 ├─ PurchaseQuotes.Read
 ├─ PurchaseQuotes.Create
 └─ PurchaseInvoices.Read

Kullanıcı: Ahmet
 ├─ Grup: "Satın Alma Yöneticisi"
 └─ Grup: "Stok Görevlisi"

Token'daki roller (flatten + distinct):
 ["PurchaseQuotes.Read", "PurchaseQuotes.Create", "PurchaseInvoices.Read", "Stock.Read", ...]

// Domain'de extend et (navigation property'ler burada tanımlanır)
public class RoleGroup : RoleGroup<Guid> { }
public class RoleGroupOperationClaim : RoleGroupOperationClaim<Guid, Guid, int> { }
public class UserRoleGroup : UserRoleGroup<Guid, Guid, Guid> { }

// Token oluştururken — ITokenHelper overload
var directClaims = await _userOpClaimRepo.GetClaimsAsync(userId);
var userGroups = await _userRoleGroupRepo.GetGroupsAsync(userId);
var groupClaims = await _roleGroupClaimRepo.GetClaimsByGroupsAsync(groupIds);

var token = _tokenHelper.CreateToken(user, directClaims, userGroups, groupClaims);

Pasif grup davranışı: IsActive = false olan gruplar token'a claim eklemez; bu sayede bir grubun tüm kullanıcı yetkilerini tek seferde askıya alabilirsiniz.

Application — CQRS Pipeline Behavior'ları

MediatR pipeline üzerinde çalışan cross-cutting concern davranışları.

// Yetkilendirme örneği
public class DeleteProductCommand : IRequest<Unit>, ISecuredRequest
{
 public string[] Roles => ["Admin", "Manager"];
}

// Önbellekleme örneği
public class GetProductsQuery : IRequest<GetListResponse<ProductDto>>, ICachableRequest
{
 public string CacheKey => "Products";
 public TimeSpan? SlidingExpiration => TimeSpan.FromMinutes(30);
}

Mailing — E-posta Gönderimi

MailKit tabanlı HTML e-posta gönderimi.

// appsettings.json
{
 "MailSettings": {
 "Server": "smtp.example.com",
 "Port": 587,
 "SenderFullName": "example",
 "SenderEmail": "noreply@example.com",
 "UserName": "noreply@example.com",
 "Password": "app-password",
 "UseSsl": false
 }
}

await _mailService.SendEmailAsync(new Mail
{
 Subject = "Siparişiniz alındı",
 HtmlBody = "<h1>Teşekkürler!</h1>",
 ToList = [new ToEmail { Address = "customer@example.com", Name = "Ad Soyad" }]
});

ElasticSearch

NEST tabanlı ElasticSearch entegrasyonu. Index oluşturma, belge ekleme/güncelleme, arama işlemleri.

// appsettings.json
{
 "ElasticSearchConfig": {
 "ConnectionString": "http://localhost:9200",
 "UserName": "",
 "Password": ""
 }
}

Localization — Çoklu Dil Desteği

İki farklı lokalizasyon stratejisi:

• ResourceLocalizationManager — .resx dosyası tabanlı, yerel çeviri
• AmazonTranslateLocalizationManager — AWS Translate ile otomatik çeviri
• TranslateLocalizationManager — Karma strateji

// Program.cs
app.UseMiddleware<LocalizationMiddleware>(); // Accept-Language header'ına göre dil ayarlar

CrossCuttingConcerns — Hata Yönetimi & Loglama

Exception Middleware: BusinessException, AuthorizationException, NotFoundException, ValidationException tiplerini yakalar ve RFC 7807 uyumlu ProblemDetails döner.

Serilog Loglama:

// appsettings.json
{
 "SeriLogConfigurations": {
 "FileLogConfiguration": {
 "FolderPath": "/logs"
 }
 }
}

Versiyon Geçmişi

10.0.8

• Güvenlik güncellemesi: MailKit 4.15.1 → 4.16.0, MimeKit 4.15.1 → 4.16.0
  • GHSA-9j88-vvj5-vhgr (moderate severity) güvenlik açığı giderildi
• Breaking change yok — mevcut API kullanımı tam uyumlu

10.0.7

• Yetki Grubu (RoleGroup) altyapısı eklendi
  • RoleGroup<TId> — Name, Description, IsActive alanlarıyla yetki grubu entity'si
  • RoleGroupOperationClaim<TId, TRoleGroupId, TOperationClaimId> — grup ↔ claim N:N köprüsü
  • UserRoleGroup<TId, TUserId, TRoleGroupId> — kullanıcı ↔ grup N:N köprüsü
• ITokenHelper yeni overload — CreateToken(user, directClaims, roleGroups, roleGroupClaims): aktif grupların claim'lerini otomatik flatten + distinct ederek token'a yazar; geriye dönük uyumlu (eski imza korundu)
• Navigation property'ler Core entity'lerine eklenmedi — bağımlılıkları sıfır tutar, uygulama katmanı kendi Domain entity'lerinde tanımlar

10.0.6

• EfRepositoryBase: CreatedDate, UpdatedDate, DeletedDate timestamp'leri DateTime.UtcNow → DateTime.Now olarak değiştirildi. Container TZ ortam değişkeni ile yerel saat desteği sağlandı.
• Paket güncellemeleri: FluentValidation 12.1.1, MailKit 4.15.1, MediatR 14.1.0, EF Core 10.0.5, Microsoft.IdentityModel.Tokens 8.17.0, Swashbuckle 10.1.7, Otp.NET 1.4.1, Serilog 4.3.1

10.0.5

• .NET 10 desteği
• MimeKit 4.14.1, EF Core 10.0.2

10.0.x (önceki)

• .NET 9 → .NET 10 geçişi
• JWT, Repository, CQRS pipeline altyapısı

Gereksinimler

• .NET 10+
• Entity Framework Core 10 uyumlu veritabanı (SQL Server, PostgreSQL vb.)
• (Opsiyonel) ElasticSearch 7.x
• (Opsiyonel) AWS hesabı (Amazon Translate için)