docs(logs): document the server summary event

astro.config.mjs

@@ -361,5 +361,6 @@ export default defineConfig({
     "/automod": "/configuration/automod",
     "/beta": "/getting-started/beta/",
     "/premium": "/premium/introduction/",
+    "/mod/moderation": "/mod/sanctions/",
   },
 });

src/content/docs/configuration/honeypot/index.mdx

@@ -21,11 +21,11 @@ Le **honeypot** est un piège à robots spammeurs : un salon "invisible" aux yeu
 
 3. Choisir l'une des deux options depuis le panneau affiché :
     - **Sélectionner un salon existant** dans le menu déroulant pour l'utiliser comme piège
-    - **Créer un salon automatiquement** via le bouton dédié (nommé `ne-pas-écrire-XXXXX`, visible par tout le monde)
+    - **Créer un salon automatiquement** via le bouton dédié (visible par tout le monde)
 </Steps>
 
-<Aside type="tip" title="Pourquoi ce nom ?">
-  Le nom `ne-pas-écrire-XXXXX` a deux rôles : le texte prévient un membre humain qui tomberait dessus par erreur, et le numéro aléatoire évite qu'un robot spammeur reconnaisse et évite un nom de salon toujours identique d'un serveur à l'autre.
+<Aside type="tip" title="Le nom du salon créé">
+  Le salon créé reçoit un nom tiré au hasard parmi `ne-pas-écrire`, `ne-rien-écrire-ici` et `ne-pas-poster-ici`. Chaque nom prévient un membre humain qui tomberait dessus par erreur, et le nom varie d'un serveur à l'autre pour qu'un robot spammeur ne puisse pas apprendre un nom unique et l'éviter. Vous pouvez le renommer librement.
 </Aside>
 
 <Aside type="note" title="Par défaut">
@@ -52,6 +52,10 @@ Depuis le panneau `/paramètres honeypot`, un bouton permet d'activer ou de dés
 
 Si vous avez [activé les logs](/configuration/logs) et l'évènement **Honeypot déclenché**, chaque bannissement déclenché par le honeypot est envoyé dans votre salon de logs, avec le membre concerné, la date de création de son compte et le salon piège concerné. Les changements de configuration du honeypot (salon choisi, création, activation/désactivation) suivent ce même évènement.
 
+Quand le honeypot est actif mais que ses bannissements ne sont pas enregistrés, le panneau `/paramètres honeypot` le signale :
+- si un salon des logs existe déjà, le bouton **Activer les logs du honeypot** active les logs et l'évènement **Honeypot déclenché** en un clic ;
+- si aucun salon des logs n'est configuré, un menu permet d'en choisir un, ce qui active aussi les logs et l'évènement. Sans salon des logs, rien n'est envoyé.
+
 ## Permissions du robot
 
 Pour que le honeypot fonctionne correctement, Mr. Robøt doit disposer des permissions suivantes :

src/content/docs/configuration/logs/events.mdx

@@ -17,7 +17,7 @@ Mr. Robøt vous permet de configurer les évènements à logger sur votre serveu
     /paramètres logs
     ```
 
-3. Choisir les évènements à logger dans le menu déroulant du panneau affiché
+3. Choisir le salon des logs dans le menu **Choisir le salon des logs**, puis les évènements à logger dans le menu déroulant du panneau affiché
     ![Message de Mr. Robøt pour configurer les évènements à logger](/img/logs-add-remove-events.png)
 
 4. Tester si vous le souhaitez la connexion en cliquant sur le bouton **Tester le webhook** du même panneau
@@ -41,6 +41,25 @@ Vous avez une multitude d'évènements à votre disposition pour lesquels vous p
 - **Annonce créée** : Une annonce est créée via une commande de modération.
 - **Urgence déclenchée** : Un mode lent d'urgence est appliqué sur un salon via la commande [`/urgence`](/configuration/urgence).
 - **Mode Protection activé** : Le [Mode Protection](/configuration/urgence/#mode-protection) est activé sur le serveur.
+- **Bilan du serveur** : Un bilan de la veille ou de la semaine passée (voir ci-dessous).
+
+## Bilan du serveur
+
+Une fois le bilan activé, Mr. Robøt envoie dans le salon des logs, sans notifier personne, un bilan de la journée précédente (chaque jour) ou de la semaine précédente, du lundi au dimanche (chaque lundi) :
+
+- le nombre de messages envoyés ;
+- le nombre d'insultes détectées et la part des messages qui en contenaient ;
+- les bannissements, expulsions et sourdines, s'il y en a eu ;
+- le nombre de signalements, s'il y en a eu ;
+- les trois membres ayant le plus insulté.
+
+Pour les messages, les insultes et les sanctions, l'évolution par rapport à la veille (ou à la semaine précédente) est indiquée, par exemple « +120 par rapport à la veille (+10,3 %) ».
+
+Pour l'activer, choisissez la fréquence dans le menu **Fréquence du bilan** du panneau `/paramètres logs` : **Bilan : chaque jour** ou **Bilan : chaque lundi**. Choisissez ensuite l'heure d'envoi dans le menu suivant : 6h, 9h, 12h, 17h, 20h ou 23h (heure de Paris), 9h par défaut. Choisissez **Bilan : désactivé** pour l'arrêter. Cocher l'évènement **Bilan du serveur** dans la liste des évènements l'active aussi, chaque jour à 9h par défaut.
+
+Le bouton **Prévisualiser le bilan** du même panneau affiche, à vous seul, le bilan tel qu'il serait envoyé.
+
+Aucun bilan n'est envoyé pour une journée sans activité, ni tant que les logs sont désactivés.
 
 ## Activer ou désactiver un évènement
 

src/content/docs/configuration/logs/index.mdx

@@ -25,36 +25,31 @@ Vous pouvez choisir les évènements à logger et le salon textuel où les logs
     /paramètres logs
     ```
 
-3. Un salon de logs (webhook) est créé automatiquement si aucun n'existe encore, puis choisir les évènements à logger dans le menu déroulant du panneau affiché
+3. Choisir le salon des logs dans le menu **Choisir le salon des logs** du panneau affiché, de préférence un salon réservé à la modération
+
+4. Choisir les évènements à logger dans le menu déroulant du même panneau
     ![Message de Mr. Robøt pour configurer les évènements à logger](/img/logs-add-remove-events.png)
 
-4. Tester si vous le souhaitez la connexion en cliquant sur le bouton **Tester le webhook** du même panneau
+5. Tester si vous le souhaitez la connexion en cliquant sur le bouton **Tester le webhook** du même panneau
 </Steps>
 
+<Aside type="note" title="Aucun salon choisi">
+  Le robot ne choisit jamais le salon des logs à votre place. Tant qu'aucun salon n'est choisi, le panneau affiche **Salon des logs : aucun** et aucun log n'est envoyé.
+</Aside>
+
 ## Déplacer le salon des logs
 
-<Steps>
-  1. Pour pouvoir déplacer le salon des logs, vous devez simplement modifier le salon textuel choisi en allant dans **Paramètre du serveur > Intégrations > Mr. Robøt > Webhooks**.
-  2. Sélectionnez le salon où vous souhaitez que les logs soient envoyés.
-     ![Déplacer le salon des logs](/img/logs_edit_webhook.png)
-  3. Cliquez sur **Enregistrer les modifications**.
-</Steps>
+Choisissez un autre salon dans le menu **Choisir le salon des logs** du panneau `/paramètres logs`. Vous pouvez aussi indiquer le salon directement dans la commande :
 
+```
+/paramètres logs salon:#mod-logs
+```
 
-## J'ai supprimé le salon des logs
+Le robot crée son webhook sur le nouveau salon et supprime l'ancien.
 
-Oh... ça peut arriver, pas de panique ! Pour régénérer le webhook, suivez les étapes suivantes :
+## J'ai supprimé le salon des logs
 
-<Steps>
-  1. Exécutez la commande
-      ```
-      /paramètres logs
-      ```
-  2. Vous devriez voir un message vous indiquant le nouveau salon des logs et une aide, ainsi qu'un message qui s'envoie dans le salon des logs.
-     ![Message du robot Discord indiquant les étapes à suivre pour configurer salon des logs](/img/logs_generate_webhook_first_time.png)
-  3. Vous pouvez également tester la connexion du webhook en cliquant sur le bouton **Tester le webhook** du panneau affiché
-  4. Tout est bon, vous avez régénéré le webhook avec succès ! 🎉
-</Steps>
+Oh... ça peut arriver, pas de panique ! Le panneau `/paramètres logs` affiche alors **Salon des logs : aucun**. Choisissez un nouveau salon dans le menu **Choisir le salon des logs**, puis testez si vous le souhaitez la connexion avec le bouton **Tester le webhook**.
 
 ## Résolution des problèmes
 
@@ -65,7 +60,7 @@ Veuillez vérifiez :
 - Que le robot est bien connecté à votre serveur Discord
 - Que vous avez bien suivi les instructions du robot
 - Que vous avez bien choisi les évènements à logger, vous pouvez voir la liste des évènements disponibles avec la commande `/paramètres logs`
-- Que le salon textuel choisi pour les logs est toujours présent, si ce n'est plus le cas, régénérez le webhook avec la commande `/paramètres logs`
+- Qu'un salon des logs est bien choisi dans le panneau `/paramètres logs`, et qu'il existe toujours. Si ce n'est plus le cas, choisissez-en un nouveau dans le même panneau
 
 ## La permission Gérer les webhooks
 

src/content/docs/getting-started/faq.mdx

@@ -23,7 +23,7 @@ Non. Il est pour le moment impossible d'avoir sa propre liste de mots bannis.
 Cette liste est celle par défaut.
 Voici donc les insultes :
 
-> "salope", "sallope", "saloppe", "salo", "putain", "putin", "pute", "putte", "putasse", "pd", "pédé", "pétasse", "tamer", "connard", "conard", "conar", "connasse", "conasse", "connase", "konar", "batard", "batarde", "batar", "fdp", "ntm", "tarlouze", "pédalle", "tg", "sal0pe", "sall0pe", "saloope", "salo0pe", "s@l0pe", "s@lope", "enfoiré", "nazi", "tocard", "bouffon", "pt1", "ptn", "fils de pute", "fils de putes", "fils de p", "3nculé", "c*n", "c0n", "cøn", "c@nn", "c@nne", "c@nnes", "bât@rd", "b@stard", "va te faire foutre", "vtf", "pauvre type", "enculé", "baltringue", "trou d'bal", "sal*p€", "sl*pe", "sa|ope", "salo|pe", "s@lo|pe", "s@l0|pe", "sal@p€", "salp€", "sal$pe", "pedalle", "итм", "pede", "konnard", "taré", "tare", "raclure", "fiotte", "gouine", "travelo", "nique ta mère", "nique ta mere", "sac à merde", "sac a merde", "fils de chien", "c0nnard", "k0nnard", "enkulé", "encul3", "3nkulé", "put1", "p*tain", "p@tain", "b4tard", "batard3", "pd3", "p3d3", "bougnoule", "négro", "negro", "va crever", "ferme ta gueule", "ta gueule", "put3", "salop3", "k0nard", "konnar0", "encul", "encul3r", "youpin", "chinetoque", "sous-merde", "enflure"
+> "salope", "sallope", "saloppe", "salo", "putain", "putin", "pute", "putte", "putasse", "pd", "pédé", "pétasse", "tamer", "connard", "conard", "conar", "connasse", "conasse", "connase", "konar", "batard", "batarde", "batar", "fdp", "ntm", "tarlouze", "pédalle", "tg", "sal0pe", "sall0pe", "saloope", "salo0pe", "s@l0pe", "s@lope", "enfoiré", "nazi", "tocard", "bouffon", "pt1", "ptn", "fils de pute", "fils de putes", "fils de p", "3nculé", "c*n", "c0n", "cøn", "c@nn", "c@nne", "c@nnes", "bât@rd", "b@stard", "va te faire foutre", "vtf", "pauvre type", "enculé", "baltringue", "trou d'bal", "sal*p€", "sl*pe", "sa|ope", "salo|pe", "s@lo|pe", "s@l0|pe", "sal@p€", "salp€", "sal$pe", "pedalle", "итм", "pede", "konnard", "taré", "tare", "raclure", "fiotte", "gouine", "travelo", "nique ta mère", "nique ta mere", "sac à merde", "sac a merde", "fils de chien", "c0nnard", "k0nnard", "enkulé", "encul3", "3nkulé", "put1", "p*tain", "p@tain", "b4tard", "batard3", "pd3", "p3d3", "bougnoule", "négro", "negro", "va crever", "ferme ta gueule", "ta gueule", "put3", "salop3", "k0nard", "konnar0", "encul", "encul3r", "youpin", "chinetoque", "sous-merde", "enflure", "je t'encule", "enculer", "t'enculer", "enculerai", "t'enculerai", "enculera", "encules", "enculez", "enculée"
 
 ## Soucis avec les logs
 

src/content/docs/mod/sanctions.mdx

@@ -0,0 +1,34 @@
+---
+title: Consulter les sanctions d'un membre
+description: Découvrez comment utiliser la commande /sanctions de Mr. Robøt pour consulter la fiche de modération d'un membre de votre serveur Discord.
+---
+
+La commande `/sanctions` affiche la fiche de modération d'un membre sur **ce serveur** : bannissements, sourdines, messages insultants, spam, ciblage répété.
+
+Pour les statistiques globales du serveur, voir [`/statistiques`](/mod/statistiques). Pour gérer les rôles d'un membre, voir [`/rôles`](/mod/roles).
+
+## Utilisation
+
+```
+/sanctions <membre>
+```
+
+- `membre` : Le membre dont vous voulez voir l'historique de modération.
+
+## Contenu de la fiche
+
+La fiche affiche un verdict (**SAIN**, **À SURVEILLER** ou **À RISQUE**), calculé à partir d'un score de gravité qui pondère chaque type d'évènement et son ancienneté : un bannissement récent pèse bien plus qu'une insulte isolée d'il y a plusieurs mois.
+
+Un résumé automatique en une phrase et un décompte par type sont affichés en premier, suivis du nombre de messages insultants envoyés par le membre sur les 15 et 30 derniers jours. Un message compte **une seule fois**, même s'il contient plusieurs insultes, et même s'il est détecté à la fois par le filtre classique et par l'IA (dans ce cas, il est compté comme détecté par l'IA). Le détail complet, avec la date, le modérateur responsable (ou "Automatique" pour une détection) et la raison de chaque évènement, est disponible derrière le bouton **Voir l'historique complet**, paginé si l'historique est long.
+
+Les membres et modérateurs sont affichés avec leur nom sur le serveur, en lien vers leur profil Discord. Une personne qui a quitté le serveur apparaît avec la mention « (a quitté le serveur) ».
+
+Si le membre est toujours présent sur le serveur, un bouton **Expulser temporairement** (mise en sourdine) permet d'enchaîner directement sur une sanction sans retaper de commande.
+
+:::note
+Aucun contenu de message n'est conservé dans cet historique, uniquement des informations contextuelles (type, salon, durée). L'historique est conservé 90 jours, puis purgé automatiquement.
+:::
+
+## Permission
+
+Permission par défaut : **Gérer les messages**.

src/content/docs/mod/statistiques.mdx

@@ -0,0 +1,34 @@
+---
+title: Consulter les statistiques du serveur
+description: Découvrez comment utiliser la commande /statistiques de Mr. Robøt pour consulter les statistiques de modération, les arrivées et les départs de votre serveur Discord.
+---
+
+La commande `/statistiques` affiche des statistiques globales de modération pour **l'ensemble du serveur**, sans ciblage individuel.
+
+Pour l'historique de modération d'un membre, voir [`/sanctions`](/mod/sanctions).
+
+## Utilisation
+
+```
+/statistiques
+```
+
+Trois boutons (**3j**, **7j**, **14j**) permettent de choisir la période. Toutes les informations ci-dessous suivent la période choisie (7 jours par défaut), sauf les sanctions actives qui reflètent l'état actuel :
+
+- Le nombre de sanctions actives en ce moment (bannissements et sourdines toujours en cours).
+- Le nombre de sanctions posées sur la période.
+- Le membre le plus sanctionné sur la période.
+- La répartition des sanctions par type sur la période.
+- Le classement des modérateurs les plus actifs sur la période.
+- Le temps de réponse moyen entre un signalement et sa prise en charge sur la période.
+- Un graphique généré localement (aucune donnée envoyée à un service externe) avec, jour par jour, les messages, les messages insultants détectés (filtre classique et IA, chaque message n'étant compté qu'une fois), les signalements, les sanctions (bannissements, expulsions et sourdines) et le spam bloqué (anti-spam, AutoMod et honeypot). Les messages ont leur propre échelle, à gauche, pour que les autres courbes restent lisibles.
+
+Le bouton **Masquer les messages** retire la courbe des messages du graphique. Il devient **Afficher les messages** pour la remettre, et le choix est conservé quand vous changez de période.
+
+## Arrivées et départs
+
+Le bouton **Arrivées et départs** affiche, sur la même période, le nombre de membres arrivés, le nombre de départs et le solde, avec un graphique jour par jour. Les départs comprennent les départs volontaires, les expulsions et les bannissements. Le bouton **← Retour aux statistiques** ramène à la vue précédente.
+
+## Permission
+
+Permission par défaut : **Gérer le serveur**.