Generovanie UML pomocou AI

V dvoch veciach, a sú to práve tie, ktoré stoja najviac času. Prvou je prázdna strana: pomenovať osem podstatných mien v doméne a dostať ich na plátno je pol hodiny práce, ktorá nevyprodukuje nič, o čom by sa niekto hádal, a model to spraví za sekundy. Druhou je dohľadávanie notácie - ktorá hlava šípky znamená realizáciu, na ktorý koniec ide kosoštvorec, ako vyzerá násobnosť 0..* vedľa 1. Tá znalosť je v špecifikácii, špecifikácia je v trénovacích dátach a pamätať si ju nikdy nebola tá zaujímavá časť práce.

Diagram v hlavičke tohto článku prišiel z dvojvetového popisu. Triedy sú správne, atribúty vierohodné a človek, ktorý doménu pozná, si ho prečíta a začne sa hádať o tie časti, na ktorých záleží - a presne na to prvý návrh je.

Opakujú sa naprieč modelmi aj naprieč promptmi, lebo pod povrchom sú všetky tým istým zlyhaním: generátor vyberá najbežnejšiu odpoveď a váš systém nie je najbežnejším systémom.

1. Kompozícia nakreslená ako agregácia alebo ako obyčajná asociácia. Dutý kosoštvorec je bezpečne vyzerajúca voľba, takže je to tá, ktorá sa vráti. Je to zároveň tá, ktorá hovorí, že časti prežijú celok, čo je tvrdenie o mazaní a o vlastníctve, ktoré nikto neoveril.
2. Násobnosti predvolené na jeden k mnohým. Bez opýtania sa takmer každá asociácia vráti ako 1 k 0..*. Niekedy je to správne. Keď nie, je to ten druh nesprávnosti, ktorý prežije až do schémy.
3. Rozhrania vymyslené pre jedinú implementáciu. Modely prečítali veľké množstvo podnikovej Javy. Ak má vaša doména jedného poskytovateľa platieb, je «interface» IPaymentProvider v návrhu ozdobou.
4. Úplne nesprávny druh diagramu.Opýtajte sa na správanie v čase a vráti sa diagram tried, lebo diagramy tried dominujú trénovacím dátam. Ak bola otázka „čo sa stane, keď platba zlyhá“, chceli ste sekvenčný diagram.

Ani jedno z nich sa neopravuje ťažko. Všetky sa ťažko všimnú, lebo nesprávny druh vzťahu vyzerá presne tak sebavedomo ako správny a diagram je tak či tak upratený.

Tri zložky, a tá tretia je tou, ktorú ľudia vynechávajú.

1. Pomenujte druh diagramu.„Diagram tried“, nie „UML diagram“. Ak si nie ste istí, ktorý druh chcete, je to modelovacia otázka a tých štrnásť druhov je tu.
2. Dajte mu svoje podstatné mená. Slová, ktoré váš tím už používa, napísané tak, ako ich píše váš kód. Model, ktorý si vymyslí BorrowRecord, keď vy hovoríte Loan, vyprodukuje diagram, ktorý si nikto nevie na nič namapovať.
3. Vyslovte otázku, na ktorú musí diagram odpovedať.„...ktorý ukazuje, čo sa stane s výpožičkami, keď sa výtlačok vyradí.“ Práve to mení vierohodný obrázok na overiteľné tvrdenie a je to jediná veta s najvyššou hodnotou v akomkoľvek prompte.

Prejdite si to skôr, než diagram opustí vašu obrazovku. Mapuje sa jedna k jednej na tie štyri zlyhania vyššie a je to celý rozdiel medzi vygenerovaným diagramom, ktorý pomôže, a takým, ktorý rok potichu dezinformuje tím.

Dve minúty nie sú nadsádzka: na diagrame o ôsmich boxoch sú to štyri pohľady. Funguje to vďaka tomu, že viete, čo hľadáte, a preto je zoznam krátky a konkrétny namiesto „dôkladne skontrolujte“.

Archyno generuje do modelu, nie do obrázka, a práve ten rozdiel je dôvodom, prečo môže tento článok skončiť tam, kde končí. AI dostane ten istý metamodel, ktorý vynucuje editor, takže sa vráti to, čo notácia naozaj pripúšťa - realizácia môže pristáť len na rozhraní, ArchiMate vzťah slúženia môže spojiť len tie vrstvy, ktoré špecifikácia dovoľuje. Kategórie chýb vyššie sa zmrštia na tie, ktoré nezachytí žiadny nástroj: na tie o vašom systéme.

Keďže je to model a nie obrázok, oprava je úprava, nie nový prompt. Zmeňte kosoštvorec, zmeňte násobnosť, premenujte triedu - a to premenovanie dorazí do každého pohľadu, v ktorom sa prvok objavuje. Výsledok sa exportuje ako PNG, SVG, Mermaid, XMI alebo súbor .qea pre Sparx, a práve to robí z vygenerovaného diagramu niečo, čo viete odovzdať tímu, ktorý nepoužíva ten istý nástroj ako vy.

ArchiMate polovica tohto - kde pravidlá vrstiev robia generovanie zároveň ťažším aj užitočnejším - je v článku generovanie ArchiMate diagramov pomocou AI. Čo nástroj robí a čo nerobí, je priamo vyložené v prečo Archyno.