Menu

Wat is een technisch ontwerp?

Een document dat beschrijft hoe de koppeling technisch werkt: welke endpoints, datamodellen, authenticatie, queueing en foutafhandeling we gebruiken.

Waar het functionele ontwerp beschrijft wat de koppeling doet, beschrijft het technisch ontwerp hoe we het gaan bouwen. Dit document is vooral relevant als je eigen IT-afdeling betrokken is of als de koppeling bedrijfskritisch wordt.

Wat staat erin?

  • Architectuur-diagram — welke componenten praten met welke
  • Endpoints en authenticatie — welke API’s we aanroepen, hoe we authenticeren (OAuth2, API-key, webhook-secrets)
  • Datamodel en veld-mapping — hoe vertaal je customer.name uit systeem A naar klant.volledige_naam in systeem B
  • Queueing en retry-logica — wat gebeurt er als systeem B tijdelijk down is
  • Monitoring en logging — wat loggen we, waar, hoe lang
  • Deployment en updates — hoe rollen we veranderingen uit zonder downtime

Waar wordt het voor gebruikt?

Het technisch ontwerp is de bouwtekening voor onze developers én de handleiding voor toekomstig onderhoud. Bij Basis leveren we een eenvoudig ontwerp, bij Corporate een volledig gedocumenteerde versie die aan ISO-achtige standaarden voldoet.