quran-app

O aplicativo «Alcorão Sagrado» é um projeto árabe de código aberto sob licença MIT, que permite a leitura, audição, pesquisa e consulta de interpretações (tafsir) do Alcorão, funcionando em navegadores web e dispositivos Android. A versão atual no repositório é a 3.1.20, com a distribuição de um arquivo APK com assinatura de Debug para testes de campo e uma versão web publicada no GitHub Pages. O projeto suporta oito idiomas de interface: árabe, inglês, francês, alemão, russo, turco, malaio e indonésio, com suporte a RTL para o árabe. Na leitura, o aplicativo exibe 114 suras em caligrafia otomana proveniente do AlQuran.cloud, com navegação entre suras, salvamento da última posição, destaque do versículo atual, 15 marcas de prostração, divisões das trinta partes (juz') e barra de progresso vinculada à rolagem. Permite controlar o tamanho da fonte (16–45 px) e o tipo (Amiri, Scheherazade New e Reem Kufi), o espaçamento entre linhas, cinco traduções dos significados do Alcorão, 18 regras de tajwid coloridas com modo diurno e noturno, e um modo de memorização que oculta o texto para prática de recuperação, além de uma «sala de memorização» com cortina que revela o versículo sob demanda, com recitador, velocidade e repetição de intervalo. Existe a opção da fonte otomana oficial de Hafs do Complexo do Rei Fahd para a impressão do Alcorão Nobre aplicada ao modo de sura, enquanto o modo de página do Mushaf permanece em QCF4, com dados de Mushaf offline para layouts de 604 páginas baixáveis opcionalmente após verificação de assinatura SHA-256. Quanto à audição, inclui mais de 30 recitadores e duas fontes de áudio: áudio por versículo via API e arquivo MP3 completo da sura com marcações temporais do mp3quran.net, com destaque palavra por palavra via interface quran.com. Oferece reprodução contínua entre suras, modos de repetição (desativado, versículo, sura, intervalo personalizado), timer de suspensão de 1 a 180 minutos, controle de velocidade, integração com MediaSession para controles na tela de bloqueio, tentativas de reconexão automática, visualizador sonoro em Canvas, reprodução a partir do número do versículo e notificação de conclusão da leitura completa. O pacote offline pode armazenar o texto do Alcorão, traduções, dados de tajwid, fontes QCF4 e o áudio do recitador escolhido no IndexedDB com limite de 200 MB e despejo LRU, com estatísticas de armazenamento e exclusão seletiva ou total. A pesquisa possui um motor que cobre 6.236 versículos, correspondendo ao texto com ou sem diacríticos, com destaque de resultados, sugestões de prefixos de palavras, histórico das últimas dez pesquisas, pesquisa por voz via Web Speech API em árabe, teclado árabe na tela e resultados paginados. As interpretações (tafsirs) incluem seis versões (Al-Muyassar, Ibn Kathir, Al-Tabari, Al-Saadi, Al-Baghawi e Al-Qurtubi) com carregamento gradual do local para IndexedDB e depois API, com cache no banco de dados QuranTafsirDB. Há a função «Meditação no Versículo» que apresenta três perguntas reflexivas sem campo de escrita, conta ou envio para IA, com dados locais offline, exibida apenas para versículos com perguntas completas, alertando que é um meio de reflexão pessoal e não um tafsir certificado. O «Modo Mushaf» exibe fontes QCF V4 em Canvas através de 604 páginas com coloração de tajwid por palavra, detecção do versículo clicado para reprodução e tafsir, e pré-carregamento de páginas adjacentes. O «Modo de Exibição» oferece visualização em tela cheia com fundos sólidos, naturais, baseados no humor e hora, e cenas de Canvas (estrelas, ondas, aurora, partículas e chuva), com possibilidade de configurar imagem panorâmica para o versículo ou vídeo HD local com fundo animado e áudio de Mishary Al-Afasy, processados no dispositivo do usuário. O aplicativo é complementado por horários de oração via Aladhan com seis horários, alerta de adhan, data hijri pelo calendário Umm al-Qura e bússola de qibla, azkar da manhã e noite e azkar personalizados com contador, notificações e redefinição diária, favoritos e marcadores com exportação em texto ou JSON, estatísticas de leitura, quatro modos de exibição incluindo modo noturno profundo, compartilhamento nativo via Capacitor Share ou Web Share API (WhatsApp e Telegram), atalhos de teclado e temas de acessibilidade, incluindo focus trap, regiões ARIA live, link de salto de conteúdo, respeito à redução de movimento e alto contraste. Tecnicamente, o projeto baseia-se em TypeScript 6.0 em modo estrito, Vite 8 com LightningCSS, vite-plugin-pwa (Workbox) para PWA, Capacitor 8 para o pacote Android, gerenciamento de estado reativo baseado em Proxy sem framework externo, e armazenamento em localStorage e três bancos IndexedDB (QuranAppDB, QuranAudioCacheDB e QuranTafsirDB). Suas APIs externas são: AlQuran.cloud, Aladhan, interface de tafsir via jsDelivr, mp3quran.net e quran.com. O pipeline de CI/CD inclui: lint, verificação de tipos, testes unitários com cobertura mínima de 80%, testes Playwright em quatro projetos (chromium, firefox, webkit e mobile-chrome), CodeQL, varredura básica OWASP ZAP, Lighthouse CI, verificação axe-core sem violações WCAG, monitoramento de tamanho de pacote e orçamento de desempenho, geração de TypeDoc, npm audit, verificação de licenças e implantação automática ao emitir uma tag. O repositório menciona que possui 3.812 testes unitários e 284 casos de teste de interface, e que os resultados do Lighthouse para a build de produção local foram 93 para desempenho, 100 para acessibilidade, 96 para melhores práticas e 91 para SEO, enfatizando que esta é uma avaliação técnica interna e não uma certificação externa independente. Para execução local, é necessário Node.js 22 ou superior, seguido de npm install, com comandos para desenvolvimento (porta 3000), build, preview, testes unitários, E2E, verificação de código e build de Android. Quem deseja apenas o aplicativo não precisa buildar o projeto, podendo baixar o APK diretamente. O repositório também oferece um guia de avaliação técnica detalhando o que pode ser verificado, o que funciona offline e as limitações conhecidas.