> ## Documentation Index
> Fetch the complete documentation index at: https://docs.e4-bizz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Statistiques

> Tableaux de bord et analytics des ventes, clients et produits dans PEPSiMAD.

# Statistiques

Le module **Statistiques** fournit une vue complète de la performance commerciale de votre activité avec des graphiques détaillés et des indicateurs clés.

<Note>
  Le module Statistiques est accessible aux **administrateurs et commerciaux**.
</Note>

***

## Accéder aux statistiques

Cliquez sur **Statistiques** dans le menu latéral pour accéder au tableau de bord.

***

## Sélecteur de période

### Filtre de période

En haut de la page, un **dropdown de période** permet de sélectionner l'intervalle temporel des données affichées.

#### Options disponibles

| Option                 | Plage            | Défaut |
| ---------------------- | ---------------- | :----: |
| **6 derniers mois**    | 6 derniers mois  |    ✓   |
| **12 derniers mois**   | 12 derniers mois |        |
| **2 dernières années** | 24 derniers mois |        |
| **3 dernières années** | 36 derniers mois |        |

<Steps>
  <Step title="Cliquer sur le dropdown de période">
    Affichage des 4 options.
  </Step>

  <Step title="Sélectionner la période souhaitée">
    Les graphiques se rechargent avec les données de la période sélectionnée.
  </Step>

  <Step title="Partager l'URL">
    La période est sauvegardée dans l'URL, vous pouvez la partager.
  </Step>
</Steps>

***

## Chargement des données

Lors du changement de période, un indicateur de chargement s'affiche :

* Les graphiques sont remplacés par des formes de chargement
* Le chargement dure quelques secondes (optimisé avec cache)
* Les graphiques réapparaissent automatiquement une fois les données chargées

***

## Graphique 1 : Chiffre d'affaires mensuel

### Description

Ce graphique en **barres verticales** affiche le chiffre d'affaires réalisé chaque mois.

### Axes

**Axe X (horizontal)** :

* Mois abrégé + année
* Ex: "Jan 25", "Fév 25", "Mar 25"

**Axe Y (vertical)** :

* Montant en euros
* Format abrégé pour les milliers : "1k", "2.5k", "10k"

### Indicateurs clés

Affichés au-dessus du graphique :

| Indicateur              | Description                                                          |
| ----------------------- | -------------------------------------------------------------------- |
| **Total de la période** | Somme totale du chiffre d'affaires sur toute la période sélectionnée |
| **Moyenne mensuelle**   | Chiffre d'affaires moyen par mois                                    |

### Interaction

**Survol d'une barre** :

* Mois complet (ex: "Février 2025")
* Total exact du mois (ex: "12 456,78 €")

### Données incluses

* Commandes validées uniquement
* Montants hors taxe
* Si pas de commande : aucune barre affichée pour ce mois

***

## Graphique 2 : Top 10 clients par chiffre d'affaires

### Description

Graphique en **barres horizontales** affichant les 10 clients avec le plus haut chiffre d'affaires.

### Axes

**Axe Y (vertical)** :

* Nom du client
* Tronçué à 20 caractères max si trop long

**Axe X (horizontal)** :

* Montant en euros (format abrégé : "1k", "2.5k", "50k")

### Ordre

Les clients sont triés du plus haut chiffre d'affaires au plus bas.

### Indicateur clé

Affiché au-dessus :

* **Total du Top 10** : Somme du chiffre d'affaires des 10 clients affichés

### Interaction

**Survol de chaque barre** :

* Nom complet du client
* Chiffre d'affaires total
* Nombre de commandes

### Données incluses

* Clients avec au moins 1 commande validée
* Si moins de 10 clients : affichage de tous les clients disponibles
* Montants hors taxe

### Cas limites

* **Pas de clients** : Affichage du message "Aucune donnée disponible"
* **Un seul client** : Affichage d'une seule barre

***

## Graphique 3 : Répartition par famille de produits

### Description

Graphique en **diagramme circulaire** affichant la répartition du chiffre d'affaires par famille de produits.

### Légende

Affichée à droite du diagramme avec :

| Élément               | Description                             |
| --------------------- | --------------------------------------- |
| **Carré coloré**      | Couleur de la famille                   |
| **Nom de la famille** | Libellé de la famille produit           |
| **Pourcentage**       | Pourcentage du chiffre d'affaires total |

**Nombre de familles** : 8 familles maximum affichées dans la légende.

Si plus de 8 familles :

* Les 8 plus grandes sont listées
* Un message "+N autres familles" indique le nombre non affiché

### Interaction

**Survol d'une section** :

* Nom complet de la famille
* Montant exact
* Pourcentage du total

### Données incluses

* Toutes les familles de produits avec au moins 1 commande
* Montants hors taxe
* Commandes validées uniquement

### Cas limites

* **Une seule famille** : Affichage d'un cercle complet de 100%
* **Pas de données** : Affichage du message "Aucune donnée disponible"

***

## Layout et responsive design

### Desktop (écran large)

* Les 3 graphiques sont affichés en grille
* Chaque graphique occupe une hauteur minimale convenable
* Espacement régulier entre les graphiques

### Mobile (petit écran)

* Les graphiques s'empilent en colonne unique
* Chacun occupe la largeur totale
* Scrolling vertical pour voir tous les graphiques

***

## État vide et erreurs

### Aucune donnée

Si aucune commande n'existe pour la période sélectionnée :

Affichage pour chaque graphique :

* Message centré : "Aucune donnée disponible"
* Suggestion : "Changez la période ou créez une commande"

### Erreur de chargement

En cas d'erreur serveur :

* Message : "Erreur lors du chargement des données"
* Bouton "Réessayer" pour relancer la requête

***

## Cas d'usage courants

### Analyser les performances du dernier trimestre

<Steps>
  <Step title="Sélectionner 3 dernières années">
    Vue plus longue pour identifier les tendances saisonnières.
  </Step>

  <Step title="Consulter le chiffre d'affaires mensuel">
    Identifier les mois les plus forts et les creux.
  </Step>

  <Step title="Analyser le Top 10">
    Voir quels clients génèrent le plus de chiffre d'affaires.
  </Step>

  <Step title="Examiner les familles">
    Déterminer les catégories produits les plus rentables.
  </Step>
</Steps>

### Valider la croissance année sur année

<Steps>
  <Step title="Sélectionner 2 dernières années">
    Obtenir exactement 24 mois de données.
  </Step>

  <Step title="Comparer les mois identiques">
    Janvier année précédente vs Janvier actuellement, etc.
  </Step>

  <Step title="Calculer la croissance">
    (Chiffre d'affaires actuel - Chiffre d'affaires année précédente) / Chiffre d'affaires année précédente × 100
  </Step>

  <Step title="Valider la tendance">
    Croissance positive ou baisse à investiguer.
  </Step>
</Steps>

### Identifier le produit best-seller

<Steps>
  <Step title="Sélectionner la période de référence">
    Par défaut 6 mois.
  </Step>

  <Step title="Consulter la répartition produits">
    Diagramme circulaire affichant les familles.
  </Step>

  <Step title="Identifier le plus gros segment">
    Plus grande section = best-seller.
  </Step>

  <Step title="Survoler pour le détail">
    Voir montant exact et pourcentage.
  </Step>
</Steps>

### Préparer une présentation commerciale

<Steps>
  <Step title="Sélectionner la période">
    Par exemple 12 mois pour une vue annuelle.
  </Step>

  <Step title="Capture les graphiques">
    Capture d'écran des résultats.
  </Step>

  <Step title="Présenter aux stakeholders">
    Montrer les tendances de ventes et clients importants.
  </Step>
</Steps>

***

## Données source

### Filtrage des commandes

Seules les commandes **validées** (non annulées) sont incluses.

### Montants inclus

* **Montants hors taxe uniquement**
* TVA non incluse
* Frais de port/urgence non inclus

### Période exacte

* La période sélectionnée inclut exactement N mois complets (du passé jusqu'à aujourd'hui)
* Exemple : Si aujourd'hui est 22 février 2025, "6 derniers mois" = 22 août 2024 à 22 février 2025

### Regroupement

* **Par mois civil** : Groupement par mois calendaire
* **Par client** : Groupement par client unique
* **Par famille produit** : Groupement par catégorie produit

***

## Bonnes pratiques

<Tip>
  **Vérifiez la période** : Assurez-vous que la période sélectionnée couvre bien le délai d'analyse avant de tirer des conclusions.
</Tip>

<Tip>
  **Investiguer les anomalies** : Un mois vide ou une baisse inattendue ? Allez vérifier les commandes dans le module Commandes.
</Tip>

<Tip>
  **Comparez les années** : Utilisez la période "2 dernières années" pour comparer année sur année et identifier les tendances saisonnières.
</Tip>

<Tip>
  **Attention à la concentration** : Une concentration trop élevée chez quelques clients = risque. Diversifiez !
</Tip>

<Tip>
  **Analyser les familles produits** : Identifiez les best-sellers et les segments peu exploités pour ajuster votre stratégie.
</Tip>

***

## Messages et états

### Chargement

"Chargement des statistiques..."

### Succès

Les graphiques s'affichent automatiquement une fois les données chargées.

### Erreurs

| Erreur                                  | Cause                           | Solution                                                              |
| --------------------------------------- | ------------------------------- | --------------------------------------------------------------------- |
| "Erreur lors du chargement des données" | Erreur serveur                  | Cliquez sur "Réessayer". Contactez le support si le problème persiste |
| "Aucune donnée disponible"              | Pas de commande dans la période | Sélectionnez une période plus large ou créez des commandes            |
| "Impossible d'accéder aux statistiques" | Permissions insuffisantes       | Vérifiez votre rôle (Admin ou commercial uniquement)                  |

***

## Limitations actuelles et évolutions à venir

### Limitations actuelles

* Export PDF des graphiques (en développement)
* Filtrage avancé par client/famille (simple période pour le moment)
* Comparaison multi-périodes côte à côte (une seule période à la fois)

### En développement

* Export graphiques en PNG/PDF
* Rapport email mensuel automatisé
* Filtres additionnels (par client, par prescripteur, par région)
* Détection automatique des anomalies et alertes

***

## Questions fréquentes

**Q: Pourquoi les montants ne correspondent-ils pas à ma comptabilité ?**
A: Les statistiques affichent les montants hors taxe des commandes validées. Elles n'incluent pas TVA ni frais. Consultez le module Commandes pour les montants complets.

**Q: Comment puis-je exporter les données pour Excel ?**
A: La fonctionnalité d'export est en développement. Vous pouvez exporter les commandes brutes depuis le module Commandes.

**Q: Les données incluent-elles les devis ?**
A: Non. Les statistiques concernent uniquement les **commandes validées**. Les devis sont exclus.

**Q: Quelle est la fréquence de mise à jour ?**
A: Les données sont mises à jour en temps quasi-réel. Un rafraîchissement manuel est possible via F5.

**Q: Puis-je voir les statistiques par collaborateur ?**
A: Non actuellement. Les stats sont globales. Cette fonctionnalité est prévue.
