Bienvenido a la Documentación

Esta es la documentación completa del sistema Plan Maestro PRIME, una plataforma educativa integral que combina inteligencia artificial avanzada con herramientas de planificación pedagógica.

🧠 Sistema de Mapas Mentales

Descripción General

El sistema de mapas mentales permite generar visualizaciones interactivas y jerárquicas del contenido de documentos subidos al gestor. Esta funcionalidad analiza automáticamente la estructura del documento y crea un mapa mental organizado por temas principales, subtemas y detalles.

Características Principales

✨ Funcionalidades

• Generación automática: Analiza el contenido del documento y extrae la estructura jerárquica
• Visualización interactiva: Mapa mental con nodos expandibles/colapsables
• Tipos de nodos: Diferentes categorías (main, sub, detail) con colores distintivos
• Controles de zoom: Permite acercar/alejar la vista del mapa
• Expansión masiva: Botones para expandir/colapsar todos los nodos
• Responsive: Se adapta a diferentes tamaños de pantalla
• Compartir con link: Genera un enlace único para compartir mapas mentales con otros usuarios

🎨 Diseño Visual

• Temas principales: Gradiente púrpura (🟣)
• Subtemas: Gradiente azul (🔵)
• Detalles: Gradiente gris (⚪)
• Conectores: Líneas que unen los nodos jerárquicamente
• Animaciones: Transiciones suaves al expandir/colapsar

Cómo Usar

1. Subir un Documento

1. Ve a la sección "Documentos" en el dashboard
2. Sube un archivo PDF, TXT, DOC o DOCX
3. Espera a que el documento se procese

2. Generar el Mapa Mental

1. Selecciona el documento de la lista
2. Haz clic en el botón "🧠 Generar Mapa Mental"
3. Espera a que se procese el contenido
4. El mapa mental se abrirá en una ventana modal

3. Interactuar con el Mapa Mental

• Expandir nodo: Haz clic en cualquier nodo con hijos
• Colapsar nodo: Haz clic nuevamente en un nodo expandido
• Zoom: Usa los botones 🔍+ y 🔍- para ajustar el tamaño
• Expandir todo: Botón "Expandir Todo" para mostrar toda la estructura
• Colapsar todo: Botón "Colapsar Todo" para ocultar todos los detalles

4. Compartir Mapas Mentales

📚 Gestor de Documentos

Descripción

El Gestor de Documentos es una funcionalidad que permite a los usuarios subir archivos PDF, TXT y Word, cargar videos de YouTube, importar contenido de páginas web, y luego interactuar con ellos usando agentes especializados de IA. Los videos se transcriben automáticamente y todo el contenido se puede analizar, consultar, convertir en mapas mentales o presentaciones, y compartir fácilmente.

Características Principales

🚀 Subida de Archivos y Contenido

• Formatos soportados: PDF, TXT, DOC, DOCX
• Videos de YouTube: Carga videos mediante URL con transcripción automática
• Páginas web: Importa contenido de cualquier página web mediante URL
• Tamaño máximo: 10MB por archivo
• Validación: Tipo de archivo y tamaño
• Almacenamiento: Seguro por usuario en carpetas separadas

🤖 Agentes Especializados

💬 Chat Inteligente

• Conversaciones contextuales sobre documentos
• Historial de mensajes persistente
• Respuestas basadas en el contenido real del archivo

🧠 Mapas Mentales

📊 Crear Presentaciones

🔗 Compartir Presentaciones

🎥 Videos de YouTube (NUEVO!)

Uso

Subir Documentos

1. Navegar a /dashboard/documentos
2. Arrastrar archivos o hacer clic en "Seleccionar Archivos"
3. Esperar a que se complete la subida y procesamiento

Seleccionar Agente

1. Hacer clic en un documento subido
2. Elegir el agente más apropiado para la tarea
3. Comenzar la conversación

Cargar y Analizar Videos de YouTube

1. Navegar a /dashboard/documentos
2. Buscar la opción "Cargar Video de YouTube" o el botón correspondiente
3. Pegar la URL del video de YouTube que deseas analizar
4. Hacer clic en "Procesar Video" o "Transcribir"
5. Esperar a que el sistema:
   • Extraiga el audio del video
   • Transcriba el contenido automáticamente
   • Procese y analice el texto transcrito
6. Una vez procesado, el video aparecerá en tu lista de documentos
7. Hacer clic en el video para abrir el chat y comenzar a hacer preguntas

Cargar y Analizar Páginas Web

1. Navegar a /dashboard/documentos
2. Buscar la opción "Cargar Página Web" o "Importar URL" o el botón correspondiente
3. Pegar la URL de la página web que deseas analizar
4. Hacer clic en "Procesar Página" o "Importar Contenido"
5. Esperar a que el sistema:
   • Extraiga el contenido de la página web
   • Procese y analice el texto extraído
   • Organice el contenido de manera estructurada
6. Una vez procesado, la página web aparecerá en tu lista de documentos
7. Hacer clic en la página web para abrir el chat, generar mapas mentales o crear presentaciones

Chatear con Videos

1. Seleccionar el video procesado de tu lista
2. Elegir un agente especializado (Analizador, Resumidor, o Respondedor de Preguntas)
3. Hacer preguntas sobre el contenido del video, por ejemplo:
   • "¿Cuál es el tema principal de este video?"
   • "Resume los puntos clave mencionados"
   • "¿Qué se dice sobre [tema específico]?"
   • "¿En qué momento del video se habla de [concepto]?"
4. El sistema responderá basándose en la transcripción del video
5. Las respuestas pueden incluir referencias a momentos específicos del video

Generar Mapas Mentales desde Contenido

1. Selecciona un documento, video de YouTube o página web de tu lista
2. Haz clic en el botón "🧠 Generar Mapa Mental"
3. Espera a que el sistema procese el contenido y genere el mapa mental
4. Interactúa con el mapa mental: expande, colapsa y haz zoom
5. Para compartir, haz clic en "🔗 Compartir" y copia el enlace generado

Crear Presentaciones desde Contenido

1. Selecciona un documento, video de YouTube o página web de tu lista
2. Haz clic en el botón "📊 Crear Presentación" o "🎨 Generar Presentación"
3. Espera a que el sistema analice el contenido y genere las diapositivas
4. Revisa y edita la presentación según tus necesidades
5. Personaliza el diseño, colores y formato si lo deseas
6. Guarda la presentación para uso futuro

Compartir Mapas Mentales y Presentaciones

1. Abre el mapa mental o presentación que deseas compartir
2. Busca el botón "🔗 Compartir" o "📤 Compartir Link"
3. Haz clic en el botón para generar un enlace único
4. Copia el enlace al portapapeles
5. Comparte el enlace por correo, mensaje, WhatsApp o cualquier medio
6. Los receptores podrán acceder sin necesidad de iniciar sesión

📋 Planificaciones

Descripción

El sistema de Planificaciones de Plan Maestro PRIME ofrece herramientas inteligentes para facilitar la creación de planificaciones educativas estructuradas y alineadas con el currículo uruguayo. Con el modo inteligente del Formulador de Prompts, puedes generar planificaciones precisas y contextualizadas de manera eficiente.

Modo Inteligente: Formulador de Prompts

📚 Estructura de Selección

El Formulador de Prompts utiliza una estructura jerárquica que te guía paso a paso:

1. Tramo Educativo: Selecciona el tramo correspondiente (Tramo 1, Tramo 2, etc.)
2. Unidad Curricular (Espacio Curricular): Elige la materia o área curricular específica
3. Grado: Selecciona el grado o nivel educativo
4. Contenido: Elige el contenido específico del currículo perteneciente a ese grado

🚀 Cómo Usar el Modo Inteligente

💡 Ventajas del Modo Inteligente

• Precisión Curricular: Asegura que tus planificaciones estén alineadas con el currículo oficial uruguayo
• Ahorro de Tiempo: Evita tener que escribir manualmente toda la información curricular
• Consistencia: Genera prompts estructurados y consistentes para todas tus planificaciones
• Facilidad de Uso: Interfaz intuitiva con dropdowns que se filtran automáticamente
• Flexibilidad: Los prompts generados pueden usarse con cualquier agente de IA de tu preferencia

🎓 Casos de Uso

📖 Integración con el Currículo Uruguayo

El sistema está completamente integrado con el currículo educativo uruguayo, lo que significa que:

• Todos los espacios curriculares están disponibles según el tramo seleccionado
• Los grados y contenidos están organizados según la estructura oficial
• Los prompts generados incluyen la terminología y estructura correcta del currículo
• Las planificaciones resultantes están alineadas con las normativas educativas uruguayas

🎤 Funcionalidades de Audio - Plan Maestro

🎤 Grabación de Mensajes de Voz

Características

• Grabación de audio: Los docentes pueden grabar mensajes de voz directamente desde el navegador
• Transcripción automática: Los mensajes de voz se transcriben automáticamente usando OpenAI Whisper
• Edición de texto: Los usuarios pueden revisar y editar el texto transcrito antes de enviarlo
• Calidad optimizada: Configuración optimizada para voz con cancelación de eco y supresión de ruido

Cómo usar

1. Haz clic en el botón 🎤 Audio en la interfaz de chat
2. Se abrirá el panel de grabación de audio
3. Haz clic en 🎤 Grabar para iniciar la grabación
4. Habla tu mensaje
5. Haz clic en ⏹ Detener cuando termines
6. Revisa y edita el texto transcrito si es necesario
7. Haz clic en 📤 Enviar para enviar el mensaje

🔊 Audio en Tiempo Real (NUEVO!)

Características

• Audio en vivo: El Plan Maestro habla mientras escribe la respuesta
• Streaming de audio: Generación y reproducción en tiempo real
• Indicador visual: Ondas de sonido animadas mientras habla
• Experiencia natural: Como conversar con alguien real
• Control total: Activar/desactivar cuando quieras

Cómo usar

1. Activa el toggle 🎤 Audio en Vivo ON para habilitar el streaming
2. Envía un mensaje normal (texto o voz)
3. El Plan Maestro empezará a hablar mientras escribe
4. Verás ondas de sonido animadas y el indicador "Plan Maestro hablando..."
5. Escucha la respuesta en tiempo real mientras se va escribiendo

🎵 Respuestas de Audio Automáticas (Tradicional)

Características

• Generación automática: Las respuestas del Plan Maestro se pueden convertir automáticamente a audio
• Síntesis de voz natural: Usa OpenAI TTS para generar audio de alta calidad
• Control manual: Toggle para activar/desactivar la generación automática
• Reproducción integrada: Reproductor de audio con controles completos

🔧 Configuración Técnica

Características Técnicas:

• Transcripción de voz a texto
• Síntesis de texto a voz (normal y streaming)
• Grabación de audio en el sistema
• Reproducción de audio en tiempo real

Formatos Soportados

• Grabación: WebM con codec Opus
• Reproducción: MP3, WebM
• Transcripción: Español (configurado por defecto)

🎨 Generador de Imágenes con IA

Esta funcionalidad permite a los usuarios premium generar imágenes únicas.

Características

• ✅ Generación de imágenes en HD
• ✅ Múltiples tamaños (1024x1024, 1024x1792, 1792x1024)
• ✅ Calidad estándar y HD
• ✅ Estilos vívido y natural
• ✅ Descarga de imágenes generadas
• ✅ Galería de imágenes generadas
• ✅ Interfaz moderna y responsive
• ✅ Integración con sistema de autenticación
• ✅ Verificación de suscripción premium

Configuración

1. Variables de Entorno

Ejemplo de prompt para generar una imagen:

Quiero una imagen de una docente enseñando en un aula con un estudiante en la silla dando la clase y la docente con un lápiz en la mano.

Uso

Para Usuarios

1. Accede a la página desde el sidebar: "Generador de Imágenes"
2. Escribe una descripción detallada de la imagen que quieres generar
3. Selecciona el tamaño, calidad y estilo deseados
4. Haz clic en "Generar Imagen"
5. Espera a que se procese la imagen (puede tomar unos segundos)
6. Descarga la imagen haciendo clic en el botón de descarga

Limitaciones

• Solo usuarios premium pueden acceder
• Máximo 1000 caracteres por prompt
• Una imagen por solicitud
• Las imágenes se almacenan temporalmente (no se guardan en base de datos)

Imágenes Generadas

• Opción 1: (1024x1024, estándar) Cuadrada
• Opción 2: (1024x1792) Vertical
• Opción 3: (1792x1024) Horizontal

📝 Formulador de Prompts

Descripción

El Formulador de Prompts es una herramienta que ayuda a los docentes a crear prompts educativos estructurados y específicos para la planificación de clases. Utiliza dropdowns dependientes basados en el contenido curricular del archivo data.json y genera prompts que pueden ser copiados y pegados en cualquier otro agente de IA.

Características

• Dropdowns Dependientes: Los dropdowns se filtran automáticamente según las selecciones previas
• Generación de Prompts: Crea prompts estructurados sin necesidad de IA propia
• Interfaz Intuitiva: Diseño moderno y fácil de usar
• Copia al Portapapeles: Botón para copiar el prompt generado fácilmente
• Prompt Estructurado: Genera prompts con formato específico para contenido educativo

Estructura de Dropdowns

1. Tramo: Selecciona el tramo educativo (ej: "Tramo 1", "Tramo 2", etc.)
2. Espacio Curricular: Se filtra según el tramo seleccionado (ej: "Matemática", "Lengua Española", etc.)
3. Grado: Se filtra según el espacio curricular (ej: "3 años", "4 años", "5 años", etc.)
4. Contenido: Se filtra según el grado seleccionado (contenidos específicos del currículo)

Flujo de Trabajo

1. Selecciona el Tramo deseado
2. Elige el Espacio Curricular correspondiente
3. Selecciona el Grado específico
4. Elige el Contenido curricular
5. Haz clic en "Generar Prompt"
6. El prompt se genera y se muestra en pantalla
7. Haz clic en "📋 Copiar Prompt" para copiarlo al portapapeles
8. Pega el prompt en cualquier otro agente de IA de tu elección

Formato del Prompt Generado

El prompt generado sigue este formato:

Quiero una clase para el Tramo: [Tramo Seleccionado], el espacio curricular es: [Espacio Curricular], para la unidad curricular [Espacio Curricular], para el grado: [Grado] y el contenido es: [Contenido].

📄 Plan Docs - Editor de Documentos Completo

Descripción

Plan Docs es un editor de texto completo tipo Google Docs integrado en la plataforma, diseñado específicamente para docentes que necesitan crear, editar y gestionar documentos profesionales con todas las funcionalidades avanzadas.

Características Principales

🎨 Editor Completo

• Editor altamente eficiente y personalizable
• Interfaz intuitiva y familiar
• Barra de herramientas completa con todas las opciones de formato
• Menú desplegable con opciones avanzadas

📝 Funcionalidades de Edición

• Formato de texto: Negrita, cursiva, subrayado, tachado
• Colores: Color de texto y color de fondo
• Alineación: Izquierda, centro, derecha, justificado
• Listas: Numeradas, con viñetas, anidadas
• Encabezados: H1, H2, H3, H4, H5, H6
• Tablas: Insertar, editar, eliminar filas y columnas
• Enlaces: Hipervínculos internos y externos
• Imágenes: Insertar, redimensionar, alinear
• Código: Bloques de código con resaltado de sintaxis
• Citas: Bloques de citas estilizados

📁 Gestión de Documentos

• Carpetas: Organización por carpetas personalizadas
• Búsqueda: Búsqueda en títulos y contenido
• Etiquetas: Sistema de etiquetas para categorización
• Vista previa: Información de documentos en la sidebar
• Ordenamiento: Por fecha de modificación

💾 Guardado y Sincronización

• Auto-guardado: Cada 30 segundos automáticamente
• Guardado manual: Botón de guardar con indicador visual
• Sincronización: Datos guardados en MongoDB
• Historial: Control de versiones automático

📤 Exportación

• PDF: Exportación a PDF con formato preservado
• DOCX: Exportación a Word con estructura completa
• TXT: Exportación a texto plano
• HTML: Código HTML del documento

Uso

Crear un Nuevo Documento

1. Hacer clic en "Nuevo documento" en la sidebar
2. El documento se crea automáticamente en la carpeta seleccionada
3. Comenzar a escribir inmediatamente

Exportar Documentos

1. Hacer clic en "Exportar" en la barra superior
2. Seleccionar formato deseado (PDF, DOCX, TXT)
3. El archivo se descarga automáticamente

📅 Calendario y Recordatorios

Descripción

El sistema de Calendario y Recordatorios de Plan Maestro PRIME es una herramienta integral que te permite organizar y gestionar todas tus actividades educativas, clases, reuniones y eventos importantes. Con recordatorios automáticos y una interfaz intuitiva, nunca olvidarás una fecha importante.

Características Principales

📆 Visualización de Fechas

• Vista mensual: Calendario completo con todos los eventos del mes
• Vista semanal: Agenda semanal detallada con horarios
• Vista diaria: Lista de eventos del día actual
• Navegación intuitiva: Fácil desplazamiento entre meses y años
• Indicadores visuales: Colores distintivos para diferentes tipos de eventos

➕ Crear Eventos

🔔 Sistema de Recordatorios

El sistema de recordatorios te ayuda a no olvidar eventos importantes:

🎨 Categorías de Eventos

Cada evento puede ser categorizado para mejor organización:

• 📚 Clase - Actividades de enseñanza
• 👥 Reunión - Reuniones con colegas o padres
• 📝 Evaluación - Exámenes y evaluaciones
• 🎉 Evento - Actividades especiales
• 📌 Personal - Eventos personales

Cómo Usar

1. Acceder al Calendario

1. Navega a la sección "Calendario" desde el menú principal
2. El calendario mostrará la fecha actual por defecto
3. Usa las flechas para navegar entre meses

2. Crear un Nuevo Evento

1. Haz clic en el botón "➕ Nuevo Evento" o en cualquier día del calendario
2. Completa el formulario con la información del evento:
   • Ingresa el título del evento
   • Selecciona la fecha haciendo clic en el campo de fecha
   • Establece la hora de inicio y fin
   • Agrega el lugar (ej: "Aula 3", "Sala de profesores")
   • Opcionalmente, agrega una descripción detallada
   • Selecciona la categoría del evento
3. Configura el recordatorio:
   • Selecciona cuándo deseas recibir la notificación
   • Puedes configurar múltiples recordatorios para el mismo evento
4. Haz clic en "Guardar Evento"

3. Gestionar Eventos Existentes

• Ver detalles: Haz clic en cualquier evento del calendario para ver su información completa
• Editar: Haz clic en el botón "✏️ Editar" en los detalles del evento
• Eliminar: Usa el botón "🗑️ Eliminar" para borrar un evento
• Duplicar: Crea eventos similares rápidamente duplicando eventos existentes

4. Configurar Recordatorios

1. Abre un evento existente o crea uno nuevo
2. En la sección "Recordatorios", selecciona los tiempos deseados
3. Los recordatorios se mostrarán como:
   • Notificaciones en el navegador
   • Alertas en la aplicación (si está instalada)
   • Recordatorios visuales en el calendario
4. Guarda los cambios

Ejemplos de Uso

Características Avanzadas

🔍 Búsqueda y Filtros

• Búsqueda por título: Encuentra eventos rápidamente
• Filtro por categoría: Muestra solo eventos de un tipo específico
• Filtro por fecha: Busca eventos en un rango de fechas
• Filtro por lugar: Encuentra todos los eventos en un lugar específico

📊 Estadísticas

El calendario proporciona estadísticas útiles:

• Total de eventos del mes
• Eventos por categoría
• Horas totales de clases programadas
• Próximos eventos

📱 Sincronización

• Todos los eventos se guardan automáticamente en la nube
• Acceso desde cualquier dispositivo con tu cuenta
• Sincronización en tiempo real
• Respaldo automático de tus datos

Consejos y Mejores Prácticas

Solución de Problemas

❓ Preguntas Frecuentes

📝 Soporte para Markdown en Plan Docs

🎯 Funcionalidad Agregada

Plan Docs ahora incluye soporte completo para Markdown, permitiendo convertir automáticamente texto con formato Markdown a HTML rico cuando pegas contenido desde otros sistemas.

✨ Características

🔍 Detección Automática

El sistema detecta automáticamente si el contenido pegado contiene elementos de Markdown como:

• Texto en negrita (**texto**)
• Títulos (# Título, ## Subtítulo)
• Listas (- item, * item)
• Citas (> texto)
• Código (`código`)
• Enlaces ([texto](url))
• Tablas (| columna |)
• Bloques de código (``` ```)

📝 Cómo Usar

1. Pegado Automático

1. Copia texto con formato Markdown desde cualquier fuente
2. Pégalo en Plan Docs
3. El sistema detectará automáticamente el formato Markdown
4. Se convertirá a HTML rico instantáneamente

2. Conversión Manual

1. Escribe o pega texto con formato Markdown
2. Si el sistema detecta Markdown, aparecerá el botón "Convertir Markdown"
3. Haz clic en el botón para convertir el contenido actual
4. El texto se transformará en formato rico

🎨 Estilos Soportados

• ✅ Negrita (**texto**)
• ✅ Cursiva (*texto*)
• ✅ Tachado (~~texto~~)
• ✅ Código inline (`código`)
• ✅ Encabezados (H1, H2, H3, etc.)
• ✅ Listas ordenadas y no ordenadas
• ✅ Citas y bloques de texto
• ✅ Enlaces e imágenes
• ✅ Tablas
• ✅ Bloques de código

⚙️ Información del Sistema

Descripción General

Plan Maestro PRIME es una plataforma educativa integral diseñada específicamente para docentes uruguayos. El sistema combina inteligencia artificial avanzada con herramientas de planificación pedagógica, proporcionando una solución completa para la gestión educativa.

Arquitectura del Sistema

🔧 Tecnologías Principales

🤖 Inteligencia Artificial

El sistema utiliza tecnologías de IA de vanguardia para:

• Análisis de documentos: Procesamiento inteligente de contenido educativo
• Generación de contenido: Creación automática de materiales educativos
• Transcripción de voz: Conversión de audio a texto en tiempo real
• Síntesis de voz: Generación de audio a partir de texto
• Generación de imágenes: Creación de imágenes educativas personalizadas

Características del Sistema

📊 Capacidades Principales

Integración con el Currículo Uruguayo

📚 Contenido Curricular

Plan Maestro PRIME está diseñado específicamente para el sistema educativo uruguayo:

• Documentación ANEP: Integración con normativas y documentación oficial
• Tramos educativos: Soporte completo para todos los tramos del sistema
• Espacios curriculares: Adaptado a la estructura curricular uruguaya
• Metodologías activas: Herramientas para implementar metodologías modernas
• Evaluación: Soporte para diferentes tipos de evaluación

Seguridad y Privacidad

Rendimiento y Disponibilidad

⚡ Optimizaciones

• Carga rápida: Optimización de recursos y caché inteligente
• Respuesta inmediata: Interfaz reactiva y fluida
• Escalabilidad: Sistema preparado para crecer
• Disponibilidad 24/7: Acceso continuo desde cualquier lugar

Casos de Uso Principales

Compatibilidad y Requisitos

💻 Navegadores Soportados

• ✅ Google Chrome (recomendado)
• ✅ Mozilla Firefox
• ✅ Microsoft Edge
• ✅ Safari
• ℹ️ Opera

📱 Dispositivos

• Computadoras de escritorio: Experiencia completa con todas las funcionalidades
• Tablets: Interfaz adaptada para pantallas táctiles
• Móviles: Versión optimizada para dispositivos móviles

Actualizaciones y Mejoras

✨ Funcionalidades Recientes

• Audio en tiempo real: Streaming de audio durante las respuestas
• Calendario integrado: Sistema completo de gestión de eventos
• Soporte Markdown: Conversión automática en Plan Docs
• Generador de imágenes: Creación de imágenes educativas

Ayuda y Soporte