university cafeteria

قمت بتطوير نظام متكامل لطلب الطعام في كافيتيريا الجامعة (CampusBite) بوصفه مشروعًا أكاديميًا شاملًا لمادة هندسة البرمجيات، حيث غطّى المشروع أربع مراحل متكاملة:

المرحلة الأولى — اكتشاف المتطلبات: تحديد جميع الأطراف الفاعلة في النظام (الطالب، موظف الكافيتيريا، المسؤول، بوابة الدفع، خدمة الإشعارات)، وبناء مصفوفة تتبع كاملة تربط أكثر من 56 متطلبًا وظيفيًا بالسيناريوهات والمخططات. كما أجريت تحليل personas لاكتشاف 7 متطلبات خفية غير موثّقة في المواصفات الرسمية، مثل وضع الضيوف غير الجامعيين، وتأخر تفعيل الخطة الغذائية، وإمكانية الوصول لمستخدمي قارئات الشاشة.

المرحلة الثانية — سيناريوهات Gherkin وعقود API: كتابة سيناريوهات BDD تغطي دورات كاملة مثل تسجيل الدخول، قفل الحساب، التحقق من الكوبونات، وعمليات الدفع عبر البوابة الإلكترونية أو المحفظة أو الخطة الغذائية. وتمّ تحويل كل وصف مبهم في المتطلبات ("سريع"، "موثوق") إلى مقاييس قابلة للقياس — مثل: استجابة API خلال 300ms عند النسبة المئوية p95، وتوافر النظام بنسبة 99.5% خلال ساعات العمل. كذلك صُمّمت عقود API واضحة لجميع نقاط النهاية مع إخفاء كامل لتفاصيل التنفيذ الداخلية.

المرحلة الثالثة — التطوير المدفوع بالاختبار (TDI): تطبيق منهجية Test-Driven Prompting حيث يُكتب الاختبار أولًا قبل أي كود، ثم تُضاف "قيود صارمة" (Padlocks) تُحدّد الحدود الدقيقة للسلوك المطلوب. شملت الحالات: قفل المخزون التفاؤلي لمنع البيع الزائد، نافذة الإلغاء في 120 ثانية بالضبط، منع الشحن المزدوج عبر مفاتيح Idempotency، والتزامن بين أجهزة متعددة.

المرحلة الرابعة — ضمان الجودة والاختبار: بناء هرم اختبار متكامل يشمل اختبارات الوحدة (70%) باستخدام Pytest وVitest، واختبارات التكامل (20%) لقواعد البيانات وRedis، واختبارات E2E (10%) باستخدام Playwright مع نمط Page Object Model. إضافةً إلى اختبارات الأداء بـ k6 لتحمّل 200 مستخدم متزامن، واختبارات أمنية تغطي OWASP Top 10 وحقن SQL وتحديد معدل الطلبات. وتمّ ربط كل ذلك بمسار CI/CD على GitHub Actions يعمل تلقائيًا عند كل push.

استُخدم في المشروع: React + Bootstrap للواجهة الأمامية، Python FastAPI للخلفية، PostgreSQL لقاعدة البيانات، مع النشر عبر Vercel وNeon.