Dashboard Administrativo¶

O Dashboard do MIDDAG é o painel central de monitoramento do plugin. Ele reune informações sobre o estado do sistema, ferramentas de manutenção e um histórico de atividades recentes.

Página Inicial (Home)¶

A página inicial do Dashboard apresenta uma visão geral rápida do estado do seu ambiente MIDDAG.

É a primeira tela que aparece ao abrir o Dashboard. O endereço /admin/ redireciona automaticamente para ela.

O que você vê¶

Pontuação de Saúde: nota de 0 a 100 que indica a saúde geral do sistema (verde = ótimo, amarelo = atenção, vermelho = problemas). Clique para ver os critérios detalhados.
Licença: status da sua licença MIDDAG com link para configurações.
Atalhos Rápidos: botões para ações frequentes como limpar cache e verificar licença.
Métricas de Tarefas: gráfico mostrando tarefas processadas nos últimos 7 ou 30 dias.
Resumo de Logs: principais erros da semana e módulos mais ativos.
Documentação e Suporte: links para a documentação, canal de suporte e abertura de tickets.

Alguns recursos (Widgets de Extensões e Novidades) estarão disponíveis em atualizações futuras.

Como acessar¶

Acesse Administração do site.
No menu lateral, clique em Plugins.
Localize MIDDAG e clique em Dashboard.

Ou acesse diretamente pelo endereço do site: seusite.com.br/local/middag/admin/status.

Você precisa ter permissão de administrador para acessar o dashboard.

Aba: Status¶

A aba Status é o ponto de partida para diagnóstico. Ela exibe um relatório completo do ambiente em que o MIDDAG está rodando.

O que você verá¶

Ambiente: versão do PHP, banco de dados, servidor web e sistema operacional
MIDDAG: versão do plugin, status da licença, totais de registros e configurações ativas
Funcionalidades ativas: quais módulos estão instalados e em funcionamento
Configurações: comparativo entre os valores atuais e os padrões recomendados
Plugins Moodle: lista de todos os plugins instalados no seu site
Temas: temas instalados e o tema ativo
Tarefas agendadas: status das tarefas automáticas do MIDDAG (quando foram executadas pela última vez)
Requisitos: verificação de dependências de sistema (extensões PHP, permissões de diretório, HTTPS)

Como enviar para o suporte MIDDAG¶

Quando precisar de ajuda, o suporte pode pedir um relatório do seu sistema. Para enviar:

Na aba Status, localize o botão Copiar relatório.
Clique no botão — o texto do relatório é copiado automaticamente.
Cole no chamado ou e-mail para o suporte.

O relatório contém apenas informações técnicas sobre o ambiente. Ele não inclui dados de alunos, notas ou qualquer informação pessoal.

Aba: Tools¶

A aba Tools oferece ferramentas de manutenção que podem ser executadas manualmente pelo administrador do site.

Estas ações exigem acesso de administrador do site (não apenas de gerente).

Ferramentas disponíveis¶

Ferramenta	Quando usar
Limpar Cache	Quando perceber comportamentos inesperados ou após atualizações do plugin. Limpa todos os caches internos do MIDDAG sem afetar o Moodle.
Limpar Logs	Para liberar espaço em disco removendo arquivos de log antigos, de acordo com o período de retenção configurado.
Verificar Banco de Dados	Após uma instalação ou atualização, para confirmar que todas as tabelas do MIDDAG foram criadas corretamente.
Verificar Licenca	Para atualizar manualmente o status da licença quando a renovação foi feita mas o sistema ainda mostra status antigo.
Redefinir Config de Módulo	Disponível em versão futura — permitirá resetar as configurações de um módulo específico.
Reindexar	Disponível em versão futura — reiniciará o índice de busca completo.

Após executar uma ferramenta, o resultado aparece na tela informando se a operação foi bem-sucedida ou se houve algum problema.

Aba: Atividade¶

A aba Atividade exibe um histórico das operações mais recentes realizadas pelo MIDDAG e pelos módulos instalados.

O que você verá¶

As 50 atividades mais recentes, ordenadas da mais nova para a mais antiga
Cada entrada mostra: o módulo de origem, o tipo de evento, a descrição e o horário
Uma indicação visual de severidade: informação, sucesso, aviso ou erro

Para que serve¶

Use esta aba para ter uma visão rápida do que aconteceu no sistema:

Confirmar que uma integração foi executada
Verificar se houve erros em operações automáticas
Acompanhar atividades geradas por módulos como Ecommerce, Matrículas ou Sincronizações

Aba: Logs¶

A aba Logs permite navegar pelos registros de atividade técnica gerados pelo MIDDAG e pelos seus módulos instalados.

Como usar¶

Selecione o módulo (funcionalidade) no primeiro menu suspenso.
Selecione o canal (área de atividade, como "api", "sync", "system") no segundo menu.
Selecione o arquivo de log (organizado por data e hora) no terceiro menu.

O visualizador exibe cada entrada com:

Data e hora do registro
Origem — de onde a ação veio (navegador, linha de comando, sistema)
Ator — quem realizou a ação (ID do usuário, sistema ou webhook)
Nível de severidade — com código de cores: vermelho para erros, amarelo para avisos, azul para informações
Mensagem — o texto do registro

Filtragem¶

Use os botões de nível no topo da lista para mostrar ou ocultar entradas por severidade. Use o campo de busca para localizar mensagens específicas.

Download¶

Clique no botão Download ao lado do arquivo selecionado para salvá-lo localmente. O download está disponível apenas para administradores do site.

Aba: Ações Agendadas (Jobs)¶

A aba de Ações Agendadas mostra as tarefas de processamento em segundo plano do MIDDAG.

O que você vê¶

Lista de tarefas com status colorido: azul = aguardando, amarelo = executando, verde = concluída, vermelho = falhou, cinza = cancelada
O número em vermelho na aba indica quantas tarefas falharam

Filtros¶

Clique nos botões de status para mostrar/ocultar por tipo
Use o dropdown para filtrar por módulo
Use a busca para encontrar tarefas específicas

Ações (apenas administradores do site)¶

Retentar: clique em "Retry" numa tarefa que falhou para tentar novamente
Cancelar: clique em "Cancel" numa tarefa pendente para interrompê-la

Detalhes¶

Clique em qualquer tarefa para ver os dados enviados e o histórico de tentativas (incluindo mensagens de erro).

Aba: Auditoria¶

A aba de Auditoria mostra o histórico de todas as alterações realizadas nos dados do MIDDAG.

O que você vê:

Lista de registros com data, módulo, tipo de ação (criação, atualização, exclusão), e quem fez a alteração
Ações coloridas: verde para criação, azul para atualização, vermelho para exclusão

Filtros:

Filtre por módulo, tipo de ação, tipo de registro, período e texto
Os filtros são populados automaticamente com os dados disponíveis

Detalhes: Clique em qualquer registro para ver:

Alterações: tabela lado a lado mostrando o que mudou (valor antigo em vermelho, novo valor em verde)
Snapshot: dados completos do registro no momento da alteração

Este recurso é útil para rastrear quem alterou informações importantes, como notas, matrículas ou configurações.

Duvidas frequentes¶

Preciso abrir o dashboard todos os dias? Não. O dashboard é uma ferramenta de diagnóstico e manutenção pontual. Você acessa quando há necessidade — por exemplo, ao suspeitar de um problema ou ao abrir um chamado de suporte.

As ferramentas da aba Tools afetam os alunos? Não diretamente. "Limpar Cache" e "Limpar Logs" afetam apenas dados internos do MIDDAG. Os dados de alunos, matrículas e cursos não são alterados.

O relatório de Status expoe dados pessoais? Não. O relatório contém apenas informações técnicas de ambiente (versão de PHP, banco de dados, configurações). Nenhum dado de usuário ou aluno é incluído.