manuel
du système

tripbier est une plateforme serverless de découverte et d'itinéraires de brasseries artisanales. Elle combine une base de données géoréférencée avec une IA générative pour créer des expériences personnalisées — de la carte interactive à l'itinéraire narré par un concierge brassicole.

Toute l'infrastructure tourne sur Cloudflare (Workers + D1 + KV + R2), sans serveurs propres, avec une latence mondiale de périphérie et un coût variable à l'usage. Le modèle de données est SQLite via D1, réparti sur plusieurs bases par continent.

Le système est composé de 6 workers indépendants, chacun ayant une responsabilité spécifique, communiquant via fetch interne ou partageant l'état par le KV.

Le radar (tripbier.com/mapa.html) est le cœur de la plateforme — une carte Leaflet avec 19 900+ épingles de brasseries dans 16 pays, avec MarkerCluster pour les performances et des filtres en temps réel.

À l'ouverture, la carte utilise la géolocalisation du navigateur ou l'IP (Cloudflare cf.city) pour se centrer automatiquement. Chaque épingle ouvre une fiche avec note, adresse, lien vers Instagram/site et bouton « voir l'itinéraire sur Google Maps ». Les brasseries primées reçoivent un marqueur différencié.

Paramètres d'URL acceptés par la carte :

Le concierge tripbier est un pipeline de 6 mini-agents qui transforme un message texte en itinéraire brassicole personnalisé. Chaque agent reçoit une enveloppe de données, l'enrichit et la passe au suivant.

Le concierge est multifonction par conception — ce n'est pas un chatbot avec menu d'options. L'utilisateur écrit en langage naturel et le système détecte l'intention automatiquement, sans demander de choix de mode :

Le Validateur détecte les 4 modes sans aucun appel LLM — logique pure en JavaScript. Il normalise les sigles (poa → Porto Alegre, cwb → Curitiba) avant l'Extracteur. Le Curateur consulte les bases en cascade : DB Brasil → DB_AMERICAS → DB_EUROPE → DB_ASIA → Serper Discovery comme fallback final.

Le passeport tripbier est une PWA (Progressive Web App) installable qui permet à l'utilisateur de collectionner des tampons à chaque visite dans des brasseries partenaires. C'est le moteur de gamification et de fidélisation de la plateforme.

Parcours utilisateur : L'utilisateur accède à passaporte.tripbier.com, installe l'app sur son téléphone (écran d'accueil), s'identifie par nom et WhatsApp (sans inscription), et reçoit des tampons lors du check-in dans les brasseries du circuit.

Circuits disponibles : Chaque itinéraire partenaire dispose d'un circuit avec N étapes. Compléter toutes les étapes débloque un avantage dans la brasserie partenaire (cadeau, réduction, expérience exclusive). L'espace partenaire (admin-parceiro) affiche en temps réel qui a complété le circuit et permet d'envoyer la récompense par WhatsApp.

Niveaux : Curieux → Apprenti → Explorateur → Maître → Sommelier — basés sur le nombre total de tampons accumulés.

Les itinéraires sont générés par le pipeline Maestro et sauvegardés automatiquement dans le D1 avec une URL permanente et unique — sans connexion. L'URL peut être partagée par WhatsApp, incluse dans un e-mail ou mise en favoris.

Format de l'URL : tripbier.com/roteiros.html?id={slug} — où le slug est généré par le Curateur à partir de la ville, du profil et du hash de la sélection (ex : variedade-porto-alegre-3d-a1b2).

Chaque itinéraire stocke : liste de brasseries (id, nom, note du curateur), ville, profil choisi, nombre de jours, météo au moment de la génération et le récit du Présentateur.

La couche sociale permet aux utilisateurs du passeport d'interagir entre eux : partager des itinéraires, commenter sur des brasseries, suivre d'autres voyageurs et accumuler un historique de visites visible sur le profil public.

Identité basée sur téléphone + nom (sans mot de passe). Avatar généré automatiquement par DiceBear. Le fil d'activité affiche les visites récentes de la communauté dans chaque ville.

Modération : un regex automatique détecte numéros de téléphone, liens et contenu inapproprié dans les commentaires avant de les sauvegarder dans le D1.

tripbier dispose d'une couverture active dans 16 pays, avec base de données, villes éditoriales et routage par le concierge. Chaque pays dispose de pages de villes et d'une intégration avec la carte mondiale.

Les pages de pays sont dynamiques — elles n'existent pas comme fichiers statiques. Elles sont générées en temps réel par le worker à partir des données du D1 : brasseries, villes, distinctions et contenu éditorial. Cela signifie qu'ajouter un nouveau pays à la base de données crée automatiquement toutes ses pages, sans aucun travail manuel de publication. C'est une infrastructure à l'échelle déguisée en contenu.

Chaque ville avec une masse critique de brasseries reçoit une page éditoriale curée — non générée automatiquement, mais rédigée avec une identité locale. Le template de base est le caxias.html (standard sériffé avec sidebar, hero, pull-quote et grille de cards).

Structure de la page : hero avec photo locale → éditorial « pourquoi visiter » → pull-quote → grille de brasseries avec note/insta/site/agent → événements → itinéraire suggéré. La section actualités est alimentée par utt-beerfeed en temps réel.

Toutes les pages de villes internationales se trouvent dans le sous-répertoire du pays : /de/berlim.html, /be/bruges.html, /it/roma.html, etc. Comme les pages de pays, les pages de villes sont générées dynamiquement — le worker construit le HTML à partir du D1 à chaque requête, sans fichiers pré-compilés. Une nouvelle ville avec suffisamment de brasseries dans la base dispose déjà de sa page.

Les brasseries primées (CBC, WBC ou WBA) reçoivent automatiquement une landing page dynamique générée à partir des données du D1 — sans intervention manuelle. L'accès se fait via sous-domaine : slug.tripbier.com.

Contenu affiché : nom, ville/état, note et votes Google, horaires d'ouverture par jour de la semaine, bières en production (nom, style, ABV, IBU), distinctions avec médaille et année, articles de blog associés, carte intégrée, boutons vers Instagram/site/WhatsApp et chat avec agent IA spécialisé dans la brasserie.

Règle d'accès : Si la brasserie a une distinction → affiche la landing page complète. Si elle n'a pas de distinction mais a Instagram ou site → redirige (302) vers le réseau social. Si elle n'a rien → 404.

Cache : chaque landing page est stockée dans le cache de périphérie Cloudflare pendant 1 heure (stale-while-revalidate=86400) — zéro CPU lors des visites récurrentes.

tripbier indexe les médailles des principaux concours de bière artisanale et les affiche sur les landing pages de brasseries et la page des récompenses. Les médailles sont un critère de classement dans le Curateur.

L'espace partenaire est l'interface de gestion pour les propriétaires de brasseries. Accès via le slug de la brasserie (sans connexion — auth par token via URL, à implémenter). URL directe : tripbier.com/admin-parceiro?slug={slug}.

Le agm.tripbier.com est un sous-domaine dédié au partenariat tripbier × AGM — une pitch page éditoriale avec les 19 brasseries associées cartographiées, l'histoire du mouvement craft gaúcho et un CTA pour l'adhésion.

Contenu historique basé sur une recherche académique vérifiée : Cruz, R.C. (2016). Consumo e Formação de Mercado: um estudo sobre as microcervejarias de Porto Alegre. Dissertação UNISINOS.

Chronologie : Dado Bier (1995, première microbrasserie BR) → WE Consultoria (1997) → Acerva Gaúcha (2003) → AGM fondée par Jorge Gitzler → réduction ICMS au RS → Pôle Anchieta (2010) → 50+ adhérents aujourd'hui.

Les brasseries sans profil complet affichent un CTA « C'est votre brasserie ? » sur la landing page et dans le chat widget. En cliquant, le propriétaire remplit un formulaire simple (nom, e-mail, poste, WhatsApp) qui génère un lead dans le D1 (reivindicacoes) et déclenche une notification interne.

C'est l'entonnoir d'entrée pour le modèle B2B : Starter (R$89/mois) → Professional (R$149/mois) → Premium (R$297/mois), avec une montée en puissance des fonctionnalités dans l'espace partenaire et de la visibilité sur la carte.

tripbier utilise des analytics 1st-party — sans Google Analytics, sans cookies tiers. Le tracker (/a/tracker.js) est chargé par toutes les pages et envoie des événements à /collect dans utt-analytics.

Données collectées : pages visitées, temps de présence (dwell), récurrence de session, funnel de conversion (accueil → carte → itinéraire → passeport), pays/ville (en-têtes CF), type d'appareil. Sans PII — l'identifiant est un hash SHA1 de l'IP+UA.

Cron quotidien : utt-analytics agrège les événements bruts et enregistre des résumés quotidiens dans le D1 (id : 170900e5) — visiteurs uniques, pageviews, top-5 pays, bandwidth. Le tableau de bord analytics lit ces résumés.

Clics tracés : Instagram, site, WhatsApp — par brasserie, par origine géographique, par appareil.

La bannière de cookies est injectée par le worker sur toutes les pages via middleware — aucune page n'a besoin d'inclure le script manuellement. Le consentement est stocké dans localStorage pendant 365 jours.

Tout le déploiement s'effectue avec Wrangler CLI depuis le répertoire G:\Site\tripbier\utt-engine\PRD\js\. La configuration se trouve dans le wrangler.toml. Les identifiants API (OpenAI, Serper, Google Places) se trouvent dans G:\Site\tripbier\upg-engine\pipeline\.env.

Règle d'or : modifier un worker ou un HTML sans avoir d'abord listé ce qui change et qui est impacté peut provoquer une régression silencieuse. Le processus correct : (1) lister les modifications et leur impact, (2) confirmer avec Marcos, (3) publier.

Attention : Tripbier et ClubTour sont des comptes/entreprises séparés — ne jamais croiser les workers, les données ou les identifiants entre les deux.