# Armonía Lab Manual del Usuario

## Dictado de Progresiones Armónicas

Autor: Pablo Schvarzman

---

## 1. Propósito y Enfoque Pedagógico

El **Dictado de Progresiones Armónicas** es una estación de entrenamiento auditivo funcional diseñada para desarrollar la capacidad de reconocer enlaces armónicos, cadencias típicas y ciclos de acordes en tiempo real dentro de contextos tonales y modales reales.

### Objetivos Pedagógicos:
1. **Reconocimiento Funcional en Números Romanos:** Centrar el análisis en la relación funcional de cada acorde respecto al centro tonal ($I$, $ii$, $IV$, $V$, $vi$, etc.), permitiendo al estudiante trasladar cualquier progresión a las doce tonalidades cromáticas.
2. **Afianzamiento del Centro Tonal:** Incorporación del control *Tónica I de Referencia (Atajo: T)*, permitiendo escuchar el reposo tonal básico antes de iniciar el análisis del enlace completo.
3. **Desglose Compás a Compás:** Al resolver el ejercicio, la herramienta permite seleccionar cada acorde de la progresión de forma aislada, reproduciéndolo independientemente y reflejándolo en el pentagrama vectorial y teclado de piano.
4. **Discriminación Tímbrica Versátil:** Dispone de cinco motores sonoros Web Audio (Piano acústico, Pluck percusivo, Synth Brass, Synth Strings y Sinte V1 clásico) para simular arreglos de teclado, guitarras, metales sintéticos o cuerdas orquestales.
5. **Didáctica Progresiva:** Presets organizados por familias estilísticas (Pop Esencial, Cadencias Jazz, Pop Menor y Andaluz) para facilitar una curva de aprendizaje sólida y sin frustración.

---

## 2. Mapa de la Interfaz

### A. Cabecera y Marcador Compacto
* **Marcador de Aciertos:** Formato numérico directo `Aciertos / Intentos` (ejemplo `0/0`) en una insignia compacta.
* **Botón Reiniciar:** Icono de reinicio para poner a cero las estadísticas de la sesión.
* **Acceso a Documentación (i):** Botón de información directa vinculado a este manual técnico.

---

### B. Barra de Ajustes
* **Selector de Sonido (Desplegable):** Menú directo para escoger entre los cinco motores tímbricos:
  - *Piano Acústico:* Ataque de martillo y armónicos naturales; referencia canónica para audición tonal.
  - *Pluck Sintetizado:* Ataque inmediato y decaimiento corto; óptimo para seguir las fundamentales en el registro grave.
  - *Synth Brass:* Textura brillante y abierta inspirada en sintetizadores analógicos clásicos.
  - *Synth Strings:* Diente de sierra con ensanchamiento estéreo y ataque frotado continuo.
  - *Sinte V1:* Onda triangular pura orientada al análisis exclusivo de conducción interválica y voces.
* **Selector de Progresiones (Checklist Desplegable):** Despliega un panel interactivo con casillas de verificación individual por progresión y botones de presets inmediatos (*Pop*, *Jazz*, *Flamenco/Blues*, *Todas*).

---

### C. Modo de Articulación y Controles de Transporte
* **Modo de Articulación:**
  - *Bloque (Armónico):* Emite cada acorde como un todo armónico sostenido a tempo constante.
  - *Arpegio Ascendente:* Despliega las voces de cada acorde sucesivamente antes de pasar al siguiente compás.
* **Repetir Audio (Atajo: Barra Espaciadora):** Dispara de nuevo la secuencia armónica completa.
* **Tónica I de Referencia (Atajo: Tecla T):** Emite exclusivamente el acorde de tónica de la tonalidad en curso para calibrar el oído tonal relativo.
* **Siguiente Ejercicio (Atajo: Tecla Enter):** Genera una nueva progresión en una tonalidad aleatoria una vez resuelta la actual.
* **Rendirme y ver solución:** Revela de inmediato los números romanos y activa el visor interactivo.

---

### D. Rejilla de Respuesta Funcional
Pads interactivos identificados con los grados armónicos limpios:
* `I – V – vi – IV (Pop Axis)`
* `vi – IV – I – V (Pop Emocional)`
* `ii – V – I (Jazz Standard)`
* `I – vi – IV – V (Doo-Wop 50s)`
* `i – bVII – bVI – V (Andaluza / Frigia)`
* `I – IV – I – V – I (Blues Tradicional)`
* `i – bVI – bIII – bVII (Pop Menor Épico)`
* `I – bVII – IV – I (Rock Mixolidio)`

---

### E. Panel de Retroalimentación y Selector de Acordes
Al acertar o solicitar la solución:
1. **Identificación Tonal:** Especifica la tonalidad fundamental y el cifrado real de cada acorde (ejemplo: *Tonalidad: C Mayor · Acordes: C -> G -> Am -> F*).
2. **Barra Selectora de Compás:** Botones interactivos (`Todos`, `Compás 1: C`, `Compás 2: G`, etc.). Permite aislar y volver a escuchar un acorde concreto para verificar su color individual.
3. **Pentagrama Dividido por Compases (SMuFL Bravura):** Dibuja los acordes en clave de sol organizados con barras divisorias de compás y armadura tonal exacta.
4. **Teclado de Piano SVG:** Muestra la disposición de las notas del acorde seleccionado sobre el teclado de dos octavas.

---

## 3. Teoría Explicada y Presets Canónicos

### Las Tres Funciones Armónicas Fundamentales
Toda progresión tonal articula el movimiento entre tres estados de energía:
1. **Tónica (T):** Reposo absoluto, punto de partida y llegada ($I$ en mayor, $i$ en menor, $vi$ como sustituto menor).
2. **Subdominante (SD):** Tensión media, movimiento de alejamiento del centro tonal ($IV$, $ii$).
3. **Dominante (D):** Máxima tensión, inestabilidad que exige resolución obligatoria hacia la tónica ($V$, $V^7$, $vii^\circ$).

---

### Las 8 Progresiones Canónicas de Estudio

| Progresión | Movimiento Funcional | Modo | Ámbito Musical y Ejemplos |
| :--- | :--- | :--- | :--- |
| **$I - V - vi - IV$** | $\text{T} \rightarrow \text{D} \rightarrow \text{T}_\text{rel} \rightarrow \text{SD}$ | Mayor | El eje del Pop contemporáneo (*With or Without You*, *Let It Be*). |
| **$vi - IV - I - V$** | $\text{T}_\text{rel} \rightarrow \text{SD} \rightarrow \text{T} \rightarrow \text{D}$ | Mayor/Menor | Pop sentimental y épico (*Apologize*, *Faded*, *Save Tonight*). |
| **$ii - V - I$** | $\text{SD} \rightarrow \text{D} \rightarrow \text{T}$ | Mayor | La columna vertebral del Jazz, Bossa Nova y la música para cine. |
| **$I - vi - IV - V$** | $\text{T} \rightarrow \text{T}_\text{rel} \rightarrow \text{SD} \rightarrow \text{D}$ | Mayor | Baladas de los años 50 y Doo-Wop (*Stand By Me*, *Earth Angel*). |
| **$i - \flat VII - \flat VI - V$** | $\text{T} \rightarrow \text{Modal} \rightarrow \text{SD} \rightarrow \text{D}$ | Menor | Cadencia Andaluza / Flamenca (*Hit the Road Jack*, *Sultans of Swing*). |
| **$I - IV - I - V - I$** | $\text{T} \rightarrow \text{SD} \rightarrow \text{T} \rightarrow \text{D} \rightarrow \text{T}$ | Mayor | Arquetipo del Blues, Gospel, Folk y Rock & Roll clásico. |
| **$i - \flat VI - \flat III - \flat VII$** | $\text{T} \rightarrow \text{SD} \rightarrow \text{T}_\text{rel} \rightarrow \text{Modal}$ | Menor | Pop menor moderno y épica cinemática (*In the End*, *Zombie*). |
| **$I - \flat VII - IV - I$** | $\text{T} \rightarrow \text{Modal} \rightarrow \text{SD} \rightarrow \text{T}$ | Mixolidio | Rock clásico con subtónica bemol (*Sweet Home Alabama*, *Hey Jude*). |

---

## 4. Guía de Trabajo Paso a Paso

1. **Establecer la Referencia Tonal:**
   - Antes de reproducir el ejercicio, pulse la tecla **T** o el botón "Tónica I" para grabar en su memoria la nota de reposo tonal.
2. **Primera Escucha (Identificación de la Tónica):**
   - Dispare la progresión con la barra espaciadora.
   - Observe si la progresión arranca en tónica mayor ($I$), en tónica menor ($i$) o en el relativo menor ($vi$).
3. **Segunda Escucha (Movimiento de la Dominante):**
   - Busque el acorde de tensión máxima ($V$). ¿Aparece al final de la frase impulsando el reinicio del ciclo (como en $I - vi - IV - V$ o $ii - V - I$)? ¿O aparece inmediatamente después de la tónica (como en $I - V - vi - IV$)?
4. **Comprobación y Desglose:**
   - Seleccione la respuesta.
   - En caso de duda o tras acertar, utilice los botones del selector de compás para escuchar individualmente el acorde problemático y cotejarlo con el pentagrama.

---

## 5. Ejercicios Prácticos

### Ejercicio 1: El Duelo del Pop ($I - V - vi - IV$ vs. $vi - IV - I - V$)
- **Configuración:** Preset "Pop Esencial". Timbre: Piano. Articulación: Bloque.
- **Objetivo:** Alcanzar 15 aciertos seguidos diferenciando si el ciclo arranca con la afirmación luminosa de la tónica mayor ($I$) o con el tono reflexivo del relativo menor ($vi$).

### Ejercicio 2: La Tensión Cadencial Jazz ($ii - V - I$)
- **Configuración:** Filtro activado con $ii - V - I$ y $I - vi - IV - V$. Timbre: Synth Strings. Articulación: Arpegio Ascendente.
- **Objetivo:** Distinguir la preparación subdominante menor del segundo grado ($ii$) frente a la estabilidad inicial del primer grado ($I$).

### Ejercicio 3: La Fuerza Flamenca de la Cadencia Andaluza
- **Configuración:** Preset "Pop Menor & Andaluz". Timbre: Pluck. Articulación: Bloque.
- **Objetivo:** Detectar el descenso por semitono hacia la dominante mayor ($V$) de la cadencia andaluza frente al enlace modal moderno sin sensible de $i - \flat VI - \flat III - \flat VII$.

### Ejercicio 4: Subtónica Rock Mixolidio vs. Dominante Clásica
- **Configuración:** Filtro activado con $I - \flat VII - IV - I$ y $I - IV - I - V - I$. Timbre: Synth Brass. Articulación: Bloque.
- **Objetivo:** Reconocer el color relajado y no resolutivo de la subtónica bemol ($\flat VII$) frente a la tensión clásica de la dominante mayor ($V$).

### Ejercicio 5: Examen Funcional Completo
- **Configuración:** Preset "Todas las Progresiones". Timbre: Sinte V1. Articulación: Aleatoria.
- **Objetivo:** Completar una serie de 20 progresiones en distintas tonalidades cromáticas manteniendo un porcentaje de aciertos superior al 85 %, utilizando la tecla T de tónica únicamente como confirmación previa.