# Kalendář a seznam rezervací, popis všech polí

Kalendář rezervací, rychlý a ruční zápis, opakování, přesun, detail rezervace, filtry seznamu, hromadné akce a export plateb.

## Kde to je

V panelu v nabídce otevřete Rezervace (adresa `/Admin/Dashboard`), to je kalendář, a Seznam rezervací (adresa `/Admin/SeznamRezervaci`). Detail rezervace se otevře kliknutím na rezervaci v kalendáři nebo na řádek seznamu. Zaměstnanec vidí obě stránky, ale jen rezervace, které smí vidět (viz soubor Zaměstnanci a pracoviště).

## K čemu stránka slouží

Kalendář ukazuje rezervace, dny volna a skupinové akce, a umožňuje je zapisovat, přesouvat a rušit. Seznam rezervací je tabulka za zvolené období s filtry a hromadnými akcemi. Obě stránky sdílejí stejné okno detailu rezervace.

## Pole stránky Kalendář

Kalendář se otevírá v pohledu Týden (na úzké obrazovce pod 768 pixelů v pohledu Den). Pohled přepínají tlačítka Seznam, Den, Týden a Měsíc, vlevo jsou šipky a tlačítko Dnes. Zvolený pohled si prohlížeč pamatuje. První den týdne je pondělí. Rozsah hodin v mřížce se řídí otevírací dobou provozovny. Barva rezervace vychází ze služby, zrušené, odmítnuté, vypršelé a rezervace se stavem Nepřišel jsou přeškrtnuté a zprůhledněné.

### Krok:

- **Co dělá:** Řádek tlačítek 5, 10, 15, 30 a Volně. Určuje, na kolik minut se přichytává čas při tažení a roztahování rezervací, při výběru v kalendáři a při posunu času šipkami v oknech zápisu.
- **Výchozí hodnota:** 15 minut.
- **Povolené hodnoty:** 5, 10, 15, 30 minut, nebo Volně (bez přichytávání, krok jedné minuty).
- **Platí pro:** všechny typy rezervací.
- **Na co má vliv:** Jen pohodlí zadávání času. Volba se pamatuje v prohlížeči, ne v účtu. Nemění nabídku termínů pro zákazníka.

### Skrýt zrušené

- **Co dělá:** Přepíná zobrazení zrušených a vypršelých rezervací v kalendáři. Po stisku se text tlačítka změní na opak.
- **Výchozí hodnota:** Zrušené rezervace se zobrazují (přeškrtnuté).
- **Povolené hodnoty:** Tlačítko přepínače.
- **Platí pro:** všechny typy.
- **Na co má vliv:** Jen zobrazení v kalendáři. Nic se nemaže.

### Zaměstnanec

- **Co dělá:** Filtr kalendáře podle zaměstnance (v kalendáři se popisek jmenuje Zaměstnanec s dvojtečkou). Vybraný zaměstnanec má zeleně podbarvené časy, kdy přijímá rezervace. Zaměstnanec se stejným popiskem je řádek v detailu rezervace s přiřazenou osobou.
- **Výchozí hodnota:** Všichni.
- **Povolené hodnoty:** Všichni, nebo jeden ze zaměstnanců. Pole je vidět jen tehdy, když účet zaměstnance má.
- **Platí pro:** tarif Pro+ s režimem zaměstnanců.
- **Na co má vliv:** V kalendáři se po výběru skryjí rezervace jiných osob i rezervace bez zaměstnance. Přihlášený zaměstnanec filtr nemá a vidí zeleně vlastní dostupnost. Zelená značí časy, kdy zaměstnanec přijímá rezervace.

### Vytvořit rezervaci

- **Co dělá:** Otevře okno s vaším zákaznickým rezervačním formulářem, ve kterém rezervaci vytvoříte stejně jako zákazník.
- **Výchozí hodnota:** Bez účinku.
- **Povolené hodnoty:** Tlačítko.
- **Platí pro:** všechny typy.
- **Na co má vliv:** Rezervace vzniklá tímto formulářem se řídí stejnými pravidly jako zákaznická: nabídka termínů, potvrzení, schvalování a platba předem. Je to rozdíl proti Manuální rezervace. Zda se zákazník i tady potvrzuje e-mailem, neověřeno.

### Manuální rezervace

- **Co dělá:** Otevře okno Přidat rezervaci pro zápis rezervace provozovatelem.
- **Výchozí hodnota:** Bez účinku.
- **Povolené hodnoty:** Tlačítko. Pole okna jsou popsaná níže.
- **Platí pro:** všechny typy.
- **Na co má vliv:** Ruční zápis je vždy potvrzený a nevyžaduje platbu předem. Termín může být mimo otevírací dobu a může kolidovat s jinou rezervací, ruční zápis kolizi neblokuje. Blokovaný zákazník je odmítnut. Zákazník s e-mailem dostane potvrzení.

### Najít rezervaci podle VS

- **Co dělá:** Najde rezervaci podle variabilního symbolu platby předem. Slouží k dohledání platby z bankovnictví. Odesílá se tlačítkem Hledat.
- **Výchozí hodnota:** Prázdné.
- **Povolené hodnoty:** Jen číslice, nejvýše 10.
- **Platí pro:** rezervace s platbou předem.
- **Na co má vliv:** Při nalezení otevře detail rezervace, při nenalezení se zobrazí „Rezervace s tímto variabilním symbolem nenalezena.“

### Rychlý zápis a výběr v kalendáři

Kliknutí do prázdného místa v týdenním nebo denním pohledu nebo tažení přes časy otevře malé okno rychlého zápisu. V měsíčním pohledu klik na den přepne na pohled Den. Krátký klik použije délku vybrané služby, tažení určí konec samo. Okno má pole Zákazník (jméno, telefon nebo e-mail, našeptává existující zákazníky), výběr služby, čas se šipkami o jeden krok dopředu a dozadu, nepovinný E-mail a Poznámku a tlačítka Zrušit a Uložit. Rychlý zápis nevyžaduje e-mail.

### Přesun a změna délky

Rezervaci v kalendáři chytnete myší a přetáhnete na jiný čas, nebo roztáhnete její konec. Změna se uloží hned a zobrazí se potvrzení „Přesunuto na ...“. Přesun z panelu neblokuje obsazený čas, rezervace se smí přesunout i na čas, který je už obsazený, stejně jako se tak dá ručně zapsat. Zákazník dostane e-mail Změna termínu rezervace. Chování při kolizi, kterou by přesto server odmítl (hláška „Koliduje s jinou rezervací“), neověřeno. Rezervace ve stavu Dokončeno, Zrušeno, Odmítnuto a Vypršelo se přesouvat nedá.

## Okno Přidat rezervaci

### Zákazník

- **Co dělá:** Pole pro zákazníka. Píše se jméno, telefon nebo e-mail, aplikace nabízí existující zákazníky.
- **Výchozí hodnota:** Prázdné, povinné.
- **Povolené hodnoty:** Zákazník musí mít vyplněné aspoň jedno z trojice jméno, telefon, e-mail. Jinak se zobrazí „Vyplňte povinné údaje (jméno, telefon nebo e-mail, službu, datum a čas).“
- **Platí pro:** všechny typy.
- **Na co má vliv:** Kdo je zákazník v seznamu a v e-mailech. Nový zákazník se založí sám.

### E-mail (nepovinný)

- **Co dělá:** E-mail zákazníka pro zprávy o rezervaci.
- **Výchozí hodnota:** Prázdné.
- **Povolené hodnoty:** E-mail nebo prázdné. E-mail už není povinný.
- **Platí pro:** všechny typy.
- **Na co má vliv:** Bez e-mailu zákazník žádné zprávy nedostane a nelze ho blokovat.

### Služba

- **Co dělá:** Výběr služby. V okně se nabízejí aktivní služby. Stejný popisek je filtr služby v seznamu rezervací.
- **Výchozí hodnota:** „vyberte službu“, povinné.
- **Povolené hodnoty:** Jedna z aktivních služeb. V seznamu rezervací se nabízejí všechny služby včetně neaktivních (označených „neaktivní“) a pole je vidět jen, když služeb je víc než jedna.
- **Platí pro:** všechny typy.
- **Na co má vliv:** Délka a cena rezervace.

### Datum a čas

- **Co dělá:** Začátek rezervace s tlačítky šipek pro posun o jeden krok. Stejný popisek je v detailu rezervace.
- **Výchozí hodnota:** Podle kliknutí v kalendáři, jinak prázdné, povinné.
- **Povolené hodnoty:** Datum a čas, krok podle voleb Krok. Neplatný formát vrátí „Neplatný formát data a času.“
- **Platí pro:** všechny typy.
- **Na co má vliv:** Termín rezervace. Konec se dopočítá z délky služby, pokud nezadáte pole Konec.

### Konec

- **Co dělá:** Volitelný konec rezervace, když má být jiný než podle délky služby.
- **Výchozí hodnota:** Prázdné, konec se dopočítá.
- **Povolené hodnoty:** Datum a čas po začátku.
- **Platí pro:** všechny typy.
- **Na co má vliv:** Délka rezervace. Neověřeno mimo povolený rozsah délky služby.

### Opakovat každý týden

- **Co dělá:** Zapne týdenní opakování. Vytvoří sérii stejných rezervací ve stejný den a čas.
- **Výchozí hodnota:** Nezaškrtnuto.
- **Povolené hodnoty:** Zaškrtnuto, nezaškrtnuto. Série má nejvýše 52 týdnů.
- **Platí pro:** všechny typy.
- **Na co má vliv:** Po zaškrtnutí se objeví pole Opakovat do. Série je rovnou potvrzená. Jeden e-mail za celou sérii (šablona Opakovaná rezervace potvrzena) obsahuje seznam všech termínů s odkazy na zrušení, když je zrušení zákazníkem povoleno. Kolize kteréhokoli termínu série zruší vytvoření všech termínů a chyba vyjmenuje kolidující dny.

### Opakovat do

- **Co dělá:** Poslední den opakování, včetně.
- **Výchozí hodnota:** Prázdné, povinné při zapnutém opakování.
- **Povolené hodnoty:** Datum shodné s dnem začátku nebo pozdější, nejvýše 52 týdnů. Chybí-li, vypíše se „Zadejte datum, do kdy se má rezervace opakovat.“ Přes 52 týdnů se vypíše „Opakování lze zadat nejdéle na 52 týdnů.“
- **Platí pro:** opakovanou rezervaci.
- **Na co má vliv:** Počet termínů série.

### Počet osob

- **Co dělá:** Počet osob rezervace.
- **Výchozí hodnota:** 1.
- **Povolené hodnoty:** Celé číslo od 1.
- **Platí pro:** služby, kde se počet osob vybírá.
- **Na co má vliv:** Kapacita a cena. U služeb bez výběru osob se v detailu rezervace pole skrývá.

### Poznámka

- **Co dělá:** Poznámka k rezervaci.
- **Výchozí hodnota:** Prázdné.
- **Povolené hodnoty:** Volný text.
- **Platí pro:** všechny typy.
- **Na co má vliv:** Zobrazení v detailu rezervace. Jestli se poznámka zapsaná v panelu dostane do e-mailu zákazníkovi, neověřeno.

### Veřejný popisek

- **Co dělá:** Krátký text, který se ve veřejném přehledu obsazenosti ukáže místo slova Obsazeno, například Tenis MZ.
- **Výchozí hodnota:** Prázdné. Pole je vidět jen při zapnutém veřejném přehledu obsazenosti.
- **Povolené hodnoty:** Text do 40 znaků.
- **Platí pro:** rezervace s veřejným přehledem obsazenosti.
- **Na co má vliv:** Text uvidí kdokoli na vašem webu.

## Detail rezervace

Detail se otevře kliknutím na rezervaci. Nahoře ukazuje souhrn (zákazník, služba, termín, stav, cena, platba, kód k zámku, když existuje). Pod ním je formulář pro úpravu, který se zobrazí, jen když je rezervace Čeká, Potvrzeno, Čeká na schválení nebo Nepřišel (nezobrazí se pro Dokončeno, Zrušeno, Odmítnuto a Vypršelo). V úpravě lze změnit službu, začátek, počet osob, poznámku a veřejný popisek tlačítkem Uložit změny. Zákazník dostane e-mail Změna termínu rezervace, když změníte termín.

Tlačítka podle stavu rezervace:

- Potvrdit a Odmítnout: stav Čeká nebo Čeká na schválení. U rezervace s platbou předem se jmenují Platba přijata – potvrdit a Platba nedorazila – uvolnit termín. Tlačítka se neukáží zaměstnanci bez role Admin u rezervace s platbou.
- Zrušit: stav Čeká, Potvrzeno a Čeká na schválení. U opakované rezervace se jmenuje Zrušit jen tento termín a přibývá Zrušit tento a všechny další. Zrušení série nepošle zákazníkovi e-mail.
- Nepřišel: stav Potvrzeno a Dokončeno.
- Vrátit na Potvrzeno: jen stav Nepřišel. Selže, když je čas mezitím obsazený.
- Obnovit rezervaci: jen stav Zrušeno. Systém ověří dostupnost termínu, při kolizi odmítne.
- Smazat rezervaci: stav Zrušeno nebo Vypršelo. Smazání je trvalé a odebere i případný kód k zámku.
- Rozbalovací nabídka s předpřipravenými e-maily Zrušení rezervace, Přeložení rezervace a Žádost o potvrzení. Otevřou se ve vašem poštovním programu, aplikace je neodesílá. Znovu odeslání kódu k zámku u rezervací se zámkem: neověřeno.

Zrušení otevře okno s polem Důvod zrušení (výběr uložené omluvy nebo volný text, nejvýše 500 znaků). Zákazník dostane e-mail Rezervace zrušena, s důvodem, pokud je zadán. Zaškrtnutím Uložit tuto omluvu pro příště se text uloží jako šablona omluvy. To smí jen majitel, zaměstnanec omluvy ukládat nesmí.

## Pole stránky Seznam rezervací

Seznam ukazuje rezervace za zvolené období. Výchozí je kalendářní měsíc, ve kterém jste. Měsíc listují šipky vedle názvu měsíce a odkazy Tento měsíc, Příští měsíc a Příští 3 měsíce. Pruh Ke schválení čeká s odkazy na měsíce se objeví, když něco čeká na schválení. Na stránce je nejvýše 500 řádků, při překročení se zobrazí „Zobrazeno prvních 500 rezervací. Zužte filtr.“

### Od

- **Co dělá:** První den období seznamu.
- **Výchozí hodnota:** První den aktuálního měsíce.
- **Povolené hodnoty:** Datum. Po zadání obou dat se použije tlačítko Použít.
- **Platí pro:** všechny rezervace.
- **Na co má vliv:** Které rezervace seznam ukazuje. Neplatné nebo chybějící datum vrátí upozornění „Vyplňte platné datum Od a Do.“ a neplatné období upozornění, že období není platné.

### Do

- **Co dělá:** Poslední den období seznamu, včetně.
- **Výchozí hodnota:** Poslední den aktuálního měsíce.
- **Povolené hodnoty:** Datum, nejdříve shodné s Od. Celé období smí mít nejvýše 12 měsíců („Období může být nejvýše 12 měsíců.“).
- **Platí pro:** všechny rezervace.
- **Na co má vliv:** Stejné jako u pole Od, určuje i období exportu plateb.

### Stav

- **Co dělá:** Rozbalovací výběr stavů rezervace, zaškrtávací políčko u každého. Zaškrtnout lze libovolný počet.
- **Výchozí hodnota:** Nic nezaškrtnuto, popisek Všechny stavy.
- **Povolené hodnoty:** Čeká na potvrzení, Čeká na schválení, Čeká na platbu, Potvrzeno, Dokončeno, Zrušeno, Odmítnuto, Vypršelo, Nepřišel. Každý stav má v seznamu vlastní zaškrtávací políčko, jeho popisek se vykresluje z kódu. Stav Čeká na zálohu v seznamu jako volba není.
- **Platí pro:** všechny rezervace.
- **Na co má vliv:** Které řádky se ukážou. Neznámý kód v adrese se ignoruje s upozorněním.

### Pole hledání zákazníka nebo VS

- **Co dělá:** Pole pro hledání zákazníka nebo variabilního symbolu. Po výběru zákazníka se objeví štítek se jménem, který zrušíte křížkem.
- **Výchozí hodnota:** Prázdné.
- **Povolené hodnoty:** Část jména nebo e-mailu, nebo číslice variabilního symbolu.
- **Platí pro:** všechny rezervace.
- **Na co má vliv:** Při variabilním symbolu seznam ignoruje období a ukáže rezervaci s tímto symbolem, hlavička pak ukazuje „Hledáno podle VS“.

### Služba

- **Co dělá:** Filtr podle služby. Pole je vidět jen když má účet víc než jednu službu.
- **Výchozí hodnota:** Všechny služby.
- **Povolené hodnoty:** Jedna ze služeb, i neaktivní (označená).
- **Platí pro:** všechny rezervace.
- **Na co má vliv:** Které řádky se ukážou. Nečíselná hodnota v adrese se ignoruje s upozorněním.

### Platba

- **Co dělá:** Filtr podle stavu platby předem.
- **Výchozí hodnota:** Vše.
- **Povolené hodnoty:** Vše, Čeká na platbu, Zaplaceno.
- **Platí pro:** tarif Pro+ a majitele nebo zaměstnance s rolí Admin. Jinak se pole nezobrazí a hodnota v adrese se ignoruje s upozorněním.
- **Na co má vliv:** Které řádky se ukážou. Vedle pole je odkaz Exportovat platby (CSV).

### Použít

- **Co dělá:** Tlačítko, které uplatní zvolená období a filtry.
- **Výchozí hodnota:** Bez účinku.
- **Povolené hodnoty:** Tlačítko.
- **Platí pro:** všechny rezervace.
- **Na co má vliv:** Načtení seznamu. Odkaz Zrušit filtry vrací výchozí stav.

### Exportovat platby (CSV)

- **Co dělá:** Stáhne soubor CSV s očekávanými platbami za zvolené období a filtry.
- **Výchozí hodnota:** Odkaz se zobrazí jen v podmínkách pole Platba.
- **Povolené hodnoty:** Odkaz.
- **Platí pro:** tarif Pro+, majitel a zaměstnanec s rolí Admin.
- **Na co má vliv:** Soubor obsahuje jen rezervace s platbou předem, v UTF-8 s BOM, jméno `ocekavane-platby-RRRR-MM.csv`. Ostatní uživatelé dostanou chybu 403.

### Tabulka a hromadné akce

Tabulka má sloupce Datum a čas, Služba, Zákazník, Stav, a podle dat Pracoviště / osoba a sloupec platby předem (částka, variabilní symbol a stav Zaplaceno s datem nebo Čeká na platbu). Na úzké obrazovce jsou místo tabulky karty. Kliknutí na řádek otevře detail. Zaškrtávací políčko u řádku a políčko Vybrat vše zobrazené v hlavičce vybírají rezervace pro hromadnou akci. Po výběru se objeví lišta Vybráno s tlačítky Potvrdit, Odmítnout a Zrušit. Potvrdit a Odmítnout se potvrzují dotazem, Zrušit se ptá na Důvod zrušení (nepovinný, nejvýše 500 znaků, platí pro všechny vybrané, zákazníkům se posílá e-mailem). Najednou lze zpracovat nejvýše 200 rezervací. Každou rezervaci systém zpracuje samostatně stejným pravidlem jako v detailu. Výsledek ukazuje souhrn typu „Potvrzeno 9“ a odkaz Zobrazit přeskočené s důvodem u každé přeskočené. Hromadné mazání neexistuje. Potvrdit nebo odmítnout rezervaci s platbou smí jen majitel a zaměstnanec s rolí Admin.

## Jak spolu pole souvisí

- Krok kalendáře platí v kalendáři i v oknech zápisu, ale mění jen zadávání, ne nabídku zákazníkovi.
- Zápis ve formuláři Vytvořit rezervaci se řídí pravidly zákazníka, zápis přes Manuální rezervace nebo rychlý zápis je rovnou potvrzený a kolize neblokuje.
- Přesun i úprava termínu z panelu kolizi neblokují, ale u série při zápisu kolize vyhodí chybu a nic se nevytvoří.
- Stav v seznamu a filtr Stav souvisí s přechody popsanými v souboru Stavy rezervace.
- Filtr Platba, sloupec platby a export fungují jen s platbou předem a tarifem Pro+. Podrobnosti jsou v souboru Platba předem.

## Příklady nastavení

**Rychlý zápis z telefonu.** Zákazník volá. Klikněte v kalendáři na požadovaný čas, vyberte službu, napište jméno a telefon a stiskněte Uložit. Rezervace je potvrzená.

**Týdenní trénink.** V Manuální rezervaci vyplňte zákazníka, službu a čas prvního termínu, zaškrtněte Opakovat každý týden a nastavte Opakovat do na konec sezóny. Vznikne série a zákazník dostane jeden e-mail se všemi termíny.

**Hromadné schválení.** V Seznamu rezervací zvolte Stav Čeká na schválení, zaškrtněte Vybrat vše zobrazené a stiskněte Potvrdit. Rezervace s neuhrazenou platbou předem, které nesmíte potvrdit, systém přeskočí nebo celou akci odmítne podle vaší role.

## Technická poznámka

Informace jsou převzaté ze zdrojového kódu (`Dashboard.cshtml(.cs)`, `SeznamRezervaci.cshtml(.cs)`, `_AddBookingModal.cshtml`, `_QuickBookingPopover.cshtml`, `_BookingDetailModal.cshtml`, `AdminBookingsController.cs`, `BookingService.cs`, `BookingListPeriod.cs`, `BookingStatusLabels.cs`). Kde chování nebylo možné ověřit, je to napsáno výslovně slovem Neověřeno.

Verze nápovědy: 1.0.2.74, 2026-11-22
