Ayuda para administradores

La administración es quien alimenta el banco de contenidos y cuida la plataforma. Aquí se explica cómo se crea, se autoriza, se retira y se borra el material, y qué se gestiona desde el panel.

Quién puede crear contenido

Por seguridad, la creación y publicación de contenido está reservada a cuentas de administración (roles admin y moderator). El docente y el alumno no publican al banco: el docente lo usa, el alumno lo consume.

Las puertas de creación (Estudio, API para agentes, importación, laboratorios) exigen sesión de personal. Si una clave de agente pertenece a una cuenta sin rol de personal, la plataforma la rechaza con un error 403.

Cada portal decide qué puertas de autoría mantiene abiertas. Hay instancias donde el Estudio web está cerrado a propósito y el contenido entra sólo por la API de agentes. Eso se ajusta sin tocar código (ver «Los ajustes de cada portal» más abajo).

Crear y publicar objetos

La API para agentes es la vía universal: /api/v1/objects con la clave en la cabecera, validación previa en /api/v1/objects/validate. Las claves y los tokens MCP se emiten en /object-studio.
Estudio de creación (donde esté activado): en /object-studio redactas un brief, obtienes el prompt para una IA externa y subes el resultado (un ZIP o un object.json) para que Lumbre lo valide, firme y publique.
Laboratorios: en /admin/labs creas y publicas laboratorios interactivos.
Importar paquetes: en /admin/import-package traes libros y rutas desde otra instancia.
Bancos de reactivos: el de PISA se gestiona en /admin/pisa (reactivos y estímulos, con revisión, aprobación, retiro e historial de versiones).

Todo objeto publicado nace en un estado y con una visibilidad:

Estado: DRAFT (borrador, invisible para el público) o PUBLISHED (publicado).
Visibilidad: público, no listado (sólo por enlace), de círculo o privado.

Dejar un contenido "disponible para cursos"

Publicar no basta para que un profesor pueda montarlo en su aula. Desde la ficha del objeto o de la ruta se autoriza el uso:

Marca global de usable en cursos: lo abre a todos los docentes.
Concesión a un curso u organización concretos: lo limita a quien tú elijas.

Recuerda que esto es independiente de la visibilidad. Un objeto puede ser público y no estar disponible para cursos (se lee en la biblioteca pero nadie lo monta), o puede ser privado y concedido a un solo curso.

Quitar un contenido: tres niveles

Hay tres formas de hacer desaparecer algo del catálogo, y son irreversibles en distinto grado. Las tres viven en la ficha del contenido:

Archivar — lo saca del catálogo y evita que se monte en cursos nuevos, pero no rompe los cursos donde ya está inscrito: tus alumnos siguen viéndolo. Es reversible.
Retirar (borrado lógico) — marca el contenido como eliminado: deja de verse y de contarse, pero la fila y su historial siguen en la base. Recuperable.
Eliminar definitivamente — sólo para rol admin y sólo en los portales donde el borrado definitivo está activado. Borra la fila y todo lo que cuelga de ella: el archivo (PDF o paquete), la portada y sus derivados, y el progreso, valoraciones, comentarios e historial asociados. No se puede deshacer. En la ficha técnica de una obra aparece como «Eliminar definitivamente (administrador)», dentro del bloque de edición, y pide una confirmación explícita.

Regla práctica: archiva para reordenar el catálogo; retira si puede que lo necesites otra vez; elimina en definitivo sólo cuando la obra ya no debe existir en ninguna parte (contenido erróneo, duplicado o retirado por derecho).

Los ajustes de cada portal

Un mismo Lumbre se instala en varios portales, y cada uno es distinto sin tocar código: los ajustes viven en la tabla settings de la base de datos de esa instancia y mandan sobre lo que diga su archivo de entorno.

Tienen interfaz propia en el panel:

Marca del portal (/admin/branding): nombre y lema, captcha y escuela anfitriona.
Franja escolar y accesos rápidos (/admin/shortcuts): los niveles que aparecen sobre el menú y los cursos destacados del sitio.
Curaduría de la portada (/admin/home-curation): los cursos destacados que salen bajo el menú principal.
Aviso del sitio (/admin/aviso): una barra de texto en todo el portal.
Roles de registro: el registro de alumnos y profesores se puede cerrar dejando sólo el de visitante.

Y hay interruptores de familia que encienden o apagan puertas enteras del portal (laboratorios y juegos, shows, recorridos, herramientas, vida escolar, mapa del conocimiento, diccionario, formación de élite, panel personal, tienda, franja de países), además de los de autoría y borrado: manual_creation_enabled y hard_delete_enabled. Cuando una familia está apagada, su ruta responde no encontrado y no queda ninguna liga muerta en el menú ni en el directorio. Por eso esta guía puede citar puertas que tu portal no muestra: no es un fallo, es la configuración de tu instancia.

El panel de administración

En /admin concentras la operación del sitio:

Usuarios y permisos: estado de la cuenta y el permiso para hacer público contenido; alumnos (/admin/alumnos) con plantilla CSV.
Control de calidad (/admin/calidad): la cola transversal de observaciones sobre cualquier ficha, los estados de los objetos y el bloqueo NO TOCAR. Está explicado a fondo en Control de calidad.
Moderación y sugerencias: cola de comentarios en revisión, reportes de contenido (/admin/sugerencias).
Importaciones (/admin/imports): registro y salud de las importaciones de libros y paquetes.
Correo (/admin/mail): configuración SMTP y cola de mensajes.
Lumbre Central (/admin/central): conexión con el hub de distribución, sus canales y las fuentes hermanas.
Conceptos y diccionario (/admin/conceptos, /admin/diccionario): calidad de la nube semántica que cruza todo el contenido.
Microideas (/admin/microideas) y tutor (/admin/tutor).
Tienda (/admin/tienda): productos, categorías, cupones, pedidos, pagos, descargas y configuración de pagos.
Licencias y descargas (/admin/licencias, /admin/descargas).
Promociones (/admin/promotions) y publicidad (/admin/publicidad).
Analítica (/admin/conocimiento, /admin/visitantes): qué se consulta, qué no se encuentra, de dónde viene el público.
Mantenimiento (/admin/mantenimiento) y tareas programadas (/admin/programado).

La cara pública del cumplimiento curricular se audita en /auditoria y en la matriz de /curriculum; nivel por nivel está explicado en Vinculación SEP ↔ objetos.

Cómo seguir

Para el detalle de producción de objetos, consulta la ayuda para creadores. Para cuidar y corregir el contenido ya existente —barra de estado, observaciones para agentes IA, bloqueo NO TOCAR— lee el control de calidad. Para entender el flujo completo del banco a la autoevaluación, lee Cómo funciona Lumbre.