> ## 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 flags y anuncios

Despliega en oscuro, limita por workspace y difunde a los miembros.

## Guía paso a paso para principiantes

Requisitos previos: lea las dos guías para principiantes a continuación, finalice la configuración local web y abra este monorepo en la raíz de su editor. La configuración web pertenece a `apps/web/.env.local`; Next.js no lee la raíz `.env`. `/dashboard` en el modo falso predeterminado es una demostración sin base de datos; `/auth` necesita una base de datos migrada.

Términos breves: un espacio de trabajo son los usuarios, datos y configuraciones separados de un equipo. El servidor es el backend confiable; Mantenga las claves del proveedor fuera del código del navegador y del teléfono. Una migración es un cambio de base de datos versionada que crea o actualiza tablas. Un modelo de IA es el motor que responde; el catálogo de modelos es la lista del servidor de ID de modelos disponibles y precios. Un proveedor es un servicio externo, como inteligencia artificial, correo electrónico o servicio de facturación. Un derecho es una concesión que permite que un espacio de trabajo utilice una función. Un webhook es un mensaje que un servicio envía al URL de otro servicio.

1. Inicie sesión como administrador de la plataforma y abra `/admin/flags`; cree o seleccione un indicador de prueba y configúrelo explícitamente como habilitado y luego deshabilitado.

2. Actualizar la superficie del producto que lee la bandera y confirmar sus cambios de presentación.

3. Las funciones y derechos aún deben proteger las acciones del servidor cuando se habilita una bandera. Si el API permanece accesible mientras está deshabilitado, agregue una marca de verificación del lado del servidor donde esté previsto.

Para obtener código personalizado, comience con el `prompts/README.md` proporcionado y copie el mensaje más cercano: `prompts/new-app-screen.md` para una pantalla de aplicación o `prompts/new-landing-page.md` para una página pública. Para trabajos de servidor, base de datos o proveedor, asigne a su agente de codificación la tarea de esta guía y pídale que lea `AGENTS.md`, `.ai/PROJECT_CONTEXT.md` y los espejos `.ai/` correspondientes; inspeccionar los archivos fuente exactos nombrados aquí; enumerar archivos y verificaciones antes de editarlos; preservar la propiedad del espacio de trabajo y los secretos exclusivos del servidor; y mostrarte la diferencia. Dígale el comportamiento que desea, los campos de entrada y salida, los roles permitidos, los éxitos y errores esperados y la cuenta, proveedor o dispositivo de prueba. Utilice valores de muestra; Nunca pegues un verdadero secreto.

[Antes de comenzar](https://supastack.dev/es/docs/web/before-you-start.md)

[Conceptos básicos de terminales](https://supastack.dev/es/docs/web/terminal-basics.md)

[Configuración local web](https://supastack.dev/es/docs/web/ship-in-5-minutes.md)

[Mensajes del agente y memoria del proyecto](https://supastack.dev/es/docs/web/agents.md)


## Configura los flags en Administración

`/admin/flags` y `feature-flags.ts` proporcionan la ruta de administración/evaluación de flags del kit. La configuración de flags pertenece a quien administra la plataforma; una interfaz de producto puede reaccionar a una función permitida, pero no adquiere autoridad para cambiar el flag.


## Mantén separada la autorización

Un flag habilita el comportamiento del producto, mientras que los roles y los derechos autorizan a quien realiza la llamada. Comprueba ambos cuando sea necesario. Deshabilitar un enlace de navegación no impide una llamada directa a la API.


## Verifica el comportamiento habilitado y deshabilitado

Prueba los valores predeterminados, flags ausentes, actualizaciones, denegación por rol y acciones de servidor controladas por flags. Conserva las comprobaciones de acceso al espacio de trabajo al añadir lógica de despliegue gradual.

[Roles de plataforma](https://supastack.dev/es/docs/web/admin.md)

[Acceso pago](https://supastack.dev/es/docs/web/setup-payments.md)


## Configuración y ajustes

feature-flag-runtime resuelve flags para un contexto de llamada: los flags no configurados están desactivados por defecto y los overrides por flag apuntan a workspaces o usuarios concretos. Un flag ausente nunca puede habilitar una superficie en silencio.

Los anuncios de plataforma (announcement-actions) difunden avisos in-app por la misma superficie de notificaciones que los miembros ya leen — listActiveAnnouncements alimenta el banner y dismissAnnouncementAction registra el descarte.

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

listActiveAnnouncements()
dismissAnnouncementAction(formData)
```


## Flujo de implementación

Publica el código en oscuro: fusiona detrás de un flag, actívalo en tu propio workspace y luego amplía. Retira el flag cuando la superficie sea permanente — un flag obsoleto es una segunda fuente de verdad.

Comprueba el flag en la frontera del servidor Y en la navegación: un enlace oculto con la ruta abierta no es una funcionalidad protegida. Mantén los anuncios fuera del correo transaccional — son noticias de producto, no recibos.


## Verificación y solución de problemas

Verifica que un flag desactivado oculta navegación, ruta y acción de extremo a extremo; que un override se aplica solo a su objetivo; y que un flag limpiado vuelve al valor por defecto. Prueba que los anuncios llegan a los workspaces previstos y que el descarte persiste.


## Siguiente

[Seguridad y privacidad](https://supastack.dev/es/docs/web/security.md)