prueba tecnica

2025-06-15 18:29:25 +02:00
parent 9758ee0bc6
commit d97e55a83f
127 changed files with 6488 additions and 1 deletions
--- a/README.md
+++ b/README.md
@@ -1,2 +1,108 @@
-# prueba_tecnica_proxima
+# 🚀 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 
+
+## 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 🎨
+
+
+    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.