
در معماری نرمافزار، تصمیمهای مهم معمولاً ساده و بدون هزینه نیستند. انتخاب یک معماری، تکنولوژی، دیتابیس، پروتکل ارتباطی یا الگوی طراحی تقریباً همیشه با مجموعهای از Trade-offها همراه است. به همین دلیل، یکی از ابزارهای شناختهشده برای مستندسازی این تصمیمها، Architecture Decision Record یا ADR است.
اما همانطور که Gregor Hohpe، از چهرههای شناختهشده حوزه معماری نرمافزار، اشاره میکند، یکی از مشکلات رایج در استفاده از Frameworkها و Templateها این است که افراد بهمرور آنها را به شکلی متفاوت از هدف اصلیشان استفاده میکنند. ADR نیز از این قاعده مستثنی نیست.
بسیاری از تیمها هنگام نوشتن ADR بیش از حد روی کلمهی Decision تمرکز میکنند. تصمیم از قبل گرفته شده و سپس بخشهایی مانند Context، Alternatives و Consequences به شکلی نوشته میشوند که همان تصمیم را تأیید کنند.
در چنین شرایطی، ADR دیگر ابزار تصمیمگیری نیست؛ بلکه تبدیل به سندی برای توجیه یک تصمیم از پیش گرفتهشده میشود.
هدف اصلی ADR صرفاً پاسخ دادن به این سؤال نیست:
«چه تصمیمی گرفتیم؟»
بلکه باید بتواند توضیح دهد:
«با توجه به شرایط، محدودیتها، گزینههای موجود و Trade-offها، چرا این تصمیم منطقیترین انتخاب بود؟»
این تفاوت بسیار مهم است.
یک ADR خوب باید به تیم کمک کند ابتدا مسئله را بهتر درک کند، گزینههای واقعی را بررسی کند و پیامدهای هر انتخاب را بسنجد؛ سپس تصمیم نهایی را ثبت کند.
فرآیند صحیح تقریباً باید چنین باشد:
Context → Constraints → Alternatives → Trade-offs → Decision → Consequences
اما در بسیاری از ADRهای ضعیف، فرآیند عملاً برعکس است:
Decision → پیدا کردن دلایل برای توجیه Decision
یکی از نشانههایی که Hohpe به آن اشاره میکند، جهتدار بودن بخش Context است.
برای مثال:
«راهکارهای Open Source بهتر هستند زیرا...»
این جمله در ظاهر بخشی از Context است، اما در عمل یک Preference را بهعنوان واقعیت وارد مسئله کرده و نتیجه را از قبل تحت تأثیر قرار داده است.
Context باید تا حد ممکن واقعیتهای مسئله را بیان کند:
محدودیتهای فنی
نیازهای کسبوکار
الزامات امنیتی
SLA
حجم داده
مهارت تیم
هزینه
محدودیت زمانی
زیرساخت موجود
وظیفه Context این نیست که یک گزینه را بهتر از بقیه نشان دهد؛ بلکه باید شرایطی را فراهم کند که بتوان گزینهها را منصفانه مقایسه کرد.
یکی دیگر از مشکلات رایج، ارائه گزینههایی است که عملاً Alternative محسوب نمیشوند.
برای مثال:
«میتوانیم این قابلیت را پیادهسازی نکنیم، اما در این صورت قابلیت موردنظر را نخواهیم داشت.»
چنین گزینهای ارزش تحلیلی چندانی ایجاد نمیکند.
اگر قرار است درباره انتخاب یک Message Broker تصمیم بگیریم، Alternatives ممکن است واقعاً شامل گزینههایی مانند:
RabbitMQ
Apache Kafka
Azure Service Bus
استفاده از ارتباط مستقیم HTTP بدون Broker
باشند.
هرکدام نیز باید بر اساس معیارهای مشخصی مانند Reliability، Throughput، Operational Complexity، Cost و Team Expertise بررسی شوند.
وجود Alternativeهای معتبر باعث میشود تصمیم معماری قابل دفاع باشد، نه به این دلیل که «معمار آن را ترجیح داده»، بلکه به این دلیل که گزینهها واقعاً ارزیابی شدهاند.
هیچ تصمیم معماری مهمی بدون هزینه نیست.
ممکن است یک تصمیم باعث افزایش Complexity شود، Dependency جدیدی وارد سیستم کند، هزینه عملیاتی را بالا ببرد یا مانع Vendor Independence شود.
نوشتن جملهای مانند:
«این راهکار پیچیدگی بیشتری ایجاد میکند، اما این پیچیدگی را میپذیریم.»
کافی نیست.
اگر یک Consequence منفی شناخته شده است، ADR بهتر است توضیح دهد که این ریسک چگونه مدیریت خواهد شد.
برای مثال:
استفاده از Kafka باعث افزایش Operational Complexity خواهد شد. برای کاهش این ریسک، Deployment از طریق Managed Kafka انجام میشود و Monitoring و Alerting استاندارد برای Cluster تعریف خواهد شد.
در این حالت ADR صرفاً مشکل را ثبت نکرده، بلکه نشان داده است تیم نسبت به پیامد تصمیم آگاه بوده و برای مدیریت آن برنامه دارد.
یکی از مهمترین نکاتی که از دیدگاه Gregor Hohpe میتوان برداشت کرد این است که ارزش اصلی ADR در ثبت خود Decision نیست.
چند ماه بعد معمولاً مشاهده کد یا زیرساخت به ما میگوید چه تکنولوژی انتخاب شده است.
اما چیزی که از کد قابل فهم نیست این است که:
چه گزینههای دیگری بررسی شدند؟
چرا رد شدند؟
چه محدودیتهایی در آن زمان وجود داشت؟
چه Trade-offهایی پذیرفته شدند؟
اگر شرایط تغییر کند، آیا تصمیم هنوز معتبر است؟
این اطلاعات همان چیزی هستند که ADR باید برای آینده حفظ کند.
Architecture Decision Record نباید به یک Template اداری تبدیل شود که بعد از تصمیمگیری تکمیل میکنیم.
ADR زمانی ارزشمند است که بخشی از فرآیند تصمیمگیری معماری باشد.
یک ADR خوب تلاش نمیکند ثابت کند تصمیم ما درست بوده است؛ بلکه نشان میدهد که تیم، مسئله را درک کرده، گزینههای معتبر را بررسی کرده، Trade-offها را شناخته و سپس آگاهانه تصمیم گرفته است.
شاید بتوان پیام اصلی Gregor Hohpe را در یک جمله خلاصه کرد:
ADR نباید سند دفاع از یک تصمیم باشد؛ باید سند تفکر پشت آن تصمیم باشد.
منبع و الهام:
Gregor Hohpe — بحث درباره استفاده صحیح از Architecture Decision Records و خطر تبدیل ADR به ابزاری برای توجیه تصمیمهای از پیش گرفتهشده، منتشرشده در LinkedIn.