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 /de/docs/web/feature-flags.md (or send Accept: text/markdown).
Feature-Flags und Ankündigungen
Dunkel ausrollen, pro Workspace begrenzen und an Mitglieder senden.
Schritt-für-Schritt für Einsteiger
Voraussetzungen: Lesen Sie die beiden folgenden Einsteigerhandbücher, schließen Sie die lokale Web-Einrichtung ab und öffnen Sie dieses Monorepo im Stammverzeichnis in Ihrem Editor. Webeinstellungen gehören in apps/web/.env.local; Next.js liest das Stammverzeichnis .env nicht. /dashboard im Standard-Fake-Modus ist eine Demo ohne Datenbank; /auth benötigt eine migrierte Datenbank.
Kurze Begriffe: Ein Arbeitsbereich umfasst die einzelnen Benutzer, Daten und Einstellungen eines Teams. Der Server ist das vertrauenswürdige Backend; Halten Sie Anbieterschlüssel aus Browser- und Telefoncodes fern. Eine Migration ist eine versionierte Datenbankänderung, die Tabellen erstellt oder aktualisiert. Ein KI-Modell ist der Motor, der antwortet; Der Modellkatalog ist die Liste der verfügbaren Modell-IDs und Preise des Servers. Ein Anbieter ist ein externer Dienst wie ein KI-, E-Mail- oder Abrechnungsdienst. Eine Berechtigung ist eine Bewilligung, die einem Arbeitsbereich die Nutzung einer Funktion ermöglicht. Ein Webhook ist eine Nachricht, die ein Dienst an den URL eines anderen Dienstes sendet.
1. Melden Sie sich als Plattformadministrator an und öffnen Sie /admin/flags. Erstellen oder wählen Sie ein Testflag aus und setzen Sie es explizit auf „Aktiviert“ und dann auf „Deaktiviert“.
2. Aktualisieren Sie die Produktoberfläche, die die Flagge liest, und bestätigen Sie ihre Darstellungsänderungen.
3. Rollen und Berechtigungen müssen weiterhin Serveraktionen schützen, wenn ein Flag aktiviert ist. Wenn API im deaktivierten Zustand weiterhin zugänglich bleibt, fügen Sie an der vorgesehenen Stelle eine serverseitige Flag-Prüfung hinzu.
Beginnen Sie für benutzerdefinierten Code mit dem bereitgestellten prompts/README.md und kopieren Sie die nächstgelegene Eingabeaufforderung: prompts/new-app-screen.md für einen App-Bildschirm oder prompts/new-landing-page.md für eine öffentliche Seite. Geben Sie Ihrem Programmieragenten für Server-, Datenbank- oder Anbieterarbeiten die Aufgabe dieses Handbuchs und bitten Sie ihn, AGENTS.md, .ai/PROJECT_CONTEXT.md und passende .ai/-Spiegel zu lesen; Überprüfen Sie die hier genannten genauen Quelldateien. Listen Sie Dateien auf und prüfen Sie sie vor der Bearbeitung. Bewahren Sie den Arbeitsbereichseigentum und die Nur-Server-Geheimnisse. und zeige dir den Unterschied. Teilen Sie ihm das gewünschte Verhalten, Eingabe- und Ausgabefelder, zulässige Rollen, erwartete Erfolge und Fehler sowie das Testkonto, den Anbieter oder das Gerät mit. Beispielwerte verwenden; Fügen Sie niemals ein echtes Geheimnis ein.
Flags im Admin-Bereich konfigurieren
/admin/flags und feature-flags.ts stellen Verwaltungs- und Auswertungspfade für die Flags des Kits bereit. Die Flag-Konfiguration gehört zur Plattformverwaltung; eine Produktoberfläche kann auf eine erlaubte Funktion reagieren, erhält dadurch aber keine Berechtigung, das Flag zu ändern.
Aktiviertes und deaktiviertes Verhalten überprüfen
Testen Sie Standardwerte, fehlende Flags, Änderungen, abgelehnte Rollen und serverseitige Aktionen mit Flag-Prüfung. Bewahren Sie Workspace-Zugriffsprüfungen beim Ergänzen von Rollout-Logik.
Einrichtung und Konfiguration
feature-flag-runtime löst Flags für einen Caller-Kontext auf: Nicht konfigurierte Flags sind standardmäßig aus, und Overrides pro Flag zielen auf bestimmte Workspaces oder Nutzer. Ein fehlendes Flag kann eine Oberfläche niemals still freischalten.
Plattform-Ankündigungen (announcement-actions) senden In-App-Hinweise über dieselbe Notification-Fläche, die Mitglieder bereits lesen — listActiveAnnouncements liefert das Banner, dismissAnnouncementAction protokolliert das Wegdrücken.
await isFeatureEnabled(flag, { workspaceId })
await resolveFeatureFlags(context)
listActiveAnnouncements()
dismissAnnouncementAction(formData)Implementierungsablauf
Shippe Code dunkel: Merge hinter einem Flag, aktiviere ihn für deinen eigenen Workspace, dann weite aus. Entferne das Flag, sobald die Fläche permanent ist — ein abgestandenes Flag ist eine zweite Wahrheitsquelle.
Prüfe das Flag an der Server-Grenze UND in der Navigation: Ein versteckter Link mit offener Route ist kein Feature-Gate. Halte Ankündigungen vom transaktionalen Mail-Pfad fern — sie sind Produktneuigkeiten, keine Belege.
Überprüfung und Fehlerbehebung
Verifiziere, dass ein deaktiviertes Flag Navigation, Route und Aktion durchgängig verbirgt; ein Override nur für sein Ziel gilt; und ein gelöschtes Flag auf den Default zurückfällt. Teste, dass Ankündigungen die vorgesehenen Workspaces erreichen und das Wegdrücken persistiert.