EduLib — Bibliothèque Universitaire

Guide d'installation complet

---

📁 Structure du projet

edulib/
├── includes/
│   └── config.php          ← Configuration BDD + fonctions PHP
├── api/
│   ├── emprunter.php        ← API : emprunter un livre (AJAX)
│   └── favori.php           ← API : toggle favori (AJAX)
├── admin/
│   ├── index.php            ← Dashboard admin (avec Chart.js)
│   ├── livres.php           ← CRUD livres
│   └── emprunts.php         ← Gestion emprunts
├── uploads/
│   └── livres/              ← Images de couverture uploadées
├── index.php                ← Catalogue (étudiant)
├── login.php                ← Connexion
├── register.php             ← Inscription
├── emprunts.php             ← Mes emprunts (étudiant)
├── evenements.php           ← Événements (étudiant)
├── logout.php               ← Déconnexion
└── edulib.sql               ← Base de données complète

---

🚀 Installation (XAMPP)

Étape 1 — Copier le projet

Copiez le dossier edulib/ dans :

C:\xampp\htdocs\edulib\

Étape 2 — Démarrer XAMPP

• Ouvrez XAMPP Control Panel
• Démarrez Apache et MySQL

Étape 3 — Importer la base de données

1. Allez sur http://localhost/phpmyadmin
2. Cliquez sur Importer (en haut)
3. Cliquez Choisir un fichier → sélectionnez edulib.sql
4. Cliquez Importer en bas de page
5. ✅ La base edulib est créée automatiquement

Étape 4 — Vérifier la config

Ouvrez includes/config.php et vérifiez :

define('DB_HOST', 'localhost');
define('DB_NAME', 'edulib');
define('DB_USER', 'root');
define('DB_PASS', '');  // Votre mot de passe MySQL si nécessaire
define('SITE_URL', 'http://localhost/edulib');

Étape 5 — Permissions uploads

Vérifiez que le dossier uploads/livres/ est accessible en écriture.

Étape 6 — Accéder au site

• Site étudiant : http://localhost/edulib/
• Administration : http://localhost/edulib/admin/

---

🔑 Comptes de démonstration

Rôle	Email	Mot de passe
Admin	admin@edulib.ma	admin123
Étudiant	hamza@edulib.ma	etudiant123
Étudiant	sara@edulib.ma	etudiant123
Étudiant	youssef@edulib.ma	etudiant123

---

✨ Fonctionnalités implémentées

Espace Étudiant

• ✅ Inscription / Connexion sécurisée (password_hash)
• ✅ Catalogue de livres avec recherche en temps réel (AJAX)
• ✅ Filtre par catégorie et disponibilité
• ✅ Emprunt de livres (limite : 3 simultanés, 14 jours)
• ✅ Suivi des emprunts avec barre de progression
• ✅ Détection automatique des retards
• ✅ Système de favoris (toggle AJAX)
• ✅ Inscription aux événements
• ✅ Notifications non-lues
• ✅ Alertes retards en rouge

Espace Administrateur

• ✅ Dashboard avec graphiques (Chart.js)
  • Emprunts par mois (bar chart)
  • Livres par catégorie (donut chart)
  • Top 5 livres les plus empruntés
• ✅ CRUD complet des livres (ajout/modification/suppression)
• ✅ Upload d'images de couverture
• ✅ Gestion des emprunts (filtres, retours)
• ✅ Mise à jour automatique des retards

Sécurité

• ✅ Requêtes PDO préparées (anti injection SQL)
• ✅ Protection XSS (htmlspecialchars)
• ✅ Sessions sécurisées
• ✅ Vérification des rôles (admin/étudiant)

---

🛠️ Technologies utilisées

Technologie	Usage
PHP 8+	Backend, logique métier
MySQL	Base de données
PDO	Connexion sécurisée à la BDD
HTML5/CSS3	Interface utilisateur
JavaScript	AJAX, interactivité
Chart.js	Graphiques admin
Google Fonts	Typographie (Syne + DM Sans)

---

📝 Pour votre PFE — Points à mentionner

1. Architecture MVC-like : séparation config/api/vues
2. Sécurité : PDO + password_hash + protection XSS
3. AJAX : recherche temps réel, favoris sans rechargement
4. Responsive : adapté desktop
5. Graphiques : Chart.js pour les statistiques admin
6. Gestion des rôles : admin vs étudiant
7. Workflow complet : emprunt → retard → retour

---

EduLib — Projet PFE Bibliothèque Universitaire