Refactor code structure for improved readability and maintainability

docs/MANUAL_USUARIO_STUDIO.md

@@ -0,0 +1,140 @@
+# Manual de Usuario - Plataforma Studio
+
+## 1) Objetivo
+Este manual explica cómo usar Studio para crear y administrar cursos, lecciones y evaluaciones.
+
+## 2) Perfil de usuario
+- Docentes
+- Diseñadores instruccionales
+- Administradores académicos
+
+## 3) Acceso a la plataforma
+1. Ir a Studio en el navegador.
+2. Iniciar sesión con credenciales institucionales.
+3. Verificar que el menú principal muestre los módulos habilitados para el rol.
+
+Captura recomendada:
+
+![Login Studio](assets/studio/01-login-studio.png)
+
+## 4) Navegación principal
+- Cursos: listado y gestión de cursos.
+- Librería: administración de archivos y recursos.
+- Banco de preguntas: creación y reutilización de preguntas.
+- Plantillas: estandarización de contenidos.
+- Configuración: opciones de perfil y parámetros generales.
+
+Captura recomendada:
+
+![Dashboard de cursos](assets/studio/02-dashboard-cursos.png)
+
+## 5) Crear un curso
+1. Entrar a Cursos.
+2. Seleccionar Crear curso.
+3. Definir título y descripción.
+4. Guardar para habilitar el editor completo.
+
+Buenas prácticas:
+- Usar nombres claros por nivel/tema.
+- Definir objetivos de aprendizaje desde el inicio.
+
+## 6) Editar estructura (módulos y lecciones)
+1. Abrir un curso.
+2. Crear módulos.
+3. Agregar lecciones por módulo.
+4. Ordenar secuencia de aprendizaje.
+
+Captura recomendada:
+
+![Editor de lección](assets/studio/03-editor-leccion.png)
+
+## 7) Constructor de lecciones por bloques
+Tipos recomendados de bloque:
+- Description
+- Media
+- Quiz
+- Fill in the blanks
+- Matching
+- Ordering
+- Short answer
+- Hotspot
+- Audio response
+- Peer review
+- Role playing
+- Mermaid
+
+Flujo:
+1. Agregar bloque.
+2. Configurar contenido e instrucciones.
+3. Guardar cambios.
+4. Previsualizar.
+
+## 8) Banco de preguntas
+1. Entrar a Banco de preguntas.
+2. Crear nueva pregunta.
+3. Definir tipo, dificultad y enunciado.
+4. Guardar y reutilizar en evaluaciones.
+
+Captura recomendada:
+
+![Banco de preguntas](assets/studio/04-banco-preguntas.png)
+
+## 9) Libreria de assets
+1. Subir recursos (imágenes, audio, documentos).
+2. Etiquetar y organizar.
+3. Insertar recursos desde lecciones.
+
+Captura recomendada:
+
+![Librería de assets](assets/studio/05-library-assets.png)
+
+## 10) Rúbricas de evaluación
+1. Crear rúbrica por curso o actividad.
+2. Definir criterios y niveles.
+3. Asignar puntajes por nivel.
+4. Guardar al finalizar la edición.
+
+Captura recomendada:
+
+![Rúbricas](assets/studio/06-rubricas.png)
+
+## 11) Administración de usuarios (rol admin)
+1. Entrar al panel de administración.
+2. Buscar usuario.
+3. Editar rol o estado.
+4. Guardar cambios.
+
+Captura recomendada:
+
+![Administración de usuarios](assets/studio/07-admin-usuarios.png)
+
+## 12) Solución de problemas comunes
+- No veo menús esperados:
+  Verificar sesión activa y rol del usuario.
+- No se guardan cambios:
+  Confirmar conexión y permisos del curso.
+- Recursos no cargan:
+  Revisar formatos permitidos y tamaño del archivo.
+
+## 13) Recomendaciones operativas
+- Definir convención de nombres para cursos y módulos.
+- Usar plantillas para mantener estándar pedagógico.
+- Revisar cada lección en previsualización antes de publicar.
+- Mantener el banco de preguntas limpio y etiquetado.
+
+## 14) Checklist de publicacion
+- Objetivos definidos.
+- Lecciones ordenadas.
+- Bloques revisados.
+- Evaluaciones probadas.
+- Rúbricas listas.
+- Recursos multimedia verificados.
+
+## 15) Anexo: inventario de fotos para documentación
+- docs/assets/studio/01-login-studio.png
+- docs/assets/studio/02-dashboard-cursos.png
+- docs/assets/studio/03-editor-leccion.png
+- docs/assets/studio/04-banco-preguntas.png
+- docs/assets/studio/05-library-assets.png
+- docs/assets/studio/06-rubricas.png
+- docs/assets/studio/07-admin-usuarios.png