Cosmos.EventSourcing.Template 0.0.5

Solution template: Cosmos EventStore

Descripción

Plantilla de solución para event sourcing.

Constuye los siguientes proyectos:

• Dominio: Contiene los agregados, comandos, eventos, commandHandlers y proyecciones.
• API: API REST de la aplicación con minimal API, healthchecks y Open API.
• EventStore: Implementación de Marten como event store.'
• Dominio.Tests: Abstracción del StoreEvent para pruebas y CommandHandlerTest.

Instalación

dotnet new install Cosmos.EventSourcing.Template::0.0.2

Forma de uso

Después de instalado, la plantilla estará disponible Cosmos EventSourcing Solution funciona para visual studio y Raider.

Por línea de comandos:

dotnet new Cosmos.EventSourcing.Solution -n nombre-del-proyecto

Correr la aplicación

Para correr la aplicación, docker desktop debe estar instalado y ejecutándose. En el directorio raíz de la solución, ejecute el siguiente comando:

docker-compose up -d

Para consultar la base de datos, puede conectarse desde el IDE a un proveedor de Postgres. Como se ve en el docker-compose, la base de datos está expuesta en el puerto 5432. Y los datos de conexión son:

POSTGRES_USER: __ProjectName__User

POSTGRES_PASSWORD: __ProjectName__Password

POSTGRES_DB: __ProjectName__Db

Ejemplo:

Si el poryecto se llama MyProject, los datos de conexión son:

POSTGRES_USER: MyProjectUser

POSTGRES_PASSWORD: MyProjectPassword

POSTGRES_DB: MyProjectDb

Tecnologías utilizadas

• .NET 9
• Marten: Event Store basado en PostgreSQL.
• Wolverine: Bus de mensajes para manejar comandos y eventos.
• OpenAPI: Documentación interactiva de la API.
• Health Checks: Supervisión de la salud de la aplicación.

Características principales

• Event Sourcing: Uso de Marten para almacenar eventos, rehidratar los agregados y crear proyecciones.
• Enrutamiento de comandos: Mediador que invoca los handlers dependiendo del comando o evento recibido.
  • La implementación WolverineCommandRouter es una abstracción de Wolverine como mediador.
• Transacciones automáticas: SaveChanges() automático al finalizar la ejecución del handler.

Configuración

Requisitos previos

• .NET 9 SDK: Asegúrate de tener instalado el SDK de .NET 9.
• Docker desktop: La solución incluye un docker compose para levantar los contenedores de base de datos y aplcación.