ASOL HoReCa Hub je webová aplikácia, ktorá slúži ako komunikačná brána medzi externými partnermi a vašimi internými systémami pre HoReCa segment (hotely, reštaurácie, kaviarne). Poskytuje REST API pre tretie strany a administračné rozhranie na správu celej integrácie.
Aplikácia beží ako Windows služba a administrácia je dostupná cez prehliadač na adrese servera (predvolene http://localhost:8080/admin).
Čo v administrácii robíte:
| Oblasť | Popis |
|---|---|
| Dashboard | celkový prehľad — volania, chybovosť, aktívne prístupy |
| Monitoring | záznamy volaní API, štatistiky a topológia prepojení |
| Používatelia | vytváranie a spravovanie prihlasovacích účtov |
| API prístupy | prideľovanie a evidovanie prihlasovacích údajov pre partnerov |
| Cieľové systémy | konfigurácia backendov, na ktoré smerujú volania API |
| Zmena hesla | zmena prihlasovacieho hesla |
ℹ Poznámka: Konfigurácia samotného REST API (endpointy, formát dát) je daná aplikáciou a nie je editovateľná.
| Položka | Požiadavka |
|---|---|
| Nainštalovaná aplikácia | Bežiaci ASOL HoReCa Hub (nainštalovaný cez MSI alebo spustený z JAR) |
| Prehliadač | Podporované prehľiadače (Chrome, Edge, Firefox) |
| Sieť | Pripojenie k serveru, na ktorom beží aplikácia |
| Účet | Používateľ s rolou ADMIN (plná administrácia) alebo USER (zmena hesla) |
✓ Tip: Po prvej inštalácii je k dispozícii predvolený účet
admins heslomadmin. Heslo si ihneď po prihlásení zmeňte.
Administrácia je dostupná na adrese http://<server>:<port>/admin. Ak nie ste prihlásení, aplikácia vás presmeruje na prihlasovaciu stránku.
Postup:
| Situácia | Správanie |
|---|---|
| Správne údaje | Presmerovanie na dashboard (/admin) |
| Nesprávne meno alebo heslo | Červená hláška „Nesprávne meno alebo heslo." — skúste znova |
| Po odhlásení | Zelená hláška „Boli ste odhlásený." |
⚠ Dôležité: Predvolené heslo
adminje verejne známe. Po prvom prihlásení ho ihneď zmeňte v sekcii Zmena hesla (kapitola 12).
Po prihlásení sa zobrazí hlavná obrazovka administrácie. Rozhranie má tri časti — bočný panel, hornú lištu a hlavný obsah.
┌────────────┬─────────────────────────────────────────────────┐
│ │ HORNÁ LIŠTA breadcrumb · jazyk · sprievodca · rola │
│ BOČNÝ ├─────────────────────────────────────────────────┤
│ PANEL │ │
│ │ │
│ logo │ HLAVNÝ OBSAH │
│ navigácia │ (dashboard / zoznam / formulár / detail) │
│ sekcie │ │
│ │ │
│ používateľ├─────────────────────────────────────────────────┤
│ odhlásenie│ PÄTIČKA logo Asseco Solutions │
└────────────┴─────────────────────────────────────────────────┘
Navigácia je rozdelená do jednotlivých seklcií:
| Sekcia | Položky | Prístup |
|---|---|---|
| Prehľad | Dashboard | ADMIN, USER |
| Monitoring | Komunikácia API, Štatistiky, Infraštruktúra | iba ADMIN |
| Správa | Používatelia, API prístupy, Cieľové systémy, Zmena hesla | iba ADMIN (okrem Zmena hesla) |
| Nástroje | API dokumentácia (Swagger UI) | ADMIN, USER |
V spodnej časti bočného panela sa zobrazuje meno prihláseného používateľa, jeho rola a tlačidlo Odhlásiť.
| Prvok | Popis |
|---|---|
| Jazyková verzia | Výber SK / CS / EN |
| Sprievodca | Spustí interaktívneho sprievodcu aktuálnou stránkou |
| Rola | ADMIN alebo USER |
✓ Tip: Na každej stránke je k dispozícii Sprievodca — interaktívny tooltip, ktorý postupne predstaví jednotlivé časti stránky. Spustíte ho tlačidlom v hornej lište.
Dashboard (/admin) je úvodná stránka administrácie. Zobrazuje prehľad celej integrácie na jednom mieste.
V hornej časti dashboardu sa zobrazuje šesť kariet s kľúčovými ukazovateľmi:
| Karta | Čo zobrazuje |
|---|---|
| Volania za 24 h | Počet volaní API za posledných 24 hodín |
| Chybovosť | Percentuálna chybovosť za posledných 7 dní (počet chýb z celkového počtu volaní) |
| Priemerné trvanie | Priemerný čas spracovania volania v milisekundách za 7 dní |
| API prístupy | Počet aktívnych prístupov z celkového počtu |
| Cieľové systémy | Počet aktívnych cieľových systémov z celkového počtu |
| Používatelia | Celkový počet používateľov a z toho počet administrátorov |
Pod KPI kartami sú dva grafy vedľa seba:
Tabuľka najnovších volaní API s týmito stĺpcami:
| Stĺpec | Popis |
|---|---|
| Čas | Dátum a čas volania |
| Endpoint | Volaný API endpoint |
| Volajúci systém | Kto volanie odoslal (názov API prístupu alebo admin) |
| Cieľový systém | Na ktorý backend bolo smerované |
| Stav | HTTP stavový kód odpovede (farebne rozlíšený) |
| Trvanie | Čas spracovania v milisekundách |
Kliknutím na riadok prejdete na detail záznamu. Odkaz Zobraziť všetko otvorí kompletný monitoring.
V spodnej časti dashboardu sú dlaždice na rýchly prístup do hlavných sekcií:
ℹ Poznámka: Bežný používateľ (rola USER) vidí zjednodušený dashboard s uvítacím panelom a odkazmi na zmenu hesla a API dokumentáciu. KPI karty, grafy a monitorovacie údaje sú dostupné iba administrátorovi.
Sekcia Používatelia (/admin/users) slúži na správu prihlasovacích účtov do administrácie.
Zobrazuje tabuľku všetkých účtov s týmito stĺpcami:
| Stĺpec | Popis |
|---|---|
| Používateľ | Prihlasovacie meno |
| Rola | Administrátor alebo Používateľ |
| Stav | Aktívny alebo Zablokovaný |
| Vytvorený | Dátum a čas vytvorenia účtu |
| Akcie | Odkaz na úpravu |
Zoznam podporuje vyhľadávanie (fulltextové pole), zoradenie (klik na hlavičku stĺpca) a stránkovanie (10 / 20 / 50 záznamov na stránku).
| Pole | Popis |
|---|---|
| Používateľské meno | Unikátne prihlasovacie meno |
| Rola | Administrátor (plná správa) alebo Používateľ (iba zmena hesla) |
| Heslo | Minimálne 8 znakov — môžete ho zadať ručne alebo vygenerovať tlačidlom Generovať |
✓ Tip: Tlačidlo Generovať vytvorí bezpečné náhodné heslo a zobrazí ho v poli. Po uložení už nie je možné heslo zobraziť.
Kliknite na odkaz Upraviť pri danom používateľovi. V editačnom formulári môžete:
| Akcia | Popis |
|---|---|
| Zmeniť rolu | Prepnúť medzi rolami Administrátor a Používateľ |
| Zablokovať / odblokovať | Zaškrtávacie pole „Účet je aktívny" — zablokovaný používateľ sa nemôže prihlásiť |
| Resetovať heslo | Vyplňte pole „Nové heslo" (alebo kliknite Generovať) — ak pole necháte prázdne, heslo zostáva nezmenené |
Po úpravách kliknite Uložiť zmeny.
Zmazať používateľa je možné z editačného formulára. Platia tieto obmedzenia:
⚠ Dôležité: Zmazanie účtu je nevratné. Ak chcete len dočasne zabrániť prihláseniu, použite radšej blokovanie účtu (pole „Účet je aktívny").
Sekcia API prístupy (/admin/api-access) slúži na prideľovanie a správu prihlasovacích údajov, pomocou ktorých sa partneri (externé systémy) autentifikujú pri volaní REST API.
Tabuľka zobrazuje všetky nakonfigurované prístupy:
| Stĺpec | Popis |
|---|---|
| Prístup | Názov prístupu (identifikátor partnera) |
| API | Na ktoré API prístup platí (BlueWS, WellnessStandard alebo Všetky) |
| Typ | Spôsob autentifikácie (Bearer, Basic, X-API-Key, Vlastná hlavička) |
| Hlavička | Názov hlavičky (relevantné pre typ Vlastná hlavička) |
| Systém | Priradený cieľový systém (backend) |
| Stav | Aktívny alebo Neaktívny |
| Vytvorený | Dátum a čas vytvorenia |
| Akcie | Odkaz na úpravu |
| Pole | Popis |
|---|---|
| Názov prístupu | Identifikátor partnera (napr. „Partner XY — produkcia") |
| API | Na ktoré API prístup platí — BlueWS API, WellnessStandard API alebo Všetky API |
| Typ prístupu | Spôsob autentifikácie (viď tabuľka nižšie) |
| Cieľový systém | Backend, na ktorý sa budú smerovať volania s týmto prístupom — alebo „Žiadny (nesmerované)" |
| Kľúč / token | Pre potreby autentifikácie — zadajte ručne alebo vygenerujte tlačidlom Generovať |
| Poznámka | Voliteľná interná poznámka |
| Aktívny | Zaškrtávacie pole — neaktívny prístup odmietne všetky volania |
| Typ | Čo partner posiela | Dodatočné polia vo formulári |
|---|---|---|
| Bearer token | Hlavička Authorization: Bearer <kľúč> |
Kľúč / token |
| Basic auth | Hlavička Authorization: Basic <base64(meno:heslo)> |
Používateľské meno + Kľúč / token (ako heslo) |
| X-API-Key | Hlavička X-API-Key: <kľúč> |
Kľúč / token |
| Vlastná hlavička | Hlavička <vlastný-názov>: <kľúč> |
Názov vlastnej hlavičky + Kľúč / token |
Pri zmene typu prístupu vo formulári sa dynamicky zobrazujú iba relevantné polia a pod poľom kľúča sa aktualizuje popis formátu hlavičky.
✓ Tip: Vygenerovaný kľúč poskytnite bezpečnou formou partnerovi. Po uložení ho nie je možné zobraziť.
Každému prístupu môžete priradiť cieľový systém — backend, na ktorý sa budú volania smerovať. Ak prístup nemá priradený systém, volania vrátia odpoveď HTTP 501 (nie je nakonfigurované).
⚠ Dôležité: Prístup bez priradeného cieľového systému je funkčný z pohľadu autentifikácie (partner sa overí), no volanie sa nemá kam poslať. Nezabudnite priradiť systém pred nasadením do prevádzky.
Sekcia Cieľové systémy (/admin/target-systems) slúži na evidenciu backendov, na ktoré sa smerujú volania publikovaných API.
Tabuľka zobrazuje všetky nakonfigurované backendy:
| Stĺpec | Popis |
|---|---|
| Systém | Názov cieľového systému |
| Typ | Typ backendu (napríklad BlueGastro) |
| Pripojenie | Host a port backendu |
| Stav | Aktívny alebo Neaktívny |
| Vytvorený | Dátum a čas vytvorenia |
| Akcie | Odkaz na úpravu |
| Pole | Popis |
|---|---|
| Názov systému | Popisný názov (napr. „BlueGastro — pobočka Bratislava") |
| Typ systému | Typ backendu — BlueGastro |
| Host | IP adresa alebo hostname servera backendu |
| Port | Port, na ktorom backend počúva |
| Názov aplikácie | Názov aplikácie na backende (parameter pre registráciu klienta) |
| Prefix klienta | Prefix pre identifikáciu klienta na backende |
| Vyžadovať bežiacu aplikáciu | Ak je zaškrtnuté, pri registrácii klienta sa overí, či inštancia backendu skutočne beží |
| Poznámka | Voliteľná interná poznámka |
| Aktívny | Neaktívny systém zostáva v evidencii, no volania sa naň nesmerujú (vrátia HTTP 501) |
⚠ Dôležité: Po vytvorení cieľového systému ho nezabudnite priradiť k API prístupu (sekcia API prístupy) — inak sa volania na tento backend nedostanú.
Sekcia Komunikácia API (/admin/monitoring) zobrazuje záznamy o všetkých volaniach publikovaných REST API.
Tabuľka obsahuje záznamy s týmito stĺpcami:
| Stĺpec | Popis |
|---|---|
| Čas | Dátum a čas prijatia volania |
| Endpoint | Volaný API endpoint (cesta) |
| Volajúci systém | Kto volanie odoslal (názov API prístupu, admin alebo anonymné) |
| Cieľový systém | Na ktorý backend bolo smerované |
| Stav | HTTP stavový kód odpovede (farebne rozlíšený podľa kategórie) |
| Trvanie | Čas spracovania v milisekundách |
| Akcie | Odkaz na detail záznamu |
Zoznam podporuje:
Kliknutím na záznam v zozname sa otvorí stránka s kompletným detailom volania, rozdelená do troch panelov:
1. Prehľad
| Údaj | Popis |
|---|---|
| Stavový kód | HTTP stav odpovede s farebným indikátorom (zelená = 2xx, žltá = 3xx/4xx, červená = 5xx) |
| Čas prijatia | Dátum a čas, kedy bolo volanie prijaté |
| Trvanie | Čas spracovania v milisekundách |
| HTTP metóda | GET, POST, PUT, DELETE a pod. |
| Endpoint | Plná cesta volaného endpointu |
| Cieľové API | Na ktoré API volanie smerovalo |
| Úspech | Áno / Nie |
| Volajúci systém | Názov prístupu alebo admin |
| Typ volajúceho | Typ autentifikácie (Bearer, Basic, Admin a pod.) |
| Cieľový systém | Názov priradeného backendu |
| IP klienta | IP adresa volajúceho |
| ID záznamu | Interný identifikátor záznamu |
Ak volanie skončilo chybou, zobrazí sa aj červený panel s chybovou hláškou.
2. Požiadavka
3. Odpoveď
ℹ Poznámka: Telá požiadavky a odpovede sa zaznamenávajú len ak je to povolené v konfigurácii (
capture-request-body,capture-response-body). Maximálna dĺžka zaznamenaného tela je predvolene 16 384 znakov.
Sekcia Štatistiky (/admin/monitoring/stats) poskytuje grafický prehľad komunikácie API za zvolené obdobie.
V hornej časti stránky vyberte obdobie:
| Voľba | Rozsah |
|---|---|
| Posledných 7 dní | Posledný týždeň |
| Posledných 14 dní | Posledné dva týždne (predvolené) |
| Posledných 30 dní | Posledný mesiac |
| Posledných 90 dní | Posledný štvrťrok |
Päť kariet s hodnotami za zvolené obdobie:
| Karta | Čo zobrazuje |
|---|---|
| Celkové volania | Celkový počet volaní za obdobie |
| Chybové volania | Počet chybových volaní a percentuálna chybovosť |
| Priemerné trvanie | Priemerný čas spracovania v milisekundách |
| Najdlhšie trvanie | Maximum (najpomalšie volanie) v milisekundách |
| Volania za 24 h | Počet volaní za posledných 24 hodín |
Pod KPI kartami sa zobrazujú štyri grafy:
| Graf | Čo zobrazuje |
|---|---|
| Vývoj volaní v čase | Čiarový graf — počet volaní a chýb po dňoch |
| Podľa stavového kódu | Rozloženie HTTP odpovedí (2xx, 3xx, 4xx, 5xx) |
| Podľa typu volajúceho | Kto volal API (ktoré prístupy, admin) |
| Podľa cieľového systému | Kam smerovali volania (ktoré backendy) |
V spodnej časti stránky sú dva rebríčky:
✓ Tip: Ak za zvolené obdobie nie sú žiadne záznamy, zobrazí sa hláška „Za zvolené obdobie nie sú žiadne monitorovacie záznamy." Skúste rozšíriť obdobie alebo overte, či monitoring je zapnutý.
Sekcia Infraštruktúra (/admin/monitoring/topology) zobrazuje vizuálnu mapu celej integrácie — kto sa pripája, cez čo komunikuje a kam volania smerujú.
Diagram zobrazuje prepojenia v troch vrstvách zľava doprava:
┌─────────────┐ ┌────────────────────┐ ┌──────────────────┐
│ API klienti │ ───→ │ ASOL HoReCa Hub │ ───→ │ Cieľové systémy │
│ (prístupy) │ │ (publikované API) │ │ (backendy) │
└─────────────┘ └────────────────────┘ └──────────────────┘
Šípky medzi uzlami znázorňujú toky dát a ich objem za zvolené obdobie.
| Farba | Význam |
|---|---|
| Aktívne | Prístup je aktívny a má priradený cieľový systém |
| Bez smerovania | Prístup je aktívny, ale nemá priradený backend |
| Vypnuté | Prístup alebo systém je neaktívny |
V hornej časti stránky sú súhrnné čísla:
Rovnako ako v štatistikách, aj tu môžete zvoliť obdobie, za ktoré sa zobrazujú objemy tokov: 7 dní, 30 dní alebo 90 dní.
Každý uzol brány a backendu má tlačidlo Overiť, ktoré spustí TCP kontrolu dosiahnuteľnosti host:port. Výsledok sa zobrazí ako farebný semafor:
| Semafor | Význam |
|---|---|
| 🟢 zelená | Systém je dostupný |
| 🟠 oranžová | Systém odpovedá pomaly alebo nemá priradené smerovanie |
| 🔴 červená | Systém nie je dostupný alebo je vypnutý |
| ⚫ sivá | Stav nebol zistený |
Tlačidlo Overiť dostupnosť v hornej časti stránky spustí kontrolu všetkých uzlov naraz.
✓ Tip: Ak topológia zobrazuje hlášku „Žiadna konfigurácia na zobrazenie", pridajte najprv cieľové systémy a API prístupy. Diagram sa generuje dynamicky z aktuálnej konfigurácie.
a hesla
Sekcia Zmena hesla (/admin/account/password) umožňuje zmeniť prihlasovacie heslo aktuálne prihláseného používateľa.
Postup:
| Pole | Popis |
|---|---|
| Súčasné heslo | Vaše aktuálne heslo (overenie identity) |
| Nové heslo | Nové heslo — minimálne 8 znakov |
| Potvrdenie nového hesla | Zopakujte nové heslo |
ℹ Poznámka: Každý používateľ môže meniť iba svoje vlastné heslo. Administrátor môže resetovať heslo iného používateľa cez sekciu Používatelia (kapitola 6).
V hornej lište kliknite na aktuálny jazyk (vlajka + názov) a vyberte z ponuky:
| Kód | Jazyk |
|---|---|
| SK | Slovenčina |
| CS | Čeština |
| EN | English |
Voľba sa prejaví okamžite a platí pre celé rozhranie vrátane prihlasovacej stránky.
Kliknite na tlačidlo Odhlásiť v spodnej časti bočného panela (ikona odhlásenia vedľa mena používateľa). Zobrazí sa prihlasovacia stránka so zelenou hláškou „Boli ste odhlásený."
✓ Tip: Po ukončení práce sa vždy odhláste, najmä ak k počítaču majú prístup aj iné osoby.
Odkaz API dokumentácia v bočnom paneli (sekcia Nástroje) otvorí Swagger UI (/swagger-ui.html) — interaktívnu dokumentáciu všetkých publikovaných REST API.
V Swagger UI môžete:
✓ Tip: Swagger UI je verejne dostupný (nie je potrebné prihlásenie do administrácie). Partneri ho môžu používať na overenie funkčnosti API so svojimi pridelenými údajmi.
Skontrolujte, že zadávate správne meno a heslo. Ak ste zabudli heslo, požiadajte iného administrátora o reset v sekcii Používatelia. Ak je účet zablokovaný, administrátor ho musí odblokovať (zaškrtávacie pole „Účet je aktívny").
KPI karty ukazujú nuly a graf je prázdny, ak za sledované obdobie neprebehli žiadne volania API. Overte, že partneri volajú API a monitoring je zapnutý (konfigurácia monitoring.enabled: true).
Monitoring zaznamenáva iba volania na /api/.... Prihlásenia do administrácie a prístupy na Swagger UI sa nezaznamenávajú. Overte tiež, že monitoring nie je vypnutý v konfigurácii.
Prístup partnera musí byť aktívny, nastavený na správne API a kľúč/heslo musí byť správne zadané. Skontrolujte záznam v sekcii API prístupy a overte, že partner posiela správnu hlavičku.
Volanie bolo autentifikované, ale prístup nemá priradený cieľový systém. Otvorte API prístupy, upravte daný prístup a priraďte mu backend.
Diagram sa generuje z aktuálnej konfigurácie. Ak nie sú nakonfigurované žiadne cieľové systémy alebo API prístupy, zobrazí sa hláška „Žiadna konfigurácia na zobrazenie."
Cieľový systém nie je dosiahnuteľný na zadanom host:port. Overte, že backend beží, adresa a port sú správne a sieťová trasa medzi serverom ASOL HoReCa Hub a backendom je priechodná (firewall, routing).
Záznamy staršie ako 90 dní (predvolene) sa automaticky mažú. Toto nastavenie je konfigurovateľné — viď implementačnú dokumentáciu, sekcia Konfigurácia monitoringu.