Un début de doc pour configurer Mailman

services/mail/services/listes.md

@@ -0,0 +1,46 @@
+# Listes de diffusion - mailing-lists
+
+En plus des comptes mails individuels, le Crans propose un service de mailing-lists, listes de diffusion en bon français, accessible [ici](https://lists.crans.org/postorius/lists/). Actuellement (juin 2025), le service est propulsé par Mailman 3 et l'interface d'administration utilise, au choix, Postorius ou Hyperkitty. tourne sous NixOS 24.11
+
+## Filtre anti-bots
+
+Une fenêtre pop-up doit apparaître lorsque l'on se rend sur l'URL ci-dessus. L'identifiant et le mot de passe sont simples pour un humain et donnés en cas d'échec de connexion.
+
+## Comptes
+
+Mailman dispose de ses propres comptes et il n'est pas nécessaire de disposer d'un compte Crans pour utiliser le service. Il est en revanche possible d'utiliser un compte Crans pour contrôler un compte Mailman, à travers une OAuth.
+
+Toute personne, même non adhérente au Crans ou extérieure à l'ENS peut créer un compte sur Mailman. À un compte Mailman, on peut associer plusieurs adresses mail, selon ses besoins ou envies.
+
+Enfin, pour être simplement abonné à une liste, il n'y a aucune condition particulière à remplir.
+
+## Droits sur les listes
+
+Les nounous peuvent créer de nouvelles listes, sur demande d'adhérents ou de clubs. Il est demandé aux requérants d'envoyer leur demande sur l'adresse des nounous pour garder une trace.
+
+Chaque liste a ses abonnés, ses propriétaires et ses modérateurs. Les propriétaires peuvent 
+- abonner ou désabonner des adresses mail, 
+- changer les critères de modération automatique (acceptation/rejet/mise en attente),
+- modérer les messages.
+
+Le rôle des modérateurs est de filtrer les messages mis en attente de distribution (envoi par un non abonné, message trop volumineux, les critères varient).
+
+## Messages automatiques et modération
+
+Lorsqu'un message envoyé à une liste est mis en attente d'être modéré, un email est automatiquement envoyé aux modérateurs de la liste. Cet email automatique admet une forme par défaut (qui vient avec l'installation de Mailman), mais il est possible de modifier le format pour le rendre plus lisible et accessible à des novices, qui ne savent pas nécessairement quoi faire.
+
+Un événement déclencheur (abonnement, désabonnement, message en modération, bounce score qui augmente, etc) a son propre mail automatique, dont le template peut être modifié. Chacun de ces templates a trois scopes qui sont appliqués avec une priorité décroissante : 
+- liste (ex : nom_de_votre_liste@lists.crans.org)
+- domaine (ex : lists.crans.org)
+- site (l'installation courante de Mailman).
+
+De fait, le niveau intermédiaire n'a pas d'intérêt pour le Crans, puisqu'on ne gère qu'un seul domaine. (Et de toute façon, on a essayé de trouver où poser le template et on a pas trouvé.)
+
+Un template doit 
+- être nommé en suivant une syntaxe précise (cf la [doc officielle](https://docs.mailman3.org/projects/mailman/en/latest/src/mailman/rest/docs/templates.html))
+- utiliser les mêmes noms de variables que Mailman, codées en dur,
+- être placé dans le bon dossier, avec le bon nom, sinon il ne sera pas lu.
+
+Un template global pour les messages de modération au niveau de Mailman a été placé sur la VM Mailman dans `/var/lib/mailman3/templates/sites/fr` et nommé, comme le veut la convention, `list:admin:action:post.txt`. Ce message est d'une importance particulière, compte tenu du nombre de débutants utilisant le service chaque année.
+
+Un template de footer pourrait être inclus, dans `list:member:regular:footer.txt` avec un lien permettant de se désabonner.

services/mail/services/mail.md

@@ -9,7 +9,7 @@ redirections mails.
 ## Installation
 
 Pour installer le logiciel, il faut cloner le répertoire git
-`https://gitlab.crans.org/nounous/mail.git` . Actuellement la convention veut
+`https://gitlab.crans.org/nounous/mail.git`. Actuellement la convention veut
 que les services soient placé sous le chemin `/var/local/services/` mais rien ne
 l'impose. Pour tourner  le script a besoin du paquet `python3-jinja2`. Il faut
 aussi crééer le dossier `generated` à la racine du dépot dans lequel seront