Integrace s ČUS při zakládání nového člena

[dapolach]

Integrace s ČUS při zakládání nového člena

Kontext

Při vytvoření nového člena v Klabis je potřeba automaticky synchronizovat údaje do systému ČUS (Český svaz orientačních sportů).

Požadavky z issue #3

Z původního požadavku na zakládání členů:

• Po založení nového člena se údaje propíší do ORIS/CUS/etc.
• Iniciuje uložení dat člena do CUS

Technické poznámky

Zjištění z analýzy:

• Podobně jako ORIS, není jasné, zda ČUS poskytuje API pro správu členů
• Je potřeba vyjasnit způsob integrace s ČUS

Otázky k vyřešení

1. Dostupnost API: Má ČUS API endpoint pro vytváření/aktualizaci členů klubu?

   • Pokud ANO: dokumentace API, autentizace, rate limits?
   • Pokud NE: jaký je preferovaný způsob synchronizace?

2. Synchronizace dat:

   • Které údaje se mají do ČUS synchronizovat?
   • Má být synchronizace synchronní (při vytvoření) nebo asynchronní (batch)?
   • Co se stane při chybě synchronizace (retry, manual fix, rollback)?

3. Mapování údajů:

   • Mapování Klabis polí → ČUS pole
   • Registrační číslo - koordinace s ČUS?
   • Rodné číslo - validace, šifrování?

Navrhovaná řešení (podle dostupnosti API)

Varianta A: ČUS má API

• Implementovat ČUS client service
• Event handler pro MemberCreatedEvent → volání ČUS API
• Retry mechanismus pro selhání
• Monitoring a alerting

Varianta B: ČUS nemá API

• Export členů do CSV/Excel formátu
• Pravidelný batch export (denně/týdně)
• Manuální import do ČUS administrátorem

Akceptační kritéria

• Vyjasnit způsob integrace s ČUS
• Navrhnout technické řešení
• Implementovat synchronizaci dat
• Ošetřit chybové stavy
• Zdokumentovat proces

Související issues

• Zakládání nových členů oddílu #3 - Zakládání nových členů oddílu (hlavní issue)

---

Priorita: Závisí na dostupnosti ČUS API - nejprve vyjasnit technické možnosti