Scenár Creator — Dokumentace
Verze 4.2 | Swagger API | Vzorový JSON
Jak začít
- Nový scénář — klikněte na „Nový scénář" v záhlaví. Vytvoří se prázdný scénář pro dnešní den.
- Import JSON — klikněte na „Import JSON" a vyberte dříve uložený .json soubor.
- 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řesun: Chytněte blok a táhněte doleva/doprava. Snap na 15 minut.
- Změna délky: Chytněte pravý okraj bloku a táhněte.
- Úprava: Klikněte na blok — otevře se formulář.
- Smazání: V editačním formuláři klikněte na „Smazat blok".
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.
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 |
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.