3xR - Radar Running Races Asturias 🏃‍♂️💨

El centro de control definitivo para los corredores en Asturias. Una Progressive Web App (PWA) diseñada para centralizar, filtrar y notificar todas las carreras populares, trail running, asfalto y más en la región.

🚀 Características Principales

• Scraping Multi-fuente: Extracción automática de datos de federaciones, clubes y plataformas de cronometraje.
• Deduplicación Inteligente: Sistema avanzado para evitar carreras repetidas basándose en títulos, fechas y enlaces únicos.
• Interfaz Mobile-First: Diseño moderno con soporte nativo para Dark Mode.
• Filtros Dinámicos: Menú de categorías inteligente con contadores en tiempo real.
• Zona Runner & IA (Nuevo!):
  • Coach Xuan: Asistente de IA experto en la tierrina para resolver dudas sobre entrenamientos, equipación y motivación.
  • Calculadora de Ritmos: Herramienta interactiva para planificar tus objetivos en carrera.
  • Exportación ICS: Descarga tus carreras favoritas directamente al calendario de tu móvil.
• Notificaciones Push: Recibe alertas instantáneas cuando se detecta una nueva carrera.
• Almacenamiento Intermedio: Cacheo de carteles en Supabase Storage para máxima fiabilidad.

🛠️ Stack Tecnológico

• Backend: Node.js, Express.
• IA: Groq API (Llama 3.1 8B).
• Base de Datos: Supabase (PostgreSQL).
• Autenticación: Supabase Auth (OAuth con Google).
• Frontend: Vanilla JS, Tailwind CSS.
• Scraping: Axios, Cheerio.
• Despliegue: Vercel (Serverless & Crons).

📦 Instalación y Configuración

1. Clonar el repositorio:

   git clone https://github.com/charran78/radar-carreras.git
   cd radar-carreras

2. Instalar dependencias:

   npm install

3. Configurar variables de entorno: Crea un archivo .env con las claves de Supabase, VAPID y tu GROQ_API_KEY. Tienes el ejemplo en el .env.example:

   SUPABASE_URL=https://example.supabase.co
   SUPABASE_ANON_KEY=eyJ_TuClave
   VAPID_PUBLIC_KEY=BD_tu_clave
   VAPID_PRIVATE_KEY=tEtu_clave
   VAPID_EMAIL=mailto:example@gmail.com
   SUPABASE_SERVICE_ROLE_KEY=eyJtu_clave
   GROQ_API_KEY=gsk_tu_clave
   NODE_ENV=development
   BASE_URL=https://example.vercel.app

4. Iniciar el servidor:

   npm start

🧹 Mantenimiento Automático

El sistema incluye una tarea programada (Vercel Cron) que se ejecuta cada noche a las 3:30 AM para actualizar el calendario y limpiar recursos antiguos.

---

Desarrollado con ❤️ para la comunidad runner de Asturias.