# Guide admins, piloter l'application du Brewers Social Club efficacement

Le dashboard admin est le poste de commande de l'association.

Il centralise la gestion opérationnelle du club, des membres et des partenaires, avec une logique simple, lisible et directement exploitable sur le terrain.

## Ce que permet l'interface admin

Le dashboard permet notamment de :

- gérer les fiches membres
- créer et suivre des invitations
- réinitialiser des accès
- envoyer des notifications email ou WhatsApp
- impersoner un membre pour l'assister
- gérer le wallet et les points
- piloter Google Wallet et Apple Wallet
- gérer les avantages et partenaires
- suivre les paiements et commandes groupées
- consulter les traces d'audit

## Connexion admin

L'accès admin se fait via un parcours sécurisé distinct de l'espace membre.

Une fois connecté, tu accèdes à une vue centrale de pilotage avec les principaux objets du club.

## Gestion des membres

La fiche membre est l'un des écrans les plus importants.

Tu peux y :

- consulter les données du membre
- voir son statut
- vérifier ses coordonnées
- accéder à l'historique utile
- ajuster ses points
- déclencher des notifications
- gérer ses accès wallet
- lancer une impersonation

### Création d'un membre
Tu peux créer un membre directement depuis l'admin.

L'application gère les règles de cohérence importantes, notamment l'unicité de certains identifiants comme l'email ou le mobile.

### Activation et statut
Selon les cas, tu peux :

- activer ou désactiver un compte
- gérer les périodes d'adhésion
- mettre à jour les informations de référence

Le statut d'adhésion doit être compris comme une donnée métier, pas juste un drapeau visuel.

## Invitations, connexion et réinitialisation

L'admin peut envoyer plusieurs types de notifications.

### Invitation membre
Selon le canal configuré, l'invitation peut partir :

- par email
- par WhatsApp texte
- par WhatsApp template

### Magic login
Tu peux aussi envoyer une **connexion directe** par WhatsApp :

- en message texte
- ou via template WhatsApp

Le magic login est utile pour réduire la friction, en particulier sur mobile.

### Réinitialisation du mot de passe
Le reset peut être envoyé :

- par email
- par WhatsApp texte
- par WhatsApp template

Cette symétrie est précieuse, parce qu'elle laisse plusieurs portes d'entrée selon le contexte réel du membre.

## Impersonation

L'impersonation permet à un admin d'ouvrir l'espace membre comme si l'on était ce membre, sans perdre sa propre session admin.

C'est extrêmement utile pour :

- diagnostiquer un problème remonté par un membre
- vérifier un affichage réel
- valider une campagne ou un avantage

L'application conserve la session admin intacte et distingue proprement ce mode de consultation.

## Wallet et points

Le wallet fait partie des briques les plus opérationnelles de la plateforme.

### Ce que tu peux faire
- rechercher un membre
- scanner sa carte
- ouvrir sa fiche wallet
- créditer ou débiter des points
- choisir un motif
- ajouter une note
- consulter l'historique récent

### Usages concrets
- recharge bar
- consommation bar
- remboursement
- correction
- geste commercial

Le format en points avec équivalence euro aide à garder une lecture simple.

## QR scan et opérations terrain

Le dashboard admin intègre un scan QR avec priorité à :

- `BarcodeDetector` quand disponible
- fallback `Html5Qrcode` sinon

Le scan permet de retrouver rapidement un membre, d'ouvrir sa fiche ou d'accélérer une opération wallet.

C'est particulièrement utile lors d'événements et de permanences.

## Wallet mobile, Google Wallet et Apple Wallet

L'admin peut piloter les cartes mobiles de manière fine.

### Actions disponibles
- inspection de l'objet Google Wallet
- resynchronisation Google Wallet
- notification Google Wallet
- reset Google Wallet
- inspection Apple Wallet
- resynchronisation Apple Wallet
- reset Apple Wallet

### Pourquoi c'est important
Ces actions permettent de résoudre rapidement les cas où un membre ne voit pas la bonne carte, le bon visuel ou le bon état de synchronisation.

## Avantages et catalogue

L'admin peut gérer les avantages proposés aux membres, avec une logique de ciblage réelle.

### La plateforme sait distinguer
- les avantages permanents
- les offres partenaires
- les audiences ciblées
- les quotas et consommations

L'idée n'est pas seulement d'afficher des cartes jolies, mais de s'assurer que les bons avantages sont visibles pour les bons membres.

## Partenaires

L'admin gère aussi le réseau partenaire.

Cela comprend :

- la création de partenaires
- la gestion des utilisateurs partenaires
- les liens d'activation
- les envois d'activation
- les logos et visuels
- les offres partenaires
- les consommations enregistrées
- les éventuels remboursements ou annulations

## Commandes groupées

Le module de campagnes et commandes groupées permet d'animer des achats collectifs avec plusieurs étapes.

### Ce que l'admin peut faire
- créer une campagne
- définir sa phase
- suivre les participations
- prévisualiser les notifications
- envoyer les notifications de masse
- suivre les états de paiement
- gérer les étapes de livraison ou retrait

### Ce que ça apporte
Cela évite les tableaux bricolés et les boucles de messages interminables. Tout le monde gagne en lisibilité.

## Intégrations utiles

Selon la configuration active, le dashboard peut aussi exposer des vues liées à :

- HelloAsso
- Brewfather
- RAPT
- SuperG
- Google Drive
- wallet featured events

Ces briques permettent d'aller plus loin que la simple gestion membre, et d'outiller le club de manière transversale.

## Bonnes pratiques admin

- privilégier les notifications adaptées au canal réel du membre
- utiliser l'impersonation pour diagnostiquer avant de conclure à un bug
- garder des motifs clairs sur les mouvements wallet
- vérifier l'éligibilité réelle avant d'interpréter un avantage manquant
- profiter de l'audit pour comprendre les incidents au lieu de bricoler à l'aveugle

## En résumé

Le dashboard admin n'est pas juste une interface de gestion.

C'est un outil de continuité opérationnelle pour l'association. Il aide à mieux servir les membres, mieux suivre les actions et mieux valoriser les partenaires, sans multiplier les outils et les fichiers parallèles.
