# Configuration

> Le fichier .env de l’instance — adresse, base, clés de signature, équipe d’administration, liaison QaTrax par défaut, serveur d’envoi des courriels.

## Le fichier .env

ValiTrax lit sa configuration dans le `.env` de son dossier (modèle : `.env.example`). Un réglage manquant est signalé au démarrage et en tête de la page des campagnes de l’administrateur (« Configuration incomplète »). Les valeurs ne s’affichent jamais à l’écran.

| variable | rôle | exemple |
|---|---|---|
| `PORT`, `HOST` | où le serveur écoute (derrière le serveur web) | `4980`, `127.0.0.1` |
| `PUBLIC_BASE_URL` | l’adresse publique : elle est écrite dans les liens des courriels | `https://valitrax.mostajs.dev` |
| `DB_DIALECT`, `SGBD_URI` | la base de données | `sqljs`, `./donnees/valitrax.db` |
| `VALITRAX_CLE_PRIVEE`, `VALITRAX_CLE_NOM` | la clé qui **signe** ce que ValiTrax envoie (rapports, dossiers) | — |
| `VALITRAX_EQUIPE` | les adresses administratrices, séparées par des virgules | `admin@exemple.dz` |
| `VALITRAX_MDP_EQUIPE` | le mot de passe initial de ces comptes (à changer dans « Mon compte ») | — |
| `QATRAX_BASE_URL`, `QATRAX_TRAME_JETON`, `QATRAX_CLE_PUBLIQUE`, `QATRAX_CLE_RECEPTION` | la liaison QaTrax **par défaut** de l’instance ; chaque projet peut avoir la sienne, réglée à l’écran | — |
| `EMAIL_SERVER_HOST`, `EMAIL_SERVER_PORT`, `EMAIL_SERVER_USER`, `EMAIL_SERVER_PASSWORD`, `EMAIL_FROM`, `EMAIL_FROM_NAME` | le serveur d’envoi des courriels (invitations, mot de passe oublié, feuillet remis) | `smtp.exemple.dz`, `587` |

Sans serveur d’envoi, rien ne se perd : l’écran affiche le lien à transmettre à la main.

## Les clés

La clé de signature de ValiTrax s’engendre **une fois**, à la mise en service, avec `engendrerClefs()` de `@mostajs/recette/sceau` ; la privée va dans `VALITRAX_CLE_PRIVEE`, jamais ailleurs. Sa publique se lit sur `https://valitrax.mostajs.dev/api/cle` (c’est elle que QaTrax lit par « ⟳ Synchroniser avec ValiTrax »). Changer la clé demande de resynchroniser chaque QaTrax relié.

## Ce qui se vérifie après un réglage

- `https://valitrax.mostajs.dev/api/health` répond `ok`, avec la liste de ce qui manque (`diagnostic`) ;
- `https://valitrax.mostajs.dev/api/cle` rend la clé publique et son empreinte ;
- un compte de test reçoit bien son courriel d’invitation.