ApiTurismo es un proyecto diseñado para proporcionar servicios relacionados con la gestión de turismo a través de una arquitectura basada en microservicios. Este proyecto está construido utilizando ASP.NET Core y sigue una arquitectura de capas, lo que facilita la separación de preocupaciones y la escalabilidad del sistema.
El proyecto se organiza en varias capas y bibliotecas de clases que se comunican entre sí para gestionar las operaciones de la API de turismo. A continuación se describen los componentes clave:
Antes de ejecutar el proyecto, asegúrate de tener instalados los siguientes requisitos:
- .NET 8.0 SDK o superior
- SQL Server o cualquier otro servidor compatible para la base de datos
- Servidor SMTP para el servicio de correo electrónico
-
Clonar el repositorio:
git clone https://github.com/AldairDominguez/ApiTurismo.git cd ApiTurismo
-
Restaurar dependencias:
Navega a la carpeta raíz del proyecto y ejecuta:
dotnet restore
-
Configurar la cadena de conexión de la base de datos y las credenciales del servidor SMTP:
Abre el archivo
appsettings.json
en la carpetaTurismoApp.API
y actualiza la cadena de conexión de la base de datos según tu entorno. Además, configura las credenciales del servidor SMTP en el archivoEmailService.cs
, ubicado en la carpetaTurismoApp.Services
, para habilitar el envío de correos electrónicos. -
Aplicar migraciones y actualizar la base de datos:
Ejecuta el siguiente comando para aplicar las migraciones a la base de datos:
dotnet ef database update --project TurismoApp.Infrastructure
Alternativamente, si prefieres ejecutar la migración manualmente en tu PC, puedes utilizar los siguientes comandos en la consola del Package Manager (PMC) o en la terminal de comandos:
Crear la migración inicial
Add-Migration InitialCreate -Project TurismoApp.Infrastructure
Aplicar la migración a la base de datos
Update-Database -Project TurismoApp.Infrastructure
-
Compilar el proyecto:
dotnet build
-
Ejecutar la API:
dotnet run --project TurismoApp.API
La API estará disponible en
https://localhost:5001
ohttp://localhost:5000
.
Puedes probar la API utilizando la interfaz de Swagger proporcionada en el despliegue en la web. Swagger permite interactuar fácilmente con los endpoints y ver las respuestas de la API.
-
URL de Swagger:
Puedes acceder a la documentación y probar los endpoints directamente desde http://apiturismo.somee.com/swagger/index.html.
Si deseas contribuir a este proyecto, puedes hacer un fork del repositorio y enviar un pull request con tus mejoras o correcciones. Todas las contribuciones son bienvenidas.
Este proyecto está bajo la MIT License.