Configuration

Après activation du module, la configuration est accessible via Accueil > Configuration > Modules/Applications, puis en cliquant sur l'icône d'engrenage à côté de DoliScubaDiving. La page de configuration est organisée en plusieurs onglets.

Réglages généraux

Fichier : admin/setup.php

Cet onglet regroupe les paramètres fondamentaux du module.

Mode de fonctionnement du club

Le paramètre Mode de fonctionnement du club détermine le fonctionnement global du module :

• Association (adhérents) : les plongeurs sont gérés via le module Adhérents de Dolibarr, avec cotisations annuelles. Ce mode active les fonctionnalités de secrétariat et de trésorerie.
• Commercial (contacts) : les clients sont gérés via les contacts des tiers Dolibarr. Ce mode est adapté aux centres de plongée professionnels.

Attention : ce paramètre influence l'ensemble du module. Choisissez-le avant de commencer à saisir des données.

Application mobile (PWA)

• Nom de l'application : nom affiché sous l'icône sur le bureau du téléphone. Si vide, le nom de la société Dolibarr est utilisé.
• Icône de l'application : image PNG ou JPG, minimum 512x512 pixels, format carré recommandé.

Création automatique de comptes utilisateurs

En mode association, le module peut créer automatiquement un compte utilisateur Dolibarr pour chaque adhérent. Paramètres associés :

• Créer automatiquement un compte utilisateur : active la création automatique.
• Statut du compte : actif ou désactivé par défaut.
• Mot de passe par défaut : mot de passe initial attribué (l'utilisateur devra le changer à la première connexion).

Utilisateur par défaut

L'utilisateur à affecter automatiquement aux actions anonymes est utilisé lorsqu'une action est créée sans utilisateur identifié (par exemple via la page publique de réservation).

Gestion des sorties

Fichier : admin/dives.php

• Point de rendez-vous par défaut : lieu pré-rempli lors de la création d'une nouvelle sortie (exemple : "Le local du club").
• Durée minimale d'une sortie bateau : intervalle minimum entre deux sorties utilisant le même bateau (en heures). Empêche les conflits de planification.

Gonflage

Fichier : admin/blockfill.php

Options de gonflage

• Activer les options nitrox : active le gonflage à l'air enrichi (oxygène).
• Activer les options trimix : active le gonflage hélium.
• Produit oxygène : sélectionnez le produit correspondant à l'oxygène dans votre base articles.
• Produit hélium : sélectionnez le produit correspondant à l'hélium.
• Service gonflage : service de manutention ajouté à chaque gonflage (frais fixes).

Pertes et stock

• Pourcentage de perte d'oxygène : pourcentage perdu lors de la manutention.
• Pourcentage de perte d'hélium : idem pour l'hélium.
• Pseudo gestion du stock : active un suivi spécifique du stock de gaz basé sur un calcul gonflage par gonflage (hors OF/BOM classiques).

Facturation

• Services packagés : si activé, le système cherche un produit dont la référence suit le format fill-volume-melange (exemple : fill-15-nx32 pour un bloc de 15 litres en nitrox 32). Si le produit existe, son prix est appliqué. Sinon, le service générique et le prix calculé sont utilisés.

Fiches de sécurité

Fichier : admin/securitysheet.php

Configuration des modèles PDF pour les fiches de sécurité. Trois modèles sont disponibles :

• Hippocampe : modèle avec palanquées détaillées
• Raie : modèle alternatif
• Standard : modèle par défaut

Réservation et planning

Fichier : admin/booking.php

Organisation du planning

• Clé principale d'organisation : choisissez entre "Articles de votre base article" (adapté si votre centre est centré sur des formations) ou "Spots de plongées" (si le lieu de plongée est la clé d'organisation).
• Nom du site inclus dans l'article : si coché, le site de plongée est inclus dans l'intitulé de l'article. Sinon, un champ complémentaire apparaît sur l'agenda.
• Nombre de places par créneau : si activé, vous spécifiez manuellement le nombre de places pour chaque créneau. Sinon, la capacité de la ressource principale (bateau, salle) est utilisée.

Catégories de ressources

• Catégorie bateaux : catégorie d'utilisateurs représentant les bateaux sur le planning.
• Catégorie salles de cours : idem pour les salles de classe.
• Catégorie restaurant : idem pour la restauration.
• Catégorie hébergement : idem pour l'hébergement.
• Catégorie inscriptions génériques : pour les créneaux sans ressource spécifique.
• Catégorie encadrants : pour lister les encadrants disponibles.

Pré-réservation

• Produit de pré-réservation : produit utilisé pour les commandes et factures de pré-réservation.
• Catégorie d'articles réservables : tag des articles proposés sur le planning de réservation.
• Mail de pré-réservation : modèle d'email envoyé au client lors de la pré-réservation.
• Mail de validation : modèle d'email envoyé après validation du paiement.
• Adresse expéditeur : adresse email utilisée pour l'envoi des emails de pré-réservation.
• Message PDF début/fin : textes ajoutés au document PDF de pré-réservation envoyé au client.

Page publique de réservation

• Activer la page publique : vos clients peuvent réserver en ligne.
• Titre et message : titre et message d'accueil de la page publique.
• Numéro de téléphone : numéro affiché pour les demandes de réservation.

Planning horaire

Fichier : admin/planning.php

Définit les créneaux horaires du planning d'inscriptions :

• Heure de début de journée : début du planning matin (exemple : 8).
• Décalage matin : durée en minutes du décalage pour les départs décalés (exemple : 30).
• Heure de fin de matinée : fin du planning matin (exemple : 12).
• Heure de début d'après-midi : début du planning après-midi (exemple : 14).
• Décalage après-midi : idem pour l'après-midi.
• Heure de fin d'après-midi : fin du planning (exemple : 18).
• Unité de découpage : durée d'un créneau en heures (exemple : 2).

Ressources

Fichier : admin/resources.php

Configuration des catégories de ressources utilisées par le module pour identifier les bateaux, salles et autres éléments de planning.

Météo

Fichier : admin/weather.php

Configuration API

• Clé API OpenWeatherMap : obtenez une clé gratuite sur openweathermap.org.
• Clé API Stormglass (optionnel) : pour des données marines enrichies.
• Coordonnées GPS par défaut : latitude et longitude utilisées pour les prévisions météo.

Seuils d'alerte

Définissez les seuils de vigilance et de danger pour chaque indicateur :

• Bloquer les départs en cas de danger : si activé, les départs sont bloqués quand les conditions météo dépassent les seuils de danger.

Planification des appels API

• Heure de début / fin : plage horaire pendant laquelle les appels API sont autorisés. En dehors, seul le cache est utilisé. Permet d'optimiser le quota API Stormglass.

Check-lists

Fichier : admin/checklist.php

Configurez les items de check-list de sécurité avant départ. Chaque item possède :

• Libellé et description
• Type : bateau ou générique
• Obligatoire : si oui, la check-list ne peut pas être validée sans cet item
• Ordre : position d'affichage
• Actif : permet de désactiver un item sans le supprimer

Actualités

Fichier : admin/news.php

Paramètres de publication des actualités du club, visibles depuis l'application mobile.

Sites de plongée

Fichier : admin/divingspots.php

Dictionnaire des sites de plongée avec code, libellé et aptitude minimale requise. Ces sites sont utilisés lors de la création des sorties et sur les fiches de sécurité.

Qualifications

Fichier : admin/qualifications.php

Dictionnaire des types de qualification, organisés par catégorie :

Champs étendus (extrafields)

Fichier : admin/extrafields.php

Ajoutez des champs personnalisés aux différentes entités du module : sorties, gonflages, pré-réservations, bateaux, formations, etc.

Modèles d'email

Fichier : admin/email_templates.php

Configurez les modèles d'email utilisés par le module pour les communications automatiques (pré-réservation, validation, rappels).

Rappels automatiques

Fichier : admin/reminders.php

Configuration des rappels automatiques envoyés aux plongeurs et au personnel (certificats médicaux expirant, sorties à venir, etc.).

Rôles

Fichier : admin/roles.php

Correspondance entre les rôles fonctionnels du club (directeur de plongée, pilote, encadrant, secrétaire, trésorier) et les groupes d'utilisateurs Dolibarr.

Droits et permissions

Fichier : admin/rights.php

Matrice des permissions par groupe d'utilisateurs. Les permissions sont organisées par domaine fonctionnel :

• Sorties (lecture, écriture, suppression)
• Fiches de sécurité (lecture, écriture)
• Réservations (lecture, écriture, suppression)
• Formations (lecture, écriture, suppression)
• Bateaux et journal de bord (lecture, écriture, suppression)
• Salles (lecture, écriture, suppression)
• Gonflage (lecture, écriture, suppression, nitrox, oxygène pur)
• Équipement (lecture, écriture, suppression)
• Documents (lecture, écriture, suppression, validation)
• Adhérents (lecture, écriture, création)
• Communication (lecture, envoi)
• Check-lists (lecture, écriture)
• Documents du club (lecture, écriture)
• Trésorerie (lecture, écriture, mouvements bancaires)
• Actualités (lecture, écriture, suppression)
• Secrétariat (lecture, écriture, validation)
• Cotisations (lecture, création, paiement)
• Profils membres (lecture, écriture, suppression)
• Sondages (lecture, écriture, suppression)

Annuaire

Fichier : admin/directory.php

Configuration de l'annuaire des membres accessible depuis l'application mobile.

Options de paiement

Fichier : admin/payment_options.php

Dictionnaire des options de paiement en plusieurs fois (nombre d'échéances, intervalle en jours).

Produits de cotisation

Fichier : admin/subscription_products.php

En mode association, configurez les catégories de produits utilisés pour les cotisations :

• Cotisation
• Licence
• Assurance
• Droit d'entrée
• Suppléments

Bannière d'export

Fichier : admin/exports.php

Configurez l'image de bannière utilisée en en-tête des exports Excel générés par le module.

Référentiels de compétences

Fichier : admin/skill_frameworks.php

Configuration des référentiels de compétences utilisés pour les formations.

Dictionnaires

Le module ajoute quatre dictionnaires accessibles via Accueil > Configuration > Dictionnaires :