# Samoobslužný kiosk - Popis

> **Cílová skupina**: majitel / provozovatel obchodu (nasazení a konfigurace kiosku), vedoucí provozu (běžný dohled), obsluha (výjimky).
> **Rozsah**: všechny způsoby, jak se kiosk dá použít, a všechny funkce, které se dají zapnout/vypnout. Kiosk = samoobslužné zařízení, kde si zákazník objednává a platí **bez obsluhy**.

---

## 1. Co je kiosk a kdy ho použít

Kiosk je samostatné dotykové zařízení (obvykle 10–15") postavené na stejném backendu jako běžná pokladna. Zákazník na něm:

1. vybere, **co chce** (režim práce kiosku — viz kapitola 3),
2. vybere **produkty** (kategorie → položky, případně skenerem čárového kódu),
3. zvolí **způsob platby** (viz kapitola 5),
4. dostane potvrzení a hotovou objednávku v systému pokladny.

Kiosk tedy **nenasazuje všechny obchody stejně** – je to univerzální terminál, jehož chování se nastavuje. Typické důvody, proč obchod kiosku používá:

| Důvod | Co to řeší |
|---|---|
| Rychlé odbavení v hodinu špičky | Zákazník si objedná a zaplatí sám, obsluha jen vydává. |
| Obsluha nepotřebuje umět s kasou | Obchod, kde je obsluha často student nebo brigádník. |
| Objednávky z jazykové ciziny | Kiosk umí přepínat jazyk vlajkou. |
| Vlastní „vstupní obrazovka“ do provozovny | Kiosk může sloužit jako recepce, vstupenky, parkování, výdej objednávek. |
| Zákazník si chce objednat z mobilu | Kiosk umí vyhledat a vyzvednout objednávku z e-shopu podle čísla. |

### Kde se kiosk zapne

Kiosk je součástí aplikace KASA FIK Pokladna. V hlavní obrazovce je tlačítko **„Samoobslužný Kiosk“** (v záhlaví obrazovky). Obsluha ho spustí kliknutím – aplikace přejde na kiosk obrazovku a čeká na zákazníka. Po dokončení (nebo přes PIN) se kiosk vrátí zpět na hlavní obrazovku pokladny.

Režim běhu zařízení se řídí nastavením **Výchozí režim zobrazení** (`Nastavení → Rozšířená nastavení → Výchozí režim zobrazení`):

| Hodnota | Význam |
|---|---|
| `kiosk` | Kiosk v režimu **samoobslužné objednávky** (produkty z katalogu, doplňky, platba). |
| `self_service` | Kiosk **u stolu** – navíc se automaticky přidávají položky s příznakem „S“ (doplňky ke stolu). |
| `unattended_pay` | Bezobslužní platba (automat) – jde o jinou obrazovku než kiosk, zde jen pro rozlišení. |
| `original` / `plus_extra` / `customer_display` | Běžné režimy pokladny – kiosk se nespouští. |

> **Tip pro provoz:** Tlačítko kiosku lze na hlavní obrazovce skrýt (`kiosk_hide`), pokud chcete, aby kiosk spouštěl jen obsluha přes PIN.

---

## 2. Průběh práce s kioskem (obecně)

1. **Úvodní obrazovka** – logo, video nebo obrázek obchodu + volba režimu práce (tlačítka) a přepínač jazyka.
2. **Režim práce** – podle zvoleného režimu se zobrazí obrazovka pro danou činnost (objednávka, ubytování, parkování, vstupenky…).
3. **Výběr zákazníka** (volitelně) – přiložením karty (čipová / NFC), naskenováním karty zákazníka, nebo ručním vyplněním formuláře.
4. **Výběr produktů** – carousel kategorií + mřížka položek, případně skener čárového kódu / PLU.
5. **Souhrn objednávky** – přehled položek, spropitné, doplňkové nabídky, volba platby.
6. **Platba** – karta, hotovost, zákaznický účet apod.
7. **Potvrzení** – hláška „Odesláno – děkujeme za nákup“ s automatickým návratem na úvodní obrazovku.

### Doplňkové obslužné prvky na obrazovce

| Prvek | Funkce | Kdy se zobrazí |
|---|---|---|
| **Tlačítko jazyka (vlajka)** | Přepnutí jazyka rozhraní i textů tlačítek. | Vždy, pokud je v konfiguraci více než jeden jazyk. |
| **Stav zák. konta** | Zákazník přiloží kartu a uvidí historii svého účtu (úhrady po měsících). | Když je zapnutá funkce `ACCOUNT_BALANCE_CHECK`. |
| **Zavolat obsluhu** | Na obrazovku se zobrazí „Požadavek odeslán“, obsluha se dostaví. | Když je zapnutá funkce `CALLBACK_SERVICE`. |
| **Zrušit** | Zrušení rozpracované objednávky (s potvrzovacím dialogem). | Při rozpracované objednávce. |
| **Označení jazyka změněno** | Krátká hláška potvrzující změnu jazyka. | Po přepnutí jazyka. |

### Automatické ukončení relace

- Po **nulové aktivitě** (default 120 s, konfigurovatelné) se zobrazí dialog **„Stále jste tu?“** s tlačítkem *Pokračovat*.
- Pokud zákazník nereaguje, objednávka se zruší a kiosk se vrátí na úvodní obrazovku.
- Kiosk tak nikdy „nevisí“ a nezablokuje se.
- Každý dotyk (i průjezd myší, sken, přidání položky) časovač resetuje.

### Návrat obsluhy / skrytý PIN

Pokud potřebujete z kiosku odejít (např. chcete obsluze vysvětlit objednávku), lze:

- **6× rychle klepnout na logo** na úvodní obrazovce, nebo
- naskenovat čárový kód `88950284`, nebo
- použít **master PIN** (`802298` / `80229800`, případně vlastní nastavený v back office).

Kiosk pak otevře PIN obrazovku a po úspěšném zadání se vrátí na hlavní obrazovku pokladny.

---

## 3. Režimy práce kiosku – „k čemu mi kiosk chce být“

Režim se v konfiguraci udává jako **delivery options** (seznam). Na úvodní obrazovce se z něj vykreslí tlačítka (max. 4); každý režim otevře jinou obrazovku. Jednotlivé režimy lze **kombinovat** i **vypnout** – např. v restauraci může být jen „Tady“ a „S sebou“, v hotelu jen „Ubytovat se“ a „Vstupenky“.

### 3.1 Objednávky zboží a jídla

| Režim | Kdy se použije | Co zákazník vidí |
|---|---|---|
| **Tady (DINE_IN)** | Restaurace, jídelna – zákazník zůstává u stolu. | Katalog kategorií → položky, objednávka se tvoří pro stůl. |
| **S sebou (TAKE_OUT)** | Restaurace s odnosem, fast food, bistro. | Stejné jako „Tady“, objednávka se bere s sebou. |
| **Nákup v obchodě (GROCERIES)** | maloobchod – zákazník si sám nakupuje z regálu. | Katalog zboží podle kategorií, prázdná hotovost na konci (pokladna). *Režim je v této verzi rozpracovaný.* |
| **Vstupenky (TICKETS)** | Divadelní / koncertní / sportovní vstupenky. | Počet dospělých a dětí (+/−), všechno jako jedna položka „Ticket“. |
| **Vyzvednout (COLLECT)** | Režim, kdy zákazník jen vyzvedává už připravenou objednávku. | Otevře obrazovku výdeje objednávek podle čísla. |

### 3.2 Ubytování a registrace hostů

| Režim | Kdy se použije | Co zákazník vidí |
|---|---|---|
| **Ubytovat se (CHECK_IN)** | Hotel, kemp, ubytovna. | Dva kroky: 1) **Ubytování** – počet nocí a výpočet ceny + obecní poplatky, 2) **Údaje zákazníka** – jméno, příjmení, datum narození, adresa, telefon. Před otevřením formuláře musí zákazník odsouhlasit **zpracování osobních údajů (GDPR)**. |

- Počet nocí násobí cenu ubytování i obecní poplatky.
- Obecní poplatek se počítá z počtu ubytovaných osob.
- Uložení hosta vytvoří/aktualizuje zákazníka a objednávku s tagem `kiosk-guest`.
- **Personalizace textů** (titulky, popis GDPR, nadpisy sekcí) jde přeložit přes konfiguraci.

### 3.3 Parkování a návštěva

| Režim | Kdy se použije | Co zákazník vidí |
|---|---|---|
| **Parkování (PARKING)** | Obchod s parkováním, garáž. | Automaticky se přidá parkovací položka (produkt s tagem `parking`) a otevře se souhrn k platbě. |
| **Návštěva (LOBBY_VISIT)** | Hotel, kanceláře, areál – evidence návštěv. | Vyhledávání návštěvy podle jména / příjmení / telefonu (min. 3 znaky), výsledky v seznamu. Vedle vyhledávání se otevře i souhrn objednávky s předvolenou položkou (např. poplatek za návštěvu). |

### 3.4 Věrnostní program a registrace

| Režim | Kdy se použije | Co zákazník vidí |
|---|---|---|
| **Registrace do věrnostního programu (LOYALTY_REGISTRATION)** | Chcete získat nového zákazníka s kartou. | Formulář (jméno, příjmení, telefon, případně IČO), souhlas GDPR, uložení do back office, vytvoření **QR kódové karty** zákazníka a tisk věrnostní karty na tiskárně. |

> Věrnostní karta se vytiskne na tiskárně nastavené jako „účtenky“ – karta obsahuje QR kód, který zákazník použije při další návštěvě.

### 3.5 Výdej objednávek, reklamace a vratky

| Režim | Kdy se použije | Co zákazník vidí |
|---|---|---|
| **Vyzvednout objednávku (ORDER_PICKUP)** | E-shop / objednávkový systém s výdejem na místě. | Klávesnice na číslo objednávky → vyhledání v Heliosu nebo v API e-shopu → zobrazení částky k úhradě → volba platby. |
| **Reklamace – zadání (ORDER_WARRANTY)** | Reklamace zboží. | Vyhledání reklamace podle identifikačního čísla, vytisk lístku do fronty. |
| **Reklamace – vyzvednutí (ORDER_WARRANTY_COLLECT)** | Výdej vyřešené reklamace. | Stejné vyhledání, jiný titulek a popisky. |
| **Vrácení zboží (ORDER_RETURN)** | Vratky z e-shopu. | Vyhledání objednávky a vytisk lístku do fronty. |

- Objednávka, která už byla vyzvednuta, se zobrazí jako **„Objednávka byla již vyzvednuta“**.
- Neznámé číslo → hláška **„Objednávka nenalezena“**.
- Po uhrazení se objednávka označí jako zaplacená a odešle do **fronty (queue)** s textem „Vyčkejte“.
- Neuhrazená / už placená objednávka se dá vyzvednout i bez zásahu obsluhy.

### 3.6 Prohlížeč a validace vstupenek

| Režim | Kdy se použije | Co zákazník vidí |
|---|---|---|
| **Prohlížeč (BROWSER)** | Ceník, menu na webu, rezervační systém partnera. | Webová stránka přímo v kiosku (případně video). |
| **Validátor (VALIDATOR)** | Sportovní / festivalové akce – ověření vstupenky. | Sken vstupenky → potvrzení (použito / neplatná / již použitá). |

---

## 4. Jak zákazník nakupuje (katalog, sken, doplňky)

### 4.1 Kategorie a položky

- Kiosk ukazuje **carousel kategorií** nahoře a **mřížku položek** dole.
- Do kiosku se dostanou **jen kategorie označené v back office jako „Zobrazit v samoobslužném kiosku“** (příznak e-commerce), a to pouze ty, které nejsou skryté na pokladně.
- Počet sloupců mřížky jde nastavit (`columns`).
- Když má obchod jen jednu kategorii, carousel se skryje a zobrazí se rovnou položky.
- Kategorie může být v kiosku zobrazena **jen obrázkem** (bez názvu) – zákazník ji pozná podle fotky.

### 4.2 Skenování

- **Čárový kód / PLU** – naskenovaný kód rovnou přidá položku do objednávky a otevře souhrn. Funguje to i u prázdného košíku.
- **Karta zákazníka** (`kasafik://…` nebo `store247://…`) – karta se načte, zákazník se přiřadí k objednávce, zobrazí se body/účet.
- **Čtečka čipových karet (ACR122)** a **NFC** – přiložení karty funguje v souhrnu objednávky i v dialogu „Stav zák. konta“.
- **Dotyková váha (USB)** – kiosk umí průběžně vážit: při přidání/vyjmutí zboží na váze se položka sama přidá nebo ubere. Váha je připojená přes USB a katalog produktů se k váze mapuje přes čárové kódy.

### 4.3 Doplňky a příplatky

- Produkty, které mají v back office nastavené **doplňky / příplatky** (obrázek, velikost, extras), otevřou po vybrání **dodatečnou obrazovku**, kde zákazník vybere z doplňkových položek a uvidí **přepočítanou cenu**.
- Produkty, které mají **varianty** (skupiny možností), otevřou dialog s volbou.
- Některé položky se dají přidat i **automaticky** (např. obal burgeru) – to je definice v katalogu, ne v kiosku.
- Ke stolu (režim `self_service`) se přidávají položky s příznakem **„S“** (doplňky ke stolu), v kioskovém režimu `kiosk` položky s příznakem **„K“**.

---

## 5. Platby

Kiosk umí kombinovat způsoby platby – každý se zobrazí jako tlačítko v souhrnu objednávky, podle konfigurace.

| Způsob platby | Kdy se použije | Podmínky |
|---|---|---|
| **Objednávka (bez platby)** | Objednávka se jen pošle do výroby, platí se na pokladně. | Nejčastější v restauracích. |
| **Hotově při převzetí** | Zákazník zaplatí až u výdejního místa. | |
| **Hotovostní přijímač (bankovní terminál na mince)** | Kiosk přijímá hotovost sám. | Nutno mít připojený a nakonfigurovaný přijímač. |
| **Platební karta** | Nejčastější způsob. | Musí běžet platební terminál (Sonet ECR2, GP TOM, ZVT, Viva, GPE). |
| **Zákaznický účet (chip karta)** | Zákazník má uctěnou kartu; platí se z jeho kreditu. | Kiosk přiloží kartu na čtečku. |
| **Zákaznický účet (post-paid)** | Objednávka se zaúčtuje na později. | |
| **Qerko** | Platba přes mobilní aplikaci Qerko (QR). | |
| **QR online platba** | Karta místo terminálu – zákazník platí v aplikaci přes QR (např. Viva). | Závisí na konfiguraci platebního kanálu v back office. |

### Důležité věci k platbám

- **Spropitné** – v souhrnu objednávky se zákazníkovi zobrazí dotaz „Přejete si přidat spropitné?“ s předvolenými hodnotami (pevné částky i procenta). Výši spropitného i sadu tlačítek jde nastavit v konfiguraci.
- **Doplňková nabídka („Nezapomněli jste něco?“)** – u souhrnu se zobrazí nabídka doplňkových položek (produkty s tagem `upsell`). Zákazník ji může jedním klepnutím přidat do objednávky.
- **Upozornění na alkohol** – pokud objednávka obsahuje alkohol, zobrazí se hláška, že personál ověří věk při převzetí.
- **Měsíční limit zákazníka** – pokud má zákazník na kartě nastavený měsíční limit úhrad, kiosk ho při platbě z účtu kontroluje. Při vyčerpání limitu se zákazníkovi zobrazí hláška s částkami a objednávku musí zaplatit jinak.
- **Odpojený terminál** – pokud terminál není dostupný, objednávka se neztratí; je potřeba ji zopakovat nebo zvolit jinou platbu.
- **Výpadek sítě** – objednávky se ukládají lokálně a po obnovení spojení se do synchronizují.

---

## 6. Tisk, fronta a propojení s provozem

| Funkce | Popis |
|---|---|
| **Tisk účtenky / objednávky** | Po zaplacení se tiskne na tiskárnu nastavenou jako „účtenky“. Podle konfigurace je tisk povinný, nebo volitelný (tlačítko *Odeslat objednávku* / *Odeslat bez tisku*). |
| **Tisk na kuchyň** | Objednávka se tiskne i na tiskárnu(k) kuchyně, aby se připravila jídla. |
| **Fronta (queue)** | Po odeslání objednávky se do fronty zákazníků pošle požadavek s pořadovým číslem a místem vyzvednutí („Vyčkejte“, „V přípravě“). Obsluha pak vidí objednávku ve frontě. |
| **Lístek s pořadovým číslem** | U reklamací a vratek se vytiskne lístek s pořadovým číslem a zároveň se pošle do fronty. |
| **Předtištěné / samostatné doklady** | U některých terminálů se tiskne i samostatný doklad s textem z platebního terminálu. |

---

## 7. Jazyky

- Kiosk podporuje **více jazyků** a přepíná se **vlajkou** v záhlaví obrazovky.
- Dostupné jazyky: **cs, en, de, fr, ru, uk, vi, sk, pl, ja, zh**.
- Které vlajky se zobrazí, určuje konfigurace (`languages`).
- Přepnutí jazyka překládá nejen rozhraní, ale i **vlastní texty** tlačítek a hlášek (přes klíče v konfiguraci).
- Jazyk se dá zvolit i **v úvodní obrazovce** před začátkem objednávky.

---

## 8. Konfigurace kiosku (všechno je řiditelné)

Kiosk si při startu načte konfiguraci ze **cloudu** – konkrétně ze souboru

```
https://fikpreferences.s3.eu-west-1.amazonaws.com/kiosks/<ID zákazníka>/<ID pokladny>.json
```

- Konfigurace je **na pokladnu**, ne na zařízení – stejný soubor může být na více kioscích.
- Změna se projeví **po restartu kiosku** (zavření a nové otevření obrazovky kiosku).
- Když soubor není dostupný, kiosk běží na výchozích hodnotách a hlásí chybu.
- Aktuální konfigurace se ukládá i na zařízení do souboru `kiosk_config_<ID pokladny>.json` – slouží jako záloha a archiv.

### 8.1 Přehled konfiguračních klíčů

#### Základní nastavení

| Klíč | Význam | Výchozí |
|---|---|---|
| `languages` | Seznam dostupných jazyků (kódy `cs`, `en`, …) | prázdné |
| `columns` | Počet sloupců mřížky produktů (`-1` = nastavení pokladny) | `-1` |
| `auto_logout_sec` | Sekundy nečinnosti před dotazem „Stále jste tu?“ | `120` |
| `text` | Překlady vlastních textů: `{ "cs": { "KLÍČ": "text" } }` | prázdné |
| `updated_at` | Čas poslední změny konfigurace | – |

#### Vzhled

| Klíč | Význam |
|---|---|
| `image_front_open_url` | Obrázek **nebo video** na úvodní obrazovce (`.mp4`, `.mov`, `.avi` se přehrává, `asset:` = offline soubor v aplikaci). |
| `image_front_closed_url` | Obrázek v „zavřeném“ stavu kiosku. *Klíč je připraven pro budoucí použití.* |
| `image_bg_url` | Barva pozadí (`#RRGGBB`) nebo URL obrázku. |
| `banner_urls` | URL obrázků v horním banneru (rotovány). |
| `banner_delay_sec` | Doba mezi bannerovým přehráním. |
| `category_text_list_color` | Barva textu v seznamu kategorií. |
| `category_text_color` / `category_bg_color` / `category_alpha` | Barvy a průhlednost panelu kategorií. |
| `sale_bg_color` | Barva pozadí obrazovky prodeje. |
| `item_title_size_sp` / `item_subtitle_size_sp` | Velikost názvu a popisu položky. |
| `button_bottom_size_sp` | Velikost písma spodních tlačítek. |
| `price_in_image` | Zda je cena vypnutá z obrázku položky (a kreslí se textem). |
| `gdpr_images_url` | Obrázek k textu GDPR (per jazyk). |

#### Funkce (features_options)

| Klíč | Efekt |
|---|---|
| `PANEL_CAROUSEL_CATEGORIES` | Zobrazí horní carousel kategorií. |
| `PANEL_SIDE_SUMMARY_STICKY` | Zobrazí **trvalý panel souhrnu objednávky** na straně obrazovky (užitečné na širokých displejích). |
| `ACCOUNT_BALANCE_CHECK` | Zobrazí tlačítko **„Stav zák. konta“**. |
| `CALLBACK_SERVICE` | Zobrazí tlačítko **„Zavolat obsluhu“**. |
| `GDPR` | Rezerva pro zpracování osobních údajů. |

#### Režimy práce (delivery_options)

`DINE_IN`, `TAKE_OUT`, `GROCERIES`, `TICKETS`, `CHECK_IN`, `PARKING`, `LOBBY_VISIT`, `LOYALTY_REGISTRATION`, `ORDER_PICKUP`, `ORDER_RETURN`, `ORDER_WARRANTY`, `ORDER_WARRANTY_COLLECT`, `COLLECT`, `BROWSER`, `VALIDATOR`.

- Pořadí v seznamu = pořadí tlačítek na úvodní obrazovce (max. 4 zobrazených).
- Názvy tlačítek jde přeložit přes `text` (klíč = název režimu, např. `DINE_IN`).

#### Platby (payment_options)

`ORDER` (bez platby), `CASH` (hotově při převzetí), `CASH_ITC` (přijímač hotovosti), `PAYMENT_CARD` (karta), `CUSTOMER_CREDIT` (chip karta – z účtu), `CUSTOMER_POST_PAID`, `QERKO`.

| Klíč | Význam |
|---|---|
| `payment_tips` | Sada spropitných: pevné částky (`10` = 10 Kč) i procenta (`1.15` = 15 %). Prázdné pole = spropitné se nenabízí. |
| `receipt_auto_pay` | Účtenka se rovnou označí jako zaplacená a vznikne transakce (bez dotazu obsluhy). |
| `order_print_require` | Tisk objednávky povinný / volitelný. *Klíč je připraven; v této verzi se tisk řídí nastavením tiskáren a obsluhou.* |
| `payment_customer_phone_number` | Zda se vyžaduje telefonní číslo zákazníka: `REQUIRED` / `OPTIONAL` / `DISABLED`. *Klíč je připraven pro budoucí použití.* |
| `sync_freq_sec` | Frekvence synchronizace katalogu (záporná hodnota = vypnuto). *Klíč je připraven; synchronizaci dnes řídí plánovač v aplikaci.* |
| `language_selector_type` | Umístění přepínače jazyka: `FIXED_BANNER` (vlajka v záhlaví) / `PRE_SALE` (v úvodní obrazovce). |

#### Překlady vlastních textů (`text`)

| Klíč | Kde se zobrazí |
|---|---|
| `CANCEL_BUTTON` | Text tlačítka „Zrušit“. |
| `PAY_BUTTON` | Text tlačítka platby. |
| `BACK_BUTTON` | Text tlačítka „Zpět“. |
| `BOTTOM_LOGO_SUBTITLE` | Popisek pod logem. |
| `gdpr_notice_checkbox` | Text souhlasu GDPR. |
| `ORDER_PICKUP_ORDER_TITLE` / `ORDER_PICKUP_LOOKUP_BUTTON` / `ORDER_PICKUP_PAYMENT_OPTIONS_TITLE` / `ORDER_PICKUP_NOT_FOUND` / `ORDER_PICKUP_COLLECTED` | Obrazovka výdeje objednávek. |
| `ORDER_PICKUP_WARRANTY_TITLE` / `ORDER_PICKUP_WARRANTY_BUTTON` | Obrazovka reklamací. |
| `PAYMENT_TYPE_CASH` / `PAYMENT_TYPE_CARD` | Názvy způsobů platby. |
| `VISITOR_NAME_LABEL` / `VISITOR_QUERY_HINT` / `VISITOR_NOT_FOUND` | Obrazovka návštěv. |

> Texty v konfiguraci se načítají pro jazyk podle vlajky; **když překlad pro daný jazyk chybí, použije se angličtina**, a když chybí i ta, použije se výchozí text aplikace.

---

## 9. Hardware a periferie

| Zařízení | Využití v kiosku |
|---|---|
| **Terminál na karty** (Sonet ECR2, GP TOM, ZVT, Viva, GPE) | Platba kartou. Při výpadku se hlásí chyba „Platební terminál je odpojen“. |
| **Přijímač hotovosti (ITC)** | Přijímání hotovosti přímo v kiosku. |
| **Čtečka čipových karet (ACR122)** | Zákaznická karta, platba z účtu. |
| **NFC** | Přiložení karty k telefonu/čtečce. |
| **Terminál pro platbu QR** | Vlastní platební terminál nebo QR přes mobil. |
| **Tiskárna** (USB i síťová) | Účtenky, objednávky, lístky do fronty, věrnostní karty. Kiosk automaticky kontroluje, jestli je tiskárna připojená, a při výpadku ukáže hlášku. |
| **Skener čárových kódů** (USB klávesnicový) | Sken produktů a čárových kódů objednávek. |
| **Dotyková váha (USB)** | Vážení zboží, automatické přidání/odebrání položky. |
| **Bluetooth displej pro zákazníka** | Zobrazení objednávky a částky vedle kiosku. |
| **Reproduktor** | Zvuková zpětná vazba – chyba, úspěch, klepnutí. |
| **Vzdálená správa / MQTT / WebSocket** | Notifikace a stav propojení s centrálou. |

> Kiosk běží v **režimu celé obrazovky** – systémová lišta, navigační panel a stavový řádek se ukrývají, aby zákazník nemohl „utéct“ z kiosku.

---

## 10. Obsluha kiosku v praxi – checklist

### Před otevřením obchodu
- [ ] Kiosk je připojený k síti a napájení, tiskárny jsou zapnuté.
- [ ] Na úvodní obrazovce se zobrazuje správné logo / video obchodu.
- [ ] V kiosku jsou vidět jen kategorie, které chcete prodávat samoobslužně (příznak v back office).
- [ ] Ceny v kiosku odpovídají cenám na pokladně.
- [ ] Platební terminál je připojený a prošel kontrolou.
- [ ] Spropitné a doplňková nabídka odpovídají vašim zvyklostem.

### Během provozu
- [ ] Občas ověřte, že kiosk nehlásí chybu tiskárny / terminálu / sítě.
- [ ] Když zákazník „zapomene“, dialog „Stále jste tu?“ sám vyřeší situaci – objednávka se zruší a obrazovka se vrátí na úvod.

### Na konci dne
- [ ] Zkontrolujte logy kiosku v adresáři `LOGS` na zařízení (chybové hlášky tiskárny, terminálu, sítě) a uloženou kopii konfigurace `kiosk_config_<ID pokladny>.json`.
- [ ] Ověřte, že se všechny objednávky propisovaly do pokladny (report za den).

---

## 11. Řešení problémů (rychlá tabulka)

| Co vidíte | Pravděpodobná příčina | Řešení |
|---|---|---|
| „Cloud kiosk config doesn't exist“ (konfigurace kiosku neexistuje) | Chybí nebo je nepřístupný konfigurační soubor pro pokladnu. | Zkontrolujte ID zákazníka a pokladny v URL konfigurace. |
| „Tiskárna na adrese X je odpojena“ | Tiskárna není zapnutá / není připojená k počítači. | Zapněte tiskárnu, ověřte USB kabel, případně v nastavení tiskáren přepočítat test. |
| „Platební terminál X je odpojen“ | Terminál neodpovídá. | Ověřte napájení a síť terminálu, případně proveďte vyrovnání terminálu. |
| „Chyba synchronizace – chyba připojení k internetu“ | Kiosk je offline. | Objednávky se ukládají lokálně, po obnovení sítě se do synchronizují. Zkontrolujte kabel / Wi-Fi. |
| Obrazovka zůstává na úvodní stránce | Seznam režimů práce je prázdný nebo je vše „zavřeno“. | Zkontrolujte `delivery_options` v konfiguraci a restartujte kiosk. |
| Zákazník nezobrazí správnou položku | Kód není v katalogu nebo není viditelný v kiosku. | Ověřte přiřazení kódů (čárový kód / PLU) a viditelnost kategorie. |
| Kiosk „nevidí“ zákaznickou kartu | Není připojená čtečka ACR122 nebo NFC. | Zkontrolujte USB čtečku a oprávnění k USB zařízení při startu. |
| „Zařízení nemá platnou licenci“ | Kiosk nemá platnou licenci KASA FIK. | Kontaktujte podporu / obnovte licenci. |

---

## 12. Shrnutí pro provozovatele

Kiosk není „další pokladna“ – je to **konfigurovatelný terminál pro obsluhu zákazníka**:

1. **Režimy práce** (`delivery_options`) určují, *co* na kiosku zákazník dělá: objednává jídla, kupuje zboží, ubytovává se, parkuje, kupuje vstupenky, registruje se do věrnostního programu, vyzvedává e-shopovou objednávku nebo reklamaci, nebo u něj jen vyplácí parkovací poplatek.
2. **Funkce** (`features_options`) zapínají konkrétní ovládací prvky – stav zákaznického konta, volání obsluhy, trvalý souhrn objednávky, carousel kategorií.
3. **Platby** (`payment_options`) říkají, jak zákazník může zaplatit – od „zaplatí na pokladně“ přes kartu, hotovostní přijímač až po zákaznický účet.
4. **Vzhled a texty** se řídí z kloudu, takže obchod si může připravit vlastní úvodní obrazovku, banner, barvy a vlastní formulace tlačítek bez zásahu do aplikace.
5. **Předpoklady** pro spolehlivý provoz: správně nastavené kategorie a ceny, funkční tiskárna a platební terminál, připojená čtečka kódů a případně váhy, a pravidelná kontrola logů.