Fichiers
meteo-vercors/forum
Théo GastineletClaude Opus 5.5 617ca808a2 Forum : menu Sujets/Stations/Se connecter retiré, bouton « Retour » dans le chemin du sujet
Demande de Théo. Connecté : le pseudo mène au compte, le menu ne garde que
Mon compte, Adhésion et les liens de gestion selon le rôle. Le bouton Retour
renvoie à la page précédente du forum (même site), sinon à la liste. 70 tests OK.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 23:15:35 +01:00
..

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 : rien de déployé. Connexion « Se connecter avec Gastinel » codée (OAuth 2 code + PKCE), en attente du Hub en ligne.

Connexion Gastinel et mode essai (05/11/2026)

  • connexion.py : client OAuth (state + PKCE S256, /oauth/autoriser, /oauth/jeton, /oauth/moi -> {id, pseudo}), sans dépendance.
  • Session : cookie forum_session HttpOnly Secure SameSite=Lax, 30 jours ; seul le SHA-256 de l'identifiant est en base. Déconnexion en POST.
  • Variables : FORUM_PREFIXE, FORUM_HUB_URL, FORUM_CLIENT_ID (défaut forum-vercors), FORUM_REDIRECT_URI, FORUM_OAUTH_SECRET (ou _FILE, facultatif), FORUM_PROPRIETAIRE_ID (id Gastinel de Théo -> rôle Propriétaire), FORUM_RELAIS (relais de confiance en plus de 127.0.0.1), FORUM_MODE_TEST=1.
  • /test-login et --seed : seulement avec FORUM_MODE_TEST=1, et /test-login seulement depuis 127/8, 10/8, 192.168/16 ou ::1. X-Forwarded-For n'est cru que d'un relais de confiance (127.0.0.1 par défaut). Ne jamais poser FORUM_MODE_TEST en production.
  • Demandes d'adhésion : /adhesion (message + 10 photos / 25 Mo, métadonnées retirées, photos hors du dossier public), /adhesions pour le propriétaire et l'adjoint ; méthodes demander_adhesion, demandes_adhesion, demande_adhesion, decider_adhesion, photo_adhesion dans forum.py pour le futur panneau LAN.
  • Fiche de station (page station de vercors.me) : GET /forum/api/station/<id>.json, publique, lecture seule, sans cookie, cache mémoire 60 s vidé à chaque changement + Cache-Control: public, max-age=300. Renvoie {"station", "sujet": "/forum/t/N" ou null, "photos": [{"url": "/forum/photo/<sha>.ext", "auteur"}]} (3 photos au plus, déjà nettoyées à l'envoi ; pas de vignette réduite, la page les réduit). Épinglage : bouton « Épingler sur la fiche » sous chaque photo du sujet de la station (POST /fiche-photo), pour le Propriétaire, l'adjoint et le propriétaire de CETTE station. Une photo masquée (message ou sujet) disparaît de la fiche. Attention : vercors-forum.caddy force Cache-Control: no-store sur tout /forum* ; le cache navigateur de la route ne joue qu'une fois ce point revu.
  • Tests : cd forum && python -m unittest (61 tests, Hub simulé par un faux serveur local).

Production : préfixe et écoute

  • FORUM_PREFIXE (ex. /forum, défaut vide) est appliqué à tous les liens, formulaires, redirections, chemins de cookie et à la redirect_uri par défaut (https://vercors.me<préfixe>/connexion/retour, sinon FORUM_REDIRECT_URI). Le serveur accepte les requêtes avec ou sans préfixe : Caddy peut le retirer (handle_path) ou non.
  • --hote (défaut 127.0.0.1) : adresse d'écoute ; derrière Caddy, ne pas y toucher. Exemple : FORUM_PREFIXE=/forum python forum/server.py --port 8940.

Panneau LAN de gestion (panneau.py)

Second serveur, sur la même base et le même dossier de photos que le forum, réservé au Propriétaire et au Propriétaire adjoint.

  • Lancer : FORUM_HUB_URL=... FORUM_PROPRIETAIRE_ID=... FORUM_PANNEAU_REDIRECT_URI=http://<ip-lan>:8790/connexion/retour python forum/panneau.py --db <base du forum> --photos <dossier photos du forum> [--port 8790] [--hote 0.0.0.0].
  • Toute IP hors 127/8, 10/8, 192.168/16, ::1 reçoit 403 ; seule l'adresse de la connexion TCP compte, X-Forwarded-For est ignoré (ne pas placer le panneau derrière un relais public).
  • Connexion avec le compte Gastinel (même client OAuth, mêmes variables FORUM_HUB_URL, FORUM_CLIENT_ID, FORUM_OAUTH_SECRET[_FILE]) ; adresse de retour propre FORUM_PANNEAU_REDIRECT_URI (défaut http://localhost:<port>/connexion/retour), à déclarer au Hub. Aucune inscription : seuls les comptes déjà connus ayant le droit gerer_roles entrent. Cookie panneau_session propre (1 jour, sans Secure si l'adresse de retour est en http), jetons séparés de ceux du forum.
  • Pages : utilisateurs avec badges et don/retrait de rôle (roles.peut_donner : seul le Propriétaire nomme un adjoint, personne ne donne « Propriétaire »), demandes d'adhésion avec message et photos (accepter/refuser), sujets de station à valider, signalements. Tous les POST portent un jeton CSRF lié à la session, en plus du contrôle d'origine.
  • Les pages /roles, /adhesions et /validation du forum public restent en attendant ; le panneau les remplace.

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 du forum + pages + connexion Gastinel
panneau.py panneau LAN de gestion (propriétaires)
connexion.py client OAuth Gastinel, réglages, adresses LAN
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.