# RunBot - Io ti trovo la prossima gara, poi però la corri tu!

RunBot è un assistente personale basato su intelligenza artificiale, disponibile su WhatsApp e Telegram, progettato per aiutare i runner a scoprire la loro prossima sfida podistica.

## Missione
Trovare la gara perfetta per te, analizzando le tue preferenze espresse in linguaggio naturale e, opzionalmente, il tuo storico di allenamenti su Strava.

## Funzionalità Principali

### 🤖 Ricerca Intelligente
Descrivi la gara che cerchi come se parlassi con un amico. RunBot capisce parametri come distanza, località e data estratti da messaggi spontanei.
- **Esempio:** "Vorrei una mezza maratona in Toscana a marzo"

### 🏃 Integrazione Strava
Collega il tuo profilo Strava per ricevere suggerimenti personalizzati. RunBot analizza il tuo livello e il tuo storico per consigliarti gare adatte alla tua preparazione.

### 📍 Database Gare Aggiornato
Accesso a un catalogo completo di gare podistiche, costantemente aggiornato tramite parsing intelligente (AI) di siti web e locandine.

### 🔔 Notifiche e Aggiornamenti
Ricevi notifiche su nuove gare che corrispondono al tuo profilo direttamente in chat. Nessuna app da installare.

## Come Funziona

1. **Avvia la Chat**: Contatta RunBot su Telegram o WhatsApp.
2. **Collega Strava (Opzionale)**: Per suggerimenti basati sulle tue reali prestazioni.
3. **Descrivi la Gara**: Scrivi cosa stai cercando in linguaggio naturale.
4. **Ottieni i Risultati**: Ricevi i link diretti e i dettagli della gara perfetta per te.

## Dettagli Tecnici (Dietro le Quinte)

- **AI Engine**: Google Gemini AI per l'interpretazione del linguaggio naturale e il parsing dei dati disomogenei.
- **Architettura**: Basata su Node.js e TypeScript. Utilizza grammY per l'interfaccia Telegram e un porting custom per la WhatsApp Business Platform.
- **Geolocalizzazione**: Integrazione con OpenStreetMap per ricerche basate sulla posizione.
- **Messaging**: Sistema asincrono basato su ZeroMQ per la gestione delle notifiche.

## Contatti e Link
- **Sito Web**: https://runbot.vijon.it
- **WhatsApp**: https://wa.me/393534974470
- **Telegram**: https://t.me/vijon_runbot
- **Sviluppatore**: Mauro Casolaro (Vijon)
- **Email**: info@vijon.it