manual
do sistema

O tripbier é uma plataforma serverless de descoberta e roteiros de cervejarias artesanais. Combina um banco de dados georreferenciado com IA generativa para criar experiências personalizadas — do mapa interativo ao roteiro narrado por um concierge cervejeiro.

Toda a infraestrutura roda em Cloudflare (Workers + D1 + KV + R2), sem servidores próprios, com latência global de borda e custo variável por uso. O modelo de dados é SQLite via D1, distribuído em múltiplos bancos por continente.

O sistema é composto por 6 workers independentes, cada um com responsabilidade específica, comunicando-se via fetch interno ou compartilhando estado pelo KV.

O radar (tripbier.com/mapa.html) é o coração da plataforma — um mapa Leaflet com 19.900+ pins de cervejarias em 16 países, com MarkerCluster para performance e filtros em tempo real.

Ao abrir, o mapa usa a geolocalização do browser ou o IP (Cloudflare cf.city) para centralizar automaticamente. Cada pin abre um card com rating, endereço, link para Instagram/site e botão "ver rota no Google Maps". Cervejarias premiadas ganham marcador diferenciado.

Parâmetros de URL aceitos pelo mapa:

O concierge tripbier é um pipeline de 6 mini-agentes que transforma uma mensagem de texto em um roteiro cervejeiro personalizado. Cada agente recebe um envelope de dados, enriquece e passa para o próximo.

O concierge é multi-função por design — não é um chatbot com menu de opções. O usuário escreve em linguagem natural e o sistema detecta a intenção automaticamente, sem pedir escolha de modo:

O Validador detecta os 4 modos sem nenhuma chamada de LLM — lógica pura em JavaScript. Normaliza siglas (poa → Porto Alegre, cwb → Curitiba) antes do Extrator. O Curador consulta bancos em cascata: DB Brasil → DB_AMERICAS → DB_EUROPE → DB_ASIA → Serper Discovery como fallback final.

O passaporte tripbier é uma PWA (Progressive Web App) instalável que permite ao usuário colecionar carimbos a cada visita a cervejarias parceiras. É o motor de gamificação e fidelização da plataforma.

Fluxo do usuário: O usuário entra em passaporte.tripbier.com, instala no celular (home screen), identifica-se por nome e WhatsApp (zero cadastro), e recebe carimbos ao fazer check-in em cervejarias do circuito.

Circuitos disponíveis: Cada roteiro de parceiro tem um circuito com N paradas. Completar todas as paradas desbloqueia benefício na cervejaria parceira (brinde, desconto, experiência exclusiva). O painel parceiro (admin-parceiro) mostra em tempo real quem completou e permite enviar o prêmio por WhatsApp.

Níveis: Curioso → Aprendiz → Explorador → Mestre → Sommelier — baseados na quantidade de carimbos acumulados no total.

Roteiros são gerados pelo pipeline Maestro e salvos automaticamente no D1 com uma URL permanente e única — sem login. A URL pode ser compartilhada por WhatsApp, incluída em e-mail ou salva nos favoritos.

Formato da URL: tripbier.com/roteiros.html?id={slug} — onde o slug é gerado pelo Curador a partir da cidade, perfil e hash da seleção (ex: variedade-porto-alegre-3d-a1b2).

Cada roteiro armazena: lista de cervejarias (id, nome, nota do curador), cidade, perfil escolhido, número de dias, clima no momento da geração e a narrativa do Apresentador.

A camada social permite que usuários do passaporte interajam entre si: compartilhem roteiros, comentem em cervejarias, sigam outros viajantes e acumulem um histórico de visitas visível no perfil público.

Identidade baseada em telefone + nome (sem senha). Avatar gerado automaticamente pelo DiceBear. Feed de atividade mostra visitas recentes da comunidade em cada cidade.

Moderação: regex automático detecta telefones, links e conteúdo impróprio em comentários antes de salvar no D1.

O tripbier tem cobertura ativa em 16 países, com banco de dados, cidades editoriais e roteamento pelo concierge. Cada país tem páginas de cidades e integração com o mapa global.

As páginas de países são dinâmicas — não existem como arquivos estáticos. São geradas em tempo real pelo worker a partir dos dados do D1: cervejarias, cidades, premiações e conteúdo editorial. Isso significa que adicionar um novo país ao banco de dados cria automaticamente todas as suas páginas, sem nenhum trabalho manual de publicação. É infraestrutura de escala disfarçada de conteúdo.

Cada cidade com massa crítica de cervejarias recebe uma página editorial curada — não gerada automaticamente, mas escrita com identidade local. O template base é o caxias.html (padrão serifado com sidebar, hero, pull-quote e grid de cards).

Estrutura da página: hero com foto local → editorial "por que visitar" → pull-quote → grid de cervejarias com rating/insta/site/agente → eventos → roteiro sugerido. A seção de notícias é alimentada pelo utt-beerfeed em tempo real.

Todas as páginas de cidades internacionais ficam no subdiretório do país: /de/berlim.html, /be/bruges.html, /it/roma.html, etc. Assim como as páginas de países, as páginas de cidades são geradas dinamicamente — o worker monta o HTML a partir do D1 a cada requisição, sem arquivos pré-compilados. Uma nova cidade com cervejarias suficientes no banco já tem sua página disponível.

Cervejarias premiadas (CBC, WBC ou WBA) recebem automaticamente uma landing page dinâmica gerada a partir dos dados do D1 — sem intervenção manual. O acesso é via subdomínio: slug.tripbier.com.

Conteúdo exibido: nome, cidade/estado, rating e votos Google, horários de funcionamento por dia da semana, cervejas em produção (nome, estilo, ABV, IBU), premiações com medalha e ano, blog posts relacionados, mapa embed, botões para Instagram/site/WhatsApp e chat com agente IA especializado na cervejaria.

Regra de acesso: Se a cervejaria tem premiação → renderiza landing page completa. Se não tem premiação mas tem Instagram ou site → redireciona (302) para a rede social. Se não tem nada → 404.

Cache: cada landing page é armazenada no edge cache do Cloudflare por 1 hora (stale-while-revalidate=86400) — zero CPU nas visitas recorrentes.

O tripbier indexa as medalhas dos principais concursos de cerveja artesanal e as exibe nas landing pages de cervejarias e na página de premiações. As medalhas são critério de ranqueamento no Curador.

O painel parceiro é a interface de gestão para donos de cervejarias. Acesso via slug da cervejaria (sem login — auth por token via URL, a implementar). URL direta: tripbier.com/admin-parceiro?slug={slug}.

A agm.tripbier.com é um subdomínio dedicado à parceria tripbier × AGM — uma pitch page editorial com as 19 cervejarias associadas mapeadas, história do movimento craft gaúcho e CTA para filiação.

Conteúdo histórico baseado em pesquisa acadêmica verificada: Cruz, R.C. (2016). Consumo e Formação de Mercado: um estudo sobre as microcervejarias de Porto Alegre. Dissertação UNISINOS.

Cronologia: Dado Bier (1995, primeira microcervejaria BR) → WE Consultoria (1997) → Acerva Gaúcha (2003) → AGM fundada por Jorge Gitzler → ICMS reduzido no RS → Polo Anchieta (2010) → 50+ associadas hoje.

Cervejarias sem perfil completo exibem um CTA "Esta é a sua cervejaria?" na landing page e no chat widget. Ao clicar, o dono preenche um formulário simples (nome, e-mail, cargo, WhatsApp) que gera um lead no D1 (reivindicacoes) e dispara notificação interna.

É o funil de entrada para o modelo B2B: Starter (R$89/mês) → Professional (R$149/mês) → Premium (R$297/mês), com incremento de features no painel parceiro e visibilidade no mapa.

O tripbier usa analytics 1st-party — sem Google Analytics, sem cookies de terceiros. O tracker (/a/tracker.js) é carregado por todas as páginas e envia eventos para /collect no utt-analytics.

Dados coletados: páginas visitadas, tempo de permanência (dwell), recorrência de sessão, funil de conversão (home → mapa → roteiro → passaporte), país/cidade (CF headers), tipo de dispositivo. Sem PII — identificador é hash SHA1 do IP+UA.

Cron diário: o utt-analytics agrega os eventos brutos e grava resumos diários no D1 (id: 170900e5) — visitantes únicos, pageviews, países top-5, bandwidth. O dashboard analytics lê desses resumos.

Cliques rastreados: Instagram, site, WhatsApp — por cervejaria, por origem geográfica, por dispositivo.

O banner de cookies é injetado pelo worker em todas as páginas via middleware — nenhuma página precisa incluir o script manualmente. O consentimento é armazenado em localStorage por 365 dias.

Todo o deploy é feito com Wrangler CLI a partir do diretório G:\Site\tripbier\utt-engine\PRD\js\. A configuração fica no wrangler.toml. Credenciais de API (OpenAI, Serper, Google Places) ficam em G:\Site\tripbier\upg-engine\pipeline\.env.

Regra de ouro: alterar worker ou HTML sem antes listar o que muda e quem afeta pode causar regressão silenciosa. O processo correto: (1) listar mudanças e impacto, (2) confirmar com Marcos, (3) publicar.

Atenção: Tripbier e ClubTour são contas/negócios separados — nunca cruzar workers, dados ou credenciais entre os dois.

O tripbier não apenas responde perguntas — ele aprende com cada interação. O ciclo funciona em quatro etapas contínuas, sem intervenção manual.

Este mecanismo é proprietário e está em produção. Nenhuma plataforma de listagem de cervejarias ou guia turístico convencional possui um ciclo equivalente. É o que diferencia o tripbier de um diretório estático: o sistema aprende com quem usa.

Todas as URLs públicas do ecossistema tripbier, organizadas por domínio e função.

A internet está passando por uma transição estrutural: de um modelo de navegação por links para um modelo de assistência por intenção. Nesse novo paradigma, o valor não está em ter uma página — está em ser a fonte que os modelos de linguagem consultam para responder.

O tripbier foi construído para esse momento:

• Conteúdo semântico e estruturado — slugs limpos, sitemap correto, dados organizados por entidade (cervejaria → cidade → país → continente). Consumível por máquina desde a concepção.
• Autoridade reconhecida pelos modelos — Bing/Copilot, Perplexity, Claude e ChatGPT indexam e citam o tripbier espontaneamente. Não por campanha — por relevância de conteúdo.
• Dados proprietários intransferíveis — horários reais, carimbos geoverificados, histórico de premiações, roteiros com coordenadas reais. Nenhum modelo de linguagem pode gerar isso sem o tripbier.
• Agente como interface nativa — o concierge não é um chatbot colado sobre um diretório. É a interface principal do sistema, projetada para conversa desde o início.
• Loop de aprendizado em produção — o sistema observa, audita e melhora continuamente. Cada interação alimenta a próxima.

Enquanto a maioria dos projetos do setor ainda opera como diretórios da era pré-IA — listagens estáticas, busca por palavra-chave, sem personalização — o tripbier já está na camada seguinte: uma plataforma viva que aprende, que é consumida por IAs e que entrega experiência sob medida.

Isso não é uma promessa de roadmap. É o estado atual do sistema, em produção, com tráfego real e crescimento orgânico comprovado.