Architectuurbesluiten
Belangrijke technische keuzes worden vastgelegd als architecture decision record — een kort document per besluit. Er zijn er op dit moment negenendertig; één daarvan is inmiddels vervangen door een later besluit.
Het sjabloon
Elk besluit volgt dezelfde opbouw:
- Context — welk probleem lag er, en waarom nu?
- Besluit — wat is gekozen?
- Alternatieven — wat is overwogen en waarom afgevallen?
- Nadelen — wat kost deze keuze ons?
- Wanneer heroverwegen — welke omstandigheid maakt dit besluit achterhaald?
Punten 3 tot 5 zijn het waardevolst. Een besluit zonder opgeschreven nadelen is meestal geen besluit maar een voorkeur, en zonder herzieningscriterium blijft een keuze hangen lang nadat de aanleiding is verdwenen.
Een besluit geldt pas als vastgesteld wanneer er werkend bewijs is — niet wanneer het document af is.
Besluiten die het platform vormgeven
| Onderwerp | Kern van het besluit |
|---|---|
| Configureerbare prompts | Prompts staan in configuratie, met een variant per tenant — niet in code |
| AI-gateway | Alle generatie via één serverside toegangspunt, met promptresolutie, modelkeuze en bewaking |
| Zoekfundament | Herbouw van het ophalen van bewijs: opknippen, betekenisindex en een begrensde selectie |
| Bewijsketen | Verwijzingen worden serverside gecontroleerd tegen wat het model daadwerkelijk kreeg |
| Onderbouwde synthese | Ook de zware analyses krijgen dossierbewijs mee, niet alleen simpele extracties |
| Tenantmodel | Datamodel en rechtenmatrix voor meerdere organisaties op één platform |
| Latency en time-outs | Streamen, achtergrondtaken en modelkeuze per taakzwaarte |
| Rapportage-engine | Blokgebaseerd documentmodel, uitsluitend additief op bestaande werkbladen |
| Vermogensmodel | De verbindende laag tussen strategie en veranderportfolio |
| Uitleverstraat | Staging-eerst, met geautomatiseerde poorten voor migraties en schemagelijkheid |
| Teststrategie | Welke test welk risico afdekt, en wanneer een test verplicht wordt |
| Beveiligingspoort | Auditlogboek, back-ups en een aantoonbaar geteste herstelprocedure |
| Bewijs op de rij | Het bewijs achter een gegenereerde tekst wordt opgeslagen bij de tekst zelf, niet in een apart logboek |
| Herkomstmodel | Elke AI-generatie draagt haar herkomst: bron, aard, bronnen, redeneerstap en of een mens eraan heeft geschreven; de server beslist of er materiaal was, niet het model |
| Anon-oppervlak | Wie niet is ingelogd leest niets, behalve wat uitdrukkelijk en gemotiveerd is vrijgegeven |
| Rapportmodel | Vier documenten per werkblad — weergave, samenvatting, bevindingen en One-pager — waarbij de samenvatting niet uit de bevindingen put en een rapport een momentopname is |
| Herkomst bij accepteren | Het herkomstteken verdwijnt zodra een mens het voorstel accepteert; genereren op algemene kennis mag overal |
| Risicomodel | De goedkeurknop van de consultant is de controle; zware waarborgen horen alleen op de grens naar de klant |
| Tijdregels voor generaties | Een afgebroken generatie geldt als mislukt, er volgt geen tweede volle poging, en het plafond volgt uit de tijdband |
| Processen en organisatie | Keten, proces en handeling hebben elk één betekenis; een proces heeft een afdeling als eigenaar, KPI's hebben één vorm, en een issue gaat over een proces, een overdracht of een keten |
| Samenwerkingsmodel | Deelnemers per canvas met een rol, één account in meerdere organisaties, en overdracht van bureau naar klant in één bewaakte stap; de beheerder van een organisatie beheert wie erbij mag en leest niet vanzelf mee |
| Bouwketen | De webapplicatie wordt gebouwd en ontwikkeld met Vite (versie 7), met een vaste bouwomgeving en een testreeks zonder zware bouwlaag erboven |
| Waardeteams | Een waardeteam voert roadmapopgaven uit en kan over meerdere ketens werken, met per initiatief een expliciete afspraak |
| Tweede factor | Inloggen met een authenticator-app: per organisatie in te schakelen voor beheerders, en af te dwingen voor alle gebruikers |
| Staging-topologie | Een aparte testomgeving met eigen database en eigen adres, naast productie |
| AI-modellen per week | Een nieuw model komt op de lijst, wordt op een proefset vergeleken en vervangt het oude per klasse of per AI-knop, met terugval |
| AI-laag als geheel | Wat de aanroep doet, waarmee en waarlangs: modelkeuze, projectcontext en de route met regio-instelling (wereldwijd of EU), plus twee poorten vóór de aanroep: schrijfrol en budget |
| IT-werkblad | Zes tabbladen, informatiedomeinen en één landschapstabel; wat het platform afleidt staat als voorstel en telt pas mee na bevestiging |
| Fundamenten | Isolatie per organisatie in de databank, alle tekst en AI-opdrachten in de databank, en geen eigen methode of branche in het platform |
| Eén basis voor het schema | Het schema is één basisbestand plus de migraties erna; de oudere migraties zijn archief |
Toegang tot de volledige besluiten
De uitgeschreven besluitdocumenten bevatten implementatiedetails en interne afwegingen en zijn daarom niet publiek. Ze zijn beschikbaar voor technische partners onder geheimhouding.