2. GraphQLサブスクリプション

GraphQLサブスクリプションのシーケンス図は、GeoPardコアで実装されたイベント駆動アーキテクチャをどのように活用するかを示します。リンクされたエンティティに変更があると、

GeoPard APIは影響を受けたエンティティと対応する操作（挿入, 変更, 削除）をキャプチャしたイベントを即座に発行します。これらのサブスクリプションの範囲は広く、Farm、Field、SatelliteImage、SoilDataset、AsAppliedDataset、YieldDataset、TopographyMap、Notesなどのすべてのエンティティを網羅します。

GraphQLサブスクリプション（リクエスト1 または R1）はすべてのイベントがほぼリアルタイムで配信されるWebSocket上で動作し、変更の即時通知を確保します。

サブスクリプションイベントの受信側は基本的なサービスとして機能し、受信したイベントを処理ロジックが適用される次のサービスへルーティングする役割を担うべきです。重要なのは、この受信側が自身で処理タスクを実行しないことです。

さらに、見逃したり失われたりしたイベントがあった場合、ユーザーはそれらを取得することができます。これは特定の日付範囲とエンティティ（User、Farm、Field）に合わせたGraphQLクエリを実行することで実現され、過去のイベントを完全に回復することが可能になります（リクエスト2 または R2）。このレベルの機能により情報が失われることはなく、ユーザーデータの整合性と一貫性が維持されます。

シーケンス図：サブスクリプションイベントの扱い