Contexto
En cada proyecto nuevo, el bootstrapping de una API .NET limpia consume tiempo repetitivo: estructurar capas, registrar dependencias, definir el manejo de errores, agregar validaciones. Sin una base estandarizada, cada equipo termina tomando decisiones de arquitectura distintas sobre los mismos problemas.
Este template nació con dos propósitos: servir como punto de partida reutilizable en distintos proyectos, y como recurso de capacitación para equipos que están adoptando Clean Architecture — con implementaciones explícitas y sin magia oculta para que el código sea fácil de leer, entender y adaptar.
El desafío
Crear un starter de referencia pragmático que aplique Clean Architecture de forma coherente, levantable en minutos, sin dependencias mágicas ni convenciones ocultas, y que sirva como punto de partida compartido para cualquier equipo.
La solución
Template que implementa Clean Architecture con separación clara de capas (Domain, Application, Infrastructure, Presentation), CQRS implementado manualmente sin librerías externas, validaciones con FluentValidation via decorator pattern, manejo centralizado de excepciones, logging estructurado con Serilog, versionado de API y auto-migraciones con EF Core. Incluye soporte Docker con SQL Server y una suite de tests con cobertura en las tres capas.
Tecnologías
- .NET 9 — framework base
- Clean Architecture — separación de capas: Domain, Application, Infrastructure, Presentation
- CQRS manual — implementación propia sin MediatR ni librerías de mediación
- FluentValidation — validaciones de requests via decorator pattern
- EF Core + Ardalis.Specification — ORM, auto-migraciones y queries tipadas
- Serilog — logging estructurado
- Scalar — documentación de API
- Asp.Versioning — versionado de API
- xUnit + Moq — testing unitario e integración
- Docker — containerización con SQL Server 2022