2. GraphQL-abonnement

Sekvensdiagrammet for GraphQL-subscriptioner illustrerer, hvordan man drager fordel af den hændelsesdrevne arkitektur implementeret i GeoPard-kernen. Ved enhver ændring af de tilknyttede enheder,

sender GeoPard API'et straks en hændelse, der fanger de berørte enheder og den tilsvarende operation (INDSÆT, ÆNDR, FJERN). Omfanget af disse subscriptioner er omfattende og dækker alle enheder såsom Farm, Field, SatelliteImage, SoilDataset, AsAppliedDataset, YieldDataset, TopographyMap, Notes osv.

GraphQL-subscriptionen (Forespørgsel 1 eller R1) kører over en WebSocket, hvor alle hændelser leveres næsten i realtid og sikrer øjeblikkelig kommunikation af enhver ændring.

Modtageren af subscription-hændelserne bør fungere som en simpel tjeneste, ansvarlig for at rute de modtagne hændelser til en efterfølgende tjeneste, hvor behandlingslogikken anvendes. Det er vigtigt, at denne modtager ikke udfører nogen behandlingsopgaver selv.

Desuden, hvis der skulle mangle eller gå tabt hændelser, har brugerne mulighed for at hente dem. Dette opnås ved at udføre en GraphQL-forespørgsel skræddersyet til en specifik datoperiode og enheder (User, Farm, Field), hvilket effektivt muliggør fuld genopretning af tidligere hændelser (Forespørgsel 2 eller R2). Dette niveau af funktionalitet sikrer, at ingen information går tabt og opretholder integriteten og konsistensen af brugerdata.

Sekvensdiagram: Arbejd med subscription-hændelser