Seja bem-vindo ao KeysOfChords (KofC), o seu assistente de bolso e laboratório de harmonia prática para teclado!

O KofC App foi desenvolvido para desconstruir o empilhamento tradicional de terças e entregar voicings profissionais, conduções de vozes fluidas e arranjos abertos em um teclado virtual interativo.

Este guia vai te ensinar, passo a passo, a explorar todos os recursos da ferramenta.

1. Seleção de Tônica e Categoria de Acorde

No painel principal do aplicativo, você define a estrutura base da harmonia:

• Tônica (Root): Escolha a nota fundamental do acorde (de Dó a Si / C a B).
• Categoria/Qualidade: Selecione a família harmônica principal — Maior, Menor, Dominante, Meio-Diminuto, Diminuto ou Suspenso.

2. Painel Reativo de Extensões e Alterações (Smart Constraints)

O painel de opções permite adicionar tensões e alterações de forma dinâmica (6, 7, 7M, 9, b9, #9, 11, #11, 13, b13, b5, #5).

O motor do KofC possui trava lógica de incompatibilidades para evitar cifras inexistentes e guiar seu estudo:

• Ao selecionar 7M, a sétima menor (7) é desativada automaticamente.
• Em acordes menores, selecionar a 6 ajusta a tétrade para m6, desativando a sétima.
• O sistema previne conflitos diretos entre quintas alteradas e sextas/décimas terceiras, garantindo que a cifra gerada seja harmonicamente coerente.

3. Carrossel de Voicings, Drops e Inversões

Na parte superior da interface, o carrossel unifica a alternância entre posições fechadas e abertas:

• Posição Fundamental / Cerrada (Root): Exibe o acorde empilhado na ordem direta.
• Técnicas de Drop: Aplique Drop 2, Drop 3 e Drop 2&4 para abrir o som do acorde e criar espaço acústico entre as vozes.
• Inversões da Mão Direita: Alterne rapidamente entre a posição fundamental e as 1ª, 2ª ou 3ª inversões.
• Omissões (Omit): Suprima notas estruturais (como a tônica para criar rootless voicings ou a quinta).

4. Visualização no Teclado SVG (LH vs. RH)

O teclado SVG de 5 oitavas (61 teclas) utiliza um sistema de cores intuitivo para orientar a execução física no instrumento:

• 🟧 Laranja (Mão Esquerda / LH - Left Hand): Indica as notas do baixo ou guias executadas pela mão esquerda.
• 🟦 Azul / Turquesa (Mão Direita / RH - Right Hand): Indica as notas de extensão e tensões executadas pela mão direita.
• 🛑 Modo Baixo: Botão dedicado para isolar a tônica na região grave, criar slash chords (acordes com baixo alterado/invertido, ex: C/E, G/B) ou dobrar oitavas no grave.

5. Alerta de Registro (Muddy & Thin Protection)

Para garantir a melhor ressonância harmônica:

• Proteção de Som Embolado (Muddy Protection): O aplicativo avisa visualmente caso um voicing invada os limites graves (Low Interval Limits), evitando choque acústico no grave.
• Zoom Dinâmico de Tela: A interface calcula automaticamente a distância entre a nota mais grave (Nota_Baixo) e a mais aguda (Nota_Topo) para ajustar o nível de zoom do teclado na tela do seu celular ou computador.

6. Motor de Áudio e Estilo de Cifragem

• Som de Piano de Cauda Real: Acione o botão ▶ Ouvir Acorde para reproduzir a sonoridade em alta fidelidade via Tone.js (com amostras do Salamander Grand Piano e reverb estéreo de estúdio).
• Alternância de Cifras (PT / EN): No cabeçalho do app, você pode alternar entre a convenção analítica brasileira (C7M, C7(9)) e o padrão sintético internacional (Cmaj7, C9).

7. Exportação de Cards e Favoritos

• Gerar Card Didático (PNG): Exporte uma imagem em alta resolução com o mapa do teclado, a cifra e o selo do KofC — ideal para professores montarem apostilas ou compartilharem no Instagram.
• Favoritos Locais: Clique no ícone de favoritos para salvar os acordes estudados no navegador do seu dispositivo sem precisar criar conta.
• Links Compartilháveis: Copie a URL dinâmica da tela para enviar a configuração exata do acorde para amigos ou alunos.

---

🎹 Quer que eu ajude a elaborar o segundo artigo do blog, sobre a lógica de abertura de acordes usando as técnicas de Drop 2 e Drop 3 no teclado?