Como o boletim é composto

O boletim oficial do Codout.School não é um relatório "ao vivo": ele é montado a partir da fotografia que o sistema tira de cada período no momento do fechamento. Esta página explica essa lógica e a tela que gera os boletins.

A fotografia do período fechado

Quando a coordenação fecha um período, o sistema grava uma fotografia (um retrato fiel) de todas as notas e médias daquele período, por aluno e por disciplina. O boletim oficial lê exclusivamente essas fotografias:

• Período aberto não imprime. Enquanto houver período em aberto no recorte pedido, ele simplesmente não entra no documento — não existe boletim oficial de período aberto.
• A fotografia é o documento, não uma cópia de conveniência: se as notas mudarem depois (com o período reaberto), a fotografia antiga é marcada como desatualizada e um novo fechamento gera uma versão nova, preservando a anterior para auditoria.
• O boletim sai com um carimbo de origem informando de quais fechamentos ele foi gerado (período, versão e data) — e a palavra "DESATUALIZADO" quando a fotografia foi superada por uma reabertura.
• Períodos fechados antes de o recurso de fotografia existir são lidos dos dados originais, que ficam congelados pela trava de fechamento — o resultado é o mesmo.

:::info Regra do sistema O boletim é montado por uma fonte única para todos os canais: o documento que a secretaria gera é idêntico ao que a família vê no Portal da família. No portal da família, período aberto também não gera boletim — nem tentando o endereço direto do arquivo. :::

Tela Gerar Boletins

Onde: menu lateral Acadêmico → menu Relatórios → Gerar Boletins.

Quem pode usar: usuários administrativos com a permissão Gerar Boletins (a pré-visualização exige Pré-visualizar Boletim).

Para que serve

Gerar os boletins oficiais de uma turma para um período fechado — um ato deliberado da secretaria, e não um efeito automático. Cada boletim gerado entra no livro de emissões com numeração própria de boletim, código de verificação pública e PDF arquivado.

Campos

Campo	O que é
Ano letivo	Ano dos períodos e turmas
Período	Período do boletim — logo abaixo aparece o status: fechado (e quando) ou ainda aberto
Turma	Turma cujos boletins serão gerados

Ações

Ação	O que faz
Pré-visualizar	Abre o boletim de um aluno com as notas ao vivo (mesmo com o período aberto), marcado como provisório — serve só para conferência, não emite nem registra nada
Gerar Boletins	Gera o boletim oficial de todos os alunos ativos da turma para o período fechado selecionado
2ª via (impressora, na lista)	Reimprime o PDF arquivado do boletim — nunca remonta o documento
Revogar (na lista)	Invalida um boletim gerado por engano; exige o motivo, que fica registrado no livro

A lista Boletins Gerados mostra, por ano: número, período, turma, aluno, versão, status (Válido/Substituído/Revogado), quando e por quem foi emitido e o código de verificação (com link para a página pública de validação — veja Validação pública).

Passo a passo — gerar os boletins do bimestre

1. Feche o período na coordenação (veja Etapas e fechamento).
2. Abra Acadêmico → Relatórios → Gerar Boletins.
3. Escolha o ano, o período e a turma. Confira o status: "Período fechado em [data] — pronto para gerar."
4. Se quiser conferir antes, use Pré-visualizar com um aluno de amostra.
5. Clique em Gerar Boletins e confirme. O sistema informa quantos boletins foram gerados e lista os alunos que ficaram de fora, se houver.
6. Imprima ou reimprima pelos botões da lista Boletins Gerados.

:::info Regra do sistema

• Só período fechado gera boletim. Com o período aberto, o botão fica desabilitado e o servidor recusa: "O período ainda não foi fechado. Feche o período pela coordenação antes de gerar os boletins."
• O boletim é "de acordo com o fechamento": gerar o boletim do 2º bimestre mostra 1º e 2º bimestres, mesmo que o 3º já esteja fechado.
• Regerar o mesmo período cria uma versão nova (v2, v3...) e marca a anterior como Substituída — a substituição só acontece depois que o PDF novo foi arquivado com sucesso; se a geração falhar, a via anterior continua válida.
• Um aluno com falha não derruba a turma: o sistema revoga automaticamente a via com problema e segue gerando os demais, informando os nomes que ficaram de fora.
• A impressão do boletim disponível em outras telas (por exemplo, na ficha da matrícula ou no portal do professor) apenas reimprime a última emissão registrada — nunca gera um documento novo por conta própria.

:::

O resultado do aluno no boletim

Quando o boletim já contém as médias finais do ano, ele traz o resultado do período por aluno. A decisão usa o corte de aprovação — padrão 6,0, configurável conforme o regimento de cada escola:

Resultado	Quando aparece
Aprovado	Todas as médias finais atingiram o corte
Prova Final	Há disciplina abaixo do corte e a recuperação ainda não foi lançada — o aluno ainda tem a prova final pela frente
Retido	Há disciplina abaixo do corte mesmo depois da recuperação lançada (nota de recuperação maior que zero)
(em branco)	As médias finais ainda não fecharam — resultado em aberto

Exemplos com corte 6,0:

• Ana: Português 7,5 · Matemática 6,0 · História 8,0 → Aprovado.
• Bruno: Português 7,0 · Matemática 5,8, recuperação ainda não lançada → Prova Final.
• Carla: Português 7,0 · Matemática 5,5, já com recuperação lançada (por exemplo, 6,5 de nota de recuperação, mas média final ainda 5,5) → Retido.

Frequência e dependências (resultado do ano)

Para o resultado anual que vai à ata e ao histórico escolar, valem também as regras legais:

• Frequência mínima de 75% para aprovação: frequência anual abaixo de 75% reprova por frequência, independentemente das notas. A frequência anual é calculada como a proporção de dias frequentados sobre os dias letivos, com uma casa decimal.
• Pré-escola: o acompanhamento mínimo é de 60% de frequência, mas não existe retenção — educação infantil não tem aprovação/reprovação; o ano concluído sai como "Cursou".
• Progressão parcial (dependências): até 4 disciplinas abaixo do corte, o aluno sai como "Aprovado com Progressão Parcial"; acima disso, "Reprovado". O limite também é configurável conforme o regimento.

Exemplo: Diego terminou o ano com 2 disciplinas abaixo de 6,0 e frequência de 88% → Aprovado com Progressão Parcial (2 dependências). Se tivesse 5 disciplinas abaixo do corte → Reprovado. Se a frequência fosse 70%, seria Reprovado por Frequência, mesmo com todas as médias acima do corte.

Boletim, ata, mapa de notas e histórico escolar usam a mesma regra de resultado — os documentos nunca divergem entre si.

O corte de aprovação, o limite de dependências e a frequência mínima são parâmetros da escola (padrões 6,0 · 4 · 75%). TODO: VALIDATE — onde esses parâmetros são alterados na interface; na dúvida, solicite o ajuste ao suporte.

Problemas comuns

• "Período ainda ABERTO — feche pela coordenação antes de gerar." — o boletim oficial só sai de período fechado. Use a pré-visualização enquanto isso.
• "Nenhuma matrícula ativa na turma." — a turma selecionada não tem alunos com matrícula ativa.
• "N aluno(s) sem dados/unidade" — alguns alunos não puderam ser gerados (por exemplo, matrícula sem unidade escolar vinculada ou nenhum período fechado no recorte). Os nomes aparecem na mensagem; corrija o cadastro e gere novamente.
• O boletim impresso está diferente das notas na tela — as notas mudaram depois do fechamento (período reaberto). Feche o período novamente e regere os boletins para emitir a versão atualizada; a página de validação passará a indicar a via antiga como substituída.