NL
Taal · dezelfde pagina NLNederlands/portaal/ ENEnglish (UK)nog niet vertaald ESEspañolnog niet vertaald We onthouden je keuze niet en sturen je nooit automatisch door.
CRM-LAAG · INTERN · DOC.P0

De laag achter de site, waar alleen AI in werkt

theseo.nl is de voorkant. Daarachter draait een systeem waarin leads binnenkomen, gesprekken worden voorbereid en klanten worden bediend. Daar werken geen medewerkers in, maar AI-sessies. Deze pagina legt uit hoe dat is ingedeeld, wie waar aan mag komen en waarom dat op drie plekken staat in plaats van op een.

FIG.01 · de trechter drie fasen, drie bronnen, een richting
FASE 01 · koud

Lead

brain.leads

Een bedrijf dat een klant kan worden. Hier gebeurt het zoeken, het benaderen en het opvolgen. Veel volume, veel afvallers, en per lead een spoor van wat er is gedaan.

Nugget en Max
preview of gesprek
FASE 02 · warm

Presales

brain.maxime_presales

Er ligt een gesprek, een voorbeeldpagina of een voorstel. Weinig volume, veel aandacht per bedrijf. Dit is de fase waar de verkoop wordt gewonnen of verloren.

presales-sessie
getekend
FASE 03 · betalend

Klant

brain.klanten

Een dossier per klant: welke diensten lopen, wat er is gedaan, welke punten open staan en wat er gefactureerd wordt. Dit stopt niet, dit loopt door.

klant-sessie en facturatie

Per fase is er precies een bron. Nooit een tweede lijst, ook niet tijdelijk, ook niet als exportje. Dat is de eerste regel van de grondwet, en hij bestaat omdat er ooit twee halve systemen naast elkaar draaiden waarvan geen van beide compleet was.

HET PROBLEEM DAT DIT OPLOST

Dertien tabbladen zijn geen overzicht

De vorige opzet was een enkel scherm met dertien tabbladen: vandaag, taken, pipeline, brein, acties, stroom, gedaan, systeem, presales, klanten, websites, netwerk en controle. Alles zat erin en dat was precies het probleem. Wie de leadstroom wilde bewaken kreeg het klantdossier erbij, wie een gesprek voorbereidde kreeg de systeemgezondheid erbij, en niemand zag in een oogopslag waar het werk lag.

Erger was wat er onder zat: hetzelfde bestand stond op twee adressen. Klanten en leads waren geen twee ingangen naar een systeem, het was een keer dezelfde applicatie op twee plekken. En de presales-fase, waar het geld wordt gewonnen, had helemaal geen eigen plek.

De herbouw splitst langs de trechter die al in de data zat. Drie gezichten, elk met een eigen vraag. Het leadportaal vraagt: wie moeten we benaderen en wat is er al geprobeerd. Het presalesportaal vraagt: welk gesprek staat er en wat ligt er klaar. Het klantportaal vraagt: hoe staat deze klant ervoor en wat is er voor hem gedaan. De poweruserlaag met systeemgezondheid en netwerk blijft bestaan, maar wordt niet op alle drie herhaald.

FIG.02 · de regelslaag van wat mag naar wat landt
De grondwetCRM-GRONDWET.md

Wat mag en wat niet. Een bron per entiteit, lees eerst en schrijf daarna terug, wie wat mag per portaal, hoe je je meldt, en de zeven dingen die een sessie nooit doet. Dit is het langzame document: het verandert zelden en het wint van al het andere.

De werkinstructieCRM-WERKINSTRUCTIE.md

Wat je precies intikt. Per handeling een recept met dezelfde zeven kopjes: wanneer, wat je eerst leest, waarop je stopt, wat je schrijft, welke velden verplicht zijn, hoe je je meldt en welke fout hier het vaakst wordt gemaakt. Geschreven voor een AI, niet voor een mens.

De keuringscripts/crm-check.py

Of het is nageleefd. Zeven regels, een oordeel per regel, een exitcode. Meldde elke sessie zich aan, bleef iedereen binnen zijn eigen spoor, heeft elke afzender een naam, heeft elke opdracht een eigenaar, draagt elke lead een herkomst. Een grondwet zonder toets is een advies.

De dataschema brain

Waar het landt. De leadtabel, het presalesvoorportaal, het klantdossier, en daarnaast de laag waarin de sessies elkaar bijhouden: een gedeeld geheugen, een berichtenbus, een opdrachtenlijst en een logboek. Die laag draaide al voor de herbouw begon en blijft precies zoals hij is.

De eerste drie staan in de repo van de site en gaan niet mee naar de webserver. Ze zijn er voor de sessies die de code lezen, niet voor bezoekers. Deze uitleg is voor mensen.

DE ROLLEN

Wie er werkt, en waar hij vanaf blijft

De scheiding is hard. Niet omdat het technisch niet anders kan, maar omdat twee sessies die in dezelfde rij schrijven elkaars werk stilletjes overschrijven, en de volgende sessie dan niet kan zien of dat expres was.

NuggetZoekt en benadert leads in het ene spoor.Raakt nooit: de leads van Max
MaxZoekt en benadert leads in het andere spoor.Raakt nooit: de leads van Nugget
Presales-sessieBereidt gesprekken, voorbeeldpagina's en voorstellen voor.Raakt nooit: het klantdossier en de outreachvelden
Klant-sessieHoudt het dossier bij: diensten, tijdlijn, open punten.Raakt nooit: de leadvelden
FacturatieMaakt facturen klaar en leest wat de klant afneemt.Raakt nooit: de leadvelden, en nooit de eerste factuur zonder akkoord
Site-sessieBouwt en keurt theseo.nl, leest de architectuurdocumenten.Raakt nooit: alles wat een lead of een klant is

Er is een uitzondering die geen sessie mag nemen en die daarom bij Gianluca ligt: de eerste factuur per klant. Alles eromheen loopt vanzelf, maar die ene gaat eerst langs een mens. Dat is geen technische beperking, dat is een afspraak uit juni 2026 die bewust is blijven staan.

FIG.03 · vier sloten

Wat er dicht zit voordat dit live mag

Deze pagina's tonen de vorm en de uitleg. Ze tonen geen gegevens, en dat is geen tussenoplossing maar een besluit: er zit een beveiligingsingreep tussen, en die legt de draaiende machine tijdelijk stil. Vier dingen moeten open voordat er een enkel echt gegeven op een portaal verschijnt.

dicht Toegangslaag

Vandaag is de enige grens dat het adres niet in Google staat. Wie het kent, komt binnen. Er moet een echte toegangscontrole voor, per persoon of met een gedeelde sleutel.

besluit bij Gianluca
dicht Schrijven via een worker

Elke schrijfactie hoort te lopen via een server met een sleutel die alleen daar staat. Niet vanuit de browser met een sleutel die iedereen kan uitlezen.

bouwwerk, ontwerp ligt klaar
dicht Rechten versmallen

De rol waarmee de oude cockpit werkt mag vandaag te veel. Die rechten moeten terug, en dat kan pas als het schrijven via de worker loopt, anders valt het werk stil.

timing bij Gianluca
dicht Adres voor presales

Het presalesportaal heeft nog geen eigen adres. Dat is een handeling van een minuut bij de domeinnaam, maar hij moet wel gebeuren.

handeling van Gianluca
WAT HIER NIET STAAT

Geen namen, geen bedragen, geen adressen

Op deze pagina en op de drie portaalpagina's staan bewust geen aantallen, geen klantnamen, geen bedragen en geen adressen van de systemen zelf. De uitleg is openbaar leesbaar voor wie de link heeft; de gegevens zijn dat niet en worden dat ook niet.

De gemeten stand van het systeem staat in de documenten in de repo, die niet worden meegepubliceerd. Wat er met gegevens van bezoekers en klanten gebeurt, met welke grondslag en hoe lang we het bewaren, staat in de privacyverklaring en in het overzicht van subverwerkers.

VEELGESTELDE VRAGEN

Wat mensen hierover vragen

Waarom drie portalen en niet een dashboard?

Omdat de drie fasen inhoudelijk verschillen. Leads zoeken is koud werk met veel volume, presales is warm werk met weinig volume, en een klant bedienen is doorlopend werk. Een scherm dat alle drie tegelijk toont, toont in de praktijk geen van drieen goed.

Wie werkt er in deze portalen?

AI-sessies. Twee die leads zoeken en benaderen, een die gesprekken en voorstellen voorbereidt, een die het klantdossier bijhoudt en een die facturen klaarzet. Gianluca kijkt mee en beslist wat een mens hoort te beslissen.

Staan er persoonsgegevens op deze pagina?

Nee. Deze pagina's leggen uit hoe het werkt, verder niets. De gegevens zitten in het systeem erachter en dat is hiervandaan niet te bereiken.

Werkt de koppeling met de data al?

Nog niet. Eerst moeten de vier sloten hierboven open. Zolang dat niet af is tonen we liever niets dan iets dat niet klopt.

Hoe wordt afgedwongen dat een AI zich aan de regels houdt?

Met drie lagen boven elkaar. De grondwet legt vast wat mag, de werkinstructie vertaalt dat naar een recept per handeling, en de keuring meet achteraf of het is nageleefd, met een oordeel per regel en een exitcode.

Sectie · Volgende stap24/7 bereikbaar
Plan een gesprek