Aller au contenu

Fonctionnalités activables

Comment une fonctionnalité de votre application devient active pour un client - un interrupteur par niveau, application, réseau et client.

ConceptAdministrateurPartenaireDéveloppeur
Voir en Markdown

Une fonctionnalité activable est un interrupteur que votre application consulte pour afficher ou masquer une partie de son interface : un module de statistiques, un export, une option payante. Wakastart stocke ces interrupteurs et répond à la question « cette fonctionnalité est-elle active pour ce client ? ».

Définition

Une fonctionnalité est déclarée sur l'application, avec un code stable (par exemple analytics), un nom, une description et une mention « premium » si elle est payante. Elle n'a de sens que pour votre application : Wakastart ne l'interprète pas.

Une fonctionnalité activable n'est pas un droit applicatif. Le droit dit qui peut faire une action ; la fonctionnalité dit si l'action existe pour l'organisation de l'utilisateur.

Fonctionnalité activableDroit applicatif
Porte surUn client (une organisation)Un utilisateur, via son profil
Exemple« Le module Statistiques est inclus dans l'offre de ce client »« Cet utilisateur peut exporter les statistiques »
Se consulte parL'API de vérification des fonctionnalitésGET /api/me

Comment ça marche

Chaque fonctionnalité a un interrupteur à trois niveaux. Elle est active pour un client seulement si les trois sont allumés :

Chargement du schéma…
  1. Application : l'interrupteur global de la fonctionnalité. Il est allumé par défaut à la création. L'éteindre coupe la fonctionnalité partout.
  2. Réseau : la fonctionnalité est proposée aux clients de ce réseau. Elle est éteinte par défaut.
  3. Client : la fonctionnalité est incluse pour ce client. Elle est éteinte par défaut, et ne peut être allumée que si elle l'est déjà pour le réseau.

Wakastart calcule le résultat à chaque appel de l'API de vérification. Un client inconnu ne provoque pas d'erreur : la réponse indique que la fonctionnalité est inactive.

Exemples

  • Offre à paliers. Votre application déclare export-pdf en premium. Un réseau de distribution la propose ; seuls les clients qui ont souscrit l'option l'ont allumée.
  • Lancement progressif. Vous déclarez nouveau-planning, puis vous l'allumez sur un réseau pilote avant de la proposer aux autres.
  • Coupure d'urgence. Une fonctionnalité pose problème : vous éteignez son interrupteur d'application et elle disparaît chez tous les clients au prochain appel de vérification.

Pour aller plus loin