Manual de Usuario AulaChord: Índice Maestro

"Domina la herramienta, libera tu creatividad. Guía exhaustiva de cada función del software."

0. El Manifiesto: ¿Qué es esto y por qué debería importarme?

Sección para el músico que aterrizó aquí por accidente o curiosidad.

• 0.0 El Viaje del Músico: Del Problema a la Promesa
  • Acto I: La Parálisis ante el Pentagrama — La brecha entre lo que escuchas y lo que puedes escribir.
  • Acto II: La Revelación (El Eslabón Perdido) — AulaChord como traductor en tiempo real.
  • Lógica Determinista, No "Cajas Negras" — Certeza matemática vs. predicción de IA.
  • Acto III: La Promesa — Música como Geometría Visual — Ver la armonía como arquitectura viva.
• 0.1 Para Quiénes Creamos AulaChord (Historias Reales, No Estadísticas):
  • María: La pianista gospel que toca de oído.
  • Carlos: El estudiante de conservatorio en examen final.
  • Ana: La profesora que enseña online a 40 estudiantes.
  • Javier: El arreglista profesional contra reloj.
  • Pablo: El YouTuber que crea tutoriales de piano.
• 0.2 Por Qué AulaChord es Diferente (Características Únicas Verificadas):
  • Motor Harmonia (análisis funcional en tiempo real).
  • Sistema Unificado de Nombrado (Nombres Dorados, Filtros Pedagógicos).
  • Tutor Armónico (validador de conducción de voces).
  • Tutor que sugiere caminos creativos, no solo critica.
  • Control enarmónico preciso (QWERTY de 3 filas).
  • Compatibilidad sin límites (MIDI Bluetooth, Auto-escaneo, MusicXML).
  • Puente profesional con IA (AI Assistant, Importación Inteligente, Persistencia Educativa).
• 0.3 Tu Primer Contacto: 7 Minutos para Cambiar Tu Forma de Ver la Música:
  • Checkpoint 1: Tu primer acorde (30 segundos).
  • Checkpoint 2: Activa el Tutor Armónico (1 minuto).
  • Checkpoint 3: Visualiza las líneas de conducción (30 segundos).
  • Checkpoint 4: Solicita ayuda al Tutor (1 minuto).
  • Checkpoint 5: Smart Paste — La magia que acelera todo (1 minuto).
  • Checkpoint 6: Explora el diapasón de guitarra (1 minuto).
  • Checkpoint 7: Modo Intérprete para clase/stream (1 minuto).
  • Checkpoint 8: Consulta al AI Assistant (1 minuto).
• 0.4 Preguntas Frecuentes del Recién Llegado:
  • ¿Qué es AulaChord exactamente? Un laboratorio de armonía en tiempo real.
  • ¿Reemplaza mi software actual? No, lo potencia (exporta a MusicXML).
  • ¿Tengo que saber solfeo o leer partitura? No es obligatorio.
  • ¿Puedo usarlo si solo toco guitarra? Absolutamente sí.
  • ¿Necesito equipo caro o piano MIDI? No (funciona con QWERTY).
  • ¿Funciona sin conexión a internet? Sí, 100% offline.
  • ¿Qué modos armónicos soporta? Análisis Auto/Tonal y 6 modos griegos complementarios.
  • ¿Puedo transcribir canciones rápidamente? Sí, con Smart Paste.
  • ¿Esto sustituye a mi profesor? Nunca. Es un asistente complementario.
  • ¿Qué gano usándolo 10 minutos al día? Comprensión visual profunda de la música.

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

Entiende cada elemento de la pantalla.

• 1.1 La Barra Superior: Tu Puesto de Mando:
  • Semáforo de Entrada (Botón ON/OFF): Verde (ON), Rojo (OFF).
  • Selectores de Instrumento (Iconos Piano/Guitarra).
  • Armadura de Clave: Atajos Ctrl (⌘)/Cmd (⌘)+→ (sostenido), Ctrl (⌘)/Cmd (⌘)+← (bemol), Ctrl (⌘)/Cmd (⌘)+D (reset).
  • Selector de Duración: Teclas 5 (negra), 6 (blanca), 7 (redonda), . (puntillo).
  • Modo de Conducción de Voces: SATB Estricto, Teclado, Estilo Libre.
  • Contexto Armónico: Modalidad (Auto/Tonal, Dórico, Frigio, Lidio, Mixolidio, Eólico, Locrio).
  • Selectores MIDI: Input/Output con detección automática.
• 1.2 El Espacio de Trabajo (Workspace):
  • Pentagrama Dinámico (Grand Staff).
  • Cifrado Americano Flotante: Cicla posición con tecla , (coma).
  • Cifrado Romano Flotante: Cicla visualización con tecla , (coma).
  • El Splitter Vertical: Redimensionable entre pentagrama e instrumentos.
• 1.3 El Panel Inferior: Toca con lo que Tengas a Mano:
  • Zona de Piano Virtual:
    • 88 notas interactivas (A0-C8).
    • Código de Colores Pedagógico: Azul (selección/estructura), Amarillo (tensiones), Rojo (infracciones).
    • Modo de Digitación.
    • Indicador de Octava.
  • Zona de Diapasón de Guitarra:
    • Botón Construir Acorde.
    • Flecha hacia Arriba (Commit).
    • Botón Guías: Muestra nombres de notas diatónicas según tonalidad.
• 1.4 Los Paneles Flotantes: Tus Colegas Silenciosos:
  • Panel de Análisis Armónico (Ctrl (⌘)/Cmd (⌘)+Shift+H): Ventana flotante con bloques de cifrado americano, romano y contexto didáctico.
  • Panel del Tutor (Ctrl (⌘)/Cmd (⌘)+T): Ventana flotante con validación y sugerencias creativas.
  • Ventana del Intérprete (M): Modo de proyección en vivo para clases y presentaciones.
  • AI Assistant (Ctrl (⌘)/Cmd (⌘)+Shift+A): Generador de prompts para ChatGPT, Gemini, Claude.
  • Captura de Pentagrama (Ctrl (⌘)/Cmd (⌘)+Shift+I): Copia capturas de alta resolución al portapapeles.
  • Exportación a MusicXML (Menú Archivo): Exporta a MusicXML 4.0 para MuseScore, Sibelius, Finale.
  • Panel de Atajos de Teclado (Menú Ayuda): Referencia completa de comandos y atajos.
• 1.5 La Barra de Estado (Footer): El Susurrador:
  • Indicador de Octava: Registro actual para entrada QWERTY.
  • Monitor de Mensajes: Alertas, confirmaciones, estado del sistema.
• 1.6 Funciones de Copia de Análisis (Menú Edición):
  • Copiar Cifrado Americano (Ctrl (⌘)/Cmd (⌘)+Shift+C).
  • Copiar Cifrado Romano (Ctrl (⌘)/Cmd (⌘)+Shift+R).

2. Configuración Técnica y Entorno

Prepara tu estudio virtual para el éxito.

• 2.1 Instalación y Requisitos:
  • Compatibilidad con Windows 10/11, macOS, Linux.
  • Dependencias (Python 3.10+, PySide6).
• 2.2 Gestión de Audio y MIDI:
  • Detección automática de dispositivos (escaneo cada 2s).
  • MIDI Bluetooth compatible.
  • Teclados USB y interfaces MIDI.
  • Guía de latencia: VirtualMIDISynth, loopMIDI.
  • Función "Refrescar MIDI" para reconexión.
• 2.3 El Sistema de Archivos (.aula):
  • Anatomía del JSON: eventos, armadura, modo armónico, índice de análisis.
  • Reparación automática de archivos corruptos.
  • Exportación a MusicXML.
• 2.4 Persistencia de Preferencias:
  • Archivo user_settings.json.
  • Configuraciones guardadas automáticamente.

3. Entradas QWERTY, MIDI y otras

Detalle técnico de cómo entra la música al sistema.

• 3.1 Teclado MIDI Externo:
  • Sincronización Note On/Off.
  • Detección automática y MIDI Bluetooth.
• 3.2 Teclado QWERTY (Las 3 Filas):
  • Fila Superior (1-0): Sostenidos.
  • Fila Media (Q-I): Notas blancas.
  • Fila Inferior (A-K): Bemoles.
  • Control de Octavas: Z (bajar), X (subir).
  • Agrupación automática de acordes de bloque.
• 3.3 Piano Virtual en Pantalla:
  • Interacción con ratón y multitouch.
  • Código de colores: Rojo (tónica), Azul (estructura), Amarillo (tensiones).
• 3.4 Diapasón de Guitarra:
  • Construcción punto a punto.
  • Commit con Enter o flecha arriba.
  • Botón Guías para colores didácticos.
• 3.5 Pegar desde Portapapeles (Ctrl (⌘)/Cmd (⌘)+V):
  • Reconocimiento de texto con acordes.
  • Extracción de acordes desde letras (ignora palabras no musicales).
  • Parsing de JSON de ChatGPT/Gemini.
  • Integración con AI Assistant.
• 3.6 Control del Flujo de Trabajo:
  • Monitor (OFF) vs Escritura (ON).
  • Override Manual: Ctrl (⌘)/Cmd (⌘)+↑/↓ (octava), Q (enarmonía).

4. 🎹 El Piano: Arquitectura y Conducción

Lógica profunda del panel de teclado.

• 4.1 Lógica de Escritura Automática:
  • Smart Split Point (regla de brecha de 7 semitonos).
  • Corrección manual de distribución (Ctrl (⌘)/Cmd (⌘)+↑/↓).
• 4.2 Modos de Conducción:
  • Strict (SATB): máxima vigilancia académica.
  • Strict (Keyboard): balance entre rigor y libertad.
  • Free (Jazz): permiso de paralelismos.
• 4.3 Semáforo de Errores Visuales:
  • Líneas de conducción (L).
  • Colores: verde (correcto), rojo (error).
  • Panel del Tutor para diagnóstico.
• 4.4 Control de Visualización:
  • Zoom (+/-).
  • Splitter vertical.
  • Scroll horizontal.

5. 🎸 La Guitarra: El Laboratorio del Mástil

Herramientas para dominar las 6 cuerdas.

• 5.1 Diseño de Acordes:
  • Selectores de Tónica (C, C#, Db, D...).
  • Tipos de acordes: tríadas, séptimas, extensiones.
  • Inversiones (Fundamental, 1ra, 2da, 3ra).
• 5.2 Sistema CAGED:
  • Voicings canónicos por todo el mástil.
  • Botón "Cambiar Posición" para explorar voicings.
• 5.3 Guías Diatónicas:
  • Colores sobre el mástil para improvisación.
  • Sincronización con armadura de clave.
• 5.4 Interacción con el Pentagrama:
  • Commit: Enter o flecha arriba.
  • Actualización en tiempo real.

6. 📝 El Intérprete: Tu Pantalla de Directo

La herramienta definitiva para clases, streams y directos.

• 6.1 Activación y Configuración:
  • Atajo M para abrir/cerrar.
  • Persistencia de posición y tamaño.
• 6.2 Visibilidad Máxima:
  • Pentagrama de alto contraste.
  • Cifrados de gran tamaño.
  • Ventana Always-on-Top.
• 6.3 Flujo de Trabajo en Tiempo Real:
  • Visualización del evento "live".
  • Entrada QWERTY activa desde el Intérprete.
• 6.4 El Panel Didáctico:
  • Nombre del acorde y cifrado romano.
  • Intervalos del acorde.
  • Escalas compatibles para improvisación.
• 6.5 Sincronización con Ventana Principal:
  • Eventos confirmados, armadura, modo armónico.
• 6.6 Casos de Uso Ideales:
  • Streamers, práctica personal, ensayos de banda.

7. 🧠 Inteligencia Artificial y Datos

Intercambio de datos, prompts de IA y exportación avanzada.

• 7.1 El Ciclo de Consultas IA:
  • AI Assistant (Ctrl (⌘)/Cmd (⌘)+Shift+A).
  • Generador de prompts profesionales.
  • Persistencia de metadatos educativos (ai_metadata).
• 7.2 Importación Inteligente (Smart Paste):
  • Formatos: texto con barras, comas, JSON estructurado.
  • Re-análisis automático con Motor Harmonia.
• 7.3 Exportación:
  • Copiar Cifrado Americano (Ctrl (⌘)/Cmd (⌘)+Shift+C).
  • Copiar Cifrado Romano (Ctrl (⌘)/Cmd (⌘)+Shift+R).
  • Exportar MusicXML.
  • Reparación JSON automática.
• 7.4 Captura Visual:
  • Captura de pentagrama (Ctrl (⌘)/Cmd (⌘)+Shift+I).
  • Transparencia inteligente.
• 7.5 Flujo de Trabajo con ChatGPT/Gemini:
  • Ejemplos prácticos de rearmonización y escalas.

8. 🎓 Teoría Avanzada (Motor Harmonia)

El cerebro analítico del software.

• 8.1 Modos Armónicos Disponibles:
  • Tabla resumen del análisis Auto/Tonal y los 6 modos complementarios.
• 8.2 Análisis Modal en Detalle:
  • Dórico, Mixolidio, Lidio, Frigio con ejemplos.
• 8.3 Armonía Moderna:
  • Borrowed chords (bVI, bVII, iv).
  • Dominantes secundarias (V7/V, V7/ii, etc.).
  • Sustitución tritonal (subV7).
• 8.4 Reinterpretación Funcional (Slash Chords):
  • IV/V → V11, bVII/I → V9sus, iiø/V → V7alt.
• 8.5 Inteligencia de Tensiones:
  • Tabla de tensiones disponibles por tipo de acorde.
  • Avoid notes y rol del Tutor.
• 8.6 Consistencia del Nombrado:
  • NOMBRES_DORADOS y TECNICISMOS_A_EVITAR.
• 8.7 Motor Harmonia y Tutor:
  • Flujo de información y Caminos Creativos.

9. 🛡️ El Tutor: Tu Mentor Armónico

Sistemas que trabajan en segundo plano.

• 9.1 Activación y Uso:
  • Atajo Ctrl (⌘)/Cmd (⌘)+T.
  • Análisis de transiciones entre acordes.
• 9.2 Salvoconductos:
  • Patrones armónicos reconocidos (V7→I, ii→V, etc.).
• 9.3 Validación de Reglas:
  • Errores de movimiento (quintas, octavas paralelas).
  • Errores de resolución (séptima, sensible).
  • Visualización con líneas y colores.
• 9.4 Caminos Creativos:
  • Regla geométrica (3ras y 6tas).
  • Tipos de sugerencias: inversiones, extensiones, alternativos.
• 9.5 Anatomía del Panel:
  • Encabezado, estado, diagnóstico, sugerencias, tip.
• 9.6 Modos de Conducción y el Tutor:
  • Strict SATB, Strict Keyboard, Free Jazz.
• 9.7 Casos de Uso:
  • Estudiantes, compositores, improvisadores.

10. ⚡ Referencia de Menús y Comandos

Desglose total de cada acción disponible.

• 10.1 Menú Archivo: Nuevo, Abrir, Guardar, Exportar MusicXML.
• 10.2 Menú Editar: Deshacer, Copiar/Pegar, Smart Paste, Captura, AI Assistant, Ciclo Enarmónico (Q), Ciclo Análisis (Ctrl (⌘)/Cmd (⌘) + A).
• 10.3 Menú Ver: Zoom, Cifrado, Líneas de Conducción (L), Paneles, Intérprete (M).
• 10.4 Menú Configuración: Armaduras (Ctrl (⌘)/Cmd (⌘)+←/→), Modos, MIDI I/O.
• 10.5 Atajos QWERTY: Z/X (octava), Space (avanzar), 3 filas de notas.
• 10.6 Atajos de Construcción: Intervalos (Shift+2..9).
• 10.7 Tabla Resumen de Atajos: Referencia rápida consolidada.

11. 🎼 Guías de Solución de Problemas (Playbooks)

Estrategias paso a paso para roles específicos.

• 11.1 Profesor Online: Pizarra visual, Modo Intérprete.
• 11.2 Estudiante de Armonía: Modo Strict, líneas de conducción.
• 11.3 Arreglista/Compositor: Filtro de higiene, exportar MusicXML.
• 11.4 Guitarrista Creativo: Sistema CAGED, exploración de voicings.
• 11.5 Youtuber/Streamer: Modo Intérprete, captura PNG.
• 11.6 Músico Jazz/Neo-Soul: Modo Free, tensiones Berklee.
• 11.7 Transcriptor de Canciones: Smart Paste desde internet.
• 11.8 Integración con IA: Flujo completo ChatGPT/Gemini.

12. 🔧 Mantenimiento y Referencia Final

Kit de supervivencia.

• 12.1 Troubleshooting:
  • Audio, MIDI, enarmonías, análisis romano, Tutor, archivos corruptos.
• 12.2 Gestión de Preferencias:
  • user_settings.json y cómo resetear.
• 12.3 Glosario de Términos:
  • Conceptos fundamentales, Motor Harmonia, técnicos, CAGED.
• 12.4 Créditos y Vida del Proyecto:
  • Fuentes (Leland, Inter), tecnología (Python, PySide6, Mido).
• 12.5 Información de Contacto y Soporte.
• 12.6 Gestión de Licencia y Activación.

13. 🛒 Opciones de Compra y Acceso

Adquiere tu licencia para la experiencia completa.

14. ✅ ¡Gracias por tu compra!

Confirmación de pago exitoso, entrega de licencia y recursos útiles.