📌 Documento vivo. Última actualización: 7 jul 2026. Fuente única de verdad del proyecto Clubeños Viajeros: visión, decisiones, modelo de datos, alcance y próximos pasos. Cualquier inconsistencia se resuelve aquí.

📍 Estado actual

Fase: 🟢 Prototipo desplegado y online — en pruebas con Jota.

Último movimiento: MVP funcionando de punta a punta y publicado. Worker desplegado en Cloudflare (conectado a Airtable, datos de ejemplo sembrados), prototipo + landing en Cloudflare Pages, Notion publicado, correo para Jota preparado.

Próximo movimiento previsto: esperar feedback de Jota. Después: envolver como Telegram Mini App (bot + WebApp + validación initData). Pendientes menores: rollups de perfil (manual en Airtable) y validación de socio en el backend antes de producción.

Bloqueadores activos: ninguno.

🔗 Enlaces y recursos

Recurso	Enlace / ID
App online (landing + prototipo)	https://clubenos-viajeros.pages.dev
Backend (Cloudflare Worker)	https://clubenos-viajeros-api.guinojrjr.workers.dev
Base Airtable	`app62BctfeW2HNcBD` · https://airtable.com/app62BctfeW2HNcBD
Notion público (para Jota)	Clubeños Viajeros — Hub
Cloudflare	cuenta [email protected] (misma que Lucas; separado por nombre `clubenos-*`)
Carpeta local backend	G:…JordiCLUB (worker.js, wrangler.toml)

🔐 El secreto AIRTABLE_TOKEN vive en el Worker (Cloudflare), nunca en el cliente ni en Notion. Endpoints: /api/health, /api/trips, /api/trips/:id/recs, POST /api/recs, POST /api/trips, /api/debug.

🎯 Visión y problema

El grupo "Clubeños Viajeros" quiere coordinar, dentro del club de fotografía callejera de Jota Barros, dónde y cuándo viaja cada socio y que el resto pueda dejarle recomendaciones ceñidas a la fotografía: lugares para visitar y fotografiar, sitios de comida, exposiciones, museos, etc.

Problema con el statu quo: hoy todo pasa por Telegram (un chat por temática). Para información estructurada (lugar + fechas + recomendaciones asociadas), un chat es lineal y efímero → la info se entierra y no se puede buscar ni filtrar. De ahí nace la app.

Los dos roles de socio (no son personas distintas, son modos):

Viajero — marca a dónde y cuándo va; durante/tras el viaje registra lugares, fotos/vídeos y comentarios.
Recomendador — aporta información útil de un lugar que conoce (comentarios, fotos, links a restaurantes/expos/sitios), con valoración de 1-5 estrellas.

Dentro de recomendador hay dos sub-modos:

Reactivo: alguien anuncia viaje → quien conoce la zona responde con recomendaciones. (Simple, arranca solo — es lo que ya hacen en el chat, ordenado.)
Proactivo: el socio pre-registra sitios que conoce o dónde vive/ha estado → el sistema cruza con viajes anunciados y le salta una alerta para que aporte proactivamente. Incluye la conexión "alguien viaja cerca de donde vivo → quedamos". (Más potente pero sufre arranque en frío.)