---
title: "Configuration"
weight: 20
description: "Paramétrage complet du module DoliScubaDiving : réglages généraux, sorties, gonflage, réservation, météo et plus."
---

# 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).

![Page de réglages généraux du module DoliScubaDiving](screenshots/configuration-setup.webp)

## 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.

![Configuration des sorties de plongée](screenshots/configuration-dives.webp)

## 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.

![Configuration du module de gonflage](screenshots/configuration-blockfill.webp)

## 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

![Configuration des fiches de sécurité](screenshots/configuration-securitysheet.webp)

## 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.

![Configuration des réservations et du planning](screenshots/configuration-booking.webp)

## 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).

![Configuration du planning horaire](screenshots/configuration-planning.webp)

## 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](https://openweathermap.org/api).
- **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 :

| Indicateur | Description |
|------------|-------------|
| Vitesse du vent | En km/h |
| Hauteur des vagues | En mètres |
| Visibilité | En mètres (seuil minimum) |
| Température minimale | En degrés Celsius |
| Précipitations | En mm/h |

- **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.

![Configuration de la météo et des seuils d'alerte](screenshots/configuration-weather.webp)

## 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

![Configuration des items de check-list](screenshots/configuration-checklist.webp)

## 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é.

![Dictionnaire des sites de plongée](screenshots/configuration-divingspots.webp)

## Qualifications

**Fichier :** `admin/qualifications.php`

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

| Catégorie | Exemples |
|-----------|----------|
| Niveau de plongée | N1 à N4, PE12 à PE20, PA20 à PA60, CMAS 1 à 3 |
| Encadrement | E1 à E4, MF1 à MF2, BEES1, DEJEPS |
| Secourisme | RIFAP, PSC1, SST, AFGSU |
| Technique | TiV, Nitrox, Trimix |
| Administratif | Permis bateau, Permis hauturier, CRR |

![Configuration des types de qualification](screenshots/configuration-qualifications.webp)

## 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.

![Configuration du mapping des rôles](screenshots/configuration-roles.webp)

## 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)

![Matrice des droits et permissions](screenshots/configuration-rights.webp)

## 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** :

| Dictionnaire | Description |
|-------------|-------------|
| Blocs (DivingTanks) | Types de blocs de plongée avec code, libellé et volume |
| Sites de plongée (DivingSpots) | Sites avec code, libellé et aptitude minimale |
| Types de sortie (DiveTypes) | Types de sortie (exploration, formation, technique, événement) |
| Options de paiement (PaymentOptions) | Modalités de paiement échelonné |