داستان «مستند تحلیل» (Software Requirement Specification – SRS یا Feature Spec) دقیقاً مرز بین باگ و کار جدید است:
۱. مستند تحلیل کجای کار قرار دارد؟
در فرآیند مهندسی نرمافزار، مسیر پروژه به این صورت است:
- پروپوزال فنی :یک نگاه کلان تجاری-فنی است (کلیات سیستم، تکنولوژی ها، جدول فیچرها، هزینه و فازبندی تقریبی).
- عقد قرارداد:بر مبنای همین پروپوزال، قرارداد امضا میشود.
- فاز ۱ پروژه (هفته ۱ تا ۳ – فاز تحلیل و UI/UX):اینجا مستند تحلیل و نیازمندیها (SRS) به همراه فایل فیگما تولید و تکمیل میشود.
- توسعه، تست، تحویل و شروع گارانتی:در روز تحویل، ملاک بررسی این است که سیستم با آن مستند تطابق دارد یا خیر.
- بنابراین: مستند تحلیل بعد از امضای قرارداد و در فاز اول پروژه تدوین و به امضای طرفین میرسد.
۲. اصلاً چرا به مستند تحلیل نیاز است و چه فایدهای برای شما دارد؟
بدون مستند تحلیل، کلمه «باگ» یک مفهوم سلیقهای میشود و کارفرما هر ایده جدیدی که به ذهنش برسد را «باگ» مینامد!
- مثال:کارفرما میگوید: «چرا وقتی کاربر عکس میسازه دکمه اشتراکگذاری مستقیم در اینستاگرام نداره؟ این باگه، درستش کنید!»
- پاسخ شما با وجود مستند تحلیل:«در مستند تحلیل مصوب فاز ۱ (صفحه ۱۲)، خروجی صرفاً دانلود فایل PNG و کپی لینک تعریف شده و اشتراک گذاری در شبکه های اجتماعی وجود ندارد. این مورد باگ نیست، Feature جدید است و با متمم قرارداد انجام میشود.»
۳. مستند تحلیل دقیقاً شامل چه چیزهایی است؟
این مستند معمولاً ۱۰ تا ۳۰ صفحه است و شامل موارد زیر میشود:
- لیست دقیق تمام فیچرها با جزییات رفتار (Use Cases): مثلاً دقیقاً در فرم لاگین OTP چه خطاهایی برگردانده شود، طول کد چقدر باشد و تایمر چقدر باشد.
- قوانین بیزینس و محاسبات مالی (Business Logic): فرمول دقیق کسر اعتبار، شرایط Hold و Refund.
- لیست Provider ها و فیلدهای ورودی/خروجی هرکدام: مدلهای دقیق OpenAI یا FLUX که ساپورت میشوند.
- طرحهای تایید شده Figma: تمام صفحات اپلیکیشن و وب سایت.
۴. برای پروپوزال، این بند را چطور بنویسید که شفاف و حرفهای باشد؟
برای اینکه کارفرما بداند این مستند کی آماده میشود، متن بند را به این شکل ویرایش کنید:
بند. دوره گارانتی و تضمین عملکرد (Warranty Period)
- مدت زمان: ۲ ماه پس از تحویل نهایی و استقرار نسخه عملیاتی
- هزینه: رایگان (پوششدادهشده در مبلغ قرارداد توسعه)
- مبنای تعهدات: رفع کلیه خطا ها و نواقص عملکردی در کدهای اختصاصی پروژه، منطبق بر مستند نیازمندی ها و سناریو های تایید شده در فاز تحلیل (فاز ۱ پروژه) و طرح های نهایی Figma.
دیدگاه کاربران