Tradex Core

**Tradex Core** هو نظام **Backend** ذكي للتجارة الإلكترونية، تم تطويره باستخدام **Laravel 13 (PHP 8.5+)**، ويعتمد على تقنيات **الذكاء الاصطناعي (AI)** لأتمتة إنشاء المحتوى وتحسين تجربة إدارة المتجر.

يوفر النظام إمكانية إنشاء **وصف المنتجات**، و**منشورات وسائل التواصل الاجتماعي**، و**الهاشتاقات**، و**الردود على استفسارات العملاء** بشكل تلقائي. كما يستخدم تقنية **RAG (Retrieval-Augmented Generation)** مع إضافة **pgvector** في **PostgreSQL** لتقديم إجابات أكثر دقة واعتمادًا على بيانات المتجر وسياسته.

### أبرز المميزات

* إنشاء وصف احترافي للمنتجات باستخدام **AI**.

* توليد منشورات جاهزة للنشر على وسائل التواصل الاجتماعي.

* اقتراح **Hashtags** مناسبة لزيادة الوصول.

* إنشاء ردود ذكية على استفسارات العملاء.

* دعم **RAG** مع **pgvector** لإجراء **Semantic Search** واسترجاع المعلومات ذات الصلة من المنتجات والسياسات.

* دعم عدة مزودي ذكاء اصطناعي مثل:

* **OpenRouter** (الافتراضي)

* **OpenAI**

* **Anthropic**

* **Ollama**

* بث النتائج لحظيًا (**True SSE Streaming**) أثناء توليد المحتوى.

* نظام **Credits** يتيح للمستخدم 10 أرصدة مجانية عند التسجيل، مع استهلاك رصيد واحد لكل طلب AI.

* آلية **Circuit Breaker** باستخدام **Redis** للتعامل الذكي مع الأعطال وتقليل فشل الطلبات.

* تنفيذ المهام غير المتزامنة (**Queue Processing**) باستخدام **Laravel Horizon** و**Redis**.

* تتبع عدد **Input Tokens** و**Output Tokens** المستهلكة في كل طلب AI.

### التقنيات المستخدمة

* **Framework:** Laravel 13 (PHP 8.5+)

* **AI Library:** Prism (يدعم أكثر من مزود AI)

* **Database:** PostgreSQL 18 مع **pgvector** للإنتاج، وSQLite للاختبارات

* **Cache & Queues:** Redis مع Laravel Horizon

* **API Documentation:** Scramble (OpenAPI / Swagger)

* **Authentication:** Laravel Sanctum (Bearer Token)

* **Testing:** PHPUnit 12.5+ وMockery