سيناريو المشروع وقواعد العمل
المسار: تطوير نظام إدارة الأعراس ودعوات QR الوحدة: التحليل والتصميم
مدخل إلى الدرس: سيناريو المشروع وقواعد العمل
سيناريو المشروع وقواعد العمل — نظام إدارة الأعراس والمناسبات ودعوات QR | Next.js وPrisma | أديب الصلوي
طريقة الدراسة: اقرأ التعريف، تتبّع المثال في الشرح، نفّذه بنفسك، ثم اختبر النتيجة والحالات الاستثنائية قبل الانتقال.
أهداف هذا الدرس
- تحديد سيناريو واقعي: منظمة زفاف + أجهزة لوحية للفرزة.
- صياغة قواعد العمل كقيود قابلة للتنفيذ.
- إعلان حدود المشروع لضبط النطاق (Scope).
المخطط: مخطط مفاهيم السيناريو (Context)
flowchart TD
G[("مدعو يفتح QR/رابط")]
G -->|يُسجّل الدخول| L["قائمة ضيوف"]
GATE["فرزة (بوابات) — أجهزة لوحية"] -->|مسح QR| L
L --> DASH["لوحة حيّة للمنظّم
دعوات · قبول · حضور"]
قواعد العمل (Business Rules)
| القاعدة | الترجمة في الكود | حالة الفشل |
|---|---|---|
| الدعوة تُعرض فقط لمن يملك رابطاً موقّعاً صحيحاً | verifySignature قبل الجلب | 403 |
| لا يرد المدعو على المناسبة أكثر من مرة | UNIQUE(guest_id,event_id)+upsert | 409 |
| المدعو يُسجَّل حضوره مرة واحدة فقط | فحص CheckIn سابق + إنشاء | 409 |
| رقم الطاولة اختياري للمنظّم | column table_no NULL | لا فشل |
حدود مقصودة لمنع انفجار النطاق
- المصادقة للمنظّم بكلمة مرور بسيطة/جلسة، لا نظام مستخدمين كامل.
- صور الدعوة تُرفع برابط مباشر (URL) لا بمعالجة ملفات.
- نظام الدفع خارج النطاق — الدورة مالية مجانية.
قاعدة ذهبية: المشروع الناجح ليس الأوسع بل الأوضح حدوداً. كل ميزة خارج السيناريو تُسجَّل طلباً مستقبلاً ولا تُبنى الآن.
الخلاصة السريعة
- سيناريو ملموس: منظمة تزيد حتى 500 ضيف عبر أجهزة لوحية.
- قواعد العمل تُنفَّذ كقيود قاعدة بيانات + تحققات API.
- الإعلان عن الحدود يمنع تضخم النطاق ويُبقي التسليم موثوقاً.
تمرين تطبيقي: اكتب ثلاث قواعد عمل إضافية طبيعية (مثل: لا تُعلن إحصائيات الحضور قبل بدء الحفل) وقدر أثر كل واحدة على المخطط.
أخطاء شائعة يجب تفاديها
- اعتبار «كل شيء ممكن» بدون سيناريو — تتعقد القاعدة ويزول موعد التسليم.
- ترك التوقيع خارج التصميم حتى يُضاف لاحقاً بمشقة.
- إهمال حدود الصلاحية الزمنية للدعوات (انتهاء بعد الحفل).
معجم مصطلحات الدرس
- قيود النطاق
- حدود صريحة لما لا يبنيه المشروع في هذه النسخة.
- قاعدة عمل
- شرط يطبَّق على بيانات النظام للحفاظ على صحتها.
- حضور وحيد
- منع تسجيل المدعو الواحد أكثر من مرة في نفس المناسبة.
مراجعة وتمرين تثبيت المهارة
اختبار سريع: اشرح بعبارتك معنى «سيناريو المشروع وقواعد العمل»، ثم بيّن أين ستستخدمه داخل نظام تسجيل حضور دعوات مناسبة عبر رمز QR، وما الخطأ الذي يجب اختباره قبل الاعتماد على الحل.
تحدٍّ إضافي: غيّر شرطًا واحدًا في التطبيق، وتوقع النتيجة، ثم نفّذ الاختبار وفسّر الاختلاف.
