Le manuel
Aide

Technique

Le modèle de données, les conventions, les liens.

4 sections

Modèle de données

  • leads — le funnel avant signature (formulaire de la landing).
  • clients — un restaurant sous contrat, avec son statut de parcours.
  • onboarding_responses — les réponses du formulaire d'onboarding (portail).
  • menu_items — la carte du client, plat par plat (prix actuels, proposés, approuvés).
  • cross_sell_offers — combos, compléments et montées en gamme proposés dans le plan.
  • documents — chaque document (audit gratuit, audit complet, plan de menu, PV) : données structurées et instantané HTML.
  • cdc_comments — commentaires du client par section, avec résolution.
  • checkpoints et checkpoint_decisions — les validations humaines et leur historique.
  • client_access_tokens — les liens personnels du portail.
  • visuels_produits — chaque visuel généré : prompt, modèle, statut au gate, QA, sources.
  • packaging_familles — les contenants du client, et ceux de la bibliothèque maison (client_id vide).
  • process_config — la politique manuel/auto de chaque étape (page Configuration + cron auto-gates).
  • workflow_runs et error_log — l'instrumentation des workflows n8n.

Source de vérité du schéma : packages/shared/src/schema.ts (Drizzle). Toute évolution passe par db:generate puis une migration appliquée — jamais de SQL à la main.

Conventions importantes

  • Stockage privé uniquement. Trois buckets : client-uploads (fichiers déposés), documents (documents et visuels générés), internal (documents de l'agence et contenants maison). Jamais d'URL publique : des liens signés temporaires, des chemins par client.
  • Accès client par lien personnel ou compte maison. Chaque lien est un jeton expirable ; le compte de l'espace naît d'un lien possédé, jamais d'une inscription libre.
  • Politique d'envoi manuel/auto (process_config). Chaque étape démarre en manuel et se bascule en automatique sur la page Configuration ; le cron auto-gates applique la règle toutes les quinze minutes. Le plan de menu reste un gate bilatéral obligatoire.
  • E-mails via Resend. Expéditeur contact@delivup.io, notifications internes vers admin@delivup.io.
  • Rapporter en trois mots : une capacité est livrée (le code existe), prouvée (une sonde la mesure sur les données réelles, visible sur /sante), ou démentie.

Documents internes de l'agence

Les fichiers juridiques, techniques, process et marketing vivent dans l'espace interne de l'admin (bucket internal, jamais purgé) : page Technique de l'admin, section « Documents internes ».

Liens

  • n8n — workflows (adresse dans la page Automatisation de l'admin).
  • Supabase — projet delivup-prod.
  • Portail client — https://portal.delivup.io
  • Dépôt — docs/planning/ pour les audits et décisions d'architecture complets.
Dans la même famille