پلتفرم یکپارچه Visual Paradigm: راهنمای جامع

پلتفرم یکپارچه Visual Paradigm یک فضای کاری متمرکز است که Visual Paradigm Desktop را با برنامه‌های مبتنی بر مرورگر برای مدل‌سازی بصری، مستندسازی، تحلیل کسب‌وکار، معماری سازمانی، برنامه‌ریزی چابک، مدیریت پروژه، طراحی پایگاه داده، مهندسی نرم‌افزار و کارهای پشتیبانی‌شده توسط هوش مصنوعی به هم متصل می‌کند. این پلتفرم بهتر است به‌عنوان لایه‌ای برای یکپارچه‌سازی و دسترسی در نظر گرفته شود، نه جایگزینی برای Visual Paradigm Desktop یا VP Online.

۱. پلتفرم یکپارچه چه کاری انجام می‌دهد

این پلتفرم سه مشکل رایج را حل می‌کند:

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

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

• جدایی دسکتاپ و ابر:برنامه‌های دسکتاپ برای مدل‌سازی دقیق و کار آفلاین قدرتمند هستند، در حالی که برنامه‌های وب برای دسترسی و همکاری مناسب‌ترند.

پلتفرم یکپارچه این قابلیت‌ها را از طریق موارد زیر گرد هم می‌آورد:

• یک فضای کاری متمرکز

• نمای شبیه به درایو برای پروژه‌ها و مصنوعات

• دسترسی به پروژه‌های Visual Paradigm Desktop

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

• منوی ایجاد یکپارچه

• ابزارهای مستندسازی و همکاری آنلاین

• ارتباطات بین نمودارها، اسناد و مصنوعات برنامه‌ریزی پروژه

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

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

۲. پلتفرم چگونه در اکوسیستم Visual Paradigm جای می‌گیرد

پلتفرم یکپارچه در کنار سایر محصولات Visual Paradigm کار می‌کند.

اجزا	هدف اصلی	مناسب‌ترین برای
Visual Paradigm Desktop	محیط مدل‌سازی و مهندسی عمیق	UML، BPMN، SysML، ArchiMate، مدل‌سازی پایگاه داده، مهندسی کد، الزامات و کارهای آفلاین
پلتفرم یکپارچه	فضای کاری مرکزی و مرکز برنامه‌ها	یافتن ابزارها، سازماندهی آثار، و پیوند دادن کارهای دسکتاپ و آنلاین
VP Online و برنامه‌های وب تخصصی	مدل‌سازی، برنامه‌ریزی، طراحی و همکاری مبتنی بر مرورگر	دسترش تیم، ایجاد سبک، بازبینی ذینفعان و جریان‌های کاری متمرکز بر ابر
OpenDocs	مستندسازی و مدیریت دانش مبتنی بر وب	مشخصات، راهنماها، توصیفات معماری، مستندات فرآیند و کتابچه‌های پروژه
خط لوله	پل ارتباطی بین مدل‌های دسکتاپ و مستندات آنلاین	ارسال نمودارها یا محتوای مدل از دسکتاپ به جریان‌های کاری مستندسازی
ابزارهای هوش مصنوعی	کمک‌رسانی با زبان طبیعی و تهیه پیش‌نویس‌های اولیه سریع	تولید نمودارها، تحلیل مدل‌ها، ایجاد محتوای ساختاریافته و تسریع کاوش

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

۳. مفاهیم اصلی

فضای کاری یکپارچه

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

از فضای کاری برای:

• یافتن پروژه‌های موجود

• باز کردن دارایی‌های مرتبط با دسکتاپ

• اجرای برنامه‌های تخصصی

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

• پیمایش بین آثار فنی و تجاری

• سازماندهی کار بر اساس پروژه، تیم یا حوزه موضوعی

درایو یکپارچه

درایو یکپارچه، نمای متمرکز و درایو-مانند از آثار را فراهم می‌کند. بسته به محصول، نسخه و پیکربندی، این موارد ممکن است شامل موارد زیر باشند:

• پروژه‌های دسکتاپ

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

• اسناد

• نقشه‌های راه

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

• وایرفریم‌ها

• مدل‌های معماری

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

• بوم‌های تحلیل کسب‌وکار

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

مزیت اصلی آن قابلیت کشف‌پذیری است: کاربران می‌توانند کارهای مرتبط را پیدا کنند بدون اینکه نیاز باشد به خاطر بسپارند کدام برنامه به‌طور خاص آن را ایجاد کرده است.

راه‌انداز برنامه‌ها

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

• UML و SysML

• BPMN و تحلیل فرآیند

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

• تحلیل نیازمندی‌ها و موارد استفاده

• طراحی پایگاه داده و API

• مدیریت چابک

• مدیریت پروژه

• تجربه کاربری و وایرفریم

• استراتژی کسب‌وکار

• مستندسازی

• مدل‌سازی با کمک هوش مصنوعی

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

منوی ایجاد یکپارچه

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

• نمودار

• سند

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

• بوم تحلیل کسب‌وکار

• طراحی تجربه کاربری

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

• مدل یا اثر بصری با کمک هوش مصنوعی

یک تمرین مفید این است که با نتیجه‌ای که نیاز دارید—مانند «مستندسازی یک فرآیند» یا «برنامه‌ریزی برای یک انتشار»—شروع کنید، نه با نام یک محصول خاص Visual Paradigm.

۴. شروع کار

گام ۱: آماده‌سازی حساب کاربری و نصب

قبل از شروع، اطمینان حاصل کنید که موارد زیر را دارید:

• یک حساب کاربری Visual Paradigm

• دسترسی به پلتفرم یکپارچه

• نصب Visual Paradigm Desktop در صورتی که به مدل‌سازی روی دسکتاپ نیاز دارید

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

• دسترسی به پروژه یا فضای کاری مربوطه

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

گام ۲: باز کردن پلتفرم

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

1. از طریق یک مرورگر وب:به محیط وب Visual Paradigm وارد شوید و فضای کاری پلتفرم یکپارچه را باز کنید.

2. از طریق Visual Paradigm Desktop:از گزینه‌های مربوط به پلتفرم یکپارچه یا تیم در برنامه دسکتاپ استفاده کنید.

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

گام ۳: شناسایی محیط کاری شما

پس از باز کردن فضای کاری، با موارد زیر آشنا شوید:

• مرورگر پروژه یا اثر

• درایو یکپارچه

• راه‌انداز برنامه‌ها

• منوی ایجاد

• جستجو و فیلتر کردن

• فایل‌ها یا پروژه‌های اخیر

• ویژگی‌های تیم و همکاری

• بخش‌های مستندات و خط لوله

• تنظیمات حساب کاربری، مجوزها و فضای کاری

گام ۴: ایجاد یک اثر آزمایشی

با یک پروژه آزمایشی کوچک شروع کنید، به‌جای وارد کردن یک مخزن سازمانی کامل در همان ابتدا. برای مثال:

1. یک نمودار مورد استفاده ساده ایجاد کنید.

2. یک سند پروژه کوتاه اضافه کنید.

3. یک برنامه وظایف یا نقشه راه اولیه ایجاد کنید.

4. هر اثر را در درایو یکپارچه پیدا کنید.

5. اثرها را از طریق مرورگر و دسکتاپ، در صورت امکان، باز کنید.

6. تأیید کنید که کاربران مورد نظر بتوانند به آن‌ها دسترسی داشته باشند.

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

۵. انتخاب ابزار مناسب

یک قانون انتخاب مفید عبارت است از:

• از Visual Paradigm Desktop زمانی که خود مدل، دارایی اصلی مهندسی است.

• از برنامه‌های آنلاین زمانی که دسترسی‌پذیری، همکاری سریع یا مشارکت ذینفعان اهمیت بیشتری دارد.

• از OpenDocs زمانی که خروجی نهایی یک توضیح، مشخصات، راهنما یا پایگاه دانش است.

• از Pipeline زمانی که نمودارهای حاصل از دسکتاپ باید بخشی از مستندات آنلاین شوند.

• از برنامه‌های چابک و مدیریت پروژه زمانی که کار شامل آیتم‌های بک‌لاگ، برنامه‌های زمانی، مسئولیت‌ها، نقشه‌های راه یا هماهنگی تحویل است.

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

۶. حوزه‌های اصلی عملکردی

مدل‌سازی بصری

این پلتفرم دسترسی به ابزارهای مدل‌سازی برای توصیف نرم‌افزارها، سیستم‌ها، فرآیندها و ساختارها را فراهم می‌کند.

حوزه‌های رایج مدل‌سازی عبارتند از:

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

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

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

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

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

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

• نمودارهای فرآیند BPMN

• مدل‌های SysML

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

• نقشه‌های ذهنی

• نمودارهای موجودیت-رابطه

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

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

برنامه‌های تحلیل کسب‌وکار به تیم‌ها کمک می‌کنند تا از یک مسئله کسب‌وکاری به الزامات و تصمیمات ساختاریافته برسند.

کاربردهای بالقوه عبارتند از:

• تحلیل ذینفعان

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

• تحلیل متنی

• جداول تصمیم‌گیری

• قوانین کسب‌وکار

• ترسیم سفر مشتری

• تحلیل فرآیند

• تحلیل ریشه‌ای

• چارچوب‌های استراتژیک SWOT و مرتبط

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

• توصیف مشکلات

• تحلیل سناریو

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

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

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

قابلیت‌های رایج عبارتند از:

• مدل‌سازی ArchiMate

• برنامه‌ریزی متمرکز بر TOGAF

• نقشه‌برداری قابلیت‌ها

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

• معماری وضعیت موجود و وضعیت هدف

• تحلیل شکاف

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

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

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

یک گردش کار معماری مؤثر عبارت است از:

1. ثبت وضعیت موجود.

2. تعریف محرک‌های استراتژیک و محدودیت‌ها.

3. مدل‌سازی وضعیت هدف.

4. شناسایی شکاف‌ها.

5. تعریف معماری‌های گذار.

6. تهیه نقشه راه مهاجرت.

7. مستندسازی تصمیمات و مالکیت‌ها.

برنامه‌ریزی چابک

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

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

• نقشه‌برداری داستان‌ها

• بازبینی بک‌لاگ

• برآورد همبستگی

• برنامه‌ریزی اسپرینت

• تخته‌های اسکرام

• بازنگری‌ها

• برنامه‌ریزی نمایش

• اولویت‌بندی

• برنامه‌ریزی توسعه

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

مدیریت پروژه

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

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

• نقشه‌های راه

• ساختارهای تجزیه کار

• نمودارهای PERT

• ماتریس‌های RACI

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

• برنامه‌های پیاده‌سازی

• ابزارهای مدیریت ذینفعان

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

• راهنمای چرخه عمر پروژه

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

تجربه کاربری و نمونه‌سازی

قابلیت‌های تجربه کاربری می‌توانند از موارد زیر پشتیبانی کنند:

• وایرفریم‌ها

• جریان‌های صفحه

• داستان‌نماها

• چیدمان‌های وب و موبایل

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

• نقشه‌های سفر مشتری

• تصویرسازی جریان کاربر

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

مهندسی پایگاه داده و کد

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

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

• نمودارهای ER

• تولید پایگاه داده

• اسکریپت‌های وصله پایگاه داده

• مهندسی معکوس

• مدل‌سازی ORM

• تولید کد

• مهندسی معکوس کد به مدل

• طراحی API REST

• خروجی‌های مرتبط با OpenAPI یا Swagger

• یکپارچه‌سازی با محیط‌های توسعه

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

۷. جریان کاری از دسکتاپ به پلتفرم

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

1. یک مدل دقیق UML، BPMN، SysML، ArchiMate یا پایگاه داده را در Visual Paradigm Desktop ایجاد کنید.

2. پروژه را در مخزن محلی یا متصل مناسب ذخیره کنید.

3. پلتفرم یکپارچه را از طریق دسکتاپ یا از طریق یک مرورگر باز کنید.

4. پروژه مرتبط یا اثر مربوطه را پیدا کنید.

5. از ابزارهای آنلاین برای ایجاد مستندات، نقشه‌های راه، برنامه‌ها، ارائه‌ها یا مواد مرتبط با ذینفعان استفاده کنید.

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

این کار عمق مدل‌سازی و قابلیت آفلاین دسکتاپ را با دسترسی‌پذیری ابزارهای مبتنی بر مرورگر ترکیب می‌کند.

تقسیم کار پیشنهادی

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

• مدل مرجع

• روابط پیچیده

• اعتبارسنجی مدل

• مخازن بزرگ

• مهندسی کد و پایگاه داده

• کارهای معماری دقیق

• ویرایش آفلاین

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

• به اشتراک‌گذاری

• مستندسازی

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

• نمودارسازی سبک

• بازبینی ذینفعان

• دسترسی از طریق مرورگر

• همکاری بین‌وظیفه‌ای

۸. مستندسازی با OpenDocs و Pipeline

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

فرآیند پایه

1. طراحی یا به‌روزرسانی نمودارها در Visual Paradigm Desktop.

2. ارسال یا نمایان کردن محتوای مرتبط مدل از طریق گردش کاری Pipeline.

3. باز کردن یک سند OpenDocs.

4. درج نمودارها و محتوای مرتبط مدل.

5. افزودن توضیحات، فرضیات، الزامات، تصمیمات و پیوندها.

6. انتشار یا اشتراک‌گذاری سند با ذینفعان.

7. به‌روزرسانی سند با تغییرات مدل.

این روش کاربردی‌تر از صادرات تصاویر ثابت است، زیرا سند می‌تواند زمینه‌ی پیرامون نمودارها را حفظ کرده و آن‌ها را به توضیحات نوشتاری متصل کند. خروجی‌های معمول شامل موارد زیر هستند:

• مشخصات الزامات نرم‌افزار

• توصیف‌های معماری

• مشخصات فنی

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

• دستورالعمل‌های پروژه

• مواد آموزشی

• گزارش‌های ذینفعان

• پایگاه‌های دانش

این پلتفرم به‌طور خاص OpenDocs و Pipeline را به‌عنوان پل ارتباطی بین نمودارهای دسکتاپ و مستندات مبتنی بر وب معرفی می‌کند.

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

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

1. هدف و دامنه

2. ذینفعان

3. زمینه کسب‌وکار

4. نیازمندی‌های عملکردی

5. نیازمندی‌های غیرعملکردی

6. نمودار زمینه سیستم

7. مدل مورد استفاده

8. نمودارهای فرآیند یا تعامل

9. معماری منطقی

10. نمای استقرار یا فناوری

11. مدل داده

12. تصمیمات و فرضیات

13. ریسک‌ها و پرسش‌های باز

14. اطلاعات ردیابی

15. تاریخچه تغییرات

۹. گردش‌کارهای کمکی هوش مصنوعی

پلتفرم یکپارچه شامل ابزارهای متمرکز بر هوش مصنوعی است که می‌توانند در تولید نمودارها یا محتوای ساختاریافته از توصیفات زبان طبیعی کمک کنند. برای مثال، یک کاربر ممکن است یک تعامل سیستم را توصیف کند و از یک ابزار نمودارسازی هوش مصنوعی برای تولید پیش‌نویس اولیه استفاده کند که سپس در Visual Paradigm Desktop اصلاح و بهبود یابد.

گردش‌کار پیشنهادی هوش مصنوعی

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

2. یک پیش‌نویس اولیه تولید کنید.

3. هر موجودیت، رابطه، بازیگر و توالی را بازرسی کنید.

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

5. از قراردادهای نام‌گذاری و مدل‌سازی پروژه استفاده کنید.

6. نتیجه را در برابر نیازمندی‌ها اعتبارسنجی کنید.

7. مدل اصلاح‌شده را به مخزن مناسب پروژه منتقل کنید.

8. فرضیات مهم و تصمیمات انسانی را مستند کنید.

الگوی دستورالعمل خوب

شامل:

• حوزه سیستم یا کسب‌وکار

• نمادگذاری مدل‌سازی

• بازیگران یا اجزای اصلی

• تعاملات مورد نیاز

• محدودیت‌های مهم

• سطح جزئیات

• قراردادهای نام‌گذاری

• هر فرمت خروجی مورد انتظار

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

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

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

۱۰. سازماندهی مؤثر پروژه‌ها

یک فضای کاری یکپارچه تنها زمانی مفید است که آثار به‌طور منسجم سازماندهی شده باشند.

ساختار پیشنهادی پروژه

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

• ۰۱-استراتژی

• ۰۲-نیازمندی‌ها

• ۰۳-فرآیندهای کسب‌وکار

• ۰۴-معماری

• ۰۵-تجربه کاربری و نمونه‌های اولیه

• ۰۶-داده‌ها و APIها

• ۰۷-پیاده‌سازی

• ۰۸-آزمون

• ۰۹-مدیریت پروژه

• ۱۰-مستندسازی

• ۹۹-بایگانی

قراردادهای نام‌گذاری

از نام‌هایی استفاده کنید که هدف و دامنه را منتقل کنند:

• Customer-Order-Context

• Checkout-Sequence-v2

• Payments-API-OpenAPI

• Target-Architecture-2030

• Release-Plan-Q3

• Order-Cancellation-Requirements

از نام‌هایی مانند اجتناب کنید: نمودار جدید, آزمون، یا نسخه نهایی نهایی.

قراردادهای نسخه‌بندی

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

• v1.0

• v1.1

• پیش‌نویس

• تأیید شده

• خط مبنا

• وضعیت فعلی

• وضعیت هدف

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

داده‌های متاداده اثر

برای اثرهای مهم، موارد زیر را ثبت کنید:

• مالک

• وضعیت

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

• حوزه کسب‌وکار

• نیازمندی مرتبط

• انتشار مرتبط

• وضعیت تأیید

• سطح محرمانگی

• سیستم مبدأ

• تاریخ آخرین تأیید

۱۱. همکاری و حکمرانی

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

تعریف مالکیت

تخصیص مالک برای:

• مدل‌های معماری

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

• نیازمندی‌ها

• بک‌لاگ محصول

• برنامه‌های پروژه

• مستندات فنی

• مدل‌های API و پایگاه داده

تعریف وضعیت‌های بازبینی

یک چرخه حیات ساده ممکن است به این صورت باشد:

1. پیش‌نویس

2. در حال بازبینی

3. تأیید شده

4. نقطه مبنا

5. منسوخ شده

6. بایگانی شده

تعریف مسئولیت‌های بازبینی

مشخص کنید:

• چه کسی می‌تواند ویرایش کند

• چه کسی می‌تواند نظر دهد

• چه کسی تأیید می‌کند

• تغییرات چگونه درخواست می‌شوند

• تعارضات چگونه حل می‌شوند

• سندهای منسوخ چگونه بایگانی می‌شوند

سیاست منبع حقیقت را ایجاد کنید

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

• مدل دقیق UML: پروژه دسکتاپ

• توضیحات ذینفعان: OpenDocs

• بک‌لاگ اسپرینت: برنامه برنامه‌ریزی چابک

• قرارداد API: مدل یا مخزن API

• برنامه انتشار: فضای کاری مدیریت پروژه

این از تبدیل شدن چندین سند به منابع متناقض حقیقت جلوگیری می‌کند.

۱۲. مثال گردش کار از ابتدا تا انتها

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

کشف

1. مسئله کسب‌وکار را ثبت کنید.

2. ذینفعان را شناسایی کنید.

3. اهداف و محدودیت‌ها را تعریف کنید.

4. یک بوم سفر مشتری یا تحلیل مسئله ایجاد کنید.

نیازمندی‌ها

1. مورد استفاده و داستان‌های کاربر را بنویسید.

2. معیارهای پذیرش را اصلاح کنید.

3. قوانین کسب‌وکار را شناسایی کنید.

4. برای سیاست‌های پیچیده جداول تصمیم‌گیری ایجاد کنید.

طراحی

1. یک نمودار زمینه سیستم بسازید.

2. نمودارهای کلاس، فعالیت و توالی ایجاد کنید.

3. مرزهای پایگاه داده و API را مدل‌سازی کنید.

4. برای تعاملات مهم کاربر، وایرفریم ایجاد کنید.

برنامه‌ریزی

1. داستان‌ها را به انتشارها نگاشت کنید.

2. یک بک‌لاگ ایجاد کنید.

3. کار را برآورد و اولویت‌بندی کنید.

4. یک برنامه و نقشه راه توسعه بسازید.

5. مسئولیت‌ها را با استفاده از ماتریس RACI تخصیص دهید.

مستندسازی

1. نمودارهای کلیدی دسکتاپ را از طریق خط لوله ارسال کنید.

2. یک مشخصات OpenDocs بسازید.

3. توضیحات، تصمیمات و پیوندها را اضافه کنید.

4. نسخه‌ای قابل‌فهم برای ذینفعان منتشر کنید.

پیاده‌سازی و نگهداری

1. تولید یا بهبود آثار فنی.

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

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

4. هنگام تغییر معماری، مستندات را به‌روزرسانی کنید.

5. نسخه‌های منسوخ را بایگانی کنید.

۱۳. مشکلات رایج و راه‌حل‌های عملی

یک برنامه در دسترس نیست

دلایل احتمالی عبارتند از:

• محدودیت‌های مجوز

• نگهداری یا اشتراک منقضی شده

• مجوزهای فضای کاری

• پیکربندی منطقه‌ای یا حساب کاربری

• در دسترس بودن برنامه # راهنمای جامع پلتفرم یکپارچه Visual Paradigm

پلتفرم یکپارچه Visual Paradigm یک فضای کاری متمرکز است که Visual Paradigm Desktop را با برنامه‌های مبتنی بر مرورگر برای مدل‌سازی بصری، مستندسازی، تحلیل کسب‌وکار، معماری سازمانی، برنامه‌ریزی چابک، مدیریت پروژه، طراحی پایگاه داده، مهندسی نرم‌افزار و کارهای کمک‌شده با هوش مصنوعی به هم متصل می‌کند. این پلتفرم را بهتر است به‌عنوان لایه‌ای برای یکپارچه‌سازی و دسترسی در نظر گرفت، نه جایگزینی برای Visual Paradigm Desktop یا VP Online.

۱. پلتفرم یکپارچه چه کاری انجام می‌دهد

این پلتفرم سه مشکل رایج را حل می‌کند:

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

• آثار پراکنده:نمودارها، اسناد، نقشه‌های راه، بک‌لاگ‌ها و دارایی‌های طراحی ممکن است یافتن آن‌ها دشوار باشد.

• جداسازی دسکتاپ و ابر:برنامه‌های دسکتاپ برای مدل‌سازی دقیق و کار آفلاین قدرتمند هستند، در حالی که برنامه‌های وب برای دسترسی و همکاری مناسب‌ترند.

پلتفرم یکپارچه این قابلیت‌ها را از طریق موارد زیر گرد هم می‌آورد:

• یک فضای کاری متمرکز

• نمایی شبیه به درایو برای پروژه‌ها و آثار

• دسترسی به پروژه‌های Visual Paradigm Desktop

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

• منوی ایجاد یکپارچه

• ابزارهای مستندسازی و همکاری آنلاین

• ارتباطات بین نمودارها، اسناد و آثار برنامه‌ریزی پروژه

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

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

۲. نحوه ادغام آن در اکوسیستم ویژوال پارادایم

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

اجزا	هدف اصلی	مناسب‌ترین برای
ویژوال پارادایم دسکتاپ	محیط مدل‌سازی و مهندسی عمیق	UML، BPMN، SysML، ArchiMate، مدل‌سازی پایگاه داده، مهندسی کد، الزامات و کار آفلاین
پلتفرم یکپارچه	فضای کاری مرکزی و مرکز برنامه‌ها	یافتن ابزارها، سازماندهی آثار، اتصال کارهای دسکتاپ و آنلاین
VP Online و برنامه‌های وب تخصصی	مدل‌سازی، برنامه‌ریزی، طراحی و همکاری مبتنی بر مرورگر	دسترسی تیم، ایجاد سبک، بازبینی ذینفعان و جریان‌های کاری مبتنی بر ابر
OpenDocs	مدیریت مستندات و دانش مبتنی بر وب	مشخصات، راهنماها، توصیفات معماری، مستندات فرآیند و راهنمای پروژه
خط لوله	پل بین مدل‌های دسکتاپ و مستندات آنلاین	ارسال نمودارها یا محتوای مدل از دسکتاپ به جریان‌های کاری مستندسازی
ابزارهای هوش مصنوعی	کمک‌های مبتنی بر زبان طبیعی و پیش‌نویس‌های سریع اولیه	تولید نمودارها، تحلیل مدل‌ها، ایجاد محتوای ساختاریافته و تسریع کاوش

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

۳. مفاهیم اصلی

فضای کاری یکپارچه

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

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

• پروژه‌های موجود را پیدا کنید

• دارایی‌های مرتبط با دسکتاپ را باز کنید

• برنامه‌های تخصصی را راه‌اندازی کنید

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

• بین آثار فنی و تجاری جابجا شوید

• کارها را بر اساس پروژه، تیم یا حوزه موضوعی سازماندهی کنید

درایو یکپارچه

درایو یکپارچه، نمای متمرکز و شبیه به درایو از آثار را ارائه می‌دهد. بسته به محصول، نسخه و پیکربندی، این موارد ممکن است شامل موارد زیر باشند:

• پروژه‌های دسکتاپ

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

• اسناد

• نقشه‌های راه

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

• وایرفریم‌ها

• مدل‌های معماری

• آثار مدیریت پروژه

• بوم‌های تحلیل کسب‌وکار

• محتوای تولیدشده توسط هوش مصنوعی

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

راه‌انداز برنامه‌ها

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

• UML و SysML

• BPMN و تحلیل فرآیند

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

• تحلیل نیازمندی‌ها و موارد استفاده

• طراحی پایگاه داده و API

• مدیریت چابک

• مدیریت پروژه

• تجربه کاربری و وایرفریمینگ

• استراتژی کسب‌وکار

• مستندسازی

• مدل‌سازی با کمک هوش مصنوعی

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

منوی یکپارچه ایجاد

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

• نمودار

• سند

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

• بوم تحلیل کسب‌وکار

• طراحی تجربه کاربری

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

• مدل یا اثر بصری با کمک هوش مصنوعی

یک روش مفید این است که با نتیجه مورد نیاز خود شروع کنید—مانند «مستندسازی یک فرآیند» یا «برنامه‌ریزی برای یک انتشار»—به جای شروع با نام یک محصول خاص Visual Paradigm.

۴. شروع کار

گام ۱: آماده‌سازی حساب و نصب شما

قبل از شروع، اطمینان حاصل کنید که موارد زیر را دارید:

• یک حساب Visual Paradigm

• دسترسی به پلتفرم یکپارچه

• نصب Visual Paradigm Desktop در صورت نیاز به مدل‌سازی دسکتاپ

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

• دسترسی به پروژه یا فضای کاری مربوطه

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

گام ۲: باز کردن پلتفرم

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

1. از طریق یک مرورگر وب:به محیط وب Visual Paradigm وارد شوید و فضای کاری پلتفرم یکپارچه را باز کنید.

2. از طریق Visual Paradigm Desktop:از گزینه مربوط به پلتفرم یکپارچه یا تیم در برنامه دسکتاپ استفاده کنید.

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

گام ۳: شناسایی محیط کاری خود

پس از باز کردن فضای کاری، با موارد زیر آشنا شوید:

• مرورگر پروژه یا اشیاء

• درایو یکپارچه

• راه‌انداز برنامه‌ها

• منوی ایجاد

• جستجو و فیلتر کردن

• فایل‌ها یا پروژه‌های اخیر

• ویژگی‌های تیم و همکاری

• حوزه‌های مستندات و خط لوله

• تنظیمات حساب، مجوزها و فضای کاری

گام ۴: ایجاد یک شیء آزمایشی

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

1. یک نمودار مورد استفاده ساده ایجاد کنید.

2. یک سند پروژه کوتاه اضافه کنید.

3. یک برنامه وظایف یا نقشه راه اولیه ایجاد کنید.

4. هر شیء را در درایو یکپارچه پیدا کنید.

5. شیءها را از مرورگر و دسکتاپ (در صورت امکان) باز کنید.

6. تأیید کنید که کاربران موردنظر بتوانند به آن‌ها دسترسی داشته باشند.

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

۵. انتخاب ابزار مناسب

یک قانون انتخاب مفید این است:

• از Visual Paradigm Desktop استفاده کنید زمانی که خود مدل، دارایی اصلی مهندسی است.

• از برنامه‌های آنلاین استفاده کنید زمانی که دسترسی‌پذیری، همکاری سریع یا مشارکت ذینفعان اهمیت بیشتری دارد.

• از OpenDocs وقتی خروجی نهایی یک توضیح، مشخصات، راهنما یا پایگاه دانش باشد.

• استفاده از خط لوله وقتی نمودارهای موجود در دسکتاپ باید بخشی از مستندات آنلاین شوند.

• استفاده از برنامه‌های چابک و مدیریت پروژه وقتی کار شامل آیتم‌های بک‌لاگ، برنامه‌های زمانی، مسئولیت‌ها، نقشه‌های راه یا هماهنگی تحویل باشد.

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

۶. حوزه‌های اصلی عملکردی

مدل‌سازی بصری

این پلتفرم دسترسی به ابزارهای مدل‌سازی برای توصیف نرم‌افزارها، سیستم‌ها، فرآیندها و ساختارها را فراهم می‌کند.

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

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

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

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

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

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

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

• نمودارهای فرآیند BPMN

• مدل‌های SysML

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

• نقشه‌های ذهنی

• نمودارهای موجودیت-رابطه

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

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

برنامه‌های تحلیل کسب‌وکار به تیم‌ها کمک می‌کنند تا از یک مسئله کسب‌وکار به نیازمندی‌ها و تصمیمات ساختاریافته حرکت کنند.

کاربردهای بالقوه شامل موارد زیر هستند:

• تحلیل ذینفعان

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

• تحلیل متنی

• جدول‌های تصمیم‌گیری

• قوانین کسب‌وکار

• نقشه‌برداری سفر مشتری

• تحلیل فرآیند

• تحلیل ریشه‌ای

• چارچوب‌های استراتژیک SWOT و مرتبط با آن

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

• توصیف مشکلات

• تحلیل سناریو

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

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

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

قابلیت‌های رایج شامل موارد زیر است:

• مدل‌سازی ArchiMate

• برنامه‌ریزی متمرکز بر TOGAF

• نقشه‌برداری قابلیت‌ها

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

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

• تحلیل شکاف

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

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

• ارتباطات مبتنی بر دیدگاه

یک جریان کاری معماری مؤثر به شرح زیر است:

1. وضعیت فعلی را ثبت کنید.

2. راننده‌های استراتژیک و محدودیت‌ها را تعریف کنید.

3. وضعیت هدف را مدل‌سازی کنید.

4. شکاف‌ها را شناسایی کنید.

5. تعریف معماری‌های گذار.

6. طراحی نقشه راه مهاجرت.

7. مستندسازی تصمیمات و مالکیت.

برنامه‌ریزی چابک

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

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

• نقشه‌برداری داستان‌ها

• بازبینی و اصلاح بک‌لاگ

• برآورد بر اساس شباهت

• برنامه‌ریزی اسپرینت

• تخته‌های اسکرام

• جلسات بازنگری

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

• اولویت‌بندی

• برنامه‌ریزی توسعه

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

مدیریت پروژه

کاربردهای مدیریت پروژه ممکن است شامل موارد زیر باشند:

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

• نقشه‌های راه

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

• نمودارهای PERT

• ماتریس‌های RACI

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

• برنامه‌های پیاده‌سازی

• ابزارهای مدیریت ذینفعان

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

• راهنمای چرخه عمر پروژه

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

تجربه کاربری و نمونه‌سازی

قابلیت‌های UX می‌توانند از موارد زیر پشتیبانی کنند:

• وایرفریم‌ها

• جریان‌های صفحه

• استوری‌بورد

• چیدمان‌های وب و موبایل

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

• نقشه‌های سفر مشتری

• تصویرسازی جریان کاربر

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

مهندسی پایگاه داده و کد

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

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

• نمودارهای ER

• تولید پایگاه داده

• اسکریپت‌های وصله پایگاه داده

• مهندسی معکوس

• مدل‌سازی ORM

• تولید کد

• مهندسی معکوس کد به مدل

• طراحی REST API

• خروجی‌های مرتبط با OpenAPI یا Swagger

• یکپارچه‌سازی با محیط‌های توسعه

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

۷. گردش کار از دسکتاپ به پلتفرم

یک گردش کار ترکیبی رایج به این صورت است:

1. یک مدل دقیق UML، BPMN، SysML، ArchiMate یا پایگاه داده را در Visual Paradigm Desktop ایجاد کنید.

2. پروژه را در مخزن محلی یا متصل مناسب ذخیره کنید.

3. پلتفرم یکپارچه را از دسکتاپ یا از طریق یک مرورگر باز کنید.

4. پروژه مرتبط یا اثر مربوطه را پیدا کنید.

5. از ابزارهای آنلاین برای ایجاد مستندات، نقشه‌های راه، برنامه‌ها، ارائه‌ها یا مواد مرتبط با ذینفعان استفاده کنید.

6. مواد حاصل را با افرادی که از Desktop استفاده نمی‌کنند، به اشتراک بگذارید.

این کار عمق مدل‌سازی و قابلیت آفلاین Desktop را با دسترسی‌پذیری ابزارهای مبتنی بر مرورگر ترکیب می‌کند.

تقسیم کار پیشنهادی

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

• مدل مرجع

• روابط پیچیده

• اعتبارسنجی مدل

• مخازن بزرگ

• مهندسی کد و پایگاه داده

• کارهای معماری دقیق

• ویرایش آفلاین

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

• به اشتراک‌گذاری

• مستندسازی

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

• نمودارسازی سبک

• بازبینی ذینفعان

• دسترسی از طریق مرورگر

• همکاری بین‌تیمی

۸. مستندسازی با OpenDocs و Pipeline

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

فرآیند پایه

1. نمودارها را در Visual Paradigm Desktop بسازید یا به‌روزرسانی کنید.

2. محتوای مرتبط مدل را از طریق گردش کاری Pipeline ارسال یا نمایان کنید.

3. یک سند OpenDocs را باز کنید.

4. نمودارها و محتوای مرتبط مدل را درج کنید.

5. توضیحات، فرضیات، الزامات، تصمیمات و پیوندها را اضافه کنید.

6. سند را با ذینفعان منتشر یا به اشتراک بگذارید.

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

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

• مشخصات الزامات نرم‌افزار

• توصیف‌های معماری

• مشخصات فنی

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

• دستورالعمل‌های پروژه

• مواد آموزشی

• گزارش‌های ذینفعان

• پایگاه‌های دانش

این پلتفرم به‌طور خاص OpenDocs و Pipeline را به‌عنوان پلی میان نمودارهای دسکتاپ و مستندات مبتنی بر وب معرفی می‌کند.

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

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

1. هدف و دامنه

2. ذینفعان

3. زمینه کسب‌وکار

4. الزامات عملکردی

5. الزامات غیرعملکردی

6. نمودار زمینه سیستم

7. مدل مورد استفاده

8. نمودارهای فرآیند یا تعامل

9. معماری منطقی

10. نمای استقرار یا فناوری

11. مدل داده

12. تصمیمات و فرضیات

13. ریسک‌ها و پرسش‌های باز

14. اطلاعات ردیابی

15. تاریخچه تغییرات

۹. گردش‌کارهای کمک‌شده با هوش مصنوعی

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

گردش‌کار پیشنهادی هوش مصنوعی

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

2. یک پیش‌نویس اولیه ایجاد کنید.

3. هر موجودیت، رابطه، بازیگر و توالی را بازرسی کنید.

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

5. از قراردادهای نام‌گذاری و مدل‌سازی پروژه استفاده کنید.

6. نتیجه را در برابر الزامات اعتبارسنجی کنید.

7. مدل اصلاح‌شده را به مخزن مناسب پروژه منتقل کنید.

8. فرضیات مهم و تصمیمات انسانی را مستند کنید.

الگوی دستورالعمل خوب

شامل:

• حوزه سیستم یا کسب‌وکار

• نمادگذاری مدل‌سازی

• بازیگران یا اجزای اصلی

• تعاملات مورد نیاز

• محدودیت‌های مهم

• سطح جزئیات

• قراردادهای نام‌گذاری

• هر فرمت خروجی مورد انتظار

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

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

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

۱۰. سازماندهی مؤثر پروژه‌ها

یک محیط کار یکپارچه تنها زمانی مفید است که آثار به‌طور منسجم سازماندهی شده باشند.

ساختار پیشنهادی پروژه

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

• ۰۱-استراتژی

• ۰۲-الزامات

• ۰۳-فرآیندهای کسب‌وکار

• ۰۴-معماری

• ۰۵-تجربه کاربری و نمونه‌های اولیه

• ۰۶-داده‌ها و APIها

• ۰۷-پیاده‌سازی

• ۰۸-آزمون

• ۰۹-مدیریت پروژه

• ۱۰-مستندسازی

• ۹۹-بایگانی

قراردادهای نام‌گذاری

از نام‌هایی استفاده کنید که هدف و دامنه را منتقل کنند:

• زمینه-سفارش-مشتری

• ترتیب-پرداخت-و۲

• API-پرداخت‌ها-OpenAPI

• معماری-هدف-۲۰۳۰

• برنامه-انتشار-سه‌ماهه-۳

• نیازمندی‌های-لغو-سفارش

از نام‌هایی مانند پرهیز کنید:نمودار-جدید, آزمون، یا نسخه-نهایی-نهایی.

قراردادهای نسخه‌بندی

اطلاعات نسخه را جایی که ارزش افزوده دارد، شامل کنید:

• v1.0

• v1.1

• پیش‌نویس

• تأییدشده

• خط‌مبنای

• وضعیت-جاری

• وضعیت-هدف

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

اطلاعات متاداده‌ی اثر

برای اثرهای مهم، موارد زیر را ثبت کنید:

• مالک

• وضعیت

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

• حوزه کسب‌وکار

• نیازمندی مرتبط

• نسخه‌ی مرتبط

• وضعیت تأیید

• سطح محرمانگی

• سیستم مبدأ

• تاریخ آخرین تأیید

۱۱. همکاری و حکمرانی

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

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

برای موارد زیر مالک تعیین کنید:

• مدل‌های معماری

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

• نیازمندی‌ها

• بک‌لاگ محصول

• برنامه‌های پروژه

• مستندات فنی

• مدل‌های API و پایگاه داده

وضعیت‌های بازبینی را تعریف کنید

یک چرخه‌ی حیات ساده ممکن است به این صورت باشد:

1. پیش‌نویس

2. در حال بازبینی

3. تأییدشده

4. نقطه‌ی پایه

5. جایگزین‌شده

6. بایگانی‌شده

تعریف مسئولیت‌های بازبینی

مشخص کنید:

• چه کسی می‌تواند ویرایش کند

• چه کسی می‌تواند نظر دهد

• چه کسی تأیید می‌کند

• تغییرات چگونه درخواست می‌شوند

• تعارضات چگونه حل می‌شوند

• سندهای منسوخ چگونه بایگانی می‌شوند

سیاست منبع حقیقت را ایجاد کنید

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

• مدل دقیق UML: پروژه دسکتاپ

• توضیحات ذینفعان: OpenDocs

• بکلاگ اسپرینت: برنامه برنامه‌ریزی چابک

• قرارداد API: مدل API یا مخزن

• برنامه انتشار: فضای کاری مدیریت پروژه

این از تبدیل شدن چندین سند به منابع حقیقت متناقض جلوگیری می‌کند.

۱۲. مثال گردش کار از ابتدا تا انتها

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

کشف

1. مسئله کسب‌وکار را ثبت کنید.

2. ذینفعان را شناسایی کنید.

3. اهداف و محدودیت‌ها را تعریف کنید.

4. یک بوم سفر مشتری یا تحلیل مسئله ایجاد کنید.

نیازمندی‌ها

1. مورد استفاده و داستان‌های کاربر را بنویسید.

2. معیارهای پذیرش را اصلاح کنید.

3. قوانین کسب‌وکار را شناسایی کنید.

4. برای سیاست‌های پیچیده جداول تصمیم‌گیری ایجاد کنید.

طراحی

1. یک نمودار زمینه سیستم ایجاد کنید.

2. نمودارهای کلاس، فعالیت و توالی ایجاد کنید.

3. مرزهای پایگاه داده و API را مدل‌سازی کنید.

4. برای تعاملات مهم کاربر، وایرفریم ایجاد کنید.

برنامه‌ریزی

1. داستان‌ها را به انتشارها نگاشت کنید.

2. یک بک‌لاگ ایجاد کنید.

3. کارها را برآورد و اولویت‌بندی کنید.

4. یک برنامه و نقشه راه توسعه ایجاد کنید.

5. مسئولیت‌ها را با استفاده از ماتریس RACI تخصیص دهید.

مستندسازی

1. نمودارهای کلیدی دسکتاپ را از طریق خط لوله ارسال کنید.

2. یک مشخصات OpenDocs ایجاد کنید.

3. توضیحات، تصمیمات و پیوندها را اضافه کنید.

4. نسخه‌ای قابل‌خواندن برای ذینفعان منتشر کنید.

پیاده‌سازی و نگهداری

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

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

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

4. هنگام تغییر معماری، مستندات را به‌روزرسانی کنید.

5. نسخه‌های منسوخ را بایگانی کنید.

۱۳. عیب‌یابی

یک برنامه در دسترس نیست

دلایل احتمالی عبارتند از:

• محدودیت‌های مجوز

• نگهداری یا اشتراک منقضی شده

• مجوزهای فضای کاری

• پیکربندی حساب

• در دسترس بودن برنامه تنها از طریق یک نسخه متفاوت

• نیاز ویژگی به یک مجوز آنلاین جداگانه

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

یک پروژه گم شده است

بررسی کنید:

1. آیا از حساب کاربری صحیح استفاده می‌کنید.

2. آیا در فضای کاری یا تیم صحیح قرار دارید.

3. آیا پروژه متعلق به کاربر یا سازمان دیگری است.

4. آیا فیلترها یا تنظیمات جستجو، این اثر را پنهان کرده‌اند.

5. آیا پروژه به صورت محلی در نسخه دسکتاپ ذخیره شده است، نه به صورت آنلاین.

6. آیا مجوز دسترسی به آن را دارید.

محتوای دسکتاپ و آنلاین ناسازگار به نظر می‌رسند

از یک سیاست منبع حقیقت شفاف استفاده کنید. تعیین کنید که آیا نسخه دسکتاپ، فضای کاری آنلاین، یک اثر مستندسازی، یا یک مخزن خارجی مرجع است. سپس:

1. آخرین نسخه تأیید شده را شناسایی کنید.

2. از ویرایش همزمان همان اثر در چندین مکان خودداری کنید.

3. تغییرات را از طریق جریان کاری پشتیبانی‌شده همگام‌سازی یا منتقل کنید.

4. تغییرات مهم را در تاریخچه سند یا پروژه ثبت کنید.

5. پس از به‌روزرسانی‌ها، نمودارها و اسناد پیوندی را مجدداً اعتبارسنجی کنید.

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

بررسی کنید:

• اندازه صفحه

• مرزهای نمودار

• در دسترس بودن فونت‌ها

• عناصر پنهان

• فرمت صادرات

• وضوح تصویر

• آیا نمودار به عنوان یک تصویر یا یک اثر آگاه از مدل صادر می‌شود

برای مستندات رسمی، در صورت امکان از جریان کاری پیوندی به مدل یا یکپارچه‌سازی بومی ترجیح دهید، به جای صادرات مکرر تصاویر ثابت.

اعضای تیم نمی‌توانند ویرایش کنند

بررسی کنید:

• عضویت در فضای کاری

• مجوزهای اثر

• پوشش مجوز

• اینکه آیا اثر قفل شده است یا پایه‌گذاری شده است

• اینکه آیا کاربر دسترسی فقط مشاهده دارد

• اینکه آیا پروژه متعلق به تیم دیگری است

۱۴. شیوه‌های عملکرد و قابلیت نگهداری

برای پروژه‌های بزرگ:

• مدل‌ها را بر اساس حوزه یا زیرسیستم تقسیم‌بندی کنید.

• از قرار دادن هر نمودار در یک پروژه عظیم خودداری کنید.

• از دیدگاه‌ها استفاده کنید تا تنها بخش‌های مرتبط یک مدل را نمایش دهید.

• نمودارهای منسوخ را بایگانی کنید.

• مستندات را از پیش‌نویس‌های اکتشافی جدا نگه دارید.

• اثرهای تکراری غیرضروری را به حداقل برسانید.

• قبل از رشد پروژه، یک استاندارد نام‌گذاری ایجاد کنید.

• پیوندها و مراجع را به‌طور دوره‌ای بازبینی کنید.

• خروجی‌های تولیدشده را با مدل‌های مبدأ همگام نگه دارید.

• برای ارتباط با ذینفعان از نمودارهای کوچک‌تر و برای کارهای مهندسی از نمودارهای دقیق استفاده کنید.

برای مستندات:

• از الگوهای قابل استفاده مجدد ترجیح دهید.

• از اصطلاحات یکسان استفاده کنید.

• نیازمندی‌ها را به نمودارها و کارهای پیاده‌سازی پیوند دهید.

• فرضیات را به‌صورت صریح ثبت کنید.

• مالکیت و تاریخ‌های بازبینی را شامل کنید.

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

۱۵. طرح پیشنهادی پذیرش

فاز ۱: پایلوت

یک پروژه متواضعانه انتخاب کنید و از موارد زیر استفاده کنید:

• یک مدل دسکتاپ

• یک سند OpenDocs

• یک اثر برنامه‌ریزی

• یک قرارداد نام‌گذاری مشترک

• یک فرآیند بازبینی

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

فاز ۲: استانداردسازی

ایجاد:

• الگوهای پروژه

• قراردادهای نام‌گذاری

• ساختار پوشه‌ها

• الگوهای مستندات

• چک‌لیست‌های بازبینی مدل

• قوانین مجوزها

• راهنماهای منبع حقیقت

فاز ۳: یکپارچه‌سازی

اتصال:

• نیازمندی‌ها به مدل‌ها

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

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

• APIها به پیاده‌سازی

• نمای معماری به نقشه‌های راه

• ریسک‌ها به برنامه‌های پروژه

فاز ۴: حاکمیت

معرفی:

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

• خط‌مبنای‌ها

• کنترل تغییرات

• مالکیت

• پاک‌سازی دوره‌ای مخزن

• آموزش برای اعضای جدید تیم

• شاخص‌های استفاده و تازگی آثار

۱۶. چک‌لیست عملی

راه‌اندازی اولیه

• تأیید دسترسی حساب کاربری.

• تأیید پوشش مجوز و اشتراک.

• در صورت نیاز، Visual Paradigm Desktop را نصب کنید.

• فضای کاری مناسب را ایجاد کنید یا به آن بپیوندید.

• Unified Drive را آزمایش کنید.

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

راه‌اندازی پروژه

• ساختار پروژه را تعریف کنید.

• قراردادهای نام‌گذاری را ایجاد کنید.

• مالکان آثار را شناسایی کنید.

• منبع حقیقت را برای هر نوع اثر انتخاب کنید.

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

• وضعیت‌های بازبینی را تعریف کنید.

مدل‌سازی

• نمادگذاری مناسب را انتخاب کنید.

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

• دیدگاه‌های مفهومی، منطقی و فیزیکی را جدا کنید.

• روابط مدل را اعتبارسنجی کنید.

• مدل‌ها را به الزامات و اسناد پیوند دهید.

همکاری

• کاربران مناسب را دعوت کنید.

• دسترسی‌های مناسب را اختصاص دهید.

• مسئولیت‌های بازبینی و تأیید را تعریف کنید.

• دسترسی را با اعضای نماینده تیم آزمایش کنید.

• فرآیند مدیریت تغییر را ایجاد کنید.

نگهداری

• آثار منسوخ را بازبینی کنید.

• نسخه‌های جایگزین‌شده را بایگانی کنید.

• پس از تغییرات عمده در مدل، مستندات را به‌روزرسانی کنید.

• پیوندها و ارجاعات را مجدداً بررسی کنید.

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

۱۷. خلاصه بهترین روش‌ها

موثرترین راه برای استفاده از پلتفرم یکپارچه، برخورد با آن به‌عنوان محیطی متصل برای مدل‌سازی، مستندسازی، برنامه‌ریزی و همکاری است:

1. از نسخه دسکتاپ برای مدل‌های مهندسی دقیق و معتبر استفاده کنید.

2. از پلتفرم یکپارچه برای سازماندهی و دسترسی به کارها استفاده کنید.

3. از برنامه‌های آنلاین برای همکاری مبتنی بر مرورگر و وظایف تخصصی استفاده کنید.

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

5. از Pipeline برای اتصال مدل‌های دسکتاپ به مستندات استفاده کنید.

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

7. قوانین نام‌گذاری، مالکیت، مجوزها، وضعیت‌های بازبینی و منبع حقیقت را از همان ابتدا تعیین کنید.

8. نمودارها، مستندات، الزامات و برنامه‌ها را در طول چرخه عمر پروژه متصل نگه دارید.

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

منابع

1. تسلط بر پلتفرم یکپارچه Visual Paradigm: راهنمای نهایی: راهنمای جامع که شامل Unified Drive، ابزارهای هوش مصنوعی و هم‌افزایی دسکتوب-وب برای یک اکوسیستم یکپارچه می‌شود.
2. شکستن سیلوها: یک راهنمای جامع: بررسی می‌کند که چگونه پلتفرم ابزارها و جریان‌های کاری پراکنده را به یک منبع حقیقت واحد و یکپارچه متصل می‌کند.
3. پلتفرم یکپارچه: مرکز فرماندهی برای کارهای بصری: سناریوهای عملی برای مستندسازی از طریق Pipeline، تولید نمودار با هوش مصنوعی و مهندسی معکوس کد به UML.
4. از سیلوها تا سمفونی: یک بررسی عملی: بررسی عملی که چهار رکن اکوسیستم و گذار از صادرات ثابت به آثار پویا را مورد بحث قرار می‌دهد.
5. از UML به چابک: تحول در مدل‌سازی سازمانی: نقش پلتفرم را در پل‌زنی بین مدل‌سازی سنتی UML با همکاری چابک و شتاب‌دهی هوش مصنوعی تحلیل می‌کند.

This post is also available in Deutsch, English, Español, Français, Bahasa Indonesia, 日本語, Polski, Portuguese, Ру́сский, Việt Nam, 简体中文 and 繁體中文.