systeem-
handleiding

tripbier is een serverless platform voor de ontdekking van en routes langs ambachtelijke brouwerijen. Het combineert een georeferenced database met generatieve AI om gepersonaliseerde ervaringen te creëren — van de interactieve kaart tot de route die door een bierconciërge wordt verteld.

De volledige infrastructuur draait op Cloudflare (Workers + D1 + KV + R2), zonder eigen servers, met wereldwijde edge-latentie en variabele kosten per gebruik. Het datamodel is SQLite via D1, verdeeld over meerdere databases per continent.

Het systeem bestaat uit 6 onafhankelijke workers, elk met een specifieke verantwoordelijkheid, die via interne fetch communiceren of status delen via KV.

De radar (tripbier.com/mapa.html) is het hart van het platform — een Leaflet-kaart met 19.900+ pins van brouwerijen in 16 landen, met MarkerCluster voor prestaties en realtime filters.

Bij het openen gebruikt de kaart de browserlocatie of het IP-adres (Cloudflare cf.city) om automatisch te centreren. Elke pin opent een kaart met beoordeling, adres, link naar Instagram/website en een knop "toon route in Google Maps". Bekroonde brouwerijen krijgen een onderscheidend markering.

URL-parameters die door de kaart worden geaccepteerd:

De tripbier-conciërge is een pipeline van 6 mini-agenten die een tekstbericht omzet in een gepersonaliseerde bierroute. Elke agent ontvangt een data-envelop, verrijkt deze en geeft hem door aan de volgende.

De conciërge is multifunctioneel by design — geen chatbot met een keuzenu. De gebruiker schrijft in gewone taal en het systeem detecteert de intentie automatisch, zonder om een keuze te vragen:

De Validator detecteert de 4 modi zonder enige LLM-aanroep — pure JavaScript-logica. Normaliseert afkortingen (poa → Porto Alegre, cwb → Curitiba) vóór de Extractor. De Curator bevraagt databases in cascade: DB Brasil → DB_AMERICAS → DB_EUROPE → DB_ASIA → Serper Discovery als uiteindelijke fallback.

Het tripbier-paspoort is een installeerbare PWA (Progressive Web App) waarmee de gebruiker stempels kan verzamelen bij elk bezoek aan een partnersbrouwerij. Het is de gamificatie- en loyaliteitsmotor van het platform.

Gebruikersstroom: De gebruiker gaat naar passaporte.tripbier.com, installeert de app op het telefoonscherm, identificeert zich via naam en WhatsApp (zonder registratie) en ontvangt stempels bij check-in bij brouwerijen in het circuit.

Beschikbare circuits: Elke partnerroute heeft een circuit met N stops. Alle stops voltooien ontgrendelt een voordeel bij de partnerbrouwerij (gratis drankje, korting, exclusieve ervaring). Het partnerpanel (admin-parceiro) toont in realtime wie heeft voltooid en maakt het mogelijk de prijs via WhatsApp te versturen.

Niveaus: Nieuwsgierig → Leerling → Ontdekker → Meester → Sommelier — gebaseerd op het totale aantal verzamelde stempels.

Routes worden gegenereerd door de Maestro-pipeline en automatisch opgeslagen in D1 met een permanente, unieke URL — zonder inloggen. De URL kan via WhatsApp worden gedeeld, in e-mail worden opgenomen of als favoriet worden opgeslagen.

URL-formaat: tripbier.com/roteiros.html?id={slug} — waarbij de slug door de Curator wordt gegenereerd op basis van stad, profiel en hash van de selectie (bijv. variedade-porto-alegre-3d-a1b2).

Elke route slaat op: lijst van brouwerijen (id, naam, curatornotitie), stad, gekozen profiel, aantal dagen, weer op het moment van genereren en het verhaal van de Presentator.

De sociale laag stelt paspoortgebruikers in staat met elkaar te communiceren: routes delen, commentaar geven bij brouwerijen, andere reizigers volgen en een bezoekgeschiedenis opbouwen die zichtbaar is op het publieke profiel.

Identiteit gebaseerd op telefoonnummer + naam (zonder wachtwoord). Avatar automatisch gegenereerd door DiceBear. De activiteitsfeed toont recente bezoeken van de gemeenschap in elke stad.

Moderatie: een automatische regex detecteert telefoonnummers, links en ongepaste inhoud in reacties vóór opslag in D1.

tripbier heeft actieve dekking in 16 landen, met database, redactionele steden en routing via de conciërge. Elk land heeft stadspagina's en integratie met de wereldkaart.

De landenpagina's zijn dynamisch — ze bestaan niet als statische bestanden. Ze worden in realtime door de worker gegenereerd op basis van D1-gegevens: brouwerijen, steden, prijzen en redactionele content. Dit betekent dat het toevoegen van een nieuw land aan de database automatisch alle bijbehorende pagina's aanmaakt, zonder handmatig publicatiewerk. Het is schaalbare infrastructuur vermomd als content.

Elke stad met een kritische massa brouwerijen krijgt een samengestelde redactionele pagina — niet automatisch gegenereerd, maar geschreven met een lokale identiteit. Het basistemplate is caxias.html (serifpatroon met zijbalk, hero, pull-quote en kaartgrid).

Paginastructuur: hero met lokale foto → redactioneel "waarom bezoeken" → pull-quote → brouwerijgrid met beoordeling/insta/site/agent → evenementen → voorgestelde route. De nieuwssectie wordt in realtime gevoed door utt-beerfeed.

Alle internationale stadspagina's bevinden zich in de landsubmap: /de/berlim.html, /be/bruges.html, /it/roma.html, enzovoort. Net als de landenpagina's worden stadspagina's dynamisch gegenereerd — de worker assembleert de HTML vanuit D1 bij elk verzoek, zonder vooraf gecompileerde bestanden. Een nieuwe stad met voldoende brouwerijen in de database heeft direct zijn pagina beschikbaar.

Bekroonde brouwerijen (CBC, WBC of WBA) krijgen automatisch een dynamische landingspagina gegenereerd op basis van D1-gegevens — zonder handmatige tussenkomst. Toegang via subdomein: slug.tripbier.com.

Weergegeven inhoud: naam, stad/staat, Google-beoordeling en stemmen, openingstijden per dag van de week, bieren in productie (naam, stijl, ABV, IBU), prijzen met medaille en jaar, gerelateerde blogposts, kaartweergave, knoppen voor Instagram/website/WhatsApp en chat met een AI-agent gespecialiseerd in de brouwerij.

Toegangsregel: Als de brouwerij een prijs heeft → volledige landingspagina renderen. Als er geen prijs is maar wel Instagram of website → doorverwijzen (302) naar het sociale netwerk. Als er niets is → 404.

Cache: elke landingspagina wordt 1 uur opgeslagen in de Cloudflare edge cache (stale-while-revalidate=86400) — geen CPU-gebruik bij terugkerende bezoeken.

tripbier indexeert de medailles van de belangrijkste ambachtelijke bierwedstrijden en toont deze op de landingspagina's van brouwerijen en op de prijzenpagina. Medailles zijn een rangschikkingscriterium in de Curator.

Het partnerpanel is de beheerinterface voor eigenaren van brouwerijen. Toegang via de brouwerij-slug (zonder inloggen — auth via token in URL, nog te implementeren). Directe URL: tripbier.com/admin-parceiro?slug={slug}.

agm.tripbier.com is een subdomein gewijd aan het partnerschap tripbier × AGM — een redactionele pitch-pagina met de 19 aangesloten brouwerijen in kaart, de geschiedenis van de gaúcho craft-beweging en een CTA voor lidmaatschap.

Historische inhoud gebaseerd op geverifieerd academisch onderzoek: Cruz, R.C. (2016). Consumo e Formação de Mercado: um estudo sobre as microcervejarias de Porto Alegre. Dissertação UNISINOS.

Tijdlijn: Dado Bier (1995, eerste micro-brouwerij BR) → WE Consultoria (1997) → Acerva Gaúcha (2003) → AGM opgericht door Jorge Gitzler → verlaagd ICMS in RS → Polo Anchieta (2010) → 50+ aangesloten vandaag.

Brouwerijen zonder volledig profiel tonen een CTA "Is dit uw brouwerij?" op de landingspagina en in de chat-widget. Na het klikken vult de eigenaar een eenvoudig formulier in (naam, e-mail, functie, WhatsApp) dat een lead aanmaakt in D1 (reivindicacoes) en een interne melding stuurt.

Dit is de instapfunnel voor het B2B-model: Starter (R$89/maand) → Professional (R$149/maand) → Premium (R$297/maand), met extra functies in het partnerpanel en meer zichtbaarheid op de kaart.

tripbier gebruikt 1st-party analytics — zonder Google Analytics, zonder cookies van derden. De tracker (/a/tracker.js) wordt geladen door alle pagina's en stuurt events naar /collect in utt-analytics.

Verzamelde gegevens: bezochte pagina's, verblijfsduur (dwell), sessierecurrentie, conversiefunnel (home → kaart → route → paspoort), land/stad (CF headers), apparaattype. Geen PII — de identificator is een SHA1-hash van IP+UA.

Dagelijkse cron: utt-analytics aggregeert de ruwe events en schrijft dagelijkse samenvattingen weg in D1 (id: 170900e5) — unieke bezoekers, pageviews, top-5 landen, bandbreedte. Het analytics-dashboard leest uit deze samenvattingen.

Bijgehouden klikken: Instagram, website, WhatsApp — per brouwerij, per geografische herkomst, per apparaat.

De cookiebanner wordt door de worker via middleware op alle pagina's geïnjecteerd — geen enkele pagina hoeft het script handmatig op te nemen. De toestemming wordt 365 dagen opgeslagen in localStorage.

Alle deploys worden uitgevoerd met de Wrangler CLI vanuit de map G:\Site\tripbier\utt-engine\PRD\js\. De configuratie staat in wrangler.toml. API-sleutels (OpenAI, Serper, Google Places) staan in G:\Site\tripbier\upg-engine\pipeline\.env.

Gouden regel: een worker of HTML aanpassen zonder eerst te vermelden wat er wijzigt en wie erdoor wordt geraakt, kan leiden tot stille regressie. Het juiste proces: (1) wijzigingen en impact vermelden, (2) bevestigen met Marcos, (3) publiceren.

Let op: Tripbier en ClubTour zijn afzonderlijke accounts/bedrijven — nooit workers, gegevens of inloggegevens tussen beide mengen.