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/healthrépondok, avec la liste de ce qui manque (diagnostic) ;https://valitrax.mostajs.dev/api/clerend la clé publique et son empreinte ;- un compte de test reçoit bien son courriel d’invitation.