Clean Architecture Demo
Loading...
Searching...
No Matches
Program.cs
Go to the documentation of this file.
1// Este archivo es la raíz de composición y configuración de inicio de la aplicación.
2//
3// Rol en Clean Architecture:
4// - Parte de la capa de presentación, en este caso, API REST
5// - Raíz de Composición: Conecta todas las dependencias a través de Inyección de Dependencias
6// - Configuración: Configura pipeline de middleware, autenticación y servicios
7// - Punto de entrada: ASP.NET Core ejecuta este archivo en el inicio de la aplicación
8//
9// Responsabilidades:
10// - Registrar servicios de todas las capas en el contenedor de DI
11// - Configurar autenticación y autorización
12// - Agregar servicios de acceso a datos y persistencia
13// - Configurar pipeline de middleware (¡el orden importa!)
14// - Inicializar base de datos si es necesario
15//
16// Patrón de Inyección de Dependencias:
17// - Registra interfaces de capas de Aplicación y Dominio
18// - Implementaciones de capa de Infraestructura
19// - Los controladores usan servicios registrados (inyección de constructor)
20// - Los interactores usan servicios registrados: reciben sus puertos de salida por constructor
21// - Los presenters son Scoped: el interactor escribe en la misma instancia que lee el controlador
22//
23// Registro de Capa de Arquitectura:
24// - Capa de aplicación: interactores y los puertos IUnitOfWork, ITaskRepository,
25// IDomainEventDispatcher
26// - Capa de infraestructura: DbContext, Repositorios, Distribuidor de Eventos
27// - Capa de UI: Controladores, Presenters, Middleware
28//
29// Directrices de Raíz de Composición:
30// - La capa de UI puede hacer referencia a Infraestructura para registro de DI
31// - Infraestructura implementa interfaces de otras capas
32// - Las capas del dominio y Aplicación permanecen independientes
33// - Este archivo es el único lugar donde se hace referencia directa a Infraestructura
34//
35// pipeline de Middleware:
36// - El orden es crítico: el middleware anterior procesa solicitudes primero
37// - ExceptionHandlingMiddleware: Usualmente primero para capturar todas las excepciones
38// - Autenticación, Autorización: Middleware relacionado con seguridad
39// - MapControllers: Enruta solicitudes a controladores
40
41using System.Data.Common;
42using System.Reflection;
43using System.Text.Json.Serialization;
44using Microsoft.AspNetCore.Authentication.JwtBearer;
45using Microsoft.Data.Sqlite;
46using Microsoft.EntityFrameworkCore;
47using Microsoft.IdentityModel.Tokens;
59
60var builder = WebApplication.CreateBuilder(args);
61
62// Cargar secretos de usuario explícitamente para que los tokens dotnet user-jwts funcionen incluso cuando
63// el proceso se inicia sin ASPNETCORE_ENVIRONMENT=Development.
64builder.Configuration.AddUserSecrets(Assembly.GetExecutingAssembly(), optional: true);
65
66const string connectionString = "Data Source=file:taskmanagement?mode=memory&cache=shared";
67builder.Configuration.AddInMemoryCollection(new Dictionary<string, string?> {
68 ["ConnectionStrings:DefaultConnection"] = connectionString
69});
70
71builder.Services.AddSingleton<SqliteConnection>(_ => {
72 var connection = new SqliteConnection(connectionString);
73 connection.Open();
74 return connection;
75});
76
77var bearerSection = builder.Configuration.GetSection("Authentication:Schemes:Bearer");
78var validIssuer = bearerSection["ValidIssuer"];
80 .GetSection("ValidAudiences")
81 .Get<string[]>() ?? [];
83 .GetSection("SigningKeys")
84 .GetChildren()
85 .Select(x => x["Value"])
86 .Where(x => !string.IsNullOrWhiteSpace(x))
87 .Select(x => new SymmetricSecurityKey(Convert.FromBase64String(x!)))
88 .Cast<SecurityKey>()
89 .ToArray();
90
91builder.Services
92 .AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
93 .AddJwtBearer(options => {
94 options.TokenValidationParameters = new TokenValidationParameters {
95 ValidateIssuer = !string.IsNullOrWhiteSpace(validIssuer),
96 ValidIssuer = validIssuer,
97 ValidateAudience = validAudiences.Length > 0,
98 ValidAudiences = validAudiences,
99 ValidateIssuerSigningKey = true,
100 IssuerSigningKeys = signingKeys,
101 ValidateLifetime = true,
102 TryAllIssuerSigningKeys = true,
103 ClockSkew = TimeSpan.FromMinutes(1)
104 };
105 });
106builder.Services.AddAuthorization();
107
108// Agregar servicios al contenedor
109builder.Services
110 .AddDbContext<TaskDbContext>(options =>
111 options.UseSqlite(builder.Configuration.GetConnectionString("DefaultConnection")))
112 .AddScoped<IUnitOfWork>(sp => sp.GetRequiredService<TaskDbContext>())
113 .AddScoped<ITaskRepository, TaskRepository>()
114 .AddSingleton<Func<DbConnection>>(_ => () => new SqliteConnection(connectionString))
115 .AddScoped<ITaskReadRepository, TaskReadRepository>()
117 .AddScoped<IDomainEventSubscriber<TaskCompletedEvent>, TaskCompletedNotificationHandler>()
119 // Crear tarea
120 .AddScoped<CreateTaskPresenter>()
121 .AddScoped<ICreateTaskOutputBoundary>(sp => sp.GetRequiredService<CreateTaskPresenter>())
122 .AddScoped<ICreateTaskInputBoundary, CreateTaskInteractor>()
123 // Completar tarea
124 .AddScoped<CompleteTaskPresenter>()
125 .AddScoped<ICompleteTaskOutputBoundary>(sp => sp.GetRequiredService<CompleteTaskPresenter>())
127 // Consultar tarea
128 .AddScoped<GetTaskByIdPresenter>()
129 .AddScoped<IGetTaskByIdOutputBoundary>(sp => sp.GetRequiredService<GetTaskByIdPresenter>())
130 .AddScoped<IGetTaskByIdInputBoundary, GetTaskByIdInteractor>()
131 .AddControllers()
132 .AddJsonOptions(options => {
133 options.JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter());
134 });
135var app = builder.Build();
136
137using (var scope = app.Services.CreateScope())
138{
139 var dbContext = scope.ServiceProvider.GetRequiredService<TaskDbContext>();
140 dbContext.Database.EnsureCreated();
141}
142
143// Configurar pipeline de middleware
144app.UseMiddleware<ExceptionHandlingMiddleware>();
145
146app.UseHttpsRedirection();
147app.UseAuthentication();
148app.UseAuthorization();
149app.MapControllers();
150
151app.Run();
152
157public partial class Program
158{
159 // Intencionalmente en blanco.
160}
var validIssuer
Definition Program.cs:78
var validAudiences
Definition Program.cs:79
var builder
Definition Program.cs:60
var app
Definition Program.cs:135
app.Services.CreateScope()) { var dbContext=scope.ServiceProvider.GetRequiredService< TaskDbContext >(); dbContext.Database.EnsureCreated();} app.UseMiddleware< ExceptionHandlingMiddleware >() scope
Definition Program.cs:137
const string connectionString
Definition Program.cs:66
var signingKeys
Definition Program.cs:82
var bearerSection
Definition Program.cs:77
Partial Program class made public for testing purposes. Allows WebApplicationFactory to access the Pr...
Definition Program.cs:158
ExceptionHandlingMiddleware convierte las excepciones inesperadas en una respuesta HTTP 500.
CompleteTaskPresenter convierte el resultado del caso de uso de completar una tarea en una respuesta ...
CreateTaskPresenter convierte el resultado del caso de uso de crear una tarea en una respuesta HTTP.
GetTaskByIdPresenter convierte el resultado del caso de uso de consultar una tarea en una respuesta H...
CompleteTaskInteractor implementa el caso de uso de completar una tarea.
TaskCompletedNotificationHandler envía una notificación cuando se completa una tarea.
LoggingEmailService es una implementación de IEmailService que, en lugar de enviar correos reales,...
InProcessDomainEventDispatcher entrega cada evento del dominio a sus manejadores, en el mismo proceso...
TaskDbContext es el DbContext de Entity Framework Core para gestión de tareas.
ICompleteTaskInputBoundary es el puerto de entrada del caso de uso de completar una tarea....
ICreateTaskOutputBoundary es el puerto de salida por el que el caso de uso de crear una tarea entrega...
IDomainEventDispatcher es la interfaz para publicación de eventos del dominio.
IEmailService es la abstracción para envío de notificaciones por correo electrónico.
IUnitOfWork es la abstracción para coordinar la persistencia de cambios de entidades.
IGetTaskByIdOutputBoundary es el puerto de salida por el que el caso de uso de consultar una tarea en...