Zum Inhalt springen
aYOUne
Non nella tua lingua

Questa pagina non è ancora disponibile in it. Stai leggendo la versione de. Disponibile in: EN · ES

Feature Flags

Feature Flags

Feature-Flags sind der Grundbaustein für stufenweise Rollouts, Beta-Programme und A/B-Tests in aYOUne. Sie leben in der config.flags-Collection und werden überall in der Plattform via flagsService.isEnabled(flagId, ctx) ausgewertet.

Das Flag-Modell

Ein Flag ist mehr als ein boolean. Es enthält:

Feld Beschreibung
_id Stabiler Slug, z.B. marketing.newsletter-v2
name Anzeige-Name
description Beschreibung für andere Admins
enabled Master-Schalter
rules[] Per-Customer/-User-/-Role-Bedingungen
defaultValue Wenn keine Rule matched
expiresAt Optional: Auto-Disable Datum

Flag setzen (UI)

admin-v2 → Feature Flags → Detail → "Regel hinzufügen". Beispiel: nur User der "Beta-Tester"-Rolle sehen das neue Newsletter-UI:

rules:
  - condition:
      role: 64a1b2...   # ObjectId der Role
    value: true
  - condition: {}      # Catch-All
    value: false

Flag setzen (CLI)

ay flag enable marketing.newsletter-v2
ay flag disable marketing.newsletter-v2
ay flag set marketing.newsletter-v2 --rule '{"role":"<id>"}' --value true
ay flag list                # alle Flags
ay flag get marketing.newsletter-v2

Auswertungs-Reihenfolge

Bei flagsService.isEnabled(flagId, ctx) durchläuft die Plattform:

  1. Wenn flag.enabled === false → false
  2. Wenn flag.expiresAt < now → false
  3. Iteriert flag.rules[] in Reihenfolge — erste matchende Rule gewinnt
  4. Sonst flag.defaultValue

Das macht Reihenfolge wichtig: spezifische Rules (z.B. customerId) gehören vor generische (z.B. role).

Mobile-App- und Customer-UI-Flags

Seit Kapitel 1.65 gibt es zwei spezielle Flag-Klassen:

  • mobile-app.* — wirken in der PWA für Customer-Admins
  • customer-ui.* — wirken in der Consumer-App (= deine End-User-Site)

Beispiel:

ay flag enable mobile-app.dark-mode
ay flag enable customer-ui.checkout-v2 --rule '{"locale":"de"}'

Rollout-Strategien

Strategie Wie
Beta-Whitelist rules.role = "Beta-Tester"
Customer-Pilot rules.customerId = "<id>"
Prozent-Rollout rules.percentage = 25 (hash-basiert auf userId)
Datum-basiert rules.afterDate = "2026-05-01"
Kill-Switch enabled = false → sofortige Deaktivierung

Best Practices

  • Slug = Modul.Feature.Variante: crm.lead-scoring.v2, nicht new-feature-test.
  • description Pflicht: Was ist es, warum existiert es, wann darf es weg?
  • Lifecycle-Disziplin: Nach Vollroll-Out das Flag löschen — sonst sammelt sich tech debt. ay flag list --orphan zeigt Flags ohne Rules.
  • Auditierbar: Jeder Toggle landet im Audit-Trail.

Verbindungen

Flags werden auch auf Backend-Seite genutzt: subscribeToReseedSignal() lauscht auf core.reseedStates.<modul> (60s-Poll), um State-Seeders ohne Pod-Restart neu auszulösen.

Continuare a lavorare con questa pagina

Istruzioni pronte per il tuo strumento di IA. Copia, incolla e inizia: l’IA recupera il contenuto da sola tramite l’indirizzo indicato nel testo.

Riassumere i passaggi per me L’essenziale, nell’ordine giusto.
Apri in ChatGPT 
Leggi la seguente documentazione di tolinax UG e lavoraci.

Questa pagina: https://ayoune.com/it/docs/admin-handbook/feature-flags.md
La raccolta completa: https://ayoune.com/it/docs/admin-handbook.md

Riassumi il contenuto per me.

- Prima, in due frasi: di cosa si tratta?
- Poi i passaggi nell’ordine in cui devo affrontarli.
- Una riga per passaggio, in linguaggio semplice.
- Alla fine: che cosa dovrei avere pronto in anticipo.

Non tralasciare nulla che mi serva per arrivare davvero in fondo.
Nota sulle fonti:
- Ogni pagina di questa documentazione è disponibile come Markdown (lo stesso indirizzo con `.md`).
- Una panoramica leggibile da macchina di tutti i contenuti pubblici è su `/llms.txt`.
- Se hai accesso al server MCP di aYOUne, puoi lavorare su dati in tempo reale
  invece che su questa istantanea. Altrimenti ignora questo punto.
Spiegare a cosa mi serve A cosa serve e quando conviene.
Apri in ChatGPT 
Leggi la seguente documentazione di tolinax UG e lavoraci.

Questa pagina: https://ayoune.com/it/docs/admin-handbook/feature-flags.md
La raccolta completa: https://ayoune.com/it/docs/admin-handbook.md

Spiegami a cosa mi serve.

1. Quale problema risolve? In una frase, dal mio punto di vista.
2. Tre situazioni tipiche in cui mi aiuta davvero.
3. Quando NON mi serve: così risparmio tempo.
4. Che cosa posso fare invece, se non fa al caso mio.

Attieniti a quanto dice la fonte. Dove non dice nulla, dillo apertamente invece
di tirare a indovinare.
Nota sulle fonti:
- Ogni pagina di questa documentazione è disponibile come Markdown (lo stesso indirizzo con `.md`).
- Una panoramica leggibile da macchina di tutti i contenuti pubblici è su `/llms.txt`.
- Se hai accesso al server MCP di aYOUne, puoi lavorare su dati in tempo reale
  invece che su questa istantanea. Altrimenti ignora questo punto.
Aiutarmi con la configurazione Passo dopo passo, chiedendomi man mano.
Apri in ChatGPT 
Leggi la seguente documentazione di tolinax UG e lavoraci.

Questa pagina: https://ayoune.com/it/docs/admin-handbook/feature-flags.md
La raccolta completa: https://ayoune.com/it/docs/admin-handbook.md

Accompagnami passo dopo passo nella configurazione.

- Dimmi prima che cosa devo avere pronto (accessi, dati, tempo).
- Poi guidami UN passaggio alla volta. Aspetta il mio "avanti".
- Per ogni passaggio, indica come capisco che ha funzionato.
- Se qualcosa va storto, chiedimi il messaggio esatto invece di indovinare.

Se le istruzioni lasciano un punto aperto, dimmelo invece di inventarlo.
Nota sulle fonti:
- Ogni pagina di questa documentazione è disponibile come Markdown (lo stesso indirizzo con `.md`).
- Una panoramica leggibile da macchina di tutti i contenuti pubblici è su `/llms.txt`.
- Se hai accesso al server MCP di aYOUne, puoi lavorare su dati in tempo reale
  invece che su questa istantanea. Altrimenti ignora questo punto.
Aiutarmi con un problema Circoscrivere la causa invece di indovinare.
Apri in ChatGPT 
Leggi la seguente documentazione di tolinax UG e lavoraci.

Questa pagina: https://ayoune.com/it/docs/admin-handbook/feature-flags.md
La raccolta completa: https://ayoune.com/it/docs/admin-handbook.md

Aiutami a circoscrivere un problema.

- Chiedimi prima che cosa osservo e che cosa mi aspettavo.
- Da lì ricava le cause più probabili coerenti con questa fonte.
- Per ogni causa dammi UNA verifica che la confermi o la escluda.
- Ordinale in modo che la verifica più economica venga per prima.

Non tirare a indovinare. Se la fonte non copre il problema, dimmi dove dovrei
cercare ancora.
Nota sulle fonti:
- Ogni pagina di questa documentazione è disponibile come Markdown (lo stesso indirizzo con `.md`).
- Una panoramica leggibile da macchina di tutti i contenuti pubblici è su `/llms.txt`.
- Se hai accesso al server MCP di aYOUne, puoi lavorare su dati in tempo reale
  invece che su questa istantanea. Altrimenti ignora questo punto.
Spiegarlo con parole semplici Senza termini tecnici, da zero.
Apri in ChatGPT 
Leggi la seguente documentazione di tolinax UG e lavoraci.

Questa pagina: https://ayoune.com/it/docs/admin-handbook/feature-flags.md
La raccolta completa: https://ayoune.com/it/docs/admin-handbook.md

Spiega il contenuto in modo che lo capisca chi non ha conoscenze pregresse.

- Parti dallo scopo: perché esiste tutto questo?
- Spiega i termini tecnici in mezza frase alla prima occorrenza.
- Un paragone quotidiano dove regge davvero, nessuno dove zoppica.
- Alla fine: le tre cose da ricordare.

Non accorciare omettendo condizioni. Una semplificazione che nasconde un
prerequisito è un’affermazione falsa.
Nota sulle fonti:
- Ogni pagina di questa documentazione è disponibile come Markdown (lo stesso indirizzo con `.md`).
- Una panoramica leggibile da macchina di tutti i contenuti pubblici è su `/llms.txt`.
- Se hai accesso al server MCP di aYOUne, puoi lavorare su dati in tempo reale
  invece che su questa istantanea. Altrimenti ignora questo punto.
Una lista da spuntare Da seguire mentre procedi.
Apri in ChatGPT 
Leggi la seguente documentazione di tolinax UG e lavoraci.

Questa pagina: https://ayoune.com/it/docs/admin-handbook/feature-flags.md
La raccolta completa: https://ayoune.com/it/docs/admin-handbook.md

Trasformalo in una **lista di controllo** da spuntare per la pratica.

- Esattamente un’azione per punto, all’imperativo.
- Ordinala in modo che nessun punto dipenda da un prerequisito successivo.
- Prerequisiti e insidie come sotto-punti rientrati.
- Chiudi con una verifica finale: come faccio a sapere che è tutto corretto?
Nota sulle fonti:
- Ogni pagina di questa documentazione è disponibile come Markdown (lo stesso indirizzo con `.md`).
- Una panoramica leggibile da macchina di tutti i contenuti pubblici è su `/llms.txt`.
- Se hai accesso al server MCP di aYOUne, puoi lavorare su dati in tempo reale
  invece che su questa istantanea. Altrimenti ignora questo punto.

Was this article helpful?

👎 No (0)
Leave a comment