Ajout Récompenses de Suggestion (#232)

Co-authored-by: DraftMan <[email protected]>
Co-authored-by: Erwan <[email protected]>

Author: 3 people

docs/2.modules/7.suggestions.md

@@ -2,7 +2,7 @@
 title: Suggestions
 description: Récoltez simplement les suggestions et avis de vos membres avec DraftBot !
 navigation.icon: 'twemoji:light-bulb'
-contributors: ['bariboo', 'clement669', 'rababio', 'elbaguetto']
+contributors: ['bariboo', 'clement669', 'rababio', 'elbaguetto', 'imroxxor']
 updated_at: '2025-04-18'
 ---
 
@@ -625,4 +625,116 @@ Vous pouvez personnaliser votre message avec différentes variables :
   ::
 ::
 
+### Annonces de récompenses
 
+Configurez où et comment annoncer l'obtention d'une récompense (désactivé par défaut) :
+
+- **Salon dédié** : Choisissez un salon spécifique pour les annonces.
+- **Message personnalisé** : Personnalisez le message d'annonce avec les [variables disponibles](#variables-de-personnalisation), ainsi que `{reward}`, `{target.count}` et `{target.type}` pour afficher la récompense obtenue.
+
+**Message par défaut** : `{user}, voici votre récompense pour avoir atteint **{target.count} {target.type}** !`
+
+::hint{ type="info" }
+  Par défaut, les annonces de récompenses sont **désactivées**. N'oubliez pas de les activer et de choisir un salon pour que vos membres soient notifiés !
+::
+
+::hint{ type="warning" }
+  **Permissions requises** : Pour envoyer les annonces, DraftBot doit disposer des permissions suivantes dans le salon choisi : **Voir le salon**, **Envoyer des messages**, **Intégrer des liens** et **Joindre des fichiers**. Si ces permissions sont retirées, les annonces seront automatiquement désactivées.
+::
+
+### Créer une récompense
+
+1. **Statut de suggestion** : Le statut que la suggestion occupe : acceptée, en attente, refusée, prévue
+2. **Nombre de suggestion** : Le nombre déclencheur
+3. **Type de récompense** : Rôle, argent, XP, objet, ou personnalisée
+4. **Paramètres spécifiques** selon le type choisi
+
+::tabs
+  ::tab{ label="Via la commande /config" }
+
+    DraftBot peut récompenser automatiquement l'auteur de suggestions pour un certain nombre de suggestions acceptées / refusées / en attente
+
+    Via la commande \</config>, accédez au menu "Suggestions" > "Récompenses" > "Créer une récompense", puis suivez les étapes de configuration.
+
+    ![Création de récompense via /config](../assets/suggestions/config_recompenses.png)
+  ::
+
+  ::tab{ label="Via le panel" }
+    [⫸ Accéder au panel de **DraftBot**](/dashboard/first/suggestions)
+
+    Dans la section "Récompenses", cliquez sur "Créer une récompense" :
+
+    ![Création de récompense depuis le panel](../assets/suggestions/panel_creer_recompense.png)
+  ::
+::
+
+::tabs
+  ::tab{ label="Rôle" }
+    Attribuez un rôle permanent ou temporaire au membre qui atteint l'objectif.
+
+    **Paramètres :**
+    - Le rôle à attribuer
+    - Durée (pour rôle temporaire uniquement)
+
+    ::hint{ type="warning" }
+      Le rôle sélectionné doit avoir été créé au préalable et être accessible à DraftBot (ne pas être situé plus haut que le rôle le plus élevé de DraftBot).
+    ::
+
+    ::hint{ type="info" }
+      Contrairement aux récompenses de niveau, les rôles ne sont **jamais retirés** automatiquement si la suggestion est changée.
+    ::
+  ::
+
+  ::tab{ label="Argent" }
+    Donnez de l'argent du [système d'économie](/docs/modules/economie) au membre.
+
+    **Paramètres :**
+    - Montant à donner
+
+    ::hint{ type="warning" }
+      Le système d'économie doit être **activé** sur votre serveur pour utiliser ce type de récompense.
+    ::
+  ::
+
+  ::tab{ label="Expérience" }
+    Donnez des points d'expérience du [système de niveaux](/docs/modules/niveaux).
+
+    **Paramètres :**
+    - Quantité d'XP à donner
+
+    ::hint{ type="warning" }
+      Le système de niveaux doit être **activé** sur votre serveur pour utiliser ce type de récompense.
+    ::
+
+    ::hint{ type="success" }
+      Si le gain d'XP fait monter le membre de niveau, il recevra automatiquement les récompenses de niveau et une annonce sera envoyée (si configurée).
+    ::
+  ::
+
+  ::tab{ label="Objet d'inventaire" }
+    Donnez un ou plusieurs [objets d'inventaire](/docs/modules/inventaire) au membre.
+
+    **Paramètres :**
+    - L'objet à donner
+    - La quantité (jusqu'à 1 million)
+
+    ::hint{ type="info" }
+      Si vous n'avez pas encore créé d'objets, vous devrez d'abord [configurer votre inventaire](/docs/modules/inventaire) depuis le module Inventaire du panel.
+    ::
+  ::
+
+  ::tab{ label="Récompense personnalisée" }
+    Offrez une récompense **en dehors de Discord** : codes promotionnels, goodies physiques, mentions spéciales, etc.
+
+    **Paramètres :**
+    - Nom/description de la récompense (jusqu'à 250 caractères)
+
+    ::hint{ type="success" }
+      **Comment ça fonctionne ?** Lorsqu'un membre obtient cette récompense, **vous recevez une notification par message privé de DraftBot** avec les informations du membre. Vous pouvez alors lui remettre la récompense manuellement.
+    ::
+
+    ::hint{ type="warning" }
+      Assurez-vous que vos messages privés sont ouverts pour recevoir les notifications !
+    ::
+  ::
+::