Fonctionnalités activables
Comment une fonctionnalité de votre application devient active pour un client - un interrupteur par niveau, application, réseau et client.
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é activable | Droit applicatif | |
|---|---|---|
| Porte sur | Un 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 par | L'API de vérification des fonctionnalités | GET /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 :
- Application : l'interrupteur global de la fonctionnalité. Il est allumé par défaut à la création. L'éteindre coupe la fonctionnalité partout.
- Réseau : la fonctionnalité est proposée aux clients de ce réseau. Elle est éteinte par défaut.
- 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-pdfen 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.