Ajoutez la Planification de Trajets à Votre Plateforme

Vue d'ensemble

Chaque niveau fonctionne de manière autonome. La plupart des partenaires commencent au Niveau 1 (Lancement en Un Clic) et ajoutent des niveaux supérieurs plus tard selon l'évolution de leurs besoins. Les sections suivantes décrivent ce que vivent vos utilisateurs finaux, ce que vous obtenez en tant qu'entreprise, la présentation complète des quatre niveaux et une analyse approfondie du Niveau 1. La section Détail Technique plus bas contient les spécifications d'ingénierie.

Ce Que Vivent Vos Utilisateurs

Au Niveau 1, Launch Pad agit comme une application complémentaire à votre produit. Il s'ouvre dans une nouvelle fenêtre du navigateur avec toute la configuration effectuée en arrière-plan, afin que l'utilisateur puisse commencer à travailler immédiatement.

Ce Que Vous Obtenez en Tant que Partenaire

Conçu pour les entreprises et les équipes d'ingénierie qui souhaitent intégrer le routage de précision sans avoir à monter l'infrastructure nécessaire pour le soutenir.

Quatre Niveaux d'Intégration

Chaque niveau fonctionne de manière autonome. La plupart des partenaires commencent au Niveau 1 et ajoutent des niveaux supérieurs plus tard selon l'évolution de leurs besoins.

Comment le Niveau 1 Supprime les Frictions

Pourquoi le Niveau 1 Existe

Modèle de Compte

Un engagement de Niveau 1 est organisé de la manière suivante :

Ce Que les Utilisateurs Voient dans Launch Pad

Lorsqu'un utilisateur ouvre Launch Pad via le Niveau 1, certaines options de Launch Pad ne s'appliquent pas et sont masquées :

• Pas de changement de mot de passe, pas de gestion d'e-mail ou de compte, pas d'inscription. L'utilisateur n'a pas de mot de passe Launch Pad ; la connexion provient de votre produit. L'écran de changement de mot de passe affiche un message "Mot de passe géré par [Partenaire]", de la même façon que Launch Pad gère déjà les utilisateurs qui se connectent via John Deere, Trimble ou CNH.
• Pas de sélecteur d'entreprise. La session est verrouillée sur une seule organisation client pour cette visite.
• La déconnexion est remplacée par "Retour à [Partenaire]", ce qui ferme l'onglet ou renvoie l'utilisateur vers une URL que vous fournissez, plutôt que de le laisser sur la page de connexion de Launch Pad.

Le menu de travail principal (Plans, Planification de Trajets, Équipements, Comparer) reste disponible car les utilisateurs en ont besoin pour effectuer le travail. Seules les options d'identité, de facturation, d'administration et de gestion de compte sont masquées.

Retour du Plan de Trajets

Une fois qu'un utilisateur a terminé un plan de trajets dans Launch Pad, le résultat doit revenir dans votre produit. Quatre options sont disponibles et fonctionnent quel que soit le niveau. Les options push sont fortement préférées au polling.

Flux de Bout en Bout

Ce qui se passe, étape par étape, lorsqu'un utilisateur partenaire ouvre Launch Pad :

sequenceDiagram
    autonumber
    participant YU as Interface Partenaire
    participant YB as Backend Partenaire
    participant LA as Launch Pad API
    participant LU as Launch Pad UI

    YU->>YB: l'utilisateur clique sur "Ouvrir Plan de Trajets"

    note over YB,LA: Étape 1 : créer l'utilisateur LP s'il n'existe pas
    YB->>LA: POST /api/users (idempotent sur externalUserId)
    YB->>LA: POST /api/company-accesses (idempotent sur utilisateur + org)

    note over YB,LA: Étape 2 (optionnel) : envoyer une parcelle
    YB->>LA: POST /api/vBoundary/upsert

    note over YB,LA: Étape 3 : demander un code de lancement
    YB->>LA: POST /api/partner/launch ({ userId, companyId, returnUrl })
    LA-->>YB: { code, expiresInSec: 600 }

    YB-->>YU: 302 redirige vers https://your-app.vergeag.com/launch?code=...
    YU->>LU: le navigateur navigue vers /launch?code=...
    LU->>LA: POST /api/partner/launch/{code}/exchange
    LA-->>LU: JWT + refresh token
    note over LU: stocke le JWT dans localStorage,
supprime le code de l'URL,
navigue vers returnUrl
          

Propriétés Clés

• Vous vous authentifiez de serveur à serveur avec un identifiant à longue durée de vie (la clé API de votre utilisateur administrateur). Le navigateur ne voit jamais la clé API.
• Le navigateur ne voit qu'un code opaque, à usage unique et à courte durée de vie dans l'URL (durée de vie de 10 minutes, consommé lors de l'échange).
• L'endpoint d'échange ne nécessite pas de connexion ; le code lui-même est le justificatif d'identité. L'interface de Launch Pad l'appelle dès que l'utilisateur arrive.
• Launch Pad émet une session utilisateur normale (JWT + refresh token), la stocke dans localStorage et achemine l'utilisateur vers l'URL que vous avez spécifiée.

Alignement avec les Standards

À Quoi Ressemble l'URL de Redirection

Ce que reçoit le navigateur de l'utilisateur (sur une ligne, en tant qu'en-tête Location:) :

https://your-app.vergeag.com/launch?code=lc_R3w9q-Kx7VtNm2bH8sLpYj4eQ6gZc1aXfU0dT5nMoP&returnUrl=%2Fpath-planning%2Fboundary%2Fb3f47e1c-8a02-4d59-9c6e-2f7a8b1d6e09

Décodée pour plus de lisibilité :

Ce Que Fait l'Interface de Launch Pad à l'Arrivée

Vous n'implémentez pas cela ; c'est fourni à titre de référence pour vous permettre de comprendre ce que voient vos utilisateurs entre le clic et la parcelle affichée :

1. Lit code et returnUrl depuis la chaîne de requête.
2. Échange le code avec Launch Pad contre une session utilisateur.
3. Connecte l'utilisateur à la bonne organisation client.
4. Supprime le code de la barre d'adresse pour qu'il ne reste pas dans l'historique du navigateur.
5. Envoie l'utilisateur vers le returnUrl que vous avez spécifié.

Si code est absent, expiré ou déjà utilisé, l'utilisateur arrive sur une page d'erreur lui demandant de retourner dans votre produit et de réessayer.

Options de Retour en Détail

Niveaux Supérieurs

Cette page est la référence complète pour le Niveau 1. Pour les niveaux supérieurs :