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
+62 -5
View File
@@ -1,10 +1,19 @@
# Document d'Exploitation — La Voix du Peuple
**Version** : 1.0
**Version** : 1.1
**Date** : Avril 2026
---
## Historique des versions
| Version | Date | Modifications |
|---------|------|---------------|
| 1.0 | Avril 2026 | Version initiale |
| 1.1 | Avril 2026 | Ajout section flyer QR, export PDF, partage horodaté |
---
## 1. Démarrage et arrêt des services
### Sur Replit
@@ -83,8 +92,10 @@ git pull gitea main
# Mettre à jour les dépendances Python si requirements.txt a changé
pip install -r artifacts/flask-api/requirements.txt
# Reconstruire le frontend si le code frontend a changé
# Mettre à jour les dépendances Node si package.json a changé
pnpm install
# Reconstruire le frontend si le code frontend a changé
pnpm --filter @workspace/voix-du-peuple run build --config vite.config.selfhost.ts
# Redémarrer l'API
@@ -204,7 +215,49 @@ Modèles Mistral disponibles (avril 2026) :
---
## 8. Purge des données
## 8. Gestion du flyer QR code
La page `/flyer` génère un flyer A4 imprimable avec un QR code.
### Changer l'URL de destination
**Méthode 1 — Interface (sans code)** : ouvrir `/flyer`, modifier le champ "Destination du QR code", cliquer "Appliquer", puis imprimer.
**Méthode 2 — Paramètre URL** : ajouter `?url=` à l'adresse de la page, ex. :
```
https://lavoixdupeuple.fr/flyer?url=https://autresite.fr
```
**Méthode 3 — Modification permanente dans le code** : éditer la ligne 10 de `artifacts/voix-du-peuple/src/pages/flyer.tsx` :
```ts
const DEFAULT_QR_URL = "https://lavoixdupeuple.fr";
```
Reconstruire ensuite le frontend (`pnpm build`).
### Imprimer / exporter en PDF
Sur la page `/flyer`, cliquer **Imprimer / Exporter PDF**. La barre de configuration disparaît automatiquement à l'impression, seul le flyer A4 est produit. Pour obtenir un PDF, choisir "Enregistrer en PDF" dans la boîte de dialogue du navigateur.
---
## 9. Export de la synthèse
Deux boutons sont disponibles dans l'en-tête de la colonne de synthèse (page principale) :
### Partager / Copier
- Sur mobile (navigateurs supportant Web Share) : ouvre le menu de partage natif du système
- Sur bureau : copie le texte dans le presse-papier avec horodatage et compteur de contributions ; un message de confirmation apparaît
### PDF
Génère et ouvre une page HTML mise en page (tricolore, titre, date, texte de synthèse, pied de page) puis déclenche l'impression. Choisir "Enregistrer en PDF" dans la boîte de dialogue pour obtenir un fichier.
> Ces deux fonctions s'exécutent entièrement côté client — aucune donnée n'est envoyée au serveur.
---
## 10. Purge des données
```sql
-- Supprimer toutes les contributions (irréversible)
@@ -222,7 +275,7 @@ Après une purge, la synthèse se régénère automatiquement à la prochaine co
---
## 9. Dépannage courant
## 11. Dépannage courant
| Symptôme | Cause probable | Solution |
|----------|---------------|----------|
@@ -232,13 +285,17 @@ Après une purge, la synthèse se régénère automatiquement à la prochaine co
| Frontend vide (page blanche) | Build manquant ou `BASE_URL` incorrect | Relancer le build Vite, vérifier la config Nginx |
| Rate limit atteint (429) | Trop de soumissions depuis la même IP | Normal — attendre 1 minute |
| Modèle IA introuvable (404) | Nom de modèle incorrect dans `FILTER_MODEL` | Corriger le nom, redémarrer le service |
| QR code ne redirige pas | URL incorrecte dans le champ ou la constante | Vérifier `DEFAULT_QR_URL` dans `flyer.tsx`, ou passer `?url=` en paramètre |
| Bouton "Copier" sans retour visuel | Navigateur sans accès au presse-papier (HTTP non sécurisé) | Servir le site en HTTPS |
| Fenêtre PDF bloquée | Bloqueur de popups actif | Autoriser les popups pour ce site dans le navigateur |
---
## 10. Contacts et ressources
## 12. Contacts et ressources
- Documentation Mistral : https://docs.mistral.ai
- PostgreSQL : https://www.postgresql.org/docs/
- Flask : https://flask.palletsprojects.com
- qrcode.react : https://github.com/zpao/qrcode.react
- Guide de déploiement complet : `DEPLOIEMENT.md`
- Architecture : `docs/DAT.md`