🚀 Guía rápida para poner el proyecto en marcha

🔧 Stack requerido

Docker Opcional. https://www.docker.com/

(Este proyecto ha sido desarrollado con Docker para la base de datos en local por lo que es muy recomendable usarlo)

Node.js & npm Cualquier versión LTS reciente (18 +) https://nodejs.org/es

.NET 8 SDK Necesario para el backend https://dotnet.microsoft.com/es-es/download

Si no consigues levantar el proyecto, puedes verlo funcionando en https://quediaempiezo.asarmientotest.es/

Levantar proyecto en local

1. Clona el repo:

git clone https://gitea.alexdev.es/alex/prueba_tecnica_proxima.git
cd prueba_tecnica_proxima

1. Arrancar la base de datos 📦

desde la raíz del repo

cd levantarDBSola

docker compose up -d

La imagen de Postgres 16 se inicializa y ejecuta automáticamente los scripts de ../../db (creación de tablas, datos y funciones).

Cuando el contenedor esté listo puedes cerrar esta terminal.

OJO!!! Si no vas a usar docker:

Crea la base de datos ejecutando en orden todos los scripts de la carpeta.

Usuario: proxima_user

Password: Proxima_Password

2. Levantar el backend ⚙️

desde la raíz del repo

cd backend/ProximaContracts/ProximaContracts.API

dotnet run           # puerto 5009 por defecto

Si prefieres un IDE:

abre la solución backend/ProximaContracts/ProximaContracts.sln en Visual Studio o Rider y ejecuta la API.

Swagger: http://localhost:5009/swagger/index.html

si ejecutas con Visual Studio irás directo al swagger

3. Iniciar el frontend 🎨

desde la raíz del repo

cd front/contracts-frontend

npm install

npm run dev          # puerto 5173

Visita: http://localhost:5173/ y ¡listo!

🌐 Despliegue en producción

Clona el repo:

git clone https://gitea.alexdev.es/alex/prueba_tecnica_proxima.git
cd prueba_tecnica_proxima

Configura CORS

Edita backend/ProximaContracts/ProximaContracts.API/appsettings.json y pon la URL de tu dominio.

Convigura .env.production

Edita prueba_tecnica_proxima/front/contracts-frontend/.env.production usando la misma url acabada en /api

Compila y arranca:

chmod +x deploy.sh     # (solo la primera vez)
./deploy.sh

DNS + HTTPS

Asegúrate de que el dominio apunta al servidor.

Caddy gestionará automáticamente los certificados Let’s Encrypt.

Ejemplo desplegado: https://quediaempiezo.asarmientotest.es/

🎨 Imágenes

Todas las imágenes se encuentran en la carpeta images en la raíz del proyecto

🤝 Contacto

¿Dudas o sugerencias? 📧 contact@asarmiento.es  |  📞 Llámame cuando quieras.