Outils pour utilisateurs

Outils du site


ujusum:1-implantation:11-reporting-bi

Table des matières

Sprint 10 — Reporting & Business Intelligence

Objectif du Sprint

Mettre en œuvre une couche décisionnelle complète permettant aux dirigeants, responsables d'agence, gestionnaires et commerciaux de piloter l'activité en temps réel.

À l'issue du Sprint 10 :

  • Les indicateurs clés sont consolidés
  • Les tableaux de bord sont personnalisables
  • Les performances commerciales sont mesurées
  • Les performances locatives sont analysées
  • Les revenus sont prévisionnels
  • Les exports décisionnels sont disponibles
  • Les propriétaires disposent de statistiques avancées

Ce sprint clôture la première phase de maturité fonctionnelle de la plateforme.


Périmètre

Modules concernés

ReportingModule

DashboardModule

AnalyticsModule

ExportsModule

ForecastModule

KpiModule

Architecture décisionnelle

PostgreSQL

↓

Reporting Views

↓

Analytics Engine

↓

Dashboards

↓

Exports

Workflow métier

Collecte données

↓

Agrégation

↓

Calcul KPI

↓

Visualisation

↓

Export

User Stories

US-1001 : Consulter le tableau de bord général

En tant que directeur d'agence

Je souhaite disposer d'une vue synthétique

Afin de piloter mon activité.


Endpoint

GET /reporting/dashboard

KPI affichés

CA du mois

CA annuel

Réservations

Occupation

Contrats signés

Paiements encaissés

US-1002 : Consulter les revenus

Endpoint

GET /reporting/revenues

Analyses

Mensuelle

Trimestrielle

Annuelle

Comparative N-1

US-1003 : Consulter les performances commerciales

Endpoint

GET /reporting/sales

KPI

Prospects

Conversions

Taux conversion

CA commercial

Réservations générées

US-1004 : Consulter les performances des biens

Endpoint

GET /reporting/properties

Statistiques

Occupation

CA

Nombre réservations

Prix moyen

Durée moyenne séjour

US-1005 : Consulter les performances propriétaires

Endpoint

GET /reporting/owners

KPI

Revenus

Occupation

Nombre biens

Réservations

US-1006 : Consulter les statistiques clients

Endpoint

GET /reporting/customers

KPI

Nouveaux clients

Clients actifs

Clients récurrents

Panier moyen

Occupation

US-1007 : Calcul du taux d'occupation

Formule

:contentReference[oaicite:0]{index=0}


Endpoint

GET /reporting/occupancy

Prévisions

US-1008 : Prévisions de revenus

Endpoint

GET /reporting/forecast

Horizon

30 jours

90 jours

12 mois

Données utilisées

Réservations confirmées

Saisonnalité

Historique

Occupation

US-1009 : Prévisions d'occupation

Objectif

Estimer les périodes de forte et faible activité.


Exports

US-1010 : Export Excel

Endpoint

GET /reporting/export/excel

Contenu

KPI

Réservations

Paiements

Factures

Propriétaires

US-1011 : Export PDF

Endpoint

GET /reporting/export/pdf

Utilisation

Direction

Comptabilité

Propriétaires

Tableaux de bord

US-1012 : Dashboard Direction

Widgets

CA

Occupation

Top Biens

Top Propriétaires

Top Clients

Prévisions

US-1013 : Dashboard Commercial

Widgets

Prospects

Conversions

Pipeline

Tâches

Activités

US-1014 : Dashboard Gestionnaire

Widgets

Réservations

Contrats

Paiements

Check-in

Check-out

Statistiques avancées

US-1015 : Top biens

Classement

CA

Occupation

Réservations

US-1016 : Top clients

Critères

Montant dépensé

Nombre séjours

Ancienneté

US-1017 : Top propriétaires

Critères

Revenus

Occupation

Nombre biens

Modèle Prisma

ReportingSnapshot

model ReportingSnapshot {
 
  id                String @id @default(uuid())
 
  snapshotDate      DateTime
 
  revenue           Decimal
 
  occupancyRate     Decimal
 
  reservationCount  Int
 
}

KpiSnapshot

model KpiSnapshot {
 
  id                String @id @default(uuid())
 
  metric            String
 
  value             Decimal
 
  period            String
 
  calculatedAt      DateTime
}

Vues SQL

Revenue View

CREATE VIEW reporting_revenue_summary
AS
SELECT
  YEAR,
  MONTH,
  SUM(total_amount)
FROM reservations
GROUP BY YEAR, MONTH;

Occupancy View

CREATE VIEW reporting_occupancy_summary
AS
SELECT
  property_id,
  occupancy_rate
FROM ...

Architecture Backend

src/modules/reporting

├── dashboard
│
├── analytics
│
├── revenues
│
├── occupancy
│
├── forecasts
│
├── exports
│
└── kpis

Domain Services

DashboardService

AnalyticsService

RevenueService

OccupancyService

ForecastService

ExportService

Événements métier

KpiCalculated

KpiCalculated

ReportGenerated

ReportGenerated

Swagger

Tags

Reporting

Analytics

Forecasts

Exports

Dashboards

Volume API

Environ :

25 endpoints

Frontend

Pages

/reports

/reports/revenues

/reports/occupancy

/reports/properties

/reports/owners

/reports/customers

/reports/forecast

Composants

RevenueChart

OccupancyChart

KpiCard

ForecastChart

PropertyRanking

OwnerRanking

CustomerRanking

Dashboard Direction

KPI

CA

Occupation

Réservations

Paiements

Top Biens

Prévisions

Dashboard Commercial

KPI

Prospects

Conversions

Pipeline

Activités

Objectifs

Dashboard Gestion

KPI

Réservations

Contrats

Paiements

Arrivées

Départs

Tests

Unitaires

RevenueService

ForecastService

OccupancyService

AnalyticsService

Intégration

Paiement

↓

Facture

↓

Agrégation

↓

Reporting

E2E

Connexion

↓

Dashboard

↓

Analyse revenus

↓

Export Excel

↓

Export PDF

Définition de terminé

Le Sprint 10 est terminé lorsque :

  • Dashboards opérationnels
  • KPI opérationnels
  • Reporting financier opérationnel
  • Reporting commercial opérationnel
  • Reporting occupation opérationnel
  • Prévisions opérationnelles
  • Exports opérationnels
  • Swagger à jour
  • Tests verts
  • CI verte

Livrables

  • ReportingModule
  • DashboardModule
  • AnalyticsModule
  • ForecastModule
  • ExportsModule
  • KpiModule
  • DTO
  • Swagger
  • Tests
  • Migrations Prisma

Démonstration Sprint

Scénario métier :

1. Consultation dashboard direction

2. Analyse revenus

3. Analyse occupation

4. Analyse performances biens

5. Analyse performances propriétaires

6. Prévisions

7. Export Excel

8. Export PDF

Bilan Release 2.0

À l'issue du Sprint 10, la plateforme dispose de :

  • Gestion utilisateurs
  • Catalogue immobilier
  • Réservations
  • Contrats électroniques
  • Paiements
  • Facturation
  • Extranet propriétaire
  • CRM
  • Communications
  • Reporting décisionnel

La plateforme couvre désormais l'intégralité du cycle métier d'une agence de location professionnelle.


Phase suivante

La roadmap entre maintenant dans la phase d'industrialisation avancée.

Sprint 11 — Administration & Paramétrage

Objectif :

Permettre à chaque agence de configurer entièrement son environnement.

Modules concernés :

AdministrationModule

AgencySettingsModule

WorkflowModule

CustomFieldsModule

AuditModule

FeatureFlagsModule

Fonctionnalités :

  • Paramétrage agence
  • Paramétrage métier
  • Champs personnalisés
  • Audit complet
  • Journaux système
  • Feature Flags
  • Multi-agence avancé

À l'issue du Sprint 11, la plateforme deviendra entièrement configurable sans intervention technique.

ujusum/1-implantation/11-reporting-bi.txt · Dernière modification : 2026/06/06 03:19 de 91.170.108.99

DokuWiki Appliance - Powered by TurnKey Linux