← terug naar de grondwet
Voor de techniek · de blauwdruk

Eén platform, tien jaar houdbaar

De architectuur is de technische vertaling van de grondwet: uit één event (de afgeronde klus) volgt automatisch alles. Bewezen technologie, pragmatische keuzes, en de dure beslissingen vanaf dag één goed.

de vorm

Gelaagd, van gebruiker tot cloud

Cloudflare aan de rand, Next.js op Vercel, een modulaire monoliet-kern op Postgres, met een event-laag naar async workers. Security, observability en backups snijden door alle lagen.

High-level platformarchitectuur Gebruikers Vakman Consument Operator (HQ) Partner Edge Cloudflare DNS · WAF · DDoS · CDN · image optimization Frontend Next.js op Vercel App Router · server components · ISR · BFF-API Applicatiekern Modulaire monoliet · bounded contexts identity · marketplace · oplevering · paspoort · materiaal · payments · reputation · content Data en async PostgresRLS · pgvector Rediscache · queue Storage + CDNfoto's · docs Event busoutbox naar workers Integraties en AI PSPStripe Connect Mail / SMSnotificaties Boekhouding · KvKGoogle-profiel AI-gatewayrouter · RAG Cross-cutting (alle lagen) Security · Aikido · RLS · RBAC Observability · Sentry · OTel Backups · PITR · DR
de motor

Eén event, twaalf processen

De commando RondKlusAf commit één transactie plus een outbox-record. Daaruit stuurt het event, betrouwbaar en idempotent, alle afgeleiden aan. Precies zoals de vakman één handeling doet, doet het systeem intern één event.

Transactional-outbox-patroon voor betrouwbaarheid (geen verloren events), idempotente consumers (één afronden is één factuur, één reviewverzoek).

De gebruikersflow wacht nooit op een worker: de offerte of oplevering verschijnt direct, de verrijking (AI, SEO, embeddings) volgt asynchroon.

de kernkeuzes

Waarom wel, waarom niet, welke trade-off

Modulaire monoliet eerst

WaaromEén team overziet het, snel bouwen, event-naden maken later afsplitsen mogelijk.
Trade-offEén deploybare eenheid. We splitsen pas bij bewezen bottleneck, niet vooraf. Voortijdige microservices zijn de duurste fout.

Postgres als bron van waarheid

WaaromBewezen, relationeel, RLS, schaalt ver. 95% van alles leeft hier.
Trade-offBewust saai. Een extra store (search, vector, warehouse) pas als Postgres het aantoonbaar niet meer aankan.

Event-driven aan de naden

WaaromKlusAfgerond stuurt review, paspoort, SEO en factuur async aan. De kern van het domein.
Trade-offIets meer complexiteit dan direct aanroepen, maar het is goedkoop nu en betaalt zich uit bij groei.

Multi-tenant en multi-label

WaaromEén platformkern, verticals als configuratie. Nieuwe vertical is een module, geen nieuwe codebase.
Trade-offRLS-discipline vereist. Dat is precies wat een DD-team wil zien.

Bewezen tech, geen hype

WaaromOver tien jaar onderhoudbaar door een gemiddeld goed team.
Trade-offSoms niet de allernieuwste feature. Dat accepteren we bewust.

Security en AVG by design

WaaromRLS, RBAC, audit en Aikido vanaf dag één. Privacy ingebouwd, niet achteraf.
Trade-offMeer werk vooraf, veel minder risico later. Onmisbaar met consumentendata en foto's.
de laag erboven

Automation Hub, Open API en de AI-assistent

Wij vervangen bestaande software niet, wij automatiseren erbovenop. Integraties zijn adapters aan de randen; de waarde-events blijven bij ons.

Adapters aan de randen

RegelWhatsApp, agenda en boekhouding zijn event-sinks. De kern-events (oplevering, materiaal, betaling, paspoort, reviews) blijven native.
WaaromLage adoptiedrempel zonder de data- en materiaalvoorsprong weg te geven.

Automation Hub

WatDe event-bus met connectors: KlusAfgerond stuurt review, factuur, agenda en materiaalbestelling automatisch aan.
WaaromDe vakman hoeft niets; zijn bestaande tools worden gevoed.

Open API en webhooks

WatGeversioneerd, met API-keys en scopes. Later koppelen ERP's, leveranciers en verzekeraars zelf.
WaaromSchaalt zonder dat wij elke koppeling bouwen.

AI-assistent, geen chatbot

WatRekent het materiaal per klus, controleert de calculatie, beoordeelt opleverfoto's en maakt opleverrapporten. Getallen uit echte productdata, niet uit een taalmodel.
WaaromNeemt werk weg dat de vakman toch al doet, en stuurt materiaal naar Stucshop.
schaalpad

Van 100 naar 100.000 vakbedrijven

Dit is geen scale-out-probleem: 100.000 bedrijven is nog altijd maar tientallen writes per seconde. Het groeit zonder herbouw.

100 - 3.000

Modulaire monoliet, één Postgres, Vercel, Redis. Geen bijzondere maatregelen.

3.000 - 25.000

Read replicas, meer caching, zware verwerking in aparte workers, dedicated zoekindex, warehouse voor analytics.

25.000 - 100.000

Partitioneer hete tabellen, splits alleen bewezen hete delen af, overweeg multi-region. De rest blijft monoliet.

due diligence

Klaar voor een technisch onderzoek van 50 miljoen

Waar een technisch due-diligence-team op hamert, en waar deze architectuur vanaf dag één op is voorbereid.