Fältanteckningar

Endpoints

Externa endpoints och events är det publika åtagande en Bounded Context gör mot omvärlden. Allt annat kan ändras fritt: datamodellen, persistensen, det interna språket. Det externa endpoint- och events-kontraktet kan inte det. Att vara explicit om vad som exponeras (och därmed implicit om vad som inte gör det) är skillnaden mellan en Bounded Context som går att underhålla och en som blir gisslan av varje konsument den någonsin haft.

Lista de endpoints som den aktuella Bounded Context exponerar. Håll fältlistan nära det kontrakt du faktiskt tänker publicera. Håll det minimalistiskt.

Som vanligt är det "best guess"-nivån vi jagar här. Exakthet görs bäst i samband med genomförandet. Med det sagt kan det vara intressant även att beskriva interna endpoints och events (inkl. events vi lyssnar på), för att beskriva något viktigt och hjälpa vissa intressenter till delad förståelse, men det är vanligtvis av lägre vikt.

Att tänka på

Endpoint är ofta relaterad till en aggregate root. Kan vara ett bra sätt
att tänka för att komma igång.
Verb: HTTP-verben (GET, POST, PUT, PATCH, DELETE) bär semantik om det rör
sig om ett REST-API. Vi har valt att låta Events också använda Verb som
beskrivningsform, vad gäller publish och subscribe.
Multi-tenant: används systemet av flera olika organisationer i samma
instans ska det framgå i kontraktet hur tenancy uttrycks (path-prefix, header,
subdomän eller token).
Versionering: endpoints kan behöva versioneras. Bestäm strategi
(URI-version, mediatyp, header) tidigt.

Vidare läsning

Webber, J., Parastatidis, S. & Robinson, I. *REST in
Practice: Hypermedia and Systems Architecture* (2010)
Evans, E. Domain-Driven Design (2003)
Vernon, V. Implementing Domain-Driven Design (2013)