Documentação pública
Como entender e usar o BancoFisica
O BancoFisica é um repositório de questões parametrizadas de Física, criado para apoiar ensino, estudo, listas, questionários e avaliações em ambientes como o Moodle.
O que é o BancoFisica?
O projeto reúne questões de Física escritas de forma programável. Em vez de manter apenas um enunciado fixo, cada item pode gerar variações de valores, alternativas, respostas e soluções, reduzindo retrabalho e melhorando a reutilização pedagógica.
A proposta é manter as questões em um repositório versionado, com revisão por pull requests, testes automatizados e solucionários que ajudem tanto o professor quanto o estudante.
Uso com R/exams e Moodle
O BancoFisica usa o ecossistema R/exams para transformar exercícios em versões exportáveis para diferentes formatos. No fluxo com Moodle, as questões podem ser convertidas para formatos compatíveis com questionários online, preservando enunciado, alternativas, resposta correta e feedback.
A vitrine pública mostra apenas exemplos demonstrativos desse fluxo. Ela ajuda a visualizar a ideia geral, mas não substitui a documentação técnica do pacote R/exams nem uma instância real do Moodle.
Vitrine pública versus banco avaliativo
Este site é uma vitrine institucional e pedagógica. Ele publica apenas
questões marcadas como demo, criadas para divulgação ou
demonstração.
O banco completo, usado ou potencialmente usado em avaliações reais, não deve ser exposto automaticamente. Questões privadas, internas, em revisão ou usadas em provas e questionários reais devem permanecer fora da vitrine.
Para detalhes, consulte a política de visibilidade.
Como contribuir
Contribuições podem envolver novas questões, melhoria de enunciados, revisão física e matemática, ampliação de solucionários, correção de bugs, documentação ou melhorias no site.
- Abra uma issue descrevendo a melhoria ou correção desejada.
- Trabalhe em um pull request pequeno e revisável.
- Inclua solucionário claro quando a mudança envolver questões.
- Não publique questões avaliativas reais no site público.
- Quando o PR resolver uma issue, use
Resolve #Nno corpo do PR.
Links úteis
Repositório
Código-fonte, issues, pull requests, testes e histórico do projeto.
Demonstrações
Catálogo público com questões sacrificáveis, filtros e preview estilo Moodle.
Visibilidade
Regras para separar conteúdo público, privado e interno.