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

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

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

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