clrogon/MagicKeyboard

The AI-powered, privacy-first typing trainer for children in Portugal and Angola. Features RPG progression, voice dictation, and automatic QWERTY/AZERTY layout detection. # Teclado Mágico 🇵🇹 🇦🇴 ### O Treinador de Digitação com Alma Lusófona ### *The Typing Trainer with a Lusophone Soul* --- ## 📸 Galeria | Screenshots Novo: Relatórios por Código QR (Esq.) e Gestão de Sala de Aula (Dir.) --- ## 🌟 Porquê o Teclado Mágico? | Why Magic Keyboard? **O Problema:** A maioria dos treinadores de digitação online ou são apenas em Inglês ou, quando em Português, utilizam vocabulário e gramática do Brasil (PT-BR). Para crianças em **Portugal** e **Angola**, isto cria confusão linguística (ex: "tela" vs "ecrã", uso do gerúndio). Além disso, escolas com internet limitada ou restrições de privacidade (RGPD) têm dificuldade em usar ferramentas baseadas na nuvem. **A Solução:** O **Teclado Mágico** é uma plataforma educativa "Privacy-First" e **Local-First**. Utiliza Inteligência Artificial para gerar exercícios infinitos e culturalmente relevantes, mas corre inteiramente no navegador da criança. --- ## 🚀 Funcionalidades de Destaque | Feature Highlights ### 🏫 Ferramentas "Sala de Aula" (Novidade v2.0) Desenvolvidas para professores que não querem gerir logins ou bases de dados. * **Magic QR Reporting**: O aluno termina o nível e o ecrã gera um Código QR. O professor lê com o telemóvel e obtém instantaneamente o relatório (Nome, Nível, PPM, Precisão). Sem servidores, sem papel. * **Modo Kiosk**: Bloqueia o perfil do aluno. Impede a mudança de avatares ou temas para garantir foco total na aula. * **Códigos TPC**: O professor escreve "TPC-1" no quadro. O aluno insere o código e o jogo carrega a lista de palavras exata para a aula. ### 🛡️ Soberania de Dados (Privacy by Design) A segurança das crianças é a nossa prioridade número um. * **Sem Base de Dados**: Não temos servidores para guardar dados de utilizadores. * **Armazenamento Local**: Todo o progresso é guardado localmente no dispositivo (LocalStorage). * **Anonimato na IA**: Apenas enviamos prompts anónimos à Google Gemini (ex: "Gera frase com a letra J"). ### 🧠 I …