Central de ajuda
Comece pelo guia rápido de seis etapas ou abra o manual completo quando precisar de mais detalhes.
Comece por aqui
Uma visão curta do caminho recomendado. Você pode abrir qualquer etapa ou avançar na sequência.
Etapa 1
Comece pelo contexto certo: escola, ano letivo, turno e turmas que realmente participarão do horário.
A lista contém somente as turmas que poderão entrar nas versões deste horário.
Caminho recomendado
Visão do produto
Abra qualquer imagem para consultar os detalhes em tamanho maior.
Ampliar imagemA página inicial apresenta o fluxo, os recursos e o caminho para começar gratuitamente.
Ampliar imagemA tabela mostra os valores de 1 a 10 turmas e calcula escolas maiores.
Ampliar imagemO PDF organiza uma turma por página e respeita dias com quantidades diferentes de aulas.
Capítulo
O Horario Plus monta e mantém grades escolares como um SaaS independente. Uma escola nova cria a própria conta e configura os dados essenciais pelo assistente; quem já usa o Educara entra com as credenciais existentes e reaproveita escola, turmas, docentes e disciplinas sem duplicação.
O produto é indicado para a preparação do horário letivo. Ele não cobre, nesta fase, salas, laboratórios, substituições ou alterações diárias de aula.
Capítulo
Cada versão possui seu próprio conjunto de turmas. Uma versão publicada só substitui outra versão ativa quando elas se sobrepõem no período, turno e em pelo menos uma turma. Assim, a escola pode manter simultaneamente horários separados para conjuntos diferentes de turmas.
Capítulo
A sidebar fica fixa enquanto a página é rolada. Ela contém as áreas de trabalho:
Use o botão de recolher no fim da sidebar ou o botão de foco no topo para aumentar a área disponível para a grade. No modo recolhido, os ícones mantêm seus rótulos como dica ao passar o mouse ou navegar pelo teclado.
Antes de editar qualquer configuração, confirme estes três filtros:
Uma mudança de escola, ano ou turno troca o contexto de trabalho. Ela não altera dados já salvos.
Clique no nome do usuário no topo. A conta SaaS oferece:
Contas criadas no Horario Plus usam autenticação própria. Contas vinculadas ao Educara continuam aceitando o login Educara no acesso unificado.
Uma conta pode ativar uma única escola gratuita, limitada a uma turma. As demais escolas exigem plano pago e cada assinatura pertence a uma escola.
O upgrade cobra somente a diferença proporcional aos dias restantes do ciclo. A redução de limite vale na próxima renovação manual e exige reduzir antes as turmas licenciadas. A licença não gera cobrança automática: ao vencer, a escola fica em modo somente leitura até que o cliente renove.
Quando houver uma campanha vigente, informe o cupom na etapa Escola e plano ou em Assinatura → Aumentar turmas. Use Aplicar para validar antes de continuar. O sistema mostra o percentual, o valor original, o desconto e o valor final. Cupons inativos, vencidos, inexistentes ou que atingiram o limite de utilizações não são aceitos.
Quando o cupom concede 100% de desconto, o Horário+ não abre o Mercado Pago. A venda é registrada com valor zero, o uso do cupom é consumido e a licença fica ativa imediatamente pelo ciclo escolhido. Como não existe uma assinatura recorrente no provedor, a licença deve ser renovada ao final desse período.
Os planos pagos podem ser parcelados em até 3 vezes sem juros, com o custo financeiro absorvido pelo Horario Plus. O Checkout Pro pode apresentar parcelas adicionais com juros calculados pelo Mercado Pago; o cliente vê o valor total antes de confirmar. A quantidade máxima de parcelas adicionais é configurável.
Administradores do Horário+ acessam Administração pelo menu da conta ou pelo endereço /app/admin. A permissão é própria da conta Horário+ e também aceita, por compatibilidade, superadministradores Educara de perfil 100. Nessa área é possível criar e editar cupons, definindo código, percentual de desconto, quantidade máxima de utilizações, data de vencimento e estado ativo ou inativo.
O relatório de vendas preserva o código, o percentual e o valor descontado em cada operação. Editar ou inativar um cupom não altera o histórico das vendas anteriores.
No painel Administração → Aquisição, selecione 7, 30 ou 90 dias, ou informe um período próprio. O resumo apresenta visitantes, sessões, páginas vistas, cadastros, contratações e escolas que chegaram à primeira geração. O funil mostra em qual etapa há maior abandono, enquanto as tabelas identificam páginas e origens que trazem mais pessoas.
A coleta é própria do Horário+, respeita os sinais “Não rastrear” e Global Privacy Control do navegador e guarda os identificadores de sessão e visitante somente por hash. Não entram nessa telemetria IP, senha, conteúdo escolar ou dados completos de pagamento.
Em Administração → SEO, escolha uma rota pública e revise:
A nota da página aponta títulos ou descrições curtos e longos, canonical fora do domínio e ausência de imagem social. A prévia permite conferir o resultado antes de salvar. A alteração aparece no navegador imediatamente; para entrar também no HTML pré-renderizado, publique um novo build com SEO_CONFIG_API_URL apontando para a API pública do Horário+.
O onboarding registra progresso e conduz quatro etapas:
O sistema provisiona automaticamente o ano letivo atual, o vínculo do proprietário e as regras padrão do solver. Horários de aula e recreio são perguntados porque não podem ser inferidos com segurança.
No workspace, Gerar com assistente conduz o percurso acadêmico Escola → Turmas → Perfis → Disciplinas → Docentes → Cargas → Grade. O menu Grade sempre abre a consulta convencional de versões; use o botão do assistente na barra lateral ou nessa consulta para iniciar ou retomar o passo a passo. Quando a versão criada fica completa, a sessão guiada é encerrada automaticamente.
Capítulo
Faça a preparação uma vez por escola, ano e turno. A ordem abaixo reduz pendências e evita refazer trabalho depois da geração.
Abra Escola no menu de Configuração para manter nome oficial, nome resumido, e-mail, telefone e endereço. O CNPJ é exibido somente para conferência porque também identifica o contrato; sua alteração exige o fluxo administrativo.
Na coluna Logotipo da escola, envie uma imagem PNG, JPG ou WebP de até 5 MB. Prefira uma arte transparente, horizontal ou quadrada, com boa leitura em fundo branco. O arquivo é enviado pela API do Educara e armazenado no Azure Blob com acesso protegido. Depois de salvar, ele passa a identificar a escola na interface e no cabeçalho dos PDFs.
Escolas novas já são criadas durante o onboarding. Esta tela não cria outra escola: ela mantém o cadastro da escola selecionada no topo. Para administrar mais uma unidade, use Adicionar escola em Minha conta.
Abra Turmas no menu de Configuração para definir quais turmas do ano letivo consomem a licença da escola. O contador mostra a quantidade selecionada e o limite do contrato.
seleção. Marque somente as que serão utilizadas no Horario Plus e salve.
identificação e turno. A nova turma é criada no cadastro mestre e já entra selecionada na licença.
Aumentar limite para alterar o plano.
Somente as turmas marcadas aparecem em Perfis, Cargas e na criação de versões de horário. A tela Turmas continua exibindo as demais turmas da escola para permitir a troca da seleção; esse comportamento não aumenta o limite contratado.
Abra Disciplinas. A seleção é única para a escola e o ano letivo: ela alimenta as cargas semanais e as habilitações que a grade usará.
O catálogo exibe:
mostraHorario = true;A Educação Infantil não aparece nessa matriz. Na BNCC, ela é organizada por campos de experiências — e não por componentes que formem uma grade semanal de disciplinas no Horario Plus.
Para editar:
Use Nova disciplina da escola quando a escola tiver uma componente que não faz parte do catálogo comum, por exemplo, Oficina de Teatro.
O novo registro recebe o id_escola da escola selecionada e é associado automaticamente ao ano em edição. Por isso ele não aparece no catálogo de outras escolas.
Um perfil descreve a rotina semanal de um turno: início e fim de cada aula, intervalos e os dias em que cada período funciona. Ele é reutilizável por várias turmas.
Exemplo de perfil 6º ano · manhã:
| Período | Horário | Dias |
|---|---|---|
| 1ª a 5ª aula | conforme o turno | segunda a sexta |
| 6ª aula | 11:30–12:20 | somente segunda |
Esse perfil possui 26 aulas semanais: seis na segunda e cinco de terça a sexta. A capacidade exibida na matriz de cargas usa exatamente essa soma.
Para criar um perfil:
Intervalo nos períodos em que não pode haver aula.Use Duplicar para criar um perfil semelhante e alterar apenas os horários necessários. Use Editar para corrigir um perfil existente. A exclusão só é possível quando o perfil não está vinculado a uma turma.
Na tela Grade, antes de existir uma versão, há a configuração de perfis por turma. Selecione o perfil adequado em cada linha.
O botão ? ao lado do seletor explica por que o perfil é obrigatório e leva diretamente ao cadastro de perfis. Sem um período letivo válido, a turma não oferece slots para o motor de horários.
Quando uma turma tiver uma exceção, use Personalizar semana desta turma. O sistema cria uma cópia exclusiva, associa-a à turma e mantém intacto o perfil geral utilizado pelas demais. Por exemplo, o 6º A pode receber uma sexta aula apenas na segunda sem alterar o 6º B.
Perfis antigos, cadastrados antes da configuração semanal, continuam aplicados de segunda a sexta até que sejam editados.
Abra Cargas. A tela apresenta disciplinas nas linhas e turmas nas colunas. Digite a quantidade diretamente em cada cruzamento; o cabeçalho e a coluna de disciplinas permanecem visíveis durante a rolagem.
Cada coluna compara carga configurada / capacidade semanal do perfil:
As edições ficam em rascunho local. Use Desfazer para voltar ao último estado carregado ou Salvar alterações para gravar o lote inteiro em uma única transação.
Copiar turma replica a matriz completa de uma origem para vários destinos:
Salve o rascunho atual antes de copiar. A cópia é executada no servidor em transação.
Uma carga zero é mantida como configuração explícita. Cargas antigas sem vínculo com id_escola_turma ficam preservadas no banco, mas não aparecem nem são usadas pelo Horario Plus. Quando necessário, o script de cópia associa esses dados às turmas do ano escolhido sem apagar a origem.
Em Regras gerais, configure os padrões da escola, ano e turno:
O comportamento padrão de blocos não cria aulas duplas sozinho. Primeiro, use o botão de ajustes da célula para informar quantos blocos duplos aquela disciplina deve possuir na turma. O padrão define somente se essa quantidade será ignorada, preferida ou obrigatória.
Use o botão de ajustes dentro de uma célula para criar uma exceção:
Exemplo: Matemática com 5 aulas, máximo diário 2 e um bloco exigido terá um par consecutivo e três aulas restantes distribuídas conforme as demais regras.
Para Educação Física na última aula, abra os ajustes da célula da turma e selecione Exigir última aula. Todas as aulas daquela carga serão limitadas ao último período letivo de cada dia. Se não existirem últimos períodos suficientes ou o docente estiver indisponível neles, a geração será bloqueada com um diagnóstico específico. Use Preferir última aula quando a posição for desejável, mas não deva impedir a cobertura total da carga.
Em Docentes, a lista vem de educador, filtrada pela escola e pela matrícula anual em educador_matricula.
Use Cadastrar docente para incluir alguém novo. O Horario Plus grava o cadastro mestre no Educara e cria automaticamente o vínculo anual para a escola e o ano selecionados. Após salvar, o mesmo diálogo libera as abas Disciplinas, Disponibilidade e Regras do horário.
Para cada pessoa que participa da grade:
O Horario Plus grava os vínculos específicos do turno em educador_disciplina. Vínculos globais existentes aparecem selecionados e protegidos; eles não são removidos pela tela.
Na aba Disponibilidade, o padrão é livre por padrão: nenhum registro significa que o docente pode ser usado em todos os períodos possíveis. Marque apenas os slots em que ele não pode lecionar.
Se a escola tiver uma agenda legada com registros disponivel = true, o sistema a identifica como agenda explícita. Ao salvar pelo novo modelo, é necessário confirmar a substituição. Isso evita apagar a regra antiga sem intenção.
Escolas pequenas costumam ter docentes que ministram mais de uma disciplina. Para evitar que a mesma pessoa saia e retorne muitas vezes à mesma turma no dia, abra Regras do horário no diálogo do docente.
Aulas consecutivas contam como uma única presença, mesmo quando a disciplina muda. Intervalo, lacuna ou a passagem de outro docente antes do retorno inicia uma nova presença. Esta regra soma todas as disciplinas, mas não cria bloco duplo.
| Sequência | Resultado |
|---|---|
| Matemática/Pablo → Matemática/Pablo → Educação Financeira/Pablo | Uma presença do Pablo e um bloco duplo de Matemática |
| Matemática/Pablo → História/outro docente → Educação Financeira/Pablo | Duas presenças do Pablo; é incompatível com limite obrigatório 1 |
Para impedir que o docente retorne à turma depois de sair, escolha Tornar o limite obrigatório e informe 1 presença separada por turma/dia. Para formar duas aulas seguidas de Matemática, configure separadamente a quantidade de blocos duplos na célula de Matemática daquela turma.
A listagem de docentes mostra a regra efetiva e informa se ela vem do padrão da escola ou de uma exceção individual.
Capítulo
Na tela Grade, o bloco Prontidão da geração consolida os requisitos que ainda impedem uma geração confiável.
Pendências mais comuns:
| Pendência | Como resolver |
|---|---|
| Perfil ausente | Associar um perfil de períodos à turma. |
| Perfil sem aulas | Cadastrar ao menos um período letivo, que não seja intervalo. |
| Carga ausente | Informar a carga semanal das disciplinas da turma. |
| Docente sem habilitação | Ativar o docente e vincular a disciplina no turno. |
| Disponibilidade incompatível | Remover bloqueios excessivos ou revisar a agenda legada. |
O botão Abrir configuração direciona para a área necessária. Só avance para publicação quando não houver pendências obrigatórias.
Capítulo
Exemplo: crie Fundamental II · manhã e selecione somente as turmas desse segmento. A prontidão, a geração e a publicação considerarão apenas essa seleção.
Enquanto a versão estiver em rascunho, use Turmas da versão na barra da Grade para alterar o conjunto. Aulas já geradas para turmas removidas são descartadas; gere novamente para recalcular a grade. Uma versão publicada é imutável.
O seletor apresenta somente turmas licenciadas no contrato da escola. Se uma turma não aparecer, abra Minha assinatura e revise as turmas participantes antes de criar a versão.
Use Inativar no cartão da versão quando ela não deve mais aparecer na operação cotidiana. A confirmação preserva a grade e o histórico, mas remove a versão da lista padrão e a torna somente para consulta. Se ela estiver publicada, deixará de ser a versão ativa.
Ative o switch Mostrar inativas para consultar versões arquivadas. A ação Reativar devolve a versão como rascunho editável; ela não é republicada automaticamente.
Clique em Gerar horário para criar um processamento em segundo plano. O motor OR-Tools CP-SAT roda integralmente na API, sem chamada de IA remota. A tela é liberada imediatamente e a geração continua mesmo que você navegue para outra área.
Antes de liberar a geração, o pré-voo verifica cada carga da versão:
Essa verificação elimina erros básicos antes do solver. A combinação global entre todas as turmas e docentes continua sendo comprovada pelo CP-SAT durante a geração.
O motor respeita estas regras obrigatórias:
Disciplinas diferentes podem ocorrer normalmente na mesma turma no mesmo dia. O impedimento é simultaneidade: a turma ou o docente não podem ocupar dois lugares no mesmo slot.
O motor executa tentativas de aproximadamente 25 segundos, variando a semente de busca e reutilizando a melhor grade como dica reversível. O limite padrão é de cinco minutos; a busca termina antes quando prova a solução ótima ou quando três tentativas seguidas não melhoram o resultado após o primeiro minuto.
Depois de cumprir as regras obrigatórias, ele compara cada resultado por este vetor, nesta ordem:
Essa comparação é lexicográfica: melhorar janelas nunca compensa perder uma aula da carga. A nota de 0 a 100 ajuda a leitura, mas não decide sozinha qual grade é melhor:
Uma grade com conflito obrigatório ou aula pendente continua classificada como Incompleta, independentemente da nota. Entre grades completas, 90 ou mais é Excelente, 80 a 89 é Boa e abaixo de 80 pede Revisão.
Durante a busca, o painel mostra progresso, tentativa atual, cronômetro atualizado a cada segundo, nota inicial e melhor nota. A barra superior mantém o indicador Gerando horário mesmo quando você navega para outra área; clique nele para voltar à versão.
Você pode fechar a aba ou o navegador. O processamento continuará na API e será recuperado automaticamente na próxima entrada, sem reiniciar a busca. Use Cancelar geração para interromper com segurança; a grade atual será preservada.
Ao concluir, o sistema informa uma destas situações:
O resultado abre em um diálogo que permanece na tela até sua confirmação. Ele resume nota, cobertura, aulas pendentes e os primeiros diagnósticos da validação. Clique em Ver resultado na grade para fechar o resumo e abrir a versão com todos os indicadores e detalhes.
Depois de uma aplicação, Desfazer aplicação restaura a grade anterior. Essa opção expira quando ocorre uma nova edição, trava, geração ou publicação.
Capítulo
Com uma versão selecionada, a grade pode ser visualizada por:
Arraste a aula até outro slot compatível. O sistema valida o movimento antes de mantê-lo, protegendo conflitos de turma, docente, perfil e disponibilidade.
Use Fixar neste horário na aula quando a posição for uma decisão já definida pela escola. Na próxima regeneração, aulas fixas permanecem no mesmo lugar e exibem um cadeado destacado.
Também é possível criar a regra antes da primeira geração:
O sistema valida perfil da turma, carga, habilitação, disponibilidade, docente único e conflitos do slot. Use Desfixar aula para liberar uma decisão antes de regenerar.
Depois de alterar cargas, habilitações, disponibilidade ou travas, gere novamente. O motor preserva as travas como regras obrigatórias, usa as demais aulas atuais somente como dicas e recalcula o restante. A grade nova nunca substitui automaticamente uma grade com vetor melhor.
Capítulo
A publicação é bloqueada quando há aula pendente ou conflito obrigatório. Essa regra impede que uma grade parcialmente possível seja usada na operação escolar.
Ao publicar:
ativo = true;educador_x_disciplina são sincronizados em transação;Essa sincronização é o ponto que integra o horário ao Diário, Notas e Plano de Aula.
Assim que uma versão possuir aulas, use Exportar PDF na barra superior da grade. A exportação funciona tanto para rascunhos quanto para versões publicadas, o que permite revisar o resultado antes da publicação.
O arquivo é gerado pela API, em A4 horizontal, com uma página por turma. Cada página contém:
Quando a turma tem uma quantidade diferente de aulas em algum dia, células sem período aparecem como Sem período, sem criar aulas artificiais. O PDF usa o logotipo oficial do Horário+ e respeita o logotipo cadastrado em Escola.
sequenceDiagram
participant C as Coordenação
participant HP as Horario Plus
participant S as Solver CP-SAT
participant E as Educara
C->>HP: Publicar versão
HP->>HP: Validar pendências e conflitos
HP->>E: Desativar versões sobrepostas
HP->>E: Ativar versão atual
HP->>E: Sincronizar educador_x_disciplina
E-->>HP: Transação concluída
HP-->>C: Grade publicadaCapítulo
Uma coordenação vai montar a grade da manhã de 2026:
Escola Exemplo, 2026 e Manhã no topo.Ensino Fundamental II e marca Português, Matemática, Ciências, História, Geografia, Arte e Educação Física.Fundamental II · manhã com seis aulas e um intervalo.2026 · Manhã · v1 e gera a grade.Capítulo
HttpOnly, Secure e SameSite=Lax.Capítulo
Valide se as disciplinas globais desejadas têm mostraHorario = true ou se a disciplina exclusiva contém o id_escola correto. Em seguida, confirme que o seed do catálogo foi executado.
Confirme se o educador pertence à escola e tem matrícula em educador_matricula no ano selecionado. Depois ative-o para o horário.
Revise a carga semanal, habilitações docentes, perfil da turma e disponibilidade. Em geral, a causa é carga maior que os slots possíveis ou poucos docentes habilitados para a mesma disciplina.
Abra o diagnóstico da versão. Publicação exige ausência de conflito obrigatório e de aulas pendentes.
Faça login novamente usando a nova senha. A senha anterior deixa de valer após a atualização.
Capítulo
| Termo | Significado |
|---|---|
| Perfil de períodos | Grade de horários de aula e intervalos reutilizável por turma. |
| Carga semanal | Número de aulas de uma disciplina que uma turma deve receber na semana. |
| Habilitação | Permissão de um docente para lecionar determinada disciplina em um turno. |
| Disponibilidade | Exceção que bloqueia um slot para um docente, ou agenda explícita legada. |
| Bloco duplo | Duas aulas consecutivas da mesma disciplina e turma. |
| Máximo diário | Limite obrigatório de aulas da disciplina na turma em um único dia. |
| Docente preferencial | Docente fixado para toda a carga semanal de uma turma-disciplina. |
| Entrada docente–turma | Sequência contínua em que um docente permanece na mesma turma; intervalo, lacuna ou retorno posterior inicia outra entrada. |
| Rascunho | Versão ainda não integrada à operação escolar. |
| Trava | Aula que deve manter sua posição nas próximas gerações. |
| Pendência | Regra ou dado ausente que impede uma grade completa ou a publicação. |