Entity, vzťahy, časová dimenzia

Entitný diagram

Nasledujúci diagram ukazuje hlavné entity systému a ich vzťahy. Affiliation je uprostred zámerne — takmer všetko v systéme sa ňou preplieta. Nie je to technický "join table", ale prvotriedna biznis entita s vlastným životným cyklom.

Person — identita osoby

Person je stabilná entita, ktorá opisuje človeka ako ľudskú bytosť, nie jeho športovú rolu. Žiadne športové polia v Person tabuľke nie sú — kluby, licencie, role, všetko patrí do iných entít.

Povinné jadro

Identifikátory

Affiliation — srdce systému

Affiliation je vzťah osoby k organizácii v určitej role (druhu športovej činnosti), v určitom športe a disciplíne, platný v určitom časovom intervale. Je to najdôležitejšia entita celého systému a modeluje sa event-sourcovane.

Schéma

Kľúčové vlastnosti

• Temporálnosť je vstavaná. Aktuálnosť sa odvodzuje z valid_from ≤ now() ≤ COALESCE(valid_to, ∞) a status = active.
• Každá zmena je event. Prestup, pozastavenie, ukončenie nie je UPDATE, ale samostatná udalosť.
• Kompozitné constrainty. Osoba nemôže mať dve aktívne "tréner" afiliácie v tom istom klube a športe súčasne.
• Prestup = ukončenie + nový začiatok. Zachováva históriu.

Organization — hierarchia subjektov

Organizácie nie sú ploché. Typológia pokrýva celý ekosystém — od národných zväzov cez samosprávu, štátnu správu, školstvo až po komerčné subjekty. Kompletný zoznam je v kapitole Číselníky.

Schéma

Jedna organizácia, viac športov

Polyvalentný klub môže byť akreditovaný vo viacerých športoch súčasne. Preto vzťah Organization × Sport × Discipline je samostatná entita ORG_SPORT_ACCREDITATION s vlastnou platnosťou a stavom uznania.

Facility — športovisko

Športovisko je v SportUp prvotriedna entita — nie atribút podujatia alebo klubu. Dôvod: jedno športovisko slúži viacerým subjektom súčasne, má vlastnú prevádzkovú a technickú identitu, jeho dáta sú zároveň podkladom pre agendu cestovného ruchu.

Schéma

Prečo samostatná entita

• Jedno športovisko, viac subjektov. Obecný štadión využíva klub, škola, ochotnícke ligy, komerčné nájmy.
• Vlastník ≠ prevádzkovateľ. Obec vlastní, klub prevádzkuje. Model to rozlišuje explicitne.
• Podujatia sa odohrávajú tu. Event Participation referencuje facility_id.
• Cestovný ruch. Register je verejne dotazovateľný cez otvorené API — aplikácie typu "lyžiarske strediská v Žilinskom kraji" alebo "najbližšia plaváreň" čerpajú dáta odtiaľto.
• Dotácie a investície. Ministerstvo vie, kde sú športoviská, v akom stave, s akou kapacitou. Dotačná politika nestojí na ad-hoc prieskumoch.

Vzťahy k ostatným entitám

Activity — druh športovej činnosti

Druh športovej činnosti (napr. amatérsky športovec, tréner, rozhodca, usporiadateľ, dobrovoľník) je hierarchický číselník. Každá Affiliation má práve jeden activity_code — ten istý človek v klube môže mať dve afiliácie, ak je zároveň hráčom aj trénerom.

Konkrétne druhy činností, ich kódy a popisy nájdete v kapitole Číselníky → Druhy športovej činnosti.

Qualification — licencie v čase

Kvalifikácia je napríklad trénerská licencia UEFA Pro, rozhodcovská licencia, športový lekár atestácia. Kvalifikácia je viazaná na osobu, nie na afiliáciu. Tréner s licenciou UEFA B si ju nesie so sebou aj keď zmení klub. Oprávnenie trénovať konkrétny tím je však kombináciou: Person + aktívna Qualification + aktívna Affiliation ako tréner.

Consent — súhlas a legal basis

Consent je samostatná entita, nie JSON pole niekde na Person. Modeluje sa granulárne: jeden záznam na účel × organizáciu alebo aplikáciu × osobu.

Detailný popis Purpose Catalogue nájdete v kapitole Účely spracovania.

Katalóg eventov pre Affiliation

Prestup — ako saga

Prestup športovca z klubu A do klubu B sa modeluje ako saga s tromi eventmi prepojenými cez correlation_id:

// 1) TransferRequested na novú (ešte neexistujúcu) afiliáciu
{
  "event_type": "TransferRequested",
  "aggregate_id": "affil-new-123",
  "correlation_id": "transfer-456",
  "data": {
    "person_id": "person-abc",
    "from_organization_id": "club-A",
    "to_organization_id": "club-B",
    "effective_date": "2026-07-01"
  }
}

// 2) AffiliationTerminated na pôvodnej afiliácii
{
  "event_type": "AffiliationTerminated",
  "aggregate_id": "affil-old-789",
  "correlation_id": "transfer-456",
  "data": { "reason": "transfer" }
}

// 3) AffiliationRegistered + AffiliationActivated na novej afiliácii
{
  "event_type": "AffiliationRegistered",
  "aggregate_id": "affil-new-123",
  "correlation_id": "transfer-456",
  "data": { /* nová afiliácia v klube B */ }
}

Okrem zachovania agregátových hraníc má saga dve praktické výhody. Po prvé, auditovateľnosť — dotaz typu "ukáž mi celý priebeh tohto prestupu" je filter nad event storom podľa jedného correlation_id. Po druhé, kompenzácia — ak sa v poslednom kroku niečo pokazí (napríklad zväz nová afiliáciu odmietne), systém vygeneruje kompenzačné eventy, ktoré obnovia pôvodný stav. Nevracia sa do minulosti rušením udalostí, ale zapíše ďalšie, ktoré pôvodný stav znovu nastolia — všetko ostáva v histórii.

Čo treba vyriešiť od začiatku

Nasledujúca kapitola — Číselníky a katalógy — obsahuje zoznam športov, druhov činnosti, typov organizácií a katalóg športovísk.