Scénář Creator

Scénář Creator — Dokumentace

Verze 4.3.0  |  Swagger API  |  Vzorový JSON

Jak začít

1. Nový scénář — klikněte na „Nový scénář" v záhlaví. Vytvoří se prázdný scénář pro dnešní den.
2. Import JSON — klikněte na „Import JSON" a vyberte dříve uložený .json soubor.
3. Vzorový JSON — stáhněte sample.json jako šablonu a importujte ho.

Nastavení akce (postranní panel)

• Název / Podtitul / Místo — zobrazí se v záhlaví PDF.
• Od / Do — rozsah dat akce. Každý den = jeden řádek v editoru. Jednodnevní kurz = stejné datum v obou polích.
• Typy programů — přidejte typ kliknutím na „+ Přidat typ", nastavte název a barvu. Každý blok patří k jednomu typu.

Práce s bloky

• Přidání: Klikněte na „+ Přidat blok" nebo klikněte na prázdné místo v řádku dne.
• Přidání do všech dnů: V modalu nového bloku zaškrtněte „Přidat do každého dne kurzu" — vytvoří identický blok pro každý den akce (sdílená série).
• Přesun v rámci dne: Chytněte blok a táhněte doleva/doprava. Snap na 15 minut.
• Přesun mezi dny: Táhněte blok nahoru/dolů — zvýrazní se cílový den (modrý rámeček). Pusťte na novém dni.
• Změna délky: Chytněte pravý okraj bloku a táhněte.
• Úprava: Klikněte na blok — otevře se formulář s editací jednoho bloku.
• Smazání jednoho bloku: V editačním formuláři klikněte na „Smazat jen tento".
• Smazání celé série: Pokud byl blok přidán jako součást série (zaškrtávací políčko), zobrazí se tlačítko „Smazat sérii" — smaže všechny bloky se stejným series_id.

Formulář bloku

• Den — výběr pouze z nastavených dní akce (ne volné datum).
• Začátek / Konec — čas HH:MM.
• Nebo trvání — zadáte hodiny a minuty → Konec se vypočítá. Funguje i opačně (zadáte Konec → trvání se aktualizuje).
• Program přes půlnoc — Konec < Začátek je validní (blok přechází přes půlnoc). V editoru označen „→", v PDF správně vykreslí.
• Garant — zobrazí se v bloku v editoru i v PDF (pod názvem bloku).
• Poznámka — nezobrazuje se v editoru, pouze v PDF jako horní index (¹ ²...) u názvu bloku. Všechny poznámky jsou vypsány na 2. stránce PDF.
• URL odkaz — volitelný. V PDF bude celý blok klikatelný a odkazuje na zadanou adresu.

Export / Import

• Export JSON — stáhne celý scénář jako .json soubor. Uložte pro pozdější editaci.
• Import JSON — načte dříve uložený .json soubor.
• Generovat PDF — vytvoří tisknutelný harmonogram:
  • Stránka 1: timetable (řádky = dny, sloupce = čas, barvy dle typů, legenda)
  • Stránka 2 (pokud jsou poznámky): výpis poznámek ke scénáři s čísly

Formát JSON

Pole	Typ	Popis
event.title	string	Název akce (povinné)
event.date_from	string	První den akce (YYYY-MM-DD)
event.date_to	string	Poslední den akce (YYYY-MM-DD)
event.subtitle	string?	Podtitul (nepovinné)
event.location	string?	Místo konání (nepovinné)
program_types[].id	string	Unikátní identifikátor typu
program_types[].name	string	Název typu (zobrazí se v legendě)
program_types[].color	string	Barva v hex formátu (#RRGGBB)
blocks[].id	string	Unikátní ID bloku (auto-generováno)
blocks[].date	string	Den bloku (YYYY-MM-DD)
blocks[].start	string	Čas začátku (HH:MM)
blocks[].end	string	Čas konce (HH:MM) — pokud end < start, jde přes půlnoc
blocks[].title	string	Název bloku (povinné)
blocks[].type_id	string	ID typu programu (musí existovat v program_types)
blocks[].responsible	string?	Garant — zobrazí se v editoru i PDF
blocks[].notes	string?	Poznámka — jen v PDF, jako horní index + stránka 2
blocks[].url	string?	URL odkaz — v PDF je celý blok klikatelný
blocks[].series_id	string?	Sdílené ID série — bloky přidané přes „Přidat do všech dnů" sdílejí toto ID

Tipy

• Scénář se neukládá automaticky — použijte Export JSON pro zálohování.
• Barvy typů se projeví okamžitě v editoru i v PDF.
• Pro tisk doporučujeme PDF v orientaci na šířku (A4 landscape).
• Pokud blok přechází přes půlnoc, vidíte ho s šipkou „→" — v PDF se zobrazí do konce dne.