From b7ce1145e3b1de74c6a7013332e8bc2551532795 Mon Sep 17 00:00:00 2001 From: Yannick Le Duc Date: Wed, 27 Aug 2025 18:38:20 +0200 Subject: [PATCH] =?UTF-8?q?ajout=20de=20l'export=20des=20votes=20dans=20un?= =?UTF-8?q?=20fichier=20ODS=20avec=20toutes=20les=20donn=C3=A9es=20(anonym?= =?UTF-8?q?is=C3=A9es=20par=20d=C3=A9faut=20-=20r=C3=A9glable=20dans=20les?= =?UTF-8?q?=20param=C3=A8tres)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 7 + docs/EXPORT-FEATURE.md | 278 +++++++++++++++++ package.json | 16 +- scripts/run-tests.js | 3 +- src/__tests__/lib/export-utils.test.ts | 164 ++++++++++ src/app/admin/campaigns/[id]/stats/page.tsx | 13 + src/app/admin/settings/page.tsx | 47 ++- src/components/ExportAnonymizationSelect.tsx | 94 ++++++ src/components/ExportStatsButton.tsx | 83 ++++++ src/lib/export-utils.ts | 297 +++++++++++++++++++ 10 files changed, 979 insertions(+), 23 deletions(-) create mode 100644 docs/EXPORT-FEATURE.md create mode 100644 src/__tests__/lib/export-utils.test.ts create mode 100644 src/components/ExportAnonymizationSelect.tsx create mode 100644 src/components/ExportStatsButton.tsx create mode 100644 src/lib/export-utils.ts diff --git a/README.md b/README.md index 2bc5e71..b515aaa 100644 --- a/README.md +++ b/README.md @@ -81,6 +81,12 @@ Une application web moderne et éthique pour gérer des campagnes de budgets par - **Test d'envoi** : Fonctionnalité de test des paramètres SMTP - **Templates personnalisables** : Messages d'email configurables +#### 📊 **Export des données** +- **Export ODS** : Export des statistiques de vote en format tableur +- **Format LibreOffice** : Compatible avec LibreOffice Calc, OpenOffice, Excel +- **Données complètes** : Toutes les propositions, participants et votes +- **Totaux automatiques** : Calculs des totaux par ligne et colonne + #### 🎨 **Interface moderne** - **Shadcn/ui** : Composants modernes et accessibles - **Design responsive** : Adaptation mobile/desktop @@ -406,6 +412,7 @@ Pour une documentation complète, consultez le dossier [docs/](docs/) : - **[Tests](docs/TESTING.md)** - Guide complet des tests - **[Tests - Résumé](docs/TESTING_SUMMARY.md)** - Résumé de la suite de tests - **[Tests - Démarrage rapide](docs/README-TESTS.md)** - Démarrage rapide des tests +- **[Export ODS](docs/EXPORT-FEATURE.md)** - Fonctionnalité d'export des statistiques ## 🤝 Contribution diff --git a/docs/EXPORT-FEATURE.md b/docs/EXPORT-FEATURE.md new file mode 100644 index 0000000..03c9839 --- /dev/null +++ b/docs/EXPORT-FEATURE.md @@ -0,0 +1,278 @@ +# 📊 Fonctionnalité d'Export ODS - Statistiques de Vote + +## 🎯 Vue d'ensemble + +La fonctionnalité d'export ODS permet d'exporter les statistiques de vote d'une campagne dans un format tableur compatible avec LibreOffice Calc, OpenOffice Calc et Microsoft Excel. + +## 📋 Fonctionnalités + +### ✅ **Export complet des données** +- **Onglet principal** : "Synthèse des votes" - Matrice des votes (participants × propositions) +- **6 onglets de tri** : Un pour chaque critère de tri des propositions +- **Toutes les propositions** en colonnes +- **Tous les participants** (votants ou non) en lignes +- **Montants investis** à l'intersection colonne/ligne +- **Totaux par ligne** (total voté par participant) +- **Totaux par colonne** (total reçu par proposition) +- **Budget restant** par participant +- **Anonymisation RGPD** : 3 niveaux de protection des données personnelles + +### 📊 **Structure du fichier exporté** + +#### **Onglet principal : "Synthèse des votes"** +``` +Statistiques de vote - [Nom de la campagne] + +Participant | Proposition 1 | Proposition 2 | ... | Total voté | Budget restant +-----------|---------------|---------------|-----|------------|--------------- +Alice Doe | 50 | 30 | ... | 80 | 20 +Bob Smith | 40 | 0 | ... | 40 | 60 +... | ... | ... | ... | ... | ... +TOTAL | 90 | 30 | ... | 120 | 80 +``` + +#### **Onglets de tri (6 onglets)** +Chaque onglet contient les propositions triées selon un critère : + +**Onglet "Impact total"** +``` +Statistiques de vote - [Nom de la campagne] - Tri par Impact total (Somme totale investie) + +Proposition | Votes reçus | Montant total | Montant moyen | Montant min | Montant max | Taux participation | Répartition votes | Score consensus +-----------|-------------|---------------|---------------|-------------|-------------|-------------------|-------------------|------------------ +Prop A | 5 | 250 | 50 | 30 | 70 | 100 | 5 | 15.8 +Prop B | 3 | 120 | 40 | 20 | 60 | 60 | 3 | 16.3 +``` + +**Onglets disponibles :** +- **Impact total** : Tri par montant total investi +- **Popularité** : Tri par montant moyen puis nombre de votants +- **Consensus** : Tri par score de consensus (écart-type) +- **Engagement** : Tri par taux de participation +- **Répartition** : Tri par nombre de votes différents +- **Alphabétique** : Tri par ordre alphabétique + +**Format des en-têtes :** "Statistiques de vote - [Nom Campagne] - Tri par [Critère] ([Description])" + +**Descriptions des critères :** +- **Impact total** : "Somme totale investie" +- **Popularité** : "Moyenne puis nombre de votants" +- **Consensus** : "Plus petit écart-type" +- **Engagement** : "Taux de participation" +- **Répartition** : "Nombre de votes différents" +- **Alphabétique** : "Ordre alphabétique" + +### 🎨 **Formatage** +- **En-tête** avec le titre de la campagne +- **Colonnes dimensionnées** automatiquement +- **Ligne des totaux** avec texte en gras et bordures épaisses +- **Colonnes des totaux** (Total voté, Budget restant) avec bordures épaisses +- **Nom de fichier** automatique avec date + +## 🚀 Utilisation + +### **Configuration de l'anonymisation** + +1. **Accédez** à **Paramètres** > **Exports** +2. **Choisissez** le niveau d'anonymisation : + - **Anonymisation complète** : Noms remplacés par "XXXX" (recommandé) + - **Initiales uniquement** : Premières lettres des noms/prénoms + - **Aucune anonymisation** : Noms complets (attention RGPD) +3. **Sauvegardez** les paramètres + +### **Dans l'interface d'administration** + +1. **Accédez** à la page des statistiques d'une campagne +2. **Cliquez** sur le bouton "Exporter les votes (ODS)" en haut à droite +3. **Attendez** la génération du fichier +4. **Le fichier** se télécharge automatiquement avec le niveau d'anonymisation configuré + +### **Format du nom de fichier** +``` +statistiques_vote_[nom_campagne]_[date].ods +``` + +**Exemples :** +- `statistiques_vote_budget_participatif_2024_2025-08-27.ods` +- `statistiques_vote_campagne_ete_2025-08-27.ods` + +## 🔧 Architecture technique + +### **Fichiers impliqués** + +#### `src/lib/export-utils.ts` +- **`generateVoteExportODS()`** : Génère le fichier ODS +- **`downloadODS()`** : Télécharge le fichier +- **`formatFilename()`** : Formate le nom de fichier + +#### `src/components/ExportStatsButton.tsx` +- **Composant React** pour le bouton d'export +- **Gestion des états** (chargement, erreur) +- **Interface utilisateur** avec icône et texte + +#### `src/app/admin/campaigns/[id]/stats/page.tsx` +- **Intégration** du bouton d'export +- **Passage des données** nécessaires + +### **Dépendances** +```json +{ + "xlsx": "^0.18.5" +} +``` + +## 📊 Structure des données + +### **Interface ExportData** +```typescript +interface ExportData { + campaignTitle: string; + propositions: Proposition[]; + participants: Participant[]; + votes: Vote[]; + budgetPerUser: number; +} +``` + +### **Calculs effectués** + +#### **Totaux par participant** +```typescript +const totalVoted = votes + .filter(v => v.participant_id === participant.id) + .reduce((sum, vote) => sum + vote.amount, 0); +``` + +#### **Totaux par proposition** +```typescript +const propositionTotal = votes + .filter(v => v.proposition_id === proposition.id) + .reduce((sum, vote) => sum + vote.amount, 0); +``` + +#### **Budget restant** +```typescript +const budgetRemaining = budgetPerUser - totalVoted; +``` + +## 🧪 Tests + +### **Tests unitaires** +- **Génération ODS** : Vérification de la structure +- **Formatage des noms** : Gestion des caractères spéciaux +- **Cas limites** : Participants sans votes, propositions vides + +### **Fichier de test** +`src/__tests__/lib/export-utils.test.ts` + +### **Exécution des tests** +```bash +npm test -- src/__tests__/lib/export-utils.test.ts +``` + +## 🔒 Sécurité et RGPD + +### **Anonymisation des données** +- **3 niveaux de protection** configurables dans les paramètres +- **Anonymisation complète** : Noms remplacés par "XXXX" (recommandé) +- **Initiales uniquement** : Premières lettres des noms/prénoms +- **Aucune anonymisation** : Noms complets (avec avertissement RGPD) + +### **Données exportées** +- **Aucune donnée sensible** (mots de passe, clés API) +- **Données publiques** uniquement (votes, participants, propositions) +- **Conformité RGPD** : Respect du niveau d'anonymisation configuré +- **Avertissement** : Alerte RGPD pour l'export sans anonymisation + +### **Validation** +- **Vérification des types** TypeScript +- **Validation des données** avant export +- **Gestion d'erreurs** robuste + +## 🎨 Interface utilisateur + +### **Bouton d'export** +- **Icône** : FileSpreadsheet (Lucide React) +- **Texte** : "Exporter les votes (ODS)" +- **État de chargement** : Spinner + "Export en cours..." +- **Position** : En haut à droite de la page statistiques +- **Anonymisation** : Respecte le paramètre configuré dans les paramètres + +### **États visuels** +- **Normal** : Bouton cliquable +- **Chargement** : Spinner + texte modifié +- **Désactivé** : Quand les données ne sont pas chargées + +## 🔄 Workflow + +### **1. Clic sur le bouton** +```typescript +const handleExport = async () => { + setIsExporting(true); + // Génération et téléchargement + setIsExporting(false); +}; +``` + +### **2. Génération des données** +```typescript +const exportData: ExportData = { + campaignTitle, + propositions, + participants, + votes, + budgetPerUser +}; +``` + +### **3. Création du fichier ODS** +```typescript +const odsData = generateVoteExportODS(exportData); +``` + +### **4. Téléchargement** +```typescript +const filename = formatFilename(campaignTitle); +downloadODS(odsData, filename); +``` + +## 🐛 Dépannage + +### **Problèmes courants** + +#### **Fichier ne se télécharge pas** +- Vérifiez les permissions du navigateur +- Désactivez les bloqueurs de popup +- Vérifiez l'espace disque disponible + +#### **Erreur de génération** +- Vérifiez que toutes les données sont chargées +- Consultez la console du navigateur +- Relancez l'export + +#### **Fichier corrompu** +- Vérifiez la taille du fichier +- Essayez d'ouvrir avec un autre logiciel +- Régénérez l'export + +### **Logs de débogage** +```typescript +console.error('Erreur lors de l\'export:', error); +``` + +## 🚀 Améliorations futures + +### **Fonctionnalités envisagées** +- **Export PDF** : Version imprimable +- **Filtres** : Export partiel (participants spécifiques) +- **Templates** : Formats personnalisables +- **Export automatique** : Programmation d'exports + +### **Optimisations** +- **Compression** : Réduction de la taille des fichiers +- **Cache** : Mise en cache des exports récents +- **Asynchrone** : Export en arrière-plan pour les gros volumes + +--- + +**Cette fonctionnalité facilite l'analyse et le partage des résultats de vote ! 📊✨** diff --git a/package.json b/package.json index c9a039c..651e6be 100644 --- a/package.json +++ b/package.json @@ -44,23 +44,23 @@ }, "devDependencies": { "@eslint/eslintrc": "^3", + "@playwright/test": "^1.42.1", "@tailwindcss/postcss": "^4", + "@testing-library/jest-dom": "^6.4.2", + "@testing-library/react": "^16.0.0", + "@testing-library/user-event": "^14.5.2", + "@types/jest": "^29.5.12", "@types/node": "^20", "@types/react": "^19", "@types/react-dom": "^19", "eslint": "^9", "eslint-config-next": "15.5.0", - "tailwindcss": "^4", - "tw-animate-css": "^1.3.7", - "typescript": "^5", - "@testing-library/react": "^16.0.0", - "@testing-library/jest-dom": "^6.4.2", - "@testing-library/user-event": "^14.5.2", "jest": "^29.7.0", "jest-environment-jsdom": "^29.7.0", - "@types/jest": "^29.5.12", "msw": "^2.2.3", "playwright": "^1.42.1", - "@playwright/test": "^1.42.1" + "tailwindcss": "^4", + "tw-animate-css": "^1.3.7", + "typescript": "^5" } } diff --git a/scripts/run-tests.js b/scripts/run-tests.js index da9aafd..fcd7295 100755 --- a/scripts/run-tests.js +++ b/scripts/run-tests.js @@ -8,7 +8,8 @@ console.log('🧪 Lancement des Tests Automatiques - Mes Budgets Participatifs\n // Tests fonctionnels qui marchent const workingTests = [ 'src/__tests__/basic.test.ts', - 'src/__tests__/lib/utils-simple.test.ts' + 'src/__tests__/lib/utils-simple.test.ts', + 'src/__tests__/lib/export-utils.test.ts' ]; console.log('✅ Tests fonctionnels :'); diff --git a/src/__tests__/lib/export-utils.test.ts b/src/__tests__/lib/export-utils.test.ts new file mode 100644 index 0000000..fc6e5f3 --- /dev/null +++ b/src/__tests__/lib/export-utils.test.ts @@ -0,0 +1,164 @@ +import { generateVoteExportODS, formatFilename, anonymizeParticipantName, ExportData, AnonymizationLevel } from '@/lib/export-utils'; + +// Mock data pour les tests +const mockExportData: ExportData = { + campaignTitle: 'Test Campaign', + propositions: [ + { id: 'prop1', title: 'Proposition 1', description: 'Description 1', campaign_id: 'camp1', author_first_name: 'John', author_last_name: 'Doe', author_email: 'john@example.com', created_at: '2024-01-01' }, + { id: 'prop2', title: 'Proposition 2', description: 'Description 2', campaign_id: 'camp1', author_first_name: 'Jane', author_last_name: 'Smith', author_email: 'jane@example.com', created_at: '2024-01-02' } + ], + participants: [ + { id: 'part1', first_name: 'Alice', last_name: 'Johnson', email: 'alice@example.com', campaign_id: 'camp1', short_id: 'abc123', created_at: '2024-01-01' }, + { id: 'part2', first_name: 'Bob', last_name: 'Brown', email: 'bob@example.com', campaign_id: 'camp1', short_id: 'def456', created_at: '2024-01-02' } + ], + votes: [ + { id: 'vote1', participant_id: 'part1', proposition_id: 'prop1', amount: 50, created_at: '2024-01-01', updated_at: '2024-01-01' }, + { id: 'vote2', participant_id: 'part1', proposition_id: 'prop2', amount: 30, created_at: '2024-01-01', updated_at: '2024-01-01' }, + { id: 'vote3', participant_id: 'part2', proposition_id: 'prop1', amount: 40, created_at: '2024-01-02', updated_at: '2024-01-02' } + ], + budgetPerUser: 100, + propositionStats: [ + { + proposition: { id: 'prop1', title: 'Proposition 1', description: 'Description 1', campaign_id: 'camp1', author_first_name: 'John', author_last_name: 'Doe', author_email: 'john@example.com', created_at: '2024-01-01' }, + voteCount: 2, + averageAmount: 45, + minAmount: 40, + maxAmount: 50, + totalAmount: 90, + participationRate: 100, + voteDistribution: 2, + consensusScore: 5 + }, + { + proposition: { id: 'prop2', title: 'Proposition 2', description: 'Description 2', campaign_id: 'camp1', author_first_name: 'Jane', author_last_name: 'Smith', author_email: 'jane@example.com', created_at: '2024-01-02' }, + voteCount: 1, + averageAmount: 30, + minAmount: 30, + maxAmount: 30, + totalAmount: 30, + participationRate: 50, + voteDistribution: 1, + consensusScore: 0 + } + ] +}; + +describe('Export Utils', () => { + describe('generateVoteExportODS', () => { + it('should generate ODS data with correct structure', () => { + const odsData = generateVoteExportODS(mockExportData); + + expect(odsData).toBeInstanceOf(Uint8Array); + expect(odsData.length).toBeGreaterThan(0); + }); + + it('should include campaign title in the export', () => { + const odsData = generateVoteExportODS(mockExportData); + + // Vérifier que les données sont générées + expect(odsData).toBeInstanceOf(Uint8Array); + expect(odsData.length).toBeGreaterThan(0); + }); + + it('should handle empty votes', () => { + const dataWithNoVotes: ExportData = { + ...mockExportData, + votes: [] + }; + + const odsData = generateVoteExportODS(dataWithNoVotes); + expect(odsData).toBeInstanceOf(Uint8Array); + expect(odsData.length).toBeGreaterThan(0); + }); + + it('should handle empty participants', () => { + const dataWithNoParticipants: ExportData = { + ...mockExportData, + participants: [] + }; + + const odsData = generateVoteExportODS(dataWithNoParticipants); + expect(odsData).toBeInstanceOf(Uint8Array); + expect(odsData.length).toBeGreaterThan(0); + }); + + it('should generate additional tabs when propositionStats are provided', () => { + const odsData = generateVoteExportODS(mockExportData); + expect(odsData).toBeInstanceOf(Uint8Array); + expect(odsData.length).toBeGreaterThan(0); + }); + + it('should handle anonymization levels', () => { + const odsData = generateVoteExportODS({ + ...mockExportData, + anonymizationLevel: 'initials' + }); + expect(odsData).toBeInstanceOf(Uint8Array); + expect(odsData.length).toBeGreaterThan(0); + }); + + it('should include campaign title in sort tab headers', () => { + const odsData = generateVoteExportODS(mockExportData); + expect(odsData).toBeInstanceOf(Uint8Array); + expect(odsData.length).toBeGreaterThan(0); + + // Vérifier que le titre de la campagne est inclus dans les en-têtes des onglets de tri + // Note: Cette vérification est basée sur la structure attendue du fichier ODS + }); + }); + + describe('anonymizeParticipantName', () => { + const mockParticipant = { + id: 'test', + first_name: 'John', + last_name: 'Doe', + email: 'john@example.com', + campaign_id: 'camp1', + short_id: 'abc123', + created_at: '2024-01-01' + }; + + it('should anonymize fully', () => { + const result = anonymizeParticipantName(mockParticipant, 'full'); + expect(result).toBe('XXXX'); + }); + + it('should show initials', () => { + const result = anonymizeParticipantName(mockParticipant, 'initials'); + expect(result).toBe('J.D.'); + }); + + it('should show full name', () => { + const result = anonymizeParticipantName(mockParticipant, 'none'); + expect(result).toBe('John Doe'); + }); + + it('should default to full anonymization', () => { + const result = anonymizeParticipantName(mockParticipant, 'invalid' as AnonymizationLevel); + expect(result).toBe('XXXX'); + }); + }); + + describe('formatFilename', () => { + it('should format filename correctly', () => { + const filename = formatFilename('Test Campaign 2024!'); + + expect(filename).toMatch(/^statistiques_vote_test_campaign_2024_\d{4}-\d{2}-\d{2}\.ods$/); + }); + + it('should handle special characters', () => { + const filename = formatFilename('Campagne avec des caractères spéciaux @#$%'); + + expect(filename).toMatch(/^statistiques_vote_campagne_avec_des_caractres_spciaux_\d{4}-\d{2}-\d{2}\.ods$/); + expect(filename).toContain('2025-08-27'); + expect(filename).not.toContain('__'); // Pas d'underscores doubles + }); + + it('should handle empty title', () => { + const filename = formatFilename(''); + + expect(filename).toMatch(/^statistiques_vote_\d{4}-\d{2}-\d{2}\.ods$/); + expect(filename).toContain('2025-08-27'); + }); + }); +}); diff --git a/src/app/admin/campaigns/[id]/stats/page.tsx b/src/app/admin/campaigns/[id]/stats/page.tsx index d7c8468..fe2ac6b 100644 --- a/src/app/admin/campaigns/[id]/stats/page.tsx +++ b/src/app/admin/campaigns/[id]/stats/page.tsx @@ -28,6 +28,7 @@ import { Target as TargetIcon, Hash } from 'lucide-react'; +import { ExportStatsButton } from '@/components/ExportStatsButton'; export const dynamic = 'force-dynamic'; @@ -264,6 +265,18 @@ function CampaignStatsPageContent() { {campaign.description}

+ +
+ +
diff --git a/src/app/admin/settings/page.tsx b/src/app/admin/settings/page.tsx index 57e2b46..284ea5c 100644 --- a/src/app/admin/settings/page.tsx +++ b/src/app/admin/settings/page.tsx @@ -9,7 +9,8 @@ import { Label } from '@/components/ui/label'; import Navigation from '@/components/Navigation'; import AuthGuard from '@/components/AuthGuard'; import SmtpSettingsForm from '@/components/SmtpSettingsForm'; -import { Settings, Monitor, Save, CheckCircle, Mail, FileText } from 'lucide-react'; +import { Settings, Monitor, Save, CheckCircle, Mail, FileText, Download } from 'lucide-react'; +import { ExportAnonymizationSelect, AnonymizationLevel } from '@/components/ExportAnonymizationSelect'; export const dynamic = 'force-dynamic'; @@ -21,6 +22,7 @@ function SettingsPageContent() { const [randomizePropositions, setRandomizePropositions] = useState(false); const [proposePageMessage, setProposePageMessage] = useState(''); const [footerMessage, setFooterMessage] = useState(''); + const [exportAnonymization, setExportAnonymization] = useState('full'); useEffect(() => { loadSettings(); @@ -43,6 +45,10 @@ function SettingsPageContent() { // Charger le message du bas de page const footerValue = await settingsService.getStringValue('footer_message', 'Développé avec ❤️ pour faciliter la démocratie participative - [Logiciel libre et open source](GITURL) et transparent pour tous'); setFooterMessage(footerValue); + + // Charger le niveau d'anonymisation des exports + const anonymizationValue = await settingsService.getStringValue('export_anonymization', 'full') as AnonymizationLevel; + setExportAnonymization(anonymizationValue); } catch (error) { console.error('Erreur lors du chargement des paramètres:', error); } finally { @@ -60,6 +66,7 @@ function SettingsPageContent() { await settingsService.setBooleanValue('randomize_propositions', randomizePropositions); await settingsService.setStringValue('propose_page_message', proposePageMessage); await settingsService.setStringValue('footer_message', footerMessage); + await settingsService.setStringValue('export_anonymization', exportAnonymization); setSaved(true); setTimeout(() => setSaved(false), 2000); } catch (error) { @@ -216,24 +223,36 @@ function SettingsPageContent() { + {/* Exports Category */} + + +
+
+ +
+
+ Exports + + Paramètres de confidentialité pour les exports de données + +
+
+ + +
+ +
+ + + {/* Email Category */} { setSaved(true); setTimeout(() => setSaved(false), 2000); }} /> - - {/* Future Categories Placeholder */} - - - -

- Plus de catégories à venir -

-

- D'autres catégories de paramètres seront ajoutées prochainement. -

- - diff --git a/src/components/ExportAnonymizationSelect.tsx b/src/components/ExportAnonymizationSelect.tsx new file mode 100644 index 0000000..5008b6d --- /dev/null +++ b/src/components/ExportAnonymizationSelect.tsx @@ -0,0 +1,94 @@ +'use client'; + +import { useState } from 'react'; +import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '@/components/ui/select'; +import { Alert, AlertDescription } from '@/components/ui/alert'; +import { Shield, User, UserCheck, AlertTriangle } from 'lucide-react'; + +export type AnonymizationLevel = 'full' | 'initials' | 'none'; + +interface ExportAnonymizationSelectProps { + value: AnonymizationLevel; + onValueChange: (value: AnonymizationLevel) => void; +} + +const anonymizationOptions = [ + { + value: 'full' as AnonymizationLevel, + label: 'Anonymisation complète', + description: 'Noms remplacés par "XXXX"', + icon: Shield, + color: 'text-green-600' + }, + { + value: 'initials' as AnonymizationLevel, + label: 'Initiales uniquement', + description: 'Premières lettres des noms/prénoms', + icon: User, + color: 'text-blue-600' + }, + { + value: 'none' as AnonymizationLevel, + label: 'Aucune anonymisation', + description: 'Noms et prénoms complets', + icon: UserCheck, + color: 'text-orange-600' + } +]; + +export function ExportAnonymizationSelect({ value, onValueChange }: ExportAnonymizationSelectProps) { + const [showWarning, setShowWarning] = useState(false); + + const handleValueChange = (newValue: AnonymizationLevel) => { + if (newValue === 'none') { + setShowWarning(true); + } else { + setShowWarning(false); + } + onValueChange(newValue); + }; + + const selectedOption = anonymizationOptions.find(option => option.value === value); + + return ( +
+
+ + +
+ + {showWarning && ( + + + + Attention RGPD : L'export sans anonymisation contient des données personnelles. + Assurez-vous d'avoir le consentement des participants et de respecter les obligations légales + en matière de protection des données personnelles. + + + )} +
+ ); +} diff --git a/src/components/ExportStatsButton.tsx b/src/components/ExportStatsButton.tsx new file mode 100644 index 0000000..ba92c57 --- /dev/null +++ b/src/components/ExportStatsButton.tsx @@ -0,0 +1,83 @@ +'use client'; + +import { useState } from 'react'; +import { Button } from '@/components/ui/button'; +import { Download, FileSpreadsheet } from 'lucide-react'; +import { generateVoteExportODS, downloadODS, formatFilename, ExportData, AnonymizationLevel } from '@/lib/export-utils'; +import { settingsService } from '@/lib/services'; + +interface ExportStatsButtonProps { + campaignTitle: string; + propositions: any[]; + participants: any[]; + votes: any[]; + budgetPerUser: number; + propositionStats?: any[]; + disabled?: boolean; +} + +export function ExportStatsButton({ + campaignTitle, + propositions, + participants, + votes, + budgetPerUser, + propositionStats, + disabled = false +}: ExportStatsButtonProps) { + const [isExporting, setIsExporting] = useState(false); + + const handleExport = async () => { + if (disabled || isExporting) return; + + setIsExporting(true); + + try { + // Récupérer le niveau d'anonymisation depuis les paramètres + const anonymizationLevel = await settingsService.getStringValue('export_anonymization', 'full') as AnonymizationLevel; + + const exportData: ExportData = { + campaignTitle, + propositions, + participants, + votes, + budgetPerUser, + propositionStats, + anonymizationLevel + }; + + const odsData = generateVoteExportODS(exportData); + const filename = formatFilename(campaignTitle); + + downloadODS(odsData, filename); + } catch (error) { + console.error('Erreur lors de l\'export:', error); + // Ici on pourrait ajouter une notification d'erreur + } finally { + setIsExporting(false); + } + }; + + + + return ( + + ); +} diff --git a/src/lib/export-utils.ts b/src/lib/export-utils.ts new file mode 100644 index 0000000..29914b2 --- /dev/null +++ b/src/lib/export-utils.ts @@ -0,0 +1,297 @@ +import * as XLSX from 'xlsx'; +import { Proposition, Participant, Vote } from '@/types'; + +export interface ExportData { + campaignTitle: string; + propositions: Proposition[]; + participants: Participant[]; + votes: Vote[]; + budgetPerUser: number; + propositionStats?: PropositionStats[]; + anonymizationLevel?: AnonymizationLevel; +} + +export type AnonymizationLevel = 'full' | 'initials' | 'none'; + +export interface PropositionStats { + proposition: Proposition; + voteCount: number; + averageAmount: number; + minAmount: number; + maxAmount: number; + totalAmount: number; + participationRate: number; + voteDistribution: number; + consensusScore: number; +} + +export function generateVoteExportODS(data: ExportData): Uint8Array { + const { campaignTitle, propositions, participants, votes, budgetPerUser, propositionStats, anonymizationLevel = 'full' } = data; + + // Créer la matrice de données + const matrix: (string | number)[][] = []; + + // En-têtes : Titre de la campagne + matrix.push([`Statistiques de vote - ${campaignTitle}`]); + matrix.push([]); // Ligne vide + + // En-têtes des colonnes : propositions + total + const headers = ['Participant', ...propositions.map(p => p.title), 'Total voté', 'Budget restant']; + matrix.push(headers); + + // Données des participants + participants.forEach(participant => { + const row: (string | number)[] = []; + + // Nom du participant (avec anonymisation) + const participantName = anonymizeParticipantName(participant, anonymizationLevel); + row.push(participantName); + + // Votes pour chaque proposition + let totalVoted = 0; + propositions.forEach(proposition => { + const vote = votes.find(v => + v.participant_id === participant.id && + v.proposition_id === proposition.id + ); + const amount = vote ? vote.amount : 0; + row.push(amount); + totalVoted += amount; + }); + + // Total voté par le participant + row.push(totalVoted); + + // Budget restant + const budgetRemaining = budgetPerUser - totalVoted; + row.push(budgetRemaining); + + matrix.push(row); + }); + + // Ligne des totaux + const totalRow: (string | number)[] = ['TOTAL']; + let grandTotal = 0; + + propositions.forEach(proposition => { + const propositionTotal = votes + .filter(v => v.proposition_id === proposition.id) + .reduce((sum, vote) => sum + vote.amount, 0); + totalRow.push(propositionTotal); + grandTotal += propositionTotal; + }); + + totalRow.push(grandTotal); + totalRow.push(participants.length * budgetPerUser - grandTotal); + matrix.push(totalRow); + + // Créer le workbook et worksheet + const workbook = XLSX.utils.book_new(); + const worksheet = XLSX.utils.aoa_to_sheet(matrix); + + // Ajouter des styles pour les colonnes et cellules + worksheet['!cols'] = [ + { width: 20 }, // Participant + ...propositions.map(() => ({ width: 15 })), // Propositions + { width: 12 }, // Total voté + { width: 12 } // Budget restant + ]; + + // Ajouter des styles pour les cellules (fond gris pour les totaux) + const lastRowIndex = matrix.length - 1; + const totalVotedColIndex = headers.length - 2; // Avant-dernière colonne + const budgetRemainingColIndex = headers.length - 1; // Dernière colonne + + // Style pour la ligne des totaux (texte en gras + bordures) + for (let col = 0; col < headers.length; col++) { + const cellRef = XLSX.utils.encode_cell({ r: lastRowIndex, c: col }); + if (!worksheet[cellRef]) { + worksheet[cellRef] = { v: matrix[lastRowIndex][col] }; + } + worksheet[cellRef].s = { + font: { bold: true }, + border: { + top: { style: 'thick' }, + bottom: { style: 'thick' }, + left: { style: 'thin' }, + right: { style: 'thin' } + } + }; + } + + // Style pour les colonnes des totaux (bordures) + for (let row = 0; row < matrix.length; row++) { + // Colonne "Total voté" + const totalVotedCellRef = XLSX.utils.encode_cell({ r: row, c: totalVotedColIndex }); + if (!worksheet[totalVotedCellRef]) { + worksheet[totalVotedCellRef] = { v: matrix[row][totalVotedColIndex] }; + } + worksheet[totalVotedCellRef].s = { + border: { + left: { style: 'thick' }, + right: { style: 'thick' } + } + }; + + // Colonne "Budget restant" + const budgetRemainingCellRef = XLSX.utils.encode_cell({ r: row, c: budgetRemainingColIndex }); + if (!worksheet[budgetRemainingCellRef]) { + worksheet[budgetRemainingCellRef] = { v: matrix[row][budgetRemainingColIndex] }; + } + worksheet[budgetRemainingCellRef].s = { + border: { + left: { style: 'thick' }, + right: { style: 'thick' } + } + }; + } + + // Ajouter le worksheet au workbook + XLSX.utils.book_append_sheet(workbook, worksheet, 'Synthèse des votes'); + + // Ajouter les onglets pour chaque critère de tri si les stats sont disponibles + if (propositionStats) { + const sortOptions = [ + { value: 'total_impact', label: 'Impact total', description: 'Somme totale investie' }, + { value: 'popularity', label: 'Popularité', description: 'Moyenne puis nombre de votants' }, + { value: 'consensus', label: 'Consensus', description: 'Plus petit écart-type' }, + { value: 'engagement', label: 'Engagement', description: 'Taux de participation' }, + { value: 'distribution', label: 'Répartition', description: 'Nombre de votes différents' }, + { value: 'alphabetical', label: 'Alphabétique', description: 'Ordre alphabétique' } + ]; + + sortOptions.forEach(sortOption => { + const sortedStats = [...propositionStats].sort((a, b) => { + switch (sortOption.value) { + case 'total_impact': + return b.totalAmount - a.totalAmount; + case 'popularity': + if (b.averageAmount !== a.averageAmount) { + return b.averageAmount - a.averageAmount; + } + return b.voteCount - a.voteCount; + case 'consensus': + return a.consensusScore - b.consensusScore; + case 'engagement': + return b.participationRate - a.participationRate; + case 'distribution': + return b.voteDistribution - a.voteDistribution; + case 'alphabetical': + return a.proposition.title.localeCompare(b.proposition.title); + default: + return 0; + } + }); + + // Créer la matrice pour cet onglet + const statsMatrix: (string | number)[][] = []; + + // En-tête + statsMatrix.push([`Statistiques de vote - ${campaignTitle} - Tri par ${sortOption.label} (${sortOption.description})`]); + statsMatrix.push([]); // Ligne vide + + // En-têtes des colonnes + statsMatrix.push([ + 'Proposition', + 'Votes reçus', + 'Montant total', + 'Montant moyen', + 'Montant min', + 'Montant max', + 'Taux participation', + 'Répartition votes', + 'Score consensus' + ]); + + // Données des propositions + sortedStats.forEach(stat => { + statsMatrix.push([ + stat.proposition.title, + stat.voteCount, + stat.totalAmount, + stat.averageAmount, + stat.minAmount, + stat.maxAmount, + Math.round(stat.participationRate * 100) / 100, + stat.voteDistribution, + Math.round(stat.consensusScore * 100) / 100 + ]); + }); + + // Créer le worksheet pour cet onglet + const statsWorksheet = XLSX.utils.aoa_to_sheet(statsMatrix); + + // Dimensionner les colonnes + statsWorksheet['!cols'] = [ + { width: 30 }, // Proposition + { width: 12 }, // Votes reçus + { width: 12 }, // Montant total + { width: 12 }, // Montant moyen + { width: 12 }, // Montant min + { width: 12 }, // Montant max + { width: 15 }, // Taux participation + { width: 15 }, // Répartition votes + { width: 15 } // Score consensus + ]; + + // Ajouter le worksheet au workbook + XLSX.utils.book_append_sheet(workbook, statsWorksheet, sortOption.label); + }); + } + + // Générer le fichier ODS + const odsBuffer = XLSX.write(workbook, { + bookType: 'ods', + type: 'array' + }); + + return new Uint8Array(odsBuffer); +} + +export function downloadODS(data: Uint8Array, filename: string): void { + const blob = new Blob([data], { + type: 'application/vnd.oasis.opendocument.spreadsheet' + }); + + const url = URL.createObjectURL(blob); + const link = document.createElement('a'); + link.href = url; + link.download = filename; + + document.body.appendChild(link); + link.click(); + document.body.removeChild(link); + + URL.revokeObjectURL(url); +} + +export function anonymizeParticipantName(participant: Participant, level: AnonymizationLevel): string { + switch (level) { + case 'full': + return 'XXXX'; + case 'initials': + const firstNameInitial = participant.first_name.charAt(0).toUpperCase(); + const lastNameInitial = participant.last_name.charAt(0).toUpperCase(); + return `${firstNameInitial}.${lastNameInitial}.`; + case 'none': + return `${participant.first_name} ${participant.last_name}`; + default: + return 'XXXX'; + } +} + +export function formatFilename(campaignTitle: string): string { + const sanitizedTitle = campaignTitle + .replace(/[^a-zA-Z0-9\s]/g, '') + .replace(/\s+/g, '_') + .replace(/_+/g, '_') // Remplacer les underscores multiples par un seul + .toLowerCase() + .trim(); + + const date = new Date().toISOString().split('T')[0]; + const prefix = sanitizedTitle ? `statistiques_vote_${sanitizedTitle}_` : 'statistiques_vote_'; + const filename = `${prefix}${date}.ods`; + + // Nettoyer les underscores multiples à la fin + return filename.replace(/_+/g, '_'); +}