# Relatório de Auditoria dos Diários
# Introdução
Este recurso faz parte da Gestão Escolar. Para entender o contexto geral, os demais módulos da Secretaria e o fluxo do ano letivo, acesse Gestão Escolar.
No fluxo da Gestão Escolar, após as Chamadas e o registro no Diário de Classe, a Auditoria dos Diários de Classe responde à pergunta “quais aulas previstas estão completas, pendentes, atrasadas ou com intervenção da Secretaria?”.
O relatório lista o andamento por aula (diário), não por aluno. Ele não edita chamadas — apenas consulta o que foi lançado ou omitido.
Esta funcionalidade é utilizada para:
- Ver omissões (chamada e/ou conteúdo não preenchidos)
- Identificar lançamentos retroativos ou em atraso
- Rastrear intervenções da Secretaria e edições após o primeiro registro
- Exportar dados para cobrança ou arquivo
| Não confundir com | Onde fazer |
|---|---|
| Percentual de presença por aluno | Mapa de Frequência |
| Registrar ou regularizar uma aula | Chamadas ou Diário de Classe |
| Montar a grade semanal | Quadro de Horários |
Observação — posição no fluxo
Este é o passo 7 do fluxo da Gestão Escolar (Gestão Escolar → Fluxo do ano letivo), em conjunto com o Mapa de Frequência. Use-o quando já houver aulas previstas na grade publicada.
# Município e Escola
Os relatórios da Gestão Escolar ficam na aba Relatórios (não na Secretaria). Município e Escola acessam a mesma tela; o que muda é o escopo de turmas disponível na estrutura da rede em que o usuário está logado.
| Município | Escola | |
|---|---|---|
| Papel | Auditar diários da rede | Auditar diários da unidade (e turmas visíveis) |
| Acesso ao card | Sim, com Gestão Escolar habilitada | Sim, com Gestão Escolar habilitada |
| Editar chamadas pelo relatório | Não | Não |
| Regularizar omissões | Não — use Chamadas na escola, com permissão de escrita | Sim, na escola, com permissão de escrita direta |
Observação
Diferente das Chamadas, a Auditoria não exige escrita direta para processar e exportar. Para regularizar omissões, acesse as Chamadas na Escola com permissão de escrita.
# Quem pode usar e permissões
| Ação | Gestor (Município ou Escola) | Professor |
|---|---|---|
| Ver o card em Relatórios | Sim, se Gestão Escolar habilitada | Não |
| Processar relatório | Sim | Não |
| Filtrar localmente após processar | Sim | Não |
| Exportar CSV / Imprimir | Sim | Não |
| Regularizar omissões | Não pelo relatório | Sim (aulas do usuário, no Diário) |
O card Auditoria dos Diários de Classe só aparece quando a Gestão Escolar está habilitada para o cliente.
# Antes de começar
Antes de processar o relatório, certifique-se de que:
- ✔ Gestão Escolar habilitada no cliente
- ✔ Quadro de Horários publicado (Quadro de Horários)
- ✔ Calendário Escolar local publicado e dias letivos definidos (Calendário Escolar)
- ✔ Alocação de Professores concluída (Alocação de Professores)
O relatório lista aulas previstas no período. Turmas sem grade publicada ou sem aulas no intervalo podem retornar Sem resultados.
# Fluxo recomendado
- Confira o ano letivo no cabeçalho da rede.
- Escolha o card Auditoria dos Diários de Classe na aba Relatórios.
- Em Escopo, selecione as turmas.
- Em Filtros, ajuste o período (padrão: Este ano).
- Escolha a opção Processar.
- Use os filtros locais (professor, turma, disciplina, status, condição) para refinar.
- Se precisar regularizar, vá às Chamadas na escola, com permissão de escrita.
- Exporte com CSV Completo ou Imprimir/PDF, se necessário.
# Como acessar
No Administrativo, após selecionar o Município ou a Escola (veja como acessar a rede), escolha a aba Relatórios — não a Secretaria — e o card Auditoria dos Diários de Classe.
A tela abre com o título Auditoria dos Diários de Classe, o nome da rede e o link Voltar para o hub de Relatórios.
# Passo a passo na tela
- Em Escopo, escolha a opção Selecionar turmas.
- Na janela, marque as turmas na estrutura da rede (filtro de ano letivo disponível) e confirme com Selecionar turmas.
- Expanda Filtros e escolha o período.
- Escolha a opção Processar.
- Após processar, os filtros locais aparecem na mesma seção Filtros (abaixo do período).
- Analise os cards, os gráficos e a tabela.
- Se precisar, use CSV Completo ou Imprimir/PDF.
Sem turma selecionada, ao processar, a plataforma exibe um alerta com "Selecione ao menos uma turma para processar o relatório." e abre a janela de escopo automaticamente.
Depois de processar, a tela mostra os botões de exportação, os cards e os gráficos:
# Filtros
# Escopo e período
| Elemento | Comportamento |
|---|---|
| Selecionar turmas | Obrigatório; só turmas (tipo grupo) são selecionáveis. Trocar o escopo limpa o resultado anterior. |
| Período | Padrão Este ano; atalhos (Últimos 7/14/28/30 dias, Este mês, etc.) e opção Personalizado. |
| Ao alterar período ou escopo | Resultado deixa de valer — escolha a opção Processar de novo. |
# Filtros locais (após processar)
Aparecem somente depois de Processar, na seção Filtros, e não fazem nova consulta à plataforma — apenas restringem cards, gráficos e tabela.
| Filtro | Opções |
|---|---|
| Professor | Todos os professores / um professor específico |
| Turma | Todas as turmas / uma turma do resultado |
| Disciplina | Todas as disciplinas / uma disciplina |
| Status | Todos os status; Omissão / Pendente; Retroativo / Atrasado; Intervenção da Secretaria; Lançado no prazo |
| Condição | Todas as condições; Editado após o 1º lançamento; Sem edições posteriores |
Atenção — filtros não são exclusivos
Os indicadores Retroativo, Intervenção, No prazo e Editado podem coincidir no mesmo registro (ex.: aula completa, retroativa e editada). Os cards refletem o conjunto filtrado atual — não são categorias que somam 100% do total.
# O que o relatório mostra
# Cards de resumo
| Card | Significado |
|---|---|
| Visão geral (todos) | Total de aulas no resultado filtrado |
| Omissões (pendentes) | Diários incompletos (falta chamada e/ou conteúdo) |
| Retroativo / atrasado | Lançamentos em atraso |
| Intervenção da Secretaria | Aulas com registro feito pela Secretaria |
| No prazo | Completos e sem atraso |
| Editados após 1º lançamento | Houve edição depois do primeiro registro |
# Gráficos
- Status dos diários — completos × pendentes (com detalhamento por status);
- Indicadores de auditoria — retroativo, intervenção, no prazo e editados.
# Tabela
| Coluna | Conteúdo |
|---|---|
| Data da Aula | Data prevista da aula |
| Professor | Professor da aula |
| Disciplina | Componente / disciplina |
| Turma | Nome da turma |
| Status / Rastreamento | Tag Completo ou Pendente, tag Editado (se houver) e texto explicativo |
Paginação: 10 linhas por página. Ordenação padrão: data da aula (crescente).
# Status e condições
# Quando o diário é Completo
É preciso ter, ao mesmo tempo:
- Chamada registrada (presenças/faltas lançadas); e
- Conteúdo preenchido.
Observações são opcionais — o diário pode ficar Completo sem elas.
Texto típico na tabela: "Diário preenchido (chamada e conteúdo)." Se houver observações, intervenção ou edição, a mensagem complementa.
# Quando é Pendente
Falta chamada e/ou conteúdo. Exemplo: "Pendente: chamada, conteúdo" ou só um dos dois.
# Outras marcas
| Marca | Significado |
|---|---|
| Retroativo / atrasado | Aula marcada como atrasada, ou lançada em data depois da data prevista |
| Intervenção da Secretaria | Registro feito (ou assumido) pela gestão escolar |
| No prazo | Completo e não retroativo |
| Editado | Houve alteração depois do primeiro lançamento |
# Regras importantes
| Regra | Efeito |
|---|---|
| Escopo por turmas | Sem turma, não processa. |
| Trocar período ou turmas | Exige Processar de novo. |
| Filtros locais | Só refinam o resultado já carregado. |
| Gestão Escolar desabilitada | Card não aparece em Relatórios. |
| Relação com Chamadas / Diário | A auditoria não edita aulas — só lista. Para regularizar, use Chamadas ou o Diário. |
# Exportar CSV e Imprimir/PDF
Aparecem só após processar, com pelo menos um registro no filtro atual.
| Botão | Conteúdo |
|---|---|
| CSV Completo | Professor, Turma, Componente, Data, Chamada (Sim/Não), Conteúdo, Observações, Status (separador ponto e vírgula; BOM UTF-8). |
| Imprimir/PDF | Impressão do navegador (pode salvar como PDF). |
Nome típico do CSV: Auditoria-Diarios-{rede}-{periodo}.csv.
O CSV e a impressão respeitam os filtros locais ativos no momento da exportação.
# Consulta rápida
# Glossário
| Termo | Significado |
|---|---|
| Diário completo | Chamada registrada e conteúdo preenchido |
| Omissão / Pendente | Falta chamada e/ou conteúdo |
| Retroativo / atrasado | Lançamento fora do prazo ou após a data prevista |
| Intervenção da Secretaria | Registro com origem da gestão escolar |
| Editado | Alteração após o primeiro lançamento |
| No prazo | Completo sem marca de retroativo |
| Processar | Consulta a plataforma e carrega o histórico de diários do período |
# Mensagens e estados
| Situação | Mensagem / comportamento |
|---|---|
| Sem turma ao processar | "Selecione ao menos uma turma para processar o relatório." + janela de escopo |
| Rede não identificada | "Não foi possível identificar a rede para consultar o relatório." |
| Sem dados no período | Sem resultados — "Não há registros de diários de classe para os filtros selecionados." |
| Filtros locais sem match | Sem resultados com a mesma mensagem — afine ou limpe os filtros |
# Erros comuns
| Situação | O que fazer |
|---|---|
| Card não aparece | Confirme se a Gestão Escolar está habilitada. |
| "Selecione ao menos uma turma…" | Marque turmas no escopo. |
| "Sem resultados" | Ajuste o período ou o escopo; confira se há aulas previstas na grade publicada. |
| Muitos diários pendentes | Oriente o professor a completar chamada e conteúdo. |
| Quer ver só omissões | Após processar, filtro Status → Omissão / Pendente. |
| Quer ver intervenções | Após processar, filtro Status → Intervenção da Secretaria. |
| Cards não somam 100% | Normal — indicadores podem se sobrepor no mesmo registro. |