Tableau de bord

La page d'accueil de l'ERP. En un coup d'œil : combien de clients, le chiffre d'affaires encaissé, ce qui reste à régler, et les derniers mouvements. Tout se charge automatiquement à l'ouverture.

/ /api/stats dashboard.view core

À quoi sert ce module

Le tableau de bord est l'écran d'atterrissage de l'application : c'est la première page affichée après connexion, à la racine /. Il agrège, en lecture seule, les chiffres dispersés dans les autres modules (Clients, Factures, Devis, Récurrents) pour donner une photographie instantanée de la santé commerciale de l'entreprise — sans avoir à ouvrir chaque module un par un.

Il s'adresse à tout le monde : un commercial y suit ses ventes, un dirigeant son chiffre d'affaires, un comptable les impayés. C'est un module cœur (core) : il ne peut pas être désactivé depuis Paramètres → Modules, au même titre que les Paramètres eux-mêmes.

Données vivantes, jamais figées Aucune valeur n'est saisie ici. Chaque indicateur est recalculé à la volée depuis la base à chaque ouverture de page (endpoint /api/stats). Si un module source manque, sa tuile affiche simplement zéro — le reste du tableau de bord reste fonctionnel.

Vue d'ensemble de l'écran

https://erp.entreprise.fr/

Tableau de bord

Bienvenue, Camille 👋

Clients actifs

128

Gérer →

CA Total

214 580 €

payé

Factures impayées

9 380 €

6 en attente

Devis en attente

à relancer

Chiffre d'affaires — 2026Mensuel · Comparer N-1

Répartition des factures

Payée 42 Envoyée 11 En retard 6 Brouillon 4

Activité récente

FAC-2026-0142 · Dupont SAS · Payée

DEV-058 · Martin & Co · Envoyé

Paiements récurrents

Abonnement mensuel · 1 200 € TTC

Quatre tuiles d'indicateurs en haut, le graphique de chiffre d'affaires et la répartition des factures au centre, puis l'activité récente et les paiements récurrents en bas. Les tuiles « Gérer → » renvoient directement vers le module concerné.

Les indicateurs clés (KPI)

La rangée supérieure expose quatre tuiles, calculées en direct par le module. Chacune offre un raccourci « Gérer » vers le module qui la nourrit.

Tuile	Ce qu'elle compte	Source	Raccourci
Clients actifs	Nombre total de fiches client enregistrées.	Table `clients`	Clients
CA Total	Somme des montants TTC des factures au statut Payée uniquement. Le chiffre d'affaires encaissé, pas le facturé.	Factures `status='paid'`	—
Factures impayées	Nombre et montant cumulé des factures Envoyées ou En retard — l'argent attendu mais non reçu.	Factures `sent` + `overdue`	Factures (ancre impayés)
Devis en attente	Nombre de devis aux statuts Brouillon ou Envoyé — les propositions encore ouvertes à relancer.	Devis `draft` + `sent`	Devis (ancre envoyés)

« CA Total » = encaissé, pas facturé Une facture émise mais pas encore réglée ne compte PAS dans le CA Total : elle apparaît dans « Factures impayées ». C'est volontaire — le tableau de bord distingue ce que vous avez vraiment touché de ce qui reste à percevoir.

Chiffre d'affaires

Le grand graphique présente l'évolution du chiffre d'affaires encaissé (factures payées) sur l'année. Il est entièrement réglable via les menus en haut à droite de la carte.

Type de graphique: Barres ou Courbe — purement visuel, n'affecte pas les chiffres.
Granularité: Mensuel (12 mois), Trimestriel (T1–T4), Semestriel (S1/S2) ou Annuel (les 5 dernières années).
Cumul: Affiche l'évolution cumulée sur la période plutôt que période par période.
Comparer N-1: Superpose la même période de l'année précédente, et affiche l'écart en pourcentage. Indisponible en granularité annuelle.

L'année de référence n'est pas forcément l'année calendaire : le module retient l'année de la dernière facture payée. Si vous n'avez encaissé aucune facture en 2026, le graphique s'ouvrira sur 2025 pour rester pertinent.

Calcul par plage de dates Le CA d'un mois additionne les factures payées dont la date d'encaissement (paiement, sinon émission, sinon création) tombe dans le mois. La comparaison N-1 utilise exactement la plage équivalente de l'année précédente — comparaison juste, de date à date.

Répartition des factures

Le graphique en anneau (donut) ventile toutes vos factures par statut, avec une légende chiffrée. Cinq catégories sont suivies :

Payée Envoyée En retard Brouillon Annulée

C'est le complément visuel de la tuile « Factures impayées » : d'un regard, vous voyez la proportion de factures réglées contre celles en souffrance. Le bouton Gérer → ouvre le module Factures.

Activité récente

La carte « Activité récente » liste les cinq derniers mouvements, factures et devis confondus, triés du plus récent au plus ancien. Chaque ligne indique le type de pièce, son numéro, le client concerné, son statut (avec une pastille colorée) et son montant. C'est le fil d'actualité de votre facturation.

Paiements récurrents

La carte « Paiements récurrents » affiche les abonnements et facturations automatiques actifs (client, montant HT/TTC). Le raccourci Gérer → mène au module Récurrents pour les configurer.

Accès programmatique : /api/stats

Les tuiles et graphiques sont alimentés par un unique endpoint, accessible aux comptes disposant de dashboard.view :

GET /api/stats: Renvoie l'ensemble des métriques : totaux, série mensuelle, répartition par statut, activité récente et récurrents actifs.
GET /api/stats?resource=revenue: Renvoie uniquement la série de chiffre d'affaires. Paramètres : period (month|quarter|semester|year), compare (1/0 pour N-1), year (année visée). Utilisé par les menus du graphique.

Permissions

Une seule permission gouverne ce module. Sans elle, le compte est redirigé vers sa page d'accueil par défaut.

Clé	Autorise
`dashboard.view`	Voir le tableau de bord et appeler /api/stats. Lecture seule — il n'existe aucune action d'écriture.

La gestion fine des rôles est décrite dans Rôles & permissions.

Liens utiles

Tuile Clients → Clients
Tuiles CA / Impayées et répartition → Factures
Tuile Devis en attente → Devis
Carte Paiements récurrents → Récurrents