Roi Cargo : construire une plateforme de fret international en trois briques connectées
Comment j'ai conçu le site vitrine, le back-office et l'application mobile de Roi Cargo, avec une seule API commune, pour SAGESPRIT SARL.
Roi Cargo est une plateforme de fret entre la Chine et l'Afrique, pour le compte de SAGESPRIT SARL. Le cahier des charges tenait en une phrase : un client doit pouvoir suivre son colis, payer en ligne et discuter avec l'équipe, pendant que l'équipe interne gère les dossiers depuis son propre espace. Trois publics, trois interfaces, une seule vérité.
Une API centrale, trois façades
Plutôt que de dupliquer la logique métier, j'ai construit une API REST unique en Symfony, avec une authentification JWT partagée. Le site public (Symfony, Twig) sert la vitrine et un calculateur de fret pensé pour le référencement. Le back-office, en React, donne à l'équipe SAGESPRIT une vue complète sur les dossiers et les expéditions. L'application mobile, en Flutter, est l'espace du client final : suivi en temps réel, paiement, messagerie.
Le temps réel, sans réinventer la roue
Le suivi de colis et la messagerie s'appuient sur Ably plutôt que sur une solution maison. Pour un projet de cette taille, c'est un choix pragmatique : la fiabilité du temps réel est déléguée à un service dont c'est le métier, et l'équipe garde son énergie pour la logique propre à Roi Cargo.
Ce que j'en retiens
Le vrai défi n'était pas technique mais organisationnel : faire tenir ensemble trois équipes de développement (web, back-office, mobile) sur des contrats d'API stables, pour qu'un changement d'un côté ne casse rien de l'autre. C'est ce genre de structuration, autant que le code lui-même, qui fait la différence sur un projet à plusieurs interfaces.