Auditoria e Rastreabilidade¶
O recurso de Auditoria é um sistema de registro imutável projetado para garantir conformidade, segurança e rastreabilidade total das operações realizadas na plataforma.
Enquanto os logs padrão do Moodle focam em "acessos" (quem viu a página X), os registros do MIDDAG focam em alterações de estado (quem mudou a nota de 5 para 10, quem alterou a data de matrícula).
Diferenciais do Sistema¶
1. Rastreamento de Mudanças¶
A maioria dos sistemas apenas registra "O usuário X editou o Curso Y".
O MIDDAG registra:
"O usuário X editou o Curso Y. O campo Data de Início mudou de
01/01/2023para05/01/2023."
Antes de salvar qualquer alteração, o sistema compara a versão antiga com a nova e armazena a diferença.
2. Contexto Rico¶
Cada registro de log armazena metadados contextuais para responder às perguntas:
- Quem? (User ID, IP real, Sessão).
- Onde? (Contexto do Moodle, URL, Curso).
- Como? (Via Interface Web, via API, via Cron/Tarefa agendada, ou via Linha de Comando).
- Por quê? (Mensagem de negócio associada à ação).
3. Imutabilidade¶
Os logs de auditoria são projetados para serem apenas leitura (Append-Only). Nem mesmo administradores podem excluir ou alterar um registro de log através da interface, garantindo que o histórico seja prova fiel das atividades.
O Que é Auditado?¶
O MIDDAG audita automaticamente ações críticas de todos os módulos ativos. Exemplos comuns incluem:
- Gestão de Usuários: Mudanças manuais de perfil, trocas de senha administrativa.
- Matrículas: Inscrições manuais, remoções, alterações de datas de vigência.
- Notas e Conclusão: Alterações manuais em notas, redefinição de progresso (via extensão Cleaner).
- Configurações: Mudanças nas configurações do plugin (ativar/desativar módulos).
- Integrações: Falhas de comunicação com serviços externos.
Visualizando os Logs¶
Para acessar o relatório de auditoria:
- Acesse Administração do Site > Plugins > Plugins Locais > MIDDAG.
- Clique na aba Logs e Auditoria.
Filtros Disponíveis¶
O painel permite filtrar o histórico por:
- Nível: Erro, Aviso, Informação, Sucesso.
- Módulo: Filtrar apenas registros de um módulo específico (ex: filtrar só Ecommerce).
- Usuário: Ver tudo que uma pessoa específica fez.
- Item: Ver todo o histórico de um objeto específico (ex: "Histórico do Pedido #1234").
Níveis de Severidade¶
O sistema classifica os eventos para facilitar a triagem:
| Nível | Cor | Significado |
|---|---|---|
| Emergency / Critical | 🔴 Vermelho | Falha grave de sistema (banco corrompido, serviço fora do ar). Exige ação imediata da TI. |
| Error | 🟠 Laranja | Uma operação falhou (ex: erro no pagamento, falha no envio de e-mail). |
| Warning | 🟡 Amarelo | Operação completada, mas com ressalvas (ex: matrícula feita, mas e-mail não enviado). |
| Info | 🔵 Azul | Registro de atividade normal (ex: "Curso criado", "Aluno matriculado"). |
| Debug | ⚪ Cinza | Informação técnica detalhada (visível apenas se o modo Debug estiver ativo). |