Solución de Problemas
12. 🔧 Mantenimiento, Soporte y Referencia Final
"El kit de supervivencia del usuario experto. Todo lo que necesitas para que AulaChord sea tan fiable como tu propio instrumento."
En esta sección final, recopilamos los recursos necesarios para mantener tu flujo de trabajo libre de obstáculos técnicos y definimos los términos que te convertirán en un conocedor profundo de la herramienta.
12.1 Solución de Problemas (Troubleshooting) 🛠️
A veces la tecnología se interpone en el camino de la música. Aquí tienes los pasos de emergencia para los problemas más comunes.
🔊 "Toco y no escucho nada"
| Paso | Acción |
|---|---|
| 1 | Volumen del Sistema: Asegúrate de que el ordenador no esté en silencio. |
| 2 | Selector de Salida: En la Barra Superior, comprueba que el menú "Salida de Audio" tenga seleccionado un sintetizador (ej. Microsoft GS Wavetable Synth o VirtualMIDISynth). |
| 3 | Refrescar MIDI: Si los pasos anteriores fallan, ve a Ayuda -> Refrescar MIDI. Es el reinicio suave que soluciona el 90% de los conflictos de sonido. |
🎹 "Mi teclado físico no reacciona"
| Paso | Acción |
|---|---|
| 1 | Conexión Física: Desconecta y vuelve a conectar el cable USB. |
| 2 | Espera 2 segundos: AulaChord escanea automáticamente los puertos MIDI cada 2 segundos. |
| 3 | Selector de Entrada: Verifica en la barra superior que tu dispositivo esté seleccionado en el menú de entrada MIDI. |
| 4 | Interruptor de Monitor: Verifica que el botón de Monitor de Entrada esté activo (color encendido). |
🎵 "Aparecen notas extrañas (Si#, Mi#)"
No es un error, es Ortografía Musical correcta en ciertos contextos. Sin embargo, si la lectura se vuelve difícil:
| Paso | Acción |
|---|---|
| 1 | Usa la tecla Q sobre la nota seleccionada para cambiar su enarmonía (ej. de Si# a Do). |
| 2 | Reset Tonal: Pulsa Ctrl (⌘)/Cmd (⌘)+D para devolver la armadura a Do Mayor. |
| 3 | Verifica que la armadura sea correcta para tu pieza (Ctrl (⌘)/Cmd (⌘) + ←/→). |
📊 "El análisis romano no coincide con lo esperado"
| Paso | Acción |
|---|---|
| 1 | Modo Armónico: Verifica que el selector de Contexto Armónico tenga el modo correcto (Auto/Tonal, Dórico, etc.). |
| 2 | Armadura: Asegúrate de que la armadura corresponda a la tonalidad de tu pieza. |
| 3 | Ciclo de Análisis: Presiona Ctrl (⌘)/Cmd (⌘) + A sobre el acorde para ver interpretaciones alternativas. |
👨🏫 "Las sugerencias del Tutor no aparecen"
| Paso | Acción |
|---|---|
| 1 | Dos acordes necesarios: El Tutor necesita al menos 2 acordes consecutivos para analizar la transición. |
| 2 | Panel abierto: Asegúrate de que el Panel del Tutor esté abierto (Ctrl (⌘)/Cmd (⌘)+T). |
| 3 | Modo de conducción: Verifica que no estés en modo "Free" si esperas validación estricta. |
📁 "El archivo .aula no abre correctamente"
| Paso | Acción |
|---|---|
| 1 | Reparación Automática: AulaChord detecta archivos corruptos y activa reparación JSON automáticamente. |
| 2 | Mensaje de recuperación: Si ves un mensaje de "archivo reparado", revisa el contenido; es posible que se haya perdido algo. |
| 3 | Backup manual: Para archivos críticos, haz copias .aula frecuentes. |
12.2 Gestión de Preferencias 🔧
Archivo de Configuración: user_settings.json
AulaChord guarda tus preferencias en un archivo JSON dentro de la carpeta de la aplicación.
Se guardan automáticamente:
- Idioma de la interfaz
- Nivel de zoom
- Dispositivos MIDI seleccionados
- Modo de conducción de voces
- Tamaños de paneles
- Posición de ventanas flotantes
Cómo Resetear las Preferencias
Si experimentas comportamientos extraños:
- Cierra AulaChord completamente.
- Localiza y elimina el archivo
user_settings.jsonen la carpeta de la aplicación. - Reinicia AulaChord. Las preferencias volverán a los valores por defecto.
12.3 Glosario Pedagógico de Términos 📚
Para entender AulaChord, es vital hablar su mismo idioma musical.
Conceptos Fundamentales de Armonía
| Término | Definición |
|---|---|
| Acorde | Tres o más notas sonando simultáneamente. La "palabra" básica del lenguaje armónico. |
| Cifrado Americano | Sistema de nombrar acordes con letras (Am7, G7, Cmaj7). El "español" de la música popular y el jazz. |
| Cifrado Romano | Sistema de nombrar acordes con números romanos según su función tonal (I, V7, ii). El "latín" del análisis académico. |
| Conducción de Voces | El arte de mover cada nota de un acorde al siguiente de forma suave, evitando saltos bruscos y paralelismos prohibidos. |
| Voicing | La disposición específica de las notas de un acorde. Decidir qué nota va arriba y cuál abajo es el arte de "dar voz" a un acorde. |
Conceptos del Motor Harmonia
| Término | Definición |
|---|---|
| Motor Harmonia | El cerebro analítico de AulaChord. Sintetiza las reglas de armonía tradicional (Piston) con la teoría moderna de jazz (Berklee). |
| Salvoconducto | Un patrón armónico tan común (como V7→I) que se considera automáticamente válido, incluso si técnicamente viola alguna regla. |
| Caminos Creativos | Sugerencias alternativas que el Tutor ofrece para mejorar una transición problemática. |
| Nombres Dorados | Lista interna de calidades de acordes pedagógicas (7, m7, Maj7, dim7). AulaChord prioriza estos nombres sobre alternativas confusas. |
| TECNICISMOS_A_EVITAR | Sufijos técnicos (add, no3, no5, dyad) que el sistema evita en favor de nombres más claros. |
Conceptos Técnicos de la Aplicación
| Término | Definición |
|---|---|
| JSON (.aula) | El formato de archivo de AulaChord. A diferencia del MIDI, guarda notas, análisis y metadatos de IA en texto estructurado. |
| Latencia | El retardo entre tu pulsación y el sonido. Mantenerla baja es clave para tocar con fluidez. |
| SMuFL | Estándar moderno de fuentes musicales. Gracias a esto, el pentagrama tiene aspecto de grabado clásico de alta calidad. |
| ai_metadata | Información educativa de ChatGPT/Gemini que se preserva cuando importas acordes desde una IA. |
| MusicXML | Formato de intercambio estándar para software de notación (Sibelius, MuseScore, Finale). |
Sistema CAGED (Guitarra)
| Término | Definición |
|---|---|
| CAGED | Sistema de 5 formas básicas de acordes (C-A-G-E-D) que se desplazan por el mástil con cejilla. |
| Voicing Canónico | Posiciones predefinidas de acordes que representan las formas más comunes y ergonómicas. |
12.4 Créditos y Vida del Proyecto
AulaChord es un proyecto vivo que se construye sobre el trabajo de grandes comunidades.
Tipografía y Diseño
- Leland: Nuestra fuente musical, inspirada en los grabados clásicos de la editorial Peters.
- Lato/Inter: Fuentes de interfaz diseñadas para una lectura clara y profesional.
Tecnología de Soporte
- Python & PySide6 (Qt): Los motores que mueven la lógica y los gráficos.
- Mido: El lenguaje que nos permite hablar con tus teclados MIDI.
- Ruff: La herramienta que asegura que el código de AulaChord sea limpio, seguro y eficiente.
12.5 Información de Contacto y Soporte
Reportar Problemas
Si encuentras un bug o comportamiento inesperado:
- Describe los pasos exactos para reproducir el problema.
- Indica tu sistema operativo y versión de AulaChord.
- Si es posible, adjunta el archivo
.aulaque causa el problema.
Sugerencias de Mejora
AulaChord evoluciona gracias a la retroalimentación de usuarios como tú. Las sugerencias son bienvenidas, especialmente en áreas como:
- Nuevos modos armónicos
- Mejoras en la guitarra
- Nuevos patrones de salvoconducto
- Traducciones a otros idiomas
12.6 Gestión de Licencia y Activación 🔐
AulaChord utiliza un sistema de licencias inteligente diseñado para ofrecer la máxima seguridad sin interrumpir tu flujo creativo, permitiendo el uso profesional incluso en entornos sin conexión a internet.
Activación y Período de Gracia
- Activación Inicial: Requiere conexión a internet por única vez para validar tu clave de Lemon Squeezy y vincularla a tu hardware.
- Uso Offline: Una vez activada, la aplicación funciona 100% offline. Cada 7 días, AulaChord intentará realizar una validación silenciosa en segundo plano si detecta internet.
- Tolerancia: Si no dispones de conexión tras el séptimo día, se activa un Período de Gracia de 14 días adicionales. Durante este tiempo, la app sigue siendo plenamente operativa.
Seguridad Anti-Tampering
Para proteger la integridad del software, AulaChord incluye protección Anti-Tampering. Cualquier intento de modificar los archivos internos o el binario de la aplicación resultará en la inhabilitación automática y silenciosa de los motores de análisis musical y visualizado, garantizando que solo las copias originales y autorizadas mantengan su potencia pedagógica.
[!TIP]
Si cambias de ordenador o realizas una actualización mayor de hardware, es recomendable contactar a soporte para asegurar una transición fluida de tu licencia actual.
"La música es el lenguaje de las almas, y AulaChord es solo el papel y el lápiz que te ayudan a escribirlo mejor."