# HEP Flashcards — Documentação e Boas Práticas

Este projeto é um sistema de flashcards multilíngue para aprendizado de idiomas, com suporte a temas visuais, comandos de voz e navegação acessível.

## Estrutura do Projeto
- **data/**: Arquivos de cards em JS, cada um exportando um array DATA.
- **ui/**: Lógica de interface, controle, comandos e carregamento dos cards.
- **css/**: Estilos principais e temas visuais.
- **card_base.html**: Visualização de um grupo de cards.
- **cards.html**: Menu principal de grupos.

## Boas Práticas Adotadas
- Funções e variáveis globais documentadas com comentários.
- Estrutura dos cards padronizada (campos info_xx, ptbr, en, etc).
- Temas CSS com contraste revisado para acessibilidade.
- Menu e interface adaptam-se ao tema selecionado.
- Carregamento dos cards seguro (DATA importado antes do loader).

## Sugestões Futuras
- Adicionar testes automatizados para funções críticas.
- Incluir mais exemplos de uso e instruções de deploy.
- Garantir que todos os arquivos JS e CSS tenham cabeçalhos de identificação.
- Revisar periodicamente a acessibilidade (contraste, navegação por teclado, ARIA).

## Dependências
- Nenhuma dependência externa obrigatória além de navegador moderno.

## Contato
Dúvidas ou sugestões: [Seu Nome ou Email]
