👑 Système de rôles utilisateurs

🎯 Nouveauté : Gestion des permissions par rôles !

Vous pouvez maintenant attribuer différents niveaux d'accès à vos utilisateurs.

📊 Les 3 rôles disponibles

👑 Administrateur

Accès complet au système

✅ Gérer les utilisateurs (créer, modifier, supprimer)
✅ Créer et modifier des factures
✅ Gérer les clients
✅ Gérer les produits/services
✅ Accéder aux paramètres
✅ Toutes les fonctionnalités

Utilisez ce rôle pour : Les responsables qui doivent gérer l'équipe

---

📊 Gestionnaire (par défaut)

Gestion opérationnelle

✅ Créer et modifier des factures
✅ Gérer les clients
✅ Gérer les produits/services
✅ Envoyer des factures par email
✅ Générer des PDF
❌ Ne peut PAS gérer les utilisateurs

Utilisez ce rôle pour : Les employés qui travaillent quotidiennement sur les factures

---

👁️ Lecteur

Consultation uniquement (lecture seule)

✅ Voir les factures
✅ Voir les clients
✅ Voir les produits
✅ Consulter les statistiques
❌ Ne peut PAS créer ou modifier
❌ Ne peut PAS supprimer
❌ Ne peut PAS gérer les utilisateurs

Utilisez ce rôle pour : Les comptables, superviseurs qui doivent consulter sans modifier

---

🚀 Installation - IMPORTANT

1️⃣ Première étape : Ajouter la colonne "role" à la base de données

Si vous avez déjà des utilisateurs existants, vous DEVEZ exécuter le script de migration :

Allez sur : www.web.proinfo83.fr/pages/admin/add-user-roles.php
Le script va ajouter la colonne role à votre table users
Votre premier utilisateur sera automatiquement défini comme Administrateur
Une fois terminé, vous pouvez supprimer le fichier add-user-roles.php

2️⃣ Créer de nouveaux utilisateurs avec des rôles

Allez dans "🔐 Utilisateurs"
Cliquez sur "+ Nouvel utilisateur"
Remplissez les informations
Choisissez le rôle dans la liste déroulante
Créez l'utilisateur

---

📋 Tableau des permissions

|---|:---:|:---:|:---:|

| Voir les factures | ✅ | ✅ | ✅ |

| Créer des factures | ✅ | ✅ | ❌ |

| Modifier des factures | ✅ | ✅ | ❌ |

| Supprimer des factures | ✅ | ✅ | ❌ |

| Envoyer par email | ✅ | ✅ | ❌ |

| Gérer les clients | ✅ | ✅ | ❌ |

| Gérer les produits | ✅ | ✅ | ❌ |

| Gérer les utilisateurs | ✅ | ❌ | ❌ |

| Voir les statistiques | ✅ | ✅ | ✅ |

| Modifier les paramètres | ✅ | ✅ | ❌ |

---

🎨 Badges de rôles

Dans la liste des utilisateurs, chaque rôle est identifié par un badge coloré :

👑 Administrateur : Badge doré avec dégradé jaune/orange
📊 Gestionnaire : Badge bleu avec dégradé cyan
👁️ Lecteur : Badge violet avec dégradé

---

💡 Cas d'usage recommandés

Petite entreprise (1-3 personnes)

1 Administrateur : Le gérant
1-2 Gestionnaires : Les employés qui créent les factures

Moyenne entreprise (4-10 personnes)

1-2 Administrateurs : Direction
3-6 Gestionnaires : Service commercial/facturation
1-2 Lecteurs : Service comptabilité

Grande organisation (10+ personnes)

2-3 Administrateurs : Direction + Responsable IT
5-10 Gestionnaires : Équipe commerciale
3-5 Lecteurs : Comptabilité, audit, superviseurs

---

🔒 Sécurité

✅ Les rôles sont vérifiés côté serveur (PHP)
✅ Un utilisateur ne peut pas changer son propre rôle
✅ Seuls les administrateurs peuvent gérer les utilisateurs
✅ Les permissions sont appliquées en temps réel

---

❓ FAQ

Q : Puis-je changer le rôle d'un utilisateur existant ?

R : Pas encore, mais cette fonctionnalité sera ajoutée. Pour l'instant, vous pouvez le faire manuellement en base de données ou supprimer/recréer l'utilisateur.

Q : Que se passe-t-il si je supprime le dernier administrateur ?

R : Soyez prudent ! Gardez toujours au moins 1 administrateur. Sinon, vous devrez modifier la base de données manuellement.

Q : Un gestionnaire peut-il voir les autres utilisateurs ?

R : Non, seuls les administrateurs ont accès au menu "Utilisateurs".

Q : Un lecteur peut-il générer des PDF ?

R : Oui, un lecteur peut voir et imprimer les factures en PDF, mais ne peut pas les modifier.

---

📝 Fichiers modifiés

✅ users.php - Ajout du sélecteur de rôle et affichage
✅ config-db.php - Table users mise à jour avec colonne role
✅ admin-style.css - Styles des badges de rôles
✅ add-user-roles.php - Script de migration (à exécuter une fois)

---

🎉 Profitez de votre nouveau système de gestion des permissions !