> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wardforge.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Guide de Démarrage

> De zéro à entièrement protégé en moins de 30 secondes.

# Guide de Démarrage

<Steps>
  ### Invitez WardForge sur votre serveur

  Cliquez sur le bouton ci-dessous et sélectionnez votre serveur. Le bot nécessite les permissions
  suivantes — **ne décochez aucune d'entre elles**.

  <a href="https://discord.com/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=8&scope=bot+applications.commands" target="_blank">
    <img src="https://img.shields.io/badge/Ajouter%20à%20Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" />
  </a>

  <Warning>
    WardForge nécessite la permission **Administrateur** lors de la configuration initiale pour créer
    rôles et salons. Une fois le setup terminé, vous pouvez réduire les permissions à la liste
    minimale (voir [Permissions Minimales](#permissions-minimales) ci-dessous).
  </Warning>

  ### Lancez `/setup`

  Dans n'importe quel salon où WardForge peut écrire, tapez :

  ```
  /setup
  ```

  WardForge va automatiquement :

  1. Créer le rôle **`Guardian-Quarantine`** (aucune permission — restreint les nouveaux comptes)
  2. Créer le salon privé **`#guardian-logs`** pour le staff
  3. Configurer les seuils de détection de raid multi-fenêtres
  4. Se connecter aux bases de données anti-phishing (PhishTank, Google Safe Browsing, VirusTotal)
  5. Activer le système de quarantaine pour les comptes de moins de 24 heures

  L'intégralité du processus prend moins de 5 secondes.

  <Tip>
    Lancez `/guardian doctor` après le setup pour vérifier que chaque composant est opérationnel
    et que la hiérarchie des rôles est correcte.
  </Tip>

  ### Vérifiez avec `/guardian health`

  ```
  /guardian health
  ```

  Vous devriez voir un **Score de Sécurité** supérieur à 80/100. Si un module affiche un
  avertissement, la commande doctor vous indiquera exactement quoi corriger.
</Steps>

***

## Ce qui se passe ensuite (Automatiquement)

Une fois `/setup` terminé, vous n'avez plus rien à faire. WardForge travaille silencieusement en
arrière-plan :

| Événement                                     | Réponse de WardForge                                        |
| --------------------------------------------- | ----------------------------------------------------------- |
| Membre rejoint avec un compte \< 24 h         | Rôle quarantaine appliqué immédiatement                     |
| Raid détecté (jointures rapides multiples)    | Verrouillage déclenché ; membres suspects signalés          |
| Membre poste un lien phishing                 | Message supprimé ; membre averti ou banni                   |
| Membre soumet `/report` avec un lien confirmé | Global Ban instantané sur tout le réseau                    |
| Admin supprime des salons rapidement          | Snapshot déclenché ; bouton de restauration envoyé au staff |

***

## Permissions Minimales

Après la configuration initiale, vous pouvez restreindre les permissions de WardForge à :

| Permission                     | Pourquoi c'est nécessaire                                       |
| ------------------------------ | --------------------------------------------------------------- |
| Gérer les Rôles                | Appliquer/retirer le rôle quarantaine                           |
| Gérer les Salons               | Restaurer les salons supprimés depuis les snapshots             |
| Bannir des Membres             | Exécuter le Global Ban quand le phishing est confirmé           |
| Expulser des Membres           | Retirer les membres en quarantaine qui échouent la vérification |
| Voir les Salons                | Surveiller tous les salons pour détecter les liens phishing     |
| Envoyer des Messages           | Poster les alertes et les embeds                                |
| Intégrer des Liens             | Embeds d'alerte enrichis                                        |
| Lire l'historique des messages | Scanner les messages récents lors d'une jointure                |

<Note>
  **L'Administrateur n'est requis que pendant `/setup`** pour créer la structure initiale de
  rôles/salons. Vous pouvez le retirer immédiatement après.
</Note>

***

## Auto-Hébergement Docker (Optionnel)

Si vous préférez héberger WardForge vous-même :

```bash theme={null}
# 1. Cloner le dépôt
git clone https://github.com/your-org/wardforge.git && cd wardforge

# 2. Configurer l'environnement
cp .env.example .env
nano .env   # Remplissez au minimum DISCORD_TOKEN et DB_PASSWORD

# 3. Démarrer tous les services
docker compose up -d

# 4. Vérifier les logs
docker compose logs -f guardian-bot
```

<Warning>
  Définissez un `REDIS_PASSWORD` et un `DB_PASSWORD` forts dans votre `.env` avant de démarrer.
  Les valeurs par défaut dans `.env.example` sont des espaces réservés uniquement.
</Warning>

Les seuls ports exposés sur Internet sont **80** et **443** (Nginx). Tout le reste — le bot,
le dashboard, Redis, PostgreSQL — communique sur un réseau Docker interne isolé.