UC-V2: Veranstaltungen auflisten – aktive Veranstaltung priorisieren

[cschog]

UC-ID

UC-V2

Ziel / Beschreibung

Das System stellt eine Liste aller Veranstaltungen bereit.
Die aktuell aktive Veranstaltung ist eindeutig gekennzeichnet und wird in der Liste priorisiert angezeigt.

Fachlicher Kontext

Akteure

•	Benutzer (z. B. Vorstand, Admin, Trainer)
•	UI / Frontend

Vorbedingungen

•	Es existieren 0, 1 oder mehrere Veranstaltungen
•	Es gibt maximal eine aktive Veranstaltung (garantiert durch UC-V1)

Nachbedingungen

•	Alle Veranstaltungen werden zurückgegeben
•	Die aktive Veranstaltung ist eindeutig erkennbar (aktiv = true)
•	Die Sortierung ist fachlich definiert

Eingaben / Filter

No response

Fachliche Regeln

Ablauf (Happy Path)

1. Der Benutzer ruft die Veranstaltungsübersicht auf
2. Das System liefert alle Veranstaltungen
3. Die Liste ist wie folgt sortiert:

• aktive Veranstaltung zuerst
• danach nach beginnDatum DESC

4. Die aktive Veranstaltung ist im Ergebnis eindeutig gekennzeichnet

Fachliche Regeln

•	Es darf höchstens eine aktive Veranstaltung geben
•	Die aktive Veranstaltung muss im UI immer eindeutig erkennbar sein
•	Die Sortierung ist stabil und deterministisch

API / Technische Umsetzung

GET /api/veranstaltung

Definition of Done

• API implementiert
• Validierung umgesetzt
• Integrationstest vorhanden
• Dokumentation aktualisiert
• Review durchgeführt

[cschog]

Der Use Case UC-V2 wurde vollständig umgesetzt und getestet.

Umsetzung:

•	Alle Veranstaltungen werden ohne Filter geladen
•	Die aktive Veranstaltung steht immer an erster Stelle
•	Alle weiteren Veranstaltungen sind nach beginnDatum DESC sortiert
•	null-Werte bei beginnDatum werden korrekt am Ende einsortiert

Technische Details:

•	Sortierlogik ist zentral im Repository implementiert
•	Service bleibt schlank und enthält keine zusätzliche Sortierung
•	Verhalten ist deterministisch und UI-tauglich

Tests:

•	Integrationstest UC_V2_listVeranstaltungen_activeFirst erfolgreich
•	Reihenfolge und Aktiv-Status werden explizit geprüft