# Exploitation

> Déployer une version, sauvegarder la base, redémarrer, surveiller, et les modules dont ValiTrax dépend.

## Déployer

Depuis le dossier de ValiTrax : `bash ../deployer/deploy.sh ./deployer.conf`. Le déploiement copie le code (dont `src/` et `aide/`), installe les modules, redémarre le processus `valitrax` (pm2) et vérifie `/api/health`. Le `.env` du serveur est **préservé**.

**Avant chaque déploiement, sauvegardez la base** : copiez le fichier de `SGBD_URI` dans `sauvegardes/`, horodaté, lisible du seul propriétaire (`chmod 600`).

## Les modules

| module | ce qu’il apporte |
|---|---|
| `@mostajs/recette` | le moteur : campagnes, étapes, relevés, rapport d’étape, dossier signé, PV, feu |
| `@mostajs/feuille-recette` | le feuillet : sur papier (PDF cochable) et à l’écran (`/web` : remarques, pièces, captures, enregistrement au fur et à mesure) |
| `@mostajs/mailer` | l’envoi des courriels |
| `@mostajs/orm`, `@mostajs/socle`, `@mostajs/rbac-tenant`, `@mostajs/users` | la base, les comptes, les rôles par projet |

Une nouvelle version d’un module se publie, puis s’installe ici (`npm install`), puis se déploie.

## Surveiller

- `pm2 logs valitrax` : les avertissements de configuration s’écrivent au démarrage ;
- la page des campagnes de l’administrateur rappelle ce qui manque ;
- chaque envoi vers QaTrax est consigné dans sa campagne, réussi ou non.

## Les feuillets PDF

Les mêmes feuillets se fabriquent en PDF cochable sur un poste (pas sur le serveur) : `node outils/feuillets.mjs` lit le manifeste d’une campagne et compose un PDF par rôle, avec la ligne ✎ de remarques sous chaque action.