La Voix du Peuple

Plateforme civique de participation démocratique assistée par intelligence artificielle.

Les citoyens soumettent des propositions politiques en texte libre. Chaque contribution est filtrée automatiquement selon le droit international des droits humains et le droit pénal français, puis intégrée à une synthèse thématique collective générée par IA. La plateforme fonctionne en mode ouvert (contributions globales) ou en mode consultation ciblée (sujet défini, dates de début et de fin, organisateur identifié). Elle ne produit pas un consensus : elle donne à voir ce que des citoyens ont choisi d'exprimer, tel quel.

La Voix du Peuple est un projet personnel open-source. Si vous l'utilisez et voulez soutenir son développement, un don est toujours bienvenu — mais une étoile sur le dépôt et des retours concrets comptent autant.

• Ko-fi : [LIEN_KO_FI]
• GitHub Sponsors : [LIEN_GITHUB_SPONSORS]

---

Fonctionnalités

Contribution citoyenne

• Formulaire texte libre (10 à 1 000 caractères), pseudonyme optionnel
• Filtrage IA automatique à la soumission selon quinze textes de référence : DUDH, PIDCP, CEDH, Code pénal français, Loi du 29 juillet 1881, LCEN, SREN 2024, RGPD, et autres
• Motif de rejet et base légale retournés au contributeur si la contribution est refusée
• Dialogue de recueil du consentement RGPD avant soumission

Synthèse collective

• Générée automatiquement à chaque nouvelle contribution acceptée (arrière-plan, non bloquant)
• Regroupement thématique, ton neutre et factuel, sans formule solennelle
• Régénération manuelle possible depuis le panel admin

Consultations ciblées

• Création via le panel admin : slug, titre, sujet, message d'introduction, organisateur, logo, dates d'ouverture et de clôture
• Fermeture automatique à l'échéance ou manuelle depuis l'admin
• Webhook de clôture configurable (envoi non bloquant en arrière-plan)
• Page publique /consultation/:slug avec formulaire de soumission, synthèse et contributions paginées
• Index public des consultations actives et clôturées (/consultations)

Exports

• Contributions globales : JSON et CSV (routes publiques)
• Synthèse de consultation : rendu HTML pour impression ou export PDF navigateur
• Export CSV complet (admin uniquement, tous champs)

Panel d'administration (protégé par ADMIN_SECRET)

• Liste des contributions avec filtres (toutes / acceptées / rejetées / signalées), pagination, recherche plein texte
• Suppression unitaire et en masse, override de statut (accepté/refusé), gestion des signalements
• Création, clôture et suppression de consultations

Interface publique complémentaire

• Page des contributions brutes paginées (/contributions-brutes)
• Signalement de contributions par les visiteurs (limité à 3/min, 10/h par IP)
• Flyer QR code imprimable configuré sur l'URL du déploiement (/flyer)
• Partage de la synthèse (copie presse-papier ou partage natif mobile)
• Pages légales : mentions légales, politique de confidentialité

Accessibilité

• Dark mode, police dyslexie, contraste élevé, texte agrandi
• Navigation clavier complète, lien d'évitement pour lecteurs d'écran
• Préférences persistées dans localStorage

Sécurité et anti-abus

• Honeypot anti-bot (champ caché côté serveur)
• hCaptcha optionnel (activé via variables d'environnement)
• Cooldown cookie signé HMAC-SHA256 entre deux soumissions
• Rate limiting par IP ou fingerprint (flask-limiter, Redis recommandé en production)
• Détection de flood (alerte log si dépassement du seuil sur 5 minutes)
• Fingerprinting non-PII : identifiant FingerprintJS hashé SHA-256, sans cookie tiers
• En-têtes de sécurité HTTP sur toutes les réponses (CSP, X-Frame-Options, etc.)
• Sanitisation XSS systématique des entrées (bleach)

---

Stack technique

Couche	Technologie
Frontend	React 18 · TypeScript · Vite 7 · Tailwind CSS · shadcn/ui · Wouter
Backend	Python 3.11+ · Flask 3 · Gunicorn
Base de données	PostgreSQL 15+ (psycopg2, sans ORM)
IA	Mistral AI (défaut) ou tout fournisseur compatible API OpenAI
Sécurité	flask-limiter · bleach · FingerprintJS · Redis (optionnel) · hCaptcha (optionnel)
Déploiement	Nginx · systemd

---

Installation

Prérequis

• Python 3.11+
• Node.js 20+ et pnpm
• PostgreSQL 15+
• Un compte Mistral AI (ou un fournisseur compatible OpenAI)

Variables d'environnement

Copier .env.example en .env et renseigner les valeurs :

cp .env.example .env
chmod 600 .env

Obligatoires :

Variable	Description
DATABASE_URL	Chaîne de connexion PostgreSQL — postgresql://user:pass@host:5432/db
MISTRAL_API_KEY	Clé API Mistral AI (ou OPENAI_API_KEY pour un fournisseur alternatif)

Recommandées en production :

Variable	Description
SECRET_KEY	Active le cooldown cookie signé HMAC-SHA256 — générer avec python3 -c "import secrets; print(secrets.token_hex(32))"
ADMIN_SECRET	Mot de passe Bearer token pour le panel /admin
REDIS_URL	Rate limiting persistant entre workers — redis://localhost:6379/0 (sinon stockage mémoire, non partagé)
VITE_APP_URL	URL publique du site, utilisée par le QR code du flyer
HCAPTCHA_SECRET_KEY	Active la vérification hCaptcha côté serveur
VITE_HCAPTCHA_SITE_KEY	Clé publique hCaptcha côté frontend (nécessite un rebuild)

Les modèles IA sont configurables via FILTER_MODEL (défaut : mistral-small-latest) et SYNTHESIS_MODEL (défaut : mistral-large-latest).

Développement local

# Prérequis : Node.js et PostgreSQL déjà installés
bash scripts/dev-local.sh

Le script installe automatiquement le virtualenv Python, les dépendances pip et pnpm, puis lance Flask sur le port 8080 et Vite sur le port 5173 en parallèle.

Pour accéder à l'interface depuis un poste distant :

ssh -L 5173:localhost:5173 -L 8080:localhost:8080 utilisateur@votre-serveur
# Puis ouvrir http://localhost:5173

Build frontend

cd artifacts/voix-du-peuple
pnpm install
pnpm build
# Résultat dans artifacts/voix-du-peuple/dist/public/

Pour configurer l'URL du QR code avant le build :

bash scripts/set-domain.sh https://votredomaine.fr

Déploiement en production

La procédure complète (PostgreSQL, Gunicorn, Nginx, systemd) est documentée dans docs/INSTALL_ROCKY.md pour Rocky Linux 9 / AlmaLinux 9 / RHEL 9. Les fichiers de configuration prêts à l'emploi se trouvent dans deploy/.

La base de données est initialisée automatiquement au premier démarrage du backend. Les migrations sont incrémentales et idempotentes — un redémarrage après mise à jour suffit.

---

Contribuer

Les contributions sont les bienvenues. Voir CONTRIBUTING.md pour les modalités.

---

Licence

EUPL-1.2 — voir fichier LICENSE.