Kompletní uživatelský manuál
Tento manuál je psaný pro běžné denní používání aplikace v praxi. Najdete zde doporučený postup práce, vysvětlení hlavních funkcí a připravené sloty pro screenshoty.
Příběh aplikace
Revize Egestas vznikla jako osobní pokus udělat praktickou Android aplikaci pro vlastní revizní práci. Původně šlo o interní nástroj pro správu kontrol elektrických spotřebičů v provozu kapely, postupně se ale rozrostl o správu elektroinstalace, měření, závad, tisk protokolů a export/import dat. Aplikaci vyvíjí jeden autor a cílem je hlavně použitelnost v reálném terénu.
1) Začínáme
- Nainstalujte aplikaci a otevřete ji.
- Nejprve si založte alespoň jednoho zákazníka.
- U zákazníka vytvořte zařízení nebo elektroinstalaci.
- Teprve potom přidávejte měření, závady a tiskové výstupy.
2) Hlavní obrazovka
Hlavní obrazovka slouží jako rozcestník do všech hlavních modulů: zákazníci, technik/přístroje, citace norem, nápověda a další systémové funkce.
01-home.png - Hlavní obrazovka.Na logo lze 5x klepnout pro otevření vývojářského menu (pokud je v aktuální verzi dostupné).
3) Editace formulářů (co přesně umí)
Prakticky každý formulář v aplikaci lze uživatelsky přizpůsobit přes položku Nastavení formuláře nebo Upravit zobrazená pole.
- Záložka Pole: název pole, jednotka, cílová sekce, zapnuto/vypnuto, viditelnost na detailu.
- Typ pole: text, číslo, výběr, dropdown (u výběru lze spravovat možnosti).
- Napojení na seznam: pole může čerpat hodnoty z uživatelského seznamu.
- Záložka Sekce: přidání/přejmenování/smazání sekce formuláře.
- Per-profil chování: jiné nastavení pro zařízení, měření, závady, elektro prvky atd.
4) Zákazníci
Modul zákazníků je výchozí bod téměř všeho. Každé zařízení i elektroinstalace se váže ke konkrétnímu zákazníkovi.
- Přidání zákazníka: otevřít seznam zákazníků, použít tlačítko přidání a uložit základní údaje.
- Detail zákazníka: obsahuje přehled zařízení, revizí, tisků a navazujících akcí.
- Doporučení: vyplňovat stabilní interní identifikátor zákazníka pro bezproblémový export/import.
02-customers-list.png - Seznam zákazníků.
03-customer-detail.png - Detail zákazníka.5) Zařízení
U každého zákazníka můžete vést seznam zařízení. V detailu zařízení se typicky provádí měření, práce se závadami a tisk.
- Každé zařízení má vlastní detail, historii měření a závad.
- K zařízení lze přikládat fotografie a vlastní QR/Barcode.
- Z detailu zařízení se spouští nejčastější pracovní akce.
04-device-detail.png - Detail zařízení.6) Měření
Měření slouží pro záznam výsledků revizní kontroly. Lze je zadávat plným formulářem i průvodcem krok za krokem.
- Plný formulář: vhodný při komplexním vyplnění všech polí.
- Průvodce: rychlé zadání po jednotlivých krocích v terénu.
- Napojení: měření může být navázáno na konkrétní zařízení nebo prvek elektroinstalace.
05-measurement-form.png - Formulář měření.
13-measurement-wizard.png - Průvodce měřením.7) Závady (2 hlavní způsoby zadání)
Závady lze vést u zařízení i u elektroinstalace.
- Samostatná závada: ručně založený záznam bez vazby na konkrétní měření.
- Závada z měření: založení přímo v kontextu měření nebo následně přes „Nevyhovuje“ akci.
- U závady je vhodné uvádět jasný stav a datum.
- Lze přikládat fotografie.
- Po opravě doporučeno navázat opravné měření.
06-defect-form.png - Formulář závady.
15-defects-overview.png - Přehled závad.8) Revize a režim měření (jak to v praxi používat)
Revize v aplikaci slouží jako kontext, ke kterému se vážou měření. Měření má vlastní pole
customerRevizeIdx, takže jde dohledat, do které revize patří.
| Scénář | Postup | Výsledek |
|---|---|---|
| Spotřebiče do revize | Otevřít revizi zákazníka a přiřadit zařízení / měřit v režimu revize. | Měření nesou vazbu na revizi a objeví se v přehledech/tisku. |
| Rychlé měření z revize | Zapnout režim měření, otevřít detail zařízení/prvku, přidat měření. | Nové měření se uloží k aktuální revizi (pokud je vybraná). |
| Doplnit existující měření | U prvků elektro lze zvolit doplnění existujícího záznamu. | Aktualizuje se stejný řádek, nevzniká duplicita. |
Režim měření lze zapínat/vypínat v menu. Aktivní revize ovlivňuje i „šedé fajky“ ve stromu elektro (indikace, že pro daný prvek existuje měření v aktuálně zvolené revizi).
14-revize-overview.png - Přehled revizí a vazeb měření.9) Elektroinstalace (strom)
Strom elektroinstalace je určen pro práci s objekty, rozvaděči a navazující strukturou prvků. Umožňuje detailní evidenci, měření, závady i exportní workflow.
- Práce probíhá přes řádky stromu a kontextové menu.
- Přes režim editace lze položky přesouvat dle pravidel struktury.
- Každý prvek může mít vlastní detail, měření, závady a fotky.
07-elektro-tree.png - Strom elektroinstalace.
08-elektro-detail.png - Detail prvku elektro.10) Symboly a barvy vyhodnocení ve stromu elektro
Vyhodnocení vychází z kombinace: aktivní/archivní revize, přítomnost měření, výsledek měření a stav závad. Po klepnutí na ikonu stavu se v aplikaci zobrazí vysvětlení.
| Ikona | Význam |
|---|---|
| Zelená fajka | Měření v aktivní revizi a stav vyhovuje. |
| Žlutá fajka | Měření je pouze v archivní revizi. |
| Žlutý křížek | Archivní měření nevyhovuje nebo je neopravená závada. |
| Šedá fajka | Existuje měření mimo revizi. |
| Šedý křížek | Měření mimo revizi nevyhovuje nebo je neopravená závada. |
| Šedý vykřičník | Nelogická/zakázaná kombinace stavů. |
| Červený křížek | Problém v aktivní nebo relevantní revizi. |
| Červený vykřičník | Závažný problém v relevantní revizi. |
| Žlutý vykřičník | Upozornění (např. platnost). |
| Žluté kolečko | Archivní historický stav. |
11) QR kódy a vlastní přiřazení
Aplikace umí pracovat jak s interním QR formátem, tak s vlastním QR/Barcode kódem zařízení.
- Interní QR: obsahuje kombinaci zákazník + zařízení (kompaktní formát
CUST|DEV). - Vlastní QR/Barcode: lze uložit k zařízení (sken kamerou nebo z obrázku).
- Skenování: aplikace nejdřív zkusí svůj QR formát, a když není použitý, hledá zařízení podle uloženého kódu.
- Párování: zařízení se dohledá podle hlavního kódu nebo podle vašeho vlastního kódu.
12) Citace norem (knihovna + vložení do závady)
- V modulu Citace norem lze záznamy přidávat, upravovat, vyhledávat a mazat.
- Při zadávání závady lze citaci vybrat přímo z databáze citací.
- Vybraná citace se propíše do polí závady a následně i do tisku.
13) Vlastní seznamy (uživatelské hodnoty)
Vlastní seznamy slouží pro jednotné hodnoty ve formulářích (např. opakující se volby).
- Seznam lze přidat, přejmenovat nebo smazat.
- Pole formuláře může být na konkrétní seznam napojené.
- Při exportu/importu se seznamy přenášejí jako samostatná datová oblast.
14) Tisk protokolů a práce se šablonami
Tisk je založený na šablonách. V nastavení je možné vybrat nebo obnovit výchozí šablony protokolů.
- Šablony musí odpovídat očekávaným placeholderům.
- Tiskové akce jsou dostupné z detailů konkrétních entit.
- Při změně šablon je vhodné udělat testovací tisk na menším vzorku dat.
12-template-settings.png - Nastavení šablon tisku.15) Placeholdery - kompletní přehled
Pro přehlednost je kompletní tabulka placeholderů na samostatné stránce: Placeholdery pro šablony.
| Kategorie | Příklady placeholderů | Použití |
|---|---|---|
| Zákazník | {customer.name}, {customer.ico}, {customer.phone} |
Protokol zákazníka, zařízení, měření, závady |
| Zařízení | {device.code}, {device.name}, {device.protClass} |
Protokol zařízení, sestavy |
| Měření | {measurement.date}, {measurement.rPe}, {measurement.resMeas} |
Protokol měření, sestavy, historie |
| Závady | {defect.title}, {defect.detectedDate}, {defect.normQuote} |
Protokol závad |
| Revize | {revize.list}, {revize.count}, {revize.line}#1 |
Přehled revizí v reportech |
| Modifikátory | :rows, #N, #last3 |
Tabulky, historie, agregace |
Na stránce placeholderů najdete přehled rozdělený podle oblastí, aby šla šablona snadno složit i bez technických znalostí.
16) Export / Import a záloha
Pro přenos dat mezi zařízeními používejte hlavně průvodce zálohou (JSON/ZIP). ZIP je doporučený formát při práci s fotkami.
- Otevřít modul Export/Import.
- Vybrat export nebo import.
- U exportu zvolit rozsah dat a případně vybrané zákazníky.
- U importu zvolit soubor a potvrdit, které bloky dat importovat.
09-export-import.png - Obrazovka Export/Import.
10-backup-wizard.png - Průvodce zálohou.17) Dobrovolný příspěvek přes Google Play
V obrazovce „O programu“ jsou k dispozici tlačítka dobrovolného příspěvku (100, 250, 500, 1000 a 2000 Kč). Platba je zpracována přes Google Play Billing.
11-about-donation.png - O programu a příspěvky.18) Typické workflow v terénu (doporučený scénář)
- Založit/otevřít zákazníka.
- Přidat zařízení a případně je přiřadit do revize.
- Zapnout režim měření a zapisovat výsledky.
- U nevyhovujícího stavu rovnou založit závadu.
- Po opravě vytvořit opravné měření.
- Vygenerovat protokoly, pak udělat ZIP zálohu.
19) Tipy a řešení problémů
- Nejde otevřít exportovaná data: ověřte, že export proběhl bez přerušení.
- Nesedí vazby po importu: zkontrolujte identifikátory zákazníků a vybraný režim kolizí.
- Nevidíte očekávané položky v tisku: zkontrolujte aktivní šablonu a vyplněná data.
- Tlačítko příspěvku je neaktivní: může jít o neaktivní produkt v Play Console.
Pokud problém přetrvá, napište na revize@egestas.cz a připojte verzi aplikace + stručný popis kroků.