Week W38 · 14-20 september 2026
Build AI. Run AI. Own AI.
Ik bouw dit niet in een lab, maar middenin mijn eigen leven als zzp'er en vader — en toch ontwerp ik elke keuze alsof er een enterprise-klant op leunt: multi-tenant vanaf dag 1, secrets die nooit een mens ziet, migraties die nooit terug kunnen. Dit is het logboek van die combinatie: zelf bouwen, zelf draaiend houden, zelf eigenaar blijven — inclusief de aanname, de misser en de prijs van elke keuze.
Nu mijn eigen productieomgeving op de nieuwe architectuur draait, zie ik pas goed waar optimistische aannames in het dagelijks gebruik beginnen te wringen. Deze week liep ik op twee verschillende plekken tegen precies dezelfde denkfout aan: het systeem nam te snel genoegen met een oppervlakkig "het lijkt gelukt". De eerste plek zat in het herkennen van personen in mijn notities; de tweede zat bij de allereerste voordeur waar nieuwe notities binnenkomen.
Het probleem dat opdook
In een drukke werkweek schrijf ik in mijn notities zelden volledige voor- en achternamen. Ik dicteer of typ: "Goed gesprek gehad met Sander over de planning voor Q4." Zolang ik maar één Sander ken, is er niets aan de hand. Maar in een echt zakelijk netwerk zitten al snel drie verschillende mensen met dezelfde voornaam bij verschillende opdrachtgevers.
De bestaande contactkoppeling in mijn notitiestraat (`PA - 03 - Create Contact` en de bijbehorende zoekfunctie) stond voor een ongemakkelijk dilemma: of hij pakte te gretig de eerstgevonden Sander uit de database (waardoor een vertrouwelijke notitie stilletjes aan de verkeerde persoon werd gehangen), of hij maakte bij elke kleine variatie een nieuw schaduwcontact aan.
Diezelfde week ontdekte ik bij het aanscherpen van de n8n-intake (`PA - 00 - Single Note`) een tweede vorm van vals optimisme: de webhook-poort gaf al een groene bevestiging terug zodra het verzoek door de poortwachter was aangenomen, nog vóórdat subworkflow `PA - 01 - Save Input` daadwerkelijk een rij in de database had vastgelegd. Als er tussen `00` en `01` iets misging, dacht de afzender dat de notitie veilig binnen was, terwijl er in werkelijkheid niets in `pa_inputs` stond.
De makkelijke weg die ik had kunnen nemen
Voor de contacten had ik simpelweg de meest recent gebruikte persoon met die voornaam kunnen kiezen en hopen dat dat in tachtig procent van de gevallen klopt. En voor de webhook-intake had ik kunnen vertrouwen op het feit dat de lokale overdracht tussen twee workflows bijna altijd slaagt. Maar in een persoonlijke assistent zijn een verkeerd gekoppeld dossier en een stilletjes verdwenen notitie precies de twee fouten waardoor je het vertrouwen in je eigen systeem verliest.
De keuze die ik maakte en de strategie erachter
Ik verving op beide plekken het optimistische raden door expliciete verificatie:
- Slimme contactresolutie die ambiguïteit erkent (`find-or-create`). Bij het koppelen van personen zoekt het platform nu gelaagd binnen de eigen workspace: eerst op exacte naam of bekend alias, en daarna op voornaam. Is er precies één treffer, dan wordt het bestaande contact gekoppeld. Zijn er meerdere treffers op dezelfde voornaam en geeft de context geen uitsluitsel, dan gokt het systeem níét en maakt het ook geen blinde kloon aan: het laat de ambiguïteit zichtbaar zodat ik of de assistent de juiste persoon kan aanwijzen.
- Een tweetraps ontvangstbewijs met een echte `input_id`. Ik bouwde de overdracht tussen `PA - 00 - Single Note` en `PA - 01 - Save Input` om naar een strikte tweetraps-handshake. `PA - 01` geeft voortaan expliciet de aangemaakte database-sleutel (`input_id`) terug aan `PA - 00`, en een inname telt pas als geslaagd wanneer er een positieve `input_id` is bevestigd.
- Harde validatie van de actieve workflowset. Om te voorkomen dat een omgeving per ongeluk met een half-geactiveerde workflowset draait, legde ik op 15 september in `canonical-active-set.txt` vast welke twintig workflows verplicht actief moeten zijn en liet ik de import-tooling daar automatisch op controleren.
Wat het kostte
Het doorvoeren van de tweetraps-handshake betekende dat zowel de n8n-workflows (`00` en `01`) als de aanroepende code en tests in dezelfde beweging moesten overstappen van "HTTP 200 is genoeg" naar "controleer op een geldige `input_id`". En bij de contactresolutie moest ik de verleiding weerstaan om allerlei slimme maar breekbare heuristieken te verzinnen: soms is "ik weet niet welke van deze twee Sanders je bedoelt" het enige eerlijke antwoord.
Wat het nu oplevert en wat ik ervan leerde
Mijn contactendossier vervuilt niet langer met dubbele kaartjes of fout gekoppelde gespreksnotities, en elke ingestuurde notitie heeft nu een keihard database-bewijs voordat de voordeur "ontvangen" terugmeldt.
De rode draad van deze week: een betrouwbaar systeem herken je niet aan hoe vaak het 'ja' zegt, maar aan het feit dat het weigert te gokken wanneer het bewijs nog ontbreekt. Die eis werd een week later nog veel belangrijker, toen ik besloot om mijn kennisgraaf voor het eerst open te stellen voor bezoekers van buitenaf.