# Gestion des clients

### 📒 Documentation – Module Clients (Fatouraty)

#### 1. Accès au module Clients

* Dans le menu latéral gauche, cliquez sur **Clients**.
* Cela affiche la liste des clients existants de l’entreprise sélectionnée.

***

#### 2. Ajouter un nouveau client

Cliquez sur le bouton **« Ajouter »** en haut à droite de la liste des clients. Une fenêtre modale s’ouvre avec les champs suivants à remplir :

**📝 Champs du formulaire :**

| Champ                   | Description                                                   |
| ----------------------- | ------------------------------------------------------------- |
| **Nom de client**       | Nom de la personne ou de l’entreprise. Obligatoire.           |
| **Numéro de téléphone** | Numéro de téléphone du client (ex: 25 620 429).               |
| **Type**                | Type de client : `particulier` ou `entreprise`.               |
| **Adresse**             | Adresse complète du client.                                   |
| **Code client**         | Généré automatiquement (ex : `1`, `2`…), identifiant interne. |
| **Email**               | Adresse e-mail du client (ex : <exemple@gmail.com>).          |
| **Matricule fiscale**   | Numéro fiscal, requis pour les clients professionnels.        |

**Actions :**

* **Enregistrer** : Ajoute le client à la base de données.
* **Annuler** : Ferme la fenêtre sans enregistrer.

***

#### 3. Consultation de la liste des clients

Une fois les clients ajoutés, ils apparaissent dans un tableau avec les colonnes suivantes :

| Colonne                 | Description                                                               |
| ----------------------- | ------------------------------------------------------------------------- |
| **Référence**           | Numéro d'identification unique (ex: 2).                                   |
| **Nom**                 | Nom du client.                                                            |
| **Nombre des factures** | Affiche le nombre de factures associées (peut être vide « – » si aucune). |
| **Email**               | Adresse mail du client.                                                   |
| **Matricule fiscale**   | Affiché en abrégé (ex: MF).                                               |
| **Téléphone**           | Numéro de téléphone.                                                      |
| **Type**                | Particulier ou entreprise.                                                |
| **Actions**             | Deux icônes : ✏️ pour modifier, 🗑️ pour supprimer.                       |

***

#### 4. Recherche et filtrage

* Vous pouvez **rechercher un client** par son nom ou e-mail via la barre de recherche.
* **Filtrer par type** : entreprise ou particulier via le menu déroulant « Filtrer par type ».

***

#### 5. Exportation des données

* Un bouton **« Exporter Excel »** permet de télécharger la liste des clients au format Excel (.xlsx).
