# Glossaire

> Définition de chaque terme de la documentation et de la console Wakastart, avec les confusions à éviter et le terme de l'interface ou de l'API.

Ce glossaire définit les termes employés dans la documentation et dans la console Wakastart. Chaque terme a une ancre stable, par exemple `/v1.0/glossaire#environnement`. Quand la console ou l'API emploie un autre mot, il est indiqué.

**Index** : [A](#accès-dun-utilisateur-à-une-application) · [B](#base-de-données) · [C](#cgu-cgv-et-documents-rgpd) · [D](#définition) · [E](#enregistrement-dns) · [F](#fhir) · [G](#gateway) · [H](#habillage) · [I](#image) · [J](#jeton-enrichi) · [K](#keycloak) · [L](#langue) · [M](#matrice-droits--profils) · [N](#namespace) · [O](#opération) · [P](#pack-de-crédits) · [Q](#quarantaine) · [R](#rapport-de-dérive) · [S](#sauvegarde) · [T](#tableau-de-bord) · [U](#url-publique) · [V](#variable-attendue) · [W](#wakapp)

## Accès d'un utilisateur à une application

Autorisation d'un utilisateur sur une application, pour un environnement donné. Sans elle, la connexion de l'utilisateur à l'application est refusée, même s'il existe dans le client.

- **Ne pas confondre avec** : [Profil](#profil), qui porte les droits et non l'accès.
- **Voir** : [Utilisateurs et équipes](/v1.0/utilisateurs).

## Accès d'urgence

Voir [Bris de glace](#bris-de-glace).

## Administrateur client

[Niveau d'administration](#niveau-dadministration) qui gère une organisation cliente : ses utilisateurs, ses équipes, ses invitations. C'est le niveau minimal pour utiliser la console et la plupart des endpoints d'administration de l'API.

- **Dans la console** : « Administrateur Client » (Mon profil), « Admin Client » (choix du niveau d'un utilisateur), « CustomerAdmin » (menu). **Dans l'API** : `CUSTOMER_ADMIN`.
- **Ne pas confondre avec** : [Client](#client), l'organisation elle-même.

## Administrateur d'applications

[Niveau d'administration](#niveau-dadministration) situé entre [Propriétaire](#propriétaire) et [Administrateur réseau](#administrateur-réseau), qui donne accès au paramétrage et à l'hébergement des applications qui lui sont confiées.

- **Dans la console** : « Administrateur Applications » (Mon profil), « Admin Application », « AppsAdmin ». **Dans l'API** : `APP_ADMIN`.

## Administrateur réseau

[Niveau d'administration](#niveau-dadministration) qui gère un [réseau](#réseau) et ses clients : création de clients, fonctionnalités par réseau, hôtes IAM, transferts de crédits.

- **Dans la console** : « Administrateur Réseau », « Admin Réseau », « NetworkAdmin ». **Dans l'API** : `NETWORK_ADMIN`.
- **Ne pas confondre avec** : [Réseau](#réseau), l'objet.

## Antivirus

Module qui analyse les fichiers envoyés par une application avant qu'elle ne les accepte. L'analyse est asynchrone ; son résultat se lit par l'API ou arrive par [webhook](#webhook). Chaque scan coûte un [crédit](#crédit).

- **Statuts d'un scan** : `PENDING`, `SCANNING`, `CLEAN`, `INFECTED`, `ERROR`.
- **Voir** : [Antivirus](/v1.0/antivirus), [Référence API](/v1.0/reference-api/antivirus).

## API publique

API que les applications et les serveurs des clients appellent directement, à l'adresse `https://api.wakastart.app/api`. Elle accepte un jeton Keycloak, un [jeton enrichi](#jeton-enrichi) ou une [clé API](#clé-api).

- **Ne pas confondre avec** : la [console](#console), qui a son propre serveur.
- **Voir** : [Référence API](/v1.0/reference-api).

## Application

Logiciel d'un éditeur, authentifié et, le cas échéant, hébergé par Wakastart. Elle appartient à un [propriétaire](#propriétaire) et est distribuée par un ou plusieurs [réseaux](#réseau). Son [WID](#wid) sert aussi d'identifiant de client Keycloak.

- **Synonyme** : [wakapp](#wakapp). **Dans la console** : « Application », « App », badge « APP / MOD / SRV ». **Dans l'API** : `App`.
- **Ne pas confondre avec** : [Application commerciale](#application-commerciale).
- **Voir** : [Applications et environnements](/v1.0/applications).

## Application commerciale

Offre commerciale d'une application, à laquelle sont rattachés ses [documents légaux](#document-légal) et leur publication. Elle active l'onglet « Légal » du paramétrage de l'application.

- **Voir** : [Documents légaux](/v1.0/documents-legaux).

## Architecture

Description d'une application indépendante des environnements : dépôts Git, définitions de services, bases et buckets déclarés, URLs, routes, redirections. Chaque [environnement](#environnement) en reçoit ensuite ses propres [instances](#instance).

- **Dans la console** : menu « Architecture » (Repositories, Services, Dépendances, URLs).
- **Ne pas confondre avec** : [Environnement](#environnement), où l'architecture est déployée.
- **Voir** : [Définitions et instances](/v1.0/concepts).

## Auto-build

Option d'un environnement qui lance un [build](#build) à chaque push sur la branche suivie, pour les services dont le dossier a changé.

- **Ne pas confondre avec** : [Auto-deploy](#auto-deploy).
- **Voir** : [Builds et déploiements](/v1.0/builds-et-deploiements).

## Auto-deploy

Option d'un environnement qui déploie automatiquement l'image d'un build réussi sur les services qui suivent la même branche.

- **Dans la console** : « Auto-deploy on new build ».
- **Ne pas confondre avec** : [Auto-build](#auto-build).

## Base de données

Base PostgreSQL, MySQL, MongoDB ou Valkey provisionnée dans un environnement à partir d'une base déclarée dans l'[architecture](#architecture). Elle est hébergée dans le cluster Wakastart ou sous forme de service managé.

- **Statuts** : `PENDING`, `PROVISIONING`, `READY`. **Dans l'API** : `DatabaseInstance`.
- **Voir** : [Base dans le cluster ou managée](#base-dans-le-cluster-ou-managée), [Bases de données](/v1.0/bases-de-donnees).

## Base dans le cluster ou managée

Les deux modes d'hébergement d'une base ou d'un bucket. Dans le cluster, la ressource tourne dans un conteneur de la plateforme ; managée, elle est confiée à un service géré par l'hébergeur.

- **Dans la console** : « In-Cluster » et « Managed ». **Dans l'API** : `IN_CLUSTER`, `MANAGED`.

## Bibliothèque de versions

Ensemble des versions du [thème Keycloak](#thème-keycloak) d'une application. Une version y est ajoutée par téléversement ou import depuis un dépôt, puis appliquée à un environnement.

- **Voir** : [Page de connexion](/v1.0/page-de-connexion).

## Blueprint

Export JSON de la configuration d'une application, d'un réseau ou d'un client (fonctionnalités, droits, profils, langues, thèmes, traductions), réimportable section par section.

- **Dans la console** : « Exporter le blueprint », menu « Backup / Restore ».
- **Ne pas confondre avec** : [Sauvegarde](#sauvegarde), qui porte sur les données d'une base ou d'un bucket.

## Boost

Mode d'un build, actif par défaut, qui lui alloue davantage de processeur et de mémoire.

- **Dans la console** : « Mode Boost ».

## Branding

Voir [Habillage](#habillage).

## Bris de glace

Accès d'urgence d'un professionnel de santé à un coffre HDS qui ne lui est pas partagé, sur justification. Chaque activation est tracée et notifiée.

- **Synonyme** : accès d'urgence. **Dans l'API** : `/api/hds/break-glass`.
- **Ne pas confondre avec** : [Partage](#partage).

## Bucket

Espace de stockage objet compatible S3 provisionné dans un environnement à partir d'un bucket déclaré dans l'[architecture](#architecture). Ses identifiants d'accès sont disponibles dans la configuration de l'environnement.

- **Dans la console** : « Buckets », « Stockage (S3) ». **Dans l'API** : `StorageBucketInstance`.
- **Voir** : [Stockage objet](/v1.0/stockage).

## Build

Construction de l'image d'un service à partir de son dépôt Git (branche, tag ou commit). L'image produite est rangée dans le [registre](#registre) de l'application.

- **Statuts** : `PENDING`, `BUILDING`, `SUCCEEDED`, `FAILED`.
- **Ne pas confondre avec** : [Déploiement](#déploiement), qui met une image en service.
- **Voir** : [Builds et déploiements](/v1.0/builds-et-deploiements).

## CGU, CGV et documents RGPD

Les cinq types de [documents légaux](#document-légal) d'une application : CGV, CGU, charte RGPD, DPA et DPA HDS.

- **Dans l'API** : `CGV`, `CGU`, `CHARTE_RGPD`, `DPA`, `DPA_HDS`.

## Checkout

Session de paiement Stripe ouverte par une application pour faire payer un de ses utilisateurs.

- **Dans l'API** : `POST /api/billing/checkout-sessions`.
- **Ne pas confondre avec** : [Portail de facturation](#portail-de-facturation).

## Clé API

Secret au format `sk_…` qui permet à un serveur d'appeler l'[API publique](#api-publique) sans utilisateur connecté. Elle est liée à une application, un environnement, un client et un profil ; elle peut être liée à un compte ou être un [compte technique](#compte-technique). Ses droits se lisent dans la [matrice droits / profils](#matrice-droits--profils) de son environnement : prévoyez une clé par environnement.

- **Dans l'API** : en-tête `x-api-key`.
- **Ne pas confondre avec** : [Clé API de wakapp](#clé-api-de-wakapp) ; la clé d'un compte d'envoi d'e-mails ou d'un fournisseur de paiement.
- **Voir** : [Clés API](/v1.0/cles-api).

## Clé API de wakapp

Secret au format `wsk_…` qu'un organisme client utilise pour appeler l'API **de votre wakapp** depuis son propre système. Elle porte des droits du catalogue de votre application, pour un client, une application et un environnement ; elle est liée à un utilisateur ou technique. Votre wakapp la fait vérifier par Wakastart (introspection) à chaque appel. Elle ne donne aucun droit sur Wakastart.

- **Dans la console** : onglet « Clés API de l'app ».
- **Ne pas confondre avec** : [Clé API](#clé-api), qui appelle Wakastart.
- **Voir** : [Clés API](/v1.0/cles-api).

## Clé d'idempotence

Valeur unique, de 180 caractères au plus, exigée par les créations de paiement pour qu'un renvoi ne crée pas de doublon.

- **Dans l'API** : champ `idempotencyKey`.

## Clé de traduction

Identifiant d'un texte traduisible d'une application, par exemple `agenda.title`, rangé dans un type de fichier : `FRONT`, `BACK` ou `EXTRA`. Chaque clé a une valeur par [langue](#langue).

- **Voir** : [Langues et traductions](/v1.0/langues-et-traductions).

## Client

Organisation cliente rattachée à un [réseau](#réseau). Elle regroupe des utilisateurs, des équipes, des profils propres, des fournisseurs d'identité et des invitations. Dans Keycloak, elle correspond à une organisation du realm du réseau.

- **Dans la console** : « Client », « Organisation ». **Dans l'API** : `Customer`, champs `customerId` et `customerWid`.
- **Ne pas confondre avec** : le client Keycloak d'une application ; l'utilisateur qui paie une application ; [Administrateur client](#administrateur-client).
- **Voir** : [Organisations](/v1.0/organisations).

## Coffre

Conteneur chiffré du module [HDS](#hds) qui regroupe les documents de santé d'un patient, d'une équipe ou d'une étude, avec ses dossiers, ses versions, ses partages et ses consentements.

- **Dans l'API** : identifiant `vlt_…`, `/api/hds/vaults`.
- **Ne pas confondre avec** : [Coffre de secrets](#coffre-de-secrets).

## Coffre de secrets

Espace de stockage des secrets propre à chaque application, créé avec elle. Les [secrets d'environnement](#secret-denvironnement) et les identifiants des bases et des buckets y sont écrits.

- **Dans la console** : « coffre de secrets », bouton « Réparer l'infrastructure ».
- **Ne pas confondre avec** : [Coffre](#coffre) HDS.
- **Voir** : [Variables et secrets](/v1.0/variables-et-secrets).

## Commission plateforme

Part prélevée par Wakastart sur chaque vente encaissée par un éditeur avec le module de paiement : 2 % par défaut.

- **Dans l'API** : `applicationFeeBps` (en points de base).

## Compte applicatif

Chacun des deux comptes d'accès, `primary` et `secondary`, créés pour une base de données. Leurs identifiants sont générés par la plateforme et rangés dans le coffre de secrets.

- **Voir** : [Bases de données](/v1.0/bases-de-donnees).

## Compte technique

[Clé API](#clé-api) liée à aucun utilisateur, créée pour une intégration de serveur à serveur.

- **Ne pas confondre avec** : une clé liée à un compte utilisateur.

## Configuration de l'environnement

Ensemble des valeurs disponibles pour les services d'un environnement : variables en clair, secrets, variables calculées, variables de plateforme et identifiants des bases et buckets. Chaque service choisit ce qu'il consomme par des [liaisons](#liaison).

- **Dans la console** : onglet « Configuration ».
- **Voir** : [Variables et secrets](/v1.0/variables-et-secrets).

## Consentement

Accord recueilli auprès d'un patient dans un coffre HDS, pour une finalité donnée. Son retrait entraîne l'archivage, l'anonymisation ou la suppression du coffre.

## Console

Interface web de Wakastart, à l'adresse `https://app.wakastart.app`. Ce qu'un écran montre dépend du [niveau d'administration](#niveau-dadministration) et des droits de l'utilisateur.

- **Voir** : [Démarrer](/v1.0/demarrer).

## Crédit

Unité de facturation des opérations payantes : scan antivirus, traduction par IA, import d'utilisateurs. Un solde existe par client ou par réseau et se recharge en achetant un [pack de crédits](#pack-de-crédits).

- **Ne pas confondre avec** : [Pack d'heures](#pack-dheures).
- **Voir** : [Crédits](/v1.0/reference-api/credits).

## Définition

Élément déclaré une seule fois dans l'[architecture](#architecture) d'une application (service, base, bucket), qui porte les valeurs par défaut. Chaque environnement en reçoit une [instance](#instance), qui peut surcharger ces valeurs.

- **Dans l'API** : objets `…Definition`.
- **Ne pas confondre avec** : [Instance](#instance).
- **Voir** : [Concepts](/v1.0/concepts).

## Définition de service

Description de la façon de construire et de lancer un service : dépôt et dossier, Dockerfile, rôle, exposition, port, ressources et sondes par défaut, [variables attendues](#variable-attendue).

- **Dans la console** : « Service », onglets « Général » et « Variables consommées ». **Dans l'API** : `ServiceDefinition`.
- **Ne pas confondre avec** : [Instance de service](#instance-de-service).

## Dépendance

Base de données ou bucket déclaré dans l'architecture, avec ses valeurs par défaut. Une option crée automatiquement une instance dans chaque environnement.

- **Dans la console** : « Dépendances ». **Dans l'API** : `DatabaseDefinition`, `StorageBucketDefinition`.

## Déploiement

Trace de chaque changement qui modifie les conteneurs d'une instance de service : nouvelle image, redémarrage, configuration, variables ou secrets.

- **Dans la console** : « Déploiements » ; statuts « En attente », « En cours », « Réussi », « Échec », « Remplacé », « Ignoré ».
- **Ne pas confondre avec** : [Build](#build).

## Discovery

Service public, appelable sans jeton, qui indique à une application où connecter ses utilisateurs : à partir du nom d'hôte de son front, il renvoie l'adresse de connexion Keycloak complète. L'application ne connaît jamais son [realm](#realm).

- **Adresse** : `https://discovery.wakastart.app`.
- **Ne pas confondre avec** : [Hôte IAM](#hôte-iam), la règle que Discovery consulte.
- **Voir** : [Discovery](/v1.0/reference-api/discovery).

## Document HDS

Fichier de santé chiffré et versionné, déposé dans un [coffre](#coffre).

- **Dans l'API** : identifiant `doc_…`.

## Document légal

Texte versionné d'une application (CGV, CGU, charte RGPD, DPA, DPA HDS), dont les variables sont remplacées par les informations de l'[entité juridique](#entité-juridique). Une seule version est en vigueur par type.

- **Dans la console** : « Documents Légaux », « Nouvelle version ».
- **Voir** : [Documents légaux](/v1.0/documents-legaux).

## Domaine personnalisé

Domaine qui appartient à l'éditeur, dont la plateforme gère les enregistrements DNS grâce aux identifiants du fournisseur DNS.

- **Ne pas confondre avec** : [Domaine plateforme](#domaine-plateforme).
- **Voir** : [Domaines et URLs](/v1.0/domaines-et-urls).

## Domaine plateforme

Domaine commun à toutes les applications, géré par Wakastart. Une URL sur un domaine plateforme contient le nom court de l'application.

## Domaine racine

Exposition d'un domaine personnalisé à sa racine, sans sous-domaine (`mondomaine.fr`), vers un service. Un seul par domaine.

- **Dans la console** : « domaine racine (apex) ».

## Droit

Dans cette documentation, « droit » désigne le plus souvent un [droit applicatif](#droit-applicatif). Les équipes ont aussi des [droits d'équipe](#droits-déquipe).

## Droit applicatif

Permission élémentaire définie par une application, au format `ressource.action` (`users.read`). Les droits sont attribués aux [profils](#profil), environnement par environnement.

- **Dans la console** : « Droits ». **Dans l'API** : `AppRight` ; message de refus `Droit applicatif requis : <code>`.
- **Ne pas confondre avec** : [Droits d'équipe](#droits-déquipe) ; [Niveau d'administration](#niveau-dadministration).
- **Voir** : [Droits et profils](/v1.0/droits-et-profils).

## Droits d'équipe

Lettres (`A` à `Z`, `a` à `z`) attribuées à un membre d'une [équipe](#équipe), dont l'application fixe la signification.

- **Ne pas confondre avec** : [Droit applicatif](#droit-applicatif).

## Enregistrement DNS

Enregistrement A, AAAA, CNAME, TXT ou MX que la plateforme crée, le plus souvent automatiquement, pour une route, un domaine racine ou une redirection.

## Entité juridique

Fiche légale (raison sociale, pays, forme juridique, numéros d'immatriculation et de TVA, adresse) rattachée à un propriétaire, un réseau ou un client. Ses champs alimentent les documents légaux.

- **Dans la console** : « Entités & Contacts ».
- **Voir** : [Organisations](/v1.0/organisations).

## Environnement

Contexte de déploiement d'une application, de type `dev`, `staging` ou `prod`. Il suit une référence Git et porte les instances, la configuration et les URLs. Chaque type d'environnement est relié à sa propre instance [Keycloak](#keycloak) et a son propre référentiel d'utilisateurs. L'API publique déduit l'environnement de l'appelant (jeton, clé API ou hôte IAM) ; il n'est jamais passé en paramètre.

- **Dans la console** : « Environnements », « Development / Staging / Production ».
- **Ne pas confondre avec** : [Type d'environnement](#type-denvironnement) ; plusieurs environnements peuvent avoir le même type.
- **Voir** : [Applications et environnements](/v1.0/applications).

## Équipe

Groupe d'utilisateurs au sein d'un [client](#client). Chaque membre y a un [niveau d'équipe](#niveau-déquipe) et, en option, des [droits d'équipe](#droits-déquipe).

- **Dans la console** : « Équipes », « Membres ». **Dans l'API** : `Team`.
- **Ne pas confondre avec** : [Profil](#profil).
- **Voir** : [Utilisateurs et équipes](/v1.0/utilisateurs).

## État de santé

État calculé en continu pour chaque service, base et tâche, à partir de l'état réel dans le cluster.

- **Dans la console** : healthy, warning, critical, down, unknown.
- **Ne pas confondre avec** : [Statut de provisionnement](#statut-de-provisionnement).
- **Voir** : [Supervision et logs](/v1.0/supervision).

## Exposition

Accessibilité d'un service : public, interne ou privé, avec protocole et port.

- **Dans la console** : « Réseau par défaut ». **Dans l'API** : `PUBLIC`, `INTERNAL`, `PRIVATE`.

## FHIR

Format standard d'échange de données de santé, dans lequel le module HDS exporte un document ou un coffre.

## Fonctionnalité

Option activable définie par une application, éventuellement payante. Elle n'est active pour un client que si elle l'est pour l'application, pour le réseau du client et pour le client.

- **Dans la console** : « Features ». **Dans l'API** : `AppFeature`.
- **Ne pas confondre avec** : [Module](#module).
- **Voir** : [Applications](/v1.0/reference-api/applications).

## Fournisseur d'identité

Service externe (OIDC, SAML ou connexion sociale) déclaré par un client pour que ses utilisateurs se connectent avec leur compte d'entreprise. Il reste en brouillon tant qu'il n'est pas activé.

- **Abréviation** : IdP. **Dans l'API** : statuts `DRAFT`, `ACTIVE`.
- **Ne pas confondre avec** : [SSO](#sso), l'usage qu'il permet.
- **Voir** : [SSO entreprise](/v1.0/sso).

## Gateway

Point d'entrée HTTPS qui sert un environnement : mutualisée, gérée par la plateforme, ou dédiée.

- **Dans la console** : « Gateway servant l'environnement », « Mutualisée — gérée par la plateforme ».

## Génération

Compteur incrémenté à chaque modification d'une ressource. Tant qu'il dépasse la génération appliquée, un changement attend d'être appliqué par la [réconciliation](#réconciliation).

- **Dans l'API** : `generation`, `reconciledGeneration`.

## Habillage

Personnalisation visuelle d'une application, d'un réseau ou d'un client : logos, fonds, favicon, visuels personnalisés et thème par défaut. Les valeurs se résolvent du plus précis au plus général : utilisateur, client, réseau, application.

- **Synonyme** : branding. **Dans la console** : « Theme Studio ».
- **Voir** : [Apparence](/v1.0/apparence).

## HDS

Hébergement de données de santé : module de coffres chiffrés pour documents de santé, avec partages, consentements, accès d'urgence, audit et rapports de conformité. Il s'active sur l'application depuis la console.

- **Voir** : [Données de santé (HDS)](/v1.0/hds), [Rôle HDS](#rôle-hds).

## Héritage

Règle selon laquelle une [instance](#instance) reprend chaque valeur de sa [définition](#définition) quand elle ne la surcharge pas, puis une valeur par défaut de la plateforme.

## Hôte IAM

Règle qui associe un nom d'hôte, exact ou générique (`*.`), à une application, un type d'environnement, un réseau et un realm. [Discovery](#discovery) s'en sert pour savoir où connecter un utilisateur.

- **Dans la console** : « Hôtes IAM », « Pattern d'hôte » ; origine « AUTO » ou « MANUAL ».
- **Ne pas confondre avec** : [Route](#route) ; [Domaine personnalisé](#domaine-personnalisé).
- **Voir** : [Authentification](/v1.0/authentification).

## Image

Résultat d'un [build](#build), rangé dans le [registre](#registre) de l'application et repéré par un tag horodaté.

- **Dans la console** : « Image Tag », « Déployer une image ».

## Instance

Ressource provisionnée dans un environnement à partir d'une [définition](#définition) : service, base, bucket, route. Elle peut surcharger les valeurs par défaut de la définition.

- **Ne pas confondre avec** : [Définition](#définition) ; une instance [Keycloak](#keycloak).

## Instance de service

[Définition de service](#définition-de-service) déployée dans un environnement, avec son image en cours, son nombre de [réplicas](#réplica) et ses ressources. Une seule par service et par environnement.

- **Dans la console** : « Instances de services ». **Dans l'API** : `ServiceInstance`.
- **Voir** : [Services](/v1.0/services).

## Invitation

Invitation envoyée par e-mail à une personne pour rejoindre un client, avec un profil, des équipes et un environnement. Le lien expire après 10 jours par défaut.

- **Statuts** : `PENDING`, `ACCEPTED`, `EXPIRED`, `CANCELLED`.
- **Voir** : [Invitations](/v1.0/reference-api/invitations).

## Jeton de contexte

Jeton de courte durée (60 secondes) que Wakastart remet à votre wakapp quand elle vérifie une [clé API de wakapp](#clé-api-de-wakapp) ou un utilisateur. Joint à un appel fait avec la [clé API](#clé-api) de la wakapp, il borne l'action au client concerné et en trace l'origine. Il n'ajoute aucun droit.

- **Dans l'API** : champ `context_token`, en-tête `X-WakaStart-Context`.
- **Ne pas confondre avec** : [Jeton enrichi](#jeton-enrichi), qui n'est jamais accepté à sa place, et inversement.
- **Voir** : [Clés API](/v1.0/cles-api).

## Jeton enrichi

Jeton signé par Wakastart à partir du jeton Keycloak d'un utilisateur. Il ajoute le contexte métier : niveau d'administration, identifiants courts du propriétaire, du réseau, du client, de l'application et de l'utilisateur, environnement de la session. Il expire en même temps que le jeton Keycloak dont il est issu.

- **Autre nom** : wakaToken. **Dans l'API** : en-tête `x-enriched-token`, `POST /api/auth/enrich`.
- **Ne pas confondre avec** : [Jeton Keycloak](#jeton-keycloak).
- **Voir** : [Jeton et /me](/v1.0/reference-api/jeton-et-me).

## Jeton Keycloak

Jeton OIDC d'accès, avec son jeton de rafraîchissement, délivré par le realm du réseau sur l'instance Keycloak de l'environnement. Il désigne l'application pour laquelle il a été émis.

- **Voir** : [Authentification de l'API](/v1.0/reference-api/authentification-api).

## Journal d'audit

Journal horodaté et protégé des actions menées sur la plateforme, conservé 3 ans, avec vérification d'intégrité.

- **Dans la console** : « Audit Logs » (menu Sécurité).
- **Ne pas confondre avec** : le journal d'audit du module HDS ; la piste d'audit d'un projet.
- **Voir** : [Journal d'audit](/v1.0/journal-d-audit).

## Keycloak

Serveur d'identité sur lequel Wakastart authentifie les utilisateurs. Wakastart opère une instance par type d'environnement : `https://auth.wakastart.app` (prod), `https://auth-staging.wakastart.app` (staging) et `https://auth-dev.wakastart.app` (dev). Chaque réseau y a son [realm](#realm).

- **Voir** : [Authentification](/v1.0/authentification).

## Langue

Langue proposée par une application, choisie dans un référentiel commun. Le français et l'anglais sont obligatoires. La langue d'un utilisateur se résout : sa préférence, puis son client, son réseau, la langue par défaut de l'application.

- **Voir** : [Langues et traductions](/v1.0/langues-et-traductions).

## Liaison

Pour une instance de service, choix de la source de chaque [variable attendue](#variable-attendue) : valeur libre, entrée de la configuration de l'environnement, ou champ d'une base, d'un bucket ou du registre.

- **Dans la console** : « Configuration du service ». **Dans l'API** : `VarBinding`.
- **Ne pas confondre avec** : [Variable attendue](#variable-attendue), déclarée par la définition de service.
- **Voir** : [Variables et secrets](/v1.0/variables-et-secrets).

## Logs

Ce qu'un service écrit sur sa sortie standard et sa sortie d'erreur, conservé 7 jours, consultable et téléchargeable dans la console. Écrit en JSON avec un niveau, il se filtre par niveau.

- **Ne pas confondre avec** : [Journal d'audit](#journal-daudit).
- **Voir** : [Supervision et logs](/v1.0/supervision).

## Matrice droits / profils

Tableau qui attribue les droits applicatifs aux profils d'une application, environnement par environnement. Chaque environnement se règle séparément : il n'existe ni copie ni promotion d'un environnement vers un autre.

- **Dans la console** : onglet « Matrice ».

## Métriques

Mesures d'un service : processeur, mémoire, disque et réseau, sur 7 jours.

## Module

Service additionnel offert aux applications : antivirus, HDS, paiements, crédits. Chacun a son propre mode d'activation.

- **Ne pas confondre avec** : [Fonctionnalité](#fonctionnalité) ; le type d'application « MOD ».

## Namespace

Espace Kubernetes propre à un environnement, nommé `wakapp-<wid>-<nom court>`.

## Niveau d'administration

Niveau hiérarchique d'un utilisateur, qui détermine ce qu'il voit dans la console, les endpoints qu'il peut appeler et le niveau maximal qu'il peut attribuer. Du plus élevé au plus faible : [Propriétaire](#propriétaire), [Administrateur d'applications](#administrateur-dapplications), [Administrateur réseau](#administrateur-réseau), [Administrateur client](#administrateur-client), [Utilisateur](#utilisateur), aucun.

- **Dans l'API** : `adminLevel`, valeurs `PARTNER_ADMIN`, `APP_ADMIN`, `NETWORK_ADMIN`, `CUSTOMER_ADMIN`, `USER`, `NONE`.
- **Ne pas confondre avec** : [Niveau d'équipe](#niveau-déquipe) ; [Profil](#profil).
- **Voir** : [Droits et profils](/v1.0/droits-et-profils).

## Niveau d'équipe

Rôle d'un membre dans une équipe : administrateur, manager, membre (par défaut), contributeur ou lecteur.

- **Dans la console** : « Rôle équipe ». **Dans l'API** : `ADMIN`, `MANAGER`, `MEMBER`, `CONTRIBUTOR`, `VIEWER`.
- **Voir** : [Équipes](/v1.0/reference-api/equipes).

## Opération

Action facturée en [crédits](#crédit), avec un coût par défaut qui peut être ajusté pour un réseau ou un client : `SCAN_DOCUMENT`, `IMPORT_USERS`, `AI_TRANSLATE_BULK`…

## Organisation Keycloak

Représentation d'un [client](#client) dans le realm de son réseau. Un utilisateur membre de plusieurs organisations choisit la sienne à la connexion ou depuis la console.

- **Ne pas confondre avec** : « Organisation », libellé de la console pour le client.

## Ouverture des ventes

Verrou qui autorise une application à encaisser. L'ouvrir exige un compte Stripe apte à encaisser ; le fermer est immédiat.

## Pack de crédits

Lot de crédits acheté en ligne : Starter (100), Pro (500), Business (2 000) ou Enterprise (10 000).

- **Ne pas confondre avec** : [Pack d'heures](#pack-dheures).
- **Voir** : [Crédits](/v1.0/reference-api/credits).

## Pack d'heures

Crédit d'heures d'accompagnement d'un propriétaire, consommé par le temps passé sur ses projets.

- **Dans la console** : « Packs horaires ».

## Page de connexion

Page de connexion Keycloak que voient les utilisateurs d'une application, personnalisable par un [thème Keycloak](#thème-keycloak) appliqué par environnement.

- **Voir** : [Page de connexion](/v1.0/page-de-connexion).

## Page de statut

Page publique qui affiche l'état des [sondes HTTP](#sonde-http) d'un environnement.

## Page légale

Page `/legal` d'une application qui publie ses documents légaux en vigueur.

- **Dans la console** : « Page légale publique ».

## Partage

Accès à un coffre HDS donné à un utilisateur, une équipe ou un rôle, en lecture, lecture-écriture ou contrôle total.

- **Dans l'API** : `READ`, `READ_WRITE`, `FULL_CONTROL`.

## Partenaire

Voir [Propriétaire](#propriétaire).

## PKCE

Mécanisme OAuth2 qui permet à une application publique de se connecter sans secret client, en prouvant qu'elle est bien à l'origine de la demande de connexion. Les clients Keycloak des applications fonctionnent ainsi.

- **Voir** : [Connecter vos utilisateurs](/v1.0/demarrer/connecter-vos-utilisateurs).

## Portail de facturation

Page Stripe où l'utilisateur d'une application consulte ses factures, change de moyen de paiement et gère ses abonnements.

## Préfixe d'URL

Segment inséré dans toutes les adresses d'un environnement, par exemple `dev`. Un seul environnement par application peut s'en passer.

## Profil

Ensemble de [droits applicatifs](#droit-applicatif) d'une application, attribuable aux fiches utilisateur. Un profil existe dans les trois environnements avec le même [WID](#wid) ; les droits qu'il porte se règlent dans la [matrice](#matrice-droits--profils) de chaque environnement. Un réseau peut masquer un profil à ses clients.

- **Dans la console** : « Profils ». **Dans l'API** : `Profile`.
- **Ne pas confondre avec** : « Mon profil », la fiche personnelle ; [Niveau d'administration](#niveau-dadministration).
- **Voir** : [Droits et profils](/v1.0/droits-et-profils).

## Projet d'accompagnement

Projet de réalisation mené par Wakastellar pour un propriétaire : étapes, équipe projet, documents, commentaires et temps passé.

- **Dans la console** : « Projets Clients ».

## Propriétaire

Éditeur qui possède une ou plusieurs applications, au sommet de l'organisation. Le terme désigne aussi le [niveau d'administration](#niveau-dadministration) correspondant.

- **Synonyme** : partenaire. **Dans la console** : « Propriétaire », « Administrateur Partenaire », « Admin Propriétaire », « OwnerAdmin ». **Dans l'API** : `Partner`, `PARTNER_ADMIN`.
- **Ne pas confondre avec** : le propriétaire d'un coffre HDS.
- **Voir** : [Organisations](/v1.0/organisations).

## Purge automatique des builds

Nettoyage du registre qui conserve, par branche, les builds réussis les plus récents ; les images déployées sont toujours conservées.

## Quarantaine

Zone où sont isolés les fichiers déclarés infectés par l'[antivirus](#antivirus).

## Rapport de dérive

Bilan d'un environnement qui compare l'[architecture](#architecture) à ce qui est réellement provisionné : services manquants ou orphelins, variables vides, secrets non prêts, changements en attente.

- **Autres noms** : rapport d'écart, drift report. **Dans l'API** : `GET /environments/{id}/drift-report`.

## Realm

Espace d'identité Keycloak propre à un [réseau](#réseau), présent sur les trois instances (prod, staging, dev). Une application ne connaît jamais son realm : [Discovery](#discovery) le résout.

- **Voir** : [Discovery](/v1.0/reference-api/discovery).

## Réconciliation

Mécanisme par lequel la plateforme applique ce qui est enregistré : toute ressource créée ou modifiée est prise en charge en quelques secondes à quelques minutes, avec de nouvelles tentatives automatiques en cas d'échec.

- **Dans la console** : « Réconcilier ».
- **Voir** : [Limites et quotas](/v1.0/limites#applications-et-environnements).

## Redirect URI

Adresse de retour acceptée par le client Keycloak d'une application après la connexion.

- **Ne pas confondre avec** : [Redirection](#redirection).

## Redirection

Renvoi d'une adresse vers une autre : redirection d'un domaine de l'éditeur vers une URL de l'application, ou sous-domaine d'un réseau ou d'un client vers l'application.

- **Voir** : [Redirections](/v1.0/redirections).

## Registre

Espace propre à chaque application où les builds rangent leurs images.

- **Dans la console** : « Registre ».

## Réplica

Copie d'une instance de service en fonctionnement. Une instance compte un réplica par défaut.

## Réseau

Canal de distribution d'une application, qui regroupe des [clients](#client). Chaque réseau a son [realm](#realm) Keycloak sur chaque instance et transmet à ses clients son thème et sa langue par défaut.

- **Dans la console** : « Réseaux ». **Dans l'API** : `Network`.
- **Ne pas confondre avec** : [Administrateur réseau](#administrateur-réseau) ; l'exposition réseau d'un service.
- **Voir** : [Organisations](/v1.0/organisations).

## Restauration

Remise en place d'une [sauvegarde](#sauvegarde), soit à la place de la base existante, soit dans une nouvelle base.

- **Voir** : [Sauvegardes](/v1.0/sauvegardes).

## Rôle de service

Fonction d'un service dans l'architecture : front, back, BFF ou worker.

- **Dans l'API** : `FRONT`, `BACK`, `BFF`, `WORKER`.

## Rôle HDS

Rôle porté par un utilisateur pour le module HDS : administrateur, professionnel de santé, médical, patient, stockage ou suppression.

- **Dans l'API** : `HDS_ADMIN`, `HDS_HEALTHCARE`, `HDS_MEDICAL`, `HDS_PATIENT`, `HDS_STORAGE`, `HDS_DELETE`.
- **Voir** : [HDS](/v1.0/reference-api/hds#rôles-hds).

## Route

Rattachement d'un chemin d'une [URL publique](#url-publique) à un service, mis en ligne par environnement avec son certificat et son enregistrement DNS.

- **Ne pas confondre avec** : [Hôte IAM](#hôte-iam).

## Sauvegarde

Copie chiffrée des données d'une base ou d'un bucket, manuelle ou planifiée, téléchargeable et restaurable.

- **Dans la console** : « Backups », « Sauvegarder maintenant ».
- **Ne pas confondre avec** : [Blueprint](#blueprint).
- **Voir** : [Sauvegardes](/v1.0/sauvegardes).

## Secret d'environnement

Valeur sensible rangée dans le [coffre de secrets](#coffre-de-secrets), jamais relisible après sa saisie : on la remplace. Sa modification redémarre les services qui l'utilisent.

- **Ne pas confondre avec** : [Variable en clair](#variable-en-clair).

## Service

Composant d'une application (front, back, BFF, worker), décrit une fois dans l'architecture puis déployé dans chaque environnement.

- **Ne pas confondre avec** : [Module](#module).
- **Voir** : [Services](/v1.0/services).

## Sonde

Vérification automatique d'un service. Voir [Sonde de santé](#sonde-de-santé) pour les vérifications du cluster et [Sonde HTTP](#sonde-http) pour la supervision externe.

## Sonde de santé

Vérifications que le cluster fait sur un service pour savoir s'il démarre, s'il vit et s'il est prêt à recevoir du trafic. Le chemin par défaut est `/health`.

- **Dans la console** : « Health Probes ».

## Sonde HTTP

Vérification externe et périodique d'une URL HTTPS d'un environnement, affichée sur la [page de statut](#page-de-statut).

- **Dans la console** : « Sondes HTTP », onglet « Monitoring ».

## SSO

Connexion des utilisateurs d'un client avec leur compte d'entreprise, par un [fournisseur d'identité](#fournisseur-didentité) déclaré et activé.

- **Voir** : [SSO entreprise](/v1.0/sso).

## Statut de provisionnement

Étape du cycle de vie d'une ressource d'hébergement : `PENDING` (enregistrée), `PROVISIONING` (en cours), `PROVISIONED` (en place, `READY` pour une base ou un bucket), `FAILED` (échec, avec nouvelles tentatives), puis `DESTROYING` et `DESTROYED` à la suppression.

- **Dans la console** : « En attente », « Provisionnement », « Provisionné », « Prêt », « Échec », « Suppression », « Supprimé ».
- **Ne pas confondre avec** : [État de santé](#état-de-santé).

## Tableau de bord

Page d'accueil de la console, avec un accès rapide aux applications de l'utilisateur.

## Thème

Jeu de variables CSS, en mode clair et sombre, ajouté à une application. Le thème appliqué se résout : préférence de l'utilisateur, puis client, réseau, thème par défaut de l'application.

- **Ne pas confondre avec** : [Thème Keycloak](#thème-keycloak).
- **Voir** : [Apparence](/v1.0/apparence).

## Thème Keycloak

Thème de la page de connexion et des e-mails Keycloak d'une application, versionné dans une [bibliothèque](#bibliothèque-de-versions) propre à chaque environnement, puis appliqué dans cet environnement.

- **Voir** : [Page de connexion](/v1.0/page-de-connexion).

## Ticket

Demande de support rattachée à une application, avec type, priorité, état, commentaires et pièces jointes.

## Type d'environnement

Valeur `dev`, `staging` ou `prod` d'un environnement, qui ne change plus après sa création. Elle détermine l'instance Keycloak, ainsi que les profils et les droits applicables.

- **Dans l'API** : `envType`, champ `wenv` du jeton enrichi.
- **Ne pas confondre avec** : [Environnement](#environnement).

## URL publique

Sous-domaine d'un domaine, déclaré dans l'architecture, auquel on rattache des [routes](#route).

- **Voir** : [Domaines et URLs](/v1.0/domaines-et-urls).

## Utilisateur

Fiche d'une personne rattachée à un client, dans un environnement : adresse e-mail unique dans ce client et cet environnement, [WID](#wid), [niveau d'administration](#niveau-dadministration), profil, équipes et compte Keycloak. Une même personne présente en dev, en staging et en prod a trois fiches indépendantes. Désigne aussi le niveau d'administration le plus bas, au-dessus de « aucun ».

- **Dans l'API** : `User`, niveau `USER`.
- **Voir** : [Utilisateurs et équipes](/v1.0/utilisateurs).

## Variable attendue

Déclaration, dans une [définition de service](#définition-de-service), d'une variable dont le service a besoin : nom, valeur par défaut, variable d'environnement ou fichier monté. Chaque environnement la relie ensuite à une valeur par une [liaison](#liaison).

- **Dans la console** : « Variables consommées ». **Dans l'API** : `ServiceVarRequirement`.
- **Voir** : [Variables et secrets](/v1.0/variables-et-secrets).

## Variable calculée

Valeur fournie par la plateforme pour un environnement : nom de l'application, adresses internes des services, URLs publiques des routes.

- **Dans la console** : filtre « Auto ».

## Variable de plateforme

Valeur commune à toutes les applications, gérée par Wakastart et visible dans la configuration de chaque environnement.

- **Dans la console** : filtre « Plateforme ».

## Variable en clair

Valeur non sensible saisie dans la configuration d'un environnement et stockée en clair.

- **Ne pas confondre avec** : [Secret d'environnement](#secret-denvironnement).

## Visuels

Logos clair et sombre, fonds clair et sombre et favicon d'une application, d'un réseau ou d'un client.

- **Voir** : [Habillage](#habillage).

## Wakapp

Nom courant d'une [application](#application) construite sur Wakastart, qui s'appuie sur la plateforme pour l'identité de ses utilisateurs et, le cas échéant, pour son hébergement.

## Webhook

Requête HTTP que Wakastart envoie à une URL de votre application pour la prévenir d'un événement, par exemple la fin d'un scan antivirus. La requête est signée pour que vous puissiez vérifier son origine.

- **Voir** : [Antivirus](/v1.0/reference-api/antivirus#recevoir-le-résultat-par-webhook).

## WID

Identifiant court de 6 caractères alphanumériques (5 ou 6 pour un profil) attribué aux propriétaires, réseaux, clients, applications, équipes, utilisateurs et profils. Le WID d'une application sert d'identifiant de client Keycloak. Le WID d'un profil est commun aux trois environnements ; celui d'un utilisateur est propre à sa fiche, donc à son environnement.

- **Exemple** : `EXCLI1`. **Dans l'API** : champs et paramètres `…Wid`.
- **Voir** : [Conventions](/v1.0/reference-api/conventions#identifiants).
