# 🚀 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

| ![](images/Responsive2.png) | ![](images/Responsive7.png) | ![](images/Responsive4.png) |
|:--:|:--:|:--:|
| ![](images/validationExample.png) | ![](images/ValidationExampleDNI1.png) | ![](images/SelectTarifaEnCreate.png) |



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