Le manuel
Le parcours

Comment ça marche

Le parcours client de bout en bout : qui fait quoi, les robots, les humains, les validations.

4 sections

Le principe d'architecture, à retenir

La base Supabase est la seule source de vérité. L'admin et le portail lisent et écrivent l'état en base ; ils n'appellent jamais n8n directement.

n8n est déclenché par la base. Des Database Webhooks Supabase notifient n8n à chaque changement d'état significatif (décision de checkpoint, soumission d'onboarding). n8n exécute, écrit son résultat en base, et l'admin l'affiche.

Chaque exécution est tracée. Les workflows écrivent dans workflow_runs (succès) et error_log (échecs, nœud par nœud) — c'est ce que montre la page Automatisation de l'admin.

Le parcours client

Étape Ce qui se passe Les robots L'humain
1 · Lead Un restaurateur remplit le formulaire de la landing DV-03 crée sa fiche, DV-07 rédige son audit vitrine (QA inclus) Relire l'audit, compléter, l'envoyer
2 · Signature Le lead accepte : contrat + procuration en ligne, puis paiement Le paiement vérifié déclenche l'e-mail d'onboarding tout seul Envoyer le lien de signature (WhatsApp)
3 · Onboarding Le client remplit le formulaire de 30 questions DV-05 notifie l'équipe ; relances automatiques s'il traîne ; lecture du menu, des photos et des couleurs du logo par le cron Récupérer les exports Talabat et les déposer sur la fiche client
4 · Audit & plan Ses données Talabat sont analysées, le plan de menu (CDC) est proposé DV-08 calcule et rédige, DV-09 génère le CDC — chacun contre-lu par un QA Relire, envoyer, traiter les retours client
5 · Photos et style Le client associe ses photos à ses plats, puis choisit son style photo entre deux rendus de son plat vedette Le cron génère les deux options et envoie l'e-mail d'étape Contrôler le mapping, lancer les deux styles, puis lancer la production
6 · Production Ses photos deviennent des visuels professionnels ; puis il choisit sa bannière entre deux styles Le moteur v4 rend chaque plat dans son style, contrôle par QA vision ; DV-12 écrit les textes menu ; le client voit sa jauge avancer Juger les images au gate
7 · Livraison Le menu transformé est mis en ligne, plateforme par plateforme Pack, mise en ligne, conformité calculée Publier, vérifier le feu vert
8 · Suivi Chaque mois, rapport et bannière pour les abonnés DV-11 calcule, rédige et envoie ; relances automatiques Importer les exports du mois

Le registre complet des maillons n8n (DV-01 → DV-12), avec liens vers l'éditeur, vit sur la page Automatisation de l'admin — une seule liste, tenue à jour avec le journal.

Les checkpoints

Un checkpoint est une décision humaine enregistrée en base (table checkpoints, historique dans checkpoint_decisions). Chaque décision déclenche automatiquement DV-01 par le Database Webhook.

  • talabat_files_complete — créé par l'équipe (bouton « Marquer les exports Talabat comme complets » sur la fiche) ; effet : l'audit de performance peut être généré.
  • cdc_client — créé par le client en approuvant son plan de menu sur le portail (prix, signature) ; effet : l'équipe vérifie les commentaires puis valide.
  • cdc_admin — créé automatiquement à l'envoi du lien au client ; trace la validation interne du contenu.
  • photos_mapping_client — créé par le client quand il a associé ses photos ; effet : l'équipe est prévenue, contrôle, et lance les deux styles photo.
  • style_client puis banniere_client — les deux choix de style du client (voir « Le style choisi par le client »).
  • production_launch — créé par l'équipe (« Lancer la production ») ; le client passe en production.

Que deviennent les commentaires du client ?

  1. Le client les saisit section par section sur son lien de plan de menu — ils arrivent en base (cdc_comments) avec sa validation.
  2. Ils remontent à trois endroits : le panneau « Commentaires clients à traiter » du tableau de bord, la colonne « Commentaires » de la liste des CDC, et la section détaillée de chaque fiche.
  3. L'équipe ajuste le plan (prix, plats, leviers) puis marque chaque commentaire « traité ». Si les changements sont significatifs, un nouveau lien peut être renvoyé au client.
  4. Garde-fou : « Lancer la production » vérifie qu'il ne reste aucun commentaire non traité — sinon il demande une confirmation explicite.
Dans la même famille