Skip to content

[Epic] Definition des Fachdatenschemas für Matrix-Nachrichten

Warum

Als Fachverfahrenshersteller möchte ich ein einheitliches, klar dokumentiertes Fachdatenschema für ZBP-Nachrichten über Matrix haben, damit ich strukturierte Inhalte (z.B. Auswahlantworten, Freitext, Anhänge) interoperabel mit dem Bürger oder Unternehmen austauschen kann, ohne für jede Behörde oder jeden Kanal eigene Datenformate pflegen zu müssen.

Ziel

Als FIT-Connect möchte ich ein versioniertes Fachdatenschema definieren, das alle relevanten ZBP-Use-Cases abdeckt und direkt in Matrix-Events(Nachrichten) abbildbar ist, damit SDKs, Homeserver und Bridge gemeinsam ein konsistentes, erweiterbares Datenmodell verwenden können.

Links, Hinweise, Bemerkungen

  • Fokus sollte auf generischen Interaktionsbausteinen liegen (z.B. Single-Choice, Multi-Choice, Freitext, Upload-Aufforderung).
  • Versionierung, Abwärtskompatibilität, Migration (v1 → v2 etc.).

Stories

  • Bestandsaufnahme der fachlichen Anforderungen.
  • Definition des Ziel-Fachdatenschemas (Fokus auf Interaktionselemente - Anfordern und Antworten).
  • Modellierung von strukturierten Antworttypen (Liste, Checkboxen, Freitext, Anhänge).
  • Abbildung des Fachdatenschemas auf Matrix-Eventtypen und -Content.
  • Definition von Versionierungs- und Migrationsregeln sowie Kompatibilitätsrichtlinien.
  • Erstellung der Dokumentation inkl. Beispielnachrichten und JSON-Schemata.

Akzeptanzkriterien

  • Ein vollständiges, versioniertes Fachdatenschema liegt vor und ist für SDK-Entwicklung, FIT-NEO und Bridge verbindlich freigegeben.
  • Das Schema unterstützt mindestens: einfache Nachrichten, strukturierte Antwortoptionen, Freitext, Anhänge und immer Vorgangsbezüge.
  • Das Mapping auf Matrix-Events ist dokumentiert, getestete Beispiel-Events liegen vor und wurden mit dem Homeserver-Team abgestimmt.
  • Definition of Done wurde überprüft.
Edited by Wojciech Gdaniec