الوحدة 16: مشروع E-Contact Backend - دليل كامل
أهداف الوحدة
توجهك هذه الوحدة خلال التنفيذ الكامل لمشروع e-contact-backend، وهو تطبيق Spring Boot احترافي مع:
- API REST كاملة لنموذج الاتصال
- مصادقة وأمان JWT
- قاعدة بيانات PostgreSQL
- تكامل الواجهة الأمامية
- نشر باستخدام GitHub Codespaces
📦 المستودع الرئيسي على GitHub
الوصول إلى المشروع
المستودع: inskillflow-docs-formation-spring-boot-projet-e-contact-backend
يحتوي هذا المستودع على الكود المصدري الكامل، الوثائق، أدلة استكشاف الأخطاء وإصلاحها، والواجهة الأمامية للاختبار.
خطة الوحدة
الفصول العملية
| # | الفصل | المدة | الوصف |
|---|---|---|---|
| 1 | البدء مع Codespaces | 1 ساعة | إعداد بيئة GitHub Codespaces |
| 2 | استكشاف الأخطاء وإصلاحها | 1 ساعة و30 دقيقة | حل المشاكل الشائعة |
| 3 | تكامل الواجهة الأمامية | 1 ساعة | ربط الواجهة الأمامية بالواجهة الخلفية |
| 4 | دورة مكملة | 3 ساعات | الوحدات 22-28 - تعمق |
| 5 | الأمان المتقدم | 4 ساعات | الوحدات 11-18 - الأمان خطوة بخطوة |
المدة الإجمالية المقدرة: 10-12 ساعة
🔗 موارد المشروع
الكود المصدري والوثائق
| المورد | الرابط | الوصف |
|---|---|---|
| المستودع الرئيسي | GitHub | الكود المصدري الكامل للمشروع |
| استكشاف الأخطاء وإصلاحها | مجلد استكشاف الأخطاء | أدلة حل المشاكل |
| الواجهة الأمامية | مجلد الواجهة الأمامية | واجهة أمامية بسيطة لاختبار الـ API |
| دليل الواجهة الأمامية | دليل التكامل | تكامل الواجهة الأمامية مع Codespaces |
الدورات والتدريبات
| المورد | الرابط | الوصف |
|---|---|---|
| دورة مكملة | مجلد الدورة | دورات كاملة (خاصة الوحدات 22-28) |
| الأمان المفصل | ملحقات الأمان | الوحدات 11-18 حول الأمان |
هيكل المشروع
e-contact-backend/
├── 📁 src/main/java/
│ ├── 📁 config/ # إعدادات Spring Security، CORS
│ ├── 📁 controller/ # REST Controllers (Contact, Auth, Admin)
│ ├── 📁 dto/ # كائنات نقل البيانات
│ ├── 📁 model/ # كيانات JPA (Lead, User)
│ ├── 📁 repository/ # مستودعات Spring Data JPA
│ ├── 📁 security/ # JWT، الفلاتر، المصادقة
│ └── 📁 service/ # المنطق التجاري
├── 📁 src/main/resources/
│ └── application.yml # إعدادات
├── 📁 frontend/ # واجهة أمامية للاختبار HTML/JS
├── 📁 troubleshooting/ # أدلة استكشاف الأخطاء
└── 📁 cours/ # وثائق ودورات
└── 📁 annexes-security-1/ # دورة أمان مفصلة
بدء سريع
الخيار 1: GitHub Codespaces (موصى به)
- افتح المستودع على GitHub
- انقر على Code → Codespaces → Create codespace on main
- انتظر تحميل البيئة (~2 دقيقة)
- شغل التطبيق:
./mvnw spring-boot:run
الخيار 2: محليًا
# استنساخ المستودع
git clone https://github.com/hrhouma1/inskillflow-docs-formation-spring-boot-projet-e-contact-backend.git
# الوصول إلى المجلد
cd inskillflow-docs-formation-spring-boot-projet-e-contact-backend
# شغل التطبيق
./mvnw spring-boot:run
📋 المتطلبات
المعارف المطلوبة
- الوحدات 1-13 من هذه الدورة
- أساسيات Spring Boot وSpring MVC
- مفاهيم Spring Data JPA
- الإلمام بـ REST APIs
الأدوات اللازمة
| الأداة | الإصدار | الاستخدام |
|---|---|---|
| حساب GitHub | - | لـ Codespaces |
| متصفح ويب | حديث | لاختبار الـ API والواجهة الأمامية |
| (اختياري) Java | 17+ | إذا كان التشغيل محليًا |
| (اختياري) Maven | 3.8+ | إذا كان التشغيل محليًا |
| (اختياري) PostgreSQL | 14+ | إذا كان التشغيل محليًا |
مسار التعلم الموصى به
الترتيب المقترح
- الفصل 1 - ابدأ بإعداد بيئة Codespaces الخاصة بك
- الفصل 2 - ارجع إلى استكشاف الأخطاء وإصلاحها إذا واجهت مشاكل
- الفصل 3 - اربط الواجهة الأمامية لرؤية النتيجة
- الفصل 4 - تعمق مع الدورات المكملة
- الفصل 5 - أتقن أمان Spring Security وJWT
المهارات المكتسبة
في نهاية هذه الوحدة، ستكون قادرًا على:
| المهارة | المستوى |
|---|---|
| إنشاء API REST كاملة | ⭐⭐⭐⭐⭐ |
| تنفيذ JWT Authentication | ⭐⭐⭐⭐⭐ |
| استخدام GitHub Codespaces | ⭐⭐⭐⭐ |
| تكامل واجهة أمامية | ⭐⭐⭐⭐ |
| تصحيح تطبيق Spring | ⭐⭐⭐⭐⭐ |
| إعداد Spring Security | ⭐⭐⭐⭐⭐ |
📞 الدعم
إذا واجهت صعوبات:
- راجع أولاً دليل استكشاف الأخطاء وإصلاحها
- تحقق من مشاكل GitHub
- تواصل مع معلمك