For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /fr/docs/web/feature-flags.md (or send Accept: text/markdown).
Feature flags et annonces
Déployer en sombre, limiter par workspace et diffuser aux membres.
Parcours pas à pas pour débuter
Prérequis : Lisez les deux guides pour débutants ci-dessous, terminez la configuration locale du Web et ouvrez ce monorepo à sa racine dans votre éditeur. Les paramètres Web appartiennent à apps/web/.env.local ; Next.js ne lit pas la racine .env. /dashboard dans le mode faux par défaut est une démo sans base de données ; /auth nécessite une base de données migrée.
Termes rapides : un espace de travail est constitué des utilisateurs, des données et des paramètres distincts d'une équipe. Le serveur est le backend de confiance ; gardez les clés du fournisseur hors du code du navigateur et du téléphone. Une migration est une modification de base de données versionnée qui crée ou met à jour des tables. Un modèle d'IA est le moteur qui répond ; le catalogue de modèles est la liste du serveur des identifiants de modèles et des prix disponibles. Un fournisseur est un service externe tel qu'un service d'IA, de messagerie ou de facturation. Un droit est une subvention qui permet à un espace de travail d'utiliser une fonctionnalité. Un webhook est un message qu'un service envoie au URL d'un autre service.
1. Connectez-vous en tant qu'administrateur de plateforme et ouvrez /admin/flags ; créez ou sélectionnez un indicateur de test et définissez-le explicitement sur activé, puis désactivé.
2. Actualisez la surface du produit qui lit le drapeau et confirmez ses modifications de présentation.
3. Les rôles et les droits doivent toujours protéger les actions du serveur lorsqu'un indicateur est activé. Si le API reste accessible lorsqu'il est désactivé, ajoutez une vérification d'indicateur côté serveur lorsque cela est prévu.
Pour le code personnalisé, commencez par le prompts/README.md fourni et copiez l'invite la plus proche : prompts/new-app-screen.md pour un écran d'application ou prompts/new-landing-page.md pour une page publique. Pour le travail sur un serveur, une base de données ou un fournisseur, confiez à votre agent de codage la tâche de ce guide et demandez-lui de lire les miroirs AGENTS.md, .ai/PROJECT_CONTEXT.md et .ai/ correspondants ; inspectez les fichiers sources exacts nommés ici ; lister les fichiers et les vérifications avant de les modifier ; préserver la propriété de l'espace de travail et les secrets du serveur ; et je vous montre la différence. Indiquez-lui le comportement souhaité, les champs d'entrée et de sortie, les rôles autorisés, les succès et erreurs attendus, ainsi que le compte, le fournisseur ou l'appareil de test. Utilisez des exemples de valeurs ; ne collez jamais un vrai secret.
Configurer les indicateurs dans Admin
/admin/flags et feature-flags.ts fournissent la gestion et l’évaluation des indicateurs du kit. La configuration appartient à l’administrateur de la plateforme ; l’interface produit peut réagir à une fonctionnalité autorisée sans pouvoir modifier l’indicateur.
Vérifier les comportements activés et désactivés
Testez les valeurs par défaut, les indicateurs manquants, les mises à jour, le refus selon le rôle et les actions serveur protégées par un indicateur. Maintenez les contrôles d’accès de l’espace de travail lors de l’ajout d’un déploiement progressif.
Configuration et paramètres
feature-flag-runtime résout les flags pour un contexte d'appelant : les flags non configurés sont désactivés par défaut, et les overrides par flag ciblent des workspaces ou utilisateurs précis. Un flag absent ne peut jamais activer silencieusement une surface.
Les annonces plateforme (announcement-actions) diffusent des notices in-app via la même surface de notifications que les membres lisent déjà — listActiveAnnouncements alimente la bannière, dismissAnnouncementAction enregistre le rejet.
await isFeatureEnabled(flag, { workspaceId })
await resolveFeatureFlags(context)
listActiveAnnouncements()
dismissAnnouncementAction(formData)Processus d’implémentation
Livrez le code en sombre : mergez derrière un flag, activez-le pour votre propre workspace, puis élargissez. Retirez le flag une fois la surface permanente — un flag obsolète est une seconde source de vérité.
Vérifiez le flag à la frontière serveur ET dans la navigation : un lien masqué avec une route ouverte n'est pas une fonctionnalité protégée. Gardez les annonces hors du mail transactionnel — ce sont des nouvelles produit, pas des reçus.
Vérification et dépannage
Vérifiez qu'un flag désactivé masque navigation, route et action de bout en bout ; qu'un override ne s'applique qu'à sa cible ; et qu'un flag purgé retourne au défaut. Testez que les annonces atteignent les workspaces visés et que le rejet persiste.