# 🧠 Evaluación Diagnóstica Inteligente

> Una herramienta revolucionaria impulsada por IA para transformar la evaluación educativa diagnóstica

[![Licencia: MIT](https://img.shields.io/badge/Licencia-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![Idiomas](https://img.shields.io/badge/Idiomas-Espa%C3%B1ol%20|%20English-green.svg)](README.md)
[![Powered by Pollinations.ai](https://img.shields.io/badge/Powered%20by-Pollinations.ai-FF6B6B.svg)](https://pollinations.ai/)

[English Version](README_EN.md)

---

### 🚀 Impulsado por [Pollinations AI](https://pollinations.ai/)

Este proyecto integra y aprovecha al máximo el ecosistema de **[Pollinations AI](https://pollinations.ai/)**, una plataforma abierta y versátil que democratiza el acceso a modelos de lenguaje (LLMs) y de generación de imágenes de última generación. Gracias a la infraestructura y APIs de Pollinations AI, esta herramienta puede:

- Conectar de forma directa, rápida y sin servidores intermedios con múltiples modelos avanzados de texto (GPT, Gemini, Llama, Mistral, entre otros).
- Generar ilustraciones pedagógicas contextualizadas en tiempo real con modelos como *grok-imagine*, *ideogram* o *qwen-image*.
- Brindar una experiencia educativa personalizada, interactiva y accesible para docentes y estudiantes de todo el mundo.

---

## 👁️ Visión General

**Evaluación Diagnóstica Inteligente** es una aplicación web de vanguardia que aprovecha el poder de la inteligencia artificial para generar evaluaciones diagnósticas personalizadas, interactivas y pedagógicamente sólidas. Diseñada específicamente para educadores, esta herramienta transforma la forma en que identificamos y comprendemos las necesidades de aprendizaje de los estudiantes.

## ❓ ¿Por Qué Esta Aplicación es Crucial para la Educación?

### 1. **Democratización de la Evaluación de Calidad**
Tradicionalmente, crear evaluaciones diagnósticas efectivas requiere:
- ⏳ Horas de trabajo docente
- 🎯 Expertise en diseño instruccional
- 💡 Conocimiento profundo de concepciones erróneas comunes
- 📊 Capacidad para crear retroalimentación diferenciada

Esta aplicación **democratiza el acceso** a evaluaciones de alta calidad, permitiendo que cualquier educador, independientemente de su experiencia o recursos, pueda generar instrumentos diagnósticos profesionales en minutos.

### 2. **Enfoque Pedagógico Basado en Evidencia**
La aplicación implementa principios educativos probados:

- **🚦 Semáforo de Retroalimentación**: Identificación clara de niveles de dominio
  - 🔴 Rojo: Necesita refuerzo / Concepción errónea
  - 🟡 Amarillo: Conocimiento parcial / Casi correcto
  - 🟢 Verde: Dominio correcto / Saberes previos sólidos

- **🎯 Evaluación Multinivel**: Cubre cuatro dimensiones críticas:
  1. Saberes previos y conceptos fundamentales
  2. Comprensión y razonamiento aplicado
  3. Identificación de concepciones erróneas
  4. Diagnóstico global y recomendaciones

### 3. **Personalización Instantánea**
Cada evaluación se adapta a:
- El tema específico que se está enseñando
- El nivel de expertise del docente evaluador
- El contexto educativo particular
- Las necesidades diagnósticas del momento

### 4. **Retroalimentación Formativa Inmediata**
En modo **formativo**, los estudiantes reciben:
- Feedback instantáneo sobre sus respuestas
- Explicaciones claras de por qué una respuesta es correcta o incorrecta
- Orientación sobre áreas que necesitan reforzar
- Apoyo para el aprendizaje autodirigido

### 5. **Evaluación Sumativa Estructurada**
En modo **sumativo**, los docentes obtienen:
- Datos estructurados sobre el desempeño estudiantil
- Identificación precisa de brechas conceptuales
- Información para adaptar la instrucción
- Documentación del progreso del aprendizaje

## ✨ Características Principales

### Generación de Contenido con IA
- **Múltiples Modelos de IA**: GPT, Gemini, Llama, Mistral, y más
- **Preguntas Contextualizadas**: Adaptadas al tema y nivel específico
- **Detección de Mitos**: Identifica concepciones erróneas comunes
- **Retroalimentación Diferenciada**: Respuestas personalizadas según el nivel de respuesta

### Experiencia Visual Personalizable
- **🎨 10 Paletas de Colores**: Desde Oceanic hasta Steel Blue
- **🎭 20 Estilos Visuales**: Moderno, Educativo, Infantil, Científico, y más
- **🌓 Modo Oscuro/Claro**: Comodidad visual adaptable
- **📱 Diseño Responsivo**: Funciona en cualquier dispositivo

### Integración de Contenido Rico
- **🖼️ Generación de Imágenes**: Soporte para múltiples modelos (grok-imagine, ideogram, qwen-image)
- **📐 Soporte MathJax**: Notación matemática profesional
- **📊 Visualización Interactiva**: Semáforo de diagnóstico animado

### Modos de Evaluación
- **📝 Sumativa**: Envío de resultados por correo electrónico
- **💡 Formativa**: Retroalimentación inmediata e interactiva

### Multiidioma
- **🌐 Español e Inglés**: Interfaz y contenido completamente traducidos
- **🔄 Cambio Dinámico**: Alterna entre idiomas sin perder el progreso

### Exportación Flexible
- **🌐 Descarga HTML**: Guarda evaluaciones para uso offline
- **📄 Descarga Word**: Compatible con procesadores de texto

## 🎓 Impacto Educativo

### Para Docentes
- ⏱️ **Ahorro de Tiempo**: De horas a minutos en la creación de evaluaciones  
- 🎓 **Calidad Profesional**: Instrumentos pedagógicamente sólidos  
- 🛠️ **Adaptabilidad**: Personalización para cualquier tema o nivel  
- 📊 **Datos Accionables**: Información clara para guiar la instrucción  
- 🔄 **Actualización Continua**: Acceso a los últimos modelos de IA

### Para Estudiantes
- 🎯 **Aprendizaje Personalizado**: Retroalimentación adaptada a su nivel  
- 🧠 **Metacognición**: Comprensión de sus propias fortalezas y debilidades  
- 🚀 **Autonomía**: Herramientas para el aprendizaje autodirigido  
- 💪 **Motivación**: Feedback constructivo y orientado al crecimiento  
- ♿ **Accesibilidad**: Interfaz clara y múltiples estilos de aprendizaje

### Para Instituciones Educativas
- 📈 **Estandarización**: Evaluaciones consistentes y de calidad  
- 🏫 **Escalabilidad**: Implementación en múltiples niveles y áreas  
- 🔍 **Análisis de Brechas**: Identificación sistemática de necesidades  
- 💡 **Innovación Pedagógica**: Adopción de tecnologías educativas avanzadas  
- 💰 **Costo-Efectividad**: Herramienta gratuita de nivel profesional

## 🛠️ Instalación y Uso

### Requisitos Previos
- Navegador web moderno (Chrome, Firefox, Safari, Edge)
- API Key de Pollinations AI ([Obtener aquí](https://enter.pollinations.ai/))

### Instalación

```bash
# Clonar el repositorio
git clone [https://github.com/tu-usuario/evaluacion-diagnostica.git](https://github.com/tu-usuario/evaluacion-diagnostica.git)

# Navegar al directorio
cd evaluacion-diagnostica

# Abrir en el navegador
# Simplemente abre index.html en tu navegador favorito

### Uso Rápido

1. **Configuración Inicial**
   - Abre `index.html` en tu navegador.
   - Haz clic en "Obtener API Key" para obtener tu clave de Pollinations AI.
   - Pega tu API Key en el campo correspondiente.

2. **Crear una Evaluación**
   - Selecciona tu idioma preferido (🇪🇸 Español / 🇬🇧 English).
   - Ingresa el experto evaluador (ej: "matemáticas", "biología").
   - Ingresa el tema a evaluar (ej: "Fotosíntesis", "Ecuaciones cuadráticas").
   - Selecciona el tipo de prueba (Sumativa o Formativa).
   - Personaliza colores, estilo visual y modelos de IA.
   - Haz clic en "🚀 Generar evaluación diagnóstica".

3. **Usar la Evaluación**
   - **Modo Formativo**: Los estudiantes responden y reciben feedback inmediato.
   - **Modo Sumativo**: Los estudiantes completan y envían por correo al docente.

4. **Exportar**
   - Descarga en HTML para uso offline.
   - Descarga en Word para edición adicional.

### 🎨 Personalización

#### Paletas de Colores
- Oceanic (predeterminada)
- Sunset
- Forest
- Royal Purple
- Crimson Night
- Golden Sands
- Minty Fresh
- Graphite Lime
- Rose Quartz
- Steel Blue

#### Estilos Visuales
- Predeterminado
- Moderno
- Corporativo
- Creativo
- Minimalista
- Glassmorphism
- Dark Neón
- Brutalista
- Gradiente Vibrante
- Editorial / Revista
- Terminal / Tech
- Infográfico Colorido
- Retro / Vintage
- Pastel Brutalista
- Cyberpunk
- Ecológico / Orgánico
- Noir Oscuro
- Educativo / Académico 🎓
- Infantil / Divertido 🎈
- Científico / Laboratorio 🧪

#### Modelos de IA Disponibles
- **Texto:**
  - GPT 5.4 Nano (predeterminado)
  - GPT 5.4 Mini
  - Gemini 2.5 Flash
  - Gemini Flash Lite 3.5
  - Gemini 2.5 Search
  - Llama 3.3 70B
  - Llama 4 Scout
  - Mistral Small 4
  - Y más...
- **Imágenes:**
  - grok-imagine
  - ideogram-v4-turbo
  - qwen-image
  - Y más...

### 📚 Casos de Uso Educativos

1. **Educación Primaria**
   Tema: "Los animales vertebrados"
   Experto: "ciencias naturales"
   Estilo: Infantil / Divertido
   Tipo: Formativa (retroalimentación inmediata)
   
2. **Educación Secundaria**   
   Tema: "Ecuaciones de segundo grado"
   Experto: "matemáticas, álgebra"
   Estilo: Educativo / Académico
   Tipo: Sumativa (envío por correo)
   Incluir: MathJax activado
   
3. **Educación Superior**
   Tema: "Termodinámica: Primera Ley"
   Experto: "física, termodinámica"
   Estilo: Científico / Laboratorio
   Tipo: Formativa
   Incluir: MathJax activado + Imágenes
   
🔒 Privacidad y Seguridad
🛡️ Sin Almacenamiento de Datos: Los datos no se guardan en servidores.

💻 Procesamiento Local: La interfaz funciona completamente en el navegador.

🔑 API Key Privada: Se almacena localmente en tu navegador.

📖 Código Abierto: Transparencia total del código.

🚫 Sin Seguimiento: No se recopilan datos de uso.

🤝 Contribuciones
Las contribuciones son bienvenidas y apreciadas. Para contribuir:

Haz un Fork del repositorio.

Crea una rama para tu feature (git checkout -b feature/NuevaCaracteristica).

Haz Commit de tus cambios (git commit -m 'Agregar nueva característica').

Haz Push a la rama (git push origin feature/NuevaCaracteristica).

Abre un Pull Request.

📄 Licencia
Este proyecto está bajo la Licencia MIT. Ver el archivo LICENSE para más detalles.

👨‍🏫 Autor
Juan Guillermo Rivera Berrío

Diseñado con ❤️ para educadores y estudiantes en todo el mundo.

Desarrollado con:

Pollinations AI para la generación multimodal de texto e imágenes.

Tecnología DeepSeek V4.

Asistencia de Open Code.

🙏 Agradecimientos
A Pollinations AI por proporcionar una infraestructura abierta, accesible e innovadora para la IA.

A todos los educadores que inspiran mejores herramientas pedagógicas.

A la comunidad de código abierto por las bibliotecas utilizadas.

A los desarrolladores de modelos de IA que hacen posible esta tecnología.

A los estudiantes que son el centro de todo proceso educativo.