Extension Review Directus

Une extension custom qui automatise la demande d'avis clients et génère la synthèse par IA, jusqu'à la publication Google.

Type
Extension backend custom
Stack Technique
Directus
Nuxt
Claude (Anthropic)
Mailgun

Contexte & Enjeux

L'objectif était de simplifier le processus de demande d'avis après une collaboration, en réduisant au maximum les étapes nécessaires pour qu'un client publie un avis Google. Le module est actuellement utilisé en interne chez Gintlemen.

J'ai géré la totalité du projet, avec pour seul cadrage un document d'objectifs plutôt qu'un cahier des charges complet ainsi que d'une aide visuelle ponctuelle pour la conception du formulaire. La supervision reçue s'est limitée à la validation finale.

Frontend

  1. 01.

    Email de demande d'avis avec lien à token, expirant après 30 jours, vérifié via middleware vers un endpoint Directus dédié.

  2. 02.

    Formulaire client en 7 étapes : questions obligatoires, notation 5 étoiles sur 3 critères, écran de relecture avant envoi, protection reCAPTCHA.

  3. 03.

    Si la moyenne atteint 4/5 ou plus, une synthèse d'avis modifiable est générée via une route serveur Nuxt, avec bouton "Écrire un avis sur Google" et copie en un clic pour minimiser les étapes du client.

  4. 04.

    Génération de texte via Claude Haiku (Anthropic), avec prompt de cadrage basé sur les réponses du client.

Backend / Directus

  1. 01.

    Hook déclenché à la création d'une fiche client : génération d'un token via randomUUID, expiration à +30 jours, envoi automatique de l'email via Mailgun.

  2. 02.

    Endpoint de vérification d'expiration du token, endpoint de mise à jour de la fiche client (statut soumis, réponses, notation, date).

  3. 03.

    Flux Directus déclenché à la mise à jour d'une fiche client, envoyant une notification interne dès qu'un avis est complété.

Captures du projet

Le défi
Gérer la sauvegarde fiable des réponses d'un formulaire multi-étapes complexe, tout en orchestrant la génération d'un avis cohérent par IA à partir de réponses textuelles variables.
Résultat
Les demandes d'avis sont désormais automatisées et centralisées dans Directus, sans relance manuelle ni gestion d'emails côté administrateur. Le client bénéficie d'un parcours rapide et guidé jusqu'à la publication de son avis sur Google.
main*0 ↓ 1 ↑
UTF-8Vue.js / Nuxt 4