dla-docs

Rapports

1. Objectif

Le module Rapports fournit des rapports financiers détaillés et vous aide à :

• Afficher l’aperçu financier du mois en cours
• Analyser les revenus et les dépenses
• Suivre les progrès d’épargne
• Prévoir les dépenses de fin de mois
• Afficher les rapports par type (Revenus, Dépenses, Épargne, Prêts)

2. Quand utiliser

Utilisez ce module lorsque vous souhaitez :

• Afficher l’aperçu financier
• Analyser les tendances de dépenses
• Vérifier les progrès de l’objectif d’épargne
• Prévoir le risque de dépassement budgétaire
• Afficher les rapports détaillés par type

3. Écrans associés

• Rapport d’aperçu
• Rapport de revenus
• Rapport de dépenses
• Rapport d’épargne
• Rapport de prêts

4. Utilisation principale

4.1 Afficher le rapport d’aperçu

1. Allez à l’onglet Rapports dans la navigation inférieure
2. Affichez la section Santé financière :
   • Objectif d’épargne et épargne réelle (avec barre de progression et niveau d’atteinte)
   • Flux de trésorerie net avec formule détaillée
   • Budget restant (si le budget a été créé)
   • Rythme de dépenses par rapport au mois précédent (si les données sont disponibles)
   • Obligations de prêt ce mois-ci (le cas échéant)
   • Top 5 des catégories de dépenses par pourcentage
3. Affichez la section Prévision de tendance future (si budget > 0) :
   • Reste attendu à la fin du mois avec formule détaillée
   • Probabilité d’atteinte de l’objectif d’épargne
   • Paiement de prêt à venir (le cas échéant)
4. Appuyez sur les cartes pour faire défiler vers les rapports détaillés correspondants

4.2 Afficher le rapport de revenus

1. Depuis l’écran Rapports, appuyez sur l’élément de menu 💵 Revenus dans la section “Rapports détaillés”
2. Affichez le total des revenus réels ce mois-ci
3. Affichez la section Revenus récurrents : Total, reçus, pas encore reçus, détails pour chaque élément
4. Affichez la section Revenus supplémentaires (le cas échéant) : Total, détails pour chaque élément, % d’augmentation/diminution
5. Affichez la Tendance des revenus sur 3 mois (si suffisamment de données sont disponibles)
6. Affichez l’Historique mensuel des revenus
7. Affichez l’Analyse des revenus (Insights) : Pourcentage, niveau de stabilité, tendances

4.3 Afficher le rapport de dépenses

1. Depuis l’écran Rapports, appuyez sur l’élément de menu 🔥 Dépenses dans la section “Rapports détaillés”
2. Affichez le total des dépenses réelles ce mois-ci avec % d’augmentation/diminution par rapport au mois précédent
3. Affichez la section Dépenses récurrentes : Total, payées, pas encore payées, détails pour chaque élément
4. Affichez la section Dépenses quotidiennes par catégorie : Catégories principales avec montants et pourcentages
5. Affichez la section Poussée de dépenses (si les données du mois précédent sont disponibles)
6. Affichez la Tendance des dépenses sur 3 mois (si suffisamment de données sont disponibles)
7. Affichez l’Historique mensuel des dépenses

4.4 Afficher le rapport budgétaire

1. Depuis l’écran Rapports, appuyez sur l’élément de menu 📉 Budget dans la section “Rapports détaillés” (affiché uniquement lorsque le budget a été créé)
2. Affichez l’Aperçu budgétaire ce mois-ci : Budget mensuel, dépensé (avec répartition), restant, barre de progression
3. Appuyez sur “Budget mensuel” pour afficher la Boîte de dialogue des détails du budget avec la méthode de calcul
4. Affichez la section Écart par rapport au plan : Éléments de revenus et de dépenses avec écarts, écart total
5. Affichez la section Dépenses par catégorie : Total, chaque catégorie avec montant, pourcentage, barre de progression
6. Appuyez sur la catégorie pour afficher la liste des dépenses dans cette catégorie

4.5 Afficher le rapport d’épargne

1. Depuis l’écran Rapports, appuyez sur l’élément de menu 💾 Épargne dans la section “Rapports détaillés” (affiché uniquement lorsque des comptes d’épargne existent)
2. Affichez l’Épargne réelle ce mois-ci avec la formule du flux de trésorerie net
3. Affichez la section Analyse de l’épargne : % du revenu, comparaison avec le mois précédent, prévision de fin de mois
4. Affichez la section Liste des comptes d’épargne : Tous les comptes actifs, triés par date d’échéance la plus proche
5. Affichez le Graphique de croissance de l’épargne sur 6 mois (si plus d’un mois de données est disponible)

4.6 Afficher le rapport de prêts

1. Depuis l’écran Rapports, appuyez sur l’élément de menu 💸 Prêts dans la section “Rapports détaillés” (affiché uniquement lorsque des prêts existent)
2. Affichez l’Aperçu des prêts : Solde de la dette actuelle, coût du prêt ce mois-ci (avec répartition capital + intérêts)
3. Affichez la section Paiement le plus proche : Date d’échéance, statut, jours jusqu’au prochain paiement
4. Affichez la section Calendrier de paiement mensuel : 3 derniers mois avec montants et statut
5. Affichez la section Analyse des prêts (Insights) : Total payé, tendance du solde de la dette, taux d’intérêt, risque de retard de paiement
6. Affichez le Graphique de réduction de la dette sur 6 mois (si plus d’un mois de données est disponible)

5. Exemples et illustrations de l’interface utilisateur

5.1 REPORT-01 : Afficher l’aperçu de la santé financière et la prévision de tendance

Objectif : Afficher l’aperçu financier du mois en cours, y compris les progrès d’épargne, le flux de trésorerie net, le budget restant et la prévision de fin de mois.

Étapes :

1. Allez à l’onglet Rapports dans la navigation inférieure
2. Affichez la section Santé financière :
   • Objectif d’épargne : 540 EUR (20% du revenu)
   • Épargne réelle : 378 EUR
   • Barre de progression : 70% - NIVEAU D’ATTEINTE : MOYEN
   • Flux de trésorerie net : +252 EUR [POSITIF] avec formule détaillée
   • Budget restant : 558 EUR [STABLE] (62% du budget ≈ 60% du temps)
   • Rythme de dépenses : 12% plus élevé que le mois précédent
   • Obligations de prêt : 378 EUR [PAYÉ]
   • Top 5 des catégories : Nourriture (32%), Shopping (25%), Divertissement (18%), Transport (15%), Autre (10%)
3. Affichez la section Prévision de tendance future :
   • Reste attendu à la fin du mois : +207 EUR [EXCÉDENT] avec formule détaillée
   • Probabilité d’atteinte de l’objectif : 82% [PRÈS D’ATTEINDRE]
   • Paiement de prêt à venir : Jour 25 : 378 EUR [FONDS SUFFISANTS]

Schéma filaire :

┌──────────────────────┐  ┌──────────────────────┐
│ 🎯 Objectif d'épargne │  │ 💾 Épargne réelle     │
│ 540 EUR              │  │ 378 EUR              │
│ 20% du revenu        │  │                      │
└──────────────────────┘  └──────────────────────┘

[██████████████----------------------] 70%
NIVEAU D'ATTEINTE : MOYEN

┌────────────────────────────────────────────────────────────┐
│ Flux de trésorerie net = Épargne réelle                   │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ +252 EUR                      [POSITIF]               │ │
│ └────────────────────────────────────────────────────────┘ │
│ Flux de trésorerie net = Revenus (récurrents + supplémentaires)│
│                – Dépenses (récurrentes + quotidiennes + prêt)│
└────────────────────────────────────────────────────────────┘

┌────────────────────────────────────────────────────────────┐
│ 📉 Budget restant                                          │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ 558 EUR                      [STABLE]                  │ │
│ └────────────────────────────────────────────────────────┘ │
│ • 62% du budget ≈ 60% du temps → Dépenses à rythme approprié│
└────────────────────────────────────────────────────────────┘

┌────────────────────────────────────────────────────────────┐
│ 💹 Reste attendu à la fin du mois                          │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ Attendu : +207 EUR             [EXCÉDENT]              │ │
│ └────────────────────────────────────────────────────────┘ │
│ • Dépenses attendues = (Dépenses quotidiennes moyennes × Jours restants)│
│                + (Dépenses fixes en attente)               │
└────────────────────────────────────────────────────────────┘

5.2 REPORT-02 : Afficher le rapport de revenus

Objectif : Afficher l’analyse détaillée des revenus de ce mois, y compris les revenus récurrents, les revenus supplémentaires, les tendances et les insights.

Étapes :

1. Depuis l’écran Rapports, appuyez sur l’élément de menu 💵 Revenus dans la section “Rapports détaillés”
2. Affichez le Total des revenus réels ce mois-ci : 1,890 EUR
3. Affichez la section Revenus récurrents : Total 1,350 EUR (Reçus : 1,170 EUR, Pas encore reçus : 180 EUR), détails pour chaque élément
4. Affichez la section Revenus supplémentaires : Total 540 EUR (Freelance : 270 EUR, Vente d’articles : 90 EUR, Petit bonus : 180 EUR), augmentation de 5% par rapport au mois précédent
5. Affichez la Tendance des revenus sur 3 mois (graphique sparkline)
6. Affichez l’Historique mensuel des revenus : Ce mois, mois précédent, il y a 2 mois
7. Affichez l’Analyse des revenus (Insights) : Pourcentage des revenus récurrents, évaluation de la stabilité, % d’augmentation/diminution

Schéma filaire : Référence à wf-bao-cao-thu-nhap.md

5.3 REPORT-03 : Afficher le rapport de dépenses

Objectif : Afficher l’analyse détaillée des dépenses de ce mois, y compris les dépenses récurrentes, les dépenses quotidiennes par catégorie, les tendances et les catégories de poussée de dépenses.

Étapes :

1. Depuis l’écran Rapports, appuyez sur l’élément de menu 🔥 Dépenses dans la section “Rapports détaillés”
2. Affichez le Total des dépenses réelles ce mois-ci : 1,638 EUR (augmentation de 12% par rapport au mois précédent)
3. Affichez la section Dépenses récurrentes : Total 765 EUR (Payées : 675 EUR, Pas encore payées : 90 EUR), détails pour chaque élément
4. Affichez la section Dépenses quotidiennes par catégorie : Nourriture 585 EUR (36%), Shopping 270 EUR (16%), Transport 189 EUR (12%), Divertissement 126 EUR (8%), Autre 90 EUR (5%)
5. Affichez la section Poussée de dépenses : Nourriture (+108 EUR, +22%), Shopping (+72 EUR, +35%)
6. Affichez la Tendance des dépenses sur 3 mois (graphique sparkline)
7. Affichez l’Historique mensuel des dépenses : Ce mois, mois précédent, il y a 2 mois

Schéma filaire : Référence à wf-bao-cao-chi-tieu.md

5.4 REPORT-04 : Afficher le rapport budgétaire

Objectif : Afficher l’aperçu budgétaire de ce mois, y compris le budget dépensé, restant, l’écart par rapport au plan et les dépenses par catégorie.

Étapes :

1. Depuis l’écran Rapports, appuyez sur l’élément de menu 📉 Budget dans la section “Rapports détaillés”
2. Affichez l’Aperçu budgétaire ce mois-ci :
   • Budget mensuel : 900 EUR (appuyez pour afficher les détails de calcul)
   • Dépensé : 342 EUR (Dépenses quotidiennes : 225 EUR, Écart de dépenses : +45 EUR, Écart de revenus : -18 EUR)
   • Restant : 558 EUR
   • Barre de progression : 38.0% avec texte d’indication dynamique
3. Appuyez sur “Budget mensuel” pour afficher la Boîte de dialogue des détails du budget avec la formule : Budget = Revenus - Dépenses
4. Affichez la section Écart par rapport au plan : Chaque élément de revenus/dépenses avec écart, écart total
5. Affichez la section Dépenses par catégorie : Total, chaque catégorie avec montant, pourcentage, barre de progression
6. Appuyez sur la catégorie pour afficher la liste des dépenses dans cette catégorie

Schéma filaire : Référence à wf-bao-cao-ngan-sach.md

5.5 REPORT-05 : Afficher le rapport d’épargne

Objectif : Afficher l’analyse détaillée de l’épargne de ce mois, y compris l’épargne réelle, l’analyse de l’épargne, la liste des comptes d’épargne et les tendances.

Étapes :

1. Depuis l’écran Rapports, appuyez sur l’élément de menu 💾 Épargne dans la section “Rapports détaillés”
2. Affichez l’Épargne réelle ce mois-ci : 378 EUR avec formule détaillée du flux de trésorerie net
3. Affichez la section Analyse de l’épargne : L’épargne représente 20% du revenu, augmentation de 12% par rapport au mois précédent, prévision de fin de mois : 459 EUR (≈85% de l’objectif)
4. Affichez la section Liste des comptes d’épargne : 3 comptes (3,600 EUR, 450 EUR, 1,800 EUR), triés par date d’échéance la plus proche
5. Affichez le Graphique de croissance de l’épargne sur 6 mois (graphique linéaire)

Schéma filaire : Référence à wf-bao-cao-tiet-kiem.md

5.6 REPORT-06 : Afficher le rapport de prêts

Objectif : Afficher l’analyse détaillée des prêts, y compris le solde de la dette actuelle, le coût du prêt ce mois-ci, le calendrier de paiement, les insights et les tendances.

Étapes :

1. Depuis l’écran Rapports, appuyez sur l’élément de menu 💸 Prêts dans la section “Rapports détaillés”
2. Affichez l’Aperçu des prêts : Solde de la dette actuelle 58,500 EUR, Coût du prêt ce mois-ci 378 EUR (Capital : 315 EUR + Intérêts : 63 EUR)
3. Affichez la section Paiement le plus proche : Jour 25 → PAYÉ, Prochain paiement dans 14 jours
4. Affichez la section Calendrier de paiement mensuel : 3 derniers mois avec montants et statut
5. Affichez la section Analyse des prêts (Insights) : Payé au cours des 3 derniers mois : 1,134 EUR, Tendance du solde de la dette en baisse régulière, Les intérêts représentent 17% du paiement, Risque de retard de paiement : FAIBLE
6. Affichez le Graphique de réduction de la dette sur 6 mois (graphique linéaire)

Schéma filaire : Référence à wf-bao-cao-khoan-vay.md

5.7 REPORT-07 : Analyser les dépenses par catégorie depuis le rapport d’aperçu

Objectif : Depuis le rapport d’aperçu, appuyez sur la section “Dépenses par catégorie” pour afficher le rapport de dépenses détaillé et une analyse plus approfondie.

Étapes :

1. Depuis l’écran d’aperçu des rapports, faites défiler jusqu’à la section Dépenses par catégorie
2. Affichez les top 5 des catégories avec les pourcentages les plus élevés
3. Appuyez sur la carte “Dépenses par catégorie” (avec icône chevron-droite)
4. L’application fait automatiquement défiler jusqu’à la section Rapport de dépenses dans le même écran
5. Affichez tous les détails : Total des dépenses, dépenses récurrentes, dépenses quotidiennes par catégorie (plus que les top 5), poussée de dépenses, tendances et historique

Schéma filaire : Référence à wf-bao-cao.md - section “Dépenses par catégorie”

5.8 REPORT-08 : Afficher les rapports lorsque les données sont insuffisantes (Premier mois)

Objectif : Les nouveaux utilisateurs de l’application affichent les rapports le premier mois, lorsqu’il n’y a pas suffisamment de données pour la comparaison et l’analyse des tendances.

Étapes :

1. Allez à l’onglet Rapports
2. Affichez la section Santé financière :
   • Objectif d’épargne et épargne réelle (si le budget existe)
   • Flux de trésorerie net avec formule
   • Budget restant (s’il existe)
   • NON affiché : “Rythme de dépenses” (pas de données du mois précédent)
3. Affichez la section Prévision de tendance future (si budget > 0)
4. Appuyez sur Rapport de revenus : Total des revenus ce mois-ci, revenus récurrents et supplémentaires, NON affiché “Tendance sur 3 mois”, UNIQUEMENT affiché “Ce mois” dans l’historique
5. Appuyez sur Rapport de dépenses : Total des dépenses ce mois-ci, dépenses récurrentes et quotidiennes, NON affiché “Poussée de dépenses”, “Tendance sur 3 mois”, UNIQUEMENT affiché “Ce mois” dans l’historique

Schéma filaire : Référence à wf-bao-cao.md - cartes avec affichage conditionnel

6. Logique et règles

6.1 Calcul du flux de trésorerie net

Formule :

Flux de trésorerie net_mois = 
  (Revenus récurrents réellement reçus dans le mois + Revenus supplémentaires dans le mois)
  - (Dépenses récurrentes réellement payées dans le mois + Dépenses quotidiennes dans le mois + Paiements de prêt réels dans le mois)

Détails :

• Revenus : SUM(recurring_income_occurrence.amount_snapshot) WHERE status = ‘COMPLETED’ AND due_date in month + SUM(extra_income.amount) WHERE occurred_at in month
• Dépenses : SUM(recurring_expense_occurrence.amount_snapshot) WHERE status = ‘COMPLETED’ AND due_date in month + SUM(daily_expense.amount) WHERE occurred_at in month + SUM(bank_debt_payment.total_amount) WHERE due_date in month AND status != ‘CANCELLED’
• Épargne réelle : max(NetCashflow_month, 0) - Si le flux de trésorerie net est positif : Épargne = Flux de trésorerie net, Si le flux de trésorerie net est négatif : Épargne = 0 (dépassement)

6.2 Niveau d’atteinte de l’objectif d’épargne

Formule :

ratio = Épargne_mois / budget.savings_amount
progression% = round(ratio × 100)

Seuils :

• BON : progression% ≥ 90
• MOYEN : 70 ≤ progression% < 90
• MAUVAIS : progression% < 70

6.3 Budget restant

Formule :

• % Budget restant = (Budget restant / Budget total) × 100
• % Temps restant = (Jours restants / Total jours dans le mois) × 100

Conclusion :

• Si % budget ≈ % temps : Le rythme de dépenses est RAISONNABLE
• Si % budget < % temps : Dépenses PLUS RAPIDES que le rythme
• Si % budget > % temps : Dépenses PLUS LENTES que le rythme

Note : Cette carte s’affiche uniquement lorsque le budget a été créé pour ce mois.

6.4 Prévision de fin de mois

Dépenses attendues :

Dépenses_attendues = 
  (Dépenses_quotidiennes_moyennes × Jours_restants_dans_le_mois)
  + Total_Dépenses_récurrentes_en_attente_restant_mois
  + Total_Paiement_Prêt_Bancaire_en_attente_dans_le_mois

Détails :

• Dépenses_quotidiennes_moyennes = (Total daily_expense.amount du début du mois à aujourd’hui) / Jours_écoulés_dans_le_mois
• Total_Dépenses_récurrentes_en_attente = SUM(recurring_expense_occurrence.amount_snapshot) WHERE status = ‘PENDING’ AND due_date between demain and fin du mois
• Total_Paiement_Prêt_Bancaire_en_attente = SUM(bank_debt_payment.total_amount) WHERE due_date between demain and fin du mois AND status = ‘PENDING’

Reste attendu à la fin du mois :

Reste_attendu_fin_du_mois = NetCashflow_month - Dépenses_attendues

Probabilité d’atteinte de l’objectif d’épargne :

ratio = Reste_attendu_fin_du_mois / budget.savings_amount
progression% = round(ratio × 100)

Étiquettes :

• ≥ 90% → ATTEINDRA
• 70–89% → PRÈS D’ATTEINDRE
• < 70% → DIFFICILE À ATTEINDRE

Note : La prévision s’affiche uniquement lorsque budget > 0.

6.5 Données réelles vs Plan

• Toutes les données du rapport utilisent les données RÉELLES :
  • Revenus : Occurrences COMPLETED + extra_income
  • Dépenses : Occurrences COMPLETED + daily_expense
  • Paiements de prêt : bank_debt_payment avec due_date dans le mois (peu importe s’ils sont payés ou non)
• N’utilise PAS les données du plan (occurrences PENDING pas encore dues)

7. Notes importantes

• Données du mois en cours uniquement : Les rapports n’affichent que les données du mois en cours
• Conditions d’affichage :
  • La carte “Budget restant” s’affiche uniquement lorsque le budget a été créé pour ce mois
  • La carte “Rythme de dépenses” s’affiche uniquement lorsque les données du mois précédent sont disponibles pour la comparaison
  • La carte “Obligations de prêt” s’affiche uniquement lorsque des prêts existent
  • L’élément de menu “Budget” s’affiche uniquement lorsque le budget a été créé
  • L’élément de menu “Épargne” s’affiche uniquement lorsque des comptes d’épargne existent
  • L’élément de menu “Prêts” s’affiche uniquement lorsque des prêts existent
  • La section “Prévision de tendance future” s’affiche uniquement lorsque budget > 0
• La prévision est à titre indicatif uniquement : Basée sur les tendances actuelles et les éléments PENDING
• Premier mois : Certaines cartes/sections ne s’affichent pas en raison du manque de données de comparaison (par exemple, “Rythme de dépenses”, “Tendance sur 3 mois”, “Poussée de dépenses”)
• Les cartes sont cliquables : Appuyer sur une carte fait défiler vers le rapport détaillé correspondant dans le même écran