Récapitulatif du mois de juin 2024

Publié le 1 juillet 2024

En juin, nous avons priorisé le travail à faire pour sortir notre premier service : Dédale. Nous avons créé une documentation, mis à jour le site, et intégré la gestion des utilisateurs en connectant le produit à notre plateforme centralisée : Heimdall.

Récapitulatif du travail effectué au cours du mois de juin 2024

Fin de développement pour la sortie du projet Dédale

Au cours du mois de juin nous avons finalisé et préparé la sortie du projet Dédale : l'éditeur en ligne pour aider les développeurs à créer leurs modèles d'e-mails dans leur navigateur.

Nous avons concentré nos efforts pour perfectionner l'outil, résoudre les bugs résiduels et préparer tous les à-côtés comme :

• une première version de la documentation,
• la landing page¹,
• la mise en place d'une liste d'attente,
• la communication à avoir et les canaux à activer pour partager notre travail.

Pour en savoir davantage à propos de Dédale vous pouvez lire notre récapitulatif du mois dernier, ou accéder à la landing page.

Travail lié à la conception et au développement produit

Focus produit du mois : Dédale

Les tâches produits accomplies durant le mois

Mise à jour du site bireme.io :

• Ajout de la landing page dédiée à Dédale
• Refonte légère de l'interface (page d'accueil, page "article")
• Mise à jour des politiques de confidentialité

Création de la documentation :

• Création des visuels pour illustrer les éléments de documentation

UX/UI :

• Élements de conversion pour inciter les utilisateurs à créer un compte
• Tests et mises à jour du design de l'interface :
  • retouches des tailles de police,
  • retouches des couleurs,
  • modification du style à appliquer en fonction des intéractions de l'utilisateur.

Annexes :

• Création des modèles d'e-mails pour la communication transactionnelle avec l'inscription en liste d'attente sur Dédale
• Configuration des automatisations pour la liste d'attente sur Dédale

Focus sur : la création de notre documentation

Pour simplifier la compréhension et l'usage de Dédale nous avons décidé d'accompagner la sortie du produit d'une documentation.

Nous avons pensé cette documentation comme une grande place ou trouver toutes les informations concernant chaque produit de l'écosystème Bireme Lab ainsi que des ressources utiles comme :

• Notre roadmap,
• Un changelog par produit,
• Des foires aux questions.

Dans le cadre de Dédale nous avons créé une section entière pour fournir un maximum d'informations et aider les utilisateurs à :

• comprendre l'interface,
• avoir un aperçu du concept et une explication détaillée de chaque fonctionnalité,
• une liste de cas d'usages pour lesquels un modèle d'e-mail peut-être pertinent,
• toutes les étapes nécessaires pour comprendre et utiliser Dédale (créer un modèle, éditer le code, utiliser le système de variables etc.)

La documentation est disponible, en anglais, à l'adresse suivante : docs.bireme.io

Technologie utilisée pour créer notre documentation

Pour développer notre documentation nous avons utilisé le service sur abonnement Mintlify qui permet d'obtenir rapidement un rendu professionnel et beau avec une expérience utilisateur optimale.

Nous avons découvert ce service grâce aux entreprises du réseau Y Combinator que nous suivons sur les réseaux sociaux.

Voici un premier retour d'expérience sur l'usage de Mintlify :

Points positifs :

• rapide à mettre en place,
• un résultat visuel de qualité out of the box,
• un plan gratuit généreux.

Points négatifs :

• les plans payants sont rapidement couteux,
• pas de gestion intégrée des traductions,
• impossibilité de stocker le code sur une organisation Github sans un plan payant pour faciliter la collaboration.

Certains points négatifs sont bloquant pour nous comme l'absence de gestion des traductions et nous avons longuement envisagé de créer une seconde documentation pour traduire en français et traiter les contraintes techniques SEO avec du bricolage maison (comme la génération d'un sitemap sur un sous-domaine distinct pour y intégrer les informations hreflang, par exemple).

Nous avons hésité à utiliser Docusaurus mais nous avons finalement préféré la rapidité de mise en place avec Mintlify pour se concentrer sur le contenu.

Travail de développement

Focus tech du mois : Dédale

Les tâches tech accomplies durant le mois

• Mise en place de l'authentification sur Dédale
• Stockage des modèles d'e-mail sur le serveur
• Mise en place du déploiement continue
• Traduction de nos applications en anglais
• Amélioration de l'interface de connexion
• Creation d'un générateur de variable pour prévisualiser les modèles d'e-mails
• Possibilité d'exporter un modèle au format HTML
• Ajout d'un bouton pour envoyer un e-mail de test avec Resend

Focus sur : notre méthode pour authentifier les utilisateurs sur nos applications

Dans notre premier récapitulatif du mois de Mars, nous vous présentions Heimdall, notre application de gestion des utilisateurs et socle commun pour nos futures applications.

Pour rappel, les fonctionalités d'Heimdall sont :

• l'authentification des utilisateurs,
• la gestion des membres,
• la gestion des équipes,
• la gestion des souscriptions et des paramètres de facturation.

Le tout est rendu disponible :

• avec une interface graphique accessible à l'adresse heimdall.bireme.io. Elle permet aux utilisateurs de gérer facilement les membres de leurs équipes avec leurs authorisations,
• avec une API GraphQL permettant à toutes nos applications :
  • d'authentifier les requêtes des utilisateurs,
  • vérifier les fonctionalités accessible pour chaque utilisateur (en se basant sur ses souscriptions et ses droits).

Éviter de reproduire le travail effectué sur notre plateforme de gestion d'utilisateurs pour chaque produit

Avec la création d'Heimdall, nous avions pour ambition de centraliser la gestion et l'authentification des utilisateurs pour obtenir les avantages suivants :

• nous n'avons qu'une seule base de code à maintenir pour gérer la connexion des utilisateurs, nous permettant de créer de nouveaux produits nécessitant une authentification plus rapidement,
• nous pouvons interconnecter nos différentes applications de façon invisible, à l'instar d'un Google qui permet d'automatiquement ajouter un événement dans Agenda quand on accepte une invitation dans Gmail.
• un seul processus d'authentification pour utiliser toutes nos applications sans avoir à se connecter à nouveau, ce qui garantie une expérience utilisateur fluide et agréable.

À partir de ce postula, plutôt que de développer une nouvelle page de connexion pour Dédale, nous avons décider de rediriger l'utilisateur vers notre plateforme d'authentification.

Comment notre plateforme authentifie nos utilisateurs sur nos produits ?

Lorsqu'un utilisateur souhaite créer un compte ou se connecter, il est redirigé vers heimdall.bireme.io/signin?from_app=dedale&redirect_to={{ app_url }}.

• la partie ?from_app=dedale nous permet d'afficher une page de connexion personalisée.
• et redirect_to={{ app_url }} permet d'automatiquement rediriger l'utilisateur vers Dédale une fois qu'il s'est connecté.

Une fois que l'utilisateur est connecté, on enregistre un cookie² contenant les informations de connexion de l'utilisateur. Ce dernier est accessible pour tous les sous-domaines .bireme.io.

Par exemple, un cookie enregistré depuis heimdall.bireme.io est accessible depuis chacune des applications disponibles aux sous-domaines *.bireme.io (app1.bireme.io, app2.bireme.io etc.).

Une fois le token d'authentification enregistré, les requêtes de l'utilisateur peuvent être authentifié par nos serveurs, ce qui lui permet de récupérer ses modèles d'e-mails.

¹ : Une landing page est une page web conçue pour convertir les visiteurs en clients. Utilisée dans les campagnes marketing, elle incite à des actions précises comme remplir un formulaire ou effectuer un achat. Elle se concentre sur un seul objectif avec des éléments comme des appels à l'action et des témoignages.
² : Un cookie est un petit morceau de données envoyé par un site web et sauvegardé dans le navigateur de l'utilisateur. Il permet au site de se souvenir d'informations comme les préférences de langue ou les informations de connexion.