Module Adhérents

Le module Adhérents d'HtkDoli vous permet de consulter et gérer les membres de votre organisation (associations, fondations, structures coopératives). Il couvre l'identité, les coordonnées, l'adhésion en cours et l'historique des cotisations versées.

Interface et Fonctionnalités (Liste)

La vue principale affiche la liste de tous vos adhérents.

Consultation et Recherche

Barre de recherche : Recherche par nom complet (prénom + nom), email ou téléphone.
Tri :
- Date (Récents → Anciens)
- Date (Anciens → Récents)
- Nom (A-Z)
- Nom (Z-A)
Filtres par statut d'adhésion, avec compteur affiché :
- Tous
- Brouillon (statut 0)
- Sans cotisation (statut 1 mais sans date de fin)
- À jour (statut 1 et date de fin de cotisation à venir)
- Expirée (statut 1 mais date de fin dépassée)
- Résilié / Exclu (statut -1)
Filtre par type d'adhérent : si des types d'adhérents sont synchronisés, un sous-menu « Type » permet de filtrer par catégorie, avec compteur.

⚠️ La recherche, les tris et les filtres s'appliquent aux adhérents déjà chargés localement. Au-delà de la première page, pensez à charger plus d'adhérents pour les inclure.

Informations affichées (Cartes Adhérent)

Chaque ligne représente un adhérent avec :

Son nom complet (prénom + nom, ou le login si les deux sont vides).
Sa référence Dolibarr (badge).
Un badge de cotisation (affiché uniquement si l'adhérent est validé) : « À jour JJ/MM/AA », « Exp. JJ/MM/AA » ou « Sans cotisation ».
Sa société (si applicable).
Sa ville et son email.
Ses téléphones (fixe / mobile).
Sa photo ou ses initiales, avec une pastille de statut colorée en surimpression (Brouillon, À jour, Expirée, Résilié).

Index alphabétique

Lorsque le tri est par nom, la liste est groupée par lettre. Une bulle d'index apparaît pendant le défilement pour indiquer la lettre courante.

Pagination

Liste paginée par lots de 50, avec bouton « Charger plus ».
Pull-to-refresh (tirer pour rafraîchir) disponible.
Un indicateur de fraîcheur dans l'en-tête signale quand la liste devient « obsolète » (au-delà d'une minute) et propose un rafraîchissement manuel.

Un appui long sur une carte adhérent ouvre un menu d'actions rapides :

Appeler (téléphone fixe) / Appeler mobile.
Nouveau mail (si email renseigné).
Nouveau message (SMS vers le mobile ou le fixe).
Itinéraire (ouvre Plans avec l'adresse).
Renouveler la cotisation (ouvre l'écran d'ajout de cotisation).
Créer un ticket (pré-remplit le tiers lié si présent).
Modifier la fiche.
Partager (VCard) : exporte le contact au format .vcf.
Supprimer.

Un glissement vers la gauche propose la suppression ; un glissement vers la droite propose la modification.

Vue Détail (Consultation d'un adhérent)

En-tête (Hero Section)

Photo de l'adhérent (ou initiales).
Nom complet.
Société (si renseignée).
Badge de statut.

Identité

Civilité
Prénom / Nom
Société (si l'adhérent représente une organisation)
Nature (Physique / Morale)
Date de naissance (si renseignée)
Tiers lié (cliquable pour ouvrir la fiche tiers, si le tiers est chargé localement ; sinon l'ID du tiers est affiché)

Coordonnées

Email (lien d'envoi d'email)
Téléphone fixe (lien d'appel)
Mobile (lien d'appel)

Adresse

Adresse postale
Code postal et Ville
Département (valeur brute Dolibarr)
Pays (code pays)

Adhésion & Cotisations

Adhésion en cours :

Type d'adhérent (libellé résolu à partir des types synchronisés).
Date de début.
Date de fin de validité.

Historique des cotisations :

Liste de toutes les cotisations enregistrées pour l'adhérent (libellé, période du/au, montant, date d'enregistrement).
Bouton « + » pour ajouter une nouvelle cotisation (si vous avez le droit de création des adhérents).
Glissement vers la gauche ou menu contextuel pour supprimer une cotisation.

Documents

Consultation des documents liés à l'adhérent, aperçu et téléchargement, et ajout d'un document (carte de membre, photo, statuts, etc.). L'ajout est possible dès que l'adhérent existe côté Dolibarr.

Divers

Login utilisateur lié (le cas échéant).
Note publique.
Note privée.

Informations Système

ID Dolibarr
Référence
Date de création
Date de dernière modification

Actions

Envoyer un email (si email renseigné) : Ouvre une feuille de composition d'email avec l'adresse pré-remplie.
Renouveler la cotisation : Ouvre l'écran d'ajout de cotisation.

⚠️ La validation d'un adhérent ne se fait pas depuis l'application. POST /members/{id}/validate n'existe pas dans l'API de Dolibarr, en version 22 comme en 24. Le bouton affichait le nouveau statut puis le laissait revenir à la synchronisation suivante ; il a été retiré. Validez depuis l'interface web.

Résilier l'adhésion : Disponible si l'adhérent n'est pas déjà résilié. Passe l'adhérent au statut Résilié (boîte de confirmation ; l'action peut être annulée par une revalidation).

⚠️ La section « Actions » n'apparaît que si vous disposez du droit de création/modification des adhérents.

Modèles d'email

La feuille de composition d'email récupère automatiquement les modèles configurés dans Dolibarr (Configuration > Modèles de documents > Modèles d'email). Un menu déroulant "Modèle" apparaît en haut de la feuille lorsque des modèles sont disponibles : sélectionner une entrée pré-remplit l'objet et le corps du message à partir du modèle choisi. L'option "Aucun (saisie libre)" reste disponible si vous préférez tout rédiger manuellement. Les champs restent éditables après application d'un modèle, et le HTML éventuel du modèle est converti automatiquement en texte lisible.

Actions de l'en-tête flottant

Fiche Adhérent (PDF) : génère et affiche l'aperçu PDF de la fiche adhérent (un avertissement signale d'éventuelles modifications en attente d'envoi).
Modifier (si droits).
Supprimer via le menu « … » (boîte de confirmation ; supprime aussi les cotisations liées).

Création et modification

L'écran d'édition (MemberEditView) permet de renseigner :

Identité : Civilité (Monsieur / Madame), Genre (Homme / Femme / Autre), Nom (obligatoire), Prénom, Société, Nature (Physique / Morale), Date de naissance (optionnelle), Photo (nom de fichier).
Liaison Tiers : associer l'adhérent à un Tiers existant (optionnel), avec recherche, et possibilité d'effacer la liaison.
Coordonnées : Email, Téléphone fixe, Mobile.
Adresse : Rue, Code postal, Ville, Département (ID/Code), Code Pays (ex. FR).
Adhésion : Type d'adhérent (sélecteur si des types sont synchronisés, sinon saisie manuelle de l'ID), Date de début, Date de fin de validité.
Système & Divers : Login utilisateur lié (optionnel), Visibilité publique.
Notes : note publique et note privée.

Le Nom est le seul champ obligatoire pour enregistrer.

Comportement Métier et Dolibarr

Statuts (mappage Dolibarr)

0 → Brouillon (« Adhésion en brouillon »).
-1 → Résilié / Exclu si une date de validité a déjà existé (« Adhésion résilié ou exclu ») ; sinon traité comme Brouillon.
1 → Validé. L'état détaillé est calculé à partir de la date de fin de validité :
- Date de fin à venir → « Membre Actif (Cotisation à jour) ».
- Date de fin dépassée → « Membre Actif (Cotisation expirée le …) ».
- Aucune date de fin → « Membre Actif (Cotisation absente) ».

Cotisations

Les cotisations enregistrées pour les adhérents alimentent un historique consultable dans la fiche. Chaque cotisation comporte un libellé, une période (date de début / date de fin), un montant et une date d'enregistrement. La création d'une cotisation envoie la période et le montant à Dolibarr ; côté serveur, selon la configuration du module, elle peut générer une écriture comptable et un reçu fiscal.

Mode hors ligne (Offline-First)

La création d'un adhérent et l'ajout d'une cotisation fonctionnent même sans connexion : l'enregistrement est effectué localement et placé dans une file d'attente, puis synchronisé automatiquement avec Dolibarr au retour de la connexion.

Droits et Permissions

Lecture : l'accès au module suppose la permission de lecture des adhérents dans Dolibarr.
Création / Modification / Cotisations / Validation / Résiliation / Suppression : pilotées par la permission adherent.creer. Si vous ne disposez pas de ce droit, le bouton de création, le bouton d'ajout de cotisation et la section « Actions » de la fiche ne s'affichent pas.

Synchronisation

Liste paginée par lots de 50.
Les types d'adhérents sont rechargés lors d'un rafraîchissement complet.
Les cotisations et documents sont chargés à l'ouverture de la fiche.
La photo est récupérée depuis le serveur et mise en cache.

Captures d'écran

2 captures — cliquez pour agrandir