طَبِّقْهاتعلّم المبدأ، وطبّقه بيدكمقرر 241 · تحليل وتصميم برمجيات الويب
الدرس 25 · الوحدة 11: تقديم المستندات للعميل للمراجعة والاعتماد

تقديم المستندات للعميل بوضوح

كيف تعرض مستندات المواصفات على العميل بطريقة يفهمها ويتخذ بها قرارًا واثقًا؟ ⏱ نحو 40 دقيقة.

بعد هذا الدرس ستستطيع أن:
  • تحلل جمهور العرض وما يهم كل فئة منه.
  • تكتب ملخصًا تنفيذيًّا قصيرًا بالمشكلة والحل والأثر والنطاق.
  • تخطط اجتماع عرض يوازن بين العرض والاستماع، وتستخدم رحلة المستخدم والنموذج الأولي.
  • تترجم المصطلحات التقنية إلى أثرها على عمل العميل.

١المستند الجيد لا يكفي

كتبنا مستندًا دقيقًا من أربعين صفحة. لكن أ. فهد مدير مشغول، ولن يقرأه كاملًا، وإن قرأه فلن يفهم ERD ولا رموز HTTP. من الخطة: «كيفية تقديم المستندات المنشأة للعميل بطريقة مفهومة ومنظمة». الهدف من التقديم: أن يفهم العميل ما سيحصل عليه، ويكتشف الآن ما لا يناسبه، ثم يعتمده وهو مطمئن.

الجمهوريهمهنعرض له
المدير (صاحب القرار)الأهداف، والتكلفة، والموعد، والمخاطرالملخص التنفيذي، والنطاق والمؤجل
المستخدمون (الموظفة، المدربون)كيف سيتغير عملهم اليوميرحلة المستخدم بالنموذج الأولي، والصلاحيات بلغة المهام
الفريق التقني لدى العميل (إن وجد)التقنيات، والاستضافة، والتكاملالمعمارية ومخطط الحاويات

٢الملخص التنفيذي

صفحة واحدة في أول المستند، تُقرأ في دقيقتين، وتكفي صاحب القرار ليعرف ما الذي سيعتمده:

📄 الملخص التنفيذي: نظام «دورات» الإصدار 1.0

يحل نظام «دورات» مشكلة ازدحام الاتصالات يوم فتح التسجيل وتأخر اعتماد الطلبات، بتمكين المتدربين من رؤية المقاعد المتاحة والتسجيل والدفع إلكترونيًّا، وتمكين موظفة التسجيل من اعتماد الطلبات من شاشة واحدة. نتوقع تقليل المكالمات 70% واعتماد 90% من الطلبات خلال يوم عمل. يشمل الإصدار الأول التسجيل والدفع والاعتماد والتقارير، وتؤجَّل الشهادات الإلكترونية للمرحلة الثانية. مدة التنفيذ عشرة أسابيع بعد الاعتماد.

يجيب عنفي الملخص
المشكلةازدحام الاتصالات وتأخر الاعتماد
الحلتسجيل ودفع واعتماد إلكتروني
الأثر المتوقع (بأرقام)70% و 90%
النطاق والمؤجليشمل… ويؤجل الشهادات
الموعدعشرة أسابيع

٣اجتماع العرض

لا تقرأ المستند على العميل صفحة صفحة. أرسله قبل الاجتماع بيومين، ثم اعرض في الاجتماع ما يحتاج قرارًا أو فهمًا. هذا جدول اجتماع العرض:

diagram.mmd
gantt  title اجتماع عرض المواصفات (60 دقيقة)  dateFormat HH:mm  axisFormat %H:%M  tickInterval 10minute  section العرض  الملخص التنفيذي :a1, 10:00, 5m  رحلة المتدرب بالنموذج الأولي :a2, after a1, 15m  الصلاحيات بلغة الأدوار :a3, after a2, 10m  section القرار  النطاق والمؤجل :a4, after a3, 10m  الأسئلة والملاحظات :a5, after a4, 15m  الخطوات التالية :a6, after a5, 5m
10:0010:1010:2010:3010:4010:5011:00الملخص التنفيذي رحلة المتدرب بالنموذج الأولي الصلاحيات بلغة الأدوار النطاق والمؤجل الأسئلة والملاحظات الخطوات التالية العرضالقراراجتماع عرض المواصفات (60 دقيقة)

لاحظ أن ثلث الوقت تقريبًا للأسئلة والملاحظات: الاجتماع للاستماع بقدر ما هو للعرض. وفي Mermaid نستطيع رسم الدقائق بـ dateFormat HH:mm والمدة 15m.

أسلوبلماذا يعمل
رحلة المستخدم: «سارة تفتح الجوال، تبحث، تسجّل، تدفع…»العميل يفهم القصص أسرع من القوائم
نموذج أولي Prototype أو رسم شاشاتيكشف «ليس هذا ما قصدته» قبل البرمجة لا بعدها
المخططات البسيطة فقط (حالات الاستخدام، والمخطط السياقي)ERD والتسلسل للفريق التقني لا للمدير
اعرض المؤجل صراحةيمنع مفاجأة «ظننت أن الشهادات ضمن المشروع»

٤ترجم المصطلحات

أكبر عائق في العرض: لغة الفريق التقني. ترجم كل مصطلح إلى أثره على عمل العميل:

✗ للعميل: غير مفهوم
💬 بلغة تقنية

النظام يستخدم RBAC مع ABAC للملكية، و MFA للأدوار الإدارية، و API بصيغة REST تعيد 403 عند فشل التفويض.

✓ للعميل: واضح
💬 بلغة العميل

كل موظف يرى ما يخص عمله فقط: المدرب يرى أسماء متدربي دوراته دون جوالاتهم. والموظفون يدخلون بكلمة المرور ورمز يصل لجوالهم، فلا يكفي سرقة كلمة المرور. ومن يحاول فتح صفحة ليست له تظهر له رسالة «غير مسموح».

الترجمة ليست تبسيطًا مخلًّا؛ هي وصف الأثر: ماذا سيرى المستخدم؟ وماذا سيمنع النظام؟

٥بعد الاجتماع

نعم

لا

إرسال المستند قبل الاجتماع بيومين

اجتماع العرض

سجل الملاحظات

تعديل المستند

ملاحظات جوهرية؟

الاعتماد

دورة التقديم: لا يُعتمد المستند حتى تُعالج الملاحظات الجوهرية. نفصّل المراجعة والاعتماد في الدرس القادم.

توقّع وتحقّق

ما الذي يكفي صاحب القرار لفهم ما سيعتمده؟

متى يُرسل المستند للعميل؟

أي عرض أنسب للمستخدمين اليوميين؟

سألك العميل سؤالًا لا تعرف جوابه. التصرف الأفضل:

الخلاصة

تحدٍّ تصميمي: حزمة العرض على أ. فهد

متوسط

جهّز ما ستقدمه في اجتماع عرض مواصفات «دورات»: ملخصًا تنفيذيًّا قصيرًا، وجدول أعمال الاجتماع، وترجمة ثلاثة مصطلحات تقنية إلى لغة أثرها على المركز.

المطلوب:
  • ملخص تنفيذي لا يزيد على 90 كلمة، يذكر المشكلة والحل وأثرًا متوقعًا برقم وما أُجّل.
  • جدول أعمال من أربعة بنود على الأقل، كل بند مع مدته بالدقائق، ومنها بند للأسئلة والملاحظات.
  • ترجمة ثلاثة مصطلحات على الأقل، كل منها في سطر: المصطلح ثم «←» ثم معناه للعميل بلا مصطلحات إنجليزية.
✓ التحقق الآلي: يفحص المختبر بنية مستندك وصياغته (لا يحكم على جودة الفكرة؛ هذا دور معلمك)
  • الملخص لا يزيد على 90 كلمة
  • الملخص 30 كلمة على الأقل
  • الملخص يذكر أثرًا برقم
  • الملخص يذكر ما أُجّل
  • أربعة بنود على الأقل
  • كل بند مع مدته بالدقائق
  • بند للأسئلة أو الملاحظات
  • ثلاث ترجمات على الأقل
  • كل ترجمة: المصطلح ← المعنى
  • المعنى للعميل بلا كلمات إنجليزية بعد السهم

💡 تلميح 1
ابدأ الملخص بالمشكلة التي قالها أ. فهد في الاجتماع الأول.
💡 تلميح 2
أعط الأسئلة والملاحظات ربع وقت الاجتماع على الأقل.
💡 تلميح 3
صف الأثر: «ماذا سيرى المستخدم؟ وماذا سيمنع النظام؟» لا كيف يعمل تقنيًّا.

نموذج واحد من إجابات كثيرة صحيحة.

الملخص التنفيذي
يحل نظام «دورات» مشكلة ازدحام المكالمات يوم التسجيل وتأخر اعتماد الطلبات، إذ يرى المتدرب المقاعد المتاحة ويسجّل ويدفع إلكترونيًّا، وتعتمد الموظفة الطلبات من شاشة واحدة. نتوقع تقليل المكالمات 70%. وتؤجَّل الشهادات الإلكترونية للمرحلة الثانية.
جدول أعمال العرض (بند ومدته في كل سطر)
الملخص التنفيذي – 5 دقائق
رحلة المتدرب بالنموذج الأولي – 15 دقيقة
الصلاحيات بلغة الأدوار – 10 دقائق
النطاق والمؤجل – 10 دقائق
الأسئلة والملاحظات – 15 دقيقة
ترجمة المصطلحات
MFA ← يدخل الموظف بكلمة المرور ورمز يصل لجواله
RBAC ← كل موظف يرى ما يخص عمله فقط
403 ← تظهر رسالة «غير مسموح» لمن يفتح صفحة ليست له
انتقل إلى تقييم الدرساختيار من متعدد، وصح وخطأ، وأكمل الفراغ، وتتبّع الناتج.ابدأ التقييم ←

📝 معلم؟ أرسل ملاحظة للمؤلف عن هذا الدرس