Koľko zo systému modelovať

Skôr než nakreslíte akýkoľvek pohľad, dokončite túto vetu: „Tento pohľad existuje preto, aby [osoba] mohla rozhodnúť [vec].“ Ak nedokážete doplniť obe medzery, nekreslite ho.

Skúška funguje preto, že je vyvrátiteľná, a to každá iná rada na túto tému nie je. „Modelujte dôležité časti“ nemôže prehrať spor; „tento diagram tried existuje preto, aby platformový tím mohol rozhodnúť, či výpočet dane patrí fakturácii“ buď pravda je, alebo nie je, a menovanej osoby sa dá spýtať.

Poctivo uplatnená odstráni väčšinu toho, čo sa modeluje. Diagram súčasného systému nakreslený preto, že by ho niekto mal zdokumentovať, neinformuje o ničom. Pohľad zobrazujúci každú službu v portfóliu neinformuje o ničom, pretože žiadne rozhodnutie sa netýka všetkých naraz. Prežije malý počet pohľadov, každý mierený na spor, ktorý niekto práve vedie.

Stane sa druhou implementáciou. Každá trieda, každé pole, každé volanie - model v takej vernosti je kópiou kódu napísanou v notácii, a nesprávna je vždy tá kópia. Toto je zlyhanie, ktoré dalo modelovaniu jeho povesť, a pochádza výhradne z toho, že sa nikto nespýtal, načo model je.

Stane sa obrázkom organizačnej schémy. Nevymedzené modely sa posúvajú k tomu, aby zobrazovali systém každého tímu s rovnakou váhou, pretože to je politicky najjednoduchšie usporiadanie. Výsledkom je diagram, na ktorom sú dva komponenty, ktoré spolu naozaj komunikujú, rovnako veľké ako dvadsať, ktoré nie, a nikto v ňom nenájde otázku.

Stane sa neudržateľným tým najobyčajnejším spôsobom. Nie dramaticky - jednoducho tak, že obsahuje viac detailov, než má tím chuť aktualizovať, takže pár prvkov zastará, potom ďalších pár, a do dvoch štvrťrokov je model vecou, ktorú si ľudia radšej overujú proti kódu, než by jej verili.

Jeden model, viacero malých pohľadov. Rozsah je vlastnosťou pohľadu, nie modelu - model môže obsahovať všetko, čo doň ktokoľvek zadal, a každý pohľad ukazuje tú hŕstku prvkov, ktoré potrebuje jedno rozhodnutie. Na to slúži mechanizmus hľadísk v ArchiMate a rovnako dobre platí aj pre UML.

Modelujte jednu úroveň pod rozhodnutím, nie dve. Ak je spor o tom, ktorá služba vlastní istú zodpovednosť, modelujte služby a ich závislosti. Nemodelujte triedy vnútri nich; ten detail nemôže zmeniť odpoveď a je to práve ten detail, ktorý zhnije.

Zmažte pohľady, ktoré splnili svoj účel. Pohľad nakreslený pre migráciu, ktorá prebehla, je hotový, a ponechať si ho znamená, že budúci čitateľ nájde sebavedomý diagram architektúry, ktorá už neexistuje. Mazanie dokumentácie sa zdá nesprávne a zvyčajne je správne.

Ďalej v tejto sérii: konvencie pomenovania a potom udržiavanie modelu aktuálneho.