Dokumentácia a používateľské príručky, Úvod do dokumentácie

Core vs Custom: najväčší tichý problém dokumentácie v produktových firmách

Séria: Ako písať dokumentáciu a manuály v IT projekte

V predchádzajúcich článkoch sme si ukázali dve veci:

  • prečo manuál nie je univerzálny dokument,
  • a čo sa deje vo firmách, kde dokumentácia neexistuje.

Teraz sa pozrime na problém, ktorý je menej viditeľný – ale v produktových firmách veľmi častý.…

Ako testovať..., Cestné mýto, diaľničné známky a cestná daň, Dáta, databáza a logovanie, Konkrétne oblasti, Všeobecné témy

Ako testovať zahraničné evidenčné čísla vozidiel

Príklad

Predstav si systém, ktorý kontroluje diaľničnú známku alebo mýto podľa evidenčného čísla vozidla (EČV).
Používateľ zadá číslo vozidla pri nákupe známky, kamera ho neskôr načíta na diaľnici a systém overí, či je známka platná.

Na prvý pohľad ide o jednoduchý údaj. V praxi však nastávajú problémy:

  • rôzne štáty používajú iné formáty ŠPZ
  • niektoré krajiny používajú diakritiku alebo špeciálne znaky
  • niekde sa používajú medzery alebo pomlčky
  • kamerové systémy môžu znaky zameniť (0/O, 1/I, B/8)

Ak systém tieto rozdiely nezvládne, môže vzniknúť chyba: vodič zaplatí známku, ale kontrolný systém jeho vozidlo neidentifikuje správne a označí ho ako neplatiča.…

Ako testovať..., Notifikácie a komunikácia so zákazníkom, Všeobecné témy

Ako testovať komunikáciu so zákazníkom pri porušení pravidiel

Príklad
Predstav si situáciu v online službe – napríklad parkovanie, prenájom auta alebo predplatné služby.
Zákazník poruší pravidlá: napríklad prekročí čas parkovania, jazdí bez platného lístka alebo poruší podmienky používania služby.

Systém automaticky odošle e-mail alebo SMS:
„Porušili ste podmienky služby. Bude vám účtovaná pokuta.“

Ak je komunikácia nejasná, zákazník nevie:

  • čo presne porušil,
  • kedy sa to stalo,
  • ako môže situáciu vyriešiť.
Ako testovať..., Bankové a platobné procesy, Cestné mýto, diaľničné známky a cestná daň, Konkrétne oblasti

Ako testovať reklamácie a refundácie mýta

Príklad
Vodič kamióna zistí, že mu systém naúčtoval mýto dvakrát za ten istý úsek. Podá reklamáciu cez zákaznícky portál, priloží evidenčné číslo prejazdu a čaká na vyjadrenie.

Ak systém nesprávne spáruje prejazdy, neoverí duplicitu alebo refundáciu pošle na nesprávny účet, problém sa neobmedzí len na jednu chybu v účtovaní – zasiahne účtovníctvo, reporting aj dôveru zákazníka.…

Dokumentácia a používateľské príručky, Úvod do dokumentácie

Nie je manuál ako manuál – pre koho vlastne píšeme dokumentáciu

(Web verzia – rozšírený článok do série „Dokumentácia ako súčasť kvality produktu“)

Reálny problém z praxe

Vo firme zaznie veta:

„Treba napísať manuál.“

Nikto sa nepýta:

  • Pre koho?
  • Na aký účel?
  • V akej situácii sa bude používať?

Výsledok?

Jeden dokument, ktorý obsahuje:

  • popis funkcionality,
  • screenshoty pre používateľa,
  • technické detaily o databáze,
  • interné poznámky pre support,
  • a na konci vetu „v prípade problému kontaktujte podporu“.
Ako testovať..., Bankové a platobné procesy, Cestné mýto, diaľničné známky a cestná daň, Konkrétne oblasti

Ako testovať generovanie faktúr za cestné mýto

Príklad

Predstav si dopravnú spoločnosť, ktorá dostane mesačnú faktúru za prejazdy po spoplatnených úsekoch.
Faktúra obsahuje desiatky položiek – dátum, čas, úsek, sadzbu podľa hmotnosti vozidla, emisnú triedu a výslednú sumu.

Na prvý pohľad sedí celková suma.
Ale účtovníčka si všimne, že pri dvoch prejazdoch je použitá nesprávna sadzba pre nápravový počet.…

Ako testovať..., Cestné mýto, diaľničné známky a cestná daň, Doprava a logistika

Ako testovať platby za mýto (preddavok vs. vyúčtovanie)

Ako otestovať

  1. Prepaid režim (preddavok)
    1. Dobitie kreditu
      • Over správne pripísanie sumy na účet používateľa.
      • Skontroluj zaokrúhľovanie, menu a DPH.
      • Sleduj stav účtu pred a po dobití (auditný log).
    2. Odpočítavanie mýta
      • Simuluj prejazdy rôznych úsekov (rôzna sadzba, nápravy, emisná trieda).
      • Over, že sa suma odpočítava okamžite a správne.
Ako testovať..., Cestné mýto, diaľničné známky a cestná daň, Dáta, databáza a logovanie, Doprava a logistika, Konkrétne oblasti, Všeobecné témy

Ako testovať chybné účtovanie pri vjazde/výjazde

Príklad
Predstav si mýtny systém, kde sa cena vypočíta podľa prejdeného úseku medzi vjazdom a výjazdom. Vozidlo vojde na úsek A, vyjde na úseku C, ale systém mu naúčtuje úsek až po D.
Alebo opačný prípad – vozidlo vojde, no výjazd sa nezaznamená a zákazníkovi sa po čase naúčtuje maximálna tarifa.…

Ako testovať..., Cestné mýto, diaľničné známky a cestná daň, Doprava a logistika, Integrácie, API a externé služby, Konkrétne oblasti, Všeobecné témy

Ako testovať prejazd bez zastavenia (ENC, free-flow)

Príklad
Predstav si úsek diaľnice, kde už nie sú závory ani mýtne brány. Vozidlo prejde pod portálom a systém automaticky načíta údaje z palubnej jednotky (ENC) alebo z kamerového systému (free-flow).
Vodič nič neplatí na mieste – suma sa zaúčtuje dodatočne podľa prejdeného úseku.

Na papieri jednoduché.…

Ako testovať..., Cestné mýto, diaľničné známky a cestná daň, Dáta, databáza a logovanie, Doprava a logistika, Konkrétne oblasti, Všeobecné témy

Ako testovať spracovanie prejazdov v špičke (sezónna záťaž)

Príklad
Predstav si prvý júlový víkend. Polovica krajiny vyráža na dovolenku, tranzit cez Slovensko je silný a mýtny systém spracúva tisíce prejazdov za minútu.
Bežne systém funguje stabilne. No v špičke sa ukáže realita: oneskorené párovanie prejazdov, duplicitné záznamy, oneskorené notifikácie o nedoplatku.

V takýchto situáciách netestujeme funkčnosť jednej obrazovky.…

Ako testovať..., Cestné mýto, diaľničné známky a cestná daň, Doprava a logistika, Integrácie, API a externé služby, Konkrétne oblasti, Všeobecné témy

Ako testovať výpadok signálu palubnej jednotky (OBU)

Vozidlo prechádza mýtnym úsekom, no palubná jednotka (OBU) stratí GPS signál v tuneli.
Po výjazde zo zóny sa signál obnoví, ale systém zaznamená len časť trasy. Výsledok?
Nesprávne vypočítané mýto, reklamácia dopravcu a otázka: kto je zodpovedný – zariadenie, infraštruktúra alebo backend?

Výpadok signálu nie je výnimočná situácia.…

Ako testovať..., Cestné mýto, diaľničné známky a cestná daň, Doprava a logistika, Konkrétne oblasti

Ako testovať palubné jednotky (OBU) pre cestné mýto

Príklad
Predstav si dopravcu, ktorý prechádza mýtnym úsekom. Vozidlo má nainštalovanú palubnú jednotku (OBU), ktorá má zaznamenať prejazd, vypočítať poplatok podľa úseku, náprav a emisnej triedy a odoslať údaje do centrálneho systému.
Ak OBU stratí GPS signál v tuneli, nesprávne identifikuje vozidlo alebo odošle duplicitné dáta, môže dôjsť k nesprávnemu účtovaniu – buď k podúčtovaniu (strata príjmu), alebo k preúčtovaniu (reklamácie, pokuty, reputačné riziko).…

Ako testovať..., Cestné mýto, diaľničné známky a cestná daň, Doprava a logistika, Konkrétne oblasti

Ako testovať kategorizáciu vozidiel v mýtnom systéme

V Európe neexistuje jednotný model spoplatnenia ciest – a práve to je pre testera dôležité. Na Slovensku, v Česku, Rakúsku, Maďarsku, Rumunsku či Bulharsku používajú osobné vozidlá systém časovej diaľničnej známky, zatiaľ čo nákladné vozidlá nad stanovenú hmotnosť podliehajú elektronickému mýtu podľa prejdenej vzdialenosti. Podobne funguje aj Slovinsko.…

Ako testovať..., Cestné mýto, diaľničné známky a cestná daň, Doprava a logistika, Konkrétne oblasti

Ako testovať mýto podľa hmotnosti, náprav a emisnej triedy

Príklad
Predstav si nákladné vozidlo nad 3,5 t, ktoré prechádza mýtnym úsekom. Výška poplatku závisí od troch faktorov: hmotnosť vozidla, počet náprav a emisná trieda (EURO).

Ak je v systéme zle nastavená emisná trieda alebo počet náprav, výsledkom môže byť nesprávne vyúčtovanie – buď finančná strata prevádzkovateľa, alebo reklamácia dopravcu.…

Ako testovať..., Cestné mýto, diaľničné známky a cestná daň, Doprava a logistika, Konkrétne oblasti

Ako testovať výpočet cestného mýta podľa prejazdu

Príklad

Predstav si dopravcu, ktorý prejde úsekom diaľnice medzi dvoma mýtnymi bránami.
Systém zaznamená vstupný bod, výstupný bod, kategóriu vozidla a vypočíta cenu podľa počtu kilometrov.

Ak sa však nezapočíta jeden prejazd, alebo sa zle priradí kategória nápravy, výsledkom je nesprávna fakturácia.
Pri tisícoch prejazdov denne môže chyba znamenať výraznú finančnú stratu alebo reklamácie dopravcov.…

Ako testovať..., Cestné mýto, diaľničné známky a cestná daň, Doprava a logistika, Konkrétne oblasti

Ako testovať notifikácie o končiacej platnosti známky

Príklad

Používateľ si kúpil 30-dňovú diaľničnú známku.
Tri dni pred koncom platnosti má dostať e-mail a SMS s upozornením, že známka čoskoro vyprší, spolu s odkazom na predĺženie.

V praxi však môže nastať:
– notifikácia príde neskoro (alebo vôbec),
– príde dvakrát,
– obsahuje zlý dátum,
– príde používateľovi, ktorý si už známku predĺžil.…

Ako testovať..., Cestné mýto, diaľničné známky a cestná daň, Doprava a logistika, Konkrétne oblasti

Ako testovať výnimky z povinnosti diaľničnej známky

Príklad
Predstav si vozidlo, ktoré má zo zákona výnimku z povinnosti diaľničnej známky (napr. vozidlo ZŤP, záchranná služba alebo vozidlo štátneho orgánu).
V systéme je výnimka evidovaná, ale pri prejazde kamerovým úsekom je vozidlo vyhodnotené ako neplatiace.
Výsledok? Automaticky vygenerovaná pokuta, reklamácia, manuálne preverovanie a strata dôvery v systém.…

Ako testovať..., Cestné mýto, diaľničné známky a cestná daň, Doprava a logistika, Konkrétne oblasti

Ako testovať jazdu s neplatnou alebo chybne zadanou diaľničnou známkou

Príklad

Predstav si vodiča, ktorý si kúpil diaľničnú známku online, ale pri zadávaní ŠPZ urobil preklep (napr. zamenil znak alebo vynechal pomlčku).
Na diaľnicu vyrazí v presvedčení, že má všetko v poriadku. Kamerový systém ho však vyhodnotí ako vozidlo bez platnej známky a automaticky spustí proces pokuty.…

Návrat hore