Aller au contenu

Applications

La wakapp au centre de la plateforme, avec sa face identité, réglée dans Paramétrage, et sa face hébergement, décrite dans Architecture.

ConceptDéveloppeurPartenaireAdministrateur
Voir en Markdown

Une application, ou wakapp, est le logiciel que vous publiez sur Wakastart. C'est l'objet central de la plateforme : les organisations qui l'utilisent sont rangées sous elle, et les ressources qui la font tourner lui appartiennent.

Définition

Une application appartient à un seul propriétaire. Elle a deux faces, réglées à deux endroits de la console :

Chargement du schéma…
AttributRôle
WIDidentifiant court de six caractères ; c'est aussi l'identifiant du client Keycloak de l'application, que l'on retrouve dans la keycloakUrl et dans le jeton (azp)
Nom courtidentifiant lisible, en minuscules, fixé à la création ; il apparaît dans les noms des ressources et dans les URLs sur domaine plateforme
TypeAPP, MOD ou SRV, affiché en badge dans l'en-tête de l'application
URL du frontl'adresse du front de l'application ; Discovery s'en sert pour la connexion par e-mail

Votre application est créée par Wakastart ; contactez-nous pour en ouvrir une. Wakastart la rattache à votre organisation : elle apparaît alors dans votre menu, sous son nom.

Pourquoi ça existe

Une application concentre ce qui est commun à tous ses utilisateurs, quel que soit leur client : le catalogue des droits, les profils modèles, les fonctionnalités, le code et sa façon de tourner. Les réseaux et les clients n'ajoutent que ce qui leur est propre. Vous décrivez donc une seule fois votre logiciel, et vous le servez à autant d'organisations que nécessaire.

Comment ça marche

La face identité

Elle se règle dans Paramétrage, en onglets :

  • Features : les fonctionnalités activables. Une fonctionnalité est active pour un client seulement si elle l'est pour l'application, pour son réseau et pour lui. Elle peut être marquée payante (« Premium »).
  • Droits, Profils, Matrice : le catalogue des droits de l'application et les profils modèles qui les regroupent, environnement par environnement (voir Droits, profils et équipes).
  • Invitations : l'activation des invitations, l'adresse de la page d'acceptation et le compte d'envoi des e-mails.
  • Langues, Thèmes, Crédits, et Légal pour une application commerciale.

À la connexion, Keycloak délivre un jeton dont l'émetteur autorisé (azp) est le WID de l'application. L'API publique vérifie ce point : un jeton émis pour une autre application est refusé.

La face hébergement

Elle se décrit dans Architecture : les dépôts Git, les services, les bases et buckets déclarés, les URLs. À la création de l'application, Wakastart lui prépare un registre d'images (un projet Harbor) et un coffre de secrets. Chaque environnement reçoit ensuite les instances de ce que l'architecture déclare (voir Définitions et instances).

Une application peut n'utiliser qu'une face : une wakapp hébergée ailleurs peut confier seulement l'identité à Wakastart.

Exemples

Une application métier complète. Un éditeur publie « Dossier Patient » : il définit vingt droits et quatre profils modèles, active les invitations, et décrit dans l'architecture un front, une API et une base PostgreSQL. Trois environnements la font tourner : développement, recette, production.

Une application hébergée ailleurs. Une startup garde son hébergement mais délègue la connexion et les droits à Wakastart. Elle n'utilise que Paramétrage et l'API publique ; le menu Architecture reste vide.

Ce qui se règle où

Vous voulezNiveau
Ajouter un droit à votre catalogueapplication
Proposer un profil à tous les clientsapplication (profil modèle)
Masquer un profil modèle pour un canalréseau
Donner ses couleurs à une organisationclient
Ajouter un service ou une baseapplication (architecture), puis chaque environnement

Pour aller plus loin