[Epic] SDK-Modul für Matrix-Kommunikation – Fokus Senden

Warum

Als Fachverfahrensentwickler möchte ich über ein FIT-Connect SDK strukturierte Nachrichten an Bürger:innen via Matrix senden können, damit ich ohne tiefes Matrix-Know-how die neue Plattform nutzen kann und mich auf die Fachlogik konzentrieren kann.

Ziel

Bereitstellung eines SDK-Moduls, das den Versand von ZBP-Matrix-Nachrichten (inkl. Fachdatenschema, Empfängersuche und Fehlermanagement) kapselt, damit Fachverfahren mit wenigen API-Aufrufen rechtssicher und robust an Bürger:innen senden können.

Links, Hinweise, Bemerkungen

• Verwendung des in 3973 definierten Fachdatenschemas.
• Integration mit Behörden-Homeserver .
• Enge Kopplung an Epic 3976 (Empfängersuche) – aber entkoppelt nutzbar.

Stories

• API-Design für Sende-Funktionalität (Nachricht erstellen, Empfänger angeben, Versand auslösen in enger Abstimmung mit FIT-NEO).
• Implementierung der Basis-Sendefunktion (inkl. Authentifizierung am Behörden-Homeserver).
• Integration des Fachdatenschemas: Validierung und Serialisierung vor dem Versand.
• Optionale Integration der Empfängersuche (Epic 3976) in den Sende-Flow.
• Erweiterungen: Anhänge, Retry-Logik, Fehlerhandling und Logging.
• Erstellung von Entwicklerdokumentation, Quickstart und Code-Beispielen.

Akzeptanzkriterien

• Fachverfahrensentwickler können mit wenigen API-Aufrufen eine Matrix-Nachricht im definierten Fachdatenschema an Bürger:innen senden.
• Das SDK validiert das Fachdatenschema und verhindert den Versand strukturell ungültiger Nachrichten.
• Fehler- und Retry-Verhalten (z.B. temporäre Matrix-Server-Probleme) ist spezifiziert, implementiert und automatisiert getestet.
• Bereitstellung von Dokumentation, Beispiel-Integrationen / Referenz-Fachverfahren.
• Definition of Done wurde überprüft.