سؤال مصاحبه

نوشتن مشخصاتی که قضاوت را به جای درستش می‌سپارد

Write a specification that leaves judgment where it belongs

  • سطح ۳: ارشد
  • طراحی
  • ۱۲ دقیقه

می‌خواهید وظیفه‌ای (task) را به یک ایجنت (agent) کدنویسی یا مهندسی تازه‌کار بسپارید تا مرحله‌ی عیب‌یابیِ فقط‌خواندنی (read-only) را به ابزار مدیریت حوادث اضافه کند. دفعه‌ی قبل، شرح وظیفه دو جمله بود و نتیجه‌اش حدس و گمان‌های بی‌پایه درباره‌ی سیستم. بار قبل از آن هم شرح وظیفه طرحی دوازده‌صفحه‌ای بود و نتیجه‌اش کپی مو‌به‌موی اشتباهی که در همان طرح وجود داشت. این بار چطور می‌نویسیدش؟

اول خودتان جواب بدهید، بعد پاسخ را باز کنید.

پاسخ کوتاه

من یک قرارداد اجرایی با شش جنبه می‌نویسم: نتیجه، پایاها (invariants) که باید همیشه برقرار بمانند، مثال‌های ملموس، ناهداف (non-goals)، شیوه‌نامه‌ی تصمیم‌گیری، و اثباتِ (proof) الزامی پیش از اتمام کار. هر تصمیم با توجه به پیامد و برگشت‌پذیری‌اش با یکی از سه وضعیت «قفل‌شده»، «محدودشده» یا «واگذارشده» مشخص می‌شود. مرزِ نوشتن در محیط عملیاتی (production) قفل می‌شود، سقف زمانیِ منبع داده محدود می‌شود، و ساختار محلی و نام‌گذاری‌ها با شرط ارائه‌ی توضیح واگذار می‌شوند.

پاسخ کامل

دو نقطه‌ی افراط مخرب

مشخصات بسیار ناچیز و ناکافی سازنده را وادار به حدس زدن سیستم می‌کند. مشخصات بیش‌از‌حد پرجزئیات هم سازنده را به کپی‌کننده‌ی طرحی تبدیل می‌کند که شاید از همان ابتدا نادرست باشد. میانه‌ی کارآمد این است که پایاها و شواهد (evidence) را تثبیت کنید و انتخاب‌های برگشت‌پذیر را باز بگذارید.

شش جنبه‌ی مشخصات

جنبه هدف
نتیجه دستاورد قابل‌مشاهده
پایاها شرایطی که همیشه باید درست بمانند
مثال‌ها نمونه‌های ملموس که نیت (intent) را نشان می‌دهند
ناهداف رفتارهای مجاور و مرتبط که عمداً کنار گذاشته شده‌اند
شیوه‌نامه‌ی تصمیم‌گیری مشخص کردن اینکه کدام انتخاب‌ها قفل‌شده، محدودشده یا واگذارشده هستند
اثبات شواهد الزامی پیش از اتمام کار

سه حالت تصمیم‌گیری

  • قفل‌شده (Locked): سازنده نباید دست به انتخاب بزند. سازگاری عمومی، حدود اختیارات، امنیت، هزینه‌های برگشت‌ناپذیر و تعهدات محصول.
  • محدودشده (Bounded): سازنده می‌تواند درون محدودیت‌های صریح تصمیم بگیرد. سقف منابع جست‌وجو، تعداد تلاش مجدد، وابستگی‌های مجاز، و خانواده‌ای شناخته‌شده از رابط‌ها.
  • واگذارشده (Delegated): تصمیم با سازنده است و باید آن را توضیح دهد. ساختار محلی، نام‌گذاری‌ها، بازآفرینی‌های (refactors) برگشت‌پذیر، و جزئیات پیاده‌سازی.

اینکه بگوییم «پیاده‌سازی می‌تواند از هر منبع فقط‌خواندنی استفاده کند که در محدوده‌ی سقف زمانی پاسخ دهد» مبهم نیست؛ بلکه تصمیمی واگذارشده است که هم مرز دارد و هم نیازمند اثبات است.

مثال‌ها نیت را خلاصه و فشرده می‌کنند

عبارت‌هایی مثل «مفید»، «پایدار» و «آماده‌ی محیط عملیاتی» قابل اجرا نیستند. مجموعه‌ی کوچکی از موارد عادی، حالت‌های مرزی، شکست‌ها و موارد ممنوعه، هدف مشترکی پیش روی سازنده و مدل اعتبارسنج (verifier) می‌گذارد. مثال‌ها جای پایاها را نمی‌گیرند؛ یک نمونه‌ی موفق نمی‌تواند قاعده‌ای امنیتی و جهان‌شمول را اثبات کند.

اثبات باید متناسب با ادعا باشد

تست واحد (unit test) قراردادِ یک تابع محلی را اثبات می‌کند. تست سیم (wire test) صحت سریال‌سازی و بستر انتقال (transport) را اثبات می‌کند. سناریوی مرورگر (browser journey) مسیر رابط کاربری را اثبات می‌کند. مجموعه‌ی بازپخش (replay set) رفتار را روی نمونه‌های شاخص اثبات می‌کند. لاگ بازرسی (audit log) اثبات می‌کند که مرزهای اختیارات حفظ شده‌اند. من اثبات در لایه‌ای پایین‌تر را برای ادعایی در لایه‌ی بالاتر نمی‌پذیرم.

سؤال‌های تکمیلی مصاحبه‌گر
  • سطح 3: کسی تصمیم مربوط به نوشتن در محیط عملیاتی را از حالت قفل‌شده به واگذارشده تغییر می‌دهد. اسکیما (schema) هم خطایی نمی‌گیرد. چرا این کار باز هم اشتباه است؟ پاسخ مورد انتظار: اسکیما فقط ساختار را بررسی می‌کند، نه ریسک محصول را؛ نوشتن در محیط عملیاتی برگشت‌ناپذیر است و حدود اختیارات را تغییر می‌دهد، بنابراین باید قفل‌شده بماند.
  • سطح 3: در شرح وظیفه، تعداد تلاش مجدد روی عددی ثابت تنظیم شده است. این تصمیم قفل‌شده است یا محدودشده؟ پاسخ مورد انتظار: محدودشده حالت بهتری است؛ سازنده می‌تواند درون یک بازه‌ی مشخص انتخاب کند و خود آن بازه دلیل انتخاب را هم منتقل می‌کند.
  • سطح 4: سه دستورالعمل پیاده‌سازی رفتاری یکسان را توصیف می‌کنند. آن‌ها را با چه چیزی جایگزین می‌کنید؟ پاسخ مورد انتظار: با یک پایا و دو مثال، تا نیت اصلی با تغییر شیوه‌ی پیاده‌سازی هم حفظ شود.
  • سطح 4: چرا باید دلیل پشت هر تصمیمِ قفل‌شده را ثبت کنیم؟ پاسخ مورد انتظار: برای اینکه اعضای بعدی تیم بتوانند با تغییر شواهد، آن تصمیم را بدون نیاز به باستان‌شناسی در پیام‌های قدیمی بازبینی کنند.
جواب‌های اشتباهی که مصاحبه‌گرها زیاد می‌شنوند
  • «همه‌ی مراحل را مو‌به‌مو مشخص کنید تا هیچ مشکلی پیش نیاید.» نوشتن دستورالعمل‌های گام‌به‌گام فقط اشتباهات نویسنده را کپی می‌کند و مجالی برای قضاوتی که مانع آن اشتباهات می‌شود باقی نمی‌گذارد.
  • «هدف را بگویید و به سازنده اعتماد کنید.» بدون پایاها و اثبات، سازنده دست به حدس زدن سیستم می‌زند و خروجی کار هم قابل اعتبارسنجی نخواهد بود.
  • «پاس شدن تست واحد اثبات می‌کند که قابلیت به درستی کار می‌کند.» تست واحد فقط یک قرارداد محلی را اثبات می‌کند، نه مسیر رابط کاربری یا مرز اختیارات را.

کجای دوره آموزش داده می‌شود

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