# 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](/aide/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](/aide/testeurs) : 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

| nom | exemple | qui le donne | à quoi il sert |
|---|---|---|---|
| **n° de campagne** | `REC-2026-0002` | ValiTrax, à l’ouverture | désigner une recette ; il change à chaque campagne |
| **clé du projet chez QaTrax** | `guerway` | QaTrax (le projet de l’espace `guerway.qatrax.dev`) | tirer les feuillets, et renvoyer les défauts au bon projet |
| **référence du cahier des charges** | `GW-CDC-2026-01` | le document du client | citer le cahier ; ce **n’est pas** une clé |

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](#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](/aide/entreprises)).

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](/aide/testeurs#les-roles-dun-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](#la-liaison-avec-qatrax)) : adresse de QaTrax, jeton, clés.
3. **Les testeurs** sont ajoutés au projet (carte **Testeurs**, [Les testeurs](/aide/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](/aide/campagne#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](#trois-noms-a-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.