Pracovníčka odošle z dokumentového systému návrh zmluvy na schválenie. Vedúci dostane e-mail s odkazom na dokument a možnosťou schváliť ho alebo zamietnuť.
Medzitým autorka nahrá novú verziu zmluvy. Vedúci však otvorí pôvodný e-mail a klikne na schválenie.
Ktorú verziu systém schváli? Má vedúci ešte oprávnenie rozhodnúť?…
V predchádzajúcom článku sme sledovali, ako internetový obchod požiada skladový systém o informáciu o produkte. Po odoslaní požiadavky príde odpoveď. Čo však aplikácia z tejto odpovede skutočne zistí?
Nestačí jej vedieť, že server niečo poslal späť. Potrebuje rozpoznať, či požiadavka uspela, aké údaje dostala a či ich dokáže použiť.…
Keď v internetovom obchode otvoríme detail produktu, vidíme jeho názov, cenu a dostupnosť. Tieto údaje nemusia pochádzať z jednej aplikácie. Obchod môže zobraziť produkt zo svojho katalógu, no informáciu o počte kusov si vyžiadať zo skladového systému. Aby si systémy navzájom rozumeli, musia mať dohodnuté pravidlá komunikácie.…
Príklad
Vo firemnom úložisku je schválená smernica. Po vydaní novej verzie sa pôvodná presunie do archívu, aby ju zamestnanci nepoužívali pri bežnej práci. Oprávnení ľudia ju však stále potrebujú nájsť pri kontrole. Po uplynutí stanovenej lehoty môže systém spustiť ďalší krok: upozornenie, posúdenie alebo odstránenie.
Chyba nemusí znamenať iba to, že starý dokument zostal na svojom mieste.…
Príklad
V systéme na správu dokumentov zmení editorka pri zmluve stav z „Na schválenie“ na „Schválené“. V histórii sa objaví nový riadok. Stačí to?
Z auditného logu potrebujem vedieť, ktorý dokument sa zmenil, kto zmenu vykonal, čo presne sa zmenilo a kedy. Skontrolujem aj to, či záznam zostane správny pri neúspešnej operácii, súbežnej práci a zmene vykonanej mimo obrazovky dokumentu.…
Séria: Ako písať dokumentáciu a manuály v IT projekte
Pracovníčka supportu sa interného AI asistenta opýta: „Kedy sa servisná požiadavka automaticky uzavrie?“ Asistent odpovie: „Po piatich dňoch bez reakcie zákazníka.“
Odpoveď vychádza zo skutočného dokumentu. Päťdňové automatické uzavretie však platí iba pre jedného zákazníka s úpravou systému na mieru.…
Príklad
V systéme na správu dokumentov je uložená interná smernica. Anna ju upraví a uloží novú verziu. Boris má k smernici prístup a sleduje jej zmeny, preto má dostať upozornenie. Externá spolupracovníčka prístup nemá a o zmene sa nemá dozvedieť.
Skôr než začneme testovať doručenie, potrebujeme vedieť, ktorá udalosť má notifikáciu spustiť.…
Séria: Ako písať dokumentáciu a manuály v IT projekte
Tím chce, aby interný AI asistent pomáhal supportu pri chybách synchronizácie objednávok. Vyberie existujúce návody, support záznamy a release notes a sprístupní ich RAG systému.
Pri skúšobnej otázke „Môžem po chybe spustiť synchronizáciu objednávky znova?“…
Séria: Ako písať dokumentáciu a manuály v IT projekte
Predstavme si, že pracovníčka supportu sa interného AI asistenta opýta: „Môžem po chybe synchronizácie objednávky spustiť synchronizáciu ručne znova?“
Asistent nájde support položku o tejto chybe. Dokument vysvetľuje, ktoré údaje treba skontrolovať a kedy incident odovzdať integračnému tímu.…
Séria: Ako písať dokumentáciu a manuály v IT projekte
Pracovníčka supportu sa interného AI asistenta opýtala, ako riešiť neúspešnú synchronizáciu objednávky. Dostala použiteľný postup, ale aj časť internej poznámky: meno zákazníka, identifikátor jeho objednávky a informáciu o zmluvne dohodnutej výnimke.
Postup bol vecne správny.…
Séria: Ako písať dokumentáciu a manuály v IT projekte
Po vydaní novej verzie systému sa zmenil postup prideľovania používateľských oprávnení. Predtým mohol administrátor prideliť rolu priamo. Nový postup vyžadoval najprv schválenie žiadosti zodpovednou osobou.
Administrátorský manuál bol aktualizovaný. V znalostnej báze však zostala staršia support položka s pôvodným postupom.…
Séria: Ako písať dokumentáciu a manuály v IT projekte
Support sa spýta interného AI asistenta: „Môžem po chybe zopakovať import faktúr?“
Asistent nájde administrátorskú príručku a odpovie: „Áno. Opravte súbor a spustite import znova.“
V príručke však postup závisí od toho, v akom stave sa import skončil.…
Séria: Ako písať dokumentáciu a manuály v IT projekte
ADR (Architecture Decision Record) je stručný záznam významného architektonického rozhodnutia, ktorý uchováva dôvod rozhodnutia, zvažované možnosti a jeho očakávané dôsledky.
Tím sa rozhodol zmeniť spracovanie fakturácie. Namiesto priameho volania fakturačnej služby má objednávkový systém posielať správy cez message broker.…
Séria: Ako písať dokumentáciu a manuály v IT projekte
ADR (Architecture Decision Record) je stručný záznam významného architektonického rozhodnutia, ktorý zachytáva jeho dôvod, zvažované možnosti a dôsledky.
V technickej dokumentácii je aktuálny diagram systému.
Objednávka sa uloží cez Order API. Následne sa správa odošle do message brokera, odkiaľ ju spracuje fakturačná služba a notifikačný modul.…
Príklad
Predstav si firemný dokument, napríklad novú smernicu pre vybavovanie reklamácií.
Autor pripraví návrh a odošle ho na odbornú kontrolu. Recenzent dokument skontroluje a vráti ho na doplnenie. Autor zapracuje pripomienky a odošle novú verziu. Vedúci oddelenia ju schváli a správca dokumentov následne zverejní zamestnancom.
Proces na prvý pohľad funguje.…
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.“…
