Frontend Client — Référence auto-générée (`client-alta`)

Cette page est auto-générée depuis le code source Vue 3 par scripts/generate-frontend-docs.js. Ne modifiez pas le contenu entre les marqueurs AUTO à la main — lancez npm run generate-frontend-docs à la place.

Dernière génération: 2026-07-01T14:07:11.232Z

Architecture de l'application

Vues (pages)

views/
  Account.vue
  AccountSetup.vue
  Base.vue
  Downloads.vue
  Feedback.vue
  GetStarted.vue
  Home.vue
  Login.vue
  NotFound.vue
  Onboarding.vue
  PasswordReset.vue
  PrivacyPolicy.vue
  dashboard/Abtests.vue
  dashboard/AbtestsRequest.vue
  dashboard/Base.vue
  dashboard/GroupManage.vue
  dashboard/Home.vue
  dashboard/Issues.vue
  dashboard/Labels.vue
  dashboard/Machines.vue
  dashboard/OutdatedMachines.vue
  dashboard/Users.vue
  help/Api.vue
  help/Base.vue
  help/Docs.vue
  help/DocsWeb.vue
  help/Faq.vue
  help/Home.vue
  help/Setup.vue
  help/SoftwareOverview.vue
  organization/Accounts.vue
  organization/Base.vue
  organization/Groups.vue
  organization/Settings.vue

Routes

Chemin	Nom	Auth requise	Composant
`/`	—	—	`views/Home.vue`
`/login`	login	—	`views/Login.vue`
`/password-reset`	password-reset	—	`views/PasswordReset.vue`
`/account-setup`	AccountSetup	Non	`views/AccountSetup.vue`
`/account`	account	Oui	`views/Account.vue`
`/onboarding`	—	Oui	`views/Onboarding.vue`
`/dashboard`	—	Oui	`views/dashboard/Base.vue`
`users`	—	—	—
`/dashboard/group/:group?`	—	Oui	`views/dashboard/Base.vue`
`/`	dashboard	—	`views/dashboard/Home.vue`
`manage`	dashboard.group	—	`views/dashboard/GroupManage.vue`
`users`	dashboard.users	—	`views/dashboard/Users.vue`
`labels`	dashboard.labels	—	`views/dashboard/Labels.vue`
`users/:id`	dashboard.users.detail	—	`views/dashboard/Users.vue`
`machines`	dashboard.machines	—	`views/dashboard/Machines.vue`
`machines/:id`	dashboard.machines.detail	—	`views/dashboard/Machines.vue`
`issues`	dashboard.issues	—	`views/dashboard/Issues.vue`
`outdated-machines`	dashboard.outdated-machines	—	`views/dashboard/OutdatedMachines.vue`
`abtests`	dashboard.abtests	—	`views/dashboard/Abtests.vue`
`abtests/request`	dashboard.requests	—	`views/dashboard/AbtestsRequest.vue`
`abtests/:id/edit`	dashboard.abtests.edit	—	`views/dashboard/AbtestsRequest.vue`
`/help`	—	Non	`views/help/Base.vue`
`/`	—	Oui	`views/help/Home.vue`
`docs`	—	Oui	`views/help/Docs.vue`
`docs/web`	—	Oui	`views/help/DocsWeb.vue`
`faq`	—	Oui	`views/help/Faq.vue`
`setup`	—	Non	`views/help/Setup.vue`
`software-overview`	—	Non	`views/help/SoftwareOverview.vue`
`api`	—	Non	`views/help/Api.vue`
`/organization`	—	Oui	`views/organization/Base.vue`
`/`	—	—	—
`settings`	—	—	`views/organization/Settings.vue`
`accounts`	—	—	`views/organization/Accounts.vue`
`groups`	—	—	`views/organization/Groups.vue`
`/downloads`	—	Oui	`views/Downloads.vue`
`/privacy`	—	Oui	`views/PrivacyPolicy.vue`
`/get-started`	—	Non	`views/GetStarted.vue`
`/feedback`	—	Oui	`views/Feedback.vue`
`/:pathMatch(.)`	NotFound	Non	`views/NotFound.vue`

Store Vuex — State

Clés de state réactives de premier niveau gérées par Vuex 4 :

currentLanguage
helpScoutBeaconId
apiUrl
authenticated
supportEmail
auth
user
impersonation
groups
selectedGroup
selectedGroupId
version
organization
downloadsUrl

Référence des composants

`AbtestCard`

Props

Prop	Type	Requis	Défaut	Description
`test`	undefined	Non	—	—

Événements

Événement	Description
`refresh`	—

Slots

Aucun.

`AbtestForm`

Props

Prop	Type	Requis	Défaut	Description
`obj`	—	Non	—	—
`group`	—	Oui	—	—

Événements

Événement	Description
`save`	—

Slots

Aucun.

`ApiForm`

Rôle : Composant de formulaire générique pour créer/mettre à jour des ressources via l'API.

Fonctionnalités :

Gestion de l'état de chargement
Affichage des erreurs de validation backend
Slots personnalisables pour l'en-tête, le corps du formulaire et les boutons
Préparation des données avant envoi (prepareSave)
Réinitialisation du formulaire après sauvegarde

Routes API appelées :

POST {endpoint} : Création d'une nouvelle ressource
PATCH/PUT {endpoint}/{id} : Mise à jour d'une ressource existante

Props

Prop	Type	Requis	Défaut	Description
`endpoint`	—	Oui	—	—
`idField`	string	Non	`'id'`	—
`obj`	—	Non	—	—
`additionalData`	func	Non	`() => {return {}}`	—
`defaultData`	func	Non	`() => {return {}}`	—
`updateMethod`	string	Non	`"patch"`	—
`createMethod`	string	Non	`"post"`	—
`showSuccessMessage`	boolean	Non	`true`	—
`resetOnSave`	boolean	Non	`false`	—
`prepareSave`	func	Non	`() => {return (d) => {return d}}`	—
`submitProps`	func	Non	`() => {return {}}`	—
`responseAttr`	string	Non	`null`	—

Événements

Événement	Description
`save`	—

Slots

Slot	Description
`header`	—
`success-message`	—
`form-body`	—
`form-controls-before`	—
`form-submit`	—
`form-controls-after`	—

`AppButton`

Props

Prop	Type	Requis	Défaut	Description
`isLoading`	boolean	Non	`false`	—

Événements

Aucun.

Slots

Slot	Description
`default`	—

`AppFooter`

Props

Aucun.

Événements

Aucun.

Slots

Aucun.

`AppIcon`

Props

Prop	Type	Requis	Défaut	Description
`name`	string	Non	—	—
`size`	string	Non	—	—
`color`	string	Non	—	—
`title`	string	Non	—	—
`desc`	string	Non	—	—

Événements

Aucun.

Slots

Aucun.

`AppMenu`

Props

Aucun.

Événements

Aucun.

Slots

Aucun.

`AppModal`

Props

Prop	Type	Requis	Défaut	Description
`submitAction`	—	Non	—	—
`validateAction`	—	Non	—	—

Événements

Événement	Description
`close`	—

Slots

Slot	Description
`header`	—
`default`	—
`footer`	—
`action-button`	—

`AudioInfo`

Props

Aucun.

Événements

Aucun.

Slots

Aucun.

`CaptionedImage`

Props

Prop	Type	Requis	Défaut	Description
`url`	undefined	Non	—	—
`alt`	undefined	Non	—	—

Événements

Aucun.

Slots

Slot	Description
`default`	—

`DataTable`

Props

Prop	Type	Requis	Défaut	Description
`tableProps`	object	Non	`{ itemsPerPage: 0, isPaginated: false, isSelectable: false, rowActions: [], hasGlobalSearch: false }`	—
`model`	array	Oui	—	—
`columnDefs`	array	Oui	—	—

Événements

Aucun.

Slots

Aucun.

`DeviceInfo`

Props

Prop	Type	Requis	Défaut	Description
`machine`	undefined	Non	—	—
`hide`	undefined	Non	—	—

Événements

Aucun.

Slots

Aucun.

`DownloadLink`

Props

Prop	Type	Requis	Défaut	Description
`apiUrl`	undefined	Non	—	—
`filename`	undefined	Non	—	—

Événements

Aucun.

Slots

Slot	Description
`default`	—

`EmptyState`

Props

Aucun.

Événements

Aucun.

Slots

Slot	Description
`default`	—
`controls`	—

`FieldErrors`

Props

Prop	Type	Requis	Défaut	Description
`errors`	object	Non	`{}`	—
`field`	string	Non	`null`	—

Événements

Aucun.

Slots

Aucun.

`ImpersonateWidget`

Props

Aucun.

Événements

Aucun.

Slots

Aucun.

`IssueMessage`

Props

Prop	Type	Requis	Défaut	Description
`issue`	undefined	Non	—	—

Événements

Aucun.

Slots

Aucun.

`ListField`

Props

Prop	Type	Requis	Défaut	Description
`modelValue`	—	Non	—	—
`type`	string	Non	`'text'`	—
`delimiters`	func	Non	`() => {return /,\| /;}`	—

Événements

Événement	Description
`update:modelValue`	—

Slots

Aucun.

`LoadingArea`

Rôle : Composant de chargement générique pour afficher un indicateur de progression et potentiellement charger des données depuis l'API.

Fonctionnalités :

Affichage d'un indicateur de chargement (icône tournante)
Gestion des erreurs de chargement
Événements déclenchés au début et à la fin du chargement

Routes API appelées :

GET {apiUrl} : Chargement de données depuis l'API (optionnel)

Props

Prop	Type	Requis	Défaut	Description
`isLoading`	boolean	Non	`false`	—
`showErrors`	boolean	Non	`true`	—
`apiUrl`	string	Non	`null`	—
`apiParams`	func	Non	`() => {return {}}`	—

Événements

Événement	Description
`loading`	—
`loaded`	—
`error`	—

Slots

Slot	Description
`default`	—

`Logo`

Props

Aucun.

Événements

Aucun.

Slots

Aucun.

`MachineRow`

Props

Prop	Type	Requis	Défaut	Description
`obj`	—	Non	—	—
`meta`	—	Non	—	—
`expand`	boolean	Non	`false`	—

Événements

Événement	Description
`expanded`	—
`filter`	—
`updated`	—

Slots

Aucun.

`Pagination`

Props

Prop	Type	Requis	Défaut	Description
`current`	number	Non	`1`	—
`paginateBy`	number	Non	`25`	—
`total`	number	Oui	—	—
`compact`	boolean	Non	`false`	—

Événements

Événement	Description
`page-changed`	—

Slots

Aucun.

`SortLink`

Props

Prop	Type	Requis	Défaut	Description
`value`	string	Non	—	—
`currentSort`	string	Non	—	—

Événements

Événement	Description
`updated`	—

Slots

Slot	Description
`default`	—

`TOC`

Props

Prop	Type	Requis	Défaut	Description
`contentElement`	undefined	Non	—	—
`level`	undefined	Non	—	—

Événements

Aucun.

Slots

Aucun.

`UserRow`

Props

Prop	Type	Requis	Défaut	Description
`obj`	—	Non	—	—
`meta`	—	Non	—	—
`expand`	boolean	Non	`false`	—

Événements

Événement	Description
`expanded`	—
`filter`	—
`updated`	—

Slots

Slot	Description
`checkbox`	—

`VersionCard`

Props

Prop	Type	Requis	Défaut	Description
`version`	—	Oui	—	—
`showChanges`	boolean	Non	`true`	—

Prop	Type	Requis	Défaut	Description
`group`	—	Non	—	—

Événements

Aucun.

Slots

Aucun.

`Downloads.vue`

Props

Aucun.

Événements

Aucun.

Slots

Aucun.

`Feedback.vue`

Props

Aucun.

Événements

Aucun.

Slots

Aucun.

`GetStarted.vue`

Props

Aucun.

Événements

Aucun.

Slots

Aucun.

`Home.vue`

Props

Aucun.

Événements

Aucun.

Slots

Aucun.

Rôle : Page de connexion permettant aux utilisateurs d'accéder à leur espace client Alta Call.

Fonctionnalités :

Formulaire de connexion avec email et mot de passe
Préremplissage du champ email si fourni en query
Redirection vers la page d'accueil ou la page demandée après connexion réussie
Déconnexion immédiate si prop logout=true

Routes API appelées :

POST api/login : Authentification utilisateur et récupération du token

Props

Prop	Type	Requis	Défaut	Description
`next`	undefined	Non	—	—
`logout`	undefined	Non	—	—

Événements

Aucun.

Slots

Aucun.

`NotFound.vue`

Props

Aucun.

Événements

Aucun.

Slots

Aucun.

`Onboarding.vue`

Rôle : Processus d'intégration pour les nouveaux utilisateurs, les guidant à travers les étapes essentielles.

Fonctionnalités :

Étape 1 : Vérification et mise à jour des informations du compte
Étape 2 : Téléchargement et installation du logiciel Alta Call
Étape 3 : Génération et gestion des clés de licence
Étape 4 : Finalisation et accès aux ressources
Sauvegarde de l'état de progression via la query string
Marquage de l'onboarding comme terminé à la fin

Routes API appelées :

PUT api/accounts/{id} : Mise à jour des informations du compte
POST api/license : Génération d'une nouvelle clé de licence
GET api/license : Récupération de la liste des clés de licence

Props

Aucun.

Événements

Aucun.

Slots

Aucun.

`PasswordReset.vue`

Props

Prop	Type	Requis	Défaut	Description
`next`	string	Non	`''`	—
`logout`	string	Non	`''`	—

Événements

Aucun.

Slots

Aucun.

`PrivacyPolicy.vue`

Props

Aucun.

Événements

Aucun.

Slots

Aucun.

`dashboard/Abtests.vue`

Rôle : Page de gestion des tests A/B, affichant les tests en cours et terminés.

Fonctionnalités :

Liste des tests A/B avec filtre "en cours" / "tous les tests"
Pagination des résultats
Lien vers la page de demande de nouveau test A/B
Actualisation automatique des tests

Routes API appelées :

GET api/abtests : Récupération de la liste des tests A/B avec filtres et pagination

Props

Prop	Type	Requis	Défaut	Description
`id`	—	Non	—	—
`group`	—	Non	—	—

Événements

Aucun.

Slots

Aucun.

`dashboard/AbtestsRequest.vue`

Props

Prop	Type	Requis	Défaut	Description
`id`	—	Non	—	—
`group`	—	Non	—	—

Événements

Événement	Description
`update:abtest`	—

Slots

Aucun.

`dashboard/Base.vue`

Props

Prop	Type	Requis	Défaut	Description
`group`	—	Non	—	—

Événements

Aucun.

Slots

Aucun.

`dashboard/GroupManage.vue`

Props

Prop	Type	Requis	Défaut	Description
`group`	—	Oui	—	—

Événements

Aucun.

Slots

Aucun.

`dashboard/Home.vue`

Rôle : Page d'accueil du tableau de bord, affichant les statistiques clés pour le groupe sélectionné.

Fonctionnalités :

Sélecteur de groupe si l'utilisateur appartient à plusieurs groupes
Statistiques des utilisateurs en ligne et avec erreurs
Statistiques des machines en ligne et avec erreurs
Liste des tests A/B en cours
Polling automatique des statistiques toutes les 5 minutes

Routes API appelées :

GET api/users : Récupération des utilisateurs avec filtres
GET api/machines : Récupération des machines avec filtres
GET api/abtests : Récupération des tests A/B en cours
GET api/software-versions : Récupération des versions de logiciel disponibles
GET api/outdated-machine : Récupération des machines avec version obsolète

Props

Prop	Type	Requis	Défaut	Description
`group`	—	Non	—	—

Événements

Aucun.

Slots

Aucun.

`dashboard/Issues.vue`

Rôle : Page de suivi des problèmes rencontrés sur les machines, avec solutions proposées.

Fonctionnalités :

Filtres multiples : recherche, statut en ligne/hors ligne, version, erreur spécifique, labels, tests A/B, délai
Pagination des résultats
Tri des colonnes
Modal détaillé pour chaque problème avec description, solutions et astuces
Lien direct vers la page de configuration de l'utilisateur/machine concerné
Export CSV des résultats filtrés

Routes API appelées :

GET api/machine-issue : Récupération de la liste des problèmes avec filtres et pagination
GET api/meta : Récupération des métadonnées (versions, erreurs, labels, tests A/B)
GET api/machine-issue/export : Export CSV des problèmes filtrés

Props

Prop	Type	Requis	Défaut	Description
`id`	—	Non	—	—
`group`	—	Non	—	—

Événements

Aucun.

Slots

Aucun.

`dashboard/Labels.vue`

Props

Prop	Type	Requis	Défaut	Description
`group`	—	Oui	—	—

Événements

Aucun.

Slots

Aucun.

`dashboard/Machines.vue`

Rôle : Page de gestion des machines, permettant de visualiser, filtrer et consulter les détails des postes de travail.

Fonctionnalités :

Filtres multiples : recherche, statut en ligne/hors ligne, pays, version, erreurs, application connectée
Pagination des résultats
Tri des colonnes
Export CSV des résultats filtrés
Affichage détaillé d'une machine via son ID

Routes API appelées :

GET api/machines : Récupération de la liste des machines avec filtres et pagination
GET api/meta : Récupération des métadonnées (pays, versions, erreurs, applications connectées)
GET api/machines/export : Export CSV des machines filtrées

Props

Prop	Type	Requis	Défaut	Description
`id`	—	Non	—	—
`group`	—	Non	—	—

Événements

Aucun.

Slots

Aucun.

`dashboard/OutdatedMachines.vue`

Props

Prop	Type	Requis	Défaut	Description
`group`	—	Oui	—	—

Événements

Aucun.

Slots

Aucun.

`dashboard/Users.vue`

Rôle : Page de gestion des utilisateurs, permettant de visualiser, filtrer et modifier les profils.

Fonctionnalités :

Filtres multiples : recherche, statut en ligne/hors ligne, pays, transformation, erreurs, labels, tests A/B, audio tuné, consentement enregistrement
Pagination des résultats
Tri des colonnes
Actions en masse : appliquer transformation, ajouter/supprimer labels, définir test A/B, verrouiller/déverrouiller UI
Export CSV des résultats filtrés
Mise à jour en temps réel des informations utilisateur

Routes API appelées :

GET api/users-machines : Récupération de la liste des utilisateurs avec filtres et pagination
GET api/meta : Récupération des métadonnées (pays, transformations, labels, tests A/B)
POST api/users/action : Exécution d'actions en masse sur les utilisateurs
GET api/users/export : Export CSV des utilisateurs filtrés

Props

Prop	Type	Requis	Défaut	Description
`id`	—	Non	—	—
`group`	—	Non	—	—

Événements

Aucun.

Slots

Aucun.