مقالات / نیازمندی‌ها و مشخصات

نیازمندی‌ها و مشخصات: چگونه تصمیم‌ها و تغییرات را سازمان‌دهی کنیم

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

علاوه بر سند، چه چیزهایی را مدیریت می‌کنید؟

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

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

هدف، نیازمندی، مشخصات و معیارهای پذیرش را به هم متصل کنید

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

هدف: کاهش رونویسی دستی

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

الزام: خروجی گرفتن از سوابق موردنیاز برای گزارش

یکی از کارکنان باید سوابق ماه انتخاب‌شده را در محدوده‌ای که مجوز دسترسی به آن را دارد، صادر کند.

مشخصات: فایل و رفتار آن را تعریف کنید

درباره ستون‌ها، ترتیب، کدگذاری متن، قالب تاریخ، رفتار در صورت خالی بودن نتایج و خطاها توافق کنید. این‌ها انتخاب‌های مربوط به این مثال هستند، نه تنظیمات پیش‌فرض همگانی.

معیارهای پذیرش: نتیجه را قابل بررسی کنید

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

از هدف تا معیارهای پذیرش باز کردن ReqSpec AI

برای هر مورد یک ایده قابل‌بررسی بنویسید

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

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

قبل: “اجازه خروجی گرفتن CSV را بده.”

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

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

مجموعه کوچکی از فیلدها برای شروع

ID، عنوان و توضیحات

به هر مورد یک ID ثابت مانند REQ-001 بدهید. موضوع، شرط و نتیجه موردانتظار را مشخص کنید. ID ثابت به افراد کمک می‌کند حتی پس از تغییر عنوان نیز به آن مورد ارجاع دهند.

دلیل و منبع

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

اولویت و محدوده

آنچه برای این نسخه لازم است را از مواردی که می‌توانند منتظر بمانند جدا کنید. دلیل اولویت را توضیح دهید؛ به همه موارد بالاترین اولویت را ندهید.

مسئول و وضعیت تصمیم

ثبت کنید چه کسی مورد را روشن خواهد کرد و آیا در وضعیت پیش‌نویس، در حال بررسی یا توافق‌شده است. مسئول پیاده‌سازی و تأییدکننده ممکن است افراد متفاوتی باشند.

معیارهای پذیرش و اطلاعات مرتبط

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

مثال: سه نیازمندی برای خروجی ماهانه CSV

آنچه در ادامه می‌آید یک مثال توضیحی است. نام فیلدها و رفتار آن‌ها باید متناسب با محصولی که می‌سازید مورد توافق قرار گیرد؛ این مثال مشخصات کامل تمام قابلیت‌های خروجی گرفتن نیست.

REQ-001: سوابق ماه انتخاب‌شده

نمونه مشخصات: ماه انتخاب‌شده را در منطقه زمانی کاری توافق‌شده در نظر بگیرید و ID، تاریخ ثبت و عنوان را با کدگذاری UTF-8 و به‌ترتیب تاریخ و سپس ID صادر کنید. نمونه معیار پذیرش: سه رکورد منطبق باید یک ردیف سرستون و دقیقاً همان سه ردیف داده را ایجاد کنند، بدون هیچ رکوردی از ماه‌های دیگر.

REQ-002: هیچ رکورد منطبقی وجود ندارد

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

REQ-003: دسترسی پیش از خروجی گرفتن بررسی می‌شود

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

از سلسله‌مراتب استفاده کنید بدون آنکه تصمیم‌های فردی گم شوند

موارد را بر اساس هدف یا قابلیت گروه‌بندی کنید و سپس شرایط جزئی را زیر گروه مربوط قرار دهید. برای مثال: گزارش‌دهی → خروجی ماهانه CSV → رکوردهای هدف / قالب فایل / نتایج خالی / دسترسی. پیش‌زمینه و پرسش‌های بی‌پاسخ را به‌جای ترکیب در یک نیازمندی طولانی، در یادداشت‌ها بیاورید.

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

توافق، پیاده‌سازی و راستی‌آزمایی را جدا نگه دارید

«توافق‌شده» یعنی محتوا برای محدوده موردنظر پذیرفته شده است. این به معنای پیاده‌سازی قابلیت نیست. «پیاده‌سازی‌شده» نیز نشان نمی‌دهد که معیارهای پذیرش توافق‌شده برآورده شده‌اند یا قابلیت منتشر شده است. حتی اگر از فهرست وضعیت ساده‌ای استفاده می‌کنید، این تفاوت‌ها را روشن نگه دارید.

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

پیش از توافق‌شده تلقی کردن یک تغییر، آن و تأثیرش را ثبت کنید

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

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

مکانی انتخاب کنید که بتوانید آن را به‌روز نگه دارید

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

برای پیش‌نویس از AI استفاده کنید و سپس تصمیم‌ها را تأیید کنید

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

در ReqSpec AI می‌توانید نیازمندی‌ها و مشخصات را به‌صورت سلسله‌مراتبی سازمان‌دهی کنید و از AI برای کمک به ایجاد، ویرایش و بررسی آن‌ها بهره ببرید. پرسشی مشخص مانند «کدام شرایط مربوط به نتایج خالی هنوز تعریف نشده‌اند؟» بپرسید. هر پاسخ را پیشنهادی بدانید که باید با محتوای ثبت‌شده بررسی شود، نه مدرکی برای تأیید یا کامل بودن.

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

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

مطالعه بیشتر

NASA: چگونه یک نیازمندی خوب بنویسیم

NASA: مدیریت نیازمندی‌ها

الزامات و مشخصات فنی را با ReqSpec AI سازمان‌دهی کنید

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