dotnet-clean-api-starter
Ein produktionsreifes .NET 10 Web-API-Template auf Basis von Clean Architecture und CQRS. Vollständig eingerichtet mit JWT-Auth, PostgreSQL, Docker und Integrationstests — bereit zum Klonen und Weiterentwickeln.
Website besuchen ↗
Zeitraum
May 2026
Rolle
Solo Backend Developer
Stack
.NET 10 · C# · PostgreSQL · EF Core · MediatR · JWT · Docker · xUnit · Testcontainers
The problem
Ein neues .NET-API von Grund auf aufzubauen dauert Tage an Boilerplate — Projektstruktur, Auth, Datenbank-Setup, Fehlerbehandlung, Tests. Dieses Template eliminiert diesen Einrichtungsaufwand, damit Sie sich auf Ihr eigentliches Feature konzentrieren können.
What I built
- ✓Clean Architecture in vier Schichten: Domain → Application → Infrastructure → API, mit strikten unidirektionalen Abhängigkeitsregeln
- ✓CQRS über MediatR mit einer Validierungspipeline — jeder Command durchläuft automatisch FluentValidation vor dem Handler
- ✓JWT-Zugriffstoken (15 Min.) + Refresh-Token-Rotation (7 Tage) — in PostgreSQL gespeichert mit vollständiger Widerrufsunterstützung
- ✓Multi-Stage-Dockerfile + docker-compose mit Healthcheck — ein Befehl, um den vollständigen Stack lokal auszuführen
- ✓Integrationstests mit Testcontainers (echtes PostgreSQL), Respawn (Datenbankbereinigung) und Bogus (realistische Testdaten)
- ✓GitHub Actions CI-Pipeline — Build, Unit-Tests und Integrationstests bei jedem Push auf main
Result
Ein vollständig funktionsfähiges, getestetes und dokumentiertes .NET 10 API-Template. 17 bestandene Tests (10 Unit-, 7 Integrations-). Clean Architecture von Anfang bis Ende demonstriert — von Domain-Wertobjekten bis zu Integrationstests gegen eine echte Datenbank.
Next project
De Bergen →