Communicatie

Berichten die hun betekenis behouden tussen teams en systemen.

Berichtontwerp

Geef elke gebeurtenis een duidelijke envelop

Een gebeurtenis heeft meer nodig dan een inhoud. Identiteit, herkomst en aanmaaktijd helpen de ontvanger begrijpen welke toepassing het bericht heeft gemaakt. Houd deze gedeelde velden gescheiden van de bedrijfsgegevens, zodat een andere transportlaag hun betekenis niet verandert.

Berichtontwerp
Wijzig een bericht zonder lezers te verrassen

Producenten en afnemers worden zelden tegelijk bijgewerkt. Een schemawijziging heeft daarom een overgangsperiode waarin oude en nieuwe berichten naast elkaar bestaan. Ontwerp die periode expliciet; een uitrol is niet één ondeelbare handeling voor de hele organisatie.

Berichtontwerp
Volg één interactie over systeemgrenzen

Eén gebruikersactie kan meerdere verzoeken, achtergrondtaken en meldingen veroorzaken. Een correlatie-identificatie verbindt de registraties van die interactie. Het is nuttige context, maar geen authenticatietoken en mag op zichzelf nooit toegang verlenen.

Berichtontwerp
Maak duidelijk welke klok een tijdstempel beschrijft

Ontvangstvolgorde is niet altijd gebeurtenisvolgorde. Apparaten raken offline, klokken lopen uiteen en wachtrijen vertragen publicatie. Een tijdstempel zonder vastgelegde betekenis nodigt uit om metingen van verschillende procesmomenten samen te voegen.

Berichtontwerp
Maak fouten bruikbaar voor het ontvangende systeem

Een foutantwoord moet de aanroeper helpen bepalen wat daarna nodig is. Een uitleg voor mensen en een classificatie voor software hebben verschillende doelen. Houd de foutcode stabiel wanneer de tekst voor duidelijkheid of vertaling verandert.

Berichtontwerp

Aflevering

Herhaal een verzoek zonder het effect te verdubbelen

Een aanroeper kan het antwoord verliezen nadat de server een bewerking al heeft voltooid. Opnieuw proberen is dan onzeker: de eerste poging kan geslaagd zijn. Idempotentie geeft herhaalde pogingen een vaste betekenis in plaats van dubbele resultaten later op te ruimen.

Aflevering
Geef een herstellende dienst ruimte

Herhaalde verzoeken kunnen een storing versterken wanneer alle clients tegelijk opnieuw proberen. Wachttijden spreiden pogingen over de tijd. Combineer dit met een maximum, anders kan een mislukte bewerking middelen blijven gebruiken nadat zij niet meer nuttig is.

Aflevering
Leg vast wat een ontvangstbevestiging belooft

Geaccepteerd, opgeslagen, verwerkt en afgeleverd zijn verschillende toestanden. Een positieve bevestiging is alleen nuttig als beide partijen weten welke toestand zij bevestigt. Ontvangst verwarren met voltooiing kan een dashboard succesvol laten lijken terwijl werk nog wacht.

Aflevering
Bewaar mislukte berichten voor onderzoek

Een bericht dat herhaaldelijk mislukt mag ander werk niet blokkeren. Een aparte foutwachtrij scheidt blijvende problemen van de gewone stroom en bewaart genoeg informatie voor onderzoek. Het is een wachtrij voor herstel, geen onbeperkt archief.

Aflevering
Laat een trage afnemer zijn grenzen aangeven

Als producenten sneller werk sturen dan afnemers het afronden, blijft de wachtrij groeien. Terugdruk maakt dit verschil zichtbaar en begrenst de instroom. Extra buffering kan een korte piek opvangen, maar lost aanhoudende overbelasting niet op.

Aflevering

Zoek in de bibliotheek