Wstęp

We współczesnej inżynierii oprogramowania „„Diagram jako kod” (DaC) zrewolucjonizował sposób dokumentowania architektury systemów.VPasCode, opracowany przez Visual Paradigm, wyróżnia się jako zintegrowana, oparta na przeglądarce platforma obsługująca wiele składni, takich jak PlantUML, Mermaid i Graphviz. Choć pisanie kodu do generowania diagramów zapewnia precyzję, ręczne aktualizowanie złożonych struktur – takich jak dodawanie atrybutów do wielu klas podrzędnych – może być żmudne.

Tu właśnie wbudowane AI w VPasCode błyszczy. Dzięki integracji przetwarzania języka naturalnego bezpośrednio w edytorze, VPasCode pozwala programistom udoskonalać swoje modele wizualne w sposób konwersacyjny. Ten przewodnik wyjaśnia, jak wykorzystać funkcję „Modyfikuj przez AI”, aby natychmiast zaktualizować diagram klas UML, zamykając przepaść między kodem tekstowym a projektem wizualnym, bez konieczności opuszczania środowiska pracy.

---

Kluczowe pojęcia

Zanim przejdziemy do kroków, warto zrozumieć kluczowe technologie, które tu występują:

• Diagram jako kod (DaC): Metoda, w której diagramy są generowane z tekstowego kodu źródłowego, a nie rysowane ręcznie za pomocą myszy. Zapewnia to możliwość kontroli wersji diagramów i ich łatwą powtarzalność.
  

• PlantUML: Popularne narzędzie open-source, które wykorzystuje prosty opis tekstowy do tworzenia diagramów UML. W poniższym przykładzie składnia PlantUML definiuje klasy takie jak Klient, Zamówienie, oraz Płatność.

• Modyfikacja przez wbudowane AI: W przeciwieństwie do zewnętrznych narzędzi AI, gdzie musisz kopiować i wklejać kod w obie strony, wbudowane AI w VPasCode rozumie kontekst Twojego aktualnego pliku. Analizuje istniejący kod PlantUML, stosuje żądane zmiany (np. dodawanie atrybutów) i automatycznie przepisuje kod.

• Renderowanie w czasie rzeczywistym: VPasCode zapewnia widok podzielonego ekranu, w którym zmiany w kodzie po lewej stronie są natychmiast odzwierciedlane w diagramie wizualnym po prawej, zapewniając natychmiastową informację zwrotną.

---

Przewodnik krok po kroku: Udoskonalanie diagramu klas przy użyciu wbudowanego AI w VPasCode

Szybkie i wygodne udoskonalanie diagramu klas w środowisku VPasCode bez użycia zewnętrznych narzędzi można wykonać w kilku prostych krokach, korzystając z wbudowanej funkcji AI.

Punkt wyjścia

Wyobraź sobie, że masz podstawowy diagram klas e-commerce zdefiniowany w PlantUML. Posiadasz klasęPaymentz trzema klasami potomnymi:Cash, Check, orazCreditObecnie te klasy potomne są pustymi powłokami, dziedziczącymi wyłącznie od klasy nadrzędnej.

(Uwaga: W rzeczywistym interfejsie odpowiada to pierwszemu dostarczonymu obrazowi, pokazującemu kod po lewej stronie oraz wyrenderowany diagram po prawej stronie z pustymi klasami potomnymi.)

Rysunek 1: Stan początkowy diagramu klas w VPasCode. Zwróć uwagę, że klasyCash, Check, orazCreditnie posiadają określonych atrybutów.

Krok 1: Otwórz menu AI

Aby rozpocząć proces udoskonalania, zlokalizuj elementy sterujące AI w interfejsie edytora.

• Kliknij przycisk rozwijanyAIznajdujący się w sekcji górno-lewej nad edytorem kodu. To menu jest Twoją bramą do inteligentnej manipulacji diagramem.

Rysunek 2: Kliknięcie przycisku rozwijanego AI ujawnia opcje Modyfikuj lub Przetłumacz kod diagramu.

Krok 2: Wybierz opcję Modyfikuj

Menu AI oferuje różne możliwości w zależności od Twoich potrzeb. W przypadku zmian strukturalnych użyjesz funkcji Modyfikuj.

• Z menu rozwijanego kliknij opcjęModyfikujz ikoną AI obok niej. Informuje to system, że zamierzasz zmienić istniejącą logikę i strukturę diagramu, a nie generować coś od zera.

Krok 3: Opisz pożądane zmiany

Jest to najważniejszy krok, w którym język naturalny zastępuje ręczne kodowanie. Nie musisz znać dokładnej składni PlantUML dla nowych atrybutów; po prostu opisz, czego chcesz.

• W oknie dialogowymAI Modify które się pojawi, wprowadź opis w języku naturalnym, jak chcesz udoskonalić lub zmienić swój diagram.

• Przykładowe polecenie: „Dodaj kilka atrybutów do klas potomnych klasy Payment na diagramie klas”

• Kliknij przyciskAI Modify aby przesłać swoje żądanie.

Rysunek 3: Okno dialogowe AI Modify. Użytkownik wprowadza polecenie w języku naturalnym (1) i uruchamia proces (2).

Krok 4: Wyświetl udoskonalony diagram

Po przesłaniu polecenia silnik VPasCode rozpoczyna pracę. Analizuje żądanie, identyfikuje docelowe klasy (Cash, Check, Credit) i wstrzykuje odpowiednie atrybuty i metody na podstawie standardowej wiedzy domenowej.

• Sztuczna inteligencja automatycznie przetworzy Twój opis, zaktualizuje kod i odzwierciedli nowo dodane klasy, atrybuty lub metody bezpośrednio w Twoim wizualnym diagramie klas.

• Wynik: Jak widać poniżej, klasaCash posiada terazcashTendered, klasaCheck posiadabankID oraznazwa banku, a Kredyt klasa zawiera numer i data ważności. Kod po lewej stronie został zaktualizowany, aby pasował do wizualizacji po prawej.

Rysunek 4: Ulepszony diagram. Sztuczna inteligencja pomyślnie uzupełniła klasy potomne odpowiednimi atrybutami i metodami, aktualizując zarówno kod, jak i reprezentację wizualną.

---

Podsumowanie

Integracja sztucznej inteligencji w narzędziach typu Diagram-as-Code, takich jak VPasCode, stanowi znaczący krok naprzód w zakresie produktywności architektów i programistów oprogramowania. Postępując zgodnie z tym prostym, czterokrokowym procesem, możesz przekształcić szkieletowy diagram klas w szczegółowy dokument projektowy w kilka sekund.

Możliwość wpisania „Dodaj atrybuty do potomków klasy Payment” i obserwować jednoczesną aktualizację kodu i diagramu eliminuje trudności związane z ręczną edycją składni. Niezależnie od tego, czy modelujesz złożony system przedsiębiorstwa, czy prostą aplikację, wbudowana sztuczna inteligencja VPasCode zapewnia, że Twoja dokumentacja ewoluuje tak szybko, jak Twoje pomysły.

Gotowy, aby spróbować samodzielnie? Odwiedź VPasCode aby natychmiast zacząć zamieniać swój tekst na profesjonalne diagramy

Artykuły referencyjne i zasoby dla VPasCode firmy Visual Paradigm

Oto wyselekcjonowana lista artykułów i zasobów dotyczących VPasCode firmy Visual Paradigm, zintegrowanej platformy do tworzenia diagramów z tekstu. Zasoby zostały uporządkowane, aby pomóc Ci zrozumieć jego podstawowe funkcje, możliwości sztucznej inteligencji oraz integracje z ekosystemem.

Podstawowe przewodniki i przeglądy funkcji

1. Kompleksowy przewodnik po VPasCode firmy Visual Paradigm: Podstawowy przewodnik wyjaśniający filozofię Diagram-as-Code (DaC), jego wielkosilnikową architekturę (PlantUML, Mermaid, Graphviz) oraz podstawowy interfejs edytora z dwoma panelami.

2. Opanowanie VPasCode: Ostateczny przewodnik po Diagram-as-Code wspieranym przez sztuczną inteligencję: Szczegółowy tutorial dotyczący wykorzystania funkcji wspieranych przez sztuczną inteligencję, w tym czatu AI do konwersji języka naturalnego na diagramy, oraz sposobu przenoszenia diagramów wygenerowanych przez AI bezpośrednio do edytora VPasCode.

3. Głęboka analiza VPasCode: Unifikacja Mermaid, PlantUML i AI w jednej platformie: Ten artykuł zawiera techniczną analizę wsparcia platformy dla Mermaid, PlantUML i Graphviz, z szczegółowym porównaniem funkcji i praktycznymi przypadkami użycia.

Szybki start i przewodniki praktyczne

4. Przewodnik szybkiego startu w 60 sekund | Przewodnik VPasCode: Tekst do Diagramu: Krok po kroku tutorial tworzenia, dostosowywania i udostępniania Twojego pierwszego diagramu w mniej niż minutę, korzystając z edytora natywnego dla chmury.

5. Od kodu do jasności: Przewodnik dla początkujących po płynne tworzenie diagramów z VPasCode i OpenDocs: Praktyczny przewodnik po tworzeniu realistycznych diagramów (sekwencji, C4, klas) i wysyłaniu ich z VPasCode do dokumentacji OpenDocs za pomocą integracji Pipeline.

Integracja i ekosystem

6. Bezproblemowe połączenie tworzenia diagramów z dokumentacją: VPasCode integruje się z OpenDocs: Ogłasza bezpośrednią integrację z pipeline’em, szczegółowo opisując, jak użyć funkcji „Wyślij do OpenDocs Pipeline”, aby przekształcić diagramy w żywą dokumentację.

7. Bezproblemowe połączenie diagramów typu „as-code” z dokumentacją za pomocą OpenDocs”: Wyjaśnia, jak VPasCode działa jako most między tworzeniem diagramów a dokumentacją, rozwiązując problem przestarzałych diagramów dzięki możliwości natychmiastowych aktualizacji.

Możliwości AI i studia przypadków

8. Visual Paradigm – wizualne modelowanie napędzane przez AI: Prezentuje szerszy ekosystem AI Visual Paradigm, z sekcjami poświęconymi VPasCode i jego możliwości generowania diagramów z tekstu, a także naprawiania błędów przy użyciu AI.

9. Co nowego w VPasCode – przegląd funkcji po premierze: Przegląd funkcji po premierze podkreślający kluczowe możliwości: obsługę wielu składni, naprawianie błędów w kodzie przy użyciu AI, tłumaczenie AI dla zespołów globalnych oraz integrację z OpenDocs.

10. Studium przypadku: przyspieszanie tworzenia dokumentacji architektury oprogramowania dzięki VPasCode: Studium przypadku pokazujące, jak VPasCode przyspiesza tworzenie dokumentacji architektury oprogramowania dzięki zautomatyzowanemu układowi, generowaniu przy użyciu AI oraz wsparciu dla zjednoczonego silnika.

Oficjalne strony produktów

11. Visual Paradigm VPasCode: Zjednoczona platforma diagramów typu „as-code: Oficjalna strona funkcji produktu szczegółowo opisująca obsługiwane typy diagramów (PlantUML, Mermaid, Graphviz), podstawowe możliwości techniczne oraz sekcję FAQ.

12. Oficjalna dokumentacja i środowisko testowe VPasCode: Centralne centrum dostępu do darmowego edytora VPasCode Playground, oficjalnej dokumentacji oraz najnowszych aktualizacji platformy.