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_clientpuisbanniere_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 ?
- Le client les saisit section par section sur son lien de plan de menu — ils arrivent en base (
cdc_comments) avec sa validation. - 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.
- 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.
- Garde-fou : « Lancer la production » vérifie qu'il ne reste aucun commentaire non traité — sinon il demande une confirmation explicite.