Documentation Technique

Guide complet d'installation, configuration et utilisation de DoliVet

Installation Configuration Workflows API FAQ Support
Sommaire

Installation

Téléchargement

Téléchargez la dernière version de DoliVet depuis notre dépôt GitHub :

git clone https://github.com/gigarun/dolivet.git

Ou téléchargez directement l'archive ZIP :

Bientôt disponible sur Dolistore

Installation des Fichiers

  1. Décompressez l'archive DoliVet
  2. Copiez le dossier cabinetvet dans /custom/ de votre installation Dolibarr
  3. Vérifiez les permissions : chmod -R 755 /custom/cabinetvet
  4. Connectez-vous à Dolibarr en tant qu'administrateur
  5. Allez dans Accueil → Configuration → Modules/Applications
  6. Recherchez "Cabinet Vétérinaire" et cliquez sur Activer
  7. Les tables de base de données seront créées automatiquement (36+ tables)
Astuce : L'installation crée automatiquement les dictionnaires métier (espèces, races, types vaccins, actes vétérinaires).

Prérequis Système

Serveur
  • PHP 7.4+ ou 8.0+
  • MySQL 5.7+ ou MariaDB 10.3+
  • Apache 2.4+ ou Nginx
  • Extensions PHP : mysqli, gd, curl, mbstring
Dolibarr
  • Dolibarr 19.0+
  • Modules natifs : Tiers, Produits, Factures
  • Module WebPortal (optionnel)
  • Module Agenda pour rendez-vous
Important : DoliVet nécessite les modules natifs Tiers et Produits activés pour fonctionner correctement.

Configuration Initiale

Accédez à Accueil → Configuration → Dictionnaires → Cabinet Vétérinaire

  • Espèces animales : Chien, Chat, NAC (pré-rempli)
  • Races : 50+ races par espèce (modifiable)
  • Types de vaccins : Primovaccination, Rappel annuel, etc.
  • Actes vétérinaires : 35+ actes avec tarifs conseillés
  • Motifs consultation : Visite annuelle, Urgence, Vaccination, etc.
Vous pouvez personnaliser ces dictionnaires selon votre pratique.

Configuration des emails automatiques via Accueil → Configuration → Emails → Templates

Template Usage Variables disponibles
(AnimVaccAlert) Alertes vaccination J-14/J-7/J-3 __ANIMAL_NAME__, __VACCINE_TYPE__, __DUE_DATE__
(AnimRdvConfirm) Confirmation rendez-vous __ANIMAL_NAME__, __RDV_DATE__, __RDV_TIME__
(AnimConsultReport) Envoi compte-rendu consultation __ANIMAL_NAME__, __CONSULT_DATE__, __VETERINARIAN__
Les templates utilisent le système natif Dolibarr (llx_c_email_templates).

Configurez les permissions par profil dans Accueil → Configuration → Utilisateurs & Groupes

Permissions Animaux :
  • $user->hasRight('cabinetvet','animal','lire') - Lecture animaux
  • $user->hasRight('cabinetvet','animal','creer') - Création animaux
  • $user->hasRight('cabinetvet','animal','supprimer') - Suppression animaux
Permissions Consultations :
  • $user->hasRight('cabinetvet','consultation','lire') - Lecture consultations
  • $user->hasRight('cabinetvet','consultation','creer') - Création consultations
  • $user->hasRight('cabinetvet','consultation','valider') - Validation consultations
  • $user->hasRight('cabinetvet','consultation','facturer') - Facturation consultations

  1. Activez le module WebPortal de Dolibarr
  2. Dans Configuration → WebPortal, ajoutez le contexte "cabinetvet"
  3. Les propriétaires accèdent via https://votredomaine.com/public/webportal/
  4. Fonctionnalités disponibles :
    • Consultation dossiers médicaux animaux
    • Historique consultations et vaccinations
    • Gestion rendez-vous (consultation/annulation)
    • Téléchargement factures
Traçabilité RGPD complète : tous les accès sont enregistrés dans llx_cabinetvet_portal_logs.

Workflows Métier

Workflow Consultation

1
Draft (Brouillon)

Création consultation, saisie anamnèse, examen clinique, ajout actes vétérinaires

2
Validated (Validée)

Verrouillage données médicales, consultation devient immutable

3
Billed (Facturée)

Génération automatique facture au propriétaire principal (link via fk_invoice)

4
Closed (Clôturée)

Consultation archivée, statistiques calculées

Conformité réglementaire : Le statut Validated verrouille les données médicales selon la législation vétérinaire.

Système Vaccination Intelligente

  1. Création plan automatique : Lors de la création d'un animal, un plan de vaccination est généré selon espèce/race
  2. Primovaccination : Vaccins initiaux programmés (ex: 8 semaines, 12 semaines)
  3. Rappels automatiques : Calcul automatique des rappels annuels/pluriannuels
  4. Alertes J-14/J-7/J-3 : Emails automatiques aux propriétaires avec fichiers ICS
  5. Intégration calendrier : Fichiers .ics RFC 5545 compatibles Google/Outlook/Apple
// Exemple plan vaccination chien
Primovaccination (8 semaines) : CHPL (Carré, Hépatite, Parvo, Lepto)
Rappel 1 (12 semaines) : CHPL + Rage
Rappel annuel : CHPL + Rage (tous les ans)
Alerte J-14 : Email + ICS → Propriétaire
Alerte J-7 : Email rappel
Alerte J-3 : Email dernière relance

Système Multi-Propriétaires

Architecture : Relation N:N entre Animaux et Tiers via llx_cabinetvet_animal_owner

  • Propriétaire principal : Marqué avec is_principal=1, reçoit factures et correspondances
  • Propriétaires secondaires : Accès lecture aux dossiers médicaux via portail
  • Switch principal : Changement propriétaire principal en 1 clic (mise à jour automatique des liens)
  • Facturation intelligente : Génération automatique au propriétaire principal lors du passage Consultation à "Billed"
Cas d'usage : Familles, Copropriétés d'animaux, Transferts de propriété sans perte d'historique.

API & Intégrations

API REST Dolibarr

DoliVet expose ses entités via l'API REST native Dolibarr :

GET /api/index.php/cabinetvet/animals
POST /api/index.php/cabinetvet/animals
PUT /api/index.php/cabinetvet/animals/{id}
DELETE /api/index.php/cabinetvet/animals/{id}

GET /api/index.php/cabinetvet/consultations
POST /api/index.php/cabinetvet/consultations/{id}/validate

Authentification : DOLAPIKEY dans header HTTP

Hooks Disponibles
Hook Déclenchement Usage
animalAfterCreate Après création animal Génération plan vaccination, notifications
consultationValidate Validation consultation Verrouillage données, envoi compte-rendu
vaccinationAlert J-14/J-7/J-3 avant échéance Envoi emails + ICS propriétaire

Gestion des Permissions

Permission Code Profil suggéré
Lecture animaux cabinetvet.animal.lire Tous
Création animaux cabinetvet.animal.creer Secrétaires, Vétérinaires
Suppression animaux cabinetvet.animal.supprimer Administrateurs uniquement
Validation consultations cabinetvet.consultation.valider Vétérinaires uniquement
Facturation consultations cabinetvet.consultation.facturer Comptables, Vétérinaires
Gestion expertises cabinetvet.expertise.creer Experts vétérinaires

Questions Fréquentes

Oui, DoliVet nécessite Dolibarr 19.0+ et s'intègre parfaitement avec vos modules existants (Tiers, Produits, Factures, Agenda). L'installation ne modifie aucune table native Dolibarr.

Absolument. Les 35+ actes pré-configurés sont entièrement personnalisables via Configuration → Dictionnaires → Actes Vétérinaires. Vous pouvez ajouter vos propres actes avec tarifs spécifiques.

Chaque animal peut avoir N propriétaires (ex: famille). Un propriétaire est marqué "principal" et reçoit automatiquement les factures. Vous pouvez changer le principal en 1 clic sans perdre l'historique. Tous les propriétaires ont accès au dossier médical via le portail client.

Oui. Le système envoie automatiquement des emails à J-14, J-7 et J-3 avant l'échéance de vaccination. Chaque email contient un fichier ICS pour ajout automatique au calendrier du propriétaire (compatible Google/Outlook/Apple). Configuration via cron Dolibarr.

Oui. Le portail utilise le système d'authentification Dolibarr WebPortal. Tous les accès sont tracés dans llx_cabinetvet_portal_logs (qui, quand, quelle donnée). Les propriétaires ne voient QUE les animaux dont ils sont propriétaires. Connexion HTTPS obligatoire.

Oui, via l'API REST ou import CSV. Nous fournissons des scripts d'exemple pour migrer depuis des formats courants (Excel, Access). Contactez le support pour assistance migration personnalisée.

Support & Ressources

GitHub

Code source, issues, pull requests

github.com/gigarun/dolivet
Wiki

Documentation détaillée, tutoriels, vidéos

wiki.dolivet.org
Forum

Communauté utilisateurs, entraide

forum.dolivet.org
Email

Support technique personnalisé

support@dolivet.org
Formation Professionnelle

Nous proposons des formations sur-mesure pour votre équipe (installation, workflows, personnalisation). Tarifs dégressifs selon nombre de participants.

Demander un Devis Formation

Prêt à installer DoliVet ?

Bientôt disponible sur Dolistore Tester la Démo Demander Support