BaseForge'un dokümantasyon sitesi yayında

BaseForge, .NET 10 mikroservisleri için geliştirdiğimiz açık kaynak bir temel kütüphane ve kod üretici. Bugüne kadar dokümanları yalnızca Türkçe ve yalnızca GitHub reposunun içindeydi. Bu hafta bunu değiştirdik: BaseForge'un artık kendine ait, İngilizce öncelikli ve Türkçe desteği olan bir dokümantasyon sitesi var.

👉 dropdeart.github.io/BaseForge

BaseForge ne yapıyor?

Her yeni backend servisi aynı altyapıyı ister: katmanlı mimari, CQRS, repository'ler, audit alanları, kimlik doğrulama, servisler arası iletişim, loglama, health check ve Docker dosyaları. BaseForge bu kararları bir kez verip iki parça halinde sunuyor:

Kütüphane: tek bir AddBaseForge() çağrısıyla CQRS (MediatR), EF Core + Dapper, audit ve soft delete, JWT, RabbitMQ ve merkezi loglama hazır geliyor.
Üretici: entity'lerinizi YAML ile ya da tarayıcıdaki Designer ile tarif ediyorsunuz; BaseForge derlenen, Docker ile çalışan, sade ve okunabilir C# kodu üretiyor.

Sitede neler var?

Başlarken: CLI'yı kurup ilk servisinizi beş dakikada ayağa kaldırmak.
Designer turu: entity, ilişki, erişim kuralı ve Identity ayarlarının görsel olarak tasarlanması.
Servis Spec'i referansı: tüm YAML seçenekleri, alan tipleri ve doğrulama kuralları tek sayfada.
Identity ve yetkilendirme: sosyal girişler, roller, kayıt sahipliği ve kullanıcı profil alanları.
Production'a yayın: Docker Compose, Caddy ile otomatik HTTPS ve yayın öncesi kontrol listesi.
Mimari kararlar: neyi neden böyle yaptığımızın gerekçeleriyle birlikte kaydı.

Neden İngilizce?

BaseForge herkese açık bir NuGet paketi olarak yayınlanıyor ve .NET topluluğu dünya genelinde. Paketi bulan bir geliştiricinin ilk gördüğü şeyin anlayabileceği bir dilde olması gerekiyordu. Bu yüzden README, dokümanlar ve Designer arayüzü artık İngilizce. Türkçeyi de bırakmadık: sitenin tamamı Türkçe okunabiliyor, Designer'da da tek tıkla Türkçeye geçebiliyorsunuz.

Hemen deneyin

dotnet tool install -g BaseForge.CodeGen --prerelease
mkdir my-platform && cd my-platform
baseforge new orders

Tarayıcıda Designer açılır. Entity'lerinizi ekleyip Üret + Derle'ye, ardından Çalıştır'a basın; servisiniz Docker'da ayağa kalkar ve API dokümanı hazır olur.

Geri bildirimleriniz ve katkılarınız için GitHub reposu her zaman açık.