Datové schéma a požadavky

Tato specifikace definuje povinnou XML strukturu pro vstup dat o událostech. Aby synchronizace s naší databází proběhla úspěšně, musí váš feed dodržovat zde uvedené datové typy a omezení.

1. Hlavní data události (kořen: `<event>`)

Následující tabulka popisuje prvky události na nejvyšší úrovni. Pole označená jako povinná jsou pro proces synchronizace bezpodmínečně nutná.

Prvek	Typ	Povinné	Popis
id	String	Ano	Vaše interní unikátní ID (max. 255 znaků).
title	String	Ano	Oficiální název události tak, jak se zobrazí na platformě.
description	Text	Ano	Plný popis. HTML tagy nejsou povolené. Pro zalomení řádku použijte `\n`.
language	String	Ano	Jazyk, ve kterém událost probíhá. Použijte ISO 639-1 kód (např. `cs`, `en`).
start_date	ISO8601	Ano	Plný UTC timestamp, nebo pouze datum u opakujících se událostí.
end_date	ISO8601	Ne	Důrazně doporučeno pro vícedenní festivaly.
copyright_acknowledged	Boolean	Ano	Potvrzení vlastnictví obsahových práv. Hodnota musí být `true`.
facebook_url	String	Ne	URL na oficiální Facebook událost nebo stránku.
duration	Number	Ne	Délka trvání události v minutách.
preview_url	String	Ano	URL adresa primárního obrázku (titulní obrázek / náhled).
banner_url	String	Ne	URL adresa banneru pro stránku s detailem události.
attachment_url	String	Ne	URL adresa souboru ke stažení (PDF, program atd.).
gallery	Array	Ne	Seznam dalších obrázků a videí.
location	Object	Ano	Fyzické místo konání a geografické souřadnice. (Viz část 2.1)
taxonomies	Object	Ano	Klasifikační štítky, kategorie a prvky přístupnosti. Viz příklad na konci stránky Taxonomie nebo celkovou ukázku XML feedu.
recurrence	Object	Ne	Konkrétní rozvrh pro události opakující se v určitém období. (Viz sekce 2.2)
nested_events	Array	Ne	Vnořené události propojené s hlavní nadřazenou událostí. (Viz sekce 2.3)
participants	Array	Ne	Seznam herců, řečníků nebo účinkujících (Viz sekce 2.4).
ticket	Object	Ne	Komerční stav a tvorba cen pro jedno vstupní místo. (Viz sekce 2.5)

2. Specifikace dílčích objektů

2.1 Detaily místa konání (`<location>`)

Každá událost musí být fyzicky lokalizovatelná, aby se zobrazila v mapách a ve vyhledávání podle polohy.

Prvek	Typ	Povinné	Popis
name	String	Ano	Veřejný název místa konání.
city	String	Ano	Slug města z oficiálního seznamu (např. `karlovy-vary`). Musí přesně odpovídat tvaru v `kebab-case`.
address	Text	Ne	Fyzická adresa (volitelné u akcí v terénu nebo v odlehlých lokalitách).
latitude	Real	Ano	Desetinná souřadnice (např. `50.2297`).
longitude	Real	Ano	Desetinná souřadnice (např. `12.8742`).

2.2 Opakování a rozvrh (`<recurrence>`)

Definuje týdenní otevírací dobu pro sezónní nebo opakující se výstavy.

Prvek	Typ	Povinné	Popis
name	Atribut (Enum)	Ano	Den v týdnu (např. `monday`, `tuesday`).
start	Atribut (Time)	Ano	Čas otevření ve 24hodinovém formátu (`HH:mm`).
end	Atribut (Time)	Ano	Čas zavření ve 24hodinovém formátu (`HH:mm`).

2.3 Hierarchie vnořených událostí (`<nested_event>`)

Umožňuje navázat více dílčích vystoupení na jednu zastřešující rodičovskou událost.

Prvek	Typ	Povinné	Popis
id	String	Ano	Unikátní ID vnořené události na straně poskytovatele.
title	String	Ano	Název konkrétního vystoupení nebo programu.
start_date	DateTime	Ano	Plný ISO 8601 timestamp s časovou zónou.
end_date	DateTime	Ano	Plný ISO 8601 timestamp s časovou zónou.
preview_url	String	Ne	URL adresa náhledového obrázku konkrétního vystoupení.
duration	Number	Ne	Délka trvání vnořené události v minutách (např. `90`).
location	String \| Object	Ne	Pokud String: název sálu nebo pódia. Pokud Object: kompletní detaily místa konání (stejná struktura jako v části 2.1).
ticket	Object	Ne	Komerční stav a tvorba cen pro konkrétní vnořenou událost (stejná struktura jako v části 2.5).

2.4 Účinkující (`<participants>`)

Tento blok umožňuje uvést klíčové osoby spojené s událostí (např. herecké obsazení, řečníky festivalu nebo hudební umělce).

Prvek	Typ	Povinné	Popis
id	String	Ano	Unikátní ID osoby na straně poskytovatele.
name	String	Ano	Plné jméno účinkujícího.
role	String	Ne	Role, ve které vystupuje (např. „Hlavní herec", „Moderátor", „DJ").
avatar	String	Ne	Veřejný přímý odkaz (HTTPS) na fotografii.
bio	Text	Ne	Krátký profesní životopis.

2.5 Vstupenky a dostupnost (`<ticket>`)

Systém podporuje jednu primární vstupenku na záznam události. Pokud existuje více cenových úrovní, uveďte cenu od.

Prvek	Typ	Povinné	Popis
status	Enum	Ano	Jedna z hodnot: `free`, `on_sale`, `sold_out`, `not_yet_available`.
sales_channel	Enum	Ne	Jedna z hodnot: `online`, `at_door`
price_min	String	Podmíněně	Nejnižší dostupná cena (např. `450`). Pokud je status nastaven na `free`, toto pole není povinné.
price_max	String	Ne	Nejvyšší dostupná cena (např. `1200`).
url	String	Ne	Přímý odkaz na externí stránku s prodejem vstupenek. Pokud je `status` nastaven na `free`, toto pole není povinné.

Datové schéma a požadavky

1. Hlavní data události (kořen: <event>)

2. Specifikace dílčích objektů

2.1 Detaily místa konání (<location>)

2.2 Opakování a rozvrh (<recurrence>)

2.3 Hierarchie vnořených událostí (<nested_event>)

2.4 Účinkující (<participants>)