boucle-7-fidelite

# Boucle ⑦ — Fidélité (programme, récompenses, jeux) ## Quand l'utiliser Pour l'**état du moteur de fidélisation** : programme, catalogue de récompenses, bons émis, cartes cadeaux, roues cadeaux et sondages. La question de la boucle : « mes clients ont-ils une raison de revenir ? » ## Enchaînement d'outils MCP (l'ordre compte) 1. **OBLIGATOIRE en premier : `get_loyalty_program`.** Lire le champ `active`. Si `active: false`, le signaler AVANT toute autre action et s'arrêter là pour les propositions : un catalogue de récompenses actif sur un programme éteint ne produit rien. Proposer la réactivation (`update_loyalty_program`, confirmation obligatoire) ou l'expliquer, mais ne rien construire par-dessus un programme inactif. 2. Si le programme est actif : `list_loyalty_rewards` (catalogue, stocks de récompenses), `list_redemptions` (bons émis vs utilisés — un taux d'usage nul signale un catalogue inadapté). 3. `list_gift_cards` (encours de cartes cadeaux = dette), `check_gift_card` au cas par cas. 4. Jeux : `list_wheel_games` + `get_wheel_stats`, `list_surveys` + `get_survey_results`. **Lecture seule côté MCP** — la création/activation d'une roue ou d'un sondage FoodEatUp se fait en back-office (voir docs/couverture-fidelite-jeux.md à la racine du dépôt) : le dire honnêtement au lieu de tenter un appel qui n'existe pas. 5. Comptes : `get_loyalty_account` par client ; `adjust_points` seulement en geste commercial motivé (plafond serveur ±1000, motif obligatoire). ## Règles métier - Programme inactif + récompenses actives = incohérence à remonter (détection partagée avec le skill `croisement-service`). - Une récompense dont le stock est épuisé mais toujours affichée frustre plus qu'elle ne fidélise : proposer `upsert_loyalty_reward` pour la retirer. - Ne jamais promettre au client un gain de roue ou un solde de points sans l'avoir lu dans l'outil. ## Garde-fous (opérations exigeant confirmation) Interceptés par le hook du plugin (confirmation humaine obligatoire) : - `update_loyalty_program` — modifie les règles pour TOUS les clients ; - `adjust_points` — modifie un solde client. `validate_redemption` est à usage unique (dédup serveur) : valider seulement un bon physiquement présenté. ## Sortie attendue D'abord une ligne d'état : « programme ACTIF/INACTIF (mode, taux) ». Puis un tableau `[levier | volumétrie | état | action proposée]` pour : récompenses, bons, cartes cadeaux, roue, sondages. ## Ce que ce skill NE fait PAS - Gérer les points d'un client au fil du service → skill `fidelite-restaurant` (plugin foodeatup). - Créer ou activer une roue cadeaux / un sondage → back-office FoodEatUp (limite MCP documentée). - Communiquer sur le programme → skill `boucle-6-communication`.