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 /es/docs/web/admin.md (or send Accept: text/markdown).
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.
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.
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 contextFlujo 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.