Architecture Decision Record

Active theme: Light

← اسناد

چه کسی می‌تواند ADR ایجاد کند؟

حوزه‌هایی مانند افراد مشخص، نقش‌های مشخص، تیم‌های مشخص یا بخش‌های مشخص را در نظر بگیرید؛ همچنین در نظر بگیرید که آیا افراد، نقش‌ها، تیم‌ها یا بخش‌هایی هستند که می‌توانند سفارش یک ADR را بدهند، یعنی ADR‌ای را درخواست کنند که شخص دیگری آن را تألیف خواهد کرد.

نمونه پاسخ: هر فردی در سازمان ما که صفحهٔ README رکورد تصمیم معماری را خوانده باشد می‌تواند یک ADR پیشنهاد دهد، یعنی می‌تواند نوشتن آن را آغاز کند و آن را با تیم به اشتراک بگذارد.

چه چیزی ایجاد یک ADR را توجیه می‌کند؟

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

نمونه پاسخ: وقتی می‌خواهیم توسعه‌دهندگان آینده «چرایی» کارهایی را که انجام می‌دهیم بفهمند، ADR ایجاد می‌کنیم.

چه چیزی ایجاد نکردن ADR را توجیه می‌کند؟

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

نمونه پاسخ: وقتی دامنهٔ تصمیم، زمان، خطر و هزینهٔ آن محدود است، یا پیش‌تر در جای دیگری پوشش داده شده است، ADR را رد می‌کنیم.

چرخهٔ عمر یک ADR چیست؟

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

نمونه پاسخ: می‌خواهیم یک ADR پنج مرحلهٔ چرخهٔ عمر داشته باشد: آغاز ← پژوهش ← ارزیابی ← اجرا ← نگهداری ← بازنشستگی.

معیارهای مراحل چرخهٔ عمر یک ADR چیست؟

حوزه‌هایی مانند معیارهای پذیرش یک ADR را در نظر بگیرید، یعنی از کجا می‌دانید که برای پیشرفت از یک مرحلهٔ چرخهٔ عمر به مرحلهٔ بعدی به‌اندازهٔ کافی خوب است؟ آیا مسئله به‌روشنی بیان شده است؟ آیا گزینه‌های جایگزین بررسی شده‌اند؟ آیا مصالحه‌ها به‌اندازهٔ کافی درک و مستند شده‌اند؟ آیا همهٔ زمینهٔ مرتبط فراهم است؟ آیا همهٔ ذی‌نفعان مرتبط درگیر هستند؟ آیا همهٔ بازخوردها اعمال شده‌اند؟

نمونه پاسخ: می‌خواهیم وقتی تیم فعال 1) پژوهش خود را تکمیل کرده، 2) ارزیابی خود را تکمیل کرده، 3) پیشنهاد ADR را با درخواست نظر و مهلت یک هفته برای ذی‌نفعان منتشر کرده، 4) همهٔ نظرات ذی‌نفعان اعمال و پاسخ داده شده باشد، ذی‌نفعان دربارهٔ ADR رأی بدهند.

چه نقش‌ها و مسئولیت‌هایی با یک ADR تعامل دارند؟

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

نمونه پاسخ: می‌خواهیم هر ADR همیشه یک فرد تماس اصلی، یک فرد تماس فرعی و یک تیم پاسخگو داشته باشد؛ این‌ها مسئول ارتباطات، انتشار، نگهداری، بازبینی دوره‌ای دست‌کم سالی یک‌بار و در صورت نیاز بازنشستگی نهایی هستند.

حکمرانی چگونه با یک ADR تعامل دارد؟

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

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

چه اصولی با یک ADR تعامل دارند؟

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

نمونه پاسخ: ما از اصول رهبری گرایش به عمل، مخالفت و تعهد (disagree-and-commit)، کافی بودن برآوردهای 70 درصدی برای تصمیم‌های به‌آسانی برگشت‌پذیر و به‌آسانی قابل‌ایزوله‌شدن، و شیوه‌های کار عمومی به‌جز اطلاعات محرمانه طبق توافق‌نامهٔ محرمانگی سازمان خود استفاده می‌کنیم.