VPasCode پلتفرم مبتنی بر مرورگر و متن‌به‌نمودار بصری پارادایم ویژوال است. این ابزار به کاربران امکان می‌دهد تا نمودارها را با نوشتن کد نمودار، تولید کد با هوش مصنوعی، یا شروع با یک توصیف به زبان طبیعی ایجاد کنند. نمودار به‌صورت زنده در کنار کد منبع رندر می‌شود و به کاربران اجازه می‌دهد تا به سرعت بین الزامات، کد و مستندات بصری جابجا شوند. VPasCode از فناوری‌های نمودار از جمله PlantUML، Mermaid، Graphviz و سایر فرمت‌های مبتنی بر متن پشتیبانی می‌کند.

VPasCode چیست؟

VPasCode از رویکرد نمودار-به‌عنوان-کد در مدل‌سازی بصری استفاده می‌کند.

به‌جای رسم دستی هر شکل، شما نمودار را با متن توصیف می‌کنید. این پلتفرم متن را به یک نمودار بصری تبدیل می‌کند.

برای مثال، یک نمودار مورد استفاده PlantUML می‌تواند به صورت زیر نوشته شود:

@startuml

جهت چپ به راست

نقش مشتری
نقش "کارگزار پشتیبانی" به عنوان Agent

مستطیل "سیستم پشتیبانی مشتری" {
  usecase "ثبت شکایت" به عنوان Submit
  usecase "بررسی شکایت" به عنوان Review
  usecase "حل شکایت" به عنوان Resolve
  usecase "بستن شکایت" به عنوان Close
}

مشتری --> Submit
Agent --> Review
Agent --> Resolve
مشتری --> Close

Review ..> Resolve : <<شامل>>
Resolve ..> Close : <<شامل>>

@enduml

VPasCode این منبع را به یک نمودار بصری تبدیل می‌کند، بدون اینکه کاربران مجبور باشند هر عنصر را به‌صورت دستی قرار دهند.

نمای کلی ویژگی‌های اصلی

این پلتفرم در مرورگر وب اجرا می‌شود، بنابراین کاربران می‌توانند بدون نصب برنامه دسکتاپ یا پیکربندی محیط محلی، کار با نمودار را آغاز کنند.

شروع کار

۱. باز کردن VPasCode

فضای کاری VPasCode را در یک مرورگر باز کنید.

فضای کاری معمولاً شامل موارد زیر است:

• ویرایشگر کد-نمودار

• پیش‌نمایش زنده نمودار

• کنترل‌های کمک هوش مصنوعی

• نمونه‌ها یا قالب‌های نمودار

• گزینه‌های خروجی و اشتراک‌گذاری

۲. انتخاب یک زبان نمودار

نحو یا موتور نمودار مناسب برای وظیفه خود را انتخاب کنید.

PlantUML

PlantUML برای موارد زیر بسیار مناسب است:

• نمودارهای UML

• نمودارهای مورد استفاده

• نمودارهای کلاس

• نمودارهای توالی

• نمودارهای فعالیت

• نمودارهای مؤلفه

• نمودارهای استقرار

• نمودارهای معماری C4

• نمودارهای ArchiMate

PlantUML زمانی که یک تیم به مستندات فنی دقیق، رسمی و قابل نگهداری نیاز دارد، به‌ویژه مفید است.

Mermaid

Mermaid برای موارد زیر مفید است:

• نمودارهای جریان ساده

• مستندات مارک‌داون

• مستندات گیت‌هاب یا گیت‌لب

• نمودارهای توالی پایه

• نمودارهای گانت

• نمودارهای وضعیت

Graphviz

Graphviz برای موارد زیر مفید است:

• ساختارهای شبکه

• نقشه‌های وابستگی

• جریان‌های داده

• نمودارهای زیرساخت

• نمودارهای رابطه‌ای بزرگ

رویکرد چندموتوره VPasCode به کاربران اجازه می‌دهد مناسب‌ترین نمادگذاری را انتخاب کنند، به‌جای اینکه هر نمودار را به یک نحو اجباری کنند.

۳. با یک مثال شروع کنید

اگر با نمودار-به-کد آشنا نیستید:

1. منطقه نمونه‌ها یا قالب‌ها را باز کنید.

2. یک نوع نمودار را انتخاب کنید.

3. کد منبع را بررسی کنید.

4. مشاهده کنید که هر خط چگونه بر نمودار بصری تأثیر می‌گذارد.

5. محتوای نمونه را با فرآیند یا معماری خود جایگزین کنید.

نمونه‌های داخلی به‌ویژه برای یادگیری نحو و شروع نمودارهای رایج بدون نوشتن همه چیز از صفر مفید هستند.

ایجاد نمودار با هوش مصنوعی

۱. نمودار را به زبان طبیعی توصیف کنید

از یک دستورالعمل واضح استفاده کنید که نوع نمودار، شرکت‌کنندگان، فعالیت‌ها و روابط را مشخص می‌کند.

مثال:

یک نمودار مورد استفاده PlantUML برای یک سیستم تحویل غذا آنلاین تولید کنید. بازیگرهای مشتری، پرسنل رستوران، راننده تحویل، درگاه پرداخت و مدیر را شامل شود. موارد استفاده برای جستجوی رستوران‌ها، ثبت سفارش، پرداخت، ردیابی تحویل، مدیریت منوها و مدیریت بازپرداخت را نمایش دهید.

هوش مصنوعی VPasCode می‌تواند یک توصیف به زبان طبیعی را به کد نمودار، مانند PlantUML یا Mermaid، تبدیل کند.

۲. کد تولیدشده را بررسی کنید

پس از تولید:

1. کد را در پنل سمت چپ بخوانید.

2. نوع نمودار و نحو را بررسی کنید.

3. تأیید کنید که تمام بازیگران، وظایف، سیستم‌ها و روابط شامل شده‌اند.

4. منبع را با پیش‌نمایش بصری در سمت راست مقایسه کنید.

نمودارهای تولیدشده با هوش مصنوعی نقاط شروع عالی هستند، اما نتیجه باید از نظر دقت تجاری و کیفیت مدل‌سازی بررسی شود.

۳. نمودار را با هوش مصنوعی اصلاح کنید

از ویژگی اصلاح هوش مصنوعی برای صدور دستورالعمل‌های پیگیری استفاده کنید.

مثال‌ها:

یک بازیگر مدیر اضافه کنید و مدیر را به مورد استفاده تأیید بازپرداخت متصل کنید.

این نمودار فعالیت را به یک نمودار فعالیت استاندارد بدون شناور (non-swimlane) تغییر دهید.

یک مسیر خطا هنگام شکست پرداخت اضافه کنید.

موارد استفاده را بر اساس مشتری، رستوران و عملیات تحویل گروه‌بندی کنید.

«پردازش سفارش» را به «اعتبارسنجی و تأیید سفارش» تغییر نام دهید.

ویژگی اصلاح هوش مصنوعی برای به‌روزرسانی اسکریپت‌های نمودار موجود از طریق دستورات متنی ساده طراحی شده است، نه اینکه از کاربران بخواهد هر خط را به‌صورت دستی بازنویسی کنند.

۴. از هوش مصنوعی برای رفع خطاهای نحو استفاده کنید

اگر نمودار رندر نشد:

1. پیام خطا را بررسی کنید.

2. ویژگی اصلاح کد با هوش مصنوعی را باز کنید.

3. از ابزار بخواهید که نحو را اصلاح کند، در حالی که نمودار مورد نظر را حفظ نماید.

4. منبع اصلاح‌شده را بررسی کنید.

5. تأیید کنید که نتیجه رندر شده صحیح است.

دستورالعمل نمونه:

خطای نحو PlantUML را بدون تغییر بازیگران، موارد استفاده یا روابط اصلاح کنید.

ویژگی اصلاح خطا با هوش مصنوعی برای کاهش وقفه‌های ناشی از دستورات گمشده، نحو نامعتبر یا کد نمودار با ساختار نادرست طراحی شده است.

ویرایش نمودار به عنوان کد

۱. ویرایش مستقیم منبع

سمت چپ محیط کاری VPasCode شامل منبع نمودار است. برای اعمال تغییرات دقیق، کد را مستقیماً ویرایش کنید.

به عنوان مثال:

@startuml

actor Customer
actor "Payment Gateway" as Payment

rectangle "Online Store" {
  usecase "Browse Products" as Browse
  usecase "Place Order" as Order
  usecase "Pay for Order" as Pay
}

Customer --> Browse
Customer --> Order
Customer --> Pay
Payment --> Pay

@enduml

شما می‌توانید تغییر دهید:

• نام عناصر

• روابط

• جهت‌های چیدمان

• شرکت‌کنندگان

• شرایط

• یادداشت‌ها

• گروه‌ها

• تم‌ها

• رنگ‌ها

• قابلیت مشاهده

• ساختار نمودار

۲. از پیش‌نمایش زنده استفاده کنید

سمت راست محیط کاری، نمودار رندر شده را نمایش می‌دهد.

با تغییر منبع:

1. ویرایشگر کد به‌روزرسانی‌شده را پردازش می‌کند.

2. پیش‌نمایش به‌روزرسانی می‌شود.

3. شما بلافاصله تأثیر تغییر را مشاهده می‌کنید.

4. می‌توانید تا زمانی که نتیجه صحیح شود، به تنظیمات منبع ادامه دهید.

پیش‌نمایش زنده در کنار هم یکی از مهم‌ترین ویژگی‌های بهره‌وری است، زیرا نیاز به صادرات و بازنمایش مکرر نمودارها پس از هر ویرایش را از بین می‌برد.

۳. از تغییرات کوچک و کنترل‌شده استفاده کنید

برای نمودارهای پیچیده، هر بار یک بخش را تغییر دهید:

1. یک شرکت‌کننده اضافه کنید.

2. روابط آن را اضافه کنید.

3. پیش‌نمایش را بررسی کنید.

4. عنصر بعدی را اضافه کنید.

5. دوباره پیش‌نمایش را بررسی کنید.

این کار یافتن خطاهای نحوی را آسان‌تر می‌کند و از تغییرات تصادفی در بخش‌های نامرتبط نمودار جلوگیری می‌کند.

۴. برای توضیح منبع، نظرات اضافه کنید

از نظرات برای مستندسازی بخش‌های نمودار استفاده کنید:

@startuml

' بازیگران
actor Customer
actor Administrator

' مرز سیستم
rectangle "Order Management System" {
  usecase "Create Order" as CreateOrder
  usecase "Review Order" as ReviewOrder
}

' روابط
Customer --> CreateOrder
Administrator --> ReviewOrder

@enduml

نظرات درک و نگهداری منبع را برای سایر اعضای تیم آسان‌تر می‌کنند.

ویرایش با ویرایشگر نمودار آنلاین Visual Paradigm

VPasCode برای ویرایش مبتنی بر منبع ایده‌آل است، اما برخی کاربران ترجیح می‌دهند از یک رابط گرافیکی استفاده کنند. پس از تولید یا وارد کردن نمودار، کاربر می‌تواند آن را در ویرایشگر نمودار آنلاین Visual Paradigm برای ویرایش مستقیم رابط کاربری گرافیکی باز کند.

۱. نمودار را وارد یا باز کنید

بسته به جریان کاری:

1. نمودار را با چت‌بات هوش مصنوعی تولید کنید.

2. انتخاب کنیدباز کردن در VPasCode, وارد کردن به Visual Paradigmیا دستور یکپارچه‌سازی معادل.

3. نمودار را در ویرایشگر نمودار آنلاین Visual Paradigm باز کنید.

4. صبر کنید تا بوم نمودار و پالت شکل‌ها بارگذاری شوند.

یکپارچگی به کاربران اجازه می‌دهد با یک مفهوم تولیدشده توسط هوش مصنوعی شروع کرده و سپس ویرایش دقیق منبع یا بصری را ادامه دهند.

۲. از پالت شکل‌ها استفاده کنید

پالت سمت چپ شامل عناصر نمودار مناسب برای نوع نمودار انتخاب‌شده است.

برای مدل‌سازی BPMN یا فعالیت، این موارد ممکن است شامل موارد زیر باشد:

• رویدادهای شروع

• رویدادهای پایان

• وظایف

• زیرفرآیندها

• درگاه‌ها

• استخرها

• مسیرهای شناور

• جریان‌های ترتیبی

• جریان‌های پیام

• اشیاء داده

• یادداشت‌ها

برای مدل‌سازی UML، پالت ممکن است شامل موارد زیر باشد:

• نقش‌ها

• مورد استفاده

• کلاس‌ها

• رابط‌ها

• اجزا

• گره‌ها

• حالت‌ها

• پیام‌ها

• ارتباط‌ها

• عمومی‌سازی‌ها

• وابستگی‌ها

۳. عناصر را به صورت گرافیکی اضافه کنید

برای افزودن یک عنصر:

1. یک شکل را از پالت انتخاب کنید.

2. آن را به بوم بکشید.

3. آن را در موقعیت مناسب قرار دهید.

4. روی عنصر دوبار کلیک کنید.

5. نام آن را وارد کنید.

6. تغییر را تأیید کنید.

۴. جابجایی و تغییر اندازه عناصر

از بوم برای استفاده کنید:

• جابجایی عناصر

• تغییر اندازه اشکال

• تراز کردن آیتم‌ها

• توزیع یکنواخت آیتم‌ها

• تغییر موقعیت برچسب‌ها

• بهبود فاصله‌گذاری

• بازآرایی روابط

این مورد به‌ویژه برای کارهای ارائه نهایی مفید است، جایی که چیدمان و خوانایی مهم‌تر از ساختار کد منبع هستند.

۵. ایجاد روابط

برای اتصال عناصر:

1. ابزار اتصال یا رابطه را انتخاب کنید.

2. از عنصر مبدأ به عنصر هدف بکشید.

3. نوع مناسب رابطه را انتخاب کنید.

4. در صورت نیاز، یک برچسب اضافه کنید.

5. جهت فلش را تأیید کنید.

برای مثال، در یک نمودار مورد استفاده:

• یک بازیگر را با یک ارتباط به یک مورد استفاده متصل کنید.

• رفتار مورد نیاز را با شامل.

• رفتار اختیاری را با گسترش.

• اتصال بازیگران یا موارد استفاده تخصصی با تعمیم.

۶. ویرایش برچسب‌ها و ویژگی‌ها

از ویرایشگر گرافیکی برای تغییر موارد زیر استفاده کنید:

• نام‌ها

• توضیحات

• برچسب‌های رابطه

• انواع عناصر

• رنگ‌ها

• فونت‌ها

• استایل‌های خط

• یادداشت‌ها

• قابلیت مشاهده

• مستندات نمودار

۷. اعتبارسنجی نمودار نهایی

قبل از تکمیل مدل، بررسی کنید:

• هر عنصر نامی واضح دارد.

• رابطه‌ها به عناصر صحیح متصل شده‌اند.

• پیکان‌ها در جهت مورد نظر اشاره می‌کنند.

• هیچ عنصری روی هم قرار ندارد.

• نمودار دارای یک ترتیب خوانش واضح است.

• مدل از قوانین نمادگذاری خود پیروی می‌کند.

• چیدمان بصری برای مخاطبان آن مناسب است.

خروجی گرفتن و اشتراک‌گذاری

پس از تکمیل نمودار، می‌توان از VPasCode برای اشتراک‌گذاری یا خروجی گرفتن از نتیجه استفاده کرد.

گزینه‌های رایج شامل موارد زیر است:

• خروجی گرفتن به فرمت PNG

• خروجی گرفتن به فرمت SVG

• اشتراک‌گذاری لینک نمودار زنده

• کپی کردن کد منبع

• جای‌گذاری نمودار در مستندات

• ارسال نمودار به سایر ابزارهای Visual Paradigm

فرمت SVG برای مستندات فنی ترجیح داده می‌شود زیرا بدون از دست دادن کیفیت مقیاس‌پذیر است. فرمت PNG برای ارائه‌ها، ایمیل و اشتراک‌گذاری سریع مناسب است. این پلتفرم هم صادرات تصویر و هم URLهای قابل اشتراک‌گذاری را تبلیغ می‌کند.

موارد استفاده عملی

معماری نرم‌افزار

از VPasCode برای مدل‌سازی استفاده کنید:

• معماری میکروسرویس

• ارتباطات API

• توپولوژی استقرار

• زیرساخت ابری

• وابستگی‌های سرویس

• سطح‌های معماری C4

مثال دستور:

یک نمودار کانتینر C4 PlantUML برای یک سیستم بانکداری آنلاین با برنامه وب، برنامه موبایل، سرویس احراز هویت، سرویس پرداخت، پایگاه داده تراکنش‌ها و شبکه بانکی خارجی تولید کنید.

مدل‌سازی فرآیندهای کسب‌وکار

از آن برای ایجاد موارد زیر استفاده کنید:

• نمودارهای BPMN

• نمودارهای فعالیت

• رویه‌های تأیید

• سفر مشتری

• فرآیندهای عملیاتی

• جریان‌های استثنا

مثال دستور:

یک فرآیند BPMN برای تأیید فاکتور ایجاد کنید. شامل نوارهای متقاضی، مدیر، مالی و حساب‌های پرداخت باشد. یک مسیر رد را اضافه کنید که فاکتور را به متقاضی بازگرداند.

تحلیل الزامات

از آن برای تجسم موارد زیر استفاده کنید:

• داستان‌های کاربر

• مورد استفاده

• نقش‌ها

• مرزهای سیستم

• وابستگی‌های عملکردی

• سناریوهای پذیرش

مثال دستور:

یک نمودار مورد استفاده برای یک سیستم کتابخانه آنلاین با بازیگرهای عضو، کتابدار، خدمات پرداخت و مدیر ایجاد کنید.

پایگاه داده و مدل‌سازی داده

از نمودارسازی مبتنی بر متن برای توصیف استفاده کنید:

• موجودیت‌ها

• جدول‌ها

• روابط

• ویژگی‌ها

• خط لوله داده

• ساختارهای JSON یا SQL

مستندات فنی

VPasCode برای نگهداری نمودارها در کنار موارد زیر مفید است:

• کد منبع

• فایل‌های مارک‌داون

• سوابق تصمیم‌گیری معماری

• مستندات API

• ویکی‌های پروژه

• مشخصات طراحی

آموزش و پرورش

معلمان و دانش‌آموزان می‌توانند از آن برای استفاده کنند:

• نمایش نمادشناسی UML

• یادگیری نحو PlantUML

• مقایسه کد منبع با خروجی بصری

• تمرین مدل‌سازی الزامات

• ایجاد نمودارها بدون نرم‌افزارهای ترسیم پیچیده

کارگاه‌های تیمی

در طول جلسات برنامه‌ریزی یا بازبینی، یک تیم می‌تواند:

1. یک سیستم یا فرآیند را توصیف کنید.

2. یک نمودار اولیه با هوش مصنوعی ایجاد کنید.

3. آن را به صورت مشارکتی بررسی کنید.

4. منبع یا مدل بصری را اصلاح کنید.

5. نتیجه را به عنوان یک مرجع مشترک به اشتراک بگذارید.

چه کسانی باید از VPasCode استفاده کنند؟

توسعه‌دهندگان نرم‌افزار

توسعه‌دهندگان می‌توانند از VPasCode برای مستندسازی استفاده کنند:

• معماری سیستم

• ساختارهای کلاس

• تعاملات API

• جریان‌های توالی

• محیط‌های استقرار

• وابستگی‌های سرویس

این ابزار به ویژه برای توسعه‌دهندگانی مفید است که ترجیح می‌دهند نمودارها را به صورت متن ذخیره کرده و آن‌ها را همزمان با کد به‌روزرسانی کنند.

معماران راه‌حل و سازمانی

معماران می‌توانند از آن برای ایجاد موارد زیر استفاده کنند:

• نمودارهای C4

• نمودارهای مؤلفه‌ای

• نمودارهای استقرار

• نمای معماری سازمانی

• نقشه‌های یکپارچه‌سازی

• منظره‌های برنامه‌ای

توانایی ترکیب تولید هوش مصنوعی با ویرایش دقیق منبع، به معماران کمک می‌کند تا از مفاهیم اولیه به ارتباطات فنی ساختاریافته حرکت کنند.

تحلیل‌گران کسب‌وکار

تحلیل‌گران کسب‌وکار می‌توانند از VPasCode برای موارد زیر استفاده کنند:

• فرآیندهای BPMN

• نمودارهای فعالیت

• نمودارهای مورد استفاده

• تصویرسازی نیازمندی‌ها

• ارتباط با ذینفعان

• کارگاه‌های بهبود فرآیند

مدیران محصول و تیم‌های چابک

تیم‌های محصول می‌توانند از آن برای تجسم موارد زیر استفاده کنند:

• سفر کاربران

• جریان‌های ویژگی

• رفتار سیستم

• دامنه اسپرینت

• جریان‌های کاری محصول

• سناریوهای پذیرش

نویسندگان فنی

نویسندگان فنی می‌توانند از آن برای نگهداری نمودارهایی که دارای ویژگی‌های زیر هستند استفاده کنند:

• قابل بازتولید

• آسان برای به‌روزرسانی

• یکپارچه

• مناسب برای مستندات کنترل‌شده نسخه

• قابل صادرات به فرمت‌های رایج تصویر

دانشجویان و مبتدیان

مبتدیان از ترکیب موارد زیر بهره‌مند می‌شوند:

• تولید هوش مصنوعی با زبان طبیعی

• نمونه‌های داخلی

• بازخورد بصری بلادرنگ

• ویرایش مستقیم منبع

• گزینه‌های ویرایش گرافیکی

کاربران نیازی به حفظ کردن تمام نحو قبل از ایجاد اولین نمودار خود ندارند.

چه چیزی VPasCode را متمایز می‌کند؟

۱. آن هوش مصنوعی و نمودار-به-کد را ترکیب می‌کند

بسیاری از ابزارها عمدتاً بر یا تولید هوش مصنوعی یا رسم دستی نمودار تمرکز دارند. VPasCode ترکیبی است از:

• تولید با زبان طبیعی

• بهبود هوش مصنوعی

• ویرایش کد منبع

• رندر زنده

• ویرایش نمودار بصری

• خروجی و اشتراک‌گذاری

این یک جریان کاری پیوسته از ایده تا مدل نهایی ایجاد می‌کند.

۲. از چندین زبان نموداری پشتیبانی می‌کند

کاربران می‌توانند با PlantUML، Mermaid، Graphviz و سایر فرمت‌های پشتیبانی‌شده در یک محیط کار کنند. این ارزشمند است زیرا نمودارهای مختلف از نمادگذاری‌های متفاوت بهره می‌برند.

۳. بازخورد بصری فوری ارائه می‌دهد

پیش‌نمایش زنده به کاربران اجازه می‌دهد تغییرات نمودار را به محض ویرایش کد منبع مشاهده کنند. این برای یادگیری نحو، اصلاح چیدمان‌ها و آزمایش روابط مفید است.

۴. تولید هوش مصنوعی را با ویرایش دقیق پیوند می‌دهد

هوش مصنوعی برای تهیه پیش‌نویس اولیه مفید است، اما نمودارهای حرفه‌ای اغلب نیازمند عبارت‌بندی دقیق، ساختار و چیدمان هستند. VPasCode پلی از محتوای تولیدشده توسط هوش مصنوعی به ویرایش کد منبع در سطح خط و اصلاح بصری فراهم می‌کند.

۵. از هر دو جریان کاری فنی و غیرفنی پشتیبانی می‌کند

یک تحلیلگر کسب‌وکار ممکن است با توصیف فرآیند به زبان طبیعی شروع کند. یک توسعه‌دهنده ممکن است کد PlantUML را ویرایش کند. یک ذینفع ممکن است ترجیح دهد نمودار را به صورت بصری تنظیم کند. VPasCode از هر سه رویکرد پشتیبانی می‌کند.

۶. مبتنی بر مرورگر است

از آنجا که VPasCode در مرورگر کار می‌کند، کاربران می‌توانند بدون نصب محلی، افزونه‌ها یا پیکربندی دستی محیط شروع به کار کنند.

چرا VPasCode برای هوش مصنوعی دوستانه است

ورودی به زبان طبیعی

کاربران می‌توانند آنچه را می‌خواهند توصیف کنند، به جای اینکه با نحو شروع کنند.

برای مثال:

یک نمودار توالی ایجاد کنید که ورود مشتری از طریق یک برنامه وب، دروازه API، سرویس احراز هویت و پایگاه داده کاربران را نشان دهد.

هوش مصنوعی می‌تواند این توصیف را به کد نمودار تبدیل کند.

تکرار با کمک هوش مصنوعی

مفیدترین جریان کاری هوش مصنوعی تکراری است:

1. نسخه اول را تولید کنید.

2. نمودار را بررسی کنید.

3. از هوش مصنوعی بخواهید عناصر را اضافه یا حذف کند.

4. نتیجه را بازبینی کنید.

5. اگر دقت لازم است، کد منبع را به صورت دستی ویرایش کنید.

6. نمودار را در ویرایشگر رابط کاربری گرافیکی (GUI) برای کارهای نهایی چیدمان باز کنید.

هوش مصنوعی با نمودارهای موجود کار می‌کند

هوش مصنوعی می‌تواند یک نمودار موجود را اصلاح کند، به جای اینکه تنها یک نمودار جدید تولید کند. این قابلیت از دستورالعمل‌هایی مانند موارد زیر پشتیبانی می‌کند:

یک مسیر شکست پس از سرویس پرداخت اضافه کنید.

همه برچسب‌ها را به زبان فرانسوی ترجمه کنید.

یک نقش مدیر جدید اضافه کنید.

این معماری را به یک نمودار زمینه در سطح بالا ساده کنید.

پشتیبانی هوش مصنوعی شامل قابلیت‌های تولید، اصلاح، رفع خطا و ترجمه است.

هوش مصنوعی مانع سینتاکس را کاهش می‌دهد

کاربرانی که PlantUML یا Mermaid را نمی‌شناسند، همچنان می‌توانند یک پیش‌نویس اولیه مفید ایجاد کنند. سپس آن‌ها می‌توانند با مقایسه دستورالعمل به زبان طبیعی با کد تولید شده و خروجی رندر شده، یاد بگیرند.

چرا VPasCode با رویکرد چابک همخوانی دارد

۱. تکرار سریع

تیم‌های چابک اغلب نیازمندی‌ها را تغییر می‌دهند. یک نمودار مبتنی بر متن می‌تواند سریع‌تر از یک نمودار که به صورت دستی بازنویسی شده است، به‌روزرسانی شود.

برای مثال، یک تیم می‌تواند تغییر دهد:

:اعتبارسنجی پرداخت;

به:

:اعتبارسنجی پرداخت با استفاده از درگاه پرداخت;

و بلافاصله نمودار به‌روزرسانی شده را مشاهده کنید.

۲. پشتیبانی از نیازمندی‌های در حال تکامل

در طول اصلاح بک‌لاگ، تیم می‌تواند یک داستان کاربر را به موارد زیر ترجمه کند:

• یک نمودار مورد استفاده

• یک نمودار فعالیت

• یک نمودار توالی

• یک جریان فرآیند

• یک نمای معماری سیستم

نمودار می‌تواند با بهتر درک شدن داستان، تکامل یابد.

۳. درک مشترک را تشویق می‌کند

یک نمودار تولیدشده، به توسعه‌دهندگان، آزمون‌کنندگان، مالکان محصول و ذینفعان کسب‌وکار، یک مدل بصری مشترک برای بحث ارائه می‌دهد.

به‌جای بحث درباره یک نیازمندی مبهم صرفاً از طریق متن، تیم می‌تواند موارد زیر را بازبینی کند:

• نقش‌ها

• مرزهای سیستم

• اقدامات کاربر

• نقاط تصمیم‌گیری

• جریان‌های جایگزین

• نقاط یکپارچه‌سازی

۴. با تحویل تدریجی به خوبی کار می‌کند

تیم‌های چابک می‌توانند با یک نمودار ساده شروع کرده و به‌مرور جزئیات را اضافه کنند:

1. یک زمینه سیستمی سطح‌بالا ایجاد کنید.

2. اجزای اصلی را اضافه کنید.

3. تعاملات را اضافه کنید.

4. استثناها را اضافه کنید.

5. جزئیات پیاده‌سازی را اضافه کنید.

6. چیدمان را برای مستندات اصلاح کنید.

این کار از تلاش برای تولید یک مدل کامل پیش از آنکه تیم مسئله را درک کند، جلوگیری می‌کند.

۵. از مستندات زنده پشتیبانی می‌کند

از آنجا که نمودار به‌صورت کد منبع نمایش داده می‌شود، هرگاه سیستم تغییر کند، قابل به‌روزرسانی است. این امر نگهداری آن را عملی‌تر از یک تصویر ثابت می‌کند که به‌سرعت منسوخ می‌شود.

۶. همکاری بین نقش‌ها را امکان‌پذیر می‌سازد

اعضای مختلف تیم می‌توانند از روش‌های ویرایش متفاوتی استفاده کنند:

• مالک محصول: دستورات هوش مصنوعی به زبان طبیعی

• تحلیل‌گر کسب‌وکار: اصلاح BPMN یا نمودار فعالیت

• توسعه‌دهنده: ویرایش کد منبع PlantUML

• معمار: مدل‌سازی ساختاری و یکپارچه‌سازی

• نویسنده فنی: قالب‌بندی نهایی و مستندسازی

۷. به خودکارسازی مستندات کمک می‌کند

تیم‌ها می‌توانند نمودارها را برای یادداشت‌های انتشار، مستندات معماری، مشخصات فنی و ویکی‌های پروژه صادر کنند. آن‌ها همچنین می‌توانند لینک‌های زنده نمودار را به اشتراک بگذارند تا ذینفعان به آخرین نسخه دسترسی داشته باشند.

روند کاری چابک پیشنهادی

از گردش کار زیر در طول یک پروژه چابک استفاده کنید:

1. نیازمندی را توصیف کنیدبه زبان طبیعی.

2. یک نمودار اولیه ایجاد کنیدبا هوش مصنوعی.

3. مدل را بازبینی کنیدبا مالک محصول و تیم توسعه.

4. نمودار را اصلاح کنیدبا استفاده از دستورات هوش مصنوعی.

5. منبع را ویرایش کنیدبرای تغییرات فنی دقیق.

6. ویرایشگر نمودار را باز کنیدبرای چیدمان و قالب‌بندی.

7. نتیجه را صادر یا به اشتراک بگذاریدبا تیم.

8. منبع را به‌روزرسانی کنیدوقتی داستان کاربر یا پیاده‌سازی تغییر می‌کند.

بهترین روش‌ها

• از دستورات واضح و مشخص استفاده کنید.

• فعالیت‌ها را با افعال عملی نام‌گذاری کنید.

• نمودارها را بر یک هدف متمرکز نگه دارید.

• از قرار دادن جزئیات بیش از حد در یک نمودار واحد خودداری کنید.

• فقط زمانی که مسئولیت مهم است، از نوارها (lanes) استفاده کنید.

• خروجی‌های دروازه را به وضوح برچسب‌گذاری کنید.

• روابط تولیدشده توسط هوش مصنوعی را با دقت بازبینی کنید.

• تغییرات کوچک در کد منبع ایجاد کنید و پیش‌نمایش را به‌طور مکرر بررسی کنید.

• برای سازماندهی اسکریپت‌های PlantUML طولانی از نظرات استفاده کنید.

• منبع را همراه مستندات مرتبط یا آثار پروژه نگه دارید.

• برای بهبود نهایی چیدمان و ارائه از ویرایشگر رابط کاربری گرافیکی (GUI) استفاده کنید.

• هنگامی که مقیاس‌پذیری با کیفیت بالا مهم است، به فرمت SVG صادر کنید.

• خروجی هوش مصنوعی را به عنوان پیش‌نویسی که نیاز به بازبینی انسانی دارد، در نظر بگیرید.

خلاصه

VPasCode به دلیل ترکیب تولید هوش مصنوعی به زبان طبیعی، چندین زبان نموداری، رندرینگ بلادرنگ، دقت کد منبع و ویرایش گرافیکی در یک جریان کاری مبتنی بر مرورگر، متمایز است. این ابزار برای توسعه‌دهندگان، معماران، تحلیل‌گران کسب‌وکار، مدیران محصول، تیم‌های چابک (Agile)، نویسندگان فنی، مربیان و دانشجویان مفید است.

قوی‌ترین جریان کاری آن عبارت است از:

توصیف با متن → تولید با هوش مصنوعی → بهبود با هوش مصنوعی → ویرایش کد منبع → پیش‌نمایش بلادرنگ → قالب‌بندی بصری → اشتراک‌گذاری نمودار نهایی.

این ترکیب، VPasCode را به‌ویژه برای تیم‌های چابک (Agile) که نیاز دارند نمودارها به سرعت همراه با الزامات، کد و تصمیمات محصول تکامل یابند، بسیار مؤثر می‌کند.

منابع