/ajudator

Me ajuda a corrigir as atividades práticas de Web

Primary LanguageCSS

Ajudator

Um conjunto de scripts para ajudar a corrigir trabalhos de Web entregues pelo Moodle.

Tela de terminal mostrando o comando ajudator executado com uma lista de alunos

Instalação e uso

  1. [Apenas 1ª vez] No terminal:
git clone git@github.com:fegemo/ajudator
cd ajudator
npm install
npm link

Isso possibilita executar o comando ajudator globalmente no computador.

  1. [A cada atividade] No Moodle, baixar um arquivo compactado com todas as submissões.

Tela do Moodle mostrando página de correção de atividade e a opção para baixar um arquivo compactado com todas as submissões

  1. [A cada atividade] Descompactar esse arquivo e, dentro da pasta criada, criar um arquivo alunos.json [1 vez por ano letivo] nessa pasta contendo um vetor de strings dos nomes dos alunos retirados do SIGAA. Depois, executar:
ajudator

Tela mostrando um exemplo do arquivo alunos.json

  1. [A cada atividade] Acessar a URL para corrigir o trabalho do primeiro aluno, fazendo marcações e comentários. Após verificar/comentar cada arquivo do aluno, imprimir um PDF referente a esse arquivo e salvar na pasta da atividade do aluno. Ao final da correção do primeiro trabalho, digitar a nota de 0 a 200 no terminal. Repetir até terminar todos os alunos.

Tela da página de correção e comentários mostrando o código de um aluno e a possibilidade de colocar figurinhas e comentários

  1. [A cada atividade] Ao final, terá sido gerado o notas.json. No Moodle, na página de correção rápida de atividades, copiar/colar o snippets/preenche-notas-no-moodle.js para a aba Snippets de Sources da ferramenta do desenvolvedor, substituir o vetor tarefas pelo conteúdo de notas.json e executar.

Tela da página de correção do Moodle com a ferramenta do desenvolvedor aberta mostrando o snippet "preenche-notas-no-moodle.js" aberto

  1. [A cada atividade] Além do notas.json (e notas.csv, se necessário para planilhas), percorrer as pastas de cada aluno excluindo todos os arquivos exceto pelos arquivos PDF gerados. No final, selecionar todas as pastas de alunos e gerar um arquivo .zip.

Tela mostrando a estrutura de pastas dos alunos com apenas arquivos PDF dentro, mas mantendo o nome da pasta gerado pelo próprio Moodle, após este passo

  1. [A cada atividade] Na mesma página de correção da atividade no Moodle, no topo, escolher a ação "Fazer upload de múltiplos arquivos..." e submeter o arquivo .zip gerado.

Tela do Moodle mostrando bem no topo da página a opção de fazer upload de múltiplos arquivos

Comparação de plágio

Também há o executável compare, que faz uma comparação da abstract syntax tree entre dois ou mais arquivos especificados. Para usar:

compare-ast arquivo1.js arquivo2js arquivo3.js ...

A saída mostra uma tabela que compara todos contra todos. É feita uma verificação de quantidade de divergências, e também é mostrado um índice de disparidade entre duplas de arquivos: quanto menor, mais semelhantes.

Não são consideradas divergências:

  1. Espaço em branco
  2. Nomes de variáveis, funções ou literais

Exemplo de saída: Tela do terminal mostrando a execução de compare-ast a.js b.js c.js com uma tabela comparativa dos resultados de plágio entre os arquivos