المخطط الزمني (18 يومًا) — Laravel 11 API + ربط React/React Native
مدة التنفيذ: 18 يوم تقويمية الإصدار: Laravel 11 + MySQL 8 + Sanctum المنصات: لوحة إدارة + لوحة متجر + تطبيق React Native + صفحة هبوط

نطاق العمل المختصر

الـ Back‑End (Laravel)

  • تصميم قاعدة البيانات (MySQL) وهجرات + نمذجة Eloquent.
  • مصادقة Sanctum، أدوار وصلاحيات (Spatie/laravel-permission).
  • بناء CRUD APIs موحّدة الاستجابة (JSON:API).
  • إدارة المتاجر، المنتجات/العناصر، الطلبات، الإشعارات.

الربط والواجهات

  • Endpoints لتطبيق React Native (ومنها QR Scan Endpoints).
  • لوحة تحكم إدارية ولوحة متجر (React أو Blade + Inertia).
  • صفحة هبوط سريعة وخفيفة (SEO Ready).

الجودة والتسليم

  • توثيق Postman/Swagger + ملف بيئات.
  • حماية، فحص أداء، معدلات طلب (Rate Limit) وLogs.
  • نشر تجريبي + حزمة تسليم نهائية جاهزة للربط.

مؤشرات التنفيذ

18
يوم عمل
4
شاشات React Native
2
لوحات (إدارة + متجر)
1
Landing Page
اليوم المرحلة المهام الرئيسية مخرجات قابلة للتسليم معايير القبول
١ تحليل المتطلبات جمع تفاصيل الشاشات الأربعة، نمذجة الكيانات والعلاقات، تحديد التدفقات (Auth/QR/CRUD). وثيقة SRS مختصرة + مخطط ERD أولي. اعتماد النطاق وقائمة الكيانات.
٢ تهيئة المشروع إنشاء Laravel 11، ضبط .env، Sanctum، Spatie Permission، قواعد CORS وRate Limit. مستودع Git، بنية مجلدات، بيئة تطوير. تشغيل محلي بدون أخطاء + فحوص صحة أساسية.
٣–٤ تصميم القاعدة والهجرات صياغة ERD النهائي، إنشاء الهجرات والفكتوريز والسييدرز، فهارس وأكواد مرجعية. Schema MySQL مُفهرس + عينات بيانات. نجاح الهجرات وإرجاع/إعادة Seed بدون فشل.
٥–٦ المصادقة والصلاحيات تسجيل/تسجيل دخول/تحديث جلسة، أدوار (Admin/Store/Staff)، سياسات Gates. Endpoints Auth + حماية المسارات. تمرير اختبارات صلاحيات نموذجية.
٧–١٠ واجهات CRUD الأساسية كيانات مستخدم/متجر/منتج/طلب/إشعار مع موارد وتحويلات JSON موحدة. مجموعة Postman أولية + Swagger YAML. كل CRUD تعمل (create/read/update/delete) مع فحص المدخلات.
١١–١٢ QR Scan API Endpoints لإنشاء/التحقق من رموز QR (JWT قصيرة العمر)، صلاحيات وصول للمتجر. API للإنشاء والتحقق + حالات خطأ واضحة. اختبارات نجاح/فشل وقيود المدة.
١٣–١٥ اللوحات والربط لوحة إدارة ولوحة متجر (React أو Blade/Inertia) بنسبة 1:1 مع الـ APIs. واجهات أساسية جاهزة للاستخدام الداخلي. كل شاشة تقرأ/تكتب من الـ API بنجاح.
١٦ Landing Page صفحة هبوط سريعة (Meta/OG/Schema) ومهيأة للأداء. ملفات HTML/CSS/Assets. نتيجة Lighthouse ≥ 90 للأداء وإتاحة الوصول.
١٧ الاختبارات والأمان اختبارات وحدات ومتكاملة، حماية إدخالات، قيود معدل، مراجعة السجلات. تقرير اختبارات + ضبط Env للبيئة التجريبية. خلو من ثغرات OWASP الشائعة.
١٨ التغليف والتسليم ضبط CI بسيط، إعداد دليل التشغيل، حزمة تسليم نهائية + نسخة احتياطية. Zip نهائي + مستند ربط للواجهات. قبول نهائي واستعداد للدمج مع الواجهات.

التوثيق والتسليم

ملاحظة تقنية

تم اختيار Laravel 11 مع Sanctum لسرعة التطوير، التوسّع، وتوحيد الصلاحيات. اقتراحات بديلة (NestJS) متاحة عند الطلب قبل البدء.