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.checkpointsetcheckpoint_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_idvide).process_config— la politique manuel/auto de chaque étape (page Configuration + cron auto-gates).workflow_runseterror_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.