Skip to content

benevole.futureTraitement – Documentation

Définition

Champ booléen sur l'entité Benevole (colonne future_traitement en base, valeur par défaut false).

À quoi ça sert ?

futureTraitement permet de marquer qu'un bénévole inscrit via un lien personnalisé doit être assigné au suivi admin (« En cours ») plutôt que rester « Autonome » lorsqu'il devient APTE. C'est un signal pour les admins qui utilisent ce lien pour « réserver » des bénévoles à leur traitement.

Flux complet

1. Paramètre URL

Un admin envoie un lien d'inscription avec ?traitement=xxx (ex. /inscription/benevole?traitement=1).

2. Stockage dans localStorage

Le middleware front/middleware/queryparams.js enregistre ce paramètre dans localStorage pour 24h : - traitement - traitement_expires

3. Inscription

Sur la page d'inscription (front/pages/inscription/benevole/index.vue), dans loadDefaultValues() : - Si traitement est présent dans localStorage et non expiré → this.benevole.futureTraitement = true - Cette valeur est envoyée à l'API lors de la création du bénévole

4. Quand le bénévole devient APTE

Dans validateFormation() (back/src/binomes/services/benevoles.service.ts) :

if (benevoleInstance.status === 'EN_ATTENTE_FORMATION') {
  benevoleInstance.status = 'APTE';
  benevoleInstance.statusUpdateDate = new Date();

  if (benevoleInstance.futureTraitement) {
    benevoleInstance.state = 'En cours'
    benevoleInstance.futureTraitement = false
  }
  // ...
}
  • Si futureTraitement est true : le bénévole passe en state = 'En cours' et futureTraitement est remis à false
  • Sinon : il reste en state = 'Autonome' (valeur par défaut)

Différence entre les états

  • Autonome : bénévole sans suivi admin particulier
  • En cours : bénévole en cours de suivi par un admin

Cas d'usage

Un admin qui veut suivre les bénévoles qu'il a recrutés via un lien personnalisé peut utiliser ?traitement=xxx. Ces bénévoles seront automatiquement marqués « En cours » à la validation de leur formation, pour apparaître dans les listes de suivi admin.

Fichiers concernés

Fichier Rôle
back/src/binomes/entities/Benevole.entity.ts Définition du champ
front/middleware/queryparams.js Stockage du paramètre URL dans localStorage
front/pages/inscription/benevole/index.vue Lecture du localStorage et futureTraitement = true
back/src/binomes/services/benevoles.service.ts Logique dans validateFormation()