# Gestão e Monitoramento Avalia4all

O módulo Gestão e Monitoramento Avalia4all permite o acompanhamento completo das avaliações aplicadas em uma fase específica. Ele exibe dados consolidados sobre apuração, estudantes, escolas e turmas, auxiliando gestores e coordenadores no monitoramento do progresso das aplicações.

Este relatório pode ser acessado em três contextos, e em cada um deles são exibidos apenas os dados do contexto atual:

  • Relatório por Fase: exibe o panorama geral de todas as escolas e turmas que fazem parte da fase.
  • Relatório por Rede: apresenta as informações consolidadas de todas as escolas vinculadas à rede/cliente selecionada.
  • Relatório por Turma: exibe apenas os resultados da turma selecionada, incluindo resumos, gráficos, tabelas e detalhes filtrados para essa turma.

🔎 Escopo por contexto
O escopo dos dados exibidos respeita sempre o contexto de acesso (Fase, Rede ou Turma).

Os três relatórios possuem o mesmo layout e funcionalidades.
A única diferença é que, quando o acesso é feito por dentro da fase, a etapa de seleção da fase é omitida, pois o sistema já reconhece automaticamente o contexto em que o usuário se encontra.


# Fundamentação

O relatório foi desenvolvido para oferecer uma visão clara e detalhada da execução e da apuração das avaliações de uma fase.
Por meio dele, é possível identificar o total de avaliações realizadas, o número de estudantes esperados e apurados, e verificar eventuais pendências, como notas duplicadas ou folhas extras ainda não revisadas.

A estrutura do relatório é composta por três etapas principais:

  1. Seleção da Fase (quando aplicável)
  2. Filtros de Exibição
  3. Exibição dos Resultados

# 1. Seleção da Fase

Quando o acesso é realizado fora do ambiente de gerenciamento da fase, o primeiro passo é selecionar a fase desejada.
A tela de seleção apresenta uma lista de fases disponíveis, com as seguintes informações:

  • Descrição da Fase: nome da fase (exemplo: Fase 1, Fase 2, etc.)
  • Ano Letivo: ano correspondente à execução da fase.
  • Status: indica a situação da fase (em execução, finalizado, produção).

Após selecionar a fase, o usuário é direcionado à tela de filtros.

Seleção da Fase


# 2. Filtros de Exibição

Nesta etapa, o usuário pode definir os critérios para geração do relatório.
Os filtros disponíveis são:

  • Escolas: possibilita selecionar uma ou mais escolas para análise.
  • Avaliações: define quais avaliações da fase serão consideradas.
  • Apuração: ao marcar o checkbox “Mostrar apenas escolas não apuradas (< 100%)”, o relatório exibirá apenas escolas que ainda não atingiram 100% de apuração.
    • O texto de ajuda abaixo do campo reforça que esta opção exibe escolas que ainda precisam finalizar a apuração.

Após configurar os filtros desejados, o usuário deve clicar em Processar para gerar ou atualizar o relatório.
Caso algum filtro seja alterado, é necessário processar novamente para que as informações sejam atualizadas.

Filtros de Relatório


# 3. Exibição do Relatório

Após o processamento, são exibidas as seções de resultados.
A exibição é composta por diferentes blocos que apresentam tanto informações consolidadas quanto detalhes individuais de cada avaliação, sempre respeitando o contexto de acesso (fase, rede ou turma).


# 3.1 Visão Geral

A seção de visão geral apresenta um resumo consolidado das principais informações do contexto selecionado:

  • Total de Avaliações: mostra o número total de avaliações aplicadas no contexto (fase, rede ou turma).
  • Escolas Envolvidas: indica quantas escolas participaram (todas as da fase, apenas as da rede, ou apenas a escola/turma selecionada).
  • Estudantes Esperados: exibe o total de estudantes previstos para participar das avaliações.
  • Estudantes Apurados: mostra quantos estudantes já tiveram suas notas registradas.
  • Percentual de Apuração: representa o percentual de estudantes com notas lançadas em relação ao total esperado.

Na coluna de Percentual, alguns indicadores podem ser apresentados para facilitar a leitura, como o percentual global de apuração dos estudantes esperados.

Logo acima desta área há a Legenda de Status de Apuração, que padroniza as cores utilizadas em diferentes pontos do relatório:

  • Verde – Completo (100%)
  • Amarelo – Parcial (50–99%)
  • Vermelho – Baixo (< 50%)

Importante:
Essa legenda é reutilizada em todo o relatório, em todos os componentes que exibem algum campo de % de Apuração (por exemplo: visão geral, tabelas por avaliação, tabelas por escola, detalhamento por turma no modal, etc.).

Visão Geral


# 3.2 Alertas

Ao lado da visão geral, o sistema apresenta o card de Alertas, responsável por sinalizar possíveis inconsistências encontradas na apuração.

Os alertas podem indicar:

  • Notas duplicadas pendentes de correção.
  • Folhas extras ainda não analisadas.

Quando não há pendências, o sistema exibe a mensagem:

Nenhum problema encontrado. Todas as avaliações estão sem pendências críticas.

# Permissões de navegação nos alertas

  • Apenas o dono da fase (gestor responsável) consegue clicar nos alertas de folhas extras pendentes e usuários com notas duplicadas para navegar até as telas específicas de tratamento dessas pendências.
  • Para os demais perfis de usuário, os cards de alerta são exibidos apenas como indicadores de contagem, sem permitir ações diretas.
    • Nesses casos, o usuário visualiza quantos registros existem em cada tipo de alerta, mas não consegue acessar a listagem detalhada a partir desse atalho.

Card de Alertas


# 3.3 Detalhamento por Avaliação

Logo abaixo dos gráficos, o relatório apresenta o detalhamento individual de cada avaliação incluída no contexto selecionado.

Cada registro exibe:

  • Avaliação: nome da avaliação aplicada.
  • Escola: instituição onde a avaliação foi realizada.
  • Turmas: quantidade de turmas participantes (ou uma única turma, no caso do relatório por turma).
  • % de Apuração: percentual de estudantes que já tiveram notas registradas. A cor deste campo segue a Legenda de Status de Apuração (verde, amarelo ou vermelho), indicando se a apuração está completa, parcial ou baixa.
  • Estudantes Esperados: total de estudantes previstos.
  • Estudantes Apurados: total de estudantes com notas lançadas.
  • Ações: botão Detalhes que abre informações completas daquela avaliação.

Acima da tabela, há recursos adicionais para refinar a visualização:

  • Campo de Busca por texto, que filtra as linhas de acordo com o termo digitado.
  • Combos de filtro específicos para:
    • Avaliações selecionadas
    • Escolas selecionadas
    • Status de apuração

O relatório possui paginação padrão, exibindo 20 registros por página (ajustável).
É possível navegar entre as páginas, alterar a quantidade de registros exibidos ou utilizar o botão “Ver Todos” para mostrar todos os registros de uma só vez.

Escopo por contexto:

  • No acesso por Fase, a tabela lista todas as avaliações de todas as escolas da fase.
  • No acesso por Rede, a tabela é automaticamente filtrada para as escolas daquela rede.
  • No acesso por Turma, a tabela é restrita àquela turma específica.

Detalhamento por Avaliação


# 3.4 Modal de Detalhes

Ao clicar em Detalhes, o sistema abre um modal com as informações específicas da avaliação selecionada.
O título do modal indica a escola em contexto (por exemplo, “Detalhes – Escola A”).

O modal é organizado em três blocos principais:

# 3.4.1 Resumo da Avaliação e Alertas

Na parte superior do modal, são exibidos dois cards:

  1. Card de Resumo da Avaliação (à esquerda), com os campos:

    • Avaliação: nome da avaliação (ex.: “Avaliação Matemática 01”).
    • Total de Turmas: quantidade de turmas daquela escola que participaram da avaliação.
    • Alunos Esperados: total de estudantes esperados para essa avaliação na escola.
    • Alunos Apurados: total de estudantes que já tiveram notas registradas.
    • % de Apuração: percentual correspondente, exibido com o selo de cor seguindo a Legenda de Status de Apuração.
  2. Card de Alertas da Avaliação (à direita), quando houver pendências, com mensagens como:

    • “10 folhas extras pendentes”
    • “2 usuários com notas duplicadas”

Se não houver problemas, o card exibe mensagem informando que não foram identificadas pendências críticas para aquela avaliação.

Modal de Detalhes – Cabeçalho


# 3.4.2 Turmas da Avaliação

Logo abaixo dos cards, há a seção Turmas, que lista as turmas da escola que possuem participação na avaliação selecionada.

Elementos da seção:

  • Buscar Turmas: campo de busca textual para filtrar as turmas pelo nome.
  • Filtro de Status: combo que permite selecionar quais status de apuração serão considerados (ex.: “3 status selecionados”).

A tabela de turmas possui as colunas:

  • Turma: nome da turma (ex.: “5º Ano A”).
  • Avaliação: nome da avaliação (repetido para facilitar a leitura quando houver mais de uma).
  • Estudantes Esperados: quantidade de estudantes previstos naquela turma.
  • Estudantes Apurados: quantidade de estudantes com nota lançada.
  • Apuração: percentual de apuração da turma, exibido com o selo colorido seguindo a Legenda de Status de Apuração.
  • Ações: ícone de expansão/recolhimento (seta para cima/baixo) que abre ou fecha o detalhamento dos estudantes da turma.

Ao clicar na seta da coluna Ações, a linha da turma é expandida, exibindo o bloco de estudantes.

Escopo por contexto: o modal sempre respeita o contexto atual.

  • Quando aberto a partir do relatório por Fase ou por Rede, ele foca na combinação Escola + Avaliação selecionada.
  • Quando aberto no relatório por Turma, o modal já traz filtrado apenas os dados daquela turma específica.

Modal de Detalhes – Cabeçalho


# 3.4.3 Estudantes da Turma Selecionada

Quando uma turma é expandida, é apresentada a área “Estudantes – [Nome da Turma]”.

Nesta área, existem:

  • Um campo Pesquisar Estudante, que permite localizar rapidamente um aluno pelo nome.
  • Uma tabela com as seguintes colunas:
    • Nome do Estudante
    • Apuração: status de apuração individual (ex.: selo verde “Apurado”).
    • Status na Avaliação: situação do estudante na aplicação (ex.: “Compareceu”, “Não Compareceu”, etc.).
    • Data da Apuração: data em que a correção/apuração daquele estudante foi registrada no sistema.

Essa visão facilita a identificação de estudantes ainda pendentes, bem como a conferência dos registros já apurados para cada turma.

Modal de Detalhes – Cabeçalho


# 3.5 Percentual de Apuração por Escola

Este gráfico apresenta a taxa de apuração de cada escola participante do contexto atual, representada em formato de barra horizontal.
Cada barra indica o percentual de estudantes apurados em relação ao total esperado para aquela instituição.

  • Quanto mais próxima de 100%, mais completa está a apuração da escola.
  • O gráfico permite uma visualização rápida do progresso entre escolas da mesma rede ou dentro da fase.
  • As cores utilizadas seguem a Legenda de Status de Apuração (verde, amarelo e vermelho), reforçando visualmente o nível de completude de cada escola.

Escopo por contexto:

  • No relatório por Fase, são exibidas todas as escolas da fase.
  • No relatório por Rede, apenas as escolas vinculadas à rede selecionada.
  • No relatório por Turma, o gráfico pode ser omitido ou restringido à escola/turma em questão, conforme configuração do ambiente.

Percentual de Apuração por Escola


# 3.6 Correções por Período

O gráfico de Correções por Período exibe o volume de correções realizadas ao longo do tempo.
Ele permite identificar em quais dias houve maior concentração de atividades de apuração.

  • O eixo horizontal representa as datas de execução.
  • O eixo vertical indica o número de correções registradas.
  • Os pontos no gráfico representam o total de correções efetuadas em cada dia.
  • O seletor no canto superior direito permite alternar a visualização “Por dia”, “Por semana” ou “Por mês”.

No canto superior do gráfico também há controles de zoom, movimentação e restauração da visualização padrão, permitindo explorar períodos específicos com maior nível de detalhe.

Escopo por contexto: as correções exibidas no gráfico consideram apenas as avaliações e escolas pertencentes ao contexto atual (fase, rede ou turma).

Correções por Período


# 3.7 Status dos Participantes – Visão Consolidada

Esta seção apresenta a distribuição dos estudantes de acordo com o status de participação e apuração nas avaliações, em formato de gráfico circular (do tipo rosca).

Os principais status exibidos são:

  • Compareceu: estudantes que realizaram a avaliação e tiveram suas respostas corrigidas.
  • Invalidou: registros nos quais a avaliação foi desconsiderada (por erro de preenchimento, fraude, etc.).
  • Não Preencheu: estudantes que tiveram folha registrada, mas não chegaram a preencher o conteúdo da avaliação.
  • Não Compareceu: estudantes ausentes no momento da aplicação.
  • Transferido: estudantes que foram transferidos de escola durante o período da fase.
  • Evadido: estudantes que deixaram a rede ou abandonaram o processo.
  • Desconhecido: registros cujos dados não puderam ser associados a um estudante válido.
  • Pendente: estudantes que ainda não tiveram sua avaliação corrigida ou cujo status final ainda não foi definido.

À direita do gráfico, é apresentado o Detalhamento por Status, com a contagem absoluta e o percentual de estudantes em cada categoria, facilitando a leitura dos dados exibidos na rosca.

Escopo por contexto: os status apresentados consideram sempre apenas os estudantes pertencentes ao contexto atual (fase inteira, rede específica ou turma selecionada).

Status dos Participantes


# Considerações Finais

Os três modos de acesso (fase, rede e turma) compartilham as mesmas funcionalidades e estrutura visual.
A diferença está apenas no escopo de exibição dos dados, que é sempre limitado ao contexto selecionado:

  • Por Fase: apresenta o consolidado geral de todas as escolas e turmas da fase.
  • Por Rede: mostra apenas as escolas e turmas que pertencem à rede/cliente selecionado.
  • Por Turma: exibe exclusivamente os resultados daquela turma específica (incluindo gráficos, alertas, detalhamentos e status).

Em todos os casos, o módulo Gestão e Monitoramento Avalia4all segue o mesmo padrão visual e operacional, oferecendo uma visão detalhada e precisa do andamento das apurações, com foco na tomada de decisão por parte de gestores e coordenadores.