Update documentation with new features and improved usability

Update several documentation files (.toml, .md) to reflect new features such as a QR code flyer page, share/PDF export buttons, and dependency updates, including version increments to v1.1.

Replit-Commit-Author: Agent
Replit-Commit-Session-Id: 923ae0e3-a363-4db8-b04a-e8baca2a1330
Replit-Commit-Checkpoint-Type: full_checkpoint
Replit-Commit-Event-Id: 88b9da52-be77-4c86-854b-f097a8c7ae86
Replit-Commit-Screenshot-Url: https://storage.googleapis.com/screenshot-production-us-central1/8af7d2ec-2cc3-4ece-8af3-9f071488d072/923ae0e3-a363-4db8-b04a-e8baca2a1330/Z3YUti7
Replit-Helium-Checkpoint-Created: true
This commit is contained in:
pironantoine
2026-04-04 10:27:58 +00:00
parent 7e9eb3c360
commit f72a64f23e
5 changed files with 188 additions and 23 deletions
+26 -4
View File
@@ -4,7 +4,8 @@
**Stack** : Python / Flask · React / Vite · PostgreSQL · Mistral AI
**Hébergement** : Replit (dev) / Auto-hébergeable (RockyLinux, Debian)
**Dépôt** : `voix-du-peuple` (Gitea)
**Statut** : Actif — avril 2026
**Statut** : Actif — avril 2026
**Version doc** : 1.1
---
@@ -15,18 +16,20 @@ Un outil permettant à des citoyens de soumettre des propositions politiques en
- **filtrées** automatiquement par une IA selon les textes internationaux des droits humains (DUDH, PIDCP, CEDH…)
- **synthétisées** en un résumé structuré par thèmes, destiné à des élus ou décideurs
- **affichées** en temps réel sur la page principale
- **exportables** : copie horodatée dans le presse-papier, PDF mise en page, ou flyer A4 avec QR code pour diffusion physique
L'objectif est de fournir aux représentants politiques un document clair et utilisable issu des préoccupations citoyennes, sans intermédiaire.
---
## Fonctionnement en 5 points
## Fonctionnement en 6 points
1. Un citoyen saisit une proposition sur la page principale
2. L'IA (Mistral Small) vérifie que le contenu respecte les droits fondamentaux
3. Si la contribution est acceptée, elle s'ajoute à la base et déclenche une re-synthèse
4. L'IA (Mistral Large) relit toutes les contributions et produit un résumé thématique
5. Le résumé s'affiche en temps réel à droite de l'écran
6. Le résumé peut être partagé (texte horodaté), exporté en PDF, ou diffusé via un flyer QR imprimable
---
@@ -34,9 +37,26 @@ L'objectif est de fournir aux représentants politiques un document clair et uti
| URL | Contenu |
|-----|---------|
| `/` | Formulaire de soumission + contributions récentes + synthèse |
| `/` | Formulaire de soumission + contributions récentes + synthèse (avec boutons Partager / PDF) |
| `/about` | Description du projet et fondements juridiques |
| `/transparence` | Fonctionnement de l'IA, données collectées, limites |
| `/flyer` | Flyer A4 imprimable avec QR code configurable pour diffusion physique |
---
## Fonctionnalités d'export et de diffusion
### Partager la synthèse
Bouton dans l'en-tête de la colonne de synthèse. Sur mobile : partage natif (WhatsApp, mail…). Sur bureau : copie dans le presse-papier avec date et heure.
### Exporter en PDF
Bouton "PDF" dans la même zone. Ouvre une fenêtre avec le résumé mis en page (tricolore, titre, date, texte, pied de page) pour impression ou export PDF depuis le navigateur.
### Flyer QR imprimable
Page `/flyer` : flyer format A4 avec grand QR code. L'URL encodée est modifiable :
- Via le champ texte en haut de la page (sans recharger)
- Via le paramètre URL `/flyer?url=https://monsite.fr`
- En modifiant la constante `DEFAULT_QR_URL` dans `src/pages/flyer.tsx`
---
@@ -50,6 +70,7 @@ L'objectif est de fournir aux représentants politiques un document clair et uti
| IA | Mistral AI (API OpenAI-compatible) |
| Modération | `mistral-small-latest` |
| Synthèse | `mistral-large-latest` |
| QR code | `qrcode.react` |
| Police | Bahnschrift (titres), Inter (corps) |
---
@@ -75,6 +96,8 @@ SYNTHESIS_MODEL — Modèle de synthèse (optionnel)
**Non collecté** : adresse IP, compte utilisateur, cookies de suivi.
**Export / partage** : entièrement côté client, rien n'est envoyé au serveur lors d'un partage ou d'un export PDF.
---
## Liens
@@ -82,5 +105,4 @@ SYNTHESIS_MODEL — Modèle de synthèse (optionnel)
- Tutoriel Gitea → [`docs/GITEA_TUTO.md`](./GITEA_TUTO.md)
- Architecture technique → [`docs/DAT.md`](./DAT.md)
- Exploitation → [`docs/DEX.md`](./DEX.md)
- Guide déploiement → [`DEPLOIEMENT.md`](../DEPLOIEMENT.md)
- Fonctionnement technique (in-app) → `/transparence`