# CHAPITRE 27 — Mise à jour du module
Les mises à jour du module s'effectuent sans interruption visible côté visiteurs. Ce chapitre présente la procédure standard et les précautions à observer.
### Avant la mise à jour — liste de contrôle
**Sur une instance de production, ne sautez jamais ces étapes :**
- Sauvegarde complète de la base Dolibarr (mysqldump).
- Sauvegarde du dossier `htdocs/custom/infrasstudio/` existant.
- Sauvegarde des données : `DOL_DATA_ROOT//website/` et `medias/`.
- Lecture du changelog de la nouvelle version pour repérer d'éventuelles modifications majeures.
- Test de la mise à jour sur une instance de pré-production lorsque c'est possible.
### Procédure standard
##### **Étape 1 — Désactiver le module**
Configuration → Modules → InfraSStudio → cliquer sur **Désactiver**.
**Effet de la désactivation —** Les constantes du module sont sauvegardées sous le préfixe `INFRASSTUDIOBKP_`. Les tables et leurs données restent intactes. L'entrée Outils → InfraS disparaît.
##### **Étape 2 — Remplacer les fichiers**
Trois méthodes selon votre environnement :
**Via l'interface Dolibarr**
1. Configuration → Modules → bouton **« Déployer / installer un module »**.
2. Sélectionner la nouvelle archive `module_infrasstudio-X.Y.Z.zip`.
3. Confirmer le remplacement.
**Via SSH ou FTP**
```
cd /var/www/dolibarr/htdocs/custom/
mv infrasstudio infrasstudio.old.20260504
unzip /tmp/module_infrasstudio-1.9.0.zip
chown -R www-data:www-data infrasstudio/
```
**Via Git**
```
cd /var/www/dolibarr/htdocs/custom/infrasstudio
git fetch --tags
git checkout v1.9.0
```
##### **Étape 3 — Réactiver le module**
1. Configuration → Modules → InfraSStudio → cliquer sur **Activer**.
2. Le module exécute alors :
- la restauration des constantes `INFRASSTUDIOBKP_` vers `INFRASSTUDIO_`,
- l'application des migrations SQL nécessaires (fichiers `sql/update_X.Y.Z_*.sql`),
- le réenregistrement des hooks et triggers,
- la mise à jour de la constante `INFRASSTUDIO_MAIN_VERSION`.
##### **Étape 4 — Vérifier avec la page Diagnostic**
***Outils → InfraSStudio → Diagnostic***. L'ensemble des contrôles doit être au vert. La section Schéma SQL confirme en particulier que toutes les tables sont à jour.
##### **Étape 5 — Test fonctionnel**
Reproduisez trois actions courantes :
1. Ouvrir une page existante dans l'éditeur — l'aperçu doit se charger.
2. Modifier un slot — l'enregistrement automatique doit fonctionner (indicateur « Enregistré »).
3. Publier les modifications — vérifier que la version publique reflète bien la modification.
### Lire le changelog avant chaque mise à jour
Le changelog est accessible :
- Dans le module : `htdocs/custom/infrasstudio/docs/changelog.xml`.
- Dans l'administration : Outils → InfraSStudio → onglet Changelog.
##### **Lire les types de changement**
| Type
| Signification
|
|---|
| `fix`
| Correction d'une anomalie.
|
| `chg`
| Modification d'un comportement existant.
|
| `add`
| Nouvelle fonctionnalité ou option.
|
##### **Numérotation X.Y.Z**
| Composant
| Cas de modification
|
|---|
| **X (majeur)**
| La version Dolibarr minimale prise en charge change.
|
| **Y (mineur)**
| Une nouvelle fonctionnalité ou option utilisateur est ajoutée.
|
| **Z (correctif)**
| Corrections et modifications internes uniquement.
|
### Fréquence des mises à jour
Recommandations :
- **Correctif (Z)** : à appliquer rapidement, surtout si l'anomalie corrigée vous concerne.
- **Mineur (Y)** : à appliquer dans les une à deux semaines, après lecture du changelog.
- **Majeur (X)** : à tester en pré-production, à planifier dans une fenêtre de maintenance, à communiquer à votre équipe.
### Retour en arrière
Si une mise à jour pose problème :
1. Désactivez le module.
2. Restaurez le dossier `infrasstudio.old./` sauvegardé à l'étape 2.
3. Si une migration SQL a été appliquée, restaurez la base depuis le dump précédent.
4. Réactivez le module.
**Avertissement — Restauration SQL —** Une migration ajoute parfois des colonnes ou des tables. Si vous restaurez le dump pré-migration sans restaurer également les fichiers, le module détectera des structures manquantes et s'interrompra. Synchronisez toujours fichiers et base de données ensemble.
### Récapitulatif
**Vous savez désormais :**
- Préparer une mise à jour avec une liste de contrôle (sauvegarde base, fichiers, données).
- Suivre la procédure en cinq étapes (désactiver, remplacer, réactiver, diagnostic, test).
- Lire le changelog et comprendre la numérotation X.Y.Z.
- Appliquer la fréquence appropriée selon le type de version.
- Revenir en arrière en cas d'incident.
**Fin de la Partie V —** Vous savez gérer le module en tant qu'administrateur : permissions, configuration avancée, résolution des incidents, mises à jour. Le module est désormais entre des mains compétentes.
La Partie VI propose la référence pure du module : tableaux exhaustifs des constantes, des shortcodes, des hooks, des tables SQL et des scripts en ligne de commande. À garder à portée pour une consultation rapide.