ForgeHook

Ce qu'il faut

• Docker >= 24
• Docker Compose >= 2.x
• Un serveur avec nginx (reverse proxy recommandé)
• Accès à un terminal avec les droits sudo

Installation

Premier lancement

1. 1Ouvrir le navigateur à l’adresse du serveur (ex. https://forgehook.heiphaistos.org)
2. 2Accéder à /setup pour créer le premier compte administrateur avec le jeton affiché dans les logs
3. 3Configurer le 2FA avec une application d’authentification et noter les 10 codes de secours
4. 4Se connecter avec le compte admin créé

Créer un embed avec l’éditeur visuel

L’outil propose un éditeur pixel‑perfect pour composer des messages enrichis.

1. 1Cliquer sur « Embed Builder » dans le menu principal
2. 2Remplir les champs titre, description, couleur, auteur, image, etc.
3. 3Utiliser le panneau de prévisualisation à droite pour vérifier le rendu
4. 4Enregistrer le modèle dans la bibliothèque de templates

Envoyer un message via webhook

1. 1Dans la page d’un embed, cliquer sur « Envoyer via webhook »
2. 2Coller l’URL du webhook Discord dans le champ prévu
3. 3Vérifier le preview puis cliquer sur « Envoyer »

Programmer un envoi récurrent

1. 1Ouvrir le planificateur de messages depuis le tableau de bord
2. 2Sélectionner l’embed à envoyer et le webhook cible
3. 3Saisir une expression cron (ex. 0 9 * * 1 pour chaque lundi à 9 h)
4. 4Enregistrer la tâche ; elle apparaîtra dans la liste des planifications

Utiliser les variables de template

1. 1Dans un embed, insérer des placeholders du type {{var}} où le texte doit être remplacé
2. 2Envoi via le modal interactif qui demande la valeur de chaque variable
3. 3Valider pour que le message soit généré avec les valeurs saisies

Gérer les comptes utilisateurs

1. 1Depuis le tableau de bord admin, ouvrir la section Utilisateurs
2. 2Créer un nouvel utilisateur en définissant un mot de passe provisoire
3. 3L’utilisateur se connecte, active son 2FA et définit son mot de passe définitif
4. 4En cas de perte du téléphone, utiliser un code de secours ou demander la réinitialisation du 2FA à un admin

Configurer le relais RSS → Discord

1. 1Accéder à la page RSS dans le menu
2. 2Ajouter l’URL du flux RSS à surveiller
3. 3Choisir un template contenant les variables {{title}}, {{link}} et {{content}}
4. 4Définir le webhook de destination et enregistrer

En images

Astuces

• Conservez le JWT_SECRET dans un gestionnaire de secrets et ne le partagez jamais.
• Utilisez des expressions cron simples au départ pour tester le planificateur avant de complexifier.
• Sauvegardez régulièrement le fichier SQLite (backend/data/database.sqlite) pour éviter toute perte de données.

Questions fréquentes