Skip to content

Doku BiDiKo Entscheider & Verantwortliche

Warum?

Als Behörde möchte ich eine aktuelle Dokumentation. Die bidirektionalen Kommunikation hat in letzter Zeit eine Reihe an Änderungen erfahren, die noch nicht in die Dokumentation eingeflossen sind. Dies betrifft konkret den Rückkanal "FIT-Connect" für den Zustelldienst und das SDK.

Im ersten Schritt soll die Aktualisierung auf der Ebene der Entscheider:innen und Verantwortliche stattfinden, also ohne technische Details. Die Dokumentation für Entwickler:innen wird in einem anderen (noch zu erstellenden) Ticket abgehandelt.

Dargestellt werden soll das beidseitige Zusammenspiel zwischen:

  • Onlinedienst
  • Fit-Connect
  • Fachverfahren

Zu behandelnde Elemente sind:

  • Rückkanal "FIT-Connect"
  • Antrag (engl. case)
  • Einreichung (engl. submission)
  • Antwort (engl. reply)

Relevante Links und Bemerkungen

Der bisherige Merge-Request ist hier:
docs!477 (diffs). Dieser Merge-Request ist nicht mehr aktuell. Er ist in main gemerged.

PREVIEW: https://preview.docs.fitko.dev/fit-connect/515-neuster-branch-rueckkanal-dokumentation-ueber-die-verwendun/docs/organisation-tasks/bidiko-entscheider/

OpenAPI-Spezifikation https://preview.docs.fitko.dev/submission-api/bilateral-communication/

Möglich Beschreibung der bidirektionalen Kommunikation (siehe Akzeptanzkriterium 1):

Die bidirektionale Kommunikation findet zwischen dem Onlinedienst und dem Fachverfahren statt. Damit können nach dem ersten Antrag von dem Onlinedienst an das Fachverfahren beliebig oft weitere Nachrichten zwischen den Beiden ausgetauscht werden. Im Gegensatz z.B. zum Postfach (siehe Bild "Mögliche Kommunikationen.png" unter Designs).

Mögliche allgemeine Vorteile einer bidirektionalen Kommunikation (siehe Akzeptanzkriterium 1):

  • Automatisierung
  • Vollständige Kommunikation
  • Historie für eine übersichtliche Darstellung der Anträge
  • Freiwilligkeit - jeder frei wählen, ob er es durchführen möchte oder nicht
  • Standardisierung indem angegeben wird, nach welchem Prozessstandard die Datenformate der Nachrichten aufgebaut sein müssen
  • Weiterhin hohe Sicherheit gewährleistet durch Ende-zu-Ende-Verschlüsselung (Anmerkung Wojtek: vielleicht würde ich von Einhaltung höchster Sicherheitsvorgaben sprechen - das E2E müssten wir ggf. noch besprechen)

Akzeptanzkriterien

  1. Die Beschreibung und allgemeinen Vorteile einer bidirektionalen Kommunikation sind beschrieben (siehe auch Bemerkungen).
  2. Das Zusammenspiel zwischen Onlinedienst, Fit-Connect und Fachverfahren für den Rückkanal "FIT-Connect" ist auf der Ebene Entscheider:innen und Verantwortliche grafisch veranschaulicht und leicht verständlich beschrieben.
  3. Die Elemente Antrag, Einreichung und Antwort sind im Zusammenspiel enthalten.
  4. Es sind auch Fälle berücksichtigt, wo mehrere Einreichungen in Folge stattfinden, ohne dass zwischendurch eine Antwort erfolgt. Dies kann z.B. sein, wenn eine Einreichung ergänzt oder ersetzt wird.
  5. Es sind auch Fälle berücksichtigt, wo mehrere Antworten in Folge stattfinden, ohne dass zwischendurch eine weitere Einreichung erfolgt. Dies kann z.B. sein, wenn eine Antwort ergänzt oder ersetzt wird.
  6. Es ist berücksichtigt, dass eine Einreichung nicht notwendigerweise eine Antwort erhält.
  7. Wir sollten speziell bei den Entscheidern nicht über OD & FV sondern allgemeiner von IT-Systemen sprechen
  8. [ ]

Durchführungsplan (von Entwickler:in bei Umsetzungsplanung auszufüllen)

Edited by Michael Haidner