Initial commit

This commit is contained in:
Arnaud Delcasse 2025-10-14 17:27:46 +02:00
commit 3da3020858
6 changed files with 1583 additions and 0 deletions

161
README.md Normal file
View File

@ -0,0 +1,161 @@
# Documentation Produit - PARCOURSMOB
## Qu'est-ce que PARCOURSMOB ?
PARCOURSMOB est une plateforme de mobilité inclusive qui permet aux structures d'accompagnement social (centres sociaux, CCAS, associations, etc.) de faciliter l'accès à la mobilité de leurs bénéficiaires.
## Vision et objectif
PARCOURSMOB vise à réduire la fracture de mobilité en offrant une solution complète de gestion de dispositifs de mobilité solidaire, incluant :
- Le transport solidaire (conducteurs bénévoles)
- Le covoiturage organisé
- La gestion de véhicules partagés
- L'accès aux transports en commun et services de mobilité
## Public cible
### Utilisateurs principaux
- **Référents sociaux** : professionnels accompagnant des bénéficiaires
- **Administrateurs de structures** : gestion et pilotage des dispositifs
- **Conducteurs solidaires** : bénévoles proposant des trajets
- **Bénéficiaires** : personnes en situation de fragilité sociale ayant des besoins de mobilité
### Types de structures
- Centres communaux d'action sociale (CCAS)
- Centres sociaux et maisons de quartier
- Associations d'insertion sociale
- Collectivités territoriales
- Plateformes de mobilité solidaire
## Architecture multi-organisation
PARCOURSMOB est conçu pour fonctionner en mode multi-organisations :
- Chaque structure dispose de son propre **espace groupe**
- Gestion autonome des membres et des droits d'accès
- Configuration personnalisée des modules et fonctionnalités
- Données isolées par organisation (confidentialité garantie)
- Possibilité de collaboration inter-structures sur certains dispositifs
## Modules principaux
### 1. Transport Solidaire
Gestion des conducteurs bénévoles et mise en relation avec les bénéficiaires pour des trajets solidaires.
[→ Documentation détaillée](modules/transport-solidaire.md)
**Fonctionnalités clés** :
- Gestion du fichier conducteurs solidaires
- Création et suivi des réservations
- Système de compensation des conducteurs
- Filtres géographiques et statistiques
### 2. Covoiturage Solidaire
Organisation de covoiturages entre conducteurs solidaires et bénéficiaires sur des trajets récurrents.
[→ Documentation détaillée](modules/covoiturage-solidaire.md)
**Fonctionnalités clés** :
- Gestion des covoitureurs solidaires
- Trajets réguliers (domicile-travail, formations, etc.)
- Réservations et planification
- Compensation et tarification
### 3. Gestion des Bénéficiaires
Fichier centralisé des personnes accompagnées avec leurs besoins de mobilité.
[→ Documentation détaillée](modules/beneficiaires.md)
**Fonctionnalités clés** :
- Fiche bénéficiaire complète
- Historique des trajets et réservations
- Gestion des documents
- Portefeuille mobilité
### 4. Gestion de Véhicules
Gestion d'une flotte de véhicules partagés mise à disposition des bénéficiaires.
[→ Documentation détaillée](modules/gestion-vehicules.md)
**Fonctionnalités clés** :
- Catalogue de véhicules disponibles
- Système de réservation
- Gestion des documents (permis, assurance, etc.)
- Suivi des disponibilités
### 5. Agenda
Gestion des événements et actions collectives liés à la mobilité.
[→ Documentation détaillée](modules/agenda.md)
**Fonctionnalités clés** :
- Création d'événements
- Inscriptions des bénéficiaires
- Notifications et rappels
- Gestion des documents associés
## Fonctionnalités transversales
### Tableau de bord
Vue d'ensemble de l'activité de la structure :
- Statistiques sur les bénéficiaires
- Nombre de conducteurs actifs
- Événements à venir
- Réservations en cours
- Carte des conducteurs avec filtres géographiques
### Recherche d'itinéraires
Moteur de recherche multimodal intégrant :
- Solutions de transport en commun
- Plateformes de covoiturage (Mobicoop, Movici, BlaBlaCar Daily)
- Conducteurs solidaires disponibles
- Véhicules disponibles à la réservation
### Système de filtres géographiques
Filtrage des données par zone géographique (EPCI, commune, etc.) pour cibler les actions et dispositifs.
### Exports Excel
Export des données au format Excel pour analyse et reporting :
- Liste des bénéficiaires
- Historique des réservations
- Liste des conducteurs
- Statistiques d'activité
### Gestion documentaire
- Stockage sécurisé des documents (permis, justificatifs, etc.)
- Types de documents configurables
- Documents obligatoires pour certaines actions
- Visualisation et téléchargement
## Architecture technique
### Approche modulaire
- Activation/désactivation des modules selon les besoins
- Configuration fine par module
- Thèmes personnalisables
### Intégrations externes
- **OpenID Connect** : authentification déléguée
- **COOPGO Platform** : services de mobilité mutualisés
- **Services de géographie** : fonds de carte, geocoding
- **API de mobilité** : transports en commun, covoiturage
### Technologies
- Backend : Go
- Frontend : Templates HTML, Alpine.js, Tailwind CSS
- Cartographie : MapLibre GL JS
- Stockage : MongoDB, PostgreSQL
- Cache distribué : etcd
## Guides d'utilisation
- [Guide de démarrage rapide](guides/demarrage-rapide.md)
- [Guide référent social](guides/referent-social.md)
- [Guide administrateur](guides/administrateur.md)
- [Guide conducteur solidaire](guides/conducteur-solidaire.md)
## Support et contact
Pour toute question ou demande d'assistance :
- Issues : [Dépôt Git](https://git.coopgo.io/coopgo-apps/parcoursmob)

297
modules/agenda.md Normal file
View File

@ -0,0 +1,297 @@
# Module Agenda
## Vue d'ensemble
Le module **Agenda** permet de gérer des événements et actions collectives liés à la mobilité. Il s'agit d'organiser des temps collectifs (ateliers, formations, sorties, événements) et de gérer les inscriptions des bénéficiaires.
## Concept et cas d'usage
### Qu'est-ce qu'un événement ?
Un événement est une action collective organisée par la structure, à laquelle les bénéficiaires peuvent s'inscrire. Il peut s'agir d'actions liées à la mobilité (formation au code de la route, atelier mécanique) ou d'événements sociaux (sorties culturelles, rencontres collectives).
### Types d'événements courants
- **Ateliers mobilité** : formation au code de la route, sensibilisation à l'éco-conduite
- **Ateliers techniques** : initiation à la mécanique, entretien de vélo
- **Sorties collectives** : visite d'entreprise, sortie culturelle, événement sportif
- **Rencontres thématiques** : café mobilité, groupes de parole
- **Formations** : permis de conduire, formation premiers secours
### Objectifs pédagogiques et sociaux
- Développer l'autonomie en mobilité
- Créer du lien social entre bénéficiaires
- Proposer des activités collectives enrichissantes
- Accompagner vers l'insertion professionnelle
- Favoriser les échanges de pratiques
## Fonctionnalités principales
### 1. Création et gestion des événements
#### Fiche événement
Chaque événement dispose d'une fiche complète avec :
- **Informations générales** :
- Titre de l'événement
- Description détaillée
- Organisation organisatrice (groupe)
- **Date et horaires** :
- Date de début
- Date de fin
- Heure de début
- Heure de fin
- **Lieu** :
- Adresse de l'événement
- Localisation GPS
- **Capacité** :
- Nombre de places disponibles
- Places restantes (calculé automatiquement)
- **Documents associés** :
- Affiche de l'événement
- Programme détaillé
- Fiche d'inscription
- Documents à fournir aux participants
#### Création d'un événement
1. Clic sur "Créer un événement"
2. Formulaire de saisie avec toutes les informations
3. Upload de documents (optionnel)
4. Validation et publication de l'événement
5. L'événement apparaît dans le calendrier
### 2. Agenda et calendrier
#### Vue calendrier
- **Événements à venir** : tous les événements futurs organisés par la structure
- **Historique** : événements passés pour consultation et archivage
- Affichage chronologique
- Recherche par date ou par mot-clé
#### Filtres
- Par période (date de début/fin)
- Par organisation
- Événements complets vs places disponibles
### 3. Inscriptions des bénéficiaires
#### Processus d'inscription
1. Le référent accède à la fiche de l'événement
2. Clic sur "Inscrire un bénéficiaire"
3. Sélection du/des bénéficiaire(s) à inscrire
4. Confirmation de l'inscription
5. Le nombre de places disponibles est mis à jour automatiquement
#### Gestion des inscriptions
- Liste complète des participants inscrits à un événement
- Possibilité de désinscrire un participant
- Gestion de la liste d'attente (si événement complet)
- Export de la liste des participants
### 4. Fiche détaillée de l'événement
Accessible en cliquant sur un événement, elle affiche :
#### Informations de l'événement
- Toutes les informations saisies lors de la création
- Statut : à venir, complet, passé, annulé
- Nombre d'inscrits / nombre de places
#### Liste des participants
- Nom, prénom de chaque participant inscrit
- Contact (email, téléphone)
- Possibilité de désinscrire un participant
- Export Excel de la liste
#### Documents
- Tous les documents associés à l'événement
- Upload de nouveaux documents
- Téléchargement des documents existants
#### Actions disponibles
- Modifier l'événement
- Annuler l'événement
- Supprimer l'événement (si aucune inscription)
- Inscrire des bénéficiaires
- Envoyer des notifications aux inscrits
### 5. Historique des événements
Consultation des événements passés avec :
- Toutes les informations de l'événement
- Liste des participants qui ont effectivement participé
- Documents de l'événement
- Statistiques de participation
### 6. Gestion documentaire
Pour chaque événement, possibilité d'associer des documents :
- Affiche ou flyer
- Programme détaillé
- Feuille d'émargement
- Supports de présentation
- Photos de l'événement (après réalisation)
- Documents personnalisés selon la configuration
### 7. Tableau de bord
Le tableau de bord principal de PARCOURSMOB affiche :
- Les prochains événements à venir
- Lien direct vers l'agenda complet
## Configuration du module
### Types de documents (exemple)
Configuration des types de documents associables aux événements :
```yaml
modules:
agenda:
file_types:
- type: poster
label: Affiche
- type: program
label: Programme
- type: attendance_sheet
label: Feuille d'émargement
- type: photos
label: Photos
- type: presentation
label: Support de présentation
```
### Namespaces
Les événements sont organisés par namespace pour isoler les événements selon les contextes :
```yaml
modules:
agenda:
namespaces:
- parcoursmob_dispositifs
```
## Cas d'usage détaillés
### Scénario 1 : Atelier code de la route
1. La structure organise un atelier de révision du code de la route
2. Création d'un événement "Atelier Code" pour le samedi suivant
3. Capacité : 15 places
4. Upload d'une affiche et du programme de l'atelier
5. 12 bénéficiaires sont inscrits par leurs référents
6. Le jour J, feuille d'émargement pour valider la présence
7. Upload de la feuille d'émargement et des photos après l'événement
### Scénario 2 : Sortie collective en covoiturage
1. Organisation d'une sortie culturelle au musée
2. Création de l'événement avec date, horaires et lieu
3. 20 bénéficiaires s'inscrivent
4. Organisation du covoiturage pour y accéder (utilisation du module Covoiturage Solidaire)
5. Réalisation de la sortie
6. Bilan dans l'historique de l'événement
### Scénario 3 : Cycle de formations mobilité
1. Organisation d'un cycle de 4 ateliers mobilité sur 2 mois
2. Création de 4 événements distincts avec les mêmes participants
3. Suivi de la présence à chaque atelier
4. Bilan final avec taux de participation
### Scénario 4 : Événement complet avec liste d'attente
1. Création d'un atelier mécanique vélo (10 places)
2. 10 bénéficiaires sont inscrits rapidement (événement complet)
3. Nouveaux bénéficiaires intéressés : gestion manuelle d'une liste d'attente
4. En cas de désistement, inscription d'un bénéficiaire en attente
## Bonnes pratiques
### Planification des événements
- Anticiper la création des événements (au moins 2 semaines avant)
- Définir clairement les objectifs pédagogiques
- Prévoir une capacité réaliste en fonction des moyens disponibles
- Varier les types d'événements pour toucher différents publics
### Gestion des inscriptions
- Valider les inscriptions rapidement pour confirmer la participation
- Relancer les inscrits quelques jours avant l'événement
- Prévoir des places de secours en cas de désistements
- Tenir une liste d'attente pour les événements populaires
### Communication
- Rédiger des descriptions attractives et claires
- Utiliser des visuels pour illustrer les événements
- Communiquer régulièrement sur les événements à venir
- Faire des retours sur les événements passés (photos, témoignages)
### Suivi et évaluation
- Faire émarger les participants le jour J
- Prendre des photos (avec accord des participants)
- Recueillir les retours et satisfaction des participants
- Analyser les taux de participation et d'absentéisme
### Archivage
- Conserver les documents de chaque événement dans l'historique
- Archiver les feuilles d'émargement
- Capitaliser sur les événements réussis pour les reproduire
## Indicateurs de suivi
### Indicateurs d'activité
- Nombre d'événements organisés par mois
- Nombre de bénéficiaires participants par mois
- Taux de participation moyen (nombre d'inscrits vs places disponibles)
- Taux de remplissage des événements
### Indicateurs de qualité
- Taux de présence effective (inscrits vs présents)
- Taux d'annulation des événements
- Diversité des types d'événements proposés
- Satisfaction des participants (enquête post-événement)
### Indicateurs sociaux
- Nombre de bénéficiaires ayant participé à au moins un événement
- Profil des participants (âge, situation)
- Types d'événements les plus plébiscités
- Fidélisation (bénéficiaires participant à plusieurs événements)
## Intégration avec les autres modules
Le module Agenda s'intègre avec les autres modules :
### Module Bénéficiaires
- Inscription aux événements depuis la fiche bénéficiaire
- Historique des événements dans l'onglet Événements de la fiche bénéficiaire
- Vue d'ensemble des événements passés et à venir
### Module Covoiturage Solidaire / Transport Solidaire
- Organisation de covoiturages ou transports pour accéder aux événements
- Réservations de trajets liées à des événements
### Module Gestion de Véhicules
- Réservation de véhicules pour se rendre à des événements
- Organisation de sorties collectives avec véhicules de la flotte
### Tableau de bord
- Affichage des prochains événements sur la page d'accueil
- Lien direct vers l'agenda complet
## Avantages du module Agenda
### Pour la structure
- Centralisation de l'organisation des événements
- Gestion simplifiée des inscriptions
- Traçabilité de l'activité collective
- Suivi de la participation des bénéficiaires
### Pour les référents
- Vue d'ensemble des événements à venir
- Inscription rapide de leurs bénéficiaires
- Accès aux documents et informations pratiques
### Pour les bénéficiaires
- Participation à des activités collectives enrichissantes
- Développement de compétences en mobilité
- Création de lien social avec d'autres bénéficiaires
- Accès à des ressources et formations gratuites ou accessibles

331
modules/beneficiaires.md Normal file
View File

@ -0,0 +1,331 @@
# Module Bénéficiaires
## Vue d'ensemble
Le module **Bénéficiaires** constitue le cœur de PARCOURSMOB. Il permet de gérer le fichier des personnes accompagnées par la structure, avec leurs besoins de mobilité, leur historique de déplacements et les services mobilité dont ils bénéficient.
## Concept et cas d'usage
### Qu'est-ce qu'un bénéficiaire ?
Un bénéficiaire est une personne en situation de fragilité sociale, accompagnée par la structure (CCAS, centre social, association), qui a des besoins de mobilité pour accéder à l'emploi, la formation, la santé ou les démarches administratives.
### Rôle central dans PARCOURSMOB
Le bénéficiaire est au centre de tous les services :
- Il peut être transporté en **transport solidaire**
- Il peut être covoituré en **covoiturage solidaire**
- Il peut réserver des **véhicules partagés**
- Il peut s'inscrire à des **événements**
- Il peut effectuer des **recherches d'itinéraires** multimodaux
## Fonctionnalités principales
### 1. Gestion de la fiche bénéficiaire
#### Informations personnelles
- Nom, prénom
- Email, téléphone
- Date de naissance
- Genre
- Adresse postale
- Photo (optionnel)
#### Informations d'accompagnement
- **Numéro de dossier** : identifiant interne de la structure
- **Référent social** : professionnel qui accompagne le bénéficiaire
- **Organisation(s)** : structure(s) d'appartenance
- **Champs personnalisables** : configurés selon les besoins de la structure
- Situation familiale
- Situation professionnelle
- Problématiques de mobilité
- Objectifs d'accompagnement
- Notes libres
#### Portefeuille mobilité
Chaque bénéficiaire dispose d'un portefeuille virtuel :
- Solde disponible pour payer les services de mobilité
- Historique des crédits et débits
- Gestion des recharges par les référents
- Utilisation pour réserver des véhicules, payer des trajets, etc.
### 2. Liste des bénéficiaires
#### Vue d'ensemble
- Liste complète de tous les bénéficiaires de la structure
- Affichage des informations principales (nom, email, téléphone)
- Recherche rapide par nom, prénom ou email
- Tri par ordre alphabétique ou date de création
#### Filtres disponibles
- **Bénéficiaires archivés** : afficher les bénéficiaires inactifs
- **Recherche textuelle** : recherche dans les noms, prénoms, emails
- **Export Excel** : export de la liste avec tous les champs
#### Actions disponibles
- Créer un nouveau bénéficiaire
- Accéder à la fiche détaillée d'un bénéficiaire
- Modifier les informations d'un bénéficiaire
- Archiver un bénéficiaire (départ de l'accompagnement)
### 3. Fiche détaillée du bénéficiaire
La fiche bénéficiaire est organisée en plusieurs onglets :
#### Onglet Informations générales
- Toutes les informations personnelles
- Organisations d'appartenance
- Champs personnalisés configurés
- Actions :
- Modifier les informations
- Archiver le bénéficiaire
- Recharger le portefeuille mobilité
#### Onglet Transport Solidaire
Si le module est activé :
- **Statistiques** :
- Nombre de trajets effectués
- Distance totale parcourue
- Montant total payé
- **Réservations en cours** : liste des prochains trajets
- **Historique des réservations** : tous les trajets passés
- Accès direct à la création d'une nouvelle réservation
#### Onglet Covoiturage Solidaire
Si le module est activé :
- **Statistiques** :
- Nombre de covoiturages
- Distance totale en covoiturage
- Montant total payé
- **Covoiturages en cours** : liste des covoiturages actifs
- **Historique** : tous les covoiturages passés
- Accès direct à la création d'un nouveau covoiturage
#### Onglet Véhicules
Si le module est activé :
- **Réservations en cours** : véhicules actuellement réservés
- **Historique** : toutes les réservations de véhicules passées
- **Documents** : permis de conduire, justificatifs
- Accès direct à la recherche de véhicules disponibles
#### Onglet Événements
Si le module est activé :
- **Événements à venir** : inscriptions aux prochains événements
- **Historique** : événements passés auxquels le bénéficiaire a participé
- Possibilité d'inscrire le bénéficiaire à de nouveaux événements
#### Onglet Documents
- Gestion des documents associés au bénéficiaire :
- Pièce d'identité
- Justificatif de domicile
- Permis de conduire
- Justificatifs de ressources
- Documents personnalisés selon la configuration
- Upload de nouveaux documents
- Visualisation et téléchargement des documents existants
#### Onglet Portefeuille
- **Solde actuel** : montant disponible
- **Historique des transactions** :
- Crédits (recharges)
- Débits (paiements de services)
- Date et motif de chaque transaction
- **Rechargement** : bouton pour créditer le portefeuille
### 4. Création d'un bénéficiaire
Processus de création :
1. Clic sur "Créer un bénéficiaire"
2. Formulaire avec :
- Informations obligatoires : nom, prénom, email
- Informations optionnelles : téléphone, date de naissance, adresse, etc.
- Champs personnalisés configurés
3. Validation et création
4. Le bénéficiaire est ajouté à la liste et reçoit un email de bienvenue (optionnel)
### 5. Export Excel des bénéficiaires
L'export génère un fichier Excel contenant :
- Toutes les informations personnelles
- Tous les champs personnalisés configurés
- Organisation(s) d'appartenance
- Statut (actif/archivé)
- Solde du portefeuille mobilité
- Statistiques d'utilisation des services
### 6. Archivage des bénéficiaires
Quand un bénéficiaire n'est plus accompagné par la structure :
- **Archivage** plutôt que suppression (conservation de l'historique)
- Les bénéficiaires archivés ne sont plus visibles par défaut
- Possibilité de réactiver un bénéficiaire archivé
- Historique conservé pour les statistiques
## Configuration du module
### Champs personnalisables
```yaml
modules:
beneficiaries:
profile_optional_fields:
- name: situation_familiale
label: Situation familiale
type: select
options:
- value: seul
label: Seul(e)
- value: couple
label: En couple
- value: famille
label: Famille
- name: situation_professionnelle
label: Situation professionnelle
type: select
options:
- value: sans_emploi
label: Sans emploi
- value: emploi
label: En emploi
- value: formation
label: En formation
- value: recherche
label: En recherche d'emploi
- name: problematiques_mobilite
label: Problématiques de mobilité
type: multicheckbox
options:
- value: pas_permis
label: Pas de permis de conduire
- value: pas_vehicule
label: Pas de véhicule personnel
- value: acces_tc
label: Difficulté d'accès aux transports en commun
- value: handicap
label: Situation de handicap
- name: objectifs
label: Objectifs d'accompagnement
type: textarea
```
### Types de documents
Configuration des types de documents associables aux bénéficiaires :
```yaml
modules:
beneficiaries:
file_types:
- type: id_card
label: Pièce d'identité
required: true
- type: address_proof
label: Justificatif de domicile
required: true
- type: driving_license
label: Permis de conduire
required: false
- type: income_proof
label: Justificatif de ressources
required: false
```
## Cas d'usage détaillés
### Scénario 1 : Nouvel accompagnement
1. Un nouveau bénéficiaire se présente au centre social
2. Le référent crée sa fiche dans PARCOURSMOB avec les informations collectées
3. Upload des documents nécessaires (pièce d'identité, justificatif de domicile)
4. Évaluation des besoins de mobilité via les champs personnalisés
5. Rechargement initial du portefeuille mobilité si nécessaire
### Scénario 2 : Suivi d'un accompagnement mobilité
1. Un bénéficiaire a besoin d'un trajet pour un entretien d'embauche
2. Le référent consulte sa fiche bénéficiaire
3. Vérification du solde du portefeuille
4. Création d'une réservation en transport solidaire depuis l'onglet dédié
5. Le coût du trajet est débité automatiquement du portefeuille
### Scénario 3 : Bilan d'activité
1. Le référent souhaite faire un bilan avec le bénéficiaire
2. Consultation de la fiche détaillée
3. Revue des statistiques dans chaque onglet :
- Nombre de trajets effectués
- Événements auxquels il a participé
- Réservations de véhicules
4. Identification des progrès et des besoins restants
### Scénario 4 : Reporting et statistiques
1. La structure doit produire un rapport d'activité
2. Export Excel de tous les bénéficiaires (actifs et archivés)
3. Analyse des données :
- Profil type des bénéficiaires (âge, situation, problématiques)
- Taux d'utilisation des différents services
- Évolution du nombre de bénéficiaires sur l'année
## Bonnes pratiques
### Création de fiches
- Renseigner un maximum d'informations dès la création
- Vérifier la validité de l'email (pour les notifications)
- Associer immédiatement le référent social
- Upload rapide des documents essentiels
### Mise à jour des informations
- Actualiser régulièrement les informations (changement d'adresse, de téléphone, etc.)
- Mettre à jour les objectifs d'accompagnement
- Renouveler les documents périmés (permis de conduire, etc.)
### Gestion du portefeuille
- Définir une politique claire de rechargement
- Suivre régulièrement les soldes pour anticiper les besoins
- Documenter les motifs de rechargement
### Confidentialité et RGPD
- Limiter l'accès aux fiches aux seuls référents autorisés
- Archiver les bénéficiaires en fin d'accompagnement
- Prévoir une politique de purge des données après un certain délai
- Respecter les droits d'accès et de rectification des bénéficiaires
### Organisation des documents
- Définir une nomenclature claire des types de documents
- Vérifier la validité des documents régulièrement
- Alerter sur les documents manquants ou périmés
## Indicateurs de suivi
Indicateurs recommandés à suivre au niveau des bénéficiaires :
### Indicateurs quantitatifs
- Nombre total de bénéficiaires actifs
- Nombre de nouveaux bénéficiaires sur la période
- Nombre de bénéficiaires archivés
- Répartition par tranche d'âge
- Répartition par zone géographique
### Indicateurs d'activité
- Taux d'utilisation des services (% de bénéficiaires ayant utilisé au moins un service)
- Nombre moyen de trajets par bénéficiaire
- Montant moyen du portefeuille mobilité
- Taux de rechargement du portefeuille
### Indicateurs sociaux
- Répartition par situation professionnelle
- Répartition par problématique de mobilité
- Évolution des situations (comparaison début/fin d'accompagnement)
## Intégration avec les autres modules
Le module Bénéficiaires s'intègre naturellement avec tous les autres modules :
- **Transport Solidaire** : création de réservations depuis la fiche bénéficiaire
- **Covoiturage Solidaire** : suivi des covoiturages du bénéficiaire
- **Gestion de Véhicules** : historique des réservations de véhicules
- **Agenda** : inscriptions aux événements
- **Recherche d'itinéraires** : recherche de solutions de mobilité pour le bénéficiaire
Cette centralisation permet un suivi complet et cohérent de l'accompagnement mobilité de chaque personne.

View File

@ -0,0 +1,251 @@
# Module Covoiturage Solidaire
## Vue d'ensemble
Le module **Covoiturage Solidaire** (aussi appelé Covoiturage Organisé) permet de gérer des trajets réguliers entre des covoitureurs solidaires et des bénéficiaires. Contrairement au transport solidaire qui gère des trajets ponctuels, ce module est conçu pour des déplacements récurrents et planifiés.
## Concept et cas d'usage
### Principe de fonctionnement
Des covoitureurs solidaires proposent des trajets réguliers (quotidiens, hebdomadaires) sur des itinéraires fixes. Les référents sociaux créent des réservations pour mettre en relation les bénéficiaires avec ces covoitureurs sur ces trajets récurrents.
### Exemples de trajets récurrents
- Trajets domicile-travail quotidiens
- Accès à une formation professionnelle
- Déplacements vers un lieu d'activité régulier
- Trajets vers un établissement de santé pour soins réguliers
### Différence avec le transport solidaire
Le covoiturage solidaire se distingue du transport solidaire par :
- **Trajets réguliers et récurrents** (vs trajets ponctuels à la demande)
- **Planification à moyen/long terme** (vs demande ponctuelle)
- **Itinéraires fixes** (vs trajets variables)
- **Engagement du covoitureur sur la durée** (vs disponibilités ponctuelles)
## Fonctionnalités principales
### 1. Gestion des covoitureurs solidaires
#### Fiche covoitureur
Chaque covoitureur dispose d'une fiche complète avec :
- **Informations personnelles** : nom, prénom, email, téléphone, date de naissance, genre
- **Adresse de départ** : point de départ habituel des trajets
- **Adresse de destination** : point d'arrivée habituel des trajets
- **Numéro de dossier** : identifiant interne
- **Champs personnalisables** configurés dans l'application
#### Liste des covoitureurs
- Vue d'ensemble de tous les covoitureurs
- **Filtres disponibles** :
- Filtre par zone géographique (adresse de départ du covoitureur)
- Affichage des covoitureurs archivés
- **Actions** :
- Création d'un nouveau covoitureur
- Modification d'un covoitureur existant
- Archivage d'un covoitureur inactif
- Export Excel de la liste
#### Export Excel des covoitureurs
L'export inclut toutes les informations des covoitureurs :
- Identifiant
- Informations personnelles complètes
- Tous les champs optionnels configurés
- Adresse de départ
- Adresse de destination
- Statut archivé
- Respect des filtres actifs (géographie, archivage)
### 2. Gestion des trajets réguliers
Les covoitureurs peuvent définir leurs trajets réguliers avec :
- Itinéraire fixe (départ et destination)
- Jours de la semaine
- Horaires
- Places disponibles
### 3. Création et suivi des réservations
#### Création d'une réservation
Le référent social crée une réservation en indiquant :
- **Bénéficiaire** : personne à covoiturer
- **Covoitureur** : conducteur solidaire
- **Motif** : raison du déplacement récurrent
- **Date de prise en charge** : date et heure de début du covoiturage
- **Lieu de prise en charge du bénéficiaire**
- **Lieu de dépose du bénéficiaire**
- **Détails du trajet** :
- Distance passager
- Durée estimée
#### Tarification et compensation
- **Prix passager** : participation financière demandée au bénéficiaire
- **Compensation conducteur** : montant versé au covoitureur
- Configuration des barèmes
#### États d'une réservation
- **En attente** : réservation créée
- **Confirmée** : covoiturage validé
- **En cours** : covoiturage actif
- **Terminée** : covoiturage achevé
- **Annulée** : covoiturage annulé
#### Filtres sur les réservations en cours
- **Statut** : filtrer par état de la réservation
- **Covoitureur** : voir les réservations d'un covoitureur spécifique
- **Période** : date de début et date de fin
- **Zones géographiques** :
- Lieu de départ du trajet
- Destination du trajet
- Adresse du bénéficiaire
#### Historique des réservations
- Consultation des réservations passées
- Mêmes filtres que pour les réservations en cours
- Export Excel avec tous les détails
### 4. Export Excel des réservations
L'export des réservations inclut :
- Informations de la réservation (ID, statut, motif, date)
- Informations du covoitureur (nom, prénom, contact, champs personnalisés)
- Informations du bénéficiaire (nom, prénom, contact, champs personnalisés)
- Détails du trajet (adresses, distance passager, durée)
- Tarification (prix passager, compensation covoitureur, devises)
### 5. Fiche détaillée du covoitureur
Accessible en cliquant sur un covoitureur, elle affiche :
- Toutes les informations du profil
- **Onglet Trajets** : trajets réguliers proposés par le covoitureur
- **Onglet Réservations** : liste des réservations du covoitureur
- **Onglet Documents** : documents du covoitureur (permis, assurance, etc.)
- **Onglet Statistiques** :
- Nombre de bénéficiaires covoiturés
- Distance totale parcourue en covoiturage
- Montant total des compensations
- **Portefeuille** : suivi des compensations versées
### 6. Gestion documentaire
Pour chaque covoitureur, possibilité d'associer des documents :
- Permis de conduire
- Carte grise du véhicule
- Attestation d'assurance
- Casier judiciaire (si requis)
- Documents personnalisés selon la configuration
## Configuration du module
### Champs personnalisables
Dans le fichier de configuration, il est possible d'ajouter des champs supplémentaires au profil covoitureur :
```yaml
modules:
organized_carpool:
drivers:
profile_optional_fields:
- name: gender
label: Genre
type: select
options:
- value: "0"
label: Inconnu
- value: "1"
label: Masculin
- value: "2"
label: Féminin
- value: "9"
label: Sans objet
- name: type_vehicle
label: Type de véhicule
type: select
options:
- value: citadine
label: Citadine
- value: berline
label: Berline
- value: monospace
label: Monospace
- name: available_seats
label: Nombre de places disponibles
type: number
- name: comment
label: Commentaire
type: textarea
```
### Filtres géographiques
Configuration identique au module Transport Solidaire pour filtrer par zones géographiques.
## Cas d'usage détaillés
### Scénario 1 : Trajet domicile-travail
1. Un bénéficiaire a trouvé un emploi mais n'a pas de moyen de transport
2. Le référent identifie un covoitureur solidaire faisant un trajet compatible
3. Création d'une réservation pour un covoiturage du lundi au vendredi
4. Le covoiturage est actif pendant la période d'emploi du bénéficiaire
5. Une participation financière symbolique peut être demandée au bénéficiaire
### Scénario 2 : Formation professionnelle
1. Un bénéficiaire suit une formation sur 6 mois dans une ville voisine
2. Le référent crée une réservation pour 2 jours par semaine
3. Le covoitureur est compensé mensuellement selon le barème
4. À la fin de la formation, le covoiturage est clôturé
### Scénario 3 : Mise en place d'une ligne solidaire
1. Plusieurs bénéficiaires ont besoin de trajets vers la même zone d'activité
2. Recrutement d'un covoitureur solidaire pour créer une "ligne" régulière
3. Création de plusieurs réservations avec points de prise en charge multiples
4. Organisation d'un planning mensuel partagé
## Bonnes pratiques
### Gestion des covoitureurs
- Établir un engagement clair sur la durée du covoiturage
- Définir les itinéraires et horaires précisément
- Prévoir des solutions de secours en cas d'indisponibilité
- Vérifier la compatibilité géographique avant de créer une réservation
### Gestion des réservations
- Anticiper les créations de réservations (ne pas attendre le dernier moment)
- Communiquer régulièrement avec covoitureurs et bénéficiaires
- Gérer les absences et ajustements de planning
- Évaluer régulièrement la satisfaction des deux parties
### Compensation
- Définir un barème adapté aux trajets réguliers (compensation mensuelle ou forfaitaire)
- Prévoir des ajustements en cas de modification du planning
- Tracer tous les versements dans le portefeuille
### Suivi de l'activité
- Faire des points réguliers avec les binômes covoitureur-bénéficiaire
- Anticiper les fins de covoiturage (fin de contrat, fin de formation)
- Identifier les opportunités de mutualisation de trajets
## Indicateurs de suivi
Indicateurs recommandés à suivre :
- Nombre de covoitureurs actifs
- Nombre de bénéficiaires covoiturés par mois
- Durée moyenne d'un covoiturage
- Taux de satisfaction des covoitureurs
- Taux de satisfaction des bénéficiaires
- Distance mensuelle totale parcourue en covoiturage solidaire
- Montant mensuel des compensations
- Taux de reconduction des covoiturages
- Nombre de trajets par zone géographique
## Complémentarité avec le Transport Solidaire
Les deux modules peuvent fonctionner de manière complémentaire :
- **Transport Solidaire** : pour les besoins ponctuels et urgents
- **Covoiturage Solidaire** : pour les besoins récurrents et planifiés
Un bénéficiaire peut utiliser le covoiturage solidaire pour ses trajets quotidiens domicile-travail, et le transport solidaire pour des rendez-vous médicaux ponctuels.

View File

@ -0,0 +1,275 @@
# Module Gestion de Véhicules
## Vue d'ensemble
Le module **Gestion de Véhicules** (aussi appelé Vehicles Management) permet aux structures de gérer une flotte de véhicules partagés mis à disposition des bénéficiaires. Il s'agit d'un service d'autopartage solidaire géré directement par la structure d'accompagnement.
## Concept et cas d'usage
### Qu'est-ce que l'autopartage solidaire ?
L'autopartage solidaire consiste à mettre à disposition des véhicules à un public en fragilité sociale, pour des usages ponctuels ou réguliers, à des tarifs accessibles ou symboliques. Contrairement aux services d'autopartage classiques, ce dispositif s'inscrit dans une démarche d'accompagnement social.
### Types de véhicules (exemples)
Les types de véhicules sont entièrement paramétrables selon les besoins de la structure. Voici quelques exemples courants :
- Voitures citadines et berlines
- Véhicules utilitaires légers (pour déménagement, courses, etc.)
- Véhicules adaptés (handicap, familles nombreuses)
- Deux-roues motorisés (scooters, motos)
- Vélos à assistance électrique (VAE)
### Cas d'usage typiques
- **Entretiens d'embauche** : réservation ponctuelle pour se présenter à un entretien
- **Démarches administratives** : accès à des services publics éloignés
- **Formations professionnelles** : déplacements réguliers vers un centre de formation
- **Courses** : accès à des commerces ou services médicaux
- **Déménagement** : location d'un utilitaire pour un petit déménagement
## Fonctionnalités principales
### 1. Gestion du parc de véhicules
#### Fiche véhicule
Chaque véhicule dispose d'une fiche complète avec :
- **Identification** :
- Nom/modèle du véhicule
- Type de véhicule (paramétrable dans la configuration)
- Immatriculation
- Photo du véhicule
- **Caractéristiques techniques** :
- Marque et modèle
- Année de mise en circulation
- Type de carburant ou énergie
- Boîte automatique ou manuelle
- Équipements spécifiques
- **Localisation** :
- Adresse du parking habituel
- **Disponibilité** :
- Périodes d'indisponibilité (maintenance, réparations)
#### Liste des véhicules
- Vue d'ensemble de tous les véhicules de la flotte
- Filtres par type, disponibilité
- Statut en temps réel (disponible, réservé, en maintenance)
- Actions :
- Ajouter un nouveau véhicule
- Modifier les informations d'un véhicule
- Retirer un véhicule de la flotte
- Voir les réservations d'un véhicule
### 2. Recherche et réservation de véhicules
#### Interface de recherche
Les bénéficiaires (via leur référent) peuvent rechercher un véhicule selon :
- **Date et horaires** : période de réservation souhaitée
- **Type de véhicule** : selon le besoin et les types configurés
- **Boîte automatique** : filtre si besoin d'une boîte automatique
- **Bénéficiaire** : personne qui réservera le véhicule
#### Processus de réservation
1. Sélection d'un véhicule disponible
2. Choix du bénéficiaire
3. Choix de la période de réservation (date/heure début et fin)
4. Vérification des **documents obligatoires** du bénéficiaire :
- Permis de conduire valide (pour les véhicules motorisés)
- Autres documents selon configuration
5. Confirmation de la réservation
> **Note** : Le système de tarification et de paiement via portefeuille mobilité est prévu mais non encore implémenté dans cette version.
### 3. Gestion des réservations
#### Vue d'ensemble des réservations
Deux espaces de gestion :
- **Réservations en cours et à venir** : planification et suivi
- **Historique des réservations** : archivage et statistiques
#### Fiche de réservation
Pour chaque réservation :
- **Informations générales** :
- Bénéficiaire
- Véhicule réservé
- Organisation (groupe)
- Dates et horaires (début et fin)
- **Statut** :
- En attente de validation
- Confirmée
- En cours (véhicule actuellement utilisé)
- Terminée
- Annulée
- **Documents associés** :
- Documents liés à la réservation (contrats, états des lieux, etc.)
#### Gestion des documents obligatoires
Le système vérifie automatiquement que le bénéficiaire dispose des documents requis :
- Permis de conduire valide pour la catégorie du véhicule
- Autres justificatifs selon la configuration
Si des documents manquent ou sont périmés, la réservation est bloquée.
#### Modification et annulation
- **Modification** : changement de dates/horaires si le véhicule est disponible
- **Annulation** : annulation par le référent ou le bénéficiaire
### 4. Gestion des véhicules alternatifs
En cas d'indisponibilité d'un véhicule réservé (panne, accident, maintenance), le référent peut proposer des **véhicules alternatifs** de type similaire et disponibles sur la même période.
### 5. Filtres sur les réservations
Les réservations peuvent être filtrées selon plusieurs critères :
- **Véhicule** : voir toutes les réservations d'un véhicule spécifique
- **Période** : date de début et date de fin
- **Statut** : en cours, terminées, annulées
- **Groupe/Organisation** : filtrer par structure
### 6. Export et statistiques
- Export Excel des réservations avec filtres
- Statistiques d'utilisation par véhicule
- Statistiques d'utilisation par bénéficiaire
> **Note** : Les indicateurs de qualité avancés (taux de satisfaction, analyse des dommages, etc.) sont prévus mais non encore implémentés (TODO).
## Configuration du module
### Types de véhicules (exemple)
Les types de véhicules sont entièrement paramétrables. Voici un exemple de configuration :
```yaml
modules:
vehicles_management:
vehicle_types:
- citadine
- berline
- utilitaire
- deux_roues
- vae
```
### Documents obligatoires (exemple)
Configuration des types de documents requis pour réserver un véhicule :
```yaml
modules:
vehicles_management:
mandatory_documents:
- driving_license
- id_card
- address_proof
```
Les documents sont gérés au niveau des bénéficiaires dans le module Bénéficiaires.
## Cas d'usage détaillés
### Scénario 1 : Entretien d'embauche
1. Un bénéficiaire a un entretien d'embauche dans une zone mal desservie
2. Le référent recherche un véhicule disponible pour la matinée
3. Vérification que le bénéficiaire dispose d'un permis valide dans ses documents
4. Réservation d'une citadine pour 3 heures
5. Le bénéficiaire récupère le véhicule et se rend à son entretien
6. Restitution du véhicule
### Scénario 2 : Formation professionnelle récurrente
1. Un bénéficiaire suit une formation 2 jours par semaine pendant 3 mois
2. Le référent crée des réservations pour tous les mardis et jeudis de la période
3. Le bénéficiaire utilise le même véhicule chaque semaine
4. Suivi de l'utilisation et bilan en fin de formation
### Scénario 3 : Déménagement
1. Un bénéficiaire doit déménager dans un nouveau logement
2. Le référent réserve un utilitaire pour un samedi complet
3. Vérification du permis et des documents
4. Le bénéficiaire effectue son déménagement avec l'aide de proches
5. Restitution et vérification de l'état du véhicule
### Scénario 4 : Indisponibilité imprévue
1. Une réservation est confirmée pour le lendemain
2. Le véhicule tombe en panne la veille
3. Le référent identifie un véhicule alternatif similaire et disponible
4. Le référent contacte le bénéficiaire et lui propose le véhicule alternatif
5. Modification de la réservation
6. Planification de la maintenance du véhicule en panne
## Bonnes pratiques
### Gestion de la flotte
- Planifier les maintenances préventives (révisions, contrôles techniques)
- Tenir un carnet d'entretien à jour pour chaque véhicule
- Renouveler les véhicules vieillissants ou peu fiables
- Adapter la flotte aux besoins réels (types de véhicules les plus demandés)
### Gestion des réservations
- Vérifier systématiquement les documents obligatoires avant validation
- Réaliser des états des lieux détaillés au départ et au retour
- Former les bénéficiaires à l'utilisation des véhicules
- Prévoir des créneaux de nettoyage entre deux réservations
### Gestion des dommages
- Documenter précisément les dommages avec photos
- Définir une politique claire de gestion des dommages
- Accompagner les bénéficiaires en cas de sinistre
### Assurance et responsabilité
- Souscrire une assurance flotte adaptée
- Vérifier la couverture en cas de conducteur occasionnel
- Former les bénéficiaires aux règles d'usage
- Établir un contrat de location clair avec responsabilités définies
## Indicateurs de suivi
### Indicateurs d'activité
- Nombre de réservations par mois
- Taux d'occupation de la flotte (% du temps réservé)
- Durée moyenne des réservations
- Nombre de bénéficiaires utilisateurs
- Taux de fidélisation (bénéficiaires ayant réservé plusieurs fois)
### Indicateurs opérationnels
- Nombre de véhicules dans la flotte
- Nombre de véhicules disponibles vs en maintenance
- Taux d'annulation des réservations
- Répartition des réservations par type de véhicule
### Indicateurs sociaux
- Nombre de bénéficiaires ayant accédé à un emploi grâce au véhicule
- Types d'usage principaux (emploi, formation, santé, démarches, etc.)
- Profil des utilisateurs (âge, situation)
> **Note (TODO)** : Les indicateurs de qualité suivants sont prévus mais non encore implémentés :
> - Taux de dommages constatés
> - Délai moyen de maintenance
> - Taux de satisfaction des bénéficiaires
> - Nombre de pannes ou incidents
> - Coûts d'exploitation et rentabilité
## Intégration avec les autres modules
Le module Gestion de Véhicules s'intègre avec :
### Module Bénéficiaires
- Accès direct à la recherche de véhicules depuis la fiche bénéficiaire
- Historique des réservations dans l'onglet Véhicules de la fiche bénéficiaire
- Gestion des documents obligatoires (permis) dans la fiche bénéficiaire
### Recherche d'itinéraires
- Les véhicules disponibles apparaissent dans les résultats de recherche
- Proposition de solution "véhicule en autopartage" lors d'une recherche
## Comparaison avec d'autres solutions de mobilité
| Critère | Autopartage solidaire | Transport solidaire | Covoiturage solidaire |
|---------|---------------------|--------------------|--------------------|
| **Autonomie** | Totale | Accompagné | Partagé |
| **Flexibilité** | Maximale | Limitée | Moyenne |
| **Prérequis** | Permis de conduire | Aucun | Aucun |
| **Usage** | Ponctuel ou régulier | Ponctuel | Régulier |
L'autopartage solidaire complète parfaitement les autres solutions de mobilité en offrant de l'autonomie aux bénéficiaires détenteurs du permis de conduire.

View File

@ -0,0 +1,268 @@
# Module Transport Solidaire
## Vue d'ensemble
Le module **Transport Solidaire** permet de gérer un réseau de conducteurs bénévoles qui proposent des trajets gratuits ou à faible coût aux bénéficiaires de la structure. Il s'agit d'un dispositif d'accompagnement à la mobilité basé sur la solidarité et l'entraide.
## Concept et cas d'usage
### Principe de fonctionnement
Des conducteurs bénévoles s'inscrivent pour proposer des trajets ponctuels aux bénéficiaires. Les référents sociaux créent des réservations en mettant en relation un conducteur disponible et un bénéficiaire ayant un besoin de mobilité.
### Exemples de trajets
- Rendez-vous médicaux
- Entretiens d'embauche
- Démarches administratives
- Formations professionnelles
- Courses et achats essentiels
### Différence avec le covoiturage solidaire
Le transport solidaire se distingue du covoiturage solidaire par :
- **Trajets ponctuels** (vs trajets réguliers récurrents)
- **Demande à la demande** (vs planification régulière)
- **Conducteurs disponibles selon leurs créneaux** (vs engagements réguliers)
## Fonctionnalités principales
### 1. Gestion des conducteurs solidaires
#### Fiche conducteur
Chaque conducteur dispose d'une fiche complète avec :
- **Informations personnelles** : nom, prénom, email, téléphone, date de naissance, genre
- **Adresse du conducteur** : lieu de résidence (utilisé pour les filtres géographiques)
- **Numéro de dossier** : identifiant interne
- **Champs personnalisables** configurés dans l'application :
- Date de dernière adhésion
- Type d'indemnisation (km, déduction fiscale, bénévolat)
- Commentaires libres
#### Liste des conducteurs
- Vue d'ensemble de tous les conducteurs
- **Filtres disponibles** :
- Filtre par zone géographique (adresse du conducteur)
- Affichage des conducteurs archivés
- **Actions** :
- Création d'un nouveau conducteur
- Modification d'un conducteur existant
- Archivage d'un conducteur inactif
- Export Excel de la liste
#### Export Excel des conducteurs
L'export inclut toutes les informations des conducteurs :
- Identifiant
- Informations personnelles complètes
- Tous les champs optionnels configurés
- Adresse
- Statut archivé
- Respect des filtres actifs (géographie, archivage)
### 2. Gestion des disponibilités
Les conducteurs peuvent indiquer leurs créneaux de disponibilité pour faciliter la planification des trajets par les référents.
### 3. Création et suivi des réservations
#### Création d'une réservation
Le référent social crée une réservation en indiquant :
- **Bénéficiaire** : personne à transporter
- **Conducteur** : bénévole qui effectuera le trajet
- **Motif** : raison du déplacement
- **Date et heure de prise en charge**
- **Lieu de départ** : adresse de prise en charge du bénéficiaire
- **Destination** : adresse de dépose du bénéficiaire
- **Trajet conducteur** :
- Lieu de départ du conducteur
- Lieu d'arrivée du conducteur (si différent)
- **Détails du trajet** :
- Distance passager
- Distance totale conducteur (aller + retour)
- Durée estimée
- Aller simple ou aller-retour
#### Tarification et compensation
- **Prix passager** : montant demandé au bénéficiaire (peut être nul ou symbolique)
- **Compensation conducteur** : montant versé au conducteur pour couvrir ses frais
- Configuration du barème de compensation (indemnisation kilométrique)
#### États d'une réservation
- **En attente** : réservation créée, en attente de confirmation
- **Confirmée** : trajet validé par le conducteur
- **Effectuée** : trajet réalisé
- **Annulée** : trajet annulé avec raison d'annulation
#### Filtres sur les réservations en cours
- **Statut** : filtrer par état de la réservation
- **Conducteur** : voir les réservations d'un conducteur spécifique
- **Période** : date de début et date de fin
- **Zones géographiques** :
- Lieu de départ du trajet
- Destination du trajet
- Adresse du bénéficiaire
#### Historique des réservations
- Consultation des réservations passées
- Mêmes filtres que pour les réservations en cours
- Export Excel avec tous les détails
### 4. Export Excel des réservations
L'export des réservations inclut :
- Informations de la réservation (ID, statut, motif, date)
- Informations du conducteur (nom, prénom, contact, champs personnalisés)
- Informations du bénéficiaire (nom, prénom, contact, champs personnalisés)
- Détails du trajet (adresses avec coordonnées GPS, distances, durée)
- Tarification (prix passager, compensation conducteur, devises)
- Informations sur l'aller-retour
- Adresses de départ et arrivée du conducteur
### 5. Fiche détaillée du conducteur
Accessible en cliquant sur un conducteur, elle affiche :
- Toutes les informations du profil
- **Onglet Trajets** : liste des réservations du conducteur
- **Onglet Documents** : documents du conducteur (permis, assurance, etc.)
- **Onglet Statistiques** :
- Nombre total de trajets effectués
- Distance totale parcourue
- Montant total des compensations
- **Portefeuille** : suivi des compensations versées
### 6. Gestion documentaire
Pour chaque conducteur, possibilité d'associer des documents :
- Permis de conduire
- Carte grise du véhicule
- Attestation d'assurance
- Casier judiciaire (si requis)
- Documents personnalisés selon la configuration
## Configuration du module
### Champs personnalisables
Dans le fichier de configuration, il est possible d'ajouter des champs supplémentaires au profil conducteur :
```yaml
modules:
solidarity_transport:
drivers:
profile_optional_fields:
- name: gender
label: Genre
type: select
options:
- value: "0"
label: Inconnu
- value: "1"
label: Masculin
- value: "2"
label: Féminin
- value: "9"
label: Sans objet
- name: last_subscription_date
label: Date de dernière adhésion
type: date
- name: indemnisation
label: Indemnisation
type: multicheckbox
options:
- value: indemnisation_km
label: Indemnisation au km
- value: deduction_fiscale
label: Déduction fiscale
- value: pas_indemnisation
label: Pas d'indemnisation
- name: comment
label: Commentaire
type: textarea
```
### Types de champs disponibles
- `text` : champ texte simple
- `textarea` : texte long
- `date` : sélecteur de date
- `select` : liste déroulante
- `multicheckbox` : cases à cocher multiples
### Filtres géographiques
Configuration des zones géographiques pour filtrer les conducteurs et les trajets :
```yaml
geography:
filters:
enabled: true
geographies:
- layer: "epci"
code: "246300701"
- layer: "epci"
code: "200070753"
```
## Cas d'usage détaillés
### Scénario 1 : Rendez-vous médical
1. Un bénéficiaire doit se rendre à un rendez-vous médical
2. Le référent consulte la liste des conducteurs disponibles
3. Le référent crée une réservation en renseignant :
- Motif : "Rendez-vous médical"
- Date et heure du rendez-vous
- Adresse du cabinet médical
4. Le conducteur est notifié et confirme sa disponibilité
5. Le trajet est effectué
6. Le conducteur reçoit une compensation selon le barème
### Scénario 2 : Entretien d'embauche
1. Un bénéficiaire a un entretien d'embauche
2. Le référent filtre les conducteurs par zone géographique pour trouver un conducteur proche
3. Création de la réservation avec aller-retour (attente du conducteur pendant l'entretien)
4. Compensation calculée sur la distance totale aller-retour
### Scénario 3 : Analyse statistique
1. L'administrateur souhaite analyser l'activité
2. Export Excel des réservations sur une période donnée
3. Analyse des données :
- Nombre de trajets par conducteur
- Zones géographiques les plus demandées
- Types de motifs les plus fréquents
- Montant total des compensations versées
## Bonnes pratiques
### Gestion des conducteurs
- Vérifier régulièrement la validité des documents (permis, assurance)
- Organiser des temps de convivialité pour fidéliser les bénévoles
- Mettre à jour les disponibilités régulièrement
- Archiver les conducteurs inactifs plutôt que de les supprimer
### Gestion des réservations
- Confirmer les trajets avec les conducteurs et bénéficiaires
- Renseigner précisément les adresses pour faciliter le trajet
- Indiquer le motif pour contextualiser le besoin
- Gérer rapidement les annulations
### Compensation
- Définir un barème clair et transparent
- Tracer tous les versements dans le portefeuille
- Prévoir un budget annuel dédié aux compensations
### Reporting
- Exporter régulièrement les données pour le suivi d'activité
- Analyser les motifs de déplacements pour adapter l'offre
- Identifier les conducteurs les plus actifs pour les valoriser
## Indicateurs de suivi
Indicateurs recommandés à suivre :
- Nombre de conducteurs actifs (ayant fait au moins un trajet sur la période)
- Nombre de trajets effectués par mois
- Taux d'annulation des réservations
- Distance moyenne des trajets
- Montant moyen de compensation par trajet
- Nombre de bénéficiaires différents transportés
- Répartition géographique des trajets