8. 🎓 Teoría Avanzada (Motor Harmonia)

"AulaChord no solo lee notas; entiende la intención y el alma que hay detrás de ellas. Es como tener a un graduado de Berklee y a un maestro del conservatorio sentados a tu lado."

El corazón analítico de la aplicación es nuestro motor Harmonia. Este sistema no es una simple base de datos de acordes; es un motor de inferencia entrenado para sintetizar las reglas de la armonía tradicional (Piston) con la libertad y frescura de la teoría de jazz moderna (Berklee). Aquí te explicamos cómo AulaChord "piensa" tu música.

8.1 Modos Armónicos Disponibles

AulaChord soporta análisis en múltiples modos. Puedes seleccionar el modo desde el Selector de Contexto Armónico en la barra de herramientas (junto al selector de tonalidad).

Análisis Romano en Modos: En los modos no-tonales, el cifrado romano mantiene la convención de mayúsculas/minúsculas según la calidad del acorde (I = mayor, i = menor), pero la función se lee respecto a la tónica modal. Por ejemplo, en Dórico de Re, el acorde de Sol Mayor es el IV (subdominante mayor, el acorde característico del Dórico por su 6ta). En Mixolidio de Sol, el acorde de Fa Mayor es el bVII — no es un acorde prestado sino diatónico del modo. AulaChord ajusta automáticamente el análisis romano cuando cambias el Contexto Armónico; no necesitas reconfigurarlo manualmente.

Cómo Cambiar el Modo

1. En la barra de herramientas, localiza el selector de Contexto Armónico (junto a la armadura de clave).
2. Haz clic para desplegar la lista de modos disponibles.
3. Selecciona el modo deseado. El análisis romano se recalculará instantáneamente.

8.2 Análisis Modal en Detalle

Vivimos en un mundo musical rico en colores. Por eso, AulaChord no asume que todo debe limitarse a las escalas tradicionales.

Dórico (El Color de la Esperanza)

• Rasgo distintivo: La 6ta Mayor sobre una tónica menor.
• Progresión típica: i - IV (ej. Dm7 - G7)
• Géneros: Jazz, Rock progresivo, Neo-Soul
• Ejemplo: "So What" de Miles Davis, "Oye Como Va" de Santana

Mixolidio (El Brillo del Blues)

• Rasgo distintivo: La 7ma menor sobre una tónica mayor.
• Progresión típica: I - bVII - IV (ej. G - F - C)
• Géneros: Rock clásico, Folk, Blues
• Ejemplo: "Sweet Home Alabama", "Norwegian Wood" (Beatles)

Lidio (El Sonido Estelar)

• Rasgo distintivo: La 4ta aumentada (tritono suave).
• Progresión típica: I - II (ej. F - G con F como tónica)
• Géneros: Bandas sonoras, Jazz fusión
• Ejemplo: "The Simpsons Theme", música de John Williams

Frigio (La Tensión Española)

• Rasgo distintivo: El bII mayor creando tensión melódica.
• Progresión típica: i - bII (ej. Em - F)
• Géneros: Flamenco, Metal, Música étnica
• Ejemplo: Cadencia andaluza Am - G - F - E

8.3 Armonía Moderna y "Robo" de Acordes

AulaChord entiende que la música moderna se basa en la sorpresa. El motor Harmonia identifica estructuras que otros softwares marcarían como errores.

Acordes de Intercambio Modal (Borrowed Chords)

El sistema reconoce automáticamente cuando decides "tomar prestados" acordes de la tonalidad paralela para añadir dramatismo:

Dominantes Secundarias

El sistema rastrea la cadena de tensión. Aquí están las más comunes:

Sustitución Tritonal (subV7)

Imprescindible en el Jazz. Si usas un Db7 para resolver hacia un Cmaj7, AulaChord no se confundirá; sabrá que estás aplicando una sustitución de tritono para una conducción de voces más cromática.

• Cómo funciona: El tritono (3ra y 7ma) de Db7 es idéntico al de G7, permitiendo la sustitución.
• Ejemplo: Dm7 - Db7 - Cmaj7 en lugar de Dm7 - G7 - Cmaj7

8.4 Reinterpretación Funcional (Slash Chords)

Un acorde escrito como una fracción (ej. F/G) puede ser mucho más que "un acorde sobre un bajo". AulaChord aplica una lógica de reinterpretación basada en el sonido global:

8.5 La Inteligencia de las Tensiones

No todas las notas añadidas a un acorde son iguales. La tabla siguiente es una referencia teórica de uso manual: te ayuda a decidir qué notas agregar o evitar según el tipo de acorde que estés construyendo.

💡 AulaChord detecta automáticamente los choques de avoid notes dentro del voicing. Con la opción Menú Ver → Alertas de Notas a Evitar activada, cualquier nota que forme un intervalo de semitono o novena menor con otra nota del mismo acorde se ilumina en ámbar en el pentagrama. Usa la tabla de abajo para entender qué notas son teóricamente conflictivas; la aplicación te las señalará en pantalla cuando actives la opción. Ten en cuenta que el cifrado del acorde debe estar reconocido para que los colores de gravedad se calculen — si el motor no identifica una fundamental, no hay contexto armónico del que partir.

Tensiones Disponibles por Tipo de Acorde

La clasificación a continuación solo aplica cuando hay un acorde activo reconocido — sin fundamental identificada, no hay gravedad ni fricción que calcular.

Sistema de Gravedad Tonal (Visualización en Pentagrama)

• AulaChord cuenta con un sistema visual (activable en el menú Ver -> Gravedad Tonal) que colorea las notas según su rol acústico:
  • ⚪ Color Neutro (Blanco o Negro según el tema) (Núcleo del Acorde): La estructura base (Raíz, 3era mayor/menor, 5ta justa). Estás en el núcleo — notas sin tensión ni gravedad.
  • 🟢 Verde (Gravedad Tonal): 6tas, 7mas, extensiones (9, 11, 13), sus (2, 4) y 5tas alteradas (b5, #5). También marca bajos flotantes en slash chords. Notas con atracción tonal — tenlas en cuenta al enlazar con el siguiente acorde.
  • � Ámbar (Alertas de Notas a Evitar): Cuando la opción Menú Ver → Alertas de Notas a Evitar está activa, una nota se ilumina en ámbar si forma un choque de semitono o novena menor con otra nota del mismo acorde. No es un error absoluto —puede ser intencional o estilístico—, pero el sistema lo señala para que lo evalúes conscientemente. (Desactivado por defecto.)
  • �🟡 Amarillo — dos comportamientos que conviene distinguir:
    • Amarillo de Navegación/Ejecución: Cuando te desplazas por el pentagrama con las teclas ←/→, el evento al que llegas se ilumina de amarillo. Igualmente, las notas que presionas físicamente (MIDI o teclado del ordenador) se iluminan de amarillo en el piano. Es tu foco actual — desaparece en cuanto te mueves a otro evento.
    • Amarillo de Advertencia Pedagógica: En el pentagrama, si un acorde presenta algo que mejorar en su disposición (cruces de voces, distancias mayores a una octava, sensibles descendentes sin resolver), se marca de amarillo. No es urgente, pero vale revisarlo. Este amarillo persiste incluso cuando el evento no está en foco.
  • 🔴 Rojo (Paralelismos / Errores Estrictos):** Quintas u octavas paralelas o directas. Si ves rojo, resuélvelas según el estilo o género que estés trabajando. Prioridad visual máxima. (Para ver el rastro visual del movimiento infractor, activa las Líneas de conducción en Menú Ver → Mostrar líneas de conducción — vienen desactivadas por defecto.)
• Avisos analíticos: El rojo de error estricto prioriza visualmente sobre cualquier otro color de gravedad.

Comportamiento del Amarillo en el Piano Virtual: El panel de piano no muestra el Amarillo de Advertencia Pedagógica — ese color de aviso existe únicamente en el pentagrama. En el teclado del piano, el Amarillo solo indica nota activa/presionada o evento en foco de navegación (←/→). Las advertencias de disposición del pentagrama (cruces de voces, distancias grandes) se traducen al piano como Rojo (alarma unificada), no como Amarillo. Si ves una tecla amarilla en el piano, es siempre navegación o ejecución — nunca una advertencia teórica.

💡 Pro-Tip — ¿Advertencia real o solo navegación? Para saber si un acorde está amarillo por una advertencia de disposición o simplemente porque está en foco, mueve el cursor a otro evento con las teclas de flecha. Si el amarillo desaparece, era el indicador de navegación. Si persiste, es una advertencia de disposición real que vale la pena revisar.

• Sugerencias alternativas: El Tutor puede sugerir vías armónicas alternativas cuando el cifrado del acorde está reconocido. Si el acorde no puede ser identificado por el motor, el Tutor no generará sugerencias para ese evento.

Nota de jerarquía: El color Rojo de infracción académica siempre tendrá prioridad visual sobre los colores de Gravedad Tonal (Verde, Amarillo). Si un error de conducción es detectado, la nota se mostrará roja incluso si técnicamente es una tensión disponible — la regla de conducción pesa más que el estado de la nota.

La Alarma Unificada del Piano: Esta sofisticada separación entre Amarillo (moderado) y Rojo (grave) es exclusiva del pentagrama analítico. En el Panel de Piano Virtual, ambas alertas se fusionan en un único color Rojo para proporcionar una alarma visual clara durante la ejecución rápida. El piano no necesita distinguir entre "regla de disposición" y "error estricto" — necesita decirte: "hay algo aquí que revisar". El pentagrama es tu maestro; el piano es tu alarma.

La escala de temperatura musical de AulaChord va del reposo absoluto a la infracción académicamente verificable: cuando una nota se muestra en su color neutro, está en reposo — es el núcleo del acorde, sin ninguna tensión activa. Si se vuelve verde, algo ha cambiado: esa nota tiene gravedad, un destino al que quiere moverse en el próximo acorde. El amarillo tiene doble rol: puede señalar el evento activo durante la navegación (←/→) o avisar que algo en la disposición puede mejorarse — no urgente, pero ya perceptible. Y el rojo es un alto académico: esas voces han hecho algo que la polifonía clásica lleva 400 años documentando como error.

Nota pedagógica: AulaChord no asigna colores por función armónica (tónica, dominante, subdominante). Esa información la entrega el cifrado romano, que es más preciso y transferible a cualquier contexto teórico. Los colores en AulaChord responden a la gravedad de cada nota dentro del acorde reconocido — no a su función en la progresión. Es una decisión pedagógica deliberada: aprender a leer el cifrado romano es más valioso a largo plazo que depender de un código de color que cambia con cada tonalidad.

8.6 Consistencia del Nombrado (Un Acorde, Un Nombre)

¿Alguna vez has tocado un acorde y un programa te dice que es "C6", mientras otro lo llama "Am7"? Es confuso, ¿verdad? En AulaChord esto no sucede.

La Promesa de Consistencia

Hemos diseñado el sistema para que el nombre de un acorde sea exactamente el mismo sin importar dónde lo veas:

• 📜 En el Pentagrama → Am7
• 🎸 En el Panel de Guitarra → Am7
• 🎹 En el Modo Intérprete → Am7
• 📊 En el Panel de Análisis → Am7
• 👨‍🏫 En las sugerencias del Tutor → Am7

Mecanismos Internos (Para Usuarios Técnicos)

AulaChord utiliza dos filtros pedagógicos definidos en music_theory.py:

1. NOMBRES_DORADOS: Calidades prioritarias que siempre se prefieren:
   {7, m7, Maj7, dim7, m7b5, aug7, 6, m6, m, ""}

2. TECNICISMOS_A_EVITAR: Sufijos que se evitan en favor de nombres más claros:
   {add, no3, no5, dyad}

Nombres Claros, Nunca Técnicos

8.7 Motor Harmonia y el Tutor: Trabajo en Equipo

El análisis armónico no vive aislado; alimenta directamente las funciones del Tutor.

Flujo de Información

1. Análisis: El Motor Harmonia analiza cada acorde y determina su función tonal.
2. Contexto: Considera los acordes anteriores para detectar patrones (cadencias, modulaciones).
3. Validación: Compara el movimiento con las reglas del modo de conducción seleccionado.
4. Sugerencias: Si detecta un problema, genera "Caminos Creativos" alternativos.

Caminos Creativos (Sugerencias del Tutor)

El Tutor no solo critica; sugiere alternativas basadas en:

• Conducción de voces más suave: Movimientos por grado conjunto o semitono.
• Tensiones Berklee: Acordes con tensiones disponibles que añaden sofisticación.
• Patrones geométricos: Solo acepta residuos de 3ras y 6tas (la "regla de oro" armónica).

Para más detalles sobre el Tutor, consulta la Sección 9.

8.8 Interacción con el Análisis (Alternativas y Ortografía)

AulaChord no pretende ser una máquina impositiva. A veces, un mismo grupo de notas puede tener múltiples interpretaciones funcionales válidas o requerir una corrección ortográfica específica. Por eso, el control final siempre es tuyo.

Ciclo de Análisis (Alternativas) — Explorador de Alternativas Analíticas (Ctrl/Cmd + A)

Un acorde de F6 tiene exactamente las mismas notas que un Dm7/F. Dependiendo de tu progresión, uno de esos dos análisis tendrá más sentido musical.

• Selecciona el acorde en el pentagrama.
• Presiona Ctrl/Cmd + A.
• El Motor Harmonia ciclará a través de todas las interpretaciones teóricamente correctas para ese set de notas, cambiando tanto el nombre americano como su análisis romano. Las alturas MIDI no cambian —las mismas teclas suenan—, pero la ortografía enarmónica puede ajustarse para ser coherente con el nuevo análisis. Así, tú decides cuál es la lectura correcta en tu contexto armónico.

Rotación de Enarmonía (Q)

La ortografía importa en partituras serias. Tocar la tecla negra entre Fa y Sol no es lo mismo si estás subiendo a Sol (Fa#) que si estás bajando a Fa (Solb).

• Selecciona una nota en el pentagrama.
• Presiona la tecla Q.
• El sistema rotará la nota a través de sus equivalentes enarmónicos (ej. de Fa# a Solb). Un ajuste fino indispensable para mantener una partitura limpia y de nivel profesional.

8.9 Shell Voicings: Ver el Esqueleto del Acorde

"Un músico de jazz que entiende los Shell Voicings ya no ve acordes de cinco notas — ve la raíz, la 3ra y la 7ma, y el resto se convierte en color."
— Filosofía de Berklee College of Music

Un Shell Voicing es la versión más reducida y funcional de un acorde: conserva solo las notas que definen su identidad armónica (el "quién eres de verdad") y descarta las que añaden color pero son prescindibles.

AulaChord puede iluminarte con esta perspectiva en cualquier momento: activa el menú Ver → Resaltar Tonos Guía (Shell) y el pentagrama amortiguará a gris claro las notas no esenciales, dejando en su color original solo el esqueleto del acorde.

⚠️ Solo es visual — tus notas están intactas. Las notas en gris siguen sonando, permanecen en tu archivo .aula y se exportarán completas al MusicXML. El modo Shell Voicing es una lente de análisis, no un editor: no borra, silencia ni omite ninguna nota. Puedes desactivarlo en cualquier momento y recuperar el color completo.

¿Qué son los Tonos Guía?

Los Tonos Guía (Guide Tones) son las notas que definen el carácter de un acorde de forma unívoca. En el Jazz, los más importantes son la 3ra (define si es Mayor o Menor) y la 7ma (define el color — dominante, Maj o semidisminuido). AulaChord amplía esta definición con las siguientes reglas, según los principios de Berklee:

Nota Jazz crítica — el tritono (intervalo 6):
En un Cm7b5 o Cdim, la Solb es la b5 estructural (hay 3ª menor). Es Tono Guía y se muestra en blanco.
En un C7#11 o Cmaj7#11, ese mismo F# es una tensión lidia (#11) con 3ª mayor presente. Es color, no esqueleto, y aparece en gris. AulaChord distingue estos dos casos automáticamente.

💡 Diferenciación inteligente: la misma nota —6 semitonos sobre la raíz— recibe un veredicto opuesto según el contexto. En un acorde disminuido o m7b5, el tritono es el b5 que define la disonancia estructural del acorde → Shell (blanco). En un dominante 7(#11) o Lydio Maj7#11, ese mismo intervalo es una tensión de color añadida sobre un dominante con 3ª mayor → gris. AulaChord consulta todo el acorde antes de decidir, no solo la nota aislada.

Un ejemplo práctico: Cmaj9#11

Activa Shell Voicing con el acorde Cmaj9#11 (Do, Mi, Sol, Si, Re, Fa#):

El resultado visual es inmediato: C y E en su color neutro (el núcleo del acorde), B en verde (Tono Guía con atracción tonal), y G, D, F# en gris. Tu ojo cae naturalmente sobre el esqueleto (C-E-B) y el cerebro empieza a reconocer el patrón en cualquier tonalidad.

¿Para qué sirve pedagógicamente?

• Estudiar reducción de acordes: Aprende a tocar solo el esqueleto de cualquier acorde sin perder su identidad.
• Analizar lead sheets avanzadas: Identifica visualmente qué notas de una partitura de jazz son estructurales y cuáles son tensiones del arreglista.
• Preparar voicings de teclado: Los pianistas de jazz suelen tocar los Shell Voicings en la mano izquierda y las tensiones en la derecha. AulaChord te muestra ese reparto en tiempo real.

Jerarquía de colores con otras capas activas

Si activas Shell Voicing al mismo tiempo que Gravedad Tonal, la interacción es musical, no arbitraria:

1. 🔴 Rojo (error de conducción): Prioridad absoluta. Siempre visible — incluso sobre el gris. Si una nota no esencial (que normalmente aparecería en gris) forma una quinta u octava paralela con otra voz, se mostrará en rojo, no en gris. El Shell Voicing nunca oculta un error de conducción.
2. 🟢 Verde (Gravedad Tonal): Los Tonos Guía conservan su color de gravedad (ej. la 7ma sigue siendo verde porque tiene atracción tonal).
3. ⬜ Gris claro (Shell Voicing): Solo las notas que no son Tonos Guía y no tienen error de conducción pasan a gris.

En resumen: activar ambas capas simultáneamente es la vista más completa. Verás el esqueleto en blanco, los tonos guía con gravedad en verde, y las extensiones/tensiones en gris — toda la jerarquía de importancia del acorde de un vistazo.

¿Qué pasa con el Piano y la Guitarra? El filtro Shell Voicing se aplica exclusivamente al pentagrama. El Panel de Piano Virtual y el Diapasón de Guitarra seguirán iluminando todas las notas —tensiones incluidas— con su color habitual. Estos paneles representan el estado físico de ejecución (qué teclas o trastes pisar), y eliminar notas de su vista sería contraproducente para tocar. El Shell Voicing es una lente analítica sobre la notación, no un filtro sobre los instrumentos visuales.