🚀 Wallbit Dashboard - Advanced Cache Middleware

Un dashboard moderno y premium para visualizar tus activos y transacciones de Wallbit en tiempo real, con una arquitectura optimizada para evitar límites de API (Rate Limiting) y garantizar la persistencia de datos.

✨ Características Principales

• 💳 Balance en Vivo: Visualización en tiempo real de cuentas de Checking e Inversiones (Stocks).
• 🕒 Sincronización Inteligente: Middleware de Cache (Express) que refresca datos cada 5 min de la API oficial. El frontend incluye un Timer Visual con barra de progreso que sincroniza localmente cada 5 min.
• 🇦🇷 Conversión a ARS (Real-time): Integración de "píldoras" de conversión a Pesos Argentinos (Dólar Oficial) en todas las tarjetas de saldo y gastos, facilitando el control financiero local.
• 🔍 Buscador Premium: Historial de transacciones con buscador estilo "píldora" responsivo, con efectos interactivos y estados de foco mejorados.
• 📉 Analíticas Avanzadas: Gráficos interactivos de depósitos mensuales (ARS) y distribución de gastos por categoría usando Recharts.
• 💵 Tasa en Tiempo Real: Integración con DolarAPI para obtener el tipo de cambio oficial automáticamente.
• 🌍 Historial Completo: Procesamiento optimizado de cientos de transacciones con filtros y búsqueda.
• 🛍️ Gastos Recientes: Sección dedicada para analizar el consumo de los últimos 7 días con totales en USD.
• 🎨 Diseño Persistente: Interfaz moderna con Glassmorphism, tipografía Outfit unificada para una estética premium, animaciones fluidas, y selector de temas (Light/Dark/System).
• 🐳 Docker-Ready: Infraestructura completa con Docker Compose y builds optimizados en GHCR.

🏗️ Arquitectura

• Frontend: React 19 + Vite (Servido via Nginx).
• Backend: Node.js 20 (Express) con Cron Jobs para sincronización.
• Proxy: Nginx como Reverse Proxy para unificar API y Frontend bajo un mismo puerto.
• CI/CD: GitHub Actions para builds automatizados en GHCR. Soporta arquitecturas amd64 y arm64 (Oracle ARM, Raspberry Pi) mediante builds optimizados.

🚀 Cómo Empezar

Requisitos Previos

• Docker y Docker Compose
• Una API Key de Wallbit (Consíguela en Wallbit Developer Portal)

Despliegue Rápido (Producción)

Si quieres levantarlo usando las imágenes ya compiladas en GHCR:

1. Clona el repositorio.
2. Configura tus variables de entorno en tu terminal o en un archivo .env:

   export WALLBIT_API_KEY=tu_api_key_aqui
   export DASHBOARD_TOKEN=un_token_seguro_aqui

3. Ejecuta:

   docker compose -f docker-compose.prod.yml up -d

Desarrollo Local

Para trabajar en el código base:

1. Instala las dependencias:

   npm install

2. Define tu API Key, el token y corre ambos servidores simultáneamente:

   WALLBIT_API_KEY=tu_api_key_aqui DASHBOARD_TOKEN=tu_token_aqui npm run dev

   El frontend estará en http://localhost:5173 y el backend en http://localhost:3001.

💾 Persistencia de Datos

El proyecto utiliza un volumen de Docker para guardar el historial en un archivo data.json. Esto permite que tus datos no se pierdan si reinicias el contenedor y reduce drásticamente las llamadas innecesarias a la API de Wallbit.

☁️ Despliegue Público (Cloudflare)

Consulta la guía detallada en DEPLOY.md para exponer tu dashboard de forma segura usando Cloudflare Tunnels (Zero Trust).

---

Hecho con ✨ por Johann y Antigravity.