Visual Paradigm AI Chatbot एक एप्लिकेशन, इसके उपयोगकर्ताओं और बाहरी सिस्टमों के सरल भाषा में वर्णन से C4 सिस्टम संदर्भ आरेख बनाने की सुविधा प्रदान करता है। हालांकि, एक AI-जनरेट आरेख तभी सबसे अधिक उपयोगी होता है जब जनरेट होने के बाद भी वह संपादन योग्य और बनाए रखने योग्य बना रहे।

यह गाइड C4-PlantUML का उपयोग करके एक फूड डिलीवरी प्लेटफॉर्म संदर्भ आरेख जनरेट करने के लिए एक एंड-टू-एंड कार्यप्रवाह को प्रदर्शित करता है। आप सीखेंगे कि AI-जनरेट आरेख से संपादन योग्य PlantUML कोड में कैसे जाएं, VPasCode में मॉडल को सुधारें और Visual Paradigm Online में इसे दृश्य रूप से संपादित करना जारी रखें। यह दृष्टिकोण AI-सहायता वाले मॉडलिंग की गति, डायग्राम-एज-कोड की लचीलेपन और ग्राफिकल डायग्राम एडिटर की सुविधा को जोड़ता है।

Visual Paradigm एक प्राकृतिक भाषा में दी गई वास्तुकला का वर्णन एक संपादन योग्य C4 संदर्भ आरेख में बदलने के लिए एक व्यावहारिक कार्यप्रवाह प्रदान करता है:

1. Visual Paradigm AI Chatbot में सिस्टम का वर्णन करें।

   

2. C4 सिस्टम संदर्भ आरेख जनरेट करें और उसकी समीक्षा करें।

3. परिणाम को VPasCode में C4-PlantUML के रूप में खोलें।

   

4. PlantUML कोड को संपादित करके आरेख में संशोधन करें।

   

5. वैकल्पिक रूप से परिणाम को Visual Paradigm Online पर भेजें।

   

6. ड्रैग-एंड-ड्रॉप डायग्राम एडिटर का उपयोग करके आरेख को दृश्य रूप से संशोधित करें।

इससे आपको दो संपादन पथ मिलते हैं:

• कोड-आधारित संपादन:VPasCode और C4-PlantUML

• GUI-आधारित संपादन:Visual Paradigm Online डायग्राम एडिटर

Visual Paradigm का AI Chatbot C4 सिस्टम संदर्भ, कंटेनर, घटक और डेप्लॉयमेंट आरेखों का समर्थन करता है। यह तत्वों को जोड़ने, हटाने, नाम बदलने या पुनः जोड़ने जैसे प्राकृतिक भाषा कमांडों के माध्यम से एक जनरेट किए गए आरेख को भी सुधार सकता है।

1. C4 संदर्भ आरेख को समझें

एक C4 संदर्भ आरेख सॉफ्टवेयर सिस्टम का सर्वोच्च स्तर का दृश्य है। यह दिखाता है:

• वहरुचि का सिस्टम

• मानव उपयोगकर्ता और संगठनात्मक अभिनेता

• बाहरी सॉफ्टवेयर सिस्टम

• इन तत्वों के बीच महत्वपूर्ण संबंध

• प्रत्येक संबंध कैसे काम करता है, इसका एक संक्षिप्त वर्णन

यह सामान्यतः आंतरिक सेवाओं, डेटाबेसों, क्लासों, APIs या इंफ्रास्ट्रक्चर विवरण को नहीं दिखाता है। वे निचले स्तर के C4 आरेखों में आते हैं।

उदाहरण के लिए, एक ऑनलाइन फूड डिलीवरी प्लेटफॉर्म के लिए संदर्भ आरेख में निम्नलिखित शामिल हो सकते हैं:

• ग्राहक

• रेस्तरां मैनेजर

• डिलीवरी ड्राइवर

• भुगतान प्रदाता

• मैप और भू-स्थान सेवा

• सूचना सेवा

• भोजन डिलीवरी प्लेटफॉर्म

केंद्रीय सिस्टम दृश्य ध्यान केंद्रित बना रहना चाहिए। बाहरी लोग और सिस्टम इसे घेरकर रखे जाने चाहिए।

2. एक अच्छा एआई प्रॉम्प्ट तैयार करें

उत्पन्न किए गए डायग्राम की गुणवत्ता चैटबॉट को प्रदान की गई वास्तुकला विवरण पर बहुत अधिक निर्भर करती है।

एक उपयोगी प्रॉम्प्ट निम्नलिखित को निर्दिष्ट करता है:

• सिस्टम का नाम

• सिस्टम का उद्देश्य

• उसका उपयोग करने वाले लोग

• बाहरी सिस्टम जिनसे यह संचार करता है

• उनके बीच संबंध

• वांछित C4 डायग्राम स्तर

• वांछित आउटपुट प्रारूप

• क्या शामिल नहीं होना चाहिए

उदाहरण प्रॉम्प्ट

एक ऑनलाइन भोजन डिलीवरी प्लेटफॉर्म के लिए C4 सिस्टम कॉन्टेक्स्ट डायग्राम बनाएं।

रुचि का सिस्टम:
भोजन डिलीवरी प्लेटफॉर्म — ग्राहकों को रेस्तरां ब्राउज़ करने, ऑर्डर देने, भुगतान करने और डिलीवरी को ट्रैक करने की अनुमति देता है।

लोग:
1. ग्राहक — रेस्तरां ब्राउज़ करता है, ऑर्डर देता है, भुगतान करता है और डिलीवरी को ट्रैक करता है।
2. रेस्तरां मैनेजर — मेनू प्रबंधित करता है, ऑर्डर स्वीकार करता है और ऑर्डर स्थिति को अपडेट करता है।
3. डिलीवरी ड्राइवर — डिलीवरी कार्य स्वीकार करता है और डिलीवरी प्रगति को अपडेट करता है।
4. ऑपरेशन प्रशासक — प्लेटफॉर्म गतिविधि की निगरानी करता है और सहायता समस्याओं को संभालता है।

बाहरी सिस्टम:
1. भुगतान प्रदाता — ग्राहक भुगतानों को प्रमाणित और कैप्चर करता है।
2. मैप और भू-स्थान सेवा — पते, मार्ग और डिलीवरी स्थान प्रदान करती है।
3. सूचना सेवा — ईमेल, SMS और पुश सूचनाएं भेजती है।

संबंध:
- ग्राहक रेस्तरां ब्राउज़ करने, ऑर्डर देने, भुगतान करने और डिलीवरी को ट्रैक करने के लिए भोजन डिलीवरी प्लेटफॉर्म का उपयोग करता है।
- रेस्तरां मैनेजर मेनू प्रबंधित करने और ऑर्डर प्रोसेस करने के लिए भोजन डिलीवरी प्लेटफॉर्म का उपयोग करता है।
- डिलीवरी ड्राइवर डिलीवरी कार्य प्राप्त करने और डिलीवरी स्थिति अपडेट करने के लिए भोजन डिलीवरी प्लेटफॉर्म का उपयोग करता है।
- ऑपरेशन प्रशासक ऑपरेशन की निगरानी करने और समस्याओं को हल करने के लिए भोजन डिलीवरी प्लेटफॉर्म का उपयोग करता है।
- भोजन डिलीवरी प्लेटफॉर्म भुगतानों को प्रमाणित और कैप्चर करने के लिए भुगतान प्रदाता का उपयोग करता है।
- भोजन डिलीवरी प्लेटफॉर्म मार्गों की गणना करने और स्थानों को ट्रैक करने के लिए मैप और भू-स्थान सेवा का उपयोग करता है।
- भोजन डिलीवरी प्लेटफॉर्म सूचनाएं भेजने के लिए सूचना सेवा का उपयोग करता है।

एक साफ C4 सिस्टम कॉन्टेक्स्ट डायग्राम जनरेट करें। आंतरिक कंटेनर, घटक, डेटाबेस, क्लास या डिप्लॉयमेंट इंफ्रास्ट्रक्चर न दिखाएं। संक्षिप्त संबंध लेबल का उपयोग करें।

आंतरिक विवरण को छोड़ने के लिए स्पष्ट निर्देश महत्वपूर्ण है। इसके बिना, एक एआई जनरेटर एक ऐसा डायग्राम बना सकता है जो संदर्भ-स्तर और कंटेनर-स्तर की जानकारी को मिलाता है।

3. Visual Paradigm AI चैटबॉट में डायग्राम जनरेट करें

Visual Paradigm AI चैटबॉट खोलें और एक नई बातचीत या डायग्राम-जनरेशन सत्र शुरू करें।

इंटरफ़ेस और सब्सक्रिप्शन संस्करण के आधार पर, चैटबॉट एक डायग्राम-प्रकार चयनक प्रदान कर सकता है। चुनें:

• C4 मॉडल

• सिस्टम कॉन्टेक्स्ट डायग्राम

फिर प्रॉम्प्ट दर्ज करें।

Visual Paradigm का सामान्य चैटबॉट कार्यप्रवाह है:

1. डायग्राम का वर्णन करें।

2. एआई को प्रारंभिक मॉडल जनरेट करने दें।

3. परिणाम की समीक्षा करें।

4. प्राकृतिक भाषा कमांडों के साथ इसे परिष्कृत करें।

5. निर्यात करें या किसी अन्य Visual Paradigm टूल में संपादन जारी रखें।

पहले परिणाम की समीक्षा करें

जांचें कि क्या आरेख में निम्नलिखित शामिल हैं:

• बिल्कुल एक केंद्रीय सिस्टम

• सभी आवश्यक लोग

• सभी प्रासंगिक बाहरी सिस्टम

• सही संबंध दिशाएँ

• संक्षिप्त संबंध विवरण

• कोई अनावश्यक आंतरिक सेवाएँ या डेटाबेस नहीं

• संगत नामकरण

• पढ़ने में आसान लेआउट

एक जनरेट किया गया आरेख एक शुरुआती बिंदु है, आर्किटेक्चर समीक्षा का विकल्प नहीं।

4. संवाद के माध्यम से आरेख को परिष्कृत करें

चैटबॉट सामान्य भाषा का उपयोग करके आरेख को संशोधित कर सकता है।

एक तत्व जोड़ें

एक ग्राहक सहायता एजेंट जोड़ें जो ग्राहक समस्याओं की जांच करने और रिफंड प्रोसेस करने के लिए फूड डिलीवरी प्लेटफॉर्म का उपयोग करता है।

एक बाहरी सिस्टम जोड़ें

एक बाहरी धोखाधड़ी पता लगाने की सेवा जोड़ें जिसका उपयोग फूड डिलीवरी प्लेटफॉर्म संदेहपूर्ण भुगतानों का मूल्यांकन करने के लिए करता है।

एक तत्व का नाम बदलें

“नोटिफिकेशन सेवा” का नाम बदलकर “संदेश और नोटिफिकेशन सेवा” रखें।

एक संबंध बदलें

डिलीवरी ड्राइवर और फूड डिलीवरी प्लेटफॉर्म के बीच के संबंध को बदलें:
“डिलीवरी असाइनमेंट प्राप्त करता है और डिलीवरी स्थिति अपडेट जमा करता है।”

एक तत्व हटाएं

आरेख से ऑपरेशंस एडमिनिस्ट्रेटर को हटाएं।

लेआउट को सुधारें

आरेख को पुनर्व्यवस्थित करें ताकि लोग ऊपर दिखाई दें, बाहरी सिस्टम नीचे दिखाई दें, और फूड डिलीवरी प्लेटफॉर्म केंद्र में बना रहे।

आरेख को सरल बनाएं

इसे एक सख्त C4 सिस्टम कॉन्टेक्स्ट आरेख में सरल बनाएं। कार्यान्वयन विवरण, डेटाबेस, APIs, माइक्रोसर्विसेस और आंतरिक घटकों को हटा दें।

संगति समीक्षा का अनुरोध करें

आरेख की समीक्षा करें कि इसमें कौन से संबंध गायब हैं, अस्पष्ट लेबल हैं, दोहराए गए सिस्टम हैं, और ऐसे तत्व हैं जो C4 कॉन्टेक्स्ट आरेख में नहीं होने चाहिए।

AI चैटबॉट दस्तावेज़ इस पुनरावृत्तमय दृष्टिकोण का वर्णन करता है, जिसमें पेमेंट गेटवे जोड़ने, तत्वों का नाम बदलने, संबंध बदलने और आरेखों को रीफैक्टोर करने के आदेश शामिल हैं।

भाग 1: कोड संपादन के लिए डायग्राम को VPasCode में खोलें

5. “VPasCode में खोलें” या “VPasCode में संपादित करें” का उपयोग करें

डायग्राम को जनरेट और परिष्कृत करने के बाद, इसी तरह लेबल किए गए कार्रवाई का उपयोग करें:

• VPasCode में खोलें

• VPasCode में संपादित करें

• कोड खोलें

• संपादन के लिए कोड जनरेट करें

बटन का सटीक लेबल वर्तमान इंटरफ़ेस के आधार पर भिन्न हो सकता है।

यह डायग्राम के कोड को VPasCode में स्थानांतरित करता है, जहाँ आप एक लाइव रेंडरित पूर्वावलोकन देखते हुए डायग्राम को पाठ के रूप में संपादित कर सकते हैं। Visual Paradigm VPasCode को एक ब्राउज़र-आधारित डायग्राम-एज-कोड एडिटर के रूप में वर्णित करता है जो PlantUML, C4 मॉडल, Mermaid, Graphviz और अन्य सिंटैक्स प्रारूपों का समर्थन करता है।

जनरेट किया गया कोड C4-PlantUML का उपयोग करना चाहिए, आमतौर पर निम्नलिखित के साथ:

@startuml
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml
...
@enduml

जनरेट किया गया स्क्रिप्ट एक अलग include URL या आंतरिक रूप से समर्थित लाइब्रेरी संस्करण का उपयोग कर सकता है। VPasCode द्वारा जनरेट किए गए include को संरक्षित रखें, जब तक कि इसे बदलने का कोई विशिष्ट कारण न हो।

6. C4-PlantUML संरचना को समझें

एक सामान्य C4-PlantUML संदर्भ डायग्राम में ये भाग होते हैं:

@startuml
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml

LAYOUT_LEFT_RIGHT()

Person(customer, "ग्राहक", "भोजन के आदेश देता है और डिलीवरी को ट्रैक करता है।")
System(platform, "भोजन डिलीवरी प्लेटफ़ॉर्म", "ग्राहकों को भोजन आदेश देने और डिलीवरी को ट्रैक करने की अनुमति देता है।")
System_Ext(payment, "भुगतान प्रदाता", "भुगतानों को अधिकृत करता है और कैप्चर करता है।")

Rel(customer, platform, "आदेश देता है और डिलीवरी को ट्रैक करता है")
Rel(platform, payment, "भुगतानों को अधिकृत करता है और कैप्चर करता है")

@enduml

मुख्य तत्व प्रकार

पहला तर्त आंतरिक पहचानकर्ता है। दूसरा प्रदर्शन नाम है। तीसरा विवरण है।

7. VPasCode में डायग्राम संपादित करें

VPasCode सामान्यतः प्रदर्शित करता है:

• एडिटर पैनल में स्रोत कोड

• पूर्वावलोकन पैनल में रेंडर किया गया डायग्राम

• निर्यात, साझा करने, कॉपी करने या परिणाम को किसी अन्य Visual Paradigm उत्पाद में खोलने के लिए क्रियाएँ

VPasCode लाइव रेंडरिंग प्रदान करता है और सीधे कोड संपादन का समर्थन करता है। जब कोड एडिटर में पेस्ट किया जाता है, तो यह समर्थित डायग्राम प्रारूपों का भी पता लगा सकता है।

उदाहरण: सुधारा गया C4-PlantUML कोड

@startuml
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml

शीर्षक भोजन डिलीवरी प्लेटफॉर्म — सिस्टम संदर्भ

LAYOUT_LEFT_RIGHT()
SHOW_LEGEND()

Person(customer, "ग्राहक",
  "रेस्तरां ब्राउज़ करता है, ऑर्डर देता है, भुगतान करता है, और डिलीवरी को ट्रैक करता है।")

Person(restaurantManager, "रेस्तरां प्रबंधक",
  "मेन्यू प्रबंधित करता है, ऑर्डर स्वीकार करता है, और ऑर्डर स्थिति को अपडेट करता है।")

Person(deliveryDriver, "डिलीवरी ड्राइवर",
  "डिलीवरी नियुक्तियां प्राप्त करता है और डिलीवरी प्रगति को अपडेट करता है।")

Person(operationsAdmin, "संचालन प्रशासक",
  "प्लेटफॉर्म संचालन की निगरानी करता है और सहायता समस्याओं को संभालता है।")

System(platform, "भोजन डिलीवरी प्लेटफॉर्म",
  "भोजन ऑर्डर, भुगतान, रेस्तरां प्रबंधन, और डिलीवरी ट्रैकिंग को सक्षम बनाता है।")

System_Ext(paymentProvider, "भुगतान प्रदाता",
  "ग्राहक भुगतानों को प्रमाणित और कैप्चर करता है।")

System_Ext(mapService, "मैप और भू-स्थान सेवा",
  "पते, मार्ग और स्थान डेटा प्रदान करता है।")

System_Ext(notificationService, "सूचना सेवा",
  "ईमेल, SMS और पुश सूचनाएं भेजता है।")

Rel(customer, platform,
  "रेस्तरां ब्राउज़ करता है, ऑर्डर देता है, भुगतान करता है, और डिलीवरी को ट्रैक करता है")

Rel(restaurantManager, platform,
  "मेन्यू प्रबंधित करता है और रेस्तरां ऑर्डरों को संसाधित करता है")

Rel(deliveryDriver, platform,
  "डिलीवरी कार्य प्राप्त करता है और डिलीवरी स्थिति जमा करता है")

Rel(operationsAdmin, platform,
  "संचालन की निगरानी करता है और सहायता समस्याओं को संभालता है")

Rel(platform, paymentProvider,
  "भुगतानों को प्रमाणित और कैप्चर करता है")

Rel(platform, mapService,
  "मार्गों की गणना करता है और डिलीवरी स्थानों को ट्रैक करता है")

Rel(platform, notificationService,
  "ऑर्डर, भुगतान और डिलीवरी सूचनाएं भेजता है")

@enduml

8. सामान्य कोड-स्तरीय परिवर्तन करें

सिस्टम का नाम बदलें

System(platform, "भोजन डिलीवरी प्लेटफॉर्म",
  "भोजन ऑर्डर और डिलीवरी का समन्वय करता है।")

एक नया व्यक्ति जोड़ें

Person(customerSupport, "ग्राहक सहायता एजेंट",
  "ग्राहक समस्याओं की जांच करता है और रिफंड प्रक्रिया करता है।")

Rel(customerSupport, platform,
  "समस्याओं की जांच करता है और रिफंड संभालता है")

एक नया बाहरी सिस्टम जोड़ें

System_Ext(fraudService, "धोखाधड़ी पता लगाने की सेवा",
  "संदिग्ध भुगतान गतिविधियों का मूल्यांकन करता है।")

Rel(platform, fraudService,
  "भुगतान लेन-देन के लिए धोखाधड़ी जोखिम की जांच करता है")

संबंध की दिशा बदलें

Rel(paymentProvider, platform,
  "भुगतान प्राधिकरण और निपटान परिणाम लौटाता है")

प्राथमिक निर्भरता या अंतःक्रिया को दर्शाने के लिए संबंध की दिशा का उपयोग करें। यदि दिशा वास्तुकला के लिए महत्वपूर्ण नहीं है, तो एक सुसंगत रूढ़िवादिता चुनें और इसे पूरे आरेख में लागू करें।

लेआउट बदलें

C4-PlantUML निम्नलिखित जैसे लेआउट संकेतों का समर्थन करता है:

LAYOUT_LEFT_RIGHT()

या:

LAYOUT_TOP_DOWN()

आप दिशा संकेतों के साथ स्थान को भी प्रभावित कर सकते हैं:

Lay_R(customer, platform)
Lay_D(platform, paymentProvider)

लेआउट संकेतों का प्रयोग सावधानी से करें। बहुत अधिक मैनुअल बाधाएं डायग्राम को बनाए रखना कठिन बना सकती हैं।

9. VPasCode AI सहायता का उपयोग करें

कुछ VPasCode संस्करण AI-सहायता वाले डायग्राम संशोधन और कोड-त्रुटि सुधार प्रदान करते हैं। टूल निम्नलिखित जैसे निर्देश स्वीकार कर सकता है:

प्लेटफॉर्म और भुगतान प्रदाता के बीच एक बाहरी धोखाधड़ी पता लगाने सेवा जोड़ें।

या:

PlantUML सिंटैक्स त्रुटि को ठीक करें और वर्तमान डायग्राम संरचना को बनाए रखें।

VPasCode को AI-संचालित डायग्राम संशोधन, त्रुटि निदान और अनुवाद सुविधाओं का समर्थन करने के लिए भी दस्तावेज़ीकृत किया गया है, हालांकि उपलब्धता संस्करण या सदस्यता पर निर्भर हो सकती है।

10. PlantUML डायग्राम की जांच करें

डायग्राम को Visual Paradigm Online भेजने से पहले, सिंटैक्स और वास्तुकला दोनों की जांच करें।

सिंटैक्स जांच सूची

• स्क्रिप्ट इससे शुरू होती है @startuml.

• स्क्रिप्ट इससे समाप्त होती है @enduml.

• C4-PlantUML लाइब्रेरी शामिल है।

• हर संबंध मौजूद पहचानकर्ताओं का संदर्भ देता है।

• पहचानकर्ताओं में कोई अंतर या विराम चिह्न नहीं होते जो सिंटैक्स को तोड़ सकते हैं।

• उद्धरण चिह्न संतुलित हैं।

• वर्णन अत्यधिक लंबे नहीं हैं।

• पूर्वदृश्य बिना किसी त्रुटि के प्रदर्शित होता है।

C4 मॉडलिंग जांच सूची

• एक स्पष्ट रूप से पहचाना गया रुचि का सिस्टम है।

• उपयोगकर्ताओं को लोगों के रूप में मॉडल किया गया है, सॉफ्टवेयर सिस्टम के रूप में नहीं।

• बाहरी अनुप्रयोगों को बाहरी सिस्टम के रूप में मॉडल किया गया है।

• आंतरिक कंटेनरों को संदर्भ डायग्राम में शामिल नहीं किया जाता है।

• संबंध अर्थपूर्ण अंतःक्रियाओं का वर्णन करते हैं।

• डायग्राम को स्रोत कोड पढ़े बिना समझा जा सकता है।

• शब्दावली परियोजना की वास्तुकथा दस्तावेज़ीकरण से मेल खाती है।

अवांछित संदर्भ डायग्राम तत्व का उदाहरण

Container(api, "ऑर्डर API", "Java", "ऑर्डर संसाधित करता है")
ContainerDb(database, "ऑर्डर डेटाबेस", "PostgreSQL", "ऑर्डर संग्रहीत करता है")

ये कंटेनर-स्तर के तत्व हैं। ये C4 कंटेनर डायग्राम में आते हैं, सामान्यतः सिस्टम संदर्भ डायग्राम में नहीं।

भाग 2: डायग्राम को Visual Paradigm Online पर भेजें

11. “VP Online में संपादित करें” या “VP Online डायग्राम में संपादित करें” का उपयोग करें

कोड संस्करण सही होने के बाद, इसी तरह लेबल किए गए कार्रवाई का चयन करें:

• VP Online में संपादित करें

• VP Online डायग्राम में संपादित करें

• ऑनलाइन खोलें

• VP Online पर निर्यात करें

सटीक लेबल इंटरफ़ेस संस्करण के अनुसार भिन्न हो सकता है।

Visual Paradigm का पारिस्थितिकी तंत्र बनाए गए डायग्रामों को AI चैटबॉट से VPasCode में कोड-स्तर के सुधार के लिए और फिर पारंपरिक डायग्राम संपादन के लिए Visual Paradigm Online में ले जाने के लिए डिज़ाइन किया गया है।

ऑनलाइन डायग्राम संपादक तब उपयोगी होता है जब आपको चाहिए:

• आकारों को मैन्युअल रूप से स्थानांतरित करें

• तत्वों का आकार बदलें

• कनेक्टरों को समायोजित करें

• रंग और फ़ॉन्ट बदलें

• नोट या टिप्पणियाँ जोड़ें

• शीर्षक या परिशिष्ट जोड़ें

• प्रस्तुति प्रारूपण लागू करें

• डायग्राम तत्वों को सटीक रूप से संरेखित करें

• डायग्राम को साझा करने या निर्यात करने के लिए तैयार करें

12. Visual Paradigm Online GUI का उपयोग करके डायग्राम को संशोधित करें

जब डायग्राम Visual Paradigm Online में खुलता है:

तत्वों को स्थानांतरित करें

केंद्रीय सिस्टम के चारों ओर लोगों और बाहरी सिस्टम को स्पष्ट व्यवस्था में खींचें।

एक सामान्य लेआउट यह है:

• बाईं ओर या ऊपर लोग

• केंद्र में मुख्य सिस्टम

• दाईं ओर या नीचे बाहरी सिस्टम

पाठ संपादित करें

संशोधित करने के लिए किसी तत्व पर डबल-क्लिक करें या उसके विनिर्देशन पैनल का चयन करें:

• नाम

• विवरण

• स्टीरियोटाइप

• संबंध लेबल

नाम छोटे रखें और विवरण सूचनात्मक बनाएं।

संबंधों को संपादित करें

एक कनेक्टर का चयन करें:

• इसकी दिशा बदलें

• संबंध लेबल को संपादित करें

• इसे किसी अन्य तत्व से पुनः जोड़ें

• इसके मार्ग को समायोजित करें

• रेखा की शैली या रूप बदलें

तत्व जोड़ें

जोड़ने के लिए डायग्राम पैलेट का उपयोग करें:

• व्यक्ति

• बाहरी व्यक्ति

• सिस्टम

• बाहरी सिस्टम

• संबंध

• नोट

• सीमा

केवल उन तत्वों को जोड़ें जो संदर्भ स्तर पर संबंधित हैं।

प्रारूपण लागू करें

आप इनमें बदलाव करके पठनीयता में सुधार कर सकते हैं:

• फ़ॉन्ट का आकार

• भरण रंग

• सीमा रंग

• रेखा की मोटाई

• आकार का आकार

• संरेखण

• अंतराल

• कनेक्टर मार्ग निर्धारण

अर्थ संचारित करने का एकमात्र तरीका रंग का उपयोग करने से बचें। स्पष्ट लेबल भी उपयोग करें।

13. अनुशंसित प्रस्तुति लेआउट

एक साफ संदर्भ आरेख इस व्यवस्था का उपयोग कर सकता है:

बड़े आरेखों के लिए:

• मुख्य प्रणाली को केंद्र में रखें।

• लोगों को एक तरफ समूहित करें।

• बाहरी सॉफ़्टवेयर प्रणालियों को दूसरी तरफ समूहित करें।

• संबंध रेखाओं को पार करने से बचें।

• जहाँ संभव हो, संबंध लेबल को क्षैतिज रखें।

• पैराग्राफ के बजाय छोटे लेबल का उपयोग करें।

• केंद्रीय प्रणाली के आसपास पर्याप्त खाली जगह छोड़ें।

भाग 3: कोड और GUI संपादन के बीच चयन करना

VPasCode PlantUML के माध्यम से C4 मॉडल का समर्थन करता है और लाइव पूर्वावलोकन प्रदान करता है, जबकि Visual Paradigm Online एक पारंपरिक दृश्य आरेख-संपादन कार्यप्रवाह प्रदान करता है।

भाग 4: अनुशंसित एंड-टू-एंड कार्यप्रवाह

त्वरित कार्यप्रवाह

1. Visual Paradigm AI चैटबॉट खोलें।

2. C4 सिस्टम संदर्भ आरेच चुनें।

3. सिस्टम, उपयोगकर्ताओं और बाहरी सिस्टम का वर्णन करें।

4. आरेच जनरेट करें।

5. चैटबॉट से आंतरिक कार्यान्वयन विवरण हटाने के लिए कहें।

6. नामों, संबंधों और सीमा की समीक्षा करें।

7. चुनें VPasCode में खोलें.

8. C4-PlantUML स्रोत को संपादित करें।

9. परिणाम को रेंडर करें और मान्य करें।

10. चुनें VP Online में संपादित करें.

11. GUI का उपयोग करके लेआउट और रूपरेखा को परिष्कृत करें।

12. अंतिम आरेख निर्यात करें या साझा करें।

जिम्मेदारियों की अनुशंसित विभाजन

का उपयोग करें AI चैटबॉट के लिए:

• पहला मसौदा तैयार करना

• वास्तुकल्प विकल्पों की खोज करना

• भागीदार जोड़ना या हटाना

• संबंधों के विवरण को पुनः शब्दित करना

• आरेख में किसी भी अनुपस्थिति के लिए समीक्षा करना

का उपयोग करें VPasCode के लिए:

• अनेक तत्वों का नाम बदलना

• आरेख कोड का पुनः उपयोग करना

• सुसंगत संरचना लागू करना

• संस्करण नियंत्रण में कोड का प्रबंधन करना

• पुनरावृत्ति संरचनात्मक परिवर्तन करना

• लेआउट निर्देशों को ठीक करना

• पाठ-आधारित सत्य का स्रोत तैयार करना

का उपयोग करें Visual Paradigm Online के लिए:

• अंतिम दृश्य स्थिति

• प्रस्तुति प्रारूपण

• मैन्युअल कनेक्टर समायोजन

• नोट्स और टिप्पणियाँ जोड़ना

• हितधारकों के लिए एक आरेख तैयार करना

भाग 5: उदाहरण परिष्करण संवाद

प्रारंभिक अनुरोध

एक फूड डिलीवरी प्लेटफॉर्म के लिए C4 सिस्टम कॉन्टेक्स्ट डायग्राम बनाएं।

परिष्करण 1

ग्राहक, रेस्तरां प्रबंधक, डिलीवरी ड्राइवर और ऑपरेशन प्रशासक को व्यक्ति के रूप में जोड़ें।

परिष्करण 2

भुगतान प्रदाता, मानचित्र और भू-स्थान सेवा, और सूचना सेवा को बाहरी सिस्टम के रूप में जोड़ें।

परिष्करण 3

सभी डेटाबेस, APIs, माइक्रोसर्विसेज, कंटेनर और कार्यान्वयन विवरण हटा दें। यह स्तर 1 C4 सिस्टम कॉन्टेक्स्ट डायग्राम बना रहना चाहिए।

परिष्करण 4

संबंध लेबल को संक्षिप्त क्रिया वाक्यांशों में पुनर्लिखित करें और जहाँ संभव हो, उन्हें 10 शब्दों से कम रखें।

परिष्करण 5

अनुपलब्ध संबंधों और असंगत शब्दावली के लिए आरेख की समीक्षा करें। 'फूड डिलीवरी प्लेटफॉर्म' को एकमात्र रुचि का सिस्टम बनाए रखें।

परिष्करण 6

आरेख को C4-PlantUML के रूप में जनरेट करें और इसे VPasCode में संपादन के लिए उपलब्ध कराएं।

भाग 6: समस्या निवारण

आरेख में बहुत अधिक विवरण है

पूछें:

इसे एक कठोर C4 सिस्टम कॉन्टेक्स्ट डायग्राम में सरल बनाएं। कंटेनर, घटक, डेटाबेस, APIs और तकनीक के नाम हटा दें।

आरेख में बहुत अधिक प्रतिच्छेदित रेखाएं हैं

VPasCode में:

• कोशिश करें LAYOUT_LEFT_RIGHT() या LAYOUT_TOP_DOWN().

• सीमित Lay_ निर्देश जोड़ें।

• संबंध लेबल छोटे करें।

• दिखाए गए संबंधों की संख्या कम करें।

• अंतिम संस्करण को मैनुअल पोजिशनिंग के लिए VP Online पर ले जाएं।

PlantUML पूर्वावलोकन में त्रुटि दिखाई दे रही है

जांचें:

• C4 लाइब्रेरी शामिल है

• कॉमा गायब हैं

• अनबंद कोष्ठक

• गलत वर्तनी वाले पहचानकर्ता

• अपरिभाषित तत्वों का संदर्भ देने वाले संबंध

• असंतुलित उद्धरण चिह्न

• गलत तत्व नाम

एक संबंध को पहले से ही घोषित किए गए पहचानकर्ताओं का संदर्भ देना चाहिए, उदाहरण के लिए:

Person(customer, "ग्राहक", "ऑर्डर देता है")
System(platform, "फूड डिलीवरी प्लेटफॉर्म", "ऑर्डर संसाधित करता है")

Rel(customer, platform, "ऑर्डर देता है")

GUI संस्करण कोड संस्करण से भिन्न है

परिवर्तन के बाद दोनों संस्करणों को अलग-अलग संपादन प्रतिनिधित्व के रूप में मानें। तय करें कि कौन सा सत्य का स्रोत है:

• इसे उपयोग करें VPasCodeयदि डायग्राम को कोड के रूप में बनाए रखा जाएगा, तो इसे सत्य का स्रोत के रूप में उपयोग करें।

• इसे उपयोग करें Visual Paradigm Onlineयदि हितधारक इसे बार-बार दृश्य रूप से समायोजित करेंगे, तो इसे सत्य का स्रोत के रूप में उपयोग करें।

बिना सिंकराइज़ किए दोनों स्थानों पर असंबंधित परिवर्तन करने से बचें।

उत्पन्न किया गया डायग्राम गलत C4 स्तर का उपयोग करता है

चैटबॉट से पूछें:

इसे केवल C4 सिस्टम कॉन्टेक्स्ट डायग्राम के रूप में पुनः जनरेट करें। लोगों, रुचि के सिस्टम और बाहरी सॉफ़्टवेयर सिस्टम को दिखाएं। कंटेनर या घटक न दिखाएं।

अंतिम गुणवत्ता जाँच सूची

डायग्राम प्रकाशित करने से पहले, यह पुष्टि करें कि:

• डायग्राम में एक स्पष्ट शीर्षक है।

• रुचि का सिस्टम स्पष्ट है।

• लोगों और बाहरी सिस्टम को सही ढंग से वर्गीकृत किया गया है।

• संबंधों में अर्थपूर्ण लेबल हैं।

• कोई भी आंतरिक कार्यान्वयन विवरण कॉन्टेक्स्ट व्यू में लीक नहीं हुआ है।

• नामों में सुसंगत शब्दावली का उपयोग किया गया है।

• डायग्राम सामान्य ज़ूम पर पढ़ने योग्य है।

• संबंध रेखाएं आकारों या लेबलों को ढकती नहीं हैं।

• PlantUML स्रोत सफलतापूर्वक रेंडर होता है।

• VP ऑनलाइन संस्करण स्वीकृत वास्तुकला से मेल खाता है।

• अंतिम डायग्राम को सिस्टम से परिचित किसी व्यक्ति द्वारा समीक्षित किया गया है।

सबसे प्रभावी कार्यप्रवाह AI चैटबॉट का उपयोग तेज़ मॉडलिंग के लिए, VPasCode का उपयोग सटीक और पुनरावृत्ति योग्य C4-PlantUML संपादन के लिए, और Visual Paradigm Online का उपयोग अंतिम दृश्य परिष्करण के लिए करना है। यह एक ही प्रक्रिया में संवादात्मक जनरेशन, डायग्राम-एज-कोड रखरखाव और GUI-आधारित प्रस्तुति संपादन को जोड़ता है।

यह पोस्ट Deutsch, English, Español, Français, Bahasa Indonesia, 日本語, Polski, Portuguese और Ру́сский में भी उपलब्ध है।