Bienvenido a Financia.al

🚀 Introducción

Financia.al es una plataforma web fintech que busca conectar a inversores interesados en financiar la venta de terrenos en distintos países de Latinoamérica con potenciales compradores. Ofrecemos una experiencia simplificada y segura para que todos los usuarios puedan hacer solicitudes de financiamiento, pagar sus cuotas e invertir sus fondos en un activo de sólida revalorización a mediano plazo.

---

🎯 Objetivo Principal

Conectar a inversores interesados en financiar la venta de terrenos en distintos países de Latinoamérica con compradores potenciales.

---

🌟 Funcionalidades

✅ Gestión de Financiamiento: Herramientas que permite a los usuarios definir términos de pago, tasas de interés y plazos personalizados.

✅ Simulador de Crédito: Un simulador interactivo que permite a los compradores e inversores simular diferentes escenarios de crédito y visualizar los resultados, estimando el monto de las cuotas mensuales basadas en el capital solicitado, tasa de interés y plazo.

✅ Evaluación de Riesgo Crediticio: Herramienta que permite evaluar el riesgo crediticio de los usuarios compradores, brindando transparencia para los inversores.

✅ Autenticación de Usuarios: Proceso de verificación riguroso que asegura la identidad de todos los usuarios para garantizar la confidencialidad y seguridad.

✅ Panel de Control de Usuarios: Muestra un resumen de las finanzas realizadas por el usuario. A los compradores les muestra la información de sus préstamos y cuotas a pagar. Mientras que a los inversores les muestra un resumen completo de su inversión y las ganancias por mes.

✅ Chatbot de Atención al Cliente: Chatbot que responde a preguntas frecuentes sobre la plataforma.

---

📝 Instrucciones de Configuración e Instalación Local

Software requerido:

• Node.js (versión 16 o superior)
• Git
• Visual Studio (.NET 8 o superior)
• Visual Studio Code (C# Dev Kit)
• Microsoft SQL Server 2019+
• SQL Server Management Studio
• PostgreSQL

Pasos para instalar el proyecto:

1. Clonar el repositorio:

   git clone https://github.com/No-Country-simulation/equipo-h3-18-proptech.git
   

2. Para configurar el Frontend, es necesario entrar en la carpeta Frontend y luego en h3-18-proptech para poder instalar las dependencias:

   \equipo-h3-18-proptech>cd Frontend
   \equipo-h3-18-proptech\Frontend> cd h3-18-proptech
   \equipo-h3-18-proptech\Frontend\h3-18-proptech> npm install
   

3. Dentro de la carpeta h3-18-proptech, crear el archivo .env y agregar las siguientes variables de entorno:

   VITE_BACKEND_URL=<URL donde se encuentra alojado el Backend>
   VITE_MERCADO_PAGO_KEY=<Llave para desarrolladores de Mercado Pago>

4. Ejecutar el servidor de desarrollo Frontend:

   \equipo-h3-18-proptech\Frontend\h3-18-proptech> npm run dev

5. Visitar la URL: http://localhost:5173/

Configuración del Backend

Requisitos de servicios externos:

• SendGrid (para servicios de correo):
  • Necesitas un correo empresarial/fintech y una API Key, que puedes obtener en SendGrid.
• Cloudinary (para almacenamiento de archivos multimedia):
  • Necesitas cloudName, apiKey y apiSecret. Puedes registrarte y obtenerlas en Cloudinary.
• Mercado Pago (para pasarela de pagos):
  • Necesitas un accessToken y una secretKey para webhooks. Puedes obtenerlas desde Mercado Pago Developers.

Nota: Asegúrate de reemplazar las URLs y claves en los archivos de configuración con los valores correctos obtenidos de las respectivas plataformas mencionadas. Para más información, visita las páginas oficiales de SendGrid, Cloudinary y Mercado Pago Developers.

Configuración de bases de datos:

• PostgreSQL: Necesitas una cadena de conexión para la base de datos de la aplicación.
• SQL Server: Necesitas otra cadena de conexión para la base de datos de autenticación (Identity Framework).

Configuración de variables de entorno:

1. Ve a la carpeta equipo-h3-18-proptech\Backend\h3-18-proptechback\h3-18-proptechback.API.
2. Crear el archivo appsettings.Development.json y pegar el siguiente contenido, reemplazando los valores con tus claves obtenidas:

   {
     "ConnectionStrings": {
       "ConnectionString": "[Tu cadena de conexión de PostgreSQL]",
       "IdentityConnectionString": "[Tu cadena de conexión de SQL Server]"
     },
     "EmailSettings": {
       "ApiKey": "[Tu API Key de SendGrid]",
       "FromAddress": "[Correo empresarial/fintech]",
       "FromName": "Financial.AI"
     },
     "Logging": {
       "LogLevel": {
         "Default": "Information",
         "Microsoft.AspNetCore": "Warning"
       }
     },
     "AllowedHosts": "*",
     "JwtSettings": {
       "Key": "[Tu clave JWT]",
       "Issuer": "https://www.equipo-h3-18-proptechbackend.somee.com",
       "Audience": "https://equipo-h3-18-proptech-desarrollo.onrender.com",
       "DurationInMinute": 360
     },
     "CloudinarySettings": {
       "CloudName": "[Tu CloudName de Cloudinary]",
       "ApiKey": "[Tu ApiKey de Cloudinary]",
       "ApiSecret": "[Tu ApiSecret de Cloudinary]"
     },
     "apiUrl": "https://api.bcra.gob.ar/CentralDeDeudores/",
     "dolarAPIURL": "https://dolarapi.com",
     "MercadoPagoConfiguration": {
       "AccessToken": "[Tu AccessToken de Mercado Pago]",
       "WebHookSecretKey": "[Tu SecretKey de webhooks de Mercado Pago]"
     }
   }

3. Reemplaza el valor [TU clave JWT] con una clave secreta de 32 caracteres o más.

Configurar las bases de datos:

1. Vuelve a la carpeta equipo-h3-18-proptech\Backend\h3-18-proptechback.

2. Abre el archivo h3-18-proptechback.sln con Visual Studio.

3. Abre la Consola del Administrador de Paquetes en Visual Studio.

4. Ejecuta los siguientes comandos para aplicar las migraciones y crear las bases de datos:

   update-database -context h3_18_proptechbackIdentityDbContext
   update-database -context ApplicationDbContext

Ejecutar el proyecto:

Presiona F5 en Visual Studio para iniciar el proyecto.

---

🛠️ Tecnologías

Front-End	Back-End	UX/UI

---

🌐 Integraciones Externas

La plataforma Financia.al utiliza diversas herramientas y servicios externos para ofrecer funcionalidades avanzadas y garantizar una experiencia óptima para los usuarios:

• 🖼️ Cloudinary: Gestión y almacenamiento de archivos multimedia y documentos en la nube. Este servicio permite cargar, almacenar, transformar y entregar archivos multimedia de manera eficiente.

• 💱 DolarAPI: Integración para consultar el tipo de cambio oficial del dólar a distintas monedas locales, facilitando transacciones financieras internacionales y cálculos precisos.

• 💳 MercadoPago: Implementación de una pasarela de pagos que permite realizar pagos con tarjetas de crédito, débito, y billeteras virtuales de manera segura.

• 📊 BCRA API: Consumo de la API del Banco Central de la República Argentina para obtener el score crediticio de entidades según el CUIT, lo que fortalece la evaluación de riesgo crediticio.

• ✉️ SendGrid: Herramienta para la personalización y envío de correos electrónicos transaccionales y de notificaciones, asegurando una comunicación directa y profesional con los usuarios.

---

👫 Equipo

⚛️ Front-End

Nombre	GitHub	LinkedIn
Angel Añez
Emanuel Capo

💻 Back-End

Nombre	GitHub	LinkedIn
Abel Montes Vega
Deivison Jiménez

🖌 UX/UI

Nombre	Github	Linkedin
Natalia Caniza

♟️ Team Leader

Nombre	Github	Linkedin
Gloria Nabor

---

🔗 Enlaces Importantes

• 🚀 Front-End Deploy
• 📜 Back-End Swagger Documentación
• 🖌️ Figma Design
• 📖 Documentación General
• 🎥 Video de Presentación