manual
del sistema

tripbier es una plataforma serverless de descubrimiento e itinerarios de cervecerías artesanales. Combina una base de datos georreferenciada con IA generativa para crear experiencias personalizadas — desde el mapa interactivo hasta el itinerario narrado por un concierge cervecero.

Toda la infraestructura corre en Cloudflare (Workers + D1 + KV + R2), sin servidores propios, con latencia global de borde y costo variable por uso. El modelo de datos es SQLite vía D1, distribuido en múltiples bases por continente.

El sistema está compuesto por 6 workers independientes, cada uno con responsabilidad específica, que se comunican mediante fetch interno o comparten estado a través del KV.

El radar (tripbier.com/mapa.html) es el corazón de la plataforma — un mapa Leaflet con 19.900+ pines de cervecerías en 16 países, con MarkerCluster para rendimiento y filtros en tiempo real.

Al abrirse, el mapa usa la geolocalización del navegador o la IP (Cloudflare cf.city) para centrarse automáticamente. Cada pin abre una tarjeta con rating, dirección, enlace a Instagram/sitio y botón "ver ruta en Google Maps". Las cervecerías premiadas obtienen un marcador diferenciado.

Parámetros de URL admitidos por el mapa:

El concierge tripbier es un pipeline de 6 mini-agentes que transforma un mensaje de texto en un itinerario cervecero personalizado. Cada agente recibe un sobre de datos, lo enriquece y lo pasa al siguiente.

El concierge es multifunción por diseño — no es un chatbot con menú de opciones. El usuario escribe en lenguaje natural y el sistema detecta la intención automáticamente, sin pedir que elija un modo:

El Validador detecta los 4 modos sin ninguna llamada a LLM — lógica pura en JavaScript. Normaliza siglas (poa → Porto Alegre, cwb → Curitiba) antes del Extractor. El Curador consulta bases en cascada: DB Brasil → DB_AMERICAS → DB_EUROPE → DB_ASIA → Serper Discovery como fallback final.

El pasaporte tripbier es una PWA (Progressive Web App) instalable que permite al usuario coleccionar sellos en cada visita a cervecerías socias. Es el motor de gamificación y fidelización de la plataforma.

Flujo del usuario: El usuario entra en passaporte.tripbier.com, lo instala en su celular (pantalla de inicio), se identifica con nombre y WhatsApp (sin registro), y recibe sellos al hacer check-in en cervecerías del circuito.

Circuitos disponibles: Cada itinerario de socio tiene un circuito con N paradas. Completar todas las paradas desbloquea un beneficio en la cervecería socia (regalo, descuento, experiencia exclusiva). El panel socio (admin-parceiro) muestra en tiempo real quién completó y permite enviar el premio por WhatsApp.

Niveles: Curioso → Aprendiz → Explorador → Maestro → Sommelier — basados en la cantidad de sellos acumulados en total.

Los itinerarios son generados por el pipeline Maestro y guardados automáticamente en D1 con una URL permanente y única — sin inicio de sesión. La URL puede compartirse por WhatsApp, incluirse en un correo o guardarse en favoritos.

Formato de la URL: tripbier.com/roteiros.html?id={slug} — donde el slug es generado por el Curador a partir de la ciudad, perfil y hash de la selección (ej: variedade-porto-alegre-3d-a1b2).

Cada itinerario almacena: lista de cervecerías (id, nombre, nota del curador), ciudad, perfil elegido, número de días, clima en el momento de la generación y la narrativa del Presentador.

La capa social permite que los usuarios del pasaporte interactúen entre sí: compartan itinerarios, comenten en cervecerías, sigan a otros viajeros y acumulen un historial de visitas visible en el perfil público.

Identidad basada en teléfono + nombre (sin contraseña). Avatar generado automáticamente por DiceBear. El feed de actividad muestra visitas recientes de la comunidad en cada ciudad.

Moderación: regex automático detecta teléfonos, enlaces y contenido inapropiado en comentarios antes de guardarlos en D1.

tripbier tiene cobertura activa en 16 países, con base de datos, ciudades editoriales y enrutamiento por el concierge. Cada país tiene páginas de ciudades e integración con el mapa global.

Las páginas de países son dinámicas — no existen como archivos estáticos. Son generadas en tiempo real por el worker a partir de los datos del D1: cervecerías, ciudades, premiaciones y contenido editorial. Esto significa que agregar un nuevo país a la base de datos crea automáticamente todas sus páginas, sin ningún trabajo manual de publicación. Es infraestructura de escala disfrazada de contenido.

Cada ciudad con masa crítica de cervecerías recibe una página editorial curada — no generada automáticamente, sino escrita con identidad local. La plantilla base es caxias.html (patrón serifado con sidebar, hero, pull-quote y grid de tarjetas).

Estructura de la página: hero con foto local → editorial "por qué visitar" → pull-quote → grid de cervecerías con rating/insta/sitio/agente → eventos → itinerario sugerido. La sección de noticias es alimentada por utt-beerfeed en tiempo real.

Todas las páginas de ciudades internacionales están en el subdirectorio del país: /de/berlim.html, /be/bruges.html, /it/roma.html, etc. Al igual que las páginas de países, las páginas de ciudades son generadas dinámicamente — el worker construye el HTML a partir del D1 en cada solicitud, sin archivos precompilados. Una nueva ciudad con cervecerías suficientes en la base ya tiene su página disponible.

Las cervecerías premiadas (CBC, WBC o WBA) reciben automáticamente una landing page dinámica generada a partir de los datos del D1 — sin intervención manual. El acceso es vía subdominio: slug.tripbier.com.

Contenido mostrado: nombre, ciudad/estado, rating y votos Google, horarios de atención por día de la semana, cervezas en producción (nombre, estilo, ABV, IBU), premiaciones con medalla y año, blog posts relacionados, mapa embed, botones para Instagram/sitio/WhatsApp y chat con agente IA especializado en la cervecería.

Regla de acceso: Si la cervecería tiene premiación → renderiza landing page completa. Si no tiene premiación pero tiene Instagram o sitio → redirige (302) a la red social. Si no tiene nada → 404.

Caché: cada landing page se almacena en el edge cache de Cloudflare por 1 hora (stale-while-revalidate=86400) — cero CPU en las visitas recurrentes.

tripbier indexa las medallas de los principales concursos de cerveza artesanal y las muestra en las landing pages de cervecerías y en la página de premiaciones. Las medallas son criterio de clasificación en el Curador.

El panel socio es la interfaz de gestión para propietarios de cervecerías. Acceso vía slug de la cervecería (sin inicio de sesión — auth por token vía URL, a implementar). URL directa: tripbier.com/admin-parceiro?slug={slug}.

agm.tripbier.com es un subdominio dedicado a la alianza tripbier × AGM — una pitch page editorial con las 19 cervecerías asociadas mapeadas, historia del movimiento craft gaúcho y CTA para afiliación.

Contenido histórico basado en investigación académica verificada: Cruz, R.C. (2016). Consumo e Formação de Mercado: um estudo sobre as microcervejarias de Porto Alegre. Dissertação UNISINOS.

Cronología: Dado Bier (1995, primera microcervejaria BR) → WE Consultoria (1997) → Acerva Gaúcha (2003) → AGM fundada por Jorge Gitzler → ICMS reducido en RS → Polo Anchieta (2010) → 50+ asociadas hoy.

Las cervecerías sin perfil completo muestran un CTA "¿Esta es tu cervecería?" en la landing page y en el chat widget. Al hacer clic, el propietario completa un formulario simple (nombre, e-mail, cargo, WhatsApp) que genera un lead en D1 (reivindicacoes) y dispara una notificación interna.

Es el embudo de entrada al modelo B2B: Starter (R$89/mes) → Professional (R$149/mes) → Premium (R$297/mes), con incremento de funciones en el panel socio y visibilidad en el mapa.

tripbier usa analytics 1st-party — sin Google Analytics, sin cookies de terceros. El tracker (/a/tracker.js) es cargado por todas las páginas y envía eventos a /collect en utt-analytics.

Datos recopilados: páginas visitadas, tiempo de permanencia (dwell), recurrencia de sesión, embudo de conversión (inicio → mapa → itinerario → pasaporte), país/ciudad (CF headers), tipo de dispositivo. Sin PII — el identificador es hash SHA1 de IP+UA.

Cron diario: utt-analytics agrega los eventos brutos y graba resúmenes diarios en D1 (id: 170900e5) — visitantes únicos, pageviews, países top-5, bandwidth. El dashboard analytics lee de esos resúmenes.

Clics rastreados: Instagram, sitio, WhatsApp — por cervecería, por origen geográfico, por dispositivo.

El banner de cookies es inyectado por el worker en todas las páginas vía middleware — ninguna página necesita incluir el script manualmente. El consentimiento se almacena en localStorage por 365 días.

Todo el deploy se realiza con Wrangler CLI desde el directorio G:\Site\tripbier\utt-engine\PRD\js\. La configuración está en wrangler.toml. Las credenciales de API (OpenAI, Serper, Google Places) están en G:\Site\tripbier\upg-engine\pipeline\.env.

Regla de oro: modificar el worker o el HTML sin antes listar qué cambia y a quién afecta puede causar una regresión silenciosa. El proceso correcto: (1) listar cambios e impacto, (2) confirmar con Marcos, (3) publicar.

Atención: Tripbier y ClubTour son cuentas/negocios separados — nunca cruzar workers, datos ni credenciales entre los dos.