Saltar al contenido principal

Guia del administrador

Para quien es esta guia​

Esta guia es para usuarios con rol global Admin. Cubre todo lo que necesitas desde iniciar sesion hasta gestionar usuarios, configurar modelos, knowledge settings y visibilidad operativa. Admin tambien puede realizar todas las tareas de Teacher dentro de las classes.

Lo que puedes hacer​

  • Todo lo que hace Teacher dentro de las classes.
  • Cambiar roles globales de cualquier usuario.
  • Enviar cuentas a trash, restaurarlas y purgar las elegibles.
  • Configurar modelos y conexiones de IA.
  • Configurar knowledge settings globales.
  • Revisar audit, branding general y system status.

Limites importantes​

  • No puedes dejar la plataforma sin ningun Admin activo.
  • Teachers y Students no ven la identidad del modelo activo.
  • El chat de los students sigue siendo privado incluso para Admin en el flujo normal.
  • No puedes ver chats privados de estudiantes.

Empezar​

Tarea: iniciar sesion​

Objetivo​

Entrar al producto con tu cuenta.

Antes de empezar​

  • Necesitas un email y password ya registrados.

Pasos​

  1. Abre la pantalla de acceso.
  2. Escribe tu email.
  3. Escribe tu password.
  4. Confirma el acceso.

Resultado esperado​

El sistema te lleva al dashboard con las opciones de tu rol Admin.

Limites y notas​

  • En v1 no hay verificacion de email obligatoria.
  • En v1 no hay flujo de password reset dentro del producto.
Captura de pantalla pendiente

ID: access-sign-in — Mostrar: pantalla de acceso con campos de email y password. Motivo: aclarar el primer paso para cualquier usuario nuevo.

Tarea: confirmar que tu rol cambio​

Objetivo​

Verificar que el rol Admin ya quedo activo en tu cuenta.

Antes de empezar​

  • Un Admin ya te aviso que tu rol fue asignado o actualizado.

Pasos​

  1. Cierra sesion.
  2. Vuelve a iniciar sesion con la misma cuenta.
  3. Revisa si ahora ves el dashboard y las opciones de Admin, incluida la entrada a Admin settings.

Resultado esperado​

Tu rol Admin queda activo y puedes acceder a la configuracion global de la plataforma.

Limites y notas​

  • El cambio de rol no toma efecto en la sesion actual.
  • Siempre es necesario cerrar sesion y volver a entrar.
Captura de pantalla pendiente

ID: access-role-change — Mostrar: cambio visible entre estado previo y posterior al reingreso, con opciones de Admin activas. Motivo: dejar claro que el cambio requiere nuevo inicio de sesion.

Navegar​

Tarea: ir del dashboard a una lesson​

Objetivo​

Abrir una class y llegar a la lesson donde vas a trabajar contenido o usar el chat.

Antes de empezar​

  • Ya tienes rol Admin activo.
  • Ya ves el dashboard.

Pasos​

  1. Entra al dashboard.
  2. Abre una class disponible para tu cuenta.
  3. En el panel izquierdo, navega por la jerarquia Class -> Module -> Lesson.
  4. Selecciona la lesson que quieres abrir.

Resultado esperado​

La class se abre en su workspace y la lesson aparece en el area central con sus tabs, incluida Settings.

Limites y notas​

  • Solo los modulos y lessons publicadas aparecen en la navegacion normal.
  • La configuracion de class se abre desde el workspace de la class, no desde el dashboard.
Captura de pantalla pendiente

ID: nav-dashboard-to-lesson — Mostrar: dashboard, class abierta y arbol de navegacion hasta una lesson. Motivo: explicar el recorrido principal dentro del producto.

Tarea: entender cuando el panel derecho esta activo​

Objetivo​

Saber cuando puedes usar el asistente y cuando solo veras un estado inactivo.

Antes de empezar​

  • Ya entraste a una class.

Pasos​

  1. Abre una lesson publicada.
  2. Revisa el panel derecho.
  3. Si no estas en una lesson publicada, confirma que el panel queda desactivado.

Resultado esperado​

El panel derecho solo es interactivo dentro de una lesson publicada. Fuera de ese contexto, el panel queda desactivado.

Limites y notas​

  • Las lessons no publicadas no permiten chat, incluso para Admin.
  • No existe chat libre por class ni chat personal fuera de una lesson.
Captura de pantalla pendiente

ID: nav-right-panel-state — Mostrar: panel derecho activo en lesson publicada y desactivado en draft o fuera de lesson. Motivo: evitar confusiones sobre disponibilidad del chat.

Tarea: encontrar drafts y class settings​

Objetivo​

Ubicar las herramientas de edicion que no aparecen en la navegacion publicada.

Antes de empezar​

  • Ya abriste la class.

Pasos​

  1. Abre una class.
  2. Entra al acceso de Drafts para ver modulos y lessons no publicadas.
  3. Abre Class Settings desde el workspace de la class cuando necesites gestionar codigo, archivo o miembros.

Resultado esperado​

Puedes alternar entre la navegacion publicada y las vistas de edicion para contenido en borrador y configuracion de class.

Limites y notas​

  • La vista Drafts solo incluye modulos y lessons en borrador.
  • No muestra borradores de assignments, materials ni grades.
  • Una class archivada queda en solo lectura para Admin.
Captura de pantalla pendiente

ID: nav-drafts-and-settings — Mostrar: acceso a la vista Drafts y acceso a Class Settings dentro del workspace. Motivo: separar claramente la navegacion publicada de las herramientas de edicion.

Gestion de clases​

Admin puede realizar todas las tareas de Teacher dentro de las classes. Esta seccion cubre las tareas mas frecuentes. Consulta la guia de Teacher si necesitas mas detalle sobre algun flujo especifico.

Tarea: crear una class​

Pasos​

  1. Entra al dashboard.
  2. Usa la accion para crear una nueva class.
  3. Completa al menos title y description.
  4. Confirma la creacion.

La class queda activa de inmediato. La configuracion vive dentro del workspace de esa class.

Captura de pantalla pendiente

ID: teacher-create-class — Mostrar: formulario de nueva class con title y description. Motivo: cubrir el primer flujo de gestion de clase para Admin.

Tarea: gestionar members​

Pasos​

  1. Abre Class Settings desde el workspace de la class.
  2. Abre la tabla de members.
  3. Aprueba, rechaza o remueve segun corresponda.

Admin puede remover cualquier member, incluidos Teachers, a diferencia de Teacher que no puede remover Admins.

Captura de pantalla pendiente

ID: teacher-manage-members — Mostrar: tabla de members con filas pendientes, aprobadas y acciones de Admin visibles. Motivo: mostrar el control de membresia con permisos de Admin.

Tarea: calificar desde la tab Grades​

Pasos​

  1. Abre la lesson correcta.
  2. Entra a Grades.
  3. Selecciona un student.
  4. Edita grade numerica, exempt y feedback por fila.
  5. Publica o despublica las filas necesarias.

La escala numerica es de 0 a 10. El autosave guarda el borrador automaticamente.

Captura de pantalla pendiente

ID: teacher-grades-tab — Mostrar: tab Grades con un student seleccionado y acciones de publish/unpublish. Motivo: confirmar que Admin puede calificar igual que Teacher.

Admin settings​

Tarea: abrir Admin settings y orientarse en sus tabs​

Objetivo​

Entrar al panel de configuracion global y conocer las secciones disponibles.

Antes de empezar​

  • Ya tienes rol Admin activo.

Pasos​

  1. Abre la entrada de Admin settings desde el dashboard o la navegacion global.
  2. Revisa las tabs disponibles: Users, Models, Knowledge Settings, Audit, System Status, General.
  3. Navega a la seccion que necesitas.

Resultado esperado​

Puedes acceder a cualquier configuracion global desde este panel sin necesidad de salir al workspace de una class.

Limites y notas​

  • Este panel es exclusivo de Admin.
  • Teachers y Students no tienen acceso a Admin settings.
Captura de pantalla pendiente

ID: admin-settings-overview — Mostrar: panel Admin settings con todas sus tabs visibles (Users, Models, Knowledge Settings, Audit, System Status, General). Motivo: dar orientacion completa sobre la configuracion global antes de entrar a cada seccion.

Usuarios​

Tarea: gestionar roles globales​

Objetivo​

Cambiar el rol global de un usuario cuando sea necesario.

Antes de empezar​

  • Ya abriste Admin settings.

Pasos​

  1. Entra a la tab Users.
  2. Busca al usuario por nombre o email.
  3. Cambia su rol global segun corresponda.

Resultado esperado​

El usuario queda con el nuevo rol global guardado en la plataforma.

Limites y notas​

  • El cambio de rol toma efecto despues de logout y login del usuario afectado.
  • El sistema bloquea cualquier accion que deje cero Admins activos.
Captura de pantalla pendiente

ID: admin-users-role-change — Mostrar: tab Users con busqueda activa y cambio de rol disponible. Motivo: cubrir la tarea de acceso global mas frecuente para Admin.

Tarea: remover, restaurar o purgar cuentas​

Objetivo​

Gestionar el estado activo o soft-deleted de las cuentas.

Antes de empezar​

  • Ya abriste la tab Users.

Pasos​

  1. Busca la cuenta activa que quieres remover, o expande la seccion de trash para ver cuentas soft-deleted.
  2. Usa la accion de remove para enviar una cuenta a trash.
  3. Usa restore para devolver una cuenta desde trash.
  4. Usa purge solo cuando realmente debas eliminar una cuenta elegible.

Resultado esperado​

La cuenta queda en el estado esperado dentro de la tabla de users.

Limites y notas​

  • Active y Soft-deleted son los estados visibles en esta tab.
  • Restore es directo.
  • Purge requiere confirmacion.
  • El sistema bloquea la eliminacion del ultimo Admin.
Captura de pantalla pendiente

ID: admin-users-trash — Mostrar: seccion de trash con acciones de restore y purge visibles. Motivo: explicar la diferencia entre remover, restaurar y purgar.

Modelos​

Tarea: configurar modelos​

Objetivo​

Seleccionar el modelo global activo y ajustar configuracion minima de inferencia.

Antes de empezar​

  • Ya abriste Admin settings.

Pasos​

  1. Entra a Models.
  2. Revisa backends y modelos disponibles.
  3. Configura conexiones necesarias.
  4. Selecciona el modelo global activo.
  5. Ajusta temperature y max tokens si hace falta.

Resultado esperado​

La plataforma queda apuntando al modelo global que quieres usar para mensajes nuevos.

Limites y notas​

  • Los chats existentes se conservan despues del cambio de modelo.
  • Los mensajes nuevos usan el nuevo modelo activo.
  • La familia de backends soportada incluye OpenAI API y Ollama.
  • Teachers y Students no ven la identidad del modelo activo.
Captura de pantalla pendiente

ID: admin-models-tab — Mostrar: tab Models con lista de backends, modelo activo y settings minimos de inferencia. Motivo: mostrar el control central de modelos.

Conocimiento​

Tarea: configurar knowledge settings​

Objetivo​

Definir reglas globales de recuperacion y citas para toda la plataforma.

Antes de empezar​

  • Ya abriste Admin settings.

Pasos​

  1. Entra a Knowledge Settings.
  2. Ajusta chunking.
  3. Selecciona embedding model o backend.
  4. Ajusta retrieval limits.
  5. Activa o desactiva citation behavior.

Resultado esperado​

La plataforma actualiza su configuracion global de conocimiento y recuperacion.

Limites y notas​

  • Los retrieval limits controlan el maximo de source chunks enviados al modelo y el maximo de citas visibles.
  • Estas reglas son globales y afectan a todas las lessons y classes.
Captura de pantalla pendiente

ID: admin-knowledge-tab — Mostrar: tab Knowledge Settings con chunking, embeddings, retrieval limits y citation behavior. Motivo: cubrir la configuracion global de retrieval.

Audit​

Tarea: revisar audit​

Objetivo​

Consultar eventos administrativos relevantes sin salir de la ventana de Admin.

Antes de empezar​

  • Ya abriste Admin settings.

Pasos​

  1. Entra a Audit.
  2. Filtra por info, warning o error.
  3. Revisa los eventos que necesitas investigar.

Resultado esperado​

Ves solo los eventos cubiertos por el audit minimo de v1.

Limites y notas​

  • El audit de v1 solo cubre account removals, model changes y material processing failures.
  • Esta vista no reemplaza monitoreo tecnico externo.
Captura de pantalla pendiente

ID: admin-audit-tab — Mostrar: tab Audit con filtros de severidad y lista de eventos. Motivo: aclarar el alcance real del audit en v1.

Sistema​

Tarea: revisar system status y general settings​

Objetivo​

Consultar visibilidad operativa basica y ajustar branding o tema global.

Antes de empezar​

  • Ya abriste Admin settings.

Pasos​

  1. Entra a System Status para revisar RAM, CPU, GPU y storage.
  2. Entra a General para revisar app name, logo y light o dark mode.

Resultado esperado​

Puedes revisar el estado operativo basico de la plataforma y ajustar la configuracion general disponible en v1.

Limites y notas​

  • System Status es solo lectura.
  • Si falta informacion de GPU, la interfaz debe degradar de forma simple.
  • General no convierte la plataforma en un sistema multi-tenant; solo ajusta configuracion basica de la app.
Captura de pantalla pendiente

ID: admin-system-status — Mostrar: entradas de System Status (RAM, CPU, GPU, storage) y General (app name, logo, tema). Motivo: cubrir visibilidad operativa y branding en un mismo bloque.

Cuando pedir ayuda​

  • Si una accion esta bloqueada, revisa si protege una regla minima como conservar al menos un Admin activo.
  • Cuando reportes un problema, comparte tu rol, la accion bloqueada o la clase afectada, y una captura del estado que ves.