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 #N no corpo do PR.

Links úteis

Repositório

Código-fonte, issues, pull requests, testes e histórico do projeto.

Abrir no GitHub

Visibilidade

Regras para separar conteúdo público, privado e interno.

Ler política