Une application Web, une application mobile et un site Web personnalisés conçus et développés par Outsourcify.

Web App - Système de réservation : L'API

Le projet ComAdvisor sert d’interface de programmation d’applications (API) centralisée dans divers environnements, comprenant une interface d’administration, un widget, une application mobile et un système de création et de gestion de sites web, en plus d’un site web public. De plus amples détails sur chaque composant seront fournis ultérieurement. Notamment, cette API joue un rôle central en tant que plaque tournante pour deux marques distinctes : Bons Restaurants en France et Aroi Restaurants en Thaïlande, fonctionnant comme la force motrice qui unifie et synchronise ces deux entités.

Si l’on se penche sur l’histoire du projet, on constate que ComAdvisor existe depuis un certain temps. La version initiale de l’API a été développée par Outsourcify en 2018, et l’intégration de Reserve With Google a eu lieu en 2022. Durant cette période, le projet ComAdvisor comptait déjà un nombre important de restaurants, ce qui a nécessité un processus de migration. Le choix technologique s’étant initialement porté sur PHP et son framework Symfony, nous avons assuré la continuité en passant de Symfony 4 à la version Symfony 6.

Widget Restaurants Aroi et Réservez avec Google

Le système fournit aux restaurateurs deux outils efficaces pour rationaliser leurs opérations et améliorer la gestion du temps : un widget permettant aux clients de réserver une table en toute simplicité et le système Reserve with Google, qui permet de réserver directement via Google Maps. Le widget offre aux restaurateurs une flexibilité exceptionnelle, leur permettant de le placer stratégiquement – que ce soit dans des posts sur les médias sociaux avec un lien direct, sur leur site web en utilisant un système iFrame, ou en l’intégrant de manière transparente dans WordPress CMS avec un plugin téléchargeable pour un affichage facile sur les pages du site.

Que ce soit en utilisant le widget ou la réserve avec Google, nous permettons aux restaurateurs d’organiser efficacement leurs horaires d’ouverture par salle et par service, améliorant ainsi la navigation des clients. Une autre fonctionnalité du widget est axée sur les commentaires ; un jour après leur repas, les clients reçoivent un courriel contenant un lien leur permettant de partager leur opinion, et ces commentaires peuvent être affichés de manière visible à l’aide du widget. Le développement de l’interface du widget a été réalisé à l’aide de VueJs.

Les notifications et les tâches d'automatisation

Lors du développement de cette plateforme, notre objectif principal était de simplifier au maximum le travail des restaurateurs. C’est pourquoi nous avons mis en place des systèmes de notification et d’automatisation.

Par exemple, lorsqu’un client effectue une réservation via le widget (ou Reserve with Google), le système envoie instantanément une notification sur l’application mobile, un courriel et un SMS au restaurateur pour l’informer de la nouvelle réservation. Le restaurateur utilise simplement l’application mobile pour approuver ou refuser la réservation, et peut également effectuer cette action en cliquant sur le lien fourni dans l’e-mail.

D’autres notifications sont également intégrées, comme les annulations de réservation.

Pour le confort du client, nous avons mis en place un système de courrier électronique qui l’informe de l’envoi de sa réservation et de l’approbation ou du refus de celle-ci par le restaurateur. En outre, le client reçoit un courriel quelques heures avant son repas pour lui rappeler les détails de sa réservation.

Nous avons également mis au point un système d’évaluation. Le lendemain de leur repas, les clients reçoivent un e-mail contenant un lien qui leur permet d’ajouter un commentaire et une note pour leur expérience de la veille.

D’autres automatisations plus techniques sont également intégrées grâce à l’utilisation de CronJobs. Il s’agit par exemple du processus de reconstruction des sites publics BonsRestaurants et Aroi Restaurants, ainsi que de l’exécution de tâches récurrentes nécessaires au bon fonctionnement de la Réserve avec le système Google.

La migration des données de la V1 vers la V2 et les redirections

Lors de la création d’un site web, ou même d’une plateforme comme celle-ci, une phase de migration est souvent inévitable. Il s’agit de transférer les données existantes vers le nouveau système. Dans le cas d’Aroi Restaurants, cette étape était essentielle, car Bons Restaurants existait depuis un certain temps en France, accumulant une grande quantité de données et d’images. Notre objectif était de rendre cette transition transparente.

Nous avons développé plusieurs scripts SQL pour assurer un processus optimal. La création de plusieurs bases de données et des simulations de mise en production ont été réalisées à plusieurs reprises pour s’assurer que nous étions prêts le jour J.

La migration des images a nécessité une approche différente. Comme le système précédent classait les images différemment, nous avons dû télécharger tous les fichiers sur nos ordinateurs et créer des scripts Python pour les réorganiser logiquement, conformément au nouveau système. Après plusieurs tests et analyses de données, nous avons pu migrer toutes les images sans problème.

La migration des données est une étape cruciale, mais la gestion des redirections l’est tout autant. Le passage de la version 1 à la version 2 pouvait potentiellement entraîner la rupture de certains liens, notamment ceux partagés via des widgets sur les réseaux sociaux ou directement sur les sites des clients. Pour anticiper cette situation, nous avons passé plusieurs heures à scraper le site existant et à analyser tous les liens pour créer toutes les redirections nécessaires. De plus, nous avons développé un script Python pour remplacer automatiquement les liens de l’ancienne base de données par ceux de la nouvelle.

Le jour J, nous avons dû bloquer tous les services de ComAdvisor pour sauvegarder les données et les fichiers, en exécutant une dernière fois tous nos scripts. Nous avons mis en place une page de maintenance pendant cette période. Une fois la migration terminée, nous avons vérifié les pages et les fonctionnalités pour nous assurer que la plateforme fonctionnait correctement.

Un WordPress Headless pour le blog

Le site web d’Aroi Restaurants propose à ses visiteurs un blog. Pour mettre en place ce blog de manière efficace et conviviale, nous avons choisi d’utiliser le CMS WordPress. Cependant, notre site web s’appuie sur la technologie Astro pour la génération des pages.

Pour concilier ces deux technologies, nous avons établi une connexion entre l’API REST de notre installation WordPress et notre API centrale. Cette dernière sert d’intermédiaire entre l’API REST de WordPress et notre site web Astro. L’utilisation de la seule API de WordPress peut s’avérer complexe en raison

au format des données. Par exemple, la réponse au message n’inclut pas directement l’URL des images en vedette, mais plutôt leur ID. Pour obtenir cette URL, un autre appel à l’API est nécessaire.

Notre API se charge donc de tous ces appels à l’API WordPress et renvoie les données au frontend dans le format le plus approprié.

Nous avons également développé un petit plugin WordPress pour lancer la commande de reconstruction sur notre serveur. Cette commande régénère les pages HTML d’Astro et met automatiquement à jour les données.