Passer au contenu principal
La couche de configuration d’une application Twenty est ce qui décrit l’application à la plateforme — son identité, les autorisations qu’elle détient et le code qui s’exécute lors de l’installation ou de la mise à niveau. Ces déclarations n’ajoutent pas de nouvelles structures de données ni de comportement à l’exécution ; elles indiquent à Twenty qui est l’application et comment la configurer.

​
Dans cette section

Configuration de l'application

defineApplication — identité, rôle par défaut, variables, métadonnées de la marketplace.

Rôles et autorisations

defineRole — déclarez ce que les fonctions logiques de votre application peuvent lire et écrire.

Hooks d'installation

definePreInstallLogicFunction et definePostInstallLogicFunction — sauvegarder les données, préremplir les valeurs par défaut, valider les mises à niveau.

​
Comment les éléments s’articulent

  • L’application est le point d’entrée. Chaque application comporte exactement un appel à defineApplication() qui pointe vers un Rôle par défaut.
  • Le Rôle contrôle ce que les fonctions logiques et les composants frontaux de l’application peuvent lire et écrire. Suivez le principe du moindre privilège : accordez uniquement les autorisations dont votre code a réellement besoin.
  • Les hooks d’installation s’exécutent lors de l’installation ou de la mise à niveau — la pré-installation avant la migration des métadonnées (ce qui permet de refuser une mise à niveau risquée), la post-installation après la migration (ce qui permet de préremplir les données par défaut selon le nouveau schéma).
Les hooks d’installation partagent l’environnement d’exécution des fonctions logiques — même signature de handler, mêmes variables d’environnement, même client d’API typé — mais ils sont déclarés avec leurs propres fonctions define et vivent en dehors du modèle de déclencheurs habituel (HTTP, cron, événements de base de données).