Rôles et permissions

QuantumLogs utilise les rôles Discord pour gérer les permissions d'accès au dashboard. Toute la configuration se fait depuis l'interface web.

Niveaux d'accès

Propriétaire (Owner)

Le propriétaire est le compte Discord défini lors de la création de l'instance. Il a accès à :

• Toutes les pages du dashboard
• La gestion des extensions (activation, désactivation, configuration)
• La configuration de l'authentification Discord
• Les pages d'administration (Extensions, Connector Health)

Staff (membres avec rôle requis)

Les membres Discord ayant le Required Role ont accès au dashboard. Par défaut, ils voient :

• La consultation des logs (toujours accessible)
• QuantumQL
• Le journal

Les autres extensions (Analytics, Kanban, Pterodactyl, etc.) peuvent être restreintes par rôle individuellement via le champ requiredDiscordRole dans la configuration de chaque extension (voir ci-dessous).

Admin (membres avec Admin Role)

Si un Admin Role ID est configuré, les utilisateurs ayant ce rôle bypasse les restrictions par extension. Ils ont accès à toutes les extensions, sans avoir besoin du rôle spécifique de chaque extension.

Membres sans rôle

Les membres Discord qui n'ont pas le rôle requis voient la page "Mauvais rôle" et ne peuvent pas accéder au dashboard.

Configurer les rôles depuis l'interface

La configuration des rôles se fait dans Administration > Extensions, section Discord Authentication.

Étape 1 : Ouvrir la configuration Discord

1. Connectez-vous en tant que propriétaire
2. Allez dans Administration > Extensions
3. Trouvez Discord Authentication dans les modules principaux
4. Cliquez sur l'icône configuration (engrenage)

Étape 2 : Configurer les champs

L'éditeur de configuration affiche les champs suivants :

Étape 3 : Obtenir un ID de rôle Discord

1. Ouvrez Discord sur PC
2. Allez dans Paramètres utilisateur > Avancé > Mode développeur : activez-le
3. Dans les paramètres de votre serveur Discord, allez dans Rôles
4. Clic droit sur le rôle souhaité > Copier l'identifiant

Étape 4 : Sauvegarder

Cliquez sur Sauvegarder dans l'éditeur. Les changements sont appliqués immédiatement, sans redémarrage.

Exemple : 2 niveaux d'accès (Fondateur + Staff)

Voici comment configurer un accès fondateur avec tous les droits et un accès staff limité aux logs :

1. Créer les rôles Discord

Sur votre serveur Discord, créez deux rôles :

• Fondateur (ou utilisez votre rôle existant)
• Staff QuantumLogs

2. Configurer QuantumLogs

Dans la configuration Discord Authentication :

3. Résultat

Tableau récapitulatif des accès

Restreindre l'accès aux extensions par rôle

Chaque extension dispose d'un champ requiredDiscordRole dans sa configuration. Ce champ permet de limiter l'accès à cette extension à un rôle Discord spécifique.

Fonctionnement

• Champ vide (par défaut) : l'extension est accessible à tous les membres authentifiés (qui ont le Required Role global)
• Champ renseigné avec un ID de rôle : seuls les membres ayant ce rôle spécifique (ou le Admin Role, ou le propriétaire) peuvent accéder à l'extension

Exception : les Logs

La section Logs est la seule partie qui n'est pas soumise à cette restriction par extension. Tout membre ayant le Required Role global (configuré dans Discord Authentication) a automatiquement accès aux logs. C'est le socle de base de QuantumLogs.

Configurer une restriction par rôle

1. Allez dans Administration > Extensions
2. Cliquez sur l'icône configuration (engrenage) de l'extension à restreindre
3. Renseignez le champ requiredDiscordRole avec l'ID du rôle Discord
4. Sauvegardez

Exemple : accès Analytics limité aux fondateurs

Si vous voulez que seuls les fondateurs voient les analytics, mais que tout le staff voie les logs :

Résultat :

• Fondateur : voit les logs + analytics + kanban + tout le reste
• Staff : voit les logs + kanban, mais pas les analytics
• Membre sans rôle : aucun accès

Hiérarchie d'accès

Quand un membre tente d'accéder à une extension avec un requiredDiscordRole configuré, QuantumLogs vérifie dans cet ordre :

1. Propriétaire (Owner Discord ID) → toujours autorisé
2. Admin Role → autorisé (bypass toutes les restrictions par extension)
3. Rôle de l'extension (requiredDiscordRole) → autorisé si le membre possède ce rôle
4. Sinon → accès refusé

Ce que voit le staff vs le propriétaire