Installation

Téléchargement

Téléchargez le module depuis le DoliStore ou depuis votre espace client CAP-REL.

Installation du module

1. Connectez-vous en tant qu'administrateur Dolibarr
2. Allez dans Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe
3. Téléversez l'archive zip du module
4. Dolibarr extrait et installe automatiquement le module

Prérequis

Avant d'activer SmartInterventions, vérifiez que les modules Dolibarr suivants sont activés :

Attention : le module SmartAuth est indispensable pour l'authentification des techniciens sur l'application smartphone. Il doit être installé et activé avant SmartInterventions.

Activation

1. Connectez-vous en tant qu'administrateur Dolibarr
2. Allez dans Accueil > Configuration > Modules/Applications
3. Recherchez "SmartInterventions" dans la liste
4. Cliquez sur le bouton d'activation

À l'activation, le module :

• Crée les tables nécessaires en base de données (statuts, schémas, profils)
• Crée la table satellite des données métier de l'intervention (date prévue, durée planifiée, envoi automatique au client, type d'intervention, type d'événement, urgence, adresse, état avancé) : ce sont des colonnes natives de cette table, plus des extrafields (les 8 anciens extrafields d'intervention sont migrés vers ces colonnes à l'activation)
• Ajoute les champs photo extensibles (smartphoto_*) sur les fiches d'intervention
• Génère une clé JWT pour l'authentification de l'application smartphone

Hôte virtuel ou proxy dédié (obligatoire)

Pour des raisons de sécurité et de bon fonctionnement de l'application smartphone, l'application doit être accessible à la racine d'un sous-domaine dédié. Deux solutions au choix, l'une ou l'autre étant impérative :

• un hôte virtuel dédié sur votre serveur web (voir l'exemple ci-dessous) ;
• un proxy dédié, par exemple le service DoliProxy proposé par CAP-REL.

Dans les deux cas, l'application est servie à la racine d'un sous-domaine (par exemple https://interventions.votre-domaine.fr/) et non dans un sous-répertoire. Une fois le sous-domaine en place, renseignez son adresse dans l'onglet Généralités de la configuration du module.

<VirtualHost *:443>
    ServerName interventions.votre-domaine.fr
    DocumentRoot /var/www/dolibarr/htdocs/custom/smartinterventions/pwa

    <Directory /var/www/dolibarr/htdocs/custom/smartinterventions/pwa>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

Taille maximale des fichiers uploadés

L'application smartphone envoie des photos et des signatures depuis le terrain. Si la taille maximale d'upload autorisée par votre serveur est trop basse, ces envois peuvent échouer (photo qui ne remonte pas, signature non enregistrée), en particulier pour les photos haute résolution ou lorsque plusieurs photos sont jointes à une même intervention.

Cette limite est fixée par la configuration de PHP (upload_max_filesize, post_max_size) et parfois du serveur web (Apache, Nginx), pas par le module lui-même. Le réglage est commun à tous les modules et à Dolibarr dans son ensemble.

La procédure détaillée pour augmenter cette limite est mutualisée ici : Augmenter la taille maximale des fichiers.

Mise à jour

1. Téléversez la nouvelle version via Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe
2. Désactivez puis réactivez le module pour appliquer les mises à jour de base de données et enregistrer les nouveaux hooks et permissions

Désinstallation

Désactivez le module depuis Accueil > Configuration > Modules/Applications. Les données créées par le module (table satellite des interventions, tables de schémas) sont conservées en base de données.