Générateur d'Export de Rapports

​

Aperçu

​

Fonctionnement

1. Accepte les sélections de l’utilisateur (rapports, plage de dates, format)
2. Appelle les APIs de rapports individuelles en parallèle :
   • GET /reports/balance-sheet?asOfDate={date}
   • GET /reports/profit-loss?startDate={date}&endDate={date}
   • GET /reports/shares-report?asOfDate={date}
   • GET /reports/loans-outstanding?expectedDate={date}
3. Combine les résultats dans le format demandé (PDF ou CSV)
4. Télécharge vers le navigateur de l’utilisateur

​

Rapports Disponibles

• Bilan
• Compte de Résultat
• Rapport des Parts
• Prêts en Cours

​

Configuration de la Plage de Dates

• Plage sélectionnée : 1er juin - 30 juin 2026
• Appel API Bilan : GET /reports/balance-sheet?asOfDate=2026-06-30
• Appel API Compte de Résultat : GET /reports/profit-loss?startDate=2026-06-01&endDate=2026-06-30
• Appel API Rapport des Parts : GET /reports/shares-report?asOfDate=2026-06-30
• Appel API Prêts en Cours : GET /reports/loans-outstanding?expectedDate=2026-06-30

​

Scénarios d’Export Courants

​

Dossier de Réunion Mensuelle du Conseil

• ✅ Bilan (situation financière à la fin du mois)
• ✅ Compte de Résultat (performance mensuelle)
• ✅ Prêts en Cours (santé du portefeuille)

GET /reports/balance-sheet?asOfDate=2026-06-30
GET /reports/profit-loss?startDate=2026-06-01&endDate=2026-06-30
GET /reports/loans-outstanding?expectedDate=2026-06-30

​

Réunion Trimestrielle des Membres

• ✅ Bilan (position des actifs et capitaux propres)
• ✅ Compte de Résultat (bénéfice/perte trimestriel)
• ✅ Rapport des Parts (répartition de la participation des membres)

GET /reports/balance-sheet?asOfDate=2026-06-30
GET /reports/profit-loss?startDate=2026-04-01&endDate=2026-06-30
GET /reports/shares-report?asOfDate=2026-06-30

​

Dossier d’Audit Annuel

• ✅ Bilan
• ✅ Compte de Résultat
• ✅ Rapport des Parts
• ✅ Prêts en Cours

GET /reports/balance-sheet?asOfDate=2025-12-31
GET /reports/profit-loss?startDate=2025-01-01&endDate=2025-12-31
GET /reports/shares-report?asOfDate=2025-12-31
GET /reports/loans-outstanding?expectedDate=2025-12-31

​

Revue du Comité de Crédit

• ✅ Prêts en Cours (statut actuel du portefeuille)

GET /reports/loans-outstanding?expectedDate=2026-06-12

​

Options de Format d’Export

​

Export PDF

• Rapports au format professionnel
• Inclut la marque de l’organisation
• Facile à imprimer et distribuer
• Adapté aux présentations

• PDF fusionné : Tous les rapports dans un seul fichier (recommandé pour les réunions)
• PDFs séparés : Chaque rapport dans un fichier individuel (pour distribution sélective)

• Fusionné : agatabo-[organization]-reports-[date].pdf
• Séparé : agatabo-[organization]-[report-name]-[date].pdf

​

Export CSV

• Import dans Excel pour analyse personnalisée
• Création de tableaux croisés dynamiques
• Génération de graphiques personnalisés
• Combinaison avec d’autres sources de données

• agatabo-[organization]-[report-name]-[date].csv

​

Utiliser le Générateur d’Export

1. Aller à la section Rapports dans l’interface
2. Sélectionner les rapports à inclure (cases à cocher)
3. Choisir la plage de dates :
   • Période courante
   • Mois dernier
   • Ce trimestre
   • Cette année
   • Personnalisée (préciser les dates exactes)
4. Sélectionner le format : PDF ou CSV
5. Configurer les options PDF (si PDF sélectionné) :
   • Fusionné (fichier unique)
   • Séparé (fichiers individuels)
6. Cliquer sur Générer/Télécharger
7. Attendre la fin des appels API
8. Télécharger le(s) fichier(s) généré(s)

• Les fichiers se téléchargent dans le dossier de téléchargement par défaut
• Les fichiers multiples (PDFs/CSVs séparés) se téléchargent successivement
• Les grands rapports peuvent prendre plusieurs secondes à générer

​

Implémentation API

// Example: Monthly board package
const organizationId = 'org-abc123';
const asOfDate = '2026-06-30';
const startDate = '2026-06-01';
const endDate = '2026-06-30';

// Parallel API calls
const [balanceSheet, profitLoss, loansOutstanding] = await Promise.all([
  fetch(`/reports/balance-sheet?asOfDate=${asOfDate}`, {
    headers: { 'x-organization-id': organizationId }
  }),
  fetch(`/reports/profit-loss?startDate=${startDate}&endDate=${endDate}`, {
    headers: { 'x-organization-id': organizationId }
  }),
  fetch(`/reports/loans-outstanding?expectedDate=${asOfDate}`, {
    headers: { 'x-organization-id': organizationId }
  })
]);

// Process responses
const balanceSheetData = await balanceSheet.json();
const profitLossData = await profitLoss.json();
const loansOutstandingData = await loansOutstanding.json();

// Generate PDF or CSV from combined data
// (implementation depends on PDF/CSV library used)

​

Préréglages de Plage de Dates

• Mois dernier : 1er juin 2026 → 30 juin 2026
• Ce trimestre : 1er avril 2026 → 12 juin 2026
• Cette année : 1er janvier 2026 → 12 juin 2026

​

Bonnes Pratiques

​

Dépannage

• Nombre de rapports sélectionnés (1-4)
• Quantité de données dans chaque rapport
• Charge du serveur
• Vitesse du réseau

• Avez-vous l’autorisation reports:read ?
• L’organisation est-elle sélectionnée (si accès multi-organisations) ?
• La plage de dates est-elle valide (début < fin) ?
• Y a-t-il des transactions dans la période sélectionnée ?
• Consultez la console du navigateur pour les messages d’erreur API

• Compatibilité du navigateur (navigateurs modernes recommandés)
• Visionneuse PDF (Adobe Reader, visionneuse PDF Chrome)
• Paramètres d’import CSV dans Excel (délimiteur, encodage)

• Exécutez le générateur plusieurs fois avec des dates différentes
• Appelez directement les APIs de rapports individuels avec des paramètres personnalisés
• Allez à chaque page de rapport et exportez individuellement

• Windows : C:\Users\[YourName]\Downloads\
• Mac : ~/Downloads/
• Linux : ~/Downloads/

• Construire un script personnalisé appelant les APIs de rapports
• Utiliser une tâche cron ou planifiée
• Générer et envoyer automatiquement les rapports par email

​

Alternative : Exports de Rapports Individuels

# Balance Sheet (as of month-end)
curl -X GET "/reports/balance-sheet?asOfDate=2026-06-30" \
  -H "x-organization-id: org-abc123"

# Profit & Loss (for quarter)
curl -X GET "/reports/profit-loss?startDate=2026-04-01&endDate=2026-06-30" \
  -H "x-organization-id: org-abc123"

# Shares Report (as of today)
curl -X GET "/reports/shares-report?asOfDate=2026-06-12" \
  -H "x-organization-id: org-abc123"

1. Rapports → Bilan
2. Sélectionner une date personnalisée
3. Exporter ce rapport
4. Répéter pour les autres rapports

​

Autorisations

• Administrateurs (accès complet)
• Comptables (accès complet)
• Trésoriers (accès complet)
• Membres du Conseil (si reports:read est accordé)

• Membres ordinaires (sauf autorisation spécifique)
• Utilisateurs avec seulement ledger:read (autorisation différente)

​

Sujets Connexes