# وصف المشروع بالعربية
# Description du Projet en Arabe
---
## عنوان المشروع
## Titre du Projet
**تطوير تطبيق ويب لإدارة المتدربين**
Développement d'une Application Web de Gestion des Stagiaires
---
## الإشكالية
## Problématique
تواجه الشركة التونسية للكهرباء والغاز (ستاغ) صعوبات في إدارة المتدربين بسبب استخدام النظام اليدوي القائم على برامج Excel و Word، مما يؤدي إلى:
- **تشتت المعلومات** في ملفات متعددة
- **صعوبة البحث** عن بيانات المتدربين
- **إهدار الوقت** في إنشاء الشهادات يدوياً
- **أخطاء في الإدخال** والتحديث
- **فقدان البيانات** وعدم الحفظ الآمن
- **عدم وجود نظام موحد** لتتبع المتدربين
---
## الحل المقترح
## Solution Proposée
تطوير **تطبيق ويب حديث ومتكامل** يسمح بـ:
**المركزية**: جمع كل المعلومات في قاعدة بيانات واحدة
**الأتمتة**: إنشاء الشهادات تلقائياً
**السهولة**: واجهة مستخدم بديهية وسهلة الاستخدام
**الأمان**: نظام مصادقة وصلاحيات متقدم
**التصدير**: إمكانية تصدير البيانات بصيغ PDF و Excel
---
## الأهداف الرئيسية
## Objectifs Principaux
### 1️⃣ **الهدف العام**
تطوير نظام معلوماتي شامل لرقمنة عملية إدارة المتدربين في الشركة التونسية للكهرباء والغاز
### 2️⃣ **الأهداف المحددة**
** التحليل والتصميم:**
- تحليل احتياجات المستخدمين (موظفي الموارد البشرية)
- تصميم قاعدة البيانات العلائقية
- وضع مخططات UML (حالات الاستخدام، الفئات)
- اختيار التقنيات المناسبة
** التطوير التقني:**
- تطوير الواجهة الخلفية (Backend) باستخدام Laravel
- تطوير الواجهة الأمامية (Frontend) باستخدام Bootstrap و JavaScript
- إنشاء قاعدة بيانات MySQL/SQLite
- تنفيذ نظام المصادقة والصلاحيات
** الأمن والحماية:**
- نظام مصادقة آمن (تشفير كلمات المرور)
- حماية ضد الهجمات الشائعة (CSRF, XSS, SQL Injection)
- إدارة الصلاحيات حسب الأدوار (مدير، موظف موارد بشرية)
** الوظائف الأساسية:**
- إضافة وتعديل وحذف بيانات المتدربين
- البحث والتصفية المتقدمة
- إنشاء الشهادات تلقائياً
- تصدير البيانات (PDF, Excel)
- إحصائيات ولوحة معلومات
---
## المستخدمون المستهدفون
## Utilisateurs Cibles
### **1. المدير (Administrateur)**
**الصلاحيات:**
- إدارة كاملة للمتدربين
- إدارة المستخدمين والصلاحيات
- الوصول إلى الإحصائيات المتقدمة
- تصدير التقارير
- إعدادات النظام
### **2. موظف الموارد البشرية (Employé RH)**
**الصلاحيات:**
- إضافة وتعديل بيانات المتدربين
- البحث والاستعلام
- إنشاء الشهادات
- تصدير قوائم المتدربين
- لا يمكنه إدارة المستخدمين
---
## ️ التقنيات المستخدمة
## Technologies Utilisées
### **️ الواجهة الخلفية (Backend)**
- **اللغة:** PHP 8.0
- **الإطار:** Laravel Framework
- **المعمارية:** MVC (Model-View-Controller)
- **قاعدة البيانات:** MySQL / SQLite
- **ORM:** Eloquent
### ** الواجهة الأمامية (Frontend)**
- **HTML5:** هيكل الصفحات
- **CSS3:** التنسيق والتصميم
- **JavaScript:** التفاعلية
- **Bootstrap 5:** إطار التصميم المتجاوب
- **AJAX:** التحديث الديناميكي
### **️ قاعدة البيانات (Base de Données)**
- **MySQL/SQLite:** تخزين البيانات
- **Migrations:** إدارة هيكل قاعدة البيانات
- **Eloquent ORM:** التعامل مع البيانات
### ** الأدوات والمكتبات (Outils)**
- **XAMPP:** بيئة التطوير المحلية
- **Composer:** إدارة الحزم والتبعيات
- **Maatwebsite/Excel:** تصدير Excel
- **DomPDF:** إنشاء ملفات PDF
- **Git:** التحكم في الإصدارات
---
## الوظائف الرئيسية
## Fonctionnalités Principales
### **1. نظام المصادقة (Authentification) **
- تسجيل الدخول الآمن
- تشفير كلمات المرور (Hashing)
- إدارة الجلسات (Sessions)
- نظام الأدوار والصلاحيات
- حماية CSRF
### **2. إدارة المتدربين (Gestion des Stagiaires) **
- **إضافة متدرب جديد** مع كل البيانات الضرورية
- **عرض قائمة المتدربين** في جدول منظم
- **تعديل المعلومات** بسهولة
- **حذف المتدربين** مع تأكيد الأمان
- **رفع الصور** للمتدربين
**البيانات المخزنة:**
- الاسم الكامل (الاسم واللقب)
- رقم بطاقة التعريف الوطنية (CIN)
- العنوان الكامل
- رقم الهاتف
- البريد الإلكتروني
- الجامعة/المعهد
- التخصص/القسم
- تاريخ بداية التدريب
- تاريخ نهاية التدريب
- القطاع/الإدارة
- موضوع التدريب
- الصورة الشخصية
### **3. البحث والتصفية (Recherche et Filtrage) **
- البحث بالاسم
- التصفية حسب القطاع
- التصفية حسب التخصص
- البحث بالتاريخ
- عرض النتائج الفورية
### **4. لوحة المعلومات (Dashboard) **
- **إجمالي عدد المتدربين**
- **التوزيع حسب القطاعات**
- **المتدربون المنتهية تدريباتهم قريباً**
- **إحصائيات شهرية**
- **رسوم بيانية ومؤشرات**
### **5. إنشاء الشهادات (Génération d'Attestations) **
- **إنشاء تلقائي** لشهادات التدريب
- **قوالب احترافية** جاهزة
- **تصدير بصيغة PDF**
- **طباعة مباشرة**
- **شعار الشركة** على الشهادة
### **6. التصدير (Exportation) **
- **تصدير Excel:** قائمة كاملة بالمتدربين
- **تصدير PDF:** تقارير وشهادات
- **طباعة القوائم**
- **تصدير حسب الفترة** الزمنية
### **7. إدارة المستخدمين (Gestion des Utilisateurs) **
*(للمدير فقط)*
- إضافة مستخدمين جدد
- تعديل الأدوار والصلاحيات
- تعطيل/تفعيل الحسابات
- عرض سجل الأنشطة
---
## الخلاصة
## Conclusion
هذا المشروع يمثل **حلاً عصرياً ومتكاملاً** لإدارة المتدربين في الشركة التونسية للكهرباء والغاز. يجمع التطبيق بين **السهولة في الاستخدام** و**الأمان** و**الكفاءة**، مما يوفر قيمة حقيقية للمؤسسة ويحسن من إنتاجية موظفي الموارد البشرية.
من خلال هذا المشروع، تم **تطبيق المعارف النظرية** المكتسبة خلال التكوين في **بيئة عمل حقيقية**، مما أتاح فرصة لـ **اكتساب خبرة مهنية قيمة** وتطوير **كفاءات تقنية ومهنية** متعددة.
---