UC-T1: Teilnehmer zur aktiven Veranstaltung hinzufügen

[cschog]

UC-ID

UC-T1

Ziel / Beschreibung

Eine Person wird der aktiven Veranstaltung als Teilnehmer / Mitarbeiter / Leiter zugeordnet.

Fachlicher Kontext

Telnehmerverwaltung in KanuControl

Eingaben / Filter

No response

Fachliche Regeln

Es muss genau eine aktive Veranstaltung existieren
•	Person muss existieren
•	Person darf nicht bereits Teilnehmer der aktiven Veranstaltung sein
•	Rolle ist Pflicht (T, M, L)
•	DB sichert zusätzlich:
•	uk(veranstatung_id, person_id)

API / Technische Umsetzung

POST /api/veranstaltung/teilnehmer

Definition of Done

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

[cschog]

Umsetzung:

•	Teilnehmer werden ausschließlich der aktiven Veranstaltung des Tenants zugeordnet
•	Ein Teilnehmer ist eindeutig durch (veranstaltungId, personId) definiert
•	Standardrolle beim Anlegen: TEILNEHMER
•	Mehrfaches Hinzufügen derselben Person zur aktiven Veranstaltung wird verhindert

API:

•	POST /api/teilnehmer
•	Tenant-scope über X-Tenant
•	Erfolgsfall: 201 CREATED
•	Duplikat: 409 CONFLICT

Technik:

•	Service kapselt:
•	Ermittlung der aktiven Veranstaltung
•	Duplikatsprüfung
•	Persistenz
•	Liquibase-Schema & Multi-Tenant-Setup berücksichtigt

Tests:

•	Vollständiger Integrationstest (Real-HTTP via MockMvc)
•	Testet Happy Path und Konfliktfall (Duplicate)