> For the complete documentation index, see [llms.txt](https://docs.chamilo.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chamilo.org/3.x/ar/dlyl-almtw-r/developer-guide.md).

# دليل المطوّر

مرحبًا بكم في دليل المطوّر لـ Chamilo 3.0. هذا الدليل موجَّه إلى المطوّرين الذين يرغبون في فهم معمارية Chamilo، وتوسيع المنصة عبر الإضافات، واستخدام الـ API، وتخصيص الواجهة، أو المساهمة في المشروع.

## نظرة سريعة على المعمارية

بُني Chamilo 3.0 على:

* **الخلفية (Backend)**: Symfony 7.4 (PHP 8.3–8.5) مع Doctrine ORM و API Platform 4
* **الواجهة الأمامية (Frontend)**: Vue 3 مع PrimeVue، وإدارة الحالة عبر Pinia، و Vue Router
* **نظام البناء**: Webpack 5 عبر Symfony Webpack Encore، مع Tailwind CSS
* **المصادقة**: رموز JWT (lexik/jwt-authentication-bundle)
* **تخزين الملفات**: Flysystem (يدعم التخزين المحلي، و AWS S3، و Azure Blob، و Google Cloud)

يُنظَّم مصدر الشيفرة في ثلاثة حزم Symfony:

| الحزمة           | الغرض                                                                                |
| ---------------- | ------------------------------------------------------------------------------------ |
| **CoreBundle**   | نواة المنصة: المستخدمون، الإعدادات، الموارد، الإدارة، مزوّدو الذكاء الاصطناعي، الأمن |
| **CourseBundle** | ميزات خاصة بالمقررات: المستندات، التمارين، مسارات التعلّم، المنتديات، وغيرها         |
| **LtiBundle**    | تكامل LTI 1.3 لأدوات التعلّم الخارجية                                                |

## تنظيم هذا الدليل

1. **البدء** — المكدس التقني، إعداد بيئة التطوير، بنية المشروع
2. **الخلفية (Backend)** — معمارية Symfony، الكيانات، نظام الموارد، المتحكّمات، الإعدادات
3. **API** — REST API عبر API Platform، مصادقة JWT، الإجراءات المخصّصة
4. **الواجهة الأمامية (Frontend)** — مكوّنات Vue، العروض، التوجيه، إدارة الحالة، نظام البناء
5. **السمات (Theming)** — سمات الألوان، CSS/Tailwind، قوالب Twig
6. **الإضافات (Plugins)** — معمارية الإضافات وتطويرها
7. **المساهمة** — اصطلاحات الترميز، سير عمل git، الاختبار