Bežné chyby
HTTP chyby
401 Unauthorized
| Príznak | API požiadavky vracajú 401, alebo používateľské rozhranie neočakávane presmeruje na prihlasovaciu stránku |
| Príčina | Vaša OAuth2 relácia vypršala alebo je token neplatný |
| Riešenie | Odhláste sa a znova prihláste. Ak problém po opätovnom prihlásení pretrváva, vymažte cookies prehliadača a localStorage pre doménu OpSee a prihláste sa znova. Pre viac detailov pozri Problémy s prihlásením. |
403 Forbidden
| Príznak | Stránka sa načíta, ale údaje sa nezobrazujú, alebo akcia vracia chybu 403 |
| Príčina | Váš Keycloak účet nemá požadovanú rolu pre tento zdroj |
| Riešenie | Kontaktujte svojho administrátora Keycloak na overenie priradenia rolí. Skontrolujte svoje aktuálne roly v Profil → Roly a oprávnenia. Bežne potrebné roly: menu:production, equipment:view, menu:admin. |
404 Not Found
| Príznak | Stránka alebo API endpoint vracia 404 |
| Príčina | URL neexistuje (preklep, zastaraná záložka) alebo modul nie je nasadený v tejto inštancii |
| Riešenie | Prejdite na stránku z hlavného menu. Ak chýba samotná položka menu, funkcia nemusí byť vo vašom nasadení povolená, kontaktujte svojho administrátora. |
500 Internal Server Error
| Príznak | Akcia zlyhá s generickou chybovou správou servera |
| Príčina | Neošetrená výnimka v backend API |
| Riešenie | Skontrolujte logy backend kontajnera (docker logs opsee-fastapi). Ak je chyba reprodukovateľná, poznačte si presnú akciu, ktorá ju spúšťa, a nahláste ju svojmu administrátorovi s časovou pečiatkou, aby mohol skorelovať záznam logu. |
502 Bad Gateway / 503 Service Unavailable
| Príznak | Celá aplikácia zobrazuje chybovú stránku 502 alebo 503 |
| Príčina | Backend služba alebo jedna z jej závislostí (databáza, Keycloak) je vypnutá alebo ešte nebola spustená |
| Riešenie | Spustite docker ps na serveri, aby ste zistili, ktoré kontajnery bežia. Reštartujte zastavené kontajnery pomocou docker compose up -d. Ak je problém v databáze, skontrolujte vyčerpanie diskového priestoru alebo chyby limitu pripojení. |
Sieťové chyby
„Nedá sa pripojiť" / Sieťová chyba
| Príznak | Volania API zlyhávajú so sieťovou chybou v konzole prehliadača; nevracia sa žiadny HTTP stavový kód |
| Príčina | Backend kontajner OpSee nebeží alebo NGINX reverzný proxy ho nedokáže dosiahnuť |
| Riešenie | Overte, či bežia Docker kontajnery: docker ps. Ak backend kontajner skončil, prezrite jeho logy pomocou docker logs opsee-fastapi. Reštartujte pomocou docker compose up -d. |
Chyby validácie formulára
Povinné pole / neplatný formát
| Príznak | Formulár odmietne odoslanie a zvýrazní polia červenou |
| Príčina | Povinné pole je prázdne, hodnota nezodpovedá očakávanému formátu (napr. dátumové pole obsahuje text), alebo vstup prekračuje maximálnu dĺžku |
| Riešenie | Vyplňte všetky zvýraznené polia. Venujte pozornosť pokynom k formátu zobrazeným pod každým poľom. |
Duplicitný záznam
| Príznak | Formulár sa odošle, ale vráti chybu typu „už existuje" alebo „duplicitný kľúč" |
| Príčina | Záznam s rovnakým unikátnym identifikátorom (názov, kód, atď.) už existuje v databáze |
| Riešenie | Použite inú hodnotu pre unikátne pole, alebo upravte existujúci záznam namiesto vytvorenia nového. |