Headless WordPress Job Board Platform with Next.js 14 & Custom REST API

منصة وظائف متكاملة (Job Board) مبنية بمعمارية Headless تجمع بين قوة WordPress كـ backend و Next.js كـ frontend — حلاً عصرياً يقدم تجربة مستخدم سينمائية فاخرة مع أداء عالٍ وتحكم كامل في البيانات.

المعمارية والتقنيات:

- **Backend:** WordPress مع إضافة مخصصة (job-board-core) توفر REST API كامل بمساحة `jbc/v1` — مصادقة JWT بدون اعتماديات خارجية، أدوار مستخدمين (صاحب عمل / مرشح)، ونظام قاعدة بيانات مخصص بجداول منفصلة عبر dbDelta

- **Frontend:** Next.js 14 (App Router) مع React 18 و TypeScript صارم، تصميم بـ Tailwind CSS مع متغيرات CSS، وحركة سينمائية عبر GSAP + ScrollTrigger + Lenis

- **قاعدة البيانات:** MariaDB 11.4 مع Docker Compose لبيئة تطوير محلية كاملة

**الميزات المنفذة:**

*للأصحاب العمل:* لوحة تحكم لإدارة الوظائف المنشورة + نظام تتبع المتقدمين (ATS) بخط أنابيب حالات (جديد → قيد المراجعة → مقابلة → مقبول/مرفوض) + إشعارات بريدية تلقائية عند كل تقديم جديد

*للمرشحين:* تسجيل حساب وتقديم على الوظائف برسالة تغطية + حفظ الوظائف المفضلة + إنشاء تنبيهات بريدية (يومية/أسبوعية) تتطابق مع معايير البحث + تتبع حالة كل تقديم

*للزوار:* تصفح الوظائف مع بحث متقدم بأوجه (Faceted Search) يعرض عدّادات ديناميكية لكل فلتر + صفحة إحصائيات حية بعدّاد زوار يتحدث كل 20 ثانية + ترتيب الوظائف حسب التاريخ

**الأمان والأداء:**

- مصادقة عبر httpOnly cookies (الـ JWT لا يُخزّن في المتصفح مباشرة)

- حدّ معدل المحاولات (Rate Limiting) على تسجيل الدخول والتسجيل لمنع هجمات القوة الغاشمة

- proxy خادم مع قائمة بيضاء صارمة للـ endpoints المسموحة + حماية ضد path traversal

- إعادة تحقق فورية للمحتوى (ISR + on-demand revalidation) عبر webhook من WordPress عند كل تعديل

- XSS protection على بيانات JSON-LD المنظمة

**التصميم والتجربة:**

- نظام تصميم كامل بألوان أسود/عاجي/أخضر ليموني مع طباعة ضخمة وحدود تقنية

- وضع داكن (Dark Mode) قابل للتبديل مع حفظ التفضيل

- دعم RTL كامل قابل للتبديل

- مؤشر ماوس مخصص (fine-pointer cursor) يتكيف فوق العناصر التفاعلية

- مشهد افتتاحي سينمائي مع حركة بارالاكس عند التمرير

- احترام كامل لـ `prefers-reduced-motion` لذوي الاحتياجات الخاصة

**SEO:**

- بيانات منظمة JSON-LD (WebSite + SearchAction + JobPosting + BreadcrumbList)

- sitemap.xml ديناميكي + robots.txt

- Open Graph و Twitter Cards

**الجودة والاختبارات:**

- اختبارات PHPUnit للـ JWT (6 اختبارات)

- اختبارات Playwright E2E (9 اختبارات تغطي كل الصفحات الرئيسية)

- CI/CD عبر GitHub Actions (lint + typecheck + build + e2e + PHP tests)

- ESLint + TypeScript strict mode

**يشمل المشروع:**

- 15 صنف PHP في الإضافة الخلفية (REST API، مصادقة، أدوار، ATS، تنبيهات، بريد، rate limiting، إعادة تحقق، قاعدة بيانات)

- 22 مساراً في الواجهة (صفحات عامة + لوحات تحكم + API handlers)

- وضع تجريبي (Demo Mode) لتجربة كل الميزات دون الحاجة لـ WordPress

- Docker Compose لبيئة تطوير كاملة قابلة للتكرار

- توثيق احترافي (README + LICENSE + .env.example)