# 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.