# Zákazníci, popis všech polí

Seznam zákazníků a jejich detail: hledání, kontakt, výjimka ze zálohy, interní poznámka, štítky, blokace a zákazník bez e-mailu.

## Kde to je

V panelu v nabídce otevřete Zákazníci (adresa `/Admin/Customers`). Detail zákazníka se otevře kliknutím na jeho jméno v seznamu (adresa `/Admin/Customers/{číslo}`) nebo položkou Detail v nabídce Akce. Stránky jsou jen pro majitele, zaměstnanec je v panelu nevidí.

## K čemu stránka slouží

Seznam zákazníků vzniká sám z rezervací. Zákazník se v něm objeví po první rezervaci, ať ji vytvořil on ve formuláři, nebo vy v panelu. V detailu upravujete jeho kontakt, určujete výjimku z platby předem, píšete si interní poznámku, přiřazujete štítky, blokujete ho a vidíte historii jeho rezervací.

## Pole stránky Zákazníci

### Hledat podle jména nebo e-mailu

- **Co dělá:** Filtruje seznam zákazníků podle části jména nebo e-mailu. Spouští se tlačítkem Hledat, filtr zruší odkaz Zrušit filtr.
- **Výchozí hodnota:** Prázdné, seznam ukazuje všechny zákazníky.
- **Povolené hodnoty:** Libovolný text, hledá se část jména nebo e-mailu bez ohledu na velikost písmen. Hledání podle telefonu tu neexistuje.
- **Platí pro:** všechny typy rezervací.
- **Na co má vliv:** Jen seznam. Když nikdo neodpovídá, zobrazí se „Žádný zákazník neodpovídá hledání“. U prázdného seznamu bez filtru se zobrazí „Zatím nemáte žádné zákazníky“.

### Hledat

- **Co dělá:** Tlačítko, které spustí hledání podle pole Hledat podle jména nebo e-mailu.
- **Výchozí hodnota:** Bez účinku, dokud se nestiskne.
- **Povolené hodnoty:** Tlačítko.
- **Platí pro:** všechny typy.
- **Na co má vliv:** Seznam a stránkování.

Seznam ukazuje sloupce Jméno / E-mail (u zákazníka bez e-mailu štítek „bez e-mailu“), Telefon, Návštěvy, Celková útrata a Poslední návštěva. Řadí se podle poslední návštěvy sestupně, pak podle data vzniku. Na stránce je 50 zákazníků, pod seznamem je stránkování a celkový počet. Návštěva je jen proběhlá rezervace, budoucí termín se nepočítá. Zrušené, odmítnuté, vypršelé a rezervace se stavem Nepřišel se do návštěv ani do útraty nepočítají. Celková útrata je součet cen proběhlých potvrzených nebo dokončených rezervací v době jejich vytvoření (když cena chybí, použije se cena služby). Zákazník s jen zrušenými rezervacemi zůstává v seznamu s nulami. U každého zákazníka je nabídka Akce s položkami Detail a Nová rezervace (otevře okno pro ruční zápis s předvyplněným zákazníkem, popis polí je v souboru Kalendář a seznam rezervací).

## Pole detailu zákazníka

### Jméno

- **Co dělá:** Jméno zákazníka, jak ho vidíte v seznamu, v kalendáři a v e-mailech.
- **Výchozí hodnota:** Podle rezervace, ze které zákazník vznikl, nebo prázdné.
- **Povolené hodnoty:** Text do 100 znaků. Jméno není povinné, ale zákazník musí mít vyplněné aspoň jedno z trojice jméno, e-mail, telefon. Jinak stránka vrátí „Zákazník musí mít vyplněné alespoň jedno z: jméno, e-mail nebo telefon.“
- **Platí pro:** všechny typy.
- **Na co má vliv:** Zobrazení zákazníka v celém panelu. Rezervační formulář jméno nevyžaduje, proto může být prázdné.

### Doplnit e-mail

- **Co dělá:** Popisek pole e-mailu u zákazníka, který e-mail nemá (zákazník zapsaný v panelu jen jménem nebo telefonem). Pole se pak ještě označuje „bez e-mailu“.
- **Výchozí hodnota:** Prázdné.
- **Povolené hodnoty:** Platný e-mail nejvýše 200 znaků. Neplatný tvar vrátí „Neplatný formát e-mailu.“ Chyby jsou „E-mail může mít nejvýše 200 znaků.“
- **Platí pro:** všechny typy.
- **Na co má vliv:** Po doplnění e-mailu dostává zákazník zprávy o rezervacích. Dřívější rezervace se zpětně nic neposílá, neověřeno.

### E-mail

- **Co dělá:** Popisek téhož pole, když zákazník e-mail má.
- **Výchozí hodnota:** E-mail z první rezervace zákazníka.
- **Povolené hodnoty:** Stejné jako u pole Doplnit e-mail. Chyba při uložení (například adresa, kterou už jiný zákazník používá) se vypíše hláškou ze serveru, přesná podmínka neověřena.
- **Platí pro:** všechny typy.
- **Na co má vliv:** Kam chodí e-maily zákazníkovi. Blokace zákazníka je vázaná na e-mail, proto zákazník bez e-mailu nejde blokovat.

### Telefon

- **Co dělá:** Telefon zákazníka.
- **Výchozí hodnota:** Podle rezervace nebo prázdné.
- **Povolené hodnoty:** Text do 30 znaků („Telefon může mít max 30 znaků.“).
- **Platí pro:** všechny typy.
- **Na co má vliv:** Zobrazení v seznamu. Telefonem lze v rychlém zápisu zákazníka vyhledat.

### Záloha

- **Co dělá:** Výjimka ze zálohy nebo platby předem jen pro tohoto zákazníka. Má tři volby: Podle nastavení (výchozí), Vyžadovat vždy a Nevyžadovat nikdy.
- **Výchozí hodnota:** Podle nastavení (výchozí).
- **Povolené hodnoty:** Jedna ze tří voleb. Jiná hodnota vrátí „Neplatná hodnota nastavení zálohy.“
- **Platí pro:** zákazníky rezervující s platbou předem.
- **Na co má vliv:** Přebíjí režim v poli Komu poslat v e-mailu údaje k platbě předem v Nastavení, Rezervace. Když je tam režim Vypnuto, záloha se neposílá nikomu, výjimka Vyžadovat vždy to nepřebije. Rozhoduje nastavení platné při vytvoření rezervace, pozdější změna už existující rezervaci nemění.

### Podle nastavení (výchozí)

- **Co dělá:** Volba v poli Záloha: zákazník se řídí režimem z nastavení.
- **Výchozí hodnota:** Vybráno.
- **Povolené hodnoty:** Přepínač.
- **Platí pro:** všechny zákazníky.
- **Na co má vliv:** Při režimu Pouze noví klienti platí záloha, dokud zákazník nemá dokončenou návštěvu. Při režimu Všichni klienti platí vždy.

### Vyžadovat vždy

- **Co dělá:** Volba v poli Záloha: záloha se po zákazníkovi chce vždy, i když už má dokončenou návštěvu.
- **Výchozí hodnota:** Nevybráno.
- **Povolené hodnoty:** Přepínač.
- **Platí pro:** zákazníky, pokud režim v nastavení není Vypnuto a služba má částku větší než 0.
- **Na co má vliv:** Zákazník dostane údaje k platbě i jako stálý klient.

### Nevyžadovat nikdy

- **Co dělá:** Volba v poli Záloha: zákazník nikdy zálohu neplatí.
- **Výchozí hodnota:** Nevybráno.
- **Povolené hodnoty:** Přepínač.
- **Platí pro:** zákazníky.
- **Na co má vliv:** Rezervace zákazníka vznikají bez platby předem. Používá se pro důvěryhodné stálé klienty.

### Interní poznámka

- **Co dělá:** Poznámka k zákazníkovi, například alergie nebo preference.
- **Výchozí hodnota:** Prázdné.
- **Povolené hodnoty:** Volný text. Délkový limit v kódu stránky není, neověřeno u velmi dlouhého textu.
- **Platí pro:** všechny typy.
- **Na co má vliv:** Je vidět pouze vám, zákazník ji nevidí a do e-mailů se nepíše. Ukládá se společně s dalšími poli tlačítkem Uložit.

### Štítky

- **Co dělá:** Zaškrtávací seznam štítků, které zákazníkovi přiřazujete. Barevné štítky se ukazují i v seznamu zákazníků. Samotný štítek (jeho název vykreslený z dat) nemá vlastní oddíl.
- **Výchozí hodnota:** Nic nezaškrtnuto. Pole se zobrazí jen tehdy, když už nějaké štítky existují.
- **Povolené hodnoty:** Libovolný počet existujících štítků. Když se přiřazení nepodaří, vypíše se „Nepodařilo se přiřadit štítek.“ nebo „Nepodařilo se odebrat štítek.“
- **Platí pro:** všechny typy.
- **Na co má vliv:** Jen označení v seznamu a v detailu. Kde se štítky zakládají, tato stránka neříká. Neověřeno.

### Blokovat zákazníka

- **Co dělá:** Přidá zákazníka na seznam blokovaných. Tlačítko se potvrzuje dotazem. Vedle něj je pole Důvod (volitelné).
- **Výchozí hodnota:** Zákazník není blokován.
- **Povolené hodnoty:** Tlačítko. Důvod je volný text a nepovinný.
- **Platí pro:** zákazníky s e-mailem. Bez e-mailu se akce nic neprovede.
- **Na co má vliv:** Blokovaný zákazník si nevytvoří novou rezervaci. Odmítne ji formulář i ruční zápis z panelu, blokace se nedá obejít zápisem v panelu. Blokace se hlídá podle e-mailu. V detailu se objeví štítek Blokovaný a blok Blokovaní zákazníci. Existující rezervace blokace nezruší.

### Odblokovat zákazníka

- **Co dělá:** Odebere zákazníka ze seznamu blokovaných.
- **Výchozí hodnota:** Tlačítko se ukazuje jen u blokovaného zákazníka.
- **Povolené hodnoty:** Tlačítko.
- **Platí pro:** blokované zákazníky.
- **Na co má vliv:** Zákazník si zase může rezervovat.

### Smazat propadlé

- **Co dělá:** Natrvalo smaže všechny rezervace zákazníka ve stavu Dokončeno, Zrušeno, Odmítnuto a Vypršelo po potvrzení dotazu „Smazat všechny dokončené/zrušené rezervace?“.
- **Výchozí hodnota:** Tlačítko se ukazuje jen tehdy, když takové rezervace existují.
- **Povolené hodnoty:** Tlačítko.
- **Platí pro:** zákazníky s historií.
- **Na co má vliv:** Historie rezervací zákazníka, jeho počet návštěv a útrata v seznamu. Smazání nejde vrátit. Stav Nepřišel se tímto tlačítkem nemaže.

### + Nová rezervace

- **Co dělá:** Otevře okno ručního zápisu rezervace s předvyplněným zákazníkem a po uložení se vrátí na tento detail.
- **Výchozí hodnota:** Bez účinku.
- **Povolené hodnoty:** Tlačítko.
- **Platí pro:** všechny typy.
- **Na co má vliv:** Vytvoří potvrzenou rezervaci, pole okna jsou v souboru Kalendář a seznam rezervací.

U každého řádku historie rezervací je tlačítko pro otevření detailu rezervace a u dokončených, zrušených, odmítnutých a vypršelých také tlačítko pro smazání jedné rezervace. Stav rezervace se ukazuje slovy Čeká, Potvrzena, Dokončena, Zrušena, Odmítnuta, Propadlá, Čeká na schválení, Čeká na zálohu, Čeká na platbu a Nepřišel.

## Jak spolu pole souvisí

- Výjimka v poli Záloha pracuje spolu s režimem v Nastavení, Rezervace. Režim Vypnuto má vždy přednost. Pouze noví klienti se mění podle toho, zda zákazník dokončil návštěvu.
- Blokace a e-mail spolu souvisí: bez e-mailu nelze blokovat. Zákazník zapsaný v panelu bez e-mailu nedostává žádné zprávy, protože není kam.
- Mazání historie ovlivňuje počet návštěv a útratu v seznamu.

## Příklady nastavení

**Stálá klientka, která záloze nepodléhá.** Provoz má režim Všichni klienti. U stálé klientky zvolte Nevyžadovat nikdy. Její další rezervace vzniknou bez platby předem, ostatním se platba dál posílá.

**Nespolehlivý zákazník.** Otevřete jeho detail, do pole Důvod napište například „nepřišel třikrát“ a stiskněte Blokovat zákazníka. Formulář i ruční zápis jeho další rezervace odmítnou.

**Telefonický zákazník bez e-mailu.** V panelu zapište rezervaci jen se jménem a telefonem. Zákazník se v seznamu objeví se štítkem „bez e-mailu“. Pokud později e-mail sdělí, doplňte ho v poli Doplnit e-mail.

## Technická poznámka

Informace jsou převzaté ze zdrojového kódu (`Customers.cshtml`, `Customers.cshtml.cs`, `CustomerDetail.cshtml`, `CustomerDetail.cshtml.cs`, `CustomerRepository.cs`, `CustomerService.cs`, `DepositPolicy.cs`, `BookingService.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
