Guia do Usuário

1. Introdução

Bem-vindo ao Aplicativo de Tajweed do Alcorão — uma plataforma de aprendizado interativa que ensina as regras de Tajweed, verifica sua pronúncia durante a recitação, testa sua memorização e responde às suas perguntas sobre o Alcorão e as regras de Tajweed.

O texto do Alcorão é sempre exibido na escrita árabe Otomana. A interface do aplicativo (botões, menus e explicações) é traduzida para mais de 68 idiomas, de acordo com sua seleção na lista de idiomas no topo da página.

2. Painel e Abas

Ao abrir o aplicativo, três abas principais são exibidas:

Cada bloco de regra abre uma página que exibe os versículos onde a regra aparece com as palavras coloridas, o áudio do recitador de referência e a tradução/tafsir do versículo de acordo com o idioma de exibição.

3. Idioma e Ajuda

Seleção de Idioma

No canto superior esquerdo de cada página (ou superior direito em idiomas da direita para a esquerda), você encontrará a lista de idiomas. Escolha seu idioma — os botões de menu, títulos e explicações mudarão instantaneamente. O idioma padrão é o árabe.

Botão de Ajuda

Ao lado da lista de idiomas, há um botão «Ajuda». Ele abre este guia no seu idioma atual em uma nova janela. Se a tradução para o seu idioma ainda não estiver disponível, o guia será exibido em árabe.

Voltar ao Painel

O botão «Painel de Regras de Tajweed» no canto superior direito da página o leva de volta à página principal de qualquer subpágina.

4. Páginas de Regras de Tajweed

Cada página de regra exibe:

• Definição da regra em árabe com tradução/transliteração no idioma de exibição.
• Tabela ou Mushaf que destaca as palavras afetadas com uma cor distinta.
• Seleção do recitador e reprodução do áudio do versículo ou página.
• Destaque de palavras durante a reprodução (karaokê): o destaque se move com o recitador palavra por palavra.
• Campo de tradução: de Kalimat.dev ou tafsir local, dependendo do idioma selecionado.

Reprodução de Áudio e Seleção de Palavras

• Um único clique em uma palavra: a seleciona como ponto de partida (destaque azul-celeste).
• Um único clique em outra palavra: expande a seleção para se tornar um intervalo entre as duas palavras.
• Um clique dentro do intervalo selecionado: reproduz o áudio apenas para o intervalo selecionado com acompanhamento de leitura (karaokê).
• Um clique fora do intervalo: redefine a seleção para a nova palavra clicada.
• Um clique duplo: seleciona a palavra e a lê individualmente.
• Arrastar (Toque/Arrastar do Mouse): para selecionar um trecho com um único toque e reproduzi-lo imediatamente após soltar.
• Botão «Ouvir»: lê da palavra selecionada até o final do versículo (nos modos de versículo e página) com coloração de karaokê das palavras.
• Botão «Repetir»: reproduz o trecho selecionado em loop para prática.
• Um clique fora da área do versículo: cancela a seleção para que o botão «Ouvir» volte a ler o versículo desde o início.

5. Recitação Inteligente (Correção de Pronúncia)

A página /r/recite/ permite que você recite diante do microfone com verificação palavra por palavra usando um modelo de transcrição corânica personalizado (Whisper).

Layout da Tela

De cima para baixo:

1. Área de Controle: Seleção da Sura, Alcance (versículo/página/sura), Recitador, Microfone e Limite de Aceitação.
2. Barra de Navegação: Reproduzir/Parar o áudio do versículo, depois os botões « » para versículos e « › » para palavras e para repetir.
3. Guia de Cores de Tajweed: Aparece diretamente acima do texto do versículo para facilitar a revisão durante a recitação.
4. Texto do Versículo: As palavras coloridas e destacadas para a palavra atual.

Iniciando a Recitação

1. Escolha a Sura e o Alcance (um versículo é recomendado para iniciantes).
2. O texto é exibido automaticamente ao abrir a página ou mudar a Sura.
3. Insira seu e-mail (salvo uma vez para todas as páginas).
4. Clique em «Iniciar Recitação» e permita que o navegador acesse o microfone.
5. Leia a palavra destacada; quando pronunciada corretamente, ela fica verde e o destaque se move para a próxima palavra.

Botões de Navegação

Limite de Aceitação da Palavra

Você pode ajustar o limite mínimo de confiança (de 30% a 70%) através do controle deslizante. Uma palavra é aceita se sua pronúncia atingir ou exceder esse limite. Uma palavra abaixo do limite terá sua pontuação exibida em laranja para ajudá-lo a melhorar.

Coloração das Regras de Tajweed

Ative «Coloração das regras de Tajweed» para ver as cores de dica nas palavras (Qalqalah, Ghunnah, Ikhfā', Iẓhār, Lām al-Jalālah…). Pode ser desativado se você quiser um Mushaf sem cores.

Avaliação das Regras de Tajweed (Opcional)

Ao ativar «Avaliação das regras de Tajweed», o Madd, Ghunnah e Qalqalah também são verificados acusticamente — a confiança sonora por si só não é suficiente.

Pesquisa por Recitação

Clique em «Pesquisar por Recitação» e recite algumas palavras; o aplicativo exibirá os versículos correspondentes. Escolha um versículo para abri-lo diretamente.

Pontuações das Palavras e Limpeza

Ao retornar a um versículo já recitado, suas pontuações aparecerão em cada palavra. Use «Limpar pontuações do alcance» para apagar as pontuações do versículo/página/sura e tentar novamente.

6. Teste de Memorização (Tasmīʿ)

A página /r/hifz/ testa sua memorização: o versículo começa vazio, e cada palavra aparece quando pronunciada corretamente.

• Clique em «Iniciar» e recite de memória; as palavras corretas aparecerão gradualmente.
• Um erro de pronúncia emitirá um tom de alerta sem revelar a palavra.
• Você pode «Mostrar Palavra» ou «Mostrar Versículo» manualmente como uma dica.
• A transição para o próximo versículo é manual, a menos que você tenha completado todo o versículo corretamente.
• As pontuações cumulativas para a Sura e para todo o Alcorão são registradas e vinculadas ao seu e-mail.

7. Assistente Inteligente

Na aba «Assistente Inteligente» ou na página /r/chatbot/, você pode fazer perguntas sobre:

• Regras de Tajweed (O que é Ikhfā'? Onde ele ocorre na Sura…?)
• Texto do Alcorão (Quantos versículos há no Juz' 'Amma? Versículos que contêm a palavra…)
• Pesquisa por raiz, repetição ou escrita ortográfica/Otomana

O assistente usa uma base de conhecimento de Tajweed e um banco de dados do Alcorão com Gemini-2.5-flash para responder em seu idioma. Você pode:

• Expandir a caixa de perguntas (arraste a borda inferior ou digite várias linhas com Shift+Enter).
• Abrir novas conversas, arquivá-las, excluí-las ou baixá-las em PDF/Markdown.
• Usar as perguntas de exemplo para começar rapidamente.

8. Pontuações e Relatórios

Insira seu e-mail uma vez — ele será usado para recitação, memorização e teste de Tajweed. As pontuações são salvas no banco de dados e você pode:

• Ver a pontuação cumulativa para a Sura e para o Alcorão na barra de status.
• Revisar suas tentativas anteriores para cada versículo.
• Solicitar «Enviar meu relatório PDF» para receber um relatório detalhado em seu e-mail (média, mais alta, mais baixa, datas).

9. Configurações de Áudio

No botão «Áudio» na página de recitação ou memorização:

• Microfone: Escolha o dispositivo de entrada, se houver mais de um.
• Alto-falante: Escolha o dispositivo de saída (compatível com Chrome/Edge; pode não funcionar no Safari).
• Indicador de Nível: Uma barra verde que mostra a intensidade do seu som durante a recitação.
• Diagnóstico: Um registro técnico para solucionar problemas de transcrição (adicione ?debug=1 ao link).

10. Perguntas Frequentes

Por que o aplicativo espera palavras que eu não disse (como a Basmala)?

Alguns recitadores costumavam começar com a Basmala antes de «الم» ou «آلم» no início das suras. Corrigimos isso detectando a abertura e realinhando. Se o problema persistir, use o diagnóstico ou tente novamente após três tentativas falhas, o aplicativo avança automaticamente.

Funciona no celular?

Sim — Chrome no Android e Safari no iOS. Pode ser necessário um primeiro toque para ativar o áudio (políticas do navegador).

Meus dados são privados?

As pontuações estão vinculadas ao seu e-mail e são isoladas entre os usuários. As gravações de áudio não são compartilhadas com terceiros — são processadas no servidor apenas para verificação.

De onde vêm as traduções dos versículos?

Kalimat.dev, banco de dados local ou Tafsir al-Jalalayn traduzido via Gemini para idiomas não suportados — e não uma tradução direta do texto do Alcorão por inteligência artificial.