Suche nach Gültigkeit eines Datenschemas

Beschreibung der Story

Als Anwender/-in des FIM-Sammelrepository

möchte ich über die im FIM-Sammelrepository enthaltenen Datenschemata per API und Suchkriterium "Gültigkeit ab" bzw. "Gültigkeit bis" abrufen können,

so dass die Liste die Metadaten der gefundenen Datenschemata zu lesen erlaubt.

Relevante Links und Bemerkungen

• Voraussetzung für diese User Story ist die Ablage der von den Landesredaktionssystemen über die FIM-Portal-Schnittstelle eingelesenen Dateien in der Datenbank.
• Die API und die Datenbank werden nicht zu Projektbeginn einmalig konzipiert und festgelegt, sondern wachsen über die Produktinkremente sprintweise.
• Die Suchergebnisse umfassen nur die Metadaten, nicht die eigentlichen Datenschemata. Das Suchergebnis mit Datenschema ist Gegenstand einer anderen User Story
• Die Gültigkeit ist fachlicher Ausdruck der Gültigkeit der Handlungsgrundlagen, was in der Regel die juristischen Grundlagen sind, welche im Rahmen der FIM-Normenanalyse ermittelt werden.

Akzeptanzkriterien

1. GET /api/v0/schemas/{schemaidd}/{version}}/search?from=2023-01-01 liefert eine Liste von einem oder mehreren Datenschemata, bei denen die Handlungsgrundlagen seit dem 01.01.2023 in Kraft sind und es noch sind. Das ist äquivalent mit der Erfüllung einer der folgenden Bedingungen:

• das Feld gueltigAb liegt vor dem oder am 01.01.2023 und das Feld gueltigBis ist leer
• das Feld gueltigAb liegt vor dem oder am 01.01.2023 und das Feld gueltigBis hat ein Datum in der Zukunft bezogen auf den Zeitpunkt der Abfrage
• das Feld gueltigAb ist leer und das Feld gueltigBis hat ein Datum in der Zukunft bezogen auf den Zeitpunkt der Abfrage
• das Feld gueltigAb und das Feld gueltigBis sind leer

2. GET /api/v0/schemas/{schemaidd}/{version}}/search?to=2023-01-01 liefert eine Liste von einem oder mehreren Datenschemata, bei denen die Handlungsgrundlagen bis zum 01.01.2023 in Kraft sind und es noch sind. Das ist äquivalent mit der Erfüllung einer der folgenden Bedingungen:

• das Feld gueltigBis liegt am oder nach dem 01.01.2023 und vor oder am Tag der Abfrage
• das Feld gueltigBis ist leer

3. GET /api/v0/schemas/{schemaidd}/{version}}/search?from=2023-01-01&to=2023-02-01 liefert eine Liste von einem oder mehreren Datenschemata, bei denen die Handlungsgrundlagen seit dem 01.01.2023 in Kraft und am 01.02.2023 noch in Kraft sind . Das ist äquivalent mit der Erfüllung einer der folgenden Bedingungen:

• • das Feld gueltigAb liegt vor dem oder am 01.01.2023 und das Feld gueltigBis ist leer
• das Feld gueltigAb liegt vor dem oder am 01.01.2023 und das Feld gueltigBis liegt am oder nach dem 01.02.2023 und vor oder am Tag der Abfrage
• das Feld gueltigAb liegt vor dem oder am 01.01.2023 und das Feld gueltigBis hat ein Datum in der Zukunft bezogen auf den Zeitpunkt der Abfrage
• das Feld gueltigAbist leer und das Feld gueltigBis liegt am oder nach dem 01.02.2023 und vor oder am Tag der Abfrage
• das Feld gueltigAbist leer und das Feld gueltigBis hat ein Datum in der Zukunft bezogen auf den Zeitpunkt der Abfrage
• das Feld gueltigAbund das Feld gueltigBissind leer

4. Die Dokumentation enthält die API-Beschreibung inkl. Ergebniscodes.
5. Tests
6. Dokumentation (falls noetig)