Documentation — Rapports

Génération de rapports d'entreprise à partir de modèles : modèle de données, fonctionnement et points d'intégration en production.

Modèle de données

Un modèle de rapport décrit une source de données, des colonnes et des visualisations. Un rapport généré est l'instanciation d'un modèle sur une période : il fige le périmètre (modèle + période + horodatage + auteur) et sert de base à l'aperçu et à l'export CSV.

{
  "modele": "ca-mensuel",        // ca-mensuel | commandes-region | effectifs-service
  "periode": "s1-2025",          // annee-2025 | s1-2025 | s2-2025
  "nom": "Chiffre d'affaires mensuel — S1 2025",
  "genereLe": "2026-06-10T09:12:00",
  "auteur": "Claire Morel"
}

Modèles fournis

  • Chiffre d'affaires mensuel — 12 mois de CA 2025 avec comparatif 2024 : courbe (bpm.lineChart), tableau des variations N-1 et métriques (total période, meilleur mois, variation vs 2024).
  • Commandes par région — 6 régions françaises : volume de commandes et panier moyen par semestre, barres (bpm.barChart), CA estimé par région.
  • Effectifs par service — 5 services : effectif, ETP et turnover par semestre, avec turnover annuel consolidé sur l'année.

Fonctionnement

  • Générer — le couple modèle + période est validé, la période filtre réellement les données (S1 = janvier–juin, S2 = juillet–décembre), le rapport est ajouté en tête de l'historique et l'aperçu s'affiche (métriques, graphique, tableau).
  • Afficher — recharge l'aperçu d'un rapport déjà généré, avec son périmètre d'origine.
  • Télécharger CSV — export réel côté navigateur (Blob + lien de téléchargement), séparateur « ; » et BOM UTF-8 pour Excel français.
  • Supprimer — confirmation explicite (bpm.confirmModal) avant retrait de l'historique.

Intégration en production

Le simulateur fonctionne en local (état React seedé, données déterministes). Pour brancher un vrai backend : exposer chaque modèle comme une requête sur vos sources (ERP pour le CA, OMS/CRM pour les commandes, SIRH pour les effectifs), persister les rapports générés (table generated_reports : modèle, période, horodatage, auteur, snapshot des données), produire le CSV côté serveur pour les gros volumes et archiver les fichiers dans votre stockage documentaire. L'historique « Rapports générés » correspond alors à un simple SELECT trié par date de génération.

Ouvrir le simulateur