Mermaid z pohľadu analytika
Prečo som ako analytik prestal kresliť diagramy myšou a začal ich písať v textovom editore — a čo mi to prinieslo.
Keď som prvýkrát videl Mermaid, pôsobil ako hračka pre vývojárov. Po pár mesiacoch každodenného používania som zistil, že je to jeden z najpraktickejších nástrojov, aké môže mať biznis analytik v rukách.
Prečo vôbec textový diagram?
Ako analytik kreslím veľa: procesné toky, sekvencie volaní medzi systémami, dátové modely, stavové diagramy. Klasické nástroje (draw.io, Visio, Miro) sú silné, ale majú dve slabiny:
👉 Diagram žije mimo dokumentácie. Skončí ako PNG v zdieľanom disku a o tri mesiace nikto nevie, kde je zdroj.
👉 Zmena = znova ťahať myšou. Pridať jeden krok do procesu znamená preusporiadať polovicu plátna.
Mermaid rieši oboje: diagram je obyčajný text v Markdowne, verzuje sa v Gite (alebo v Notione, Confluence, GitHube — všade ho už podporujú natívne) a zmena je úprava jedného riadka.
Najčastejšie typy, ktoré používam
1. Flowchart — procesný tok
Najrýchlejší spôsob ako sa s biznisom dohodnúť, ako vlastne funguje (alebo má fungovať) ich proces.
2. Sequence diagram — komunikácia medzi systémami
Keď navrhujem integráciu, sekvenčný diagram ukáže, kto komu volá, v akom poradí a čo sa vracia späť.
3. ER diagram — dátový model
Na workshope so zákazníkom dokážem v reálnom čase upravovať dátový model a hneď vidieť, či dáva zmysel.
Čo mi to v praxi prinieslo
👉 Diagram je súčasťou dokumentácie, nie príloha. Žije v tom istom súbore ako popis, verzuje sa spolu s ním. 👉 Review je rýchlejší. Kolega vidí v pull requeste presne, čo sa v procese zmenilo — riadok textu, nie nový obrázok. 👉 AI rozumie textu, nie obrázkom. Keď chcem od jazykového modelu, aby mi navrhol úpravu procesu, stačí mu poslať Mermaid blok. Vráti mi upravený blok, ktorý hneď viem renderovať. 👉 Workshop bez prepínania nástrojov. Píšem zápisnicu v Markdowne a diagramy vznikajú priamo v nej.
Kedy Mermaid nestačí
Nie je to univerzálny nástroj. Komplexné architektonické pohľady (C4 na úrovni komponentov s desiatkami väzieb), pixel-perfect prezentácie pre vedenie alebo interaktívne wireframy stále patria do špecializovaných nástrojov. Pre 80 % dennej práce analytika ale úplne stačí — a tých zvyšných 20 % má aspoň textový základ, z ktorého sa dá vyjsť.
Ako začať
Najjednoduchšie: otvorte mermaid.live, skopírujte jeden z príkladov vyššie a začnite ho upravovať. Za hodinu budete vedieť tri základné typy diagramov. Za týždeň zistíte, že už nesiahnete po myši.