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:
+62
-5
@@ -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`
|
||||
|
||||
Reference in New Issue
Block a user