Na obrazovke otvoríme naskenovaný dokument a bez problémov si prečítame jeho obsah. Vidíme nadpisy, odseky aj čísla. Keď však stlačíme klávesovú skratku na vyhľadávanie a zadáme slovo, ktoré sa na stránke preukázateľne nachádza, systém nevráti žiadny výsledok. Text sa nedá označiť ani skopírovať a dokument sa nemusí objaviť ani vo výsledkoch fulltextového vyhľadávania.…
Používateľ nahrá do firemného systému dokument s názvom „Zmluva_Novak.pdf“. O niekoľko dní nahrá rovnaký súbor znova. Systém druhé nahratie povolí a vytvorí dva samostatné dokumenty.
Kolegyňa medzitým nahrá inú zmluvu s rovnakým názvom. Systém ju bez upozornenia uloží namiesto pôvodného dokumentu. Používatelia teraz nevedia, ktorý dokument je správny, či ide o novú verziu alebo o úplne inú zmluvu.…
Používateľ potrebuje nájsť všetky zmluvy, ktoré v marci 2026 vytvorila Jana Nováková.
Vo vyhľadávaní preto vyberie autora „Jana Nováková“ a nastaví obdobie od 1. marca do 31. marca 2026. Systém zobrazí desať dokumentov.
Je to správny výsledok?
Možno áno. Najskôr však potrebujeme vedieť:
Ako testovať vyhľadávanie podľa obsahu (fulltext)
Keď do vyhľadávacieho poľa zadáme slovo alebo krátku frázu, očakávame, že systém rýchlo zobrazí správne výsledky. Málokedy pritom rozmýšľame nad tým, čo všetko musí aplikácia urobiť, aby našla hľadaný výraz v stovkách článkov, dokumentov alebo produktov.
Fulltextové vyhľadávanie neprehľadáva iba názvy alebo vopred určené hodnoty.…
Čo je fulltextové vyhľadávanie a ako funguje
Fulltextové vyhľadávanie môže na prvý pohľad pôsobiť jednoducho: používateľ zadá slovo a systém zobrazí výsledky.
Pri testovaní však nestačí overiť, že sa „niečo našlo“.
Príklad
Máme aplikáciu s článkami. Jeden z článkov obsahuje text:
„Automatizované testovanie pomáha zrýchliť regresné testy.“…
Používateľ nahrá do systému faktúru, zaradí ju do kategórie „Faktúry“, pridá tag „dodávateľ“ a vyplní rok 2026. Dokument uloží bez chyby.
Neskôr však zistí, že sa dokument nezobrazí vo výsledkoch filtrovania podľa roku. Kolegyňa navyše môže rovnakému dokumentu pridať tag „Dodávateľ“ s veľkým začiatočným písmenom. V systéme tak vzniknú dva tagy s rovnakým významom.…
Táto šablóna slúži na vytvorenie samostatnej znalostnej položky, ktorú môže používať človek, interné vyhľadávanie, AI asistent alebo RAG riešenie.
Jedna znalostná položka má riešiť jednu konkrétnu tému, postup, pravidlo alebo problém. Nemá spájať viac nesúvisiacich oblastí do jedného dokumentu.
Názov znalostnej položky:
Interný identifikátor:
Typ znalosti:
Modul alebo oblasť systému:
Produkt:
Verzia produktu:
Prostredie:
Rozsah platnosti:
Používateľská rola:
Cieľová skupina:
Séria: Ako písať dokumentáciu a manuály v IT projekte
Pracovníčka supportu riešila používateľa, ktorý sa po niekoľkých neúspešných pokusoch nemohol prihlásiť do systému. Interného AI asistenta sa opýtala:
„Ako odblokujem používateľa po troch nesprávnych heslách?“
AI jej ponúkla postup na obnovenie zabudnutého hesla.…
Séria: Ako písať dokumentáciu a manuály v IT projekte
Pracovníčka supportu sa interného AI asistenta opýtala:
„Ako môžem zákazníkovi znovu vystaviť faktúru?“
AI odpovedala konkrétnym postupom:
Príklad
Aplikácia umožňuje ukladať dokumenty do štruktúry:
Klienti
Používateľ vytvorí dokument pre Firmu A a vyberie typ „Faktúra“.
Na prvý pohľad je test jednoduchý: dokument sa uložil.
Lenže nestačí overiť, že súbor niekde existuje. Dôležité je aj to, či skončil presne tam, kde má.…
Séria: Ako písať dokumentáciu a manuály v IT projekte
Pracovníčka supportu riešila objednávku, ktorá po úspešnej platbe zostala v stave Čaká na platbu. Interného AI asistenta sa opýtala:
„Ako máme opraviť stav objednávky po úspešnej platbe?“
AI našla konkrétny postup:
Séria: Ako písať dokumentáciu a manuály v IT projekte
Interný AI asistent mal pomáhať supportu pri riešení problémov s objednávkami. Do znalostnej bázy sme preto pridali dokument, ktorý opisoval celý proces platby:
Séria: Ako písať dokumentáciu a manuály v IT projekte
Testerka požiada interného AI asistenta:
„Priprav mi testovacie scenáre pre zmenu spôsobu platby.“
AI vytvorí prehľadný zoznam testov. Overí výber platobnej metódy, úspešnú platbu, zamietnutie platby aj zobrazenie chybovej správy. Odpoveď pôsobí profesionálne a na prvý pohľad jej nič nechýba.…
Séria: Ako písať dokumentáciu a manuály v IT projekte
Používateľ nahlásil, že po odoslaní objednávky nedostal potvrdzovací e-mail.
V znalostnej báze sme našli tri dokumenty:
Prvý dokument opisoval nastavenie e-mailového servera. Druhý obsahoval zoznam udalostí, pri ktorých systém posiela notifikácie.…
Príklad
Portál zobrazuje verejné podujatia aj ich detail. Neprihlásený návštevník môže vidieť názov, dátum a miesto verejného podujatia. Zoznam účastníkov, interné poznámky, možnosť upravovať podujatie a export údajov však majú byť dostupné iba prihláseným používateľom s príslušným oprávnením.
Pri testovaní nestačí overiť, že sa anonymnému návštevníkovi nezobrazilo tlačidlo Upraviť.…
Príklad
Projektová manažérka zdieľa návrh zmluvy dvoma spôsobmi. Kolegom vo firme pošle interný link, ktorý má fungovať len po prihlásení do firemného účtu. Dodávateľovi pošle externý link s právom iba na zobrazenie a platnosťou do piatka.
Pri teste nestačí overiť, že sa dokument po kliknutí otvorí.…
Séria: Ako písať dokumentáciu a manuály v IT projekte
Firma sa rozhodne nasadiť AI asistenta pre support. Do nástroja pripojí priečinok s návodiami, export starých tiketov, FAQ a niekoľko interných dokumentov.
Po prvých otázkach prichádza sklamanie.
Používateľ sa opýta, prečo sa mu nevytvorila faktúra.…
Príklad
Aplikácia má tri používateľské roly:
Séria: Ako písať dokumentáciu a manuály v IT projekte
V piatok má ísť do produkcie verzia 2026.09.
Projektový manažér si vypýta podklad k release notes. V Jire je uzatvorená user story, niekoľko vývojových taskov a tri bugy. Špecifikácia obsahuje zmenu schvaľovania objednávok, ale v jednom bug reporte je dôležitá výnimka, ktorá sa do pôvodného návrhu vôbec nedostala.…
Príklad
V systéme na správu dokumentov existuje priečinok Projekty, do ktorého majú členovia tímu právo dokumenty zobrazovať. V jeho podpriečinku Projekty/Financie sú však citlivé rozpočty. Vedúca financií tu potrebuje upravovať dokumenty, ostatní členovia tímu ich nemajú ani vidieť.
Tester potrebuje overiť, či sa práva z nadradeného priečinka prenášajú na podpriečinky podľa nastavených pravidiel, či výnimka dedenie správne preruší a či sa obmedzenie nedá obísť priamou URL adresou alebo API.…
