115 lines
2.8 KiB
Markdown
115 lines
2.8 KiB
Markdown
# 🚀 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.
|
||
|