# 🚀 الدليل الشامل لجميع الـ Endpoints (API V1)

> **العنوان الأساسي للباك إند (Base URL):** `http://192.168.1.146:8000`  
> **عنوان الـ API المباشر:** `http://192.168.1.146:8000/api/v1`

---

## 1️⃣ الهيدر وشريط القائمة العلوي (Header & Navigation)

| الوظيفة | Method | رابط الـ Endpoint | ماذا يعيد؟ |
|---|:---:|---|---|
| **الـ Endpoint الشامل للقائمة والهيدر** | `GET` | `http://192.168.1.146:8000/api/v1/public/navigation` | اللوجو، الهوية، زر الاتصال CTA، والروابط كاملة |
| إعدادات اللوجو وزر الـ CTA | `GET` | `http://192.168.1.146:8000/api/v1/resources/menu-bar-settings` | اللوجو، اسم العلامة، نص ورابط زر الـ Action |
| روابط القائمة العلوية فقط | `GET` | `http://192.168.1.146:8000/api/v1/resources/menu-bar-links?filter[is_active]=1&sort=display_order` | قائمة الروابط النشطة مرتبة |

---

## 2️⃣ الفوتر وتذييل الموقع (Footer)

> 💡 **تحديث جديد:** تم تفعيل إمكانية رفع وتغيير صورة شعار الفوتر (Footer Logo) مباشرة من لوحة التحكم مع المعاينة الفورية وخيار الحذف بنقرة واحدة، حيث يتم حفظ وتوفير رابط الصورة تلقائياً في الـ Endpoint.

| الوظيفة | Method | رابط الـ Endpoint | ماذا يعيد؟ |
|---|:---:|---|---|
| **الـ Endpoint الشامل للفوتر كاملاً** | `GET` | `http://192.168.1.146:8000/api/v1/public/footer` | شعار الفوتر المرفوع (`logo_url`)، نبذة الشركة، أقسام الروابط، التواصل، السوشيال، وحقوق النشر |
| إعدادات ونصوص وشعار الفوتر | `GET` | `http://192.168.1.146:8000/api/v1/resources/footer-settings` | رابط الشعار المرفوع أو المحذوف، النصوص، سنة الحقوق، والوصف المختصر |
| أعمدة وأقسام روابط الفوتر | `GET` | `http://192.168.1.146:8000/api/v1/resources/footer-sections?filter[is_active]=1&sort=display_order` | أعمدة الروابط (روابط سريعة، خدمات، الخ) |
| روابط منصات التواصل الاجتماعي | `GET` | `http://192.168.1.146:8000/api/v1/resources/social-links?filter[is_active]=1&sort=display_order` | منصات السوشيال ميديا (LinkedIn, X, GitHub, Facebook, WhatsApp, الخ) |

---

## 3️⃣ الصفحة الرئيسية (Home Page)

| السيكشن / الوظيفة | Method | رابط الـ Endpoint | ماذا يعيد؟ |
|---|:---:|---|---|
| **الـ Endpoint الشامل لجميع سكاشن الرئيسية** | `GET` | `http://192.168.1.146:8000/api/v1/public/home` | يجمع كل سكاشن الصفحة الرئيسية في استدعاء واحد |
| سيكشن الهيرو (Hero Header) | `GET` | `http://192.168.1.146:8000/api/v1/resources/home-hero-sections` | العنوان الرئيسي، الوصف، وأزرار الـ CTA |
| شركاء النجاح وعملاؤنا | `GET` | `http://192.168.1.146:8000/api/v1/public/partners` | شعارات وأسماء الشركات الشريكة |
| كروت الخدمات الرئيسية | `GET` | `http://192.168.1.146:8000/api/v1/resources/services?filter[is_active]=1&sort=display_order` | قائمة الخدمات مع الأيقونات والوصف |
| أحدث المشاريع المميزة | `GET` | `http://192.168.1.146:8000/api/v1/resources/projects?filter[is_active]=1&sort=display_order` | المشاريع المنفذة مع الصور والتصنيف |
| عدادات الأرقام والإنجازات (Stats) | `GET` | `http://192.168.1.146:8000/api/v1/resources/stats-counters?filter[is_active]=1&sort=display_order` | أرقام الإنجازات والخبرة وسنوات العمل |
| مراحل ومنهجية العمل (Process Steps) | `GET` | `http://192.168.1.146:8000/api/v1/resources/process-steps?filter[is_active]=1&sort=display_order` | خطوات العمل من التخطيط حتى التسليم |
| آراء وتقييمات العملاء (Testimonials) | `GET` | `http://192.168.1.146:8000/api/v1/resources/testimonials?filter[is_active]=1&sort=display_order` | شهادات العملاء والتقييمات بالنجوم |
| الأسئلة الشائعة (FAQs) | `GET` | `http://192.168.1.146:8000/api/v1/resources/faqs?filter[is_active]=1&sort=display_order` | الأسئلة وإجاباتها المصنفة والمرتبة |

---

## 4️⃣ صفحة من نحن (About Us)

| الوظيفة | Method | رابط الـ Endpoint | ماذا يعيد؟ |
|---|:---:|---|---|
| **الـ Endpoint الشامل لصفحة من نحن** | `GET` | `http://192.168.1.146:8000/api/v1/public/about` | قصة الشركة، الخط الزمني، رسالة CEO، الفريق، والـ CTA |
| **الاسم البديل لنفس الصفحة** | `GET` | `http://192.168.1.146:8000/api/v1/public/about-page` | نفس البيانات الشاملة لصفحة من نحن |

---

## 5️⃣ صفحة تواصل معنا (Contact Us)

| الوظيفة | Method | رابط الـ Endpoint | ماذا يعيد؟ |
|---|:---:|---|---|
| **الـ Endpoint الشامل لصفحة تواصل معنا** | `GET` | `http://192.168.1.146:8000/api/v1/public/contact` | الهاتف، البريد، العنوان، الواتساب، وحقول النموذج |
| **الاسم البديل لنفس الصفحة** | `GET` | `http://192.168.1.146:8000/api/v1/public/contact-page` | نفس بيانات التواصل |
| **إرسال رسالة تواصل جديدة من العميل** | `POST` | `http://192.168.1.146:8000/api/v1/public/contact-submissions` | يستقبل `name`, `email`, `phone`, `message` |

---

## 6️⃣ صفحة المدونة والمقالات (Blog & Articles)

> 💡 **تحديث جديد:** تم حذف التكرار وجعل الاستجابة نظيفة تحتوي على إعدادات الصفحة (`page`) والمقالات المصنفة والمميزة والأحدث (`sections`)، مع إمكانية تعديل ونشر المقالات لحظياً من لوحة التحكم.

| الوظيفة | Method | رابط الـ Endpoint | ماذا يعيد؟ |
|---|:---:|---|---|
| **الـ Endpoint الشامل لصفحة المدونة** | `GET` | `http://192.168.1.146:8000/api/v1/public/posts` | إعدادات الصفحة (`page`)، المقال المميز، الشائع، والأحدث (`sections`) |
| **الاسم البديل للمدونة** | `GET` | `http://192.168.1.146:8000/api/v1/public/blog` | نفس بيانات المدونة المنظمة |
| **قراءة مقال محدد بالكامل من الداخل** | `GET` | `http://192.168.1.146:8000/api/v1/public/posts/{slug}` | المقال كاملاً بالمقدمة، الأقسام، الخلاصة، والـ CTA |
| *(مثال حي لمقال الذكاء الاصطناعي)* | `GET` | `http://192.168.1.146:8000/api/v1/public/posts/ai-agents-business` | محتوى مقال AI Agents كاملاً |
| *(مثال حي لمقال نظام ERP)* | `GET` | `http://192.168.1.146:8000/api/v1/public/posts/custom-erp-system` | محتوى مقال ERP كاملاً |

---

## 7️⃣ صفحة معرض الأعمال والمشاريع (Portfolio / Work)

| الوظيفة | Method | رابط الـ Endpoint | ماذا يعيد؟ |
|---|:---:|---|---|
| **الـ Endpoint الشامل لمعرض الأعمال** | `GET` | `http://192.168.1.146:8000/api/v1/public/portfolio` | الهيدر، المشاريع المميزة، وقائمة الأعمال |
| **الاسم البديل لمعرض الأعمال** | `GET` | `http://192.168.1.146:8000/api/v1/public/portfolio-page` | نفس بيانات الأعمال |
| **تفاصيل مشروع محدد (دراسة حالة Case Study)** | `GET` | `http://192.168.1.146:8000/api/v1/public/projects/{slug}` | القصة، التحديات، الحلول التقنية، والنتائج |
| قائمة المشاريع المباشرة | `GET` | `http://192.168.1.146:8000/api/v1/resources/projects?filter[is_active]=1&sort=display_order` | قائمة المشاريع المنشورة |
| تصنيفات المشاريع | `GET` | `http://192.168.1.146:8000/api/v1/resources/project-categories?filter[is_active]=1&sort=display_order` | تابات التصنيف (تطبيقات، مواقع، ERP) |

---

## 8️⃣ صفحة الخدمات (Services)

| الوظيفة | Method | رابط الـ Endpoint | ماذا يعيد؟ |
|---|:---:|---|---|
| **الـ Endpoint الشامل لصفحة الخدمات** | `GET` | `http://192.168.1.146:8000/api/v1/public/services` | عناوين الصفحة، باقات وكتالوج الخدمات كاملة |
| **الاسم البديل لصفحة الخدمات** | `GET` | `http://192.168.1.146:8000/api/v1/public/services-page` | نفس بيانات الخدمات |
| **تفاصيل خدمة محددة بالكامل** | `GET` | `http://192.168.1.146:8000/api/v1/public/services/{slug}` | شرح الخدمة، المزايا، خطوات التنفيذ، والـ CTA |
| قائمة الخدمات المباشرة | `GET` | `http://192.168.1.146:8000/api/v1/resources/services?filter[is_active]=1&sort=display_order` | جميع الخدمات المفعلة |

---

## 9️⃣ صفحة الوظائف والتوظيف (Careers / Jobs)

| الوظيفة | Method | رابط الـ Endpoint | ماذا يعيد؟ |
|---|:---:|---|---|
| **الـ Endpoint الشامل لصفحة الوظائف** | `GET` | `http://192.168.1.146:8000/api/v1/public/careers` | نصوص الصفحة، التصنيفات، الوظائف المفتوحة، وحقول التقديم |
| **الاسم البديل لصفحة الوظائف** | `GET` | `http://192.168.1.146:8000/api/v1/public/careers-page` | نفس بيانات الوظائف |
| **تقديم طلب توظيف جديد (مع رفع CV)** | `POST` | `http://192.168.1.146:8000/api/v1/public/careers/{job}/applications` | إرسال بيانات المتقدم وملف السيرة الذاتية PDF |

---

## 🔟 صفحة اطلب مشروعك (Project Request)

> 💡 **تحديث جديد:** تم تنظيف صفحة لوحة التحكم لتفتح مباشرة على عرض جميع طلبات المشاريع الواردة وإمكانية إدارة وتعديل نصوص وحقول صفحة اطلب مشروعك مع أزرار حفظ لكل سيكشن منفصل.

| الوظيفة | Method | رابط الـ Endpoint | ماذا يعيد؟ |
|---|:---:|---|---|
| **الـ Endpoint الشامل لإعدادات وحقول الصفحة** | `GET` | `http://192.168.1.146:8000/api/v1/public/project-request-page` | عناوين السكاشن، أرقامها، نصوص الحقول، شروط رفع الملف PDF |
| **إرسال طلب مشروع جديد من العميل** | `POST` | `http://192.168.1.146:8000/api/v1/public/project-requests` | يستقبل (`name`, `phone`, `email`, `project_details`, `attachment`) |
| **جلب قائمة طلبات المشاريع الواردة للداشبورد** | `GET` | `http://192.168.1.146:8000/api/v1/resources/project-requests` | يعيد مصفوفة بجميع الطلبات مع الاسم، الهاتف، الإيميل، التفاصيل، والمرفق |