feat: token count implement

2026-03-17 12:07:56 -03:00
parent 41279585f6
commit be699ad6ab
44 changed files with 9032 additions and 167 deletions
@@ -0,0 +1,168 @@
+# 🎤 Guía de Audio para Preguntas
+
+## ¿Por qué agregar audio?
+
+El audio en las preguntas ayuda a:
+- ✅ Estudiantes con diferentes estilos de aprendizaje
+- ✅ Práctica de listening comprehension
+- ✅ Accesibilidad para estudiantes con dificultades visuales
+- ✅ Pronunciación correcta en idiomas
+
+## 📱 Cómo Grabar Audio
+
+### Opción 1: Con tu Celular (Recomendado)
+
+1. **Abre la app de grabadora** en tu celular
+2. **Graba la pregunta** en un lugar silencioso
+3. **Envía el archivo** a tu computadora (email, WhatsApp, cable USB)
+
+**Consejos:**
+- Habla claro y a velocidad normal
+- Evita ruido de fondo
+- Grabación corta: 5-30 segundos ideal
+
+### Opción 2: Con tu Computadora
+
+**Windows:**
+- Usa "Grabadora de voz" (incluida en Windows)
+- O usa [Online Voice Recorder](https://online-voice-recorder.com/)
+
+**Mac:**
+- Usa QuickTime Player → Archivo → Nueva grabación de audio
+- O usa GarageBand
+
+**Linux:**
+- Usa Audacity: `sudo apt install audacity`
+- O usa GNOME Sound Recorder
+
+### Opción 3: Usando el Editor de Preguntas
+
+1. Ve a `/question-bank` en Studio
+2. Crea o edita una pregunta
+3. En la sección "Audio de la Pregunta":
+   - Click en "Subir archivo de audio"
+   - Selecciona tu archivo MP3/WAV/OGG
+   - Preview del audio
+   - Guarda la pregunta
+
+## 📊 Formatos Soportados
+
+| Formato | Tamaño Máx | Calidad Recomendada |
+|---------|------------|---------------------|
+| MP3 | 10 MB | 128 kbps |
+| WAV | 10 MB | 44.1 kHz, 16-bit |
+| OGG | 10 MB | 128 kbps |
+
+## 💡 Mejores Prácticas
+
+### Para Preguntas de Listening
+
+```
+📝 Texto: "What color is the sky?"
+🎤 Audio: [Grabación clara: "What color is the sky?"]
+```
+
+### Para Preguntas de Pronunciación
+
+```
+📝 Texto: "Repeat: The quick brown fox"
+🎤 Audio: [Pronunciación modelo]
+```
+
+### Para Instrucciones
+
+```
+📝 Texto: "Listen and choose the correct answer"
+🎤 Audio: [Instrucción en inglés]
+```
+
+## 🚫 Errores Comunes a Evitar
+
+- ❌ Audio muy largo (> 1 minuto)
+- ❌ Ruido de fondo (tráfico, ventilador, etc.)
+- ❌ Volumen muy bajo o muy alto
+- ❌ Hablar muy rápido
+- ❌ Múltiples personas hablando
+
+## ✅ Checklist de Calidad
+
+Antes de subir tu audio:
+
+- [ ] Se escucha claro y sin ruido
+- [ ] Duración apropiada (< 1 min)
+- [ ] Volumen consistente
+- [ ] Pronunciación correcta
+- [ ] Formato MP3/WAV/OGG
+- [ ] Tamaño < 10MB
+
+## 📈 Ejemplo de Flujo de Trabajo
+
+### 1. Preparación
+```
+1. Abre tu banco de preguntas en Studio
+2. Ten lista la lista de preguntas
+3. Prepara tu celular o micrófono
+```
+
+### 2. Grabación
+```
+1. Graba cada pregunta por separado
+2. Nombra los archivos claramente:
+   - pregunta_001.mp3
+   - pregunta_002.mp3
+   - etc.
+```
+
+### 3. Subida
+```
+1. Ve a cada pregunta en Studio
+2. Sube el archivo de audio correspondiente
+3. Preview para verificar
+4. Guarda
+```
+
+## 🎯 Casos de Uso por Habilidad
+
+### 📖 Reading
+- Audio de la pregunta para estudiantes con dificultades visuales
+- Narración de pasajes cortos
+
+### 🎧 Listening
+- Diálogos para comprensión auditiva
+- Instrucciones en el idioma objetivo
+
+### 🗣️ Speaking
+- Modelos de pronunciación
+- Ejemplos de conversación
+
+### ✍️ Writing
+- Dictados
+- Instrucciones de escritura
+
+## 🔧 Solución de Problemas
+
+### "El audio no se reproduce"
+- Verifica el formato (MP3/WAV/OGG)
+- Verifica el tamaño (< 10MB)
+- Intenta subir de nuevo
+
+### "El audio se escucha mal"
+- Re-graba en un lugar más silencioso
+- Usa un micrófono externo si es posible
+- Ajusta el volumen de grabación
+
+### "El archivo es muy grande"
+- Comprime a MP3 con menor bitrate (128 kbps)
+- Corta silencios al inicio/final
+- Usa formato OGG (mejor compresión)
+
+## 📞 Soporte
+
+¿Problemas con el audio?
+- Revisa esta guía completa
+- Contacta al administrador del sistema
+- Revisa los logs del servidor
+
+---
+
+**Recuerda:** El audio es OPCIONAL pero MUY VALIOSO para la experiencia de aprendizaje.