Premiers pas

Connexion, configuration API et démarrage rapide avec FleetyApp.

Sur cette pageAfficher

Accéder à l'application

En production : https://www.fleetyapp.com. En local : http://localhost:3292 (ou le port affiché par Vite).

  1. 1Configurez web/.env avec VITE_API_URL=http://localhost:3291
  2. 2Démarrez l'API Spring Boot (port 3291) puis le frontend
  3. 3Ouvrez /login si l'authentification utilisateur est activée (USER_AUTH_ENABLED=true)
  4. 4Sinon, utilisez /connect pour entrer la clé API si requise

Comptes de développement

E-mailMot de passeRôle
admin@trakcar.localadmin123Administrateur
user@trakcar.localuser123Opérateur
Ces comptes existent uniquement en profil dev (H2). Ne pas utiliser en production.

Assistant de démarrage

À la première connexion, un guide interactif propose les étapes clés : consulter la carte, créer une intervention, configurer le GPS et inviter des utilisateurs.

Enregistrer un boîtier GPS

  1. 1Paramètres → GPS : vérifiez que Traccar est connecté (badge vert)
  2. 2Saisissez le nom du véhicule et l'IMEI du boîtier GT06
  3. 3Configurez le boîtier : serveur = IP VPS, port = 5023, APN opérateur
  4. 4Attendez la première position — le véhicule apparaît sur /map sous 2-5 min
  5. 5Vérifiez dans Traccar UI (:3290) que le device est « En ligne »
Protocole supporté : GT06 sur port 5023. Autres protocoles selon configuration Traccar.

Variables d'environnement essentielles

VariableFichierDescription
VITE_API_URLweb/.envURL API — http://localhost:3291 en dev
CORS_ORIGINS.envOrigines frontend autorisées
USER_AUTH_ENABLED.env / trakcar.envActive le login JWT
JWT_SECRET.envSecret JWT (min. 32 caractères)
TRACCAR_URL.envURL serveur Traccar
TRACCAR_TOKENtrakcar.envToken admin Traccar
MAIL_FROMtrakcar.envsupport@fleetyapp.com en prod

Commandes de démarrage

Stack dev légère (API H2 + frontend, sans Traccar) :

  • ./scripts/start-dev.sh — API :3291 + Web :3292
  • cd trakcar-api && SPRING_PROFILES_ACTIVE=dev USER_AUTH_ENABLED=true JWT_SECRET=dev-local-jwt-secret-minimum-32-chars ./mvnw spring-boot:run
  • cd web && npm run dev
  • ./scripts/smoke-test-local.sh — vérifie les endpoints

Stack complète avec Traccar local : ./scripts/start-full-dev.sh

Checklist première semaine

  1. 1Jour 1 : connexion admin, tour du tableau de bord, lire cette documentation
  2. 2Jour 2 : enregistrer le premier boîtier GPS, vérifier la carte live
  3. 3Jour 3 : créer des interventions test, tester le Kanban et les ETA
  4. 4Jour 4 : créer les profils chauffeurs et lier les utilisateurs opérateurs
  5. 5Jour 5 : configurer une règle d'alerte et SMTP (MAIL_FROM=support@fleetyapp.com)
  6. 6Semaine 2 : premier export rapport PDF et livre de bord signé