Fichiers
meteo-vercors/forum/README.md
T
Théo GastineletClaude Sonnet 5.5 ff42faca16 vercors.me : collecte Météo-France / Infoclimat / VP2, archive SQLite, accueil en carte, forum (squelette)
- collecte : collecter_meteofrance, extraire_infoclimat, extraire_vp2, archiver_historique, importer_opendata ; WeatherLink allégé (alleger)
- tests : meteofrance, infoclimat, vp2, archive, opendata (tous verts)
- maquettes/accueil-carte : sources de la maquette (générateurs de tuiles, page, À propos, CGU, confidentialité)
- forum : noyau local (rôles, droits, SQLite, serveur de test, 18 tests)
- deploy : Caddyfile.vercors.me.v2 (non appliqué)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-04 02:24:57 +01:00

70 lignes
5.9 KiB
Markdown

# Forum de vercors.me (noyau local)
Forum où le père de Théo et d'autres adhérents météo publient (ex. « Récapitulatif de la semaine »). **État : noyau local, rien de déployé, rien de publié, authentification simulée.**
## Choix techniques
- Python standard seulement (`http.server`, `sqlite3`, `unittest`) : comme `collecte/` du projet, aucune dépendance, facile à expliquer et à relire. Python 3.10 testé.
- SQLite : un fichier, sauvegarde simple, suffisant pour un forum d'adhérents. À revoir si la charge explose (peu probable).
- HTML généré côté serveur, sans JavaScript ni ressource distante, CSP stricte (`default-src 'none'`). Thème clair, coins carrés (`border-radius: 0`) pour cette maquette ; la DA finale est à caler sur le site vercors.me.
- Tout texte utilisateur est échappé (`html.escape`). Les POST exigent une origine identique à l'hôte (anti-CSRF), le cookie est `HttpOnly; SameSite=Strict`.
- Le serveur local n'écoute que sur `127.0.0.1`. Les journaux HTTP sont coupés (pas d'IP dans la sortie).
## Fichiers
| Fichier | Rôle |
|---|---|
| `roles.py` | rôles, tableau des droits, `peut(role, droit)` |
| `db.py` | schéma SQLite, catégories par défaut |
| `forum.py` | logique : sujets, messages, signalements, masquage, rôles, purge IP ; tout contrôlé par les droits |
| `server.py` | serveur HTTP local + pages + connexion simulée |
| `tests/test_forum.py` | 18 tests (droits de chaque rôle, modération, HTTP, purge IP) |
Lancer : `python forum/server.py --seed` puis `http://127.0.0.1:8940/test-login?u=adherent1` (aussi `modo1`, `admin1` ; tout autre identifiant crée un « membre »). Tests : `python -I forum/tests/test_forum.py`.
## Modèle de données
- `users` : `hub_id` (identifiant du compte Gastinel, unique), nom affiché, rôle (membre, adherent, moderateur, admin). Le visiteur n'a pas de ligne. Aucun e-mail ni mot de passe stocké : ils restent au Hub.
- `categories` : slug, nom, rôle minimal pour créer un sujet. Par défaut : **Récapitulatif de la semaine**, Observations, Discussion générale (toutes réservées aux adhérents pour créer un sujet).
- `topics` : catégorie, titre, auteur, `locked`, `hidden`.
- `posts` : sujet, auteur, texte, `edited_at`, `hidden`, `ip` (purgeable).
- `reports` : signalement d'un message (motif, un seul par personne et par message).
- Prévu plus tard : table `attachments` (nom, type, taille, SHA-256, chemin) ; taille et types à limiter, stockage hors dossier web.
## Rôles et droits
| Droit | Visiteur | Membre | Adhérent météo | Modérateur | Admin |
|---|---|---|---|---|---|
| Lire sujets et messages | oui | oui | oui | oui | oui |
| Répondre (sujet non verrouillé) | non | oui | oui | oui | oui |
| Modifier son propre message | non | oui | oui | oui | oui |
| Signaler un message | non | oui | oui | oui | oui |
| Créer un sujet (selon catégorie) | non | non | oui | oui | oui |
| Masquer/afficher messages et sujets | non | non | non | oui | oui |
| Verrouiller un sujet | non | non | non | oui | oui |
| Voir les contenus masqués et les signalements | non | non | non | oui | oui |
| Changer le rôle d'un utilisateur | non | non | non | non | oui |
Le visiteur est un navigateur sans compte. Un administrateur ne peut pas se rétrograder lui-même. L'attribution du rôle « adhérent » est faite par un administrateur (voir « À décider »).
## Modération
- Un membre signale un message avec un motif ; les modérateurs voient la liste sur `/moderation`.
- **Masquer** plutôt que supprimer : le contenu reste en base, invisible du public et du membre, visible des modérateurs, réversible. Pas de suppression définitive pour l'instant.
- Verrouillage d'un sujet : plus de réponses.
## RGPD (à faire valider par Théo)
- Données minimales : identifiant Hub, nom affiché, rôle, contenus publiés.
- Adresse IP : enregistrée avec chaque message pour la personnalisation, **conservée 13 mois**, puis effacée par `Forum.purger_ips(13)` (testé). Il reste à planifier cette purge (tâche périodique) et à l'indiquer dans la politique de confidentialité.
- Aucun usage des données hors du service lui-même (principe de Théo : pas d'entraînement, pas de publicité).
- Suppression du compte Hub : à relier (anonymiser le nom affiché, garder ou retirer les messages : à décider).
## Intégration avec le Hub (Gastinel)
État du Hub lu dans `5-infra/hub-comptes/docs/hub-comptes.md` : e-mail + mot de passe ou Google, jetons `Bearer` ou cookie `__Host-`, `GET /api/public/account` renvoie le compte (dont `email_verified`). « Se connecter avec Gastinel » (OpenID Connect fournisseur) est **prévu mais pas construit** ; aujourd'hui une appli peut utiliser `POST /api/public/auth/login` et le jeton `Bearer`. Je n'ai pas lu le code Go ni de secret.
Flux proposé (quand OIDC existera) : visiteur clique « Se connecter » -> redirection vers le Hub (code + PKCE) -> retour sur le forum avec le code -> le forum échange le code, lit l'identifiant du compte (`sub`) et le nom -> `Forum.utilisateur(sub, nom)` crée la ligne `users` (rôle membre) -> cookie de session du forum. Seul le point d'entrée `Handler.utilisateur()` de `server.py` change ; la logique et les droits restent identiques. Les rôles restent gérés dans le forum.
## À décider par Théo
1. Hub : attendre OIDC fournisseur, ou utiliser tout de suite le jeton `Bearer` du Hub côté serveur ?
2. Le forum exige-t-il une adresse e-mail vérifiée (`email_verified`) pour devenir membre ? Et le numéro vérifié ?
3. Comment devient-on « adhérent météo » : attribution manuelle par un admin (proposé), liste fournie par l'association, ou demande dans le forum ?
4. Les visiteurs voient-ils toutes les catégories ? Les membres peuvent-ils répondre dans « Récapitulatif » ?
5. Pièces jointes : types, taille, stockage.
6. Où l'héberger (VPS, Caddy, domaine `forum.vercors.me` ou `vercors.me/forum`) : aucun déploiement fait.
7. Politique de suppression de compte et texte RGPD.