Refonte de Codex (interrompue par son quota), reprise et finie par Claude : dates en français à l'heure de Paris, « Aucune réponse » / « Aucune publication ». 69 tests OK. En essai sur le forum LAN :32, pas en ligne. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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_sessionHttpOnly 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éfautforum-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-loginet--seed: seulement avecFORUM_MODE_TEST=1, et/test-loginseulement depuis 127/8, 10/8, 192.168/16 ou ::1.X-Forwarded-Forn'est cru que d'un relais de confiance (127.0.0.1 par défaut). Ne jamais poserFORUM_MODE_TESTen production.- Demandes d'adhésion :
/adhesion(message + 10 photos / 25 Mo, métadonnées retirées, photos hors du dossier public),/adhesionspour le propriétaire et l'adjoint ; méthodesdemander_adhesion,demandes_adhesion,demande_adhesion,decider_adhesion,photo_adhesiondansforum.pypour 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.caddyforceCache-Control: no-storesur 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 à laredirect_uripar défaut (https://vercors.me<préfixe>/connexion/retour, sinonFORUM_REDIRECT_URI). Le serveur accepte les requêtes avec ou sans préfixe : Caddy peut le retirer (handle_path) ou non.--hote(défaut127.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-Forest 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 propreFORUM_PANNEAU_REDIRECT_URI(défauthttp://localhost:<port>/connexion/retour), à déclarer au Hub. Aucune inscription : seuls les comptes déjà connus ayant le droitgerer_rolesentrent. Cookiepanneau_sessionpropre (1 jour, sansSecuresi 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,/adhesionset/validationdu forum public restent en attendant ; le panneau les remplace.
Choix techniques
- Python standard seulement (
http.server,sqlite3,unittest) : commecollecte/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 estHttpOnly; 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
- Hub : attendre OIDC fournisseur, ou utiliser tout de suite le jeton
Bearerdu Hub côté serveur ? - Le forum exige-t-il une adresse e-mail vérifiée (
email_verified) pour devenir membre ? Et le numéro vérifié ? - Comment devient-on « adhérent météo » : attribution manuelle par un admin (proposé), liste fournie par l'association, ou demande dans le forum ?
- Les visiteurs voient-ils toutes les catégories ? Les membres peuvent-ils répondre dans « Récapitulatif » ?
- Pièces jointes : types, taille, stockage.
- Où l'héberger (VPS, Caddy, domaine
forum.vercors.meouvercors.me/forum) : aucun déploiement fait. - Politique de suppression de compte et texte RGPD.