Vue d'ensemble
Présentation de FleetyApp, architecture, parcours utilisateur et modules principaux.
Accès rapide
Les guides les plus consultés pour démarrer avec FleetyApp.
Sur cette pageAfficherMasquer
Qu'est-ce que FleetyApp ?
FleetyApp est la plateforme de gestion de flotte pensée pour les artisans du bâtiment, plombiers, électriciens, chauffagistes et PME de service. Elle centralise le suivi GPS, la planification des interventions, la preuve de passage client et la conformité réglementaire (livre de bord).
- Tableau de bord temps réel : véhicules, interventions, alertes, KPIs
- Carte live OpenStreetMap avec géofences chantier et rejeu de trajets
- Kanban interventions : planifié → en cours → terminé, avec preuves GPS
- Feuille de route optimisable et planning chauffeurs jour/semaine
- Rapports PDF, livre de bord signé, exports CSV et envoi e-mail automatique
- Portail client public sans connexion pour suivre l'arrivée du technicien
Architecture technique
FleetyApp repose sur trois composants : le frontend React (web/), l'API métier Spring Boot (trakcar-api/) et le serveur GPS Traccar. Les données métier (interventions, chauffeurs, rapports) sont stockées en PostgreSQL ; les positions GPS transitent par Traccar.
| Composant | Port | Rôle |
|---|---|---|
| Frontend FleetyApp | 3293 (VPS) / 3292 (dev) | Interface utilisateur (React + Vite) |
| API trakcar-api | 3291 | REST, WebSocket, auth JWT, rapports |
| Traccar | 3290 | Serveur GPS, UI admin, protocole GT06 :5023 |
| PostgreSQL | 5432 | Base Traccar + tables métier trakcar_* |
Parcours utilisateur typiques
Voici les scénarios les plus courants dans FleetyApp :
- 1Matin : consulter le tableau de bord → vérifier la feuille de route → envoyer les ETA clients
- 2Terrain : avancer les interventions au fil de la journée → preuve GPS automatique à l'arrivée
- 3Admin : analyser les rapports hebdo → exporter le livre de bord → ajuster le planning équipe
- 4Client final : ouvrir le lien /share/job?job=INT-xxx → suivre le technicien en direct sur la carte
Modules de l'application
| Module | URL | Description |
|---|---|---|
| Tableau de bord | / | KPIs, carte miniature, activité, onboarding |
| Véhicules | /vehicles | Parc, statut live, export CSV, commandes à distance |
| Interventions | /interventions | Kanban, création, ETA, preuves, partage client |
| Récurrentes | /recurring | Modèles hebdo/mensuels, génération auto |
| Feuille de route | /routes | Tournée du jour, distance, optimisation |
| Carte live | /map | Positions WS, géofences, replay trajet |
| Alertes | /alerts | Règles, résolution, historique notifications |
| Insights | /insights | Recommandations flotte, score sécurité chauffeurs |
| Maintenance | /maintenance | Santé véhicules, carburant, priorités |
| Trajets | /trips | Historique 7/30/90j, lien replay carte |
| Équipe | /team | Planning DnD, chauffeurs, disponibilités |
| Rapports | /reports | PDF, livre de bord, CSV, e-mail (admin) |
| Paramètres | /settings | Profil, GPS, notifications, utilisateurs |
Modes d'authentification
FleetyApp supporte trois modes d'accès, configurables côté API :
- Mode démo : sans VITE_API_URL — données fictives, pas de login requis
- Clé API : page /connect — accès admin complet via X-API-Key
- JWT utilisateur : page /login — rôles admin ou opérateur (USER_AUTH_ENABLED=true)
Mode démo vs mode connecté
Sans VITE_API_URL dans web/.env, l'application affiche des données simulées (véhicules, interventions, alertes). Idéal pour découvrir l'interface sans infrastructure.
Avec l'API connectée, toutes les données proviennent de PostgreSQL et Traccar. Le bandeau « Mode démo » disparaît et les actions (création intervention, export PDF) deviennent réelles.