> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Feature flag e annunci

Rilascia in dark, limita per workspace e trasmetti ai membri.

## Procedura dettagliata per principianti

Prerequisiti: leggi le due guide per principianti di seguito, completa la configurazione locale del Web e apri questo monorepo alla radice nel tuo editor. Le impostazioni Web appartengono a `apps/web/.env.local`; Next.js non legge la radice `.env`. `/dashboard` nella modalità falsa predefinita è una demo senza database; `/auth` necessita di un database migrato.

Termini rapidi: uno spazio di lavoro è costituito da utenti, dati e impostazioni separati di un team. Il server è il backend affidabile; mantenere le chiavi del provider fuori dal browser e dal codice del telefono. Una migrazione è una modifica del database con versione che crea o aggiorna tabelle. Un modello AI è il motore che risponde; il catalogo dei modelli è l'elenco del server degli ID e dei prezzi dei modelli disponibili. Un fornitore è un servizio esterno come un servizio di intelligenza artificiale, posta elettronica o fatturazione. Un diritto è una concessione che consente a un'area di lavoro di utilizzare una funzionalità. Un webhook è un messaggio che un servizio invia allo URL di un altro servizio.

1. Accedi come amministratore della piattaforma e apri `/admin/flags`; creare o selezionare un flag di test e impostarlo esplicitamente su abilitato, quindi disabilitato.

2. Aggiorna la superficie del prodotto su cui è riportata la bandiera e conferma le modifiche alla presentazione.

3. Ruoli e autorizzazioni devono comunque proteggere le azioni del server quando un flag è abilitato. Se API rimane accessibile mentre è disabilitato, aggiungi un controllo flag lato server dove previsto.

Per il codice personalizzato, inizia con `prompts/README.md` in dotazione e copia il prompt più vicino: `prompts/new-app-screen.md` per la schermata di un'app o `prompts/new-landing-page.md` per una pagina pubblica. Per il lavoro su server, database o provider, assegna al tuo agente di codifica il compito di questa guida e chiedigli di leggere `AGENTS.md`, `.ai/PROJECT_CONTEXT.md` e i mirror `.ai/` corrispondenti; controllare gli esatti file sorgente nominati qui; elencare file e controlli prima della modifica; preservare la proprietà dello spazio di lavoro e i segreti solo del server; e mostrarti la differenza. Indicagli il comportamento desiderato, i campi di input e output, i ruoli consentiti, i successi e gli errori previsti e l'account, il fornitore o il dispositivo di prova. Utilizzare valori campione; non incollare mai un vero segreto.

[Prima di iniziare](https://supastack.dev/it/docs/web/before-you-start.md)

[Nozioni di base sui terminali](https://supastack.dev/it/docs/web/terminal-basics.md)

[Configurazione locale Web](https://supastack.dev/it/docs/web/ship-in-5-minutes.md)

[Messaggi dell'agente e memoria del progetto](https://supastack.dev/it/docs/web/agents.md)


## Configura i flag in Amministrazione

`/admin/flags` e `feature-flags.ts` forniscono il percorso di gestione/valutazione dei flag del kit. La configurazione del flag appartiene all'amministratore della piattaforma; l'interfaccia utente di un prodotto può reagire a una funzionalità consentita senza acquisire l'autorità per modificare il flag.


## Mantenere l'autorizzazione separata

Un flag abilita il comportamento del prodotto, mentre i ruoli e i diritti autorizzano un chiamante. Controllare entrambi dove richiesto. Un collegamento di navigazione disabilitato non impedisce una chiamata diretta a API.


## Verificare il comportamento abilitato e disabilitato

Testare le impostazioni predefinite, i flag mancanti, gli aggiornamenti, la negazione dei ruoli e le azioni del server con flag. Mantieni i controlli di accesso allo spazio di lavoro quando aggiungi la logica di implementazione.

[Ruoli della piattaforma](https://supastack.dev/it/docs/web/admin.md)

[Accesso a pagamento](https://supastack.dev/it/docs/web/setup-payments.md)


## Installazione e configurazione

feature-flag-runtime risolve i flag per un contesto chiamante: i flag non configurati restano off di default e gli override per flag mirano a workspace o utenti specifici. Un flag mancante non può mai abilitare una superficie silenziosamente.

Gli annunci della piattaforma (announcement-actions) trasmettono avvisi in-app attraverso la stessa superficie di notifiche che i membri già leggono — listActiveAnnouncements alimenta il banner, dismissAnnouncementAction registra la rimozione.

```
await isFeatureEnabled(flag, { workspaceId })
await resolveFeatureFlags(context)

listActiveAnnouncements()
dismissAnnouncementAction(formData)
```


## Flusso di implementazione

Rilascia codice in dark: fai merge dietro un flag, abilitalo per il tuo workspace, poi allarga. Rimuovi il flag quando la superficie è permanente — un flag stale è una seconda fonte di verità.

Controlla il flag al confine del server E nella navigazione: un link nascosto con una rotta aperta non è una feature gated. Tieni gli annunci fuori dal percorso delle email transazionali — sono notizie di prodotto, non ricevute.


## Verifica e risoluzione dei problemi

Verifica che un flag disabilitato nasconda nav, rotta e azione end-to-end; che un override si risolva solo per il suo target; e che un flag azzerato torni al default. Testa che la consegna degli annunci raggiunga i workspace previsti e che la rimozione persista.


## Successivo

[Sicurezza e privacy](https://supastack.dev/it/docs/web/security.md)