Refactor code structure for improved readability and maintainability

2026-04-09 16:27:31 -04:00
parent 5e80949269
commit f2f9cef0e7
21 changed files with 768 additions and 116 deletions
@@ -0,0 +1,66 @@
+# Brochure Comercial - Plataforma Studio
+
+## 1) Qué es Studio
+Studio es la plataforma de autoría académica de OpenCCB para diseñar, publicar y administrar cursos de alta fidelidad. Está orientada a instituciones educativas, equipos académicos y docentes que necesitan construir experiencias de aprendizaje interactivas sin fricción técnica.
+
+## 2) Propuesta de valor
+- Diseño instruccional en un entorno moderno y visual.
+- Creación de lecciones modulares con bloques interactivos.
+- Banco de preguntas reutilizable para evaluaciones.
+- Gestión de usuarios, cursos y configuraciones institucionales.
+- Integración con LMS Experience para consumo de contenidos por estudiantes.
+
+## 3) Capacidades principales
+- Gestión de cursos: creación, edición, estructura por módulos y lecciones.
+- Constructor de lecciones: bloques de texto, multimedia, quiz, respuestas cortas, ordenamiento, matching, hotspot, audio-response, peer review, role-playing y mermaid.
+- Plantillas: plantillas de curso y de pruebas para estandarizar procesos.
+- Biblioteca de assets: administración y reutilización de recursos multimedia.
+- Banco de preguntas: catálogo de preguntas filtrable por tipo y dificultad.
+- Analítica y seguimiento: soporte para revisión de progreso y evaluaciones.
+- Branding institucional: logo, favicon y colores de marca.
+
+## 4) Beneficios para la institución
+- Reduce tiempos de producción académica.
+- Estandariza calidad de contenidos.
+- Facilita colaboración entre docentes y equipos de diseño instruccional.
+- Mejora la trazabilidad de evaluaciones y resultados.
+- Acelera despliegues de nuevos programas y cursos.
+
+## 5) Flujo recomendado de uso
+1. Configurar branding institucional.
+2. Crear curso y definir módulos.
+3. Diseñar lecciones con bloques interactivos.
+4. Configurar evaluaciones y rúbricas.
+5. Publicar y monitorear desempeño.
+
+## 6) Capturas sugeridas (fotos)
+Pantalla de acceso
+
+![Pantalla de acceso](assets/studio/01-login-studio.png)
+
+Vista principal de cursos
+
+![Dashboard de cursos](assets/studio/02-dashboard-cursos.png)
+
+Editor de lección con bloques
+
+![Editor de leccion](assets/studio/03-editor-leccion.png)
+
+Banco de preguntas y filtros
+
+![Banco de preguntas](assets/studio/04-banco-preguntas.png)
+
+Librería de recursos
+
+![Libreria de assets](assets/studio/05-library-assets.png)
+
+Editor de rúbricas
+
+![Rubricas](assets/studio/06-rubricas.png)
+
+Administración de usuarios
+
+![Administracion de usuarios](assets/studio/07-admin-usuarios.png)
+
+## 7) Mensaje comercial breve
+Studio convierte el diseño académico en un proceso más rápido, controlado y escalable. Permite a la institución pasar de la idea al curso publicado con calidad pedagógica y consistencia operacional.
@@ -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