1. Anatomía de la Interfaz (El Mapa Visual) 🗺️

"Antes de tocar la primera nota, conoce tu espacio de trabajo. Cada elemento de la pantalla tiene un propósito musical, no decorativo."

AulaChord no es un editor de partituras tradicional. Es un laboratorio de armonía en tiempo real donde la información fluye desde tus manos hasta el análisis teórico sin interrumpir tu creatividad. La interfaz está dividida en zonas estratégicas que trabajan juntas como un ecosistema musical.

Vamos a recorrer este mapa visual paso a paso.

1.1 Controles Principales: Barra de Herramientas y Zona Central

[PLACEHOLDER: IMAGEN PANORÁMICA]

Puesto de mando: Configuración del contexto tonal y modo de inserción.

Aquí configuras qué información quieres procesar y cómo. Aunque algunos selectores están en la barra de herramientas, los controles operativos más importantes se ubican en la zona central, justo entre el pentagrama y los paneles inferiores de instrumentos:

Semáforo de Entrada (Botón ON/OFF)

El indicador visual de estado (Atajo: Ctrl/Cmd + K). Si está en ON (Verde), las notas que tocas se registran en AulaChord. Si está en OFF (Rojo), activas el Modo Monitor: escuchas el sonido pero no se registra en la partitura. Útil cuando solo quieres probar ideas sin alterar la zona de trabajo y sin compromiso de análisis.

Selectores de Instrumento (Iconos Piano/Guitarra)

Dos botones que despliegan paneles completos de trabajo, no simples visualizadores:

• 🎹 Piano (Ctrl/Cmd + 1): Un teclado de 88 teclas con distribución automática entre claves de Sol y Fa, código de colores pedagógico que revela errores armónicos en tiempo real, y asistente de digitación didáctico (clic derecho = alternar mano al instante, clic izquierdo = ciclo de asignar/seleccionar/borrar dedo).

• 🎸 Guitarra (Ctrl/Cmd + 2): Un diapasón interactivo con generador de posiciones basado en el sistema CAGED, exploración de inversiones, modo construcción para diseñar acordes nota a nota, asistente de digitación didáctico para mano derecha y guías diatónicas que mapean toda la escala sobre el mástil.

Ambos paneles están sincronizados bidireccionalmente para graficar lo seleccionado en el pentagrama.

Armadura de Clave

La armadura de clave establece el contexto tonal de tu pieza (ej. 1 sostenido = Sol Mayor o Mi menor). Se modifica mediante:

• Atajos de teclado: Ctrl/Cmd + → añade un sostenido, Ctrl/Cmd + ← añade un bemol, Ctrl/Cmd + D resetea la armadura
• Menú Configuración: Opciones "Añadir Sostenido", "Añadir Bemol" y "Resetear Armadura"

Selector de Duración

La duración de las notas que vas a insertar se controla mediante:

• Atajos de teclado: 5 (negra), 6 (blanca), 7 (redonda)
• Puntillo: Tecla . (punto) para activar/desactivar el puntillo
• Menús: También disponible en los menús de la aplicación

Piensa en esto como el "pincel" que eliges antes de pintar.

Modo de Conducción de Voces

Un menú desplegable para elegir entre SATB Estricto (máxima vigilancia académica), Teclado Estricto (balance entre rigor y libertad), o Libre (Teclado) (permiso de paralelismos para jazz/neo-soul).

Contexto Armónico

AulaChord tiene el poder de análisis para trabajar en modo Auto (Tonal) (identificando inteligentemente relaciones Mayor/Menor según la progresión), pero también tienes el poder de forzar el contexto a uno de los 6 modos griegos complementarios (Dórico, Frigio, Lidio, Mixolidio, Eólico, Locrio). El Contexto que elijas modifica radicalmente el análisis de los números romanos.

Selectores MIDI

Listas desplegables para elegir de dónde viene la señal (Input) y por dónde suena (Output). El sistema detecta automáticamente los dispositivos disponibles. Esta salida es compatible con los dispositivos MIDI de tu computadora o los que tengas conectados.

1.2 El Espacio de Trabajo (Workspace)

[PLACEHOLDER: IMAGEN DESTACADA]

El Pentagrama Dinámico: Visualización gramatical de la armonía en tiempo real.

El centro de la aplicación, donde tus ideas cobran forma visual:

El Pentagrama Dinámico (Grand Staff)

Es un espacio que reacciona a tus manos en milisegundos. Visualiza simultáneamente la clave de Sol (mano derecha) y la clave de Fa (mano izquierda). El sistema distribuye automáticamente tus notas de la forma más legible posible para un músico. Tiene incorporado un sistema de saltos de pentagrama que se van agregando a medida que te vas extendiendo; también puedes insertar un salto manual con Ctrl/Cmd + Enter y navegar entre sistemas con PageUp / PageDown.

Cifrados Flotantes (Americano y Romano)

AulaChord muestra dos niveles de información sobre cada acorde:

1. Americano (Cmaj7, Am7): Identifica el "evento" armónico. Estos son los "Nombres Dorados" del sistema, consistentes en todo el software.
2. Romano (I, IV, V): Explica la lógica funcional y por qué ese acorde funciona en relación con la tonalidad.

Interacción: La tecla , (coma) cicla simultáneamente la visualización de ambos cifrados, alternando su posición (arriba o abajo del pentagrama) o escondiéndolos completamente.

El Splitter Vertical

La línea divisoria que separa el pentagrama de los instrumentos inferiores. Pasa el ratón sobre ella y arrástrala: puedes dar más espacio al pentagrama para leer mejor o al piano para ver mejor las teclas.

1.3 El Panel Inferior: Toca con lo que Tengas a Mano

Tu interfaz de entrada visual. Cambia según lo que necesites ver en cada momento de la composición.

Zona de Piano Virtual

[PLACEHOLDER: IMAGEN]

Piano didáctico: Código de colores que enseña la estructura armónica mientras tocas.

Un teclado de 88 notas totalmente interactivo:

Código de Colores del Teclado

Los colores no son estética, son enseñanza instantánea. AulaChord usa un sistema de cinco niveles en el pentagrama y una paleta simplificada de tres niveles en el piano:

• ⚪ Color Neutro — Núcleo del acorde: raíz, 3ª y 5ª justas; notas sin tensión ni gravedad tonal.
• 🟢 Verde — Gravedad Tonal: 6tas, 7mas y extensiones con atracción hacia el siguiente acorde.
• 🟡 Amarillo — doble rol: en el piano marca tu foco de navegación/ejecución; en el pentagrama también puede señalar una advertencia de disposición (cruces de voces, distancias grandes).
• 🔴 Rojo — Errores estrictos: quintas u octavas paralelas y otras infracciones de conducción. En el piano, además, unifica en rojo tanto las advertencias de disposición como los errores graves.
• 🔵 Azul — Nota individual seleccionada: aparece exclusivamente al hacer clic con el ratón sobre una nota; activa su modo de edición (Del, transposición, enarmonía) en pentagrama y piano simultáneamente.

Para la explicación completa de cada nivel — incluyendo la lógica pedagógica del amarillo dual (navegación vs. advertencia) y la filosofía de la "escala de temperatura musical" — consulta §8.5: Sistema de Gravedad Tonal.

Nota (Pentagrama vs. Piano): El pentagrama muestra los 5 niveles de análisis. El Piano Virtual usa 3 niveles de ejecución: Amarillo = foco activo, Azul = edición por clic, Rojo = cualquier alerta. Al activar el Modo Digitación, la paleta cambia a 🔵 Cian (Mano Derecha) y 🩷 Rosa (Mano Izquierda) — ver §4.5.

Modo de Digitación

Modo de Digitación: ¿Quieres practicar posiciones o crear material pedagógico? Activa el botón de Digitación (👋) en la barra de controles del panel. La interfaz es 100% automática y sin menús: el sistema detecta la clave en la que está escrita la nota en el pentagrama y colorea la tecla (Cian para clave de Sol/Mano Derecha, Rosa para clave de Fa/Mano Izquierda). Un clic izquierdo en tecla vacía asigna el dedo. Un segundo clic sobre ese dígito lo selecciona (permitiéndote reasignar el número presionando del 1 al 5 en tu teclado QWERTY), y un tercer clic lo borra. Si necesitas corregir la mano detectada, un clic derecho sobre el dígito ya colocado alterna la mano al instante (Cian ↔ Rosa), sin desplegar ningún menú.

Nota: La asignación de dedos (clic izquierdo) y la alternancia de mano (clic derecho) solo funcionan si el Modo Digitación está activo. Con el modo desactivado, los clics ejecutan el comportamiento normal del piano (sonido y escritura).

Zona de Diapasón de Guitarra

[PLACEHOLDER: IMAGEN]

Diapasón interactivo: Lógica de 6 cuerdas que entiende la ergonomía de tu mano.

Un mástil que entiende la ergonomía de la mano. Muestra exactamente dónde estás pisando y te ayuda a "graficar" posiciones complejas:

• Selectores de Raíz / Calidad / Inversión: Las listas desplegables en la barra de controles del panel (entre el pentagrama y el diapasón) con las que eliges el acorde y AulaChord lo dibuja y valida automáticamente. Es la vía más rápida de explorar posiciones.- Botón Construir Acorde: Para el modo manual de diseño de voicings
• Botón ↑ (Commit — Enviar al Pentagrama): Para enviar tu diseño al pentagrama. Atajo equivalente: tecla Enter.
• Botón Guías: Muestra u oculta los nombres de las notas diatónicas según la tonalidad configurada en el pentagrama (ej. si estás en Do Mayor, verás do, re, mi, fa, sol, la, si sobre el diapasón)

[!NOTE]
Nota del Mentor: El diapasón no solo muestra notas, enseña la ergonomía de tu instrumento. Cada posición sugerida respeta las limitaciones reales de la mano humana en el mástil.

1.4 Los Paneles Flotantes: Tus Colegas Silenciosos

[PLACEHOLDER: IMAGEN]

El Tutor y el Analista: Tus colegas silenciosos que validan y sugieren caminos creativos.

Herramientas avanzadas que aportan una capa de inteligencia extra cuando la necesitas. Estos paneles son flotantes: puedes moverlos, redimensionarlos y colocarlos donde prefieras en tu espacio de trabajo.

Panel de Análisis Armónico (Ctrl/Cmd + 3)

Una ventana flotante que muestra todos los acordes de tu progresión como tarjetas visuales por grado de escala (I, II, III, IV…). Cada tarjeta indica el número romano del grado y la nota raíz (por ejemplo, una tarjeta I con Do, tarjeta IV con Fa). Al seleccionar un acorde en el pentagrama la tarjeta correspondiente se resalta. Ideal para tener una visión panorámica funcional de toda tu progresión.

Panel del Tutor (Ctrl/Cmd + T)

Una ventana flotante que eleva tu música. Cuando existe una transición entre dos acordes, el Tutor propone caminos armónicos alternativos: modificar inversiones, añadir extensiones, redistribuir voces — convirtiendo una progresión funcional en algo sofisticado y profesional. Los errores de conducción viven en el pentagrama (colores y líneas rojas) y en la Barra de Estado; el Tutor te indica el camino para superarlos.

Laboratorio de Voicings (Ctrl/Cmd + 4)

Una herramienta interactiva y predictiva diseñada para transformar la textura de un acorde en tiempo real. Actúa como tu taller personal de orquestación: te permite aplicar disposiciones orquestales (Drop 2, Drop 3, Drop 2&4, etc.) manteniendo anclada la melodía superior o la línea de bajo. Además de la rotación clásica de octavas, incluye el motor de "Inversión Drop" real, desplazando diatónicamente todas las voces sin destruir el color armónico.

Ventana del Intérprete (M)

El modo de proyección en vivo de AulaChord. Al pulsar M, la interfaz se limpia completamente, y solo queda la música en un tamaño gigante, optimizado para que sea legible a distancia. Esta es la funcionalidad prometida en la landing page como "Modo Vista en Vivo", diseñada específicamente para:

• Clases online: Pantalla compartida perfectamente legible para tus estudiantes
• Presentaciones en vivo: Proyectar tu análisis armónico en tiempo real durante conciertos o talleres
• Lectura a distancia: Leer cómodamente desde lejos del monitor mientras tocas

El pentagrama y los cifrados se muestran con tipografía aumentada para máxima claridad visual.

AI Assistant (Ctrl/Cmd + Shift + A)

[PLACEHOLDER: IMAGEN]

Diálogo del AI Assistant: Prompt musical listo para ser enviado a Gemini o Claude, demostrando tecnología que no estorba.

Tu puente con inteligencias artificiales externas (ChatGPT, Gemini, Claude). Genera prompts profesionales con el contexto musical de tu pentagrama, listos para copiar y pegar en tu IA favorita. La IA es tu consultor externo, no tu jefe interno.

Captura de Pentagrama (Ctrl/Cmd + Shift + I)

Crea capturas de alta resolución de cualquier sección del pentagrama y la copia al portapapeles. Ideal para crear materiales didácticos, ilustraciones para libros o thumbnails de video. La captura incluye el fondo tal como se visualiza en la aplicación.

Exportación a MusicXML (Menú Archivo)

Exporta tu trabajo a formato MusicXML 4.0, el estándar universal de intercambio de partituras. Esto te permite:

• Abrir tu progresión en MuseScore, Sibelius o Finale para edición avanzada
• Compartir con otros músicos que usan diferentes software de notación
• Archivar tu trabajo en un formato estándar y duradero

El diálogo de exportación te permite configurar título, compositor, tempo y compás antes de guardar el archivo .musicxml.

Panel de Atajos de Teclado (Menú Ayuda)

Una referencia completa de todos los comandos y sus atajos de teclado, organizada por categorías:

• Archivo y Edición: Operaciones básicas (Nuevo, Guardar, Copiar, Pegar)
• Navegación: Movimiento entre acordes y páginas
• Edición Musical: Modificación de notas, duraciones, enarmonías
• Visualización: Controles de zoom, paneles, modos de vista
• Panel del Tutor: Atajos específicos para el modo Tutor

Esta ventana flotante te permite consultar rápidamente cualquier atajo sin interrumpir tu flujo de trabajo.

1.5 La Barra de Estado (Footer): El Susurrador

La franja al final de la ventana es el "susurrador" que te da información clave sin interrumpir tu flujo:

• Indicador de Octava: Fundamental si usas el teclado QWERTY. Te dice en qué registro estás trabajando (ej. Octava: 3, Octava: 4)
• Monitor de Mensajes: Aquí aparecerán confirmaciones de guardado, y mensajes informativos sobre el estado del sistema (cambio de modo, conexión MIDI, acciones de portapapeles, etc.)

1.6 Funciones de Copia de Análisis (Menú Edición)

Estas funciones te permiten copiar el análisis armónico directamente desde el pentagrama al portapapeles:

• Copiar Cifrado Americano (Ctrl/Cmd + Shift + C): Copia el cifrado americano del acorde seleccionado (ej. "Cmaj7", "Dm7")
• Copiar Cifrado Romano (Ctrl/Cmd + Shift + R): Copia el análisis funcional del acorde seleccionado (ej. "Imaj7", "iim7")

Estas funciones están disponibles desde el menú Edición y funcionan sobre el acorde que tengas seleccionado en el pentagrama.

Navegación del Manual