اكتب وصفاً جيداً قبل أول سطر كود
Writing a Good Spec
كيف تحوّل فكرتك إلى وثيقة متطلبات قصيرة (PRD) يفهمها الوكيل: المستخدمون، الوظائف، القيود، ومعايير القبول.
ستتعلم في هذا الدرس
- كتابة وثيقة متطلبات قصيرة
- تحديد ما هو خارج النطاق
- صياغة معايير القبول
لماذا الوصف أهم من الكود؟
الوكيل لا يعرف ما في رأسك. كل غموض في الطلب يتحول إلى افتراض قد لا يعجبك. وثيقة قصيرة في البداية توفر عليك جولات تصحيح كثيرة.
عناصر الوصف الجيد
- الهدف في جملة واحدة: ماذا يفعل التطبيق ولمن.
- المستخدمون وأدوارهم (زائر، مستخدم مسجل، مدير).
- الوظائف الأساسية مرتبة حسب الأولوية، وما ليس مطلوباً الآن.
- القيود التقنية: اللغة والإطار والمنصة وقاعدة البيانات واتجاه النص RTL.
- معايير القبول: كيف تعرف أن الميزة اكتملت.
- البيانات الحساسة وطريقة حمايتها.
مثال مختصر
# تطبيق متابعة قراءة الكتب
الهدف: يسجّل الطالب الكتب التي يقرأها وصفحاته اليومية.
المستخدمون: طالب واحد (دون تسجيل دخول في النسخة الأولى).
الوظائف: إضافة كتاب، تسجيل صفحات اليوم، رسم بياني أسبوعي.
خارج النطاق: المشاركة الاجتماعية، الحسابات.
القيود: واجهة عربية RTL، تخزين محلي في المتصفح، يعمل على الجوال.
القبول: بعد إضافة كتاب وتسجيل 20 صفحة يظهر الرقم في الرسم الأسبوعي.