Maker-case · tool
Een maker-case over een kleine assistent die losse tekst omzet naar een gecontroleerde offerte- of factuurflow.
Daarom laat ik AI alleen de vrije tekst interpreteren en houd ik de kritieke logica in code. Zo ontstaat een kleine assistent die van losse input naar draft, preview en uiteindelijk een nette PDF werkt, zonder dat de kernberekeningen gaan zweven.
Hoofdflow: van chat tot downloadbare factuur
Start gesprek, parse, confirm, PDF downloaden.
Idee & motivatie
Ik vond het interessant om te kijken of je van rommelige, vrije tekst toch een gecontroleerde flow kunt maken voor iets dat normaal snel foutgevoelig wordt. Facturen en offertes zijn daarvoor een goed testgebied: de invoer is vaak ongestructureerd, maar de uitkomst moet wel kloppen.
De kernvraag voor mij was niet hoe slim ik AI kon maken, maar hoe ik AI kon inzetten zonder de betrouwbaarheid uit handen te geven. Daarom leest de AI alleen de tekst, terwijl totalen, btw en nummering in TypeScript blijven.
Grenzen & uitgangspunten
Flow
Hier zit voor mij de UX-kern van het project: de flow moet niet magisch, maar begrijpelijk aanvoelen. Daarom vraagt de assistent eerst wat nog ontbreekt, laat daarna een concept zien en pas dan komt de PDF in beeld.
Opbouw
Na de interactie wordt pas zichtbaar hoe simpel de kern eigenlijk is: eerst invoer normaliseren, daarna velden laten interpreteren, vervolgens de berekening in code doen en pas op het einde de branded PDF genereren.
Technische keuzes
Dit gaat minder over losse tools en meer over waarom ik bepaalde onderdelen nodig vond om de flow stabiel en geloofwaardig te houden.
Velden controleren en bedragen/btw in code uitrekenen.
Zet je bericht om naar velden; rekent niet zelf.
API-sleutel, limiet op verzoeken en altijd eerst een voorbeeld tonen.
Instellingen, factuurnummers en PDF-verwijzingen bewaren.
Logo, kleuren en nette opmaak zonder design-handoff.
Belangrijke keuzes
Dit zijn de principes waar ik tijdens het bouwen steeds op terugkwam: niet meer features, maar keuzes die de flow logisch en betrouwbaar houden.
Btw, nummering en afronding gebeuren in de code. AI leest alleen de tekst uit je bericht.
AI zet je bericht om naar velden; ontbrekende info wordt gevraagd in plaats van gegokt.
PDF krijgt je logo en kleuren; je ziet een voorbeeld voor je ‘download’ zegt.
Berichten worden herkend, zodat er geen dubbel werk of dubbele PDF ontstaat.
Kleine modules, snelle responstijd en tests om regressies te voorkomen.
Resultaat & mijn rol
Ik heb dit project van idee tot werkende flow uitgewerkt: van de interactie en promptlogica tot de rekenlaag, PDF-branding en technische checks die de output betrouwbaar houden.
Wat ik hiervan leer
Verder in het portfolio
Deze pagina moet onderdeel voelen van een geheel. Daarom kun je vanaf hier direct door naar de volgende maker-case of terug naar het volledige overzicht.