View source for Module Gestion-camping-dolibarr

[[Category:Modules complémentaires]]

== DoliCamping — Logiciel de gestion de camping et d'hôtellerie de plein air ==

'''Transformez Dolibarr en logiciel de gestion complet (PMS) pour campings et hôtellerie de plein air : réservations au comptoir et en ligne, plan interactif, emplacements, saisons et tarifs, taxe de séjour, facturation native et Factur-X, état des lieux, bar et restaurant (caisse TakePOS), piscine, cours de natation, terrain et personnel.'''

=== Présentation ===
DoliCamping est un module Dolibarr (éditeur KSIDol.io) qui transforme l'ERP en PMS complet pour campings, villages vacances, aires naturelles, aires de camping-car, parcs résidentiels de loisirs et hôtellerie de plein air (HPA). Il centralise dans un seul outil la réservation, la tarification, la facturation, le terrain, les loisirs et le personnel, en s'appuyant à 100 % sur le natif Dolibarr (tiers, produits, devis, factures, agenda, caisse TakePOS). Rien n'est isolé : tout reste exploitable par le reste de l'ERP et de la comptabilité.

{| class="wikitable"
! Information !! Valeur
|-
| Éditeur || KSIDol.io (copyright KSI 30)
|-
| Numéro de module || 493176
|-
| Version || 1.0.0
|-
| Compatibilité Dolibarr || 18.0 à 24.x
|-
| PHP || 7.4+ (compatible 7.1 à 8.3)
|-
| Licence || GPLv3
|-
| Langues || fr_FR, en_US, de_DE, es_ES, it_IT
|-
| Famille || CRM / Tourisme
|}

=== Liens officiels ===
* Boutique : https://ksidol.io
* Fiche du module : https://www.ksidol.io/fr/modules/detail?module=main_module_dolicamping
* Présentation : https://www.ksidol.io/fr/dolicamping
* Vidéo de démonstration : https://youtu.be/SIz6Vl6Zw5I
* Démo en ligne : https://www.ksidol.io/t/demo-camping/ (identifiant : Login, mot de passe : DEMO)

=== Objectif ===
Gérer l'ensemble de l'activité d'un camping dans Dolibarr, sans logiciel de réservation externe : configuration des emplacements, types d'hébergement, saisons, tarifs, options et taxe de séjour ; prise de réservation au comptoir ou en ligne générant un séjour, un devis puis les factures ; état des lieux d'entrée et de sortie ; exploitation du terrain (ménage, incidents, interventions, compteurs) ; loisirs (bar, restaurant, piscine, cours de natation) ; personnel et conformité réglementaire (HPA).

=== Installation ===
# Décompressez l'archive pour obtenir un dossier <code>dolicamping/</code>.
# Copiez-le dans <code>htdocs/custom/</code> de votre Dolibarr.
# Vérifiez les droits d'écriture sur le dossier de données Dolibarr (le module y publie l'image du plan et les documents générés).
# Activez le module depuis Accueil → Configuration → Modules/Applications.
# Affectez les droits utilisateurs et parcourez la configuration (profil d'établissement, saisons, taxe de séjour, options, plan).

=== Mise à jour ===
Remplacez le dossier <code>dolicamping/</code> par la nouvelle version puis rechargez la liste des modules. À l'activation, le module met à jour son schéma de base et ses données par défaut de façon non bloquante (les erreurs éventuelles sont journalisées sans empêcher le chargement).

=== Droits ===
* Consulter le camping (réservations, séjours, planning)
* Gérer les réservations et les séjours (write)
* Réaliser les états des lieux (checkinout)
* Gérer le terrain (ménage, incidents, interventions, personnel — staff)
* Suivre la conformité (compliance)
* Configurer le module (config)

=== Menus ===
Un menu principal « Camping » donne accès à trois sections : '''Réservations''' (Tableau de bord, Planning, Séjours, Nouvelle réservation, Arrivées / Départs, Plan, Emplacements, Séjours résidentiels) ; '''Terrain''' (Ménage, Incidents, Interventions, Personnel, Compteurs / relevés, Planning du personnel, Pointage, Fiches de police, Conformité) ; '''Loisirs & Services''' (Bar, Surveillance piscine, Cours de natation, Habilitations du personnel, Restaurant). Le paramétrage regroupe : types d'hébergement, saisons & tarifs, options, taxe de séjour, éléments d'état des lieux, channel manager et configuration.

=== Périmètre fonctionnel détaillé ===
* '''Moteur de réservation au comptoir''' : recherche de disponibilité en trois étapes (critères, disponibilité, réservation), composition (adultes, enfants, bébés), options et frais annexes calculés en temps réel, contrôle anti-double-réservation et verrou temporaire (hold) pendant la saisie.
* '''Réservation en ligne''' : tunnel public optionnel permettant au vacancier de réserver sans compte Dolibarr, avec vérification d'identité par code OTP (double opt-in RGPD), anti-bruteforce et anti-mailbombing ; création automatique d'un tiers particulier.
* '''Plan interactif''' : représentation du camping à l'écran, chaque emplacement positionné avec son statut en temps réel (libre, en option, occupé, à nettoyer) et les espaces communs ; éditeur de plan intégré ; technologie 100 % locale, sans CDN.
* '''Emplacements, saisons, tarifs, options''' : emplacements et types d'hébergement (tente, caravane, camping-car, mobil-home, chalet, lodge…) adossés aux produits Dolibarr ; saisons ; grille tarifaire multi-critères ; options (kits, ménage, animal, électricité, personne supplémentaire, visiteur…) et frais annexes.
* '''Taxe de séjour''' : barème communal paramétrable par catégorie et régime, calcul automatique nuit par nuit et par occupant, report sur la facturation et état à reverser.
* '''Facturation native''' : devis (proposition commerciale), facture d'acompte (arrhes) puis facture de solde qui déduit l'acompte ; TVA par nature de prestation ; refacturation de la consommation relevée pour le résidentiel.
* '''Facture électronique 2026''' : tout ce qui est facturable est un produit ou service natif Dolibarr (emplacements, options, frais), prêt pour l'émission de factures Factur-X vers une plateforme (PDP / PPF), sans développement spécifique.
* '''État des lieux''' : entrée et sortie par séjour, sur tablette ou téléphone (écran responsive), avec équipements remis, relevés de compteurs, retenues, signature et PDF filigrané ; la sortie reprend automatiquement l'entrée poste par poste (seul le premier état des lieux est long).
* '''Terrain''' : ménage avec attribution automatique des tâches au départ, incidents, interventions techniques (avec carte de choix du lieu, création depuis un incident), espaces communs, compteurs et relevés, résidentiel avec sous-comptage (refacturation eau / électricité).
* '''Personnel et GRH''' : le personnel repose sur les utilisateurs Dolibarr natifs, avec catégories de rôles, planning du personnel, pointage, habilitations et plannings de service.
* '''Bar et restaurant''' : point de vente via la caisse enregistreuse native de Dolibarr (TakePOS), produits dédiés et TVA adaptée, réservation de table, restriction du personnel habilité.
* '''Piscine et cours de natation''' : surveillance des baignades (registre chlore, pH, température, fréquentation) selon le Code du sport, cours de natation en option (créneaux, capacité, inscriptions, facturation native).
* '''Conformité et fiche de police''' : registre des obligations réglementaires (HPA) avec statut dérivé (conforme, à échéance, dépassé, à faire) et échéances à moins de 30 jours ; fiche de police (déclaration des voyageurs).
* '''Channel manager''' : synchronisation des disponibilités avec les plateformes de réservation (OTA), import iCal, export protégé par jeton et import protégé contre les attaques SSRF.
* '''Tableau de bord''' : arrivées et départs du jour (y compris les rotations le même jour sur un même emplacement), occupation, emplacements libres, réservations à confirmer, ménage, incidents ouverts, taxe à reverser, obligations à échéance, et recherche rapide transversale.

=== Pages de configuration ===
Depuis la configuration du module : profil d'établissement (municipal, familial, chaîne, aire naturelle, aire de camping-car, PRL…), général, frais annexes, conformité, page publique, plan, ménage, produits, sous-comptage (tarifs de refacturation), saisons, grille tarifaire, options, taxe de séjour, éléments d'état des lieux, bar / restaurant / piscine, et channel manager.

=== Facturation et taxe de séjour ===
Toute la chaîne commerciale est native Dolibarr, pilotée depuis la fiche du séjour : génération du devis, facture d'acompte à la validation ou à la signature, puis facture de solde au départ. La taxe de séjour est calculée nuit par nuit et par occupant selon le barème communal, reportée sur la facturation et suivie via un état à reverser. Le module est conçu pour répondre à la réforme française de la facture électronique (à compter du 1er septembre 2026) sans développement spécifique.

=== Notes techniques ===
* 100 % basé sur le natif Dolibarr (tiers, produits, propositions, commandes, factures, agenda, catégories, TakePOS), sans modification du cœur.
* Compatible Dolibarr v18 à v24 et PHP 7.1 à 8.3 ; fonctionnement local, sans aucun CDN.
* Rôles et droits fins, multi-entités, modèles PDF personnalisables (séjour, état des lieux, ménage).
* Le plan interactif s'appuie sur une image du camping publiée dans le dossier de données Dolibarr et servie via viewimage.php.
* Export iCal protégé par jeton, import iCal protégé contre les attaques SSRF ; anti-bruteforce et double opt-in sur la réservation en ligne.

=== Flux type ===
# Configurer le camping : profil, emplacements et types d'hébergement, saisons, tarifs, options, taxe de séjour et plan.
# Prendre une réservation au comptoir (ou laisser un client réserver en ligne) → création du séjour, du devis et de l'acompte.
# Réaliser l'état des lieux d'entrée à l'arrivée.
# Suivre le séjour, le ménage, les incidents et les loisirs depuis le tableau de bord et le planning.
# Réaliser l'état des lieux de sortie au départ, puis la facture de solde qui déduit l'acompte et intègre la taxe de séjour.

=== Dépannage ===
* '''Le plan n'affiche pas l'image''' : vérifiez les droits d'écriture sur le dossier de données Dolibarr et la présence de l'image du plan dans <code>documents/dolicamping/maps/</code>.
* '''Taxe de séjour à 0''' : vérifiez que le barème de la collectivité est renseigné pour l'exercice courant dans le paramétrage.
* '''Bar / restaurant non visibles''' : ces blocs sont activés depuis la configuration du module (profil d'établissement / réglages Loisirs & Services).

=== Support ===
* Boutique : https://ksidol.io
* Support : support@ksidol.io
* Vidéo : https://youtu.be/SIz6Vl6Zw5I
* Produit transverse : Terminal de signature KSIDol (signature des fiches et documents natifs de Dolibarr, compatible avec tous les modules KSIDol).