آرشیل؛ ابزار مستندسازی معماری نرم‌افزار با AI
هوش مصنوعیخلاصهٔ کامل‌تر
C4 (یعنی یه مدل چهار سطحی برای دیدن معماری نرم‌افزار از زوایای مختلف) این‌طوریه: سطح ۱ کل سیستم رو با کاربرا و سیستم‌های بیرونی نشون می‌ده، سطح ۲ (Container) بخش‌های فنی بزرگ مثل اپلیکیشن‌ها و دیتابیس‌ها رو، سطح ۳ (Component) ساختار داخلی یه بخش رو، و سطح ۴ (Code) نحوه پیاده‌سازی یه کامپوننت رو تو کد نشون می‌ده.
آرشیل دقیقاً همین چهار سطح رو به‌صورت دیاگرام‌های تعاملی می‌سازه، اونم بدون این‌که مجبور باشید همه‌چیزو دستی بکشید. کافیه مخزن گیت پروژه‌تون رو وصل کنید تا هوش مصنوعی آرشیل خودش کد رو بخونه و معماری رو کشف کنه. علاوه بر این، می‌تونید از ADR (یعنی سوابق تصمیم‌های معماری که تیم‌ها معمولاً تو مخزن نگه می‌دارن) یا حتی مستندات مارک‌داون قبلی هم برای وارد کردن اطلاعات استفاده کنید.
نکته مهم آرشیل اینه که همه‌چیزو با یه زبان YAML به اسم Architecture as Code ذخیره می‌کنه، یعنی دیاگرام‌ها مثل کد تو مخزن نسخه‌بندی می‌شن و با تغییر پروژه از حالت بی‌ربط و قدیمی در نمیان. برای ساختن ارتباط بین بخش‌های مختلف هم کافیه از لبه یه عنصر به عنصر دیگه بکشید و نوع رابطه (مثل Uses یا Depends on) رو مشخص کنید.
آرشیل امکان دعوت اعضای تیم و کار مشترک روی پروژه‌ها رو هم داره، و از طریق سرور MCP (یعنی یه پروتکل استاندارد برای وصل کردن ابزارهای هوش مصنوعی به سیستم‌های دیگه) و یه REST API معمولی هم میشه بهش وصل شد و دیتاشو تو ابزارهای دیگه استفاده کرد.
نکات کلیدی:
- آرشیل معماری نرم‌افزار رو بر پایه مدل چهار سطحی C4 مستند می‌کنه
- با وصل شدن به مخزن گیت، هوش مصنوعی خودش معماری رو از روی کد کشف می‌کنه
- مستندات به فرمت YAML (Architecture as Code) ذخیره و نسخه‌بندی می‌شن
- امکان وارد کردن ADR و مستندات مارک‌داون قبلی هم وجود داره
- اتصال از طریق سرور MCP و REST API برای یکپارچه‌سازی با ابزارهای دیگه
