Ako to reálne vyzerá

Overenie/založenie osoby cez Identity Broker

Klubový portál pošle dáta dieťaťa do SportUp. Identity Broker pokusom o match s RFO zistí, že Tomáš existuje. Vráti stabilné interné person_id.

{
  "given_name": "Tomáš",
  "family_name": "Hudák",
  "date_of_birth": "2013-05-12",
  "gender": "male",
  "nationality": "SK",
  "national_id": "130512/XXXX"
}

// → 200 OK
{
  "person_id": "prs_8f2a4c1e-...",
  "verification_status": "verified_by_rfo",
  "is_minor": true,
  "matched": true
}

Registrácia zákonného zástupcu a spojenie

Ak otec ešte v systéme nie je, založí sa. Potom sa vytvorí vzťah osoba-zák.zástupca.

{
  "minor_person_id": "prs_8f2a4c1e-...",
  "guardian_person_id": "prs_c91b7d33-...",
  "relationship_type": "legal_parent",
  "valid_from": "2013-05-12"
}

Udelenie súhlasov

Otec udeľuje tri súhlasy: základnú registráciu (contract, nedá sa odvolať), marketingové použitie fotografií (consent, odvolateľné), a anonymizovaný výskum (consent).

[
  {
    "person_id": "prs_8f2a4c1e-...",
    "purpose_code": "REG-ATHLETE-001",
    "legal_basis": "contract",
    "granted_to_id": "org_tatran_snv",
    "granted_by": "prs_c91b7d33-..."
  },
  {
    "person_id": "prs_8f2a4c1e-...",
    "purpose_code": "MKT-IMAGE-001-MINOR",
    "legal_basis": "consent",
    "granted_to_id": "org_tatran_snv",
    "granted_by": "prs_c91b7d33-..."
  },
  {
    "person_id": "prs_8f2a4c1e-...",
    "purpose_code": "VYS-DEMOGRAPHIC-001",
    "legal_basis": "public_task",
    "granted_to_id": "org_nsc"
  }
]

Vytvorenie afiliácie

Klubový portál zapisuje novú afiliáciu. Systém vyprodukuje dva eventy: AffiliationRegistered (stav pending) a po validácii AffiliationActivated.

{
  "person_id": "prs_8f2a4c1e-...",
  "organization_id": "org_tatran_snv",
  "activity_code": "amatersky_sportovec",
  "legal_title": "bez_zmluvy",
  "sport_code": "SK-BAS",
  "discipline_code": "SK-BAS-5v5",
  "category_code": "SK-BAS-U13",
  "valid_from": "2026-09-01",
  "registration_number": "TAT-2026-0834"
}

// → 201 Created
{
  "affiliation_id": "aff_a4e7...",
  "status": "active",
  "events_generated": ["AffiliationRegistered", "AffiliationActivated"]
}

Zahájenie prestupu

HK Nitra iniciuje prestup cez svoj klubový portál. Vytvorí sa nová (zatiaľ neaktívna) afiliácia v stave pending_transfer s referenciou na zdrojovú afiliáciu.

{
  "source_affiliation_id": "aff_bb_kovac_2023",
  "target_organization_id": "org_hk_nitra",
  "target_activity_code": "profesionalny_sportovec",
  "effective_date": "2026-07-01",
  "contract_type": "zmluva_profi",
  "contract_duration_years": 2,
  "compensation_amount": 85000
}

// → generovaný event:
{
  "event_type": "TransferRequested",
  "aggregate_id": "aff_nit_kovac_2026",
  "correlation_id": "txn_transfer_c4f8...",
  "occurred_at": "2026-06-15T14:22:00Z"
}

Ukončenie pôvodnej afiliácie

K účinnému dátumu sa zdrojová afiliácia ukončí. Event nesie to isté correlation_id, aby bolo možné spätne rekonštruovať celú sagu.

{
  "event_type": "AffiliationTerminated",
  "aggregate_id": "aff_bb_kovac_2023",
  "correlation_id": "txn_transfer_c4f8...",
  "occurred_at": "2026-07-01T00:00:00Z",
  "data": {
    "reason": "transfer",
    "destination_organization_id": "org_hk_nitra"
  }
}

Aktivácia novej afiliácie

Nová afiliácia sa aktivuje k účinnému dátumu. Tretí event s rovnakým correlation_id uzatvára sagu.

{
  "event_type": "AffiliationActivated",
  "aggregate_id": "aff_nit_kovac_2026",
  "correlation_id": "txn_transfer_c4f8...",
  "occurred_at": "2026-07-01T00:00:00Z"
}

Osoba vyvolá overenie zo svojej aplikácie

V SportUp mobilnej aplikácii si osoba vygeneruje krátkodobý verifikačný token. Token obsahuje len referenciu na osobu a platnosť, žiadne osobné údaje.

{
  "token": "vft_2bc4e7f8a9...",
  "valid_until": "2026-04-20T10:30:00Z",
  "qr_url": "https://verify.sportup.sk/vft_2bc4e7f8a9..."
}

Hotel overí token v certifikovanej aplikácii

Recepcia naskenuje QR kód zo zariadenia hosťa. Komerčný subjekt je certifikovaný pre scope verification:athlete_discount.

{
  "token": "vft_2bc4e7f8a9...",
  "purpose": "KOM-BENEFIT-001",
  "requested_attributes": ["has_active_athlete_affiliation"]
}

// → 200 OK
{
  "valid": true,
  "has_active_athlete_affiliation": true,
  "category_tier": "registered"
}

Notifikácia z CSRÚ do Identity Brokera

Štátny register notifikuje systém o úmrtí osoby. Broker aktualizuje lokálny cache a vyprodukuje interný event.

{
  "event_type": "PersonDeathRecorded",
  "aggregate_id": "prs_zamecnik_...",
  "occurred_at": "2026-03-18T00:00:00Z",
  "data": {
    "date_of_death": "2026-03-18",
    "source": "csru_notification"
  }
}

Automatická terminácia afiliácií

Systém vyhľadá všetky aktívne afiliácie osoby a pre každú vyprodukuje AffiliationTerminated event s dôvodom death.

[
  {
    "event_type": "AffiliationTerminated",
    "aggregate_id": "aff_sfz_rozhodca_...",
    "data": { "reason": "death", "effective_date": "2026-03-18" }
  },
  {
    "event_type": "AffiliationTerminated",
    "aggregate_id": "aff_fk_funkcionar_...",
    "data": { "reason": "death", "effective_date": "2026-03-18" }
  }
]

Ochrana citlivých údajov

GDPR sa po úmrtí neuplatňuje v plnom rozsahu, ale systém automaticky obmedzí prístup k citlivým údajom. Základné údaje sa zachovávajú pre historickú a štatistickú hodnotu — inak by sa rozbili dlhé časové rady (napr. zoznam majstrov SR za posledných 50 rokov).

Registrácia vlastníka a prevádzkovateľa

Vlastník je mesto Žilina (organizácia typu mesto, RPO previazané). Prevádzkovateľ je mestská príspevková organizácia.

Registrácia športoviska

{
  "name_sk": "Mestská športová hala Žilina-Vlčince",
  "facility_type": "ruznopouzitelna_hala",
  "supported_sports": ["SK-VLB", "SK-BAS", "SK-HDB", "SK-FLB"],
  "owner_organization_id": "org_mesto_zilina",
  "operator_organization_id": "org_msh_zilina_po",
  "address": {
    "street": "Obežná 16",
    "municipality_code": "SK-ZA-514301",
    "region_code": "SK-ZA",
    "postal_code": "01008",
    "gps": { "lat": 49.2175, "lng": 18.7492 }
  },
  "capacity_spectators": 1800,
  "surfaces": [
    { "type": "sport_parquet", "indoor": true, "dimensions_m": "44 × 25" }
  ],
  "accessibility": {
    "wheelchair": true,
    "hearing_loop": true,
    "parking_disabled": true
  },
  "public_access": "reservation",
  "certifications": ["STN-EN-14904", "hygienicky_posudok_2026"],
  "amenities": ["parking", "changing_rooms", "showers", "cafeteria", "medical", "wifi"],
  "tourism": {
    "nearby_accommodation": true,
    "public_transport_stop_m": 120,
    "parking_spaces": 95,
    "ev_charging": true,
    "bike_parking": true
  },
  "valid_from": "2026-04-15"
}

// → 201 Created
{
  "facility_id": "fac_za_vlcince_...",
  "status": "operational",
  "public_data_url": "https://data.sportup.sk/facilities/fac_za_vlcince_..."
}

Následné okamžité použitie

Len čo je športovisko zapísané a má stav operational, automaticky:

• Je viditeľné na verejnej mape SportUp a je dostupné cez otvorené API.
• Turistické platformy (visitslovakia.com, GoZilina) ho môžu zobraziť.
• Rezervačné systémy môžu na ňom ponúkať termíny.
• Zväzy (SBA, SHF, SZH) ho môžu priraďovať k ligovým zápasom.
• Obec má základný podklad pre výročné hlásenie o športovej infraštruktúre.
• Mestský magistrát môže vypisovať verejné obstarávanie na údržbu s presným popisom objektu.

Registrácia hobby aktivity (bez osôb)

Aktivita sa zapíše s participant_data: aggregate_only — systém nečaká žiadne person_id.

{
  "activity_type": "hobby",
  "organization_scope": "unorganized",
  "sport_code": "SK-ATH",
  "reported_by_organization_id": "org_mesto_presov",
  "participant_data": "aggregate_only"
}

// → 201 Created
{
  "activity_id": "act_po_park_run_...",
  "personal_data_stored": false
}

Nahlásenie agregátneho počtu (bez identít)

Po každom stretnutí sa nahlási len počet — žiadne mená, žiadne person_id.

{
  "occurred_on": "2026-05-17",
  "estimated_participants": 34,
  "age_bands": { "under_18": 4, "18_39": 18, "40_59": 9, "60_plus": 3 }
}

Odoslanie dávky

Certifikovaná aplikácia akadémie pošle dávku s Idempotency-Key. Rôzne role, maloletý s guardian údajmi.

{
  "organization_id": "org_fa_zilina",
  "default_sport_code": "SK-FBL",
  "records": [
    { "row_ref": "1", "given_name": "Adam", "role_code": "amatersky_sportovec", "discipline_code": "SK-FBL-FUTBAL", "guardian": { /* zákonný zástupca */ } },
    { "row_ref": "2", "given_name": "Marek", "role_code": "trener" },
    { "row_ref": "3", "given_name": "Jana", "role_code": "fyzioterapeut" },
    { "row_ref": "4", "given_name": "Ivan", "role_code": "technicky_veduci" }
  ]
}

Výsledok — čiastočný úspech

Tri riadky prešli, jeden (technický vedúci bez rodného čísla) sa odmietol. Dávka nezlyhala ako celok.

{
  "status": "completed_with_errors",
  "summary": { "total": 4, "succeeded": 3, "failed": 1 },
  "results": [
    { "row_ref": "1", "status": "created" },
    { "row_ref": "2", "status": "matched_existing" },
    { "row_ref": "3", "status": "created" },
    { "row_ref": "4", "status": "rejected", "error_code": "missing_national_id" }
  ]
}

TIC číta verejný katalóg športovísk

Certifikovaná turistická aplikácia so scope read:public_facilities.

{
  "facilities": [{
    "facility_id": "fac_tatry_trail_...",
    "name_sk": "Tatranský bežecký okruh Štrbské Pleso",
    "public_access": "free",
    "tourism": { "nearby_accommodation": true, "difficulty": "medium" },
    "purpose": "TUR-KATALOG-001"
  }]
}

Kalendár verejných podujatí

Kalendár obsahuje verejné podujatia — žiadne osobné údaje účastníkov.

{
  "events": [{
    "name_sk": "Tatry Ultra Trail 2026",
    "public": true,
    "purpose": "TUR-PODUJATIE-001",
    "data_form": "public_no_participant_pii"
  }]
}

Posudok voči účelom

Erasure Coordinator prejde všetky dáta osoby a pre každý účel rozhodne podľa legal_basis a retention.

{
  "erasable": [
    "MKT-FOTO-001", "MKT-NEWSLETTER-001", "REG-DOBROVOLNIK-001"
  ],
  "retained": [
    { "purpose": "DIS-KONANIE-001", "reason": "active_legal_proceeding" },
    { "purpose": "FIN-DOTACIA-001", "reason": "legal_retention_10y" }
  ]
}

Crypto-shredding a anonymizácia

Osobné údaje v eventoch sú šifrované per-person kľúčom — výmaz zničí kľúč. Eventy zostanú (nemenná história), osobné dáta v nich sú nečitateľné. Historické výkony sa anonymizujú.

{
  "deleted_scopes": ["contact", "photo", "marketing_preferences"],
  "method": "crypto_shredding",
  "anonymized_scopes": ["historical_results"]
}

Kontrola safeguarding certifikátu

Pred vytvorením afiliácie s prístupom k maloletým policy engine overí kvalifikáciu.

{
  "qualifications": [{
    "type": "KVL-SAFEGUARDING-001",
    "valid_to": "2026-05-01",
    "status": "valid"
  }]
}

Vytvorenie afiliácie viazanej na aktivitu

Afiliácia sa aktivuje len ak je safeguarding platný. Inak zôstane v stave pending_safeguarding.

{
  "person_id": "prs_zuzana_...",
  "organization_id": "org_mesto_trnava",
  "role_code": "dobrovolnik",
  "works_with_minors": true,
  "safeguarding_qualification_id": "qual_sg_..."
}

// → 201 Created (Prípad A)
{ "status": "active", "safeguarding_verified": true }