Aller au contenu principal

Livraison — intégration Livro

Statut : en cours (non finalisé)​

La livraison chez Tranoo est déléguée à un prestataire tiers : Livro. Ce système externe prendra en charge explicitement toute la logistique de livraison (prise en charge, tracking, statuts, etc.).

:::warning Hors périmètre documentation Les fonctionnalités de livraison internes historiques (livreurs Tranoo, routes /api/deliveries, /api/livreurs, workers, balance livreur…) existent encore dans le code backend mais ne font plus partie de la stratégie produit. Elles ne sont pas documentées ici et ne doivent pas être considérées comme la référence pour la livraison Tranoo. :::

Ce qui existe aujourd'hui​

Côté app Tranoo (acheteurs)​

ÉlémentEmplacementÉtat
Bouton « Commander avec livraison »tranoo/lib/data/screens/mastervacpage.dartUI présente (FAB avec logo Livro)
Flux commande_startDeliveryFlow() → panier → OrderSummaryPageEn transition vers Livro
Logo Livroassets/images/livro_logo.pngIntégré

Le bouton Livro ajoute l'article au panier et redirige vers le récapitulatif de commande. L'appel API direct à Livro n'est pas encore finalisé.

Variables d'environnement (Flutter)​

Définies dans tranoo/.env et tranoo/.env.prod :

VariableDescription
LIVRO_PUBLIC_KEYClé publique API Livro
LIVRO_SECRET_KEYClé secrète API Livro
LIVRO_BASE_URLURL base API (https://livro-plateforme.dihas.tech/api)
LIVRO_EXTERNAL_CLIENT_IDIdentifiant client externe Tranoo
LIVRO_EXTERNAL_CLIENT_NAMENom affiché côté Livro (Tranoo)

Côté backend (tranoo-api/src/)​

Aucune intégration Livro n'est présente dans l'API Express à ce jour. La communication avec Livro se fera depuis l'app mobile (ou via un futur proxy backend).

Architecture cible (prévue)​

┌──────────────┐         API Livro          ┌─────────────────┐
│  App Tranoo  │ ─────────────────────────► │  Livro (tiers)  │
│  (acheteur)  │   commande, tracking,    │  Logistique     │
└──────────────┘   statuts livraison       └─────────────────┘
       │
       │  paiement article, profil
       ▼
┌──────────────┐
│ API Tranoo   │  (hors livraison)
└──────────────┘

Tranoo conserve la gestion du catalogue, des commandes/achats et des paiements (FeexPay). Livro gère uniquement la livraison.

Ce qui n'est plus documenté​

Les éléments suivants du dépôt sont considérés comme legacy :

  • LIVRAISON_ARCHITECTURE.md, LIVRAISON_SUMMARY.md, DELIVERY_TESTS.md
  • tranoo_pro/LIVREUR_FEATURES.md, BACKEND_ET_DYNAMIQUE.md (partie livreur)
  • Routes /api/deliveries, /api/livreurs, /api/delivery-zones
  • Modèles Delivery, DeliveryZone, DeliverySettings, LivreurBalance
  • Rôle livreur dans Tranoo Pro (hors scope livraison Livro)

Prochaines étapes (intégration)​

  • Service Dart LivroService consommant LIVRO_BASE_URL
  • Création de commande livraison côté Livro depuis OrderSummaryPage
  • Webhooks ou polling statuts Livro → notifications Tranoo
  • Mise à jour doc utilisateur (suivi-livraison) pour refléter Livro
  • Décision : proxy backend ou appel direct depuis Flutter

Voir aussi​