dotnet clean arch

Ejemplo de arquitectura limpia en C#

Este repositorio proporciona una implementación de la arquitectura limpia en una solución de C# que se integra con una API HTTP meteorológica, que integran herramientas modernas esenciales como Prometheus y Grafana para el monitoreo y la observabilidad.

Estructura de proyectos

Este proyecto sigue la estructura de arquitectura limpia:

• CleanArch.Api : la capa API web, que contiene controladores, configuración y configuración de inyección de dependencia.
• CleanArch.Domain : entidades básicas de lógica comercial y dominio.
• CleanArch.Application : lógica y casos de uso específicos de la aplicación.
• CleanArch.Infrastructure : código de infraestructura, como la integración del servicio externo y la persistencia de datos.

Bibliotecas y herramientas

El proyecto utiliza las siguientes bibliotecas y herramientas:

• ASP.NET Core : para construir la API web.
• SERILOG : para registrar.
• Prometheus.net : para exponer las métricas de la aplicación.
• Docker Compose : para orquestar servicios como la API, Prometheus y Grafana.

Monitoreo y observabilidad

El proyecto incluye un archivo docker-compose.yml que se establece:

• Prometeo : raspar métricos expuestas por la API.
• Grafana : para visualizar métricas de Prometeo.

Punto final de métricas

La aplicación expone métricas a /metrics utilizando la biblioteca Prometheus.net .

Instrucciones de configuración

Requisitos previos

• Docker y Docker componen instalados.
• Clave de la API Weatherstack para la integración de la API meteorológica.

Pasos

1. Clon el repositorio:

git clone https://github.com/MatheusSw/dotnet-clean-arch.git
cd CleanArch

2. Agregue su tecla API de WeatherStack a las variables de entorno de su sistema
3. Construya y ejecute la aplicación usando Docker Compose:

docker-compose up --build

4. Acceder a los servicios:

• API : http: // localhost: 8080
• Prometheus : http: // localhost: 9090
• Grafana : http: // localhost: 3000

Visualización de métricas

1. Inicie sesión en Grafana en http: // localhost: 3000 (administrador predeterminado/administrador).
2. Agregue Prometheus como fuente de datos. (Use Prometeo: 9090 como URL)
3. Importe paneles preconfigurados o cree los personalizados para monitorear el rendimiento de la API.

Ejemplo de puntos finales de API

• Get /weathers?location=Brasil Sao Paulo : obtiene información meteorológica para una ubicación específica utilizando la API WeatherStack.