Look Exam Logger

Extensão para Visual Studio Code desenvolvida para auxiliar no registro, acompanhamento e análise de avaliações práticas de programação.

O Look Exam Logger acompanha a evolução dos arquivos durante uma sessão de avaliação, registra eventos observáveis pelo Visual Studio Code, mantém evidências locais e sincroniza os dados com o servidor configurado pela extensão.

A ferramenta funciona independentemente da linguagem de programação utilizada.

O Look Exam Logger é uma ferramenta de registro e auditoria. Os eventos produzidos são evidências auxiliares e devem ser interpretados pelo professor ou responsável pela avaliação. A extensão não determina automaticamente a ocorrência de fraude ou irregularidades.

---

Principais recursos

• Registro de início e término da avaliação.
• Identificação de aluno, turma, avaliação e professor.
• Monitoramento de documentos manipulados no Visual Studio Code.
• Registro da evolução dos arquivos durante a sessão.
• Registro de alterações de conteúdo.
• Detecção heurística de grandes inserções de conteúdo (BULK_INSERT).
• Identificação de possível reutilização de conteúdo entre arquivos abertos (POSSIBLE_INTERNAL_COPY).
• Registro de períodos de inatividade observável.
• Criação automática de snapshots.
• Recuperação de sessões após reload ou encerramento inesperado do VS Code.
• Geração de relatório HTML.
• Exportação de eventos e métricas em JSON e CSV.
• Armazenamento local independente da conexão com a internet.
• Sincronização automática com servidor remoto.
• Fila offline para envio posterior caso o servidor esteja indisponível.

---

Instalação

Visual Studio Marketplace

No Visual Studio Code:

1. Abra Extensions com Ctrl+Shift+X.

2. Pesquise por:

   Look Exam Logger

3. Clique em Install.

Nenhuma configuração de servidor é necessária após a instalação.

---

Iniciando uma avaliação

Antes de iniciar, abra no Visual Studio Code a pasta que será utilizada durante a avaliação.

Pressione:

Ctrl+Shift+P

Procure por:

Look Exam Logger: Iniciar Prova

A extensão solicitará as informações necessárias para identificar a sessão, como:

1. nome do aluno;
2. turma;
3. identificação da avaliação;
4. código do professor.

Quando a comunicação com o servidor estiver disponível, o código do professor é validado antes da confirmação da sessão.

Apenas uma sessão pode permanecer ativa simultaneamente.

---

Durante a avaliação

Enquanto uma sessão estiver ativa, o Look Exam Logger acompanha eventos disponibilizados oficialmente pelas APIs do Visual Studio Code.

Entre eles estão:

• abertura de documentos;
• alteração de conteúdo;
• salvamento;
• criação de arquivos;
• exclusão de arquivos;
• renomeação;
• troca de editor ativo;
• inserções de grande quantidade de conteúdo;
• períodos de inatividade;
• snapshots;
• encerramento da sessão.

O comando:

Look Exam Logger: Status

permite consultar a sessão atualmente ativa.

---

Finalizando uma avaliação

Abra a Command Palette:

Ctrl+Shift+P

Execute:

Look Exam Logger: Finalizar Prova

Durante a finalização, a extensão:

1. processa eventos pendentes;
2. cria os snapshots finais;
3. consolida as métricas;
4. gera os arquivos derivados;
5. gera o relatório HTML;
6. finaliza a sessão local;
7. sincroniza os dados pendentes com o servidor quando disponível.

Caso o servidor esteja indisponível, a avaliação continua sendo finalizada localmente e os dados permanecem na fila para sincronização posterior.

---

Relatório

O Look Exam Logger gera um relatório HTML contendo informações consolidadas da avaliação.

O relatório pode apresentar:

• identificação da sessão;
• duração;
• arquivos manipulados;
• quantidade de alterações;
• linha do tempo;
• períodos de inatividade;
• inserções em massa;
• possíveis correlações internas;
• snapshots;
• métricas consolidadas.

Para abrir o último relatório:

Look Exam Logger: Mostrar Relatório da Última Prova

Também é possível reconstruí-lo utilizando:

Look Exam Logger: Regenerar Relatório da Última Prova

---

Sincronização remota

Além do armazenamento local, o Look Exam Logger possui sincronização com servidor remoto.

A versão publicada utiliza um endpoint definido internamente pela extensão. O usuário não precisa configurar:

• URL da API;
• Device ID;
• Activation Key;
• token;
• credenciais técnicas de integração.

A autenticação do cliente ocorre automaticamente.

Quando o servidor estiver temporariamente indisponível, os eventos permanecem armazenados em uma fila local persistente.

A extensão tenta novamente posteriormente sem interromper a avaliação.

A indisponibilidade da internet ou do servidor não impede a geração dos registros e relatórios locais.

---

Funcionamento offline

O armazenamento local é independente da sincronização remota.

Se a conexão cair durante uma avaliação:

1. a sessão continua normalmente;
2. os eventos continuam sendo registrados;
3. o relatório local continua disponível;
4. os dados destinados ao servidor entram em uma fila persistente;
5. a extensão tenta sincronizá-los posteriormente.

Isso permite que uma avaliação continue mesmo durante indisponibilidade temporária da infraestrutura remota.

---

Privacidade

O Look Exam Logger utiliza APIs disponibilizadas oficialmente pelo Visual Studio Code.

A extensão não realiza captura global de:

• teclado;
• área de transferência;
• tela;
• câmera;
• microfone;
• navegador;
• outros aplicativos;
• tráfego de rede do usuário.

A extensão observa eventos disponibilizados pelo próprio Visual Studio Code relacionados ao editor e ao workspace utilizado durante a sessão.

Ela não funciona como keylogger, gravador de tela ou ferramenta de monitoramento geral do computador.

---

Inserções em massa

Uma alteração contendo grande quantidade de conteúdo pode gerar:

BULK_INSERT

Por padrão, a heurística considera uma alteração com pelo menos:

• 100 caracteres; ou
• 5 linhas.

Esse evento indica somente que uma quantidade significativa de conteúdo apareceu em uma única alteração observada pelo editor.

BULK_INSERT não comprova que houve cópia de conteúdo e não representa isoladamente uma irregularidade.

---

Possível reutilização interna

Durante determinadas inserções, o conteúdo pode ser comparado com documentos internos previamente carregados pelo Visual Studio Code.

Quando uma similaridade relevante é encontrada, pode ser registrado:

POSSIBLE_INTERNAL_COPY

O evento indica apenas uma possível correlação com outro conteúdo disponível durante a sessão.

A ocorrência desse evento não comprova a origem do conteúdo e deve ser analisada juntamente com as demais evidências da avaliação.

---

Inatividade

Após determinado período sem eventos observáveis pelo Look Exam Logger, a extensão pode registrar:

IDLE_STARTED

Quando uma nova atividade observável ocorre:

IDLE_ENDED

Por padrão, o limite é de 60 segundos.

Inatividade significa apenas ausência de eventos detectáveis pelas APIs utilizadas pela extensão.

Esse registro não determina presença física do usuário e não identifica atividades realizadas fora do Visual Studio Code.

---

Snapshots

O Look Exam Logger pode criar snapshots dos arquivos em momentos relevantes, como:

• salvamento;
• inserções em massa;
• finalização da avaliação.

Snapshots consecutivos idênticos são evitados utilizando hashes SHA-256.

Esses arquivos permitem reconstruir parte da evolução do código durante uma sessão.

---

Armazenamento local

Os registros são armazenados utilizando:

ExtensionContext.globalStorageUri

Essa localização é administrada pelo próprio Visual Studio Code.

Nada precisa ser criado dentro do projeto do aluno.

Uma sessão pode conter aproximadamente:

sessions/<sessionId>/
├── session.json
├── summary.json
├── files-summary.csv
├── events.jsonl
├── events/
│   ├── events.jsonl
│   ├── events.pretty.json
│   └── events.csv
├── report.html
└── snapshots/