Cazurronics Planner
Web que monta planes por horas en León y su provincia con IA: la persona dice qué le apetece, su presupuesto y una zona en el mapa, y recibe una ruta con sitios reales (comprobados en Google Places), la previsión del tiempo y la agenda de eventos de ese día. Los planes se pueden compartir y votar en grupo.
Hecha con Next.js 16 (App Router), React 19, Tailwind 4 y Leaflet. Se despliega en Vercel.
Arrancar en local
npm install
npm run dev
Abre http://localhost:3000. Sin Redis configurado, los datos se guardan en memoria y se borran al reiniciar.
| Comando | Para qué |
|---|
npm run dev | Servidor de desarrollo |
npm run build | Compilar para producción |
npm run lint | Revisar el código con ESLint |
npm test | Tests de la lógica (duplicados, horas, presupuesto, finde, votos…) |
Variables de entorno
Van en .env.local en local y en Vercel → Settings → Environment Variables.
| Variable | Obligatoria | Qué es |
|---|
GEMINI_API_KEY | Sí | Clave de Google AI Studio (Gemini). Solo se usa en el servidor. |
GOOGLE_MAPS_API_KEY | Sí | Places, Geocoding y fotos de Google Maps. |
STREET_VIEW_API_KEY | No | Clave para la vista 360º. Acaba en el navegador (va dentro del iframe), así que restríngela por dominio en Google Cloud. Si falta, se usa GOOGLE_MAPS_API_KEY (nunca la de Gemini). |
KV_REST_API_URL / KV_REST_API_TOKEN | En producción | Redis de Upstash (Vercel → Storage → Upstash for Redis). También valen UPSTASH_REDIS_REST_URL / _TOKEN. |
PANEL_CLAVE | Para /panel | Contraseña del panel del equipo. |
NEGOCIOS_SECRETO | Recomendada | Firma los enlaces privados de cada local (/negocio/…). Si falta, se usa PANEL_CLAVE. |
CRON_SECRET | En producción | Vercel la manda a los crons. Sin ella, los crons responden 401. |
NEXT_PUBLIC_SITE_URL | Con dominio propio | Por ejemplo https://cazurronics.es (sitemap, enlaces y textos para compartir). |
NEXT_PUBLIC_GAS_BUSINESS_URL | No | Google Apps Script que recibe las solicitudes de negocios (además se guardan en /panel). |
RESEND_API_KEY, AVISO_EMAIL, AVISO_DE | No | Correos de aviso al equipo (resumen del finde y locales listos para escribirles). |
TELEGRAM_TOKEN, TELEGRAM_SECRETO (y opcional TELEGRAM_CHAT_ID) | No | Bot de Telegram "asesor de métricas" (web + Instagram). Tras ponerlas, abre https://www.cazurronics.es/api/telegram?activar=PANEL_CLAVE y abre el enlace de un solo uso que te da (15 min): queda emparejado contigo. |
INSTAGRAM_TOKEN | No | Token de la API de Instagram (inicio de sesión de Instagram). El cron /api/telegram/diario guarda las cifras cada mañana y lo renueva solo. |
Cómo funciona
Montar un plan (/api/plan):
- Se comprueba lo que llega (fecha, punto del mapa, números) y se aplica un freno por conexión (20 planes cada 10 minutos).
- A la vez: el tiempo (Open-Meteo), la agenda guardada de ese día, una búsqueda de eventos a medida con Gemini y los sitios que la comunidad ha valorado bien o mal en la zona.
- Gemini (con Google Search) propone las paradas. Si un modelo está saturado, prueba el siguiente (
src/lib/gemini.js).
- Todas las paradas se comprueban a la vez en Google Places: coordenadas reales, teléfono, web, horario, foto y Street View. Los bares y restaurantes sin ficha real se descartan.
- Se ajusta al presupuesto, se quitan duplicados, se ordena por hora y se guarda para compartir (
/plan/ID). Las estadísticas y los rankings se escriben en segundo plano.
Agenda de eventos (src/lib/eventos.js): los crons de vercel.json barren cada día las fuentes de la provincia (datos abiertos de la Junta y búsquedas dirigidas con Gemini). Solo se publica lo que tiene una fuente comprobada. De ahí salen /agenda-leon, las páginas por zona, /finde y "Qué hacer hoy/mañana".
Panel del equipo (/panel): analítica propia sin cookies, ranking de locales con su enlace privado, estado del barrido, resumen del finde para redes y captación de negocios.
Estructura
src/
app/ páginas y rutas de la API (App Router)
api/ plan, retocar, planes (compartir y votar), barrido, panel, finde, captación…
components/ componentes de la interfaz
lib/ lógica: almacén (Redis), IA, eventos, agenda, zonas, lugares, freno anti-abuso…
tests/ tests de la lógica (Vitest)
vercel.json crons del barrido y de los avisos
