> ## 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 # Consola de administración Inspección de plataforma, anuncios y feature flags. ## 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. Antes de crear una cuenta de prueba local, agregue su propia dirección a la lista `ADMIN_EMAILS` de solo servidor y reinicie la aplicación. 2. Regístrese en la base de datos de prueba migrada y abra `/admin`; Inspeccione las páginas de usuarios y organizaciones disponibles. 3. Esto otorga administración de plataforma, no propiedad del espacio de trabajo. Si se deniega el acceso, verifique la configuración exacta del correo electrónico y del servidor; no eleve usuarios arbitrarios ni pruebe con producción. 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) ## Crea el límite de administración `ADMIN_EMAILS` es una lista inicial de correos separada por comas, solo del servidor. Las personas enumeradas reciben el rol de administrador de plataforma al registrarse. Si no está configurada, concede acceso mediante una ruta autorizada de base de datos/administración; no conviertas en administrador al primer visitante arbitrario. El rol de administrador de plataforma es distinto de owner/admin del espacio de trabajo. `/admin` y sus páginas de usuarios, organizaciones, flags, anuncios y lista de espera comprueban el rol de plataforma. ## Usa los controles implementados El motor Better Auth predeterminado proporciona administración de usuarios, bloqueos y suplantación. La aplicación compone vistas de plataforma con registros de auditoría. Limita la suplantación a administradores verificados, haz visible su estado y restaura la sesión del administrador original al salir. Auth.js no hereda automáticamente los plugins de administración de Better Auth. Revisa `admin.ts`, `admin-actions.ts` y el comportamiento del proveedor de autenticación antes de cambiar de motor. ## Verifica las acciones privilegiadas Prueba la denegación a personas que no son administradoras, el acceso administrativo, las sesiones de usuarios bloqueados, el inicio/fin de suplantación y las acciones que habilites. Mantén todas las rutas de administración fuera de la indexación pública. [Indicadores de funciones](https://supastack.dev/es/docs/web/feature-flags.md) [Anuncios](https://supastack.dev/es/docs/web/project-structure.md) [Administración de lista de espera](https://supastack.dev/es/docs/web/setup-ai.md) ## Configuración y ajustes La superficie /admin es la vista de inspección del operador sobre workspaces, miembros y estado del producto. ADMIN_EMAILS (o la configuración del plugin admin en el producto consumidor) decide quién llega; cada ruta admin vuelve a comprobar la autorización en el servidor. Los feature flags (feature-flag-runtime.ts) desactivan por defecto todo lo no configurado — un flag ausente nunca puede habilitar silenciosamente una superficie — y los overrides por flag viven en la tabla featureFlagOverride. ``` /admin operator dashboard announcement-actions.ts broadcast in-app notices resolveFeatureFlags(...) bulk flag resolution for a caller context ``` ## Flujo de implementación Usa las acciones admin para inspección y operaciones de soporte (búsqueda de workspace, gestión de miembros, difusión de anuncios). Mantén las mutaciones auditadas y la autorización comprobada en el límite de la acción, no en la navegación. Despliega funciones detrás de flags: envía código en oscuro, habilítalo por workspace o globalmente, y retira el flag cuando la superficie sea permanente. La impersonación de plataforma permanece congelada a menos que el PRODUCT.md del producto la autorice explícitamente. ## Verificación y solución de problemas Verifica que un no-admin es denegado, que un flag deshabilitado oculta su superficie de extremo a extremo (nav, ruta, acción), que un override se resuelve solo para su objetivo y que los anuncios llegan a la audiencia prevista. Los tests admin deben cubrir primero el camino denegado. ## Siguiente [Estrategia de pruebas](https://supastack.dev/es/docs/web/testing.md)