Táto téma Pomocníka obsahuje postup inštalácie mobilnej aplikácie LUKUL - nielen mobilný čašník (skrátene LUKUL) v systéme OBERON. Aplikácia so systémom OBERON komunikuje prostredníctvom webových služieb. Z tohto dôvodu je potrebné v prevádzke zabezpečiť WiFi pripojenie do lokálnej počítačovej siete.

OBERON - nastavenia

• V programe OBERON - Agenda firmy v ponuke Servis, Používatelia definujte zoznam používateľov, ktorí budú s aplikáciou pracovať. V záložke Podrobnosti, časti Prihlásenie každému používateľovi definujte Kód rýchleho prístupu (kód prístupového kľúča alebo PIN) v dĺžke maximálne 4 znakov. Tento PIN slúži na prihlásenie používateľa (obsluhy) do aplikácie.
• V Pokladnici OBERON je potrebné nadefinovať zoznam stolov a priradiť ich do zón. Pri predaji sa pod nimi vytvoria pokladničné účty, na ktoré je možné pridávať položky a zúčtovať ich. Stôl môže definovať len používateľ s právami administrátora. Stoly je vhodné farebne odlíšiť. Viac informácií vrátane postupu, ako stoly nadefinovať, získate v téme Práca s otvorenými účtami (stolmi).
• V záložke Reg. pokladnice formulára Skladová karta (ponuka Sklad, Skladové karty) nastavte názvy a poradie (prípadne aj farbu na sprehľadnenie práce v aplikácii) skupín na pokladnici - v aplikácii sa zobrazujú ako Skupiny (napr. Polievky, Šaláty, Dezerty a pod.).
• Položky v ponuke eMenu sú zoradené podľa kódu položky v záložke Reg. pokladnice formulára Skladová karta, a to aj v rámci jednotlivých skupín.

Obrázok č. 1: Nastavenie skupín v pokladnici

Údaje prenášané do ponuky eMenu

• Všetky údaje potrebné na naplnenie ponuky eMenu tak v režime LUKUL - mobilný čašník, ako aj v jednotlivých režimoch LUKUL eMenu určených pre zákazníkov (hostí) sa vyčítavajú zo systému OBERON, preto je dôležité, aby každá položka zobrazená v ponuke bola správne zadaná aj v skladovej evidencii systému OBERON. Viac informácií nájdete v téme Založenie skladových kariet.
• Pre zobrazenie položiek v ponuke eMenu sú dôležité nasledujúce nastavenia vo formulári Skladová karta:
  - pri režime LUKUL - mobilný čašník v záložke Reg. pokladnice začiarkavacie políčko Umožniť pracovať s položkou na pokladnici,
  - pri jednotlivých režimoch LUKUL eMenu určených pre zákazníkov (hostí) v záložke Receptúra je potrebné pridať položku do jedálneho lístka (tlačidlo Pridať alebo odobrať). Bližšie informácie nájdete v téme Jedálny lístok.
• Uvedené nastavenia majú za následok, že niektoré skladové položky zostávajú pre zákazníka (hosťa) skryté (napr. položky typu doblok, fľaša a pod.).
• Názov jedla/nápoja sa vyčítava buď z názvu skladovej karty v záložke Základné formulára Skladová karta, alebo z poľa Názov položky na bločku (ak je zadaný) v záložke Reg. pokladnice.
• Rozšírený popis jedla/nápoja (napr. zloženie, názov v inom jazyku a pod.) sa prenáša z poľa Doplňujúci text formulára Skladová karta (záložka Základné). Maximálna dĺžka doplňujúceho textu je 255 znakov vrátane medzier.
• Podrobnosti o položke (jedle/nápoji) sa prenášajú z poľa Podrobný popis formulára Skladová karta (záložka Základné). 
• Cena položky sa vyčítava z oddielu Predajná cena v záložke Cena formulára Skladová karta.
• Hmotnosť, nutričná hodnota a alergény sa preberajú zo zloženia receptúry (v prípade, že je skladová karta typu Receptúra): hmotnosť z poľa Hmotnosť/objem uvádzané na jedálnom lístku (v záložke Položky receptúry), nutričná hodnota a alergény z polí Nutričná hodnota a Alergény (v záložke Ostatné). Stlačením informácie o alergénoch v aplikácii sa otvorí zoznam alergénov, ktorý sa prenáša z formulára Jedálny lístok, záložka Alergény.

Obrázok č. 2: Podrobnosti o položke a zoznam alergénov

Obrázok č. 2: Nastavenie jednotného lístka pre jedlá a nápoje LUKUL eMenu

Ďalšie nastavenia

• V ponuke Firma, Údaje o firme, oddiel Logo nastavte logo firmy, resp. prevádzky - prenáša sa do záložky Info hlavnej ponuky aplikácie v režime LUKUL eMenu. Tu je možné zobraziť aj uvítací text (napr. Vítame Vás) - prenáša sa z formulára Jedálny lístok, záložka Základné.
• V prípade vypredania niektorej položky je možné v OBERON-e danú skladovú kartu označiť ako dočasne nedostupnú, a to stlačením tlačidla F6 - Označiť položku za dočasne nedostupnú v evidencii Skladové karty (prípadne v tejto evidencii aj cez tlačidlo Možnosti). Po označení sa bude cena danej položky v aplikácii zobrazovať sivou farbou a položku nebude možné objednať.

Obrázky

• Jednotlivé položky eMenu sa tak v režime LUKUL - mobilný čašník, ako aj v jednotlivých režimoch LUKUL eMenu môžu zobrazovať s obrázkom, alebo bez neho. Obrázok k danej skladovej karte (položke) je možné priradiť vo formulári Skladová karta cez tlačidlo Dokumenty a obrázky... - Nový alebo Oprava. Otvorí sa formulár Dokument (obrázok), v ktorom začiarknite možnosť Obrázok použiť na Pokladnici OBERON v režime Fast Food. Na tento účel odporúčame používať obrázky vo formáte PNG kvôli priehľadnosti s veľkosťou aspoň 64 x 64 pixelov, najviac však 5 - 10 kB - sú určené tak pre obsluhu, ako aj pre zákazníka (hosťa) na lepšiu orientáciu v ponuke.
• Obrázky určené na zobrazenie v rámci podrobností o položkách v jednotlivých režimoch LUKUL eMenu odporúčame používať vo formáte PNG kvôli priehľadnosti s veľkosťou aspoň 600 x 600 pixelov, najviac však 100 - 150 kB (sú určené na prezentáciu jednotlivých jedál a nápojov spravidla vlastnými fotografiami).

Použitie príliš veľkých obrázkov v režime LUKUL - mobilný čašník by mohlo spôsobovať výrazné spomalenie a v krajnom prípade až nespustenie aplikácie (spustenie aplikácie sa musí ukončiť v časovom limite 10 sekúnd).

OBERON Center - konfigurácia rozhrania webovej služby

1. Pred inštaláciou webovej služby je potrebné zvoliť počítač, v ktorom bude webová služba hosťovaná (t. j. spustená). Mal by to byť počítač, ktorý je neustále zapnutý (spravidla sieťový databázový server). Na tomto počítači je potrebné vykonať Inštaláciu OBERON-u. Po inštalácii otvorte účtovnú jednotku (databázu) a v nastaveniach programu (ponuka Servis, oddiel Firma - Všeobecné, záložka Rozšírenia) začiarknite Umožniť používať webové služby.
2. Z hľadiska aplikácie webová služba predstavuje LUKUL Local Server. Pod týmto názvom sa zobrazuje obsluhe pri práci s aplikáciou.
3. V ďalšom kroku vytvorte pre webovú službu nového používateľa (ponuka Servis - Používatelia) typu Systémový (napr. s názvom LUKUL). Pod týmto používateľom sa bude webová služba spúšťať.
4. Otvorte program OBERON Center. Kvôli neskoršiemu úspešnému zaregistrovaniu webovej služby je nutné program spustiť s právami administrátora.
5. Otvorte oddiel Rozhranie webovej služby a stlačte tlačidlo Pridať. Otvorí sa formulár, v ktorom v záložke Základné:
   - zadajte Názov webovej služby - napr. LUKUL,
   - vyberte Typ služby Pokladnica OBERON,
   - zadajte číslo IP portu, pod ktorým bude daná služba dostupná (port musí byť voľný - t. j. v systéme Windows ho nesmie používať iná služba),
   - začiarknite pole Pridať výnimku do Windows firewall (ak používate bránu firewall iného výrobcu, je potrebné povoliť zadaný port manuálne).

   

6. V záložke Databáza stlačte tlačidlo Nastaviť a vyberte príslušnú databázu. Ďalej zvoľte používateľa na spúšťanie webovej služby (podľa bodu č. 2).
7. Prejdite späť do záložky Základné, v ktorej stlačte tlačidlo Nastaviť na podrobné nastavenie služby. Otvorí sa formulár Nastavenia webovej služby Pokladnica OBERON, v ktorom v záložke Webové služby:
   - vyberte systémového používateľa vytvoreného v bode č. 2,
   - začiarknite možnosť Povoliť webovú službu,
   - pri položke Zabezpečenie vyberte možnosť OBERON autorizácia (bez zabezpečeného pripojenia).
8. Prejdite do záložky Pokladnica OBERON, v ktorej:
   - pri položke Pokladnica OBERON vyberte pokladnicu, ktorú bude táto webová služba zastupovať (bližšie určuje predajnú cenu, sklady, otvorené účty (stoly) a pod.),
   - pri položke Režim činnosti zvoľte jednu z nasledujúcich možností v závislosti od toho, pre ktorú súčasť aplikácie webovú službu konfigurujete:
     a) Mobilný čašník - pre obsluhu na objednávanie jedál a nápojov od stola zákazníka,
     b) eMenu - bez možnosti objednávania - pre zákazníka na prezeranie jedálneho a nápojového lístka bez možnosti objednávania,
     c) eMenu - hosť v reštaurácii - pre zákazníka pri objednávke z reštauračného zariadenia,
     d) eMenu - donáška - pre zákazníka pri objednávke z domu.
   - pri položke Jedálny lístok vyberte lístok nadefinovaný v programe OBERON - Agenda firmy vo formulári Skladová karta, záložka Receptúra (napr. odporúčaný LUKUL eMenu),
   - pri položke Obslužné vyberte predvolenú hladinu obslužného.
   Nastavenia potvrďte stlačením tlačidla OK.
9. Aby systém Windows webovú službu povolil, je nevyhnutné vykonať jej registráciu - vo formulári Rozhranie webovej služby stlačte tlačidlo Zaregistrovať službu. Pred prípadnou dodatočnou zmenou napr. čísla portu je potrebné najprv zrušiť registráciu danej služby, zmeniť port a následne opätovne vykonať registráciu.
10. Po nadefinovaní webovej služby je možné spustiť server rozhrania webovej služby. Skontrolujte nastavenie, či sa má tento server automaticky spúšťať pri spustení programu OBERON Center: v oddiele Rozhranie webové služby stlačte tlačidlo Nastavenia (vpravo hore). Otvorí sa okno, v ktorom danú možnosť povoľte, resp. zakážte. V záložke Prehľad komunikácie získate údaje (IP adresu počítača spolu s číslom portu), ktoré následne použijete na nastavenia komunikácie v mobilnom zariadení.
11. Nastavenia potvrďte stlačením tlačidla OK. Ak je webová služba nainštalovaná korektne, vo webovom prehliadači je možné vykonať jej kontrolu - zobrazí sa informácia o danej službe.
12. Pre režim eMenu - donáška je webovú službu v lokálnej počítačovej sieti potrebné sprístupniť z vonkajšieho internetu - je potrebné nastaviť presmerovanie portu na smerovači (routri) z verejnej IP adresy na IP adresu počítača v lokálnej sieti, na ktorom je služba spustená (predpokladá sa, že reštauračné zariadenie má verejnú statickú IP adresu alebo dynamické DNS).

Na prácu s gastroaplikáciou LUKUL - nielen mobilný čašník je potrebné nakonfigurovať potrebný počet webových služieb typu Pokladnica OBERON v závislosti od počtu použitých režimov činnosti: jednu na prácu obsluhy (vyberá sa režim Mobilný čašník) a ďalšie pre zákazníkov (s jedným z režimov eMenu). Všetky webové služby sa konfigurujú v tom istom rozhraní webovej služby v programe OBERON Center. Pre každú webovú službu je potrebné nadefinovať nového používateľa typu Systémový (ponuka Servis, Používatelia).

Generovanie prístupových QR kódov   

• Na prihlásenie zákazníka (v režime LUKUL eMenu - bez možnosti objednávania a LUKUL eMenu - hosť v reštaurácii), ale aj obsluhy (režim LUKUL - mobilný čašník) do WiFi siete reštauračného zariadenia, stiahnutie a následné prihlásenie do aplikácie LUKUL, prípadne na spustenie aplikácie v režime donáškovej služby (LUKUL eMenu - donáška), je potrebné v programe OBERON - Agenda firmy vygenerovať prístupové QR kódy.
• QR kódy určené pre zákazníkov sa spravidla umiestňujú na stole v rámci reštauračnej prevádzky. QR kódy určené pre zákazníkov pri objednávke jedla/nápojov na donášku sa spravidla sprístupňujú na webovej stránke reštauračného zariadenia.  
• Zákazník v reštauračnom zariadení po usadení k stolu nasníma svojím mobilným zariadením QR kód na prihlásenie do lokálnej WiFi siete. Následne nasníma QR kód na stiahnutie aplikácie. Po jej nainštalovaní nasníma QR kód na prihlásenie do aplikácie. Tým bude automaticky priradený aj k danému stolu.
• Pri donáškovom režime zákazník najskôr svojím mobilným zariadením nasníma QR kód na stiahnutie aplikácie. Po jej nainštalovaní nasníma QR kód na spustenie aplikácie v režime donáškovej služby.
• Generovať QR kódy pre obsluhu môže mať využitie pri prihlásení do WiFi siete a prvotnom prihlásení do aplikácie.
• Postup vygenerovania QR kódov pre režimy LUKUL eMenu - bez možnosti objednávania, LUKUL eMenu - hosť v reštaurácii a LUKUL - mobilný čašník je k dispozícii v téme Sprievodca QR kódy stolov a aplikácie LUKUL.
• Postup vygenerovania QR kódov pre režim LUKUL eMenu - donáška je k dispozícii v téme Sprievodca QR kód donáškovej služby a aplikácie LUKUL.      

Mobilné zariadenie - inštalácia aplikácie (obsluha)

1. Aplikáciu LUKUL - nielen mobilný čašník vyhľadajte a nainštalujte do mobilného zariadenia pomocou aplikácie Obchod Play, resp. App Store. Odkaz priamo na aplikáciu je umiestnený aj na webovej stránke firmy EXALOGIC (tlačidlo Google Play/App Store).
2. Uistite sa, že mobilné zariadenie je pripojené do tej istej lokálnej počítačovej siete ako počítač, v ktorom máte nainštalovaný OBERON a na ktorom budete pracovať.
3. Otvorte aplikáciu klepnutím na ikonu na ploche mobilného zariadenia. Klepnite na ikonu  - otvorí sa ponuka Nastavenia. V časti Komunikácia zadajte nasledujúce údaje:
   - IP adresa - aktuálna IP adresa počítača a číslo komunikačného portu (TCP/IP) v programe OBERON Center v tvare: 192.168.16.17:21005,
   - názov používateľa v OBERON-e,
   - heslo používateľa v OBERON-e (ak je definované).
4. Aplikáciu LUKUL je možné používať tak v slovenskom, ako aj anglickom jazyku. Výber jazyka sa vykonáva v ponuke Nastavenia (ikona ) v časti Jazyk.
5. Stlačte tlačidlo PRIPOJIŤ. Po úspešnom nadviazaní komunikácie je nastavenie aplikácie ukončené. Otvorte aplikáciu klepnutím na ikonu na ploche mobilného zariadenia. Na výzvu povoľte aplikácii fotenie a natáčanie videí.
6. Alternatívne namiesto bodu 3 na prvotné prihlásenie obsluhy do aplikácie je možné použiť QR kód vygenerovaný podľa postupu uvedeného vyššie.
7. Na ďalšie opakované prihlásenie obsluhy do aplikácie sa zadáva PIN - Kód rýchleho prístupu nadefinovaný v bode č. 1 nastavení v OBERON-e v ponuke Servis, Používatelia, záložka Podrobnosti, Prihlásenie (pozri vyššie).

Mobilné zariadenie - inštalácia aplikácie (zákazník)

1. Aplikáciu LUKUL - nielen mobilný čašník vyhľadajte a nainštalujte do mobilného zariadenia pomocou aplikácie Obchod Play, resp. App Store. Odkaz priamo na aplikáciu je umiestnený aj na webovej stránke firmy EXALOGIC (tlačidlo Google play/App Store).
2. Na pripojenie do lokálnej počítačovej siete reštauračného zariadenia zosnímajte QR kód na pripojenie do WiFi siete (pozri časť Generovanie prístupových QR kódov vyššie).
3. Otvorte aplikáciu klepnutím na ikonu na ploche mobilného zariadenia. Na výzvu povoľte aplikácii fotenie a natáčanie videí. To umožní nasnímanie QR kódu na prihlásenie zákazníka do aplikácie.
4. Zosnímajte QR kód na prihlásenie do aplikácie (pozri časť Generovanie prístupových QR kódov vyššie).

Obrázok č. 2: Nastavenia a prihlásenie do aplikácie - obsluha pomocou PIN-u a zákazník zosnímaním QR kódu