GitHunt
YE

Yeisson8A/finanzas-app-react

Proyecto de desarrollo de una aplicación tipo Dashboard de finanzas con predicción forecast con base en los datos provistos por la API Alpha Vantage e insights para los KPIs mediante Gemini AI, usando React, TypeScript y Vite; todo esto contenerizado mediante Docker

Aplicación Dashboard de finanzas en React, TypeScript y Vite

Proyecto de desarrollo de una aplicación tipo Dashboard de finanzas con predicción forecast con base en los datos provistos por la API Alpha Vantage, así como insights para los KPIs con base en Gemini AI; usando para esto React, TypeScript y Vite; incluyendo además pruebas unitarias usando Vitest para estas funcionalidades.

Requisitos

  • Docker y Docker Compose
  • NodeJS v20 o superior

Environment

  • VITE_API_URL: Url del backend que interactúa con la API Alpha Vantage
  • VITE_REFRESH_TIME: Tiempo establecido para el refresh de los datos en el Dashboard, en la función useEffect
  • VITE_DEFAULT_SYMBOL: Símbolo o acción financiera por defecto, por ejemplo AAPL (Apple)

Instalación de paquetes

npm install: Este comando instalará todas las dependencias que se encuentran en el archivo package.json

Ejecución de la aplicación

npm run dev: Este comando ejecuta la aplicación usando vite

Construir la imagen

docker-compose build

Levantar todo

docker-compose up -d

Ejecución de pruebas unitarias

npm test: Este comando ejecutará las diferentes pruebas unitarias que se encuentran en la carpeta tests

Ejecución de cobertura de pruebas

npm run test:coverage: Este comando ejecutará la cobertura de las pruebas unitarias, la cual se podrá encontrar en la carpeta coverage y en el archivo index.html