openccb/README_MANUAL.md

Manual de Usuario - OpenCCB Studio

Complementos y Guías de Instalación

📋 Archivos Incluidos

1. Manual_Usuario_OpenCCB_Studio.docx (43 KB)
   • Manual profesional completo en formato Microsoft Word
   • Contiene ~40-50 páginas de contenido
   • Estructura lista para agregar screenshots
   • Totalmente editable

🖼️ Cómo Agregar Screenshots al Manual

El manual incluye marcadores indicados con comentarios donde debe insertarse contenido visual. Para agregar screenshots:

Opción 1: Manualmente en Microsoft Word

1. Abra el documento en Microsoft Word o LibreOffice Writer

2. Acceda a la aplicación en studio.norteamericano.com

3. Tome screenshots de cada sección (Pantalla Completa = Windows + Shift + S)

4. En el Manual, ubique las secciones indicadas:

   • Sección 3: Panel Principal
   • Sección 5: Plantillas de Prueba
   • Sección 6: Plantillas de Curso
   • Sección 7: Creación de Cursos
   • Sección 8: Gestión de Lecciones
   • Sección 9: IA - Generación de Preguntas
   • Sección 10: Ejercicios y Evaluaciones
   • Sección 11: Configuración
   • Sección 12: Panel de Administrador
   • Sección 13: Análisis y Reportes

5. Inserte imagen:

   • Menú → Insertar → Imagen/Imagen desde archivo
   • Seleccione el screenshot
   • Ajuste tamaño a 6 pulgadas de ancho × 4 pulgadas de alto
   • Agregue título descriptivo debajo de la imagen

Opción 2: Script Automático (Avanzado)

Se proporciona add_screenshots_to_manual.py que puede:

• Importar screenshots desde carpeta
• Insertarlos automáticamente en lugares marcados
• Ajustar tamaños y resolución
• Agregar captions

Uso:

python3 add_screenshots_to_manual.py \
  --manual Manual_Usuario_OpenCCB_Studio.docx \
  --screenshots /ruta/a/capturas/ \
  --output Manual_Completo.docx

📸 Screenshots Recomendados

Sección 3: Panel Principal

• Captura de pantalla completa después del login
• Mostrar: Navegación, lista de cursos, estadísticas

Sección 5: Plantillas de Prueba

1. Lista de plantillas existentes
2. Formulario de crear nueva plantilla
3. Editor de preguntas
4. Vista con IA habilitada

Sección 6: Plantillas de Curso

1. Lista de plantillas
2. Formulario de creación
3. Editor de módulos
4. Vista de estructura completa

Sección 7: Creación de Curso

1. Diálogo de seleccionar plantilla
2. Formulario básico del curso
3. Configuración de acceso/fecha
4. Confirmación de creación exitosa

Sección 8: Gestión de Lecciones

1. Vista de lecciones en un curso
2. Editor de lección con bloques de contenido
3. Insertar video
4. Insertar archivo/recurso

Sección 9: IA

1. Botón "Generar con IA" en pantalla
2. Formulario de generación de preguntas
3. Preguntas generadas por IA
4. Opción de mejorar contenido

Sección 10: Ejercicios

1. Crear evaluación - formulario
2. Vista de quiz
3. Página de calificación
4. Rúbrica de evaluación

Sección 11: Configuración

1. Configuración de Branding (logo, colores)
2. Servicios de Email SMTP
3. Plantillas de Email personalizadas

Sección 12: Panel Admin

1. Dashboard de administración
2. Gestión de Usuarios
3. Reportes disponibles

Sección 13: Análisis

1. Dashboard de instructor
2. Gráficas de calificaciones
3. Progreso estudiantil
4. Exportación de reportes

🎨 Consejos para Screenshots

Calidad:

• Resolución mínima: 1920x1080
• Formato: PNG (mejor compresión) o JPG
• Contraste adecuado y legibilidad

Contenido:

• Oculte datos sensibles (emails, nombres reales)
• Use datos de demostración obvios
• Priorice interfaz sobre contenido

Redacción:

• Agregue captions descriptivos bajo cada imagen
• Ejemplo: "Fig. 1: Panel Principal mostrando cursos activos"

📝 Personalización

El documento puede personalizarse fácilmente:

1. Portada:

   • Cambiar nombre de organización
   • Agregar logo personalizado
   • Modificar fecha

2. Contacto:

   • Sección 14: Reemplazar email y teléfono
   • Agregar URL de help center

3. Branding:

   • Colores corporativos
   • Logo en encabezado
   • Temas personalizados

🔄 Traducción

Para traducir a otro idioma:

1. Abra el DOCX en Word
2. Menú → Revisar → Traducir
3. Seleccione idioma destino
4. Revise las traducciones automáticas

O use: python3 translate_manual.py --lang es --output Manual_ES.docx

📤 Distribución

El manual puede distribuirse como:

Formato Final:

• PDF (más profesional para distribución)

  • File → Export as PDF en Word
  • Mantiene formato, ideal para impresión

• DOCX (editable por usuarios)

  • Permite anotaciones
  • Actualizaciones fáciles

• HTML (para portales web)

  • Convertir con: python3 convert_to_html.py input.docx output.html

🛠️ Edición de Futuro

Para futuras ediciones:

1. Abra el .docx en Word
2. Actualice contenido según cambios de interfaz
3. Reemplace screenshots antiguas con nuevas
4. Aumente número de versión en portada
5. Re-exporte como PDF

📞 Soporte

Si encuentra problemas con:

• Generación de documento: Ejecute python3 generate_manual.py nuevamente
• Screenshots: Use herramienta captura nativa del SO
• Inserción de imágenes: Use script automático proporcionado

---

Versión: 1.0
Fecha: 15 de Abril de 2026
Formato: OpenCCB Studio - Manual de Usuario