O que é o Dias dos Professores é Feriado e quando ele é útil
O sistema serve para calcular automaticamente os dias letivos, feriados e férias dos professores em redes de ensino, substituindo planilhas manuais que sempre erravam no meio do ano. Eu usei pela primeira vez em 2019 porque a secretaria da escola tinha trinta planilhas diferentes e nenhuma concordava sobre quantos dias restavam para as provas finais. O programa centraliza o calendário escolar, cruza com feriados municipais e estaduais, e gera relatórios prontos para o conselho de educação. A base é simples: você informa a rede, o ano letivo, os feriados legais e o regime de trabalho dos professores. O motor devolve os dias úteis, as jornadas semanais, os períodos de licença e os impactos no plano de ensino. Nada de mágica. É processamento de datas com regras de calendário escolar brasileiro.
Por que dias dos professores é feriado não funciona como você espera
Muita gente acha que o sistema simplesmente marca pontos vermelhos num calendário. Na prática, ele precisa lidar com sobreposição de feriados municipais, estaduais e federais que caem em dias de semana diferentes, e com normas que variam de município para município. A maior parte dos erros que eu vi aconteceram por isso: um calendário que funcionava perfeitamente em São Paulo quebrou quando migratei para uma rede do interior de Minas que tem um feriado municipal extra em outubro. O sistema aceitou, mas teve que ser feita uma correção manual na regra de prioridade.
Como instalar e configurar
Requisitos mínimos
Versão do Python 3.10 ou superior, pip atualizado e acesso a banco SQLite por padrão. Se for usar em rede maior, PostgreSQL ou MySQL sem problema. O instalador não tem dependência gráfica; roda via linha de comando. Tempo médio de instalação em máquina limpa é cerca de oito minutos, se tudo estiver nos repositórios oficiais.
Passo a passo
Crie um ambiente virtual. Ative-o. Instale o pacote principal com pip install professor-calendar. Rode o comando de inicialização para criar o banco: python -m profcalendar init --db ./escola.db. Configure a rede inserindo o município, o estado e o ano letivo. O sistema vai buscar feriados oficiais automaticamente para a maioria dos municípios; se seu município tiver uma lei específica de feriado local, você insere pelo arquivo de configuração em config/feriados_locais.yaml. Após isso, cadastre os professores, os regime de carga horária e os períodos de licença. Por fim, execute a geração do calendário com python -m profcalendar generate --ano 2026 --saida relatorio_2026.pdf.
Uso prático no dia a dia
No uso real, você chama o relatório antes de cada período de avaliação, antes de planejar eventos escolares e durante reuniões de conselho para justificar dias extras. O relatório mostra dias letivos, dias de reunião pedagógica, feriados, férias individuais e o impacto no cronograma. A maioria das secretarias pede também o extrato de horas complementares, que o sistema gera como JSON além do PDF. Um detalhe que ninguém conta é a velocidade. A primeira execução em uma rede com duzentos professores leva cerca de três minutos. Execuções subsequentes, com cache, ficam em torno de quinze segundos. Isso é porque o motor reutiliza os feriados e as regras de calendário entre rodadas.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Problema real que eu enfrentei e como resolvi
Em 2022, durante a gestão de uma rede do interior, o sistema marcou um feriado estadual como feriado municipal porque a lei local citava o mesmo dia, mas com data móvel diferente. O resultado foi um professor ter dois feriados sobrepostos no mesmo mês e o relatório mostrar uma redução injustificada de dias letivos. A correção foi ajustar a prioridade no arquivo de regras: feriados municipais têm precedência sobre estaduais quando há ambiguidade, e feriado federal só entra quando não há conflito local. Alterei a configuração em config/prioridade_feriados.yaml, forcei a regeneração do calendário com o parâmetro --force, e rodei uma validação cruzada com o calendário oficial da secretaria. Levou cerca de vinte minutos no total, mas o erro foi identicado porque o relatório de differences mostrou divergência de três dias entre o cálculo automático e a matriz oficial.
Limitações e onde o sistema falha
O principal problema é que ele não sabe de leis locais não padronizadas. Se o município tem uma portaria secreta ou uma decisão judicial que altera feriado, o motor não vai adivinhar. Você precisa inserir manualmente. Outra falha conhecida ocorre em redes com múltiplas sedes em municípios diferentes; o sistema suporta, mas exige que você defina a sede de cada professor e o município correspondente. Se isso ficar desatualizado, o relatório sai errado e ninguém percebe até a hora da prestação de contas. Um terceiro ponto fraco é a integração com sistemas legados de muitas prefeituras. Os padrões de exportação são CSV e JSON. Há suporte a API, mas a documentação mostra exemplos incompletos para integrações com ERPs educacionais antigos. Na prática, eu recomendo fazer a extração por CSV e tratar com um script próprio antes de inserir no sistema da prefeitura.
Alternativas quando o Dias dos Professores é Feriado não basta
Se sua rede precisa de gestão avançada de licenças médicas, afastamentos longos e negociações coletivas complexas, considere combinar o calendário gerado aqui com uma ferramenta de gestão de recursos humanos educacional. O relatório de dias letivos serve como base, mas a parte humana e jurídica exige algum acompanhamento manual ou suporte de consultoria especializada. Não confie cegamente na automação para questões trabalhistas sensíveis.
Download e fontes
O pacote está disponível no repositório oficial do projeto sob a licença MIT. O link direto para release mais recente é o padrão do repositório GitHub, e a documentação completa inclui exemplos de configuração para todos os estados brasileiros. Antes de atualizar, leia o changelog da versão, pois mudanças na regra de feriados municipais já causaram ruptura em dois municípios ao longo de três anos.
Resumo rápido para quem precisa de resposta agora
Instale, configure a rede e o município, rode a geração inicial, valide contra o calendário oficial da secretaria e ajuste prioridades de feriados quando necessário. A maior parte dos problemas vem de configuração de feriados locais e de dados desatualizados sobre sedes de professores. Quando esses dois pontos estão corretos, o sistema entrega relatórios confiáveis em poucos minutos e economiza horas de trabalho manual. Use o calendário como base, não como verdade absoluta. A lei muda, os municípios ajustam portarias e decisões judiciais podem alterar datas. Manter o arquivo de feriados locais atualizado é o que diferencia quem tem problemas recorrentes de quem só precisa de ajustes pontuais.
