Version Markdown

Administration

Les comptes, les projets, la liaison avec QaTrax (réglée une fois, par l’administrateur), et les réglages techniques d’une campagne.

Qui est administrateur

Les adresses de VALITRAX_EQUIPE (voir Configuration) deviennent administratrices de la plateforme au démarrage. L’administrateur voit tous les projets, toutes les entreprises et toutes les campagnes ; les menus Entreprises et Comptes ne sont qu’à lui.

Les comptes

Menu Comptes › Nouveau compte : adresse, prénom, nom. ValiTrax envoie lui-même le lien pour choisir le mot de passe — aucun mot de passe n’est affiché ni transmis par vous. Pour un testeur, passez plutôt par la page du projet : le rôle est donné en même temps.

Les projets

Menu Projets › Nouveau projet :

• clé : minuscules, chiffres, tirets (guerway) ;
• nom lisible ; description ;
• clé chez QaTrax : celle du projet dans QaTrax, si elle diffère (c’est elle qui tire les feuillets). Elle se corrige ensuite dans la carte Liaison avec QaTrax.

Trois noms à ne pas confondre

La clé chez QaTrax est celle que QaTrax affiche pour le projet : la même pour toutes les campagnes du projet. Mettre à sa place un n° de campagne ou une référence de document, c’est demander à QaTrax un projet qu’il ne connaît pas : il répond 404 (« QaTrax a répondu 404 sur …/trame?p=GW-CDC-2026-01 ») et la campagne reste sans feuillet — voir Une campagne sans feuillet.

Le menu Projets range les logiciels (la recette) et les formations en entreprise (une entreprise cliente sur un logiciel) ; une formation s’ouvre par une nouvelle vente (les entreprises clientes).

La page d’un projet regroupe ses campagnes (et le formulaire pour en ouvrir une), ses testeurs, et — pour l’administrateur seul — sa liaison avec QaTrax. Son équipe et ses rôles ont leur propre page, Équipe et rôles, ouverte par le lien en tête de la page du projet ou par le menu (les rôles d’un projet).

Mettre un projet en route

La première recette d’un projet, dans l’ordre. Chaque étape suppose la précédente.

1. Le projet existe, avec la bonne clé chez QaTrax (guerway pour Guerway Express) : page du projet, carte Liaison avec QaTrax.
2. La liaison est réglée et vérifiée (ci-dessous) : adresse de QaTrax, jeton, clés.
3. Les testeurs sont ajoutés au projet (carte Testeurs, Les testeurs). Un compte créé seulement dans Comptes n’est testeur d’aucun projet : ajoutez-le aussi ici — il garde son mot de passe.
4. La campagne est ouverte (version candidate, instance d’essai) : elle naît prête, avec ses feuillets par rôle (Ouvrir une campagne).
5. Chaque feuillet est remis à un testeur (carte Feuillets par rôle) : il est prévenu par courriel et le trouve dans Mes feuillets.

Un testeur connecté qui ne voit aucun feuillet : l’étape 3 ou l’étape 5 manque — ValiTrax ne montre à un testeur que les feuillets qui lui ont été remis.

La liaison avec QaTrax

C’est le seul réglage technique, et il se fait une fois, par l’administrateur, sur la page du projet (carte Liaison avec QaTrax). Les responsables et les testeurs ne la voient pas.

1. Dans QaTrax (page « Recette client » de l’espace du projet, par exemple https://guerway.qatrax.dev/recette) : Engendrer un nouveau jeton ; copiez-le (il ne s’affiche qu’une fois). Collez-y l’adresse de la page du projet dans ValiTrax (affichée dans la carte, « À recopier dans QaTrax »), puis ⟳ Synchroniser avec ValiTrax : QaTrax lit la clé publique de ValiTrax.
2. Dans ValiTrax (carte Liaison avec QaTrax) : l’adresse de QaTrax (https://guerway.qatrax.dev), le jeton collé, les deux clés laissées vides ; Enregistrer la liaison : ValiTrax lit les clés chez QaTrax.
3. Vérifiez que l’empreinte du jeton est la même des deux côtés, et que les clés affichées par ValiTrax sont celles qu’affiche QaTrax.

Ensuite : ⟳ Synchroniser avec QaTrax relit ses clés (après un changement chez lui) ; Ouvrir la recette chez QaTrax ↗ mène à sa page « Recette client ». Un nouveau jeton chez QaTrax s’enregistre de nouveau ici. La liaison est propre au projet : en régler une ne touche pas aux autres projets ; Revenir à la liaison de l’instance reprend celle du .env.

Une campagne sans feuillet

Si une campagne affiche « La trame n’est pas venue de QaTrax », la clé du projet chez QaTrax est fausse, ou la liaison n’était pas encore réglée à son ouverture. La clé est celle du projet dans l’espace QaTrax (par exemple guerway) — ni le n° de la campagne, ni une référence de cahier des charges (trois noms à ne pas confondre). Le message d’erreur le trahit : 404 sur …/trame?p=<clé> veut dire « QaTrax ne connaît pas cette clé » ; 403, « jeton refusé » — la liaison est alors à refaire.

1. Sur la page du projet, carte Liaison avec QaTrax : corrigez clé du projet chez QaTrax, puis Enregistrer la liaison.
2. Dans la campagne, Réglages techniques → Trame : la clé corrigée est proposée ; Synchroniser. La campagne devient prête : feuillets par rôle préparés, recette ouverte. Il ne reste qu’à les remettre aux testeurs. Inutile d’ouvrir une autre campagne : celle-ci garde son numéro et prend la bonne clé.

Les réglages techniques d’une campagne

Dans une campagne, l’administrateur a une section repliée Réglages techniques :

• Trame › Synchroniser : retirer les feuillets de QaTrax (après une mise à jour du plan) ; ce qui a été écrit pour le client n’est jamais écrasé ;
• Points : toutes les lignes de la trame ; Retenir une liste de références, ou une exigence entière (SPEC-RCT-A) pour un rôle ;
• Vérification — ce que l’équipe relève : l’équipe joue elle-même les lignes retenues ;
• Feuillets (accès par code) : l’ancien accès sans compte (un lien et un mot de passe affichés une fois), pour un cas particulier ;
• Figer le dossier, Exporter (signé et scellé), PV collé à la main : le chemin manuel, si QaTrax n’est pas joignable.