BaseForge.NET mikroservislerini spec'ten üret

.NET 10 için opinionated bir temel kütüphane ve görsel kod üretici. Entity'lerini tarif et — CQRS, kimlik doğrulama, gRPC, event'ler ve Docker'ı hazır bağlanmış, temiz ve production'a hazır servisler al.

Başlarken →

BaseForge nedir?

GitHub'da gör

Görsel Designer

Entity'leri, ilişkileri, erişim kurallarını ve Identity'yi tarayıcıda canlı ER diyagramıyla modelle. Tek tıkla üret, derle ve çalıştır.

Designer turu

Clean Architecture + CQRS

Core → Infrastructure → API katmanlaması, MediatR komut ve sorguları, repository'ler, audit alanları ve soft delete hazır gelir.

Neden böyle tasarlandı

Merkezi Identity

Sosyal girişler, roller, sahiplik kuralları ve kullanıcı profil alanlarıyla OpenIddict + ASP.NET Identity — hepsi YAML'dan.

Identity ve yetkilendirme

gRPC ve RabbitMQ

Kardeş spec'lerden üretilen tipli gRPC istemcileri; transactional outbox, inbox idempotency ve dead-letter kuyruklu event'ler.

Servisler arası iletişim

Varsayılan olarak izlenebilir

Serilog + Grafana Loki, HTTP → gRPC → RabbitMQ boyunca tek correlation id, her serviste /health ve canlı durum paneli.

Loglama ve sağlık

Docker'a hazır

Her servis Dockerfile, docker-compose, health check ve çakışmayan portlarla gelir. Production rehberi dahil.

Production'a yayın

Spec'i ver, servisi al

Bir kez tarif et. Derlenen, çalışan ve ölçeklenen bir servis al.

Birkaç satır YAML yaz — ya da Designer'da tıklayarak oluştur. BaseForge kütüphaneyi kullanan sade, okunabilir C# üretir, derler ve Docker ile ayağa kaldırır.

orders.yaml

service: orders
database: orders_db
auth: { protect: true }

entities:
  Order:
    props:
      Status: { type: enum, values: [Draft, Paid] }
      Total: decimal
      BuyerId: guid
    ownerField: BuyerId
    access:
      list: [Admin, owner]
    publishes: [created]

  OrderLine:
    relations:
      order: { kind: many-to-one, target: Order }
    externalRefs:
      product: { target: products/Product, via: grpc }

terminal

$ baseforge new-service --spec orders.yaml --yes

✓ spec doğrulandı · 2 entity · 1 dış referans

✓ ER diyagramı → orders/er.drawio

✓ 38 dosya üretildi → ./orders

✓ gRPC istemcisi → products/Product (zengin, 5 alan)

✓ dotnet build · 0 uyarı · 0 hata

$ docker compose up --build -d --wait

● orders http://localhost:8080/scalar/v1 healthy

Fikirden API'ye üç adım

Tasarla

Entity'leri, ilişkileri, erişim kurallarını ve Identity'yi görsel olarak — canlı ER diyagramıyla — ya da düz YAML ile modelle.

Üret

Controller'lar, CQRS handler'ları, EF Core entity'leri, DTO'lar, validasyon, gRPC proto'ları, event'ler, Dockerfile ve compose.

Çalıştır

Tek tıkla tüm stack derlenir ve ayağa kalkar. baseforge update ile devam et — spec her zaman tek doğru kaynak.

Production servisinin ihtiyacı olan her şey — hazır bağlı

REST controller'lar + Scalar API dokümanı

MediatR üzerinde CQRS komut ve sorguları

EF Core entity'leri, audit alanları, soft delete

Ağır okuma sorguları için Dapper

Rol ve sahiplik tabanlı yetkilendirme

Servisler arası gRPC istemci ve sunucuları

Transactional outbox ile RabbitMQ event'leri

Inbox idempotency ve dead-letter kuyrukları

Serilog + Grafana Loki, correlation id

/health kontrolleri ve Docker healthcheck

Multi-tenancy ve append-only entity'ler

Her servis için Dockerfile + docker-compose

Zaten güvendiğin araçların üzerine kurulu

.NET 10ASP.NET CoreEF Core 10DapperMediatRPostgreSQLgRPCRabbitMQOpenIddictYARPSerilogGrafana LokiDockerReact + Vite

İlk servisini beş dakikada üret

CLI'yı kur, Designer'ı aç, Üret'e bas.

Başlarken Mimariyi oku