Guia do Usuário: HorárIA
Aprenda a estruturar sua instituição, definir regras acadêmicas avançadas e gerar grades horárias otimizadas em minutos utilizando nosso motor de inteligência artificial.
Visão Geral
O HorárIA é um sistema de gestão e montagem de horários escolares construído para resolver um dos processos mais complexos da coordenação pedagógica: o cruzamento irretocável de restrições de professores, turmas e ambientes.
Diferente de sistemas legados de gestão escolar (ERP) que funcionam apenas como "tabelas cegas", o HorárIA possui um motor de otimização próprio. Ele entende variáveis reais de uma escola (como janelas de disciplinas, professores atuando em múltiplos níveis, limite de aulas diárias) e gera cenários viáveis que reduzem o atrito no corpo docente e otimizam operações.
Reduzir os conflitos diários e o estresse que a montagem manual causa na coordenação, garantindo grades 99% prontas antes do início do ano letivo.
Primeiros Passos (O Fluxo de Setup)
A inteligência do sistema depende fundamentalmente da precisão dos seus cadastros. Para gerar uma grade perfeita, siga estruturalmente a Pirâmide de Setup HorárIA:
- Mapeamento Físico e Estrutural: Cadastrar Segmentos (ex: EM), Turnos (ex: Manhã) e Ambientes de Aula (ex: Lab de Química).
- Oferta Acadêmica: Definir as Disciplinas e as Turmas que receberão estas aulas.
- Corpo Docente: Cadastrar os Professores e convidar a equipe a preencher suas Disponibilidades de horário via Portal do Professor.
- A Matriz (Vínculos): Dizer ao sistema quem ensina o quê e onde. (ex: Bruno Lima dá Física para a 2ª Série B no Lab 01).
- Regras Finas: Restringir janelas, evitar horários vagos ou agrupar turmas.
- Processamento: Rodar o Algoritmo.
Estrutura Base (Entidades do Sistema)
Para navegar no HorárIA de forma fluida, entenda a hierarquia dos dados. Usaremos um exemplo prático do colégio fictício "Aquarela".
Segmento
A divisão macro da sua escola. O sistema isola ou cruza acessos a partir daqui.
Ex: Ensino Fundamental II, Ensino Médio, Cursos Técnicos.
Turno & Horários
Os blocos de tempo onde a operação acotecem. Uma escola pode ter turno Matutino (das 07:10 às 13:00 dividido em tempos de 50min).
Ambientes (Salas)
Espaços físicos com limite de capacidade, fundamentais para evitar conflitos de salas duplamente alocadas.
Ex: Sala 101, Lab de Informática, Quadra Poliesportiva.
Turmas
O agrupamento de alunos de um determinado Ano/Série em um Turno.
Ex: 6º Ano A, 2ª Série EM B, Informática 1M.
Parâmetros do Sistema (Branding)
Antes de iniciar os cadastros base, é essencial configurar a identidade visual e os dados de contato da sua instituição. Estas informações serão replicadas em todos os relatórios, grades impressas e visualizações públicas (como no Portal do Professor).
Define o título da escola e o texto do rodapé/cabeçalho oficial.
Upload da logo em PNG/JPG. O sistema armazena uma cópia única por instituição.
Veja em tempo real como o cabeçalho ficará nos documentos oficiais.
Apenas usuários com perfil **Administrador** têm permissão para visualizar e alterar os parâmetros de branding da instituição.
Cadastro de Segmentos
Os Segmentos representam as divisões macro da sua instituição. Eles são fundamentais para organizar a estrutura acadêmica e isolar ou cruzar o acesso dos coordenadores.
Ensino Fundamental I, Ensino Médio, Cursos Técnicos, Graduação. O sistema isola as regras por segmento para evitar conflitos de horários em níveis diferentes.
A. Gestão e Listagem de Segmentos
Nesta tela, você visualiza todos os segmentos cadastrados, seus códigos de identificação e o status de ativação.
Exibe uma etiqueta (badge) com a sigla do segmento, facilitando a identificação rápida em filtros e relatórios.
Define a prioridade de exibição nos menus e relatórios do sistema. O valor "0" é o padrão inicial.
B. Cadastro e Edição de Segmento
Ao criar um segmento, você define as informações básicas que estruturarão as turmas e disciplinas vinculadas.
- Nome: O nome completo da unidade (ex: Ensino Médio).
- Código: Uma abreviação única (ex: ENS_MEDIO) para uso interno do sistema.
- Segmento ativo: Determina se este segmento aparecerá nas opções de montagem de grade.
C. Segurança e Exclusão de Segmentos
A exclusão de um segmento é uma ação crítica e requer confirmação devido aos seus impactos em cascata.
Ao excluir um registro, o sistema alerta que:
- Turmas e disciplinas vinculadas perderão sua referência institucional.
- Professores que atuam neste segmento terão o vínculo removido automaticamente.
- Agendas e grades geradas para este segmento serão descartadas.
Cadastro de Turnos e Horários
Os Turnos definem os blocos de tempo onde as aulas acontecem. Para cada turno, você define a grade de horários (tempos de aula) e intervalos.
Você pode configurar tempos de aula com durações diferentes (ex: 45min ou 50min) e definir exatamente quando ocorrem os intervalos para lanche ou troca de turno.
Cadastro de Disciplinas
As Disciplinas representam a oferta acadêmica da sua instituição. Elas são a base para a matriz curricular e determinam a carga horária que cada turma deve cumprir.
A quantidade de tempos definida por semana ditará quantos "slots" na grade horária o algoritmo deverá preencher obrigatoriamente para cada turma vinculada.
A. Gestão e Listagem de Disciplinas
A tela central exibe um resumo da carga horária e a quantidade de recursos (professores e ambientes) já vinculados a cada matéria.
Indica o número total de aulas semanais. Se "Matemática" tem 4 tempos, o sistema garantirá 4 aulas distribuídas na semana para as turmas.
Além de editar e excluir, você encontrará ícones específicos:
- Chapéu de Formatura: Gerencia quais professores estão aptos a lecionar esta disciplina.
- Prédio/Sala: Define ambientes preferenciais (ex: Lab para Química).
B. Cadastro e Edição de Dados
Ao cadastrar uma disciplina, a escolha da carga horária semanal é o campo mais crítico para o motor de IA.
- Nome: Nome oficial da matéria (ex: Biologia).
- Código: Abreviação para exibições compactas (ex: BIO, MAT).
- Qtd. tempos/semana: Selecione o peso da disciplina na grade curricular.
C. Vínculo de Ambientes (Salas Específicas)
Algumas disciplinas exigem infraestrutura específica. O sistema permite travar uma disciplina a determinados ambientes.
Ao vincular um ambiente como **Padrão**, o sistema priorizará a alocação de todas as aulas desta disciplina naquela sala, evitando que o professor precise se deslocar desnecessariamente ou que a aula ocorra em local inapropriado.
D. Segurança e Exclusão
Excluir uma disciplina remove todas as suas referências nas grades atuais e futuras.
Vínculos com turmas e associações de professores serão removidos permanentemente. Grades já geradas que contenham esta disciplina poderão apresentar erros de integridade.
Gestão de Turmas
As Turmas são os alvos da geração de horário. Cada turma representa um grupo de alunos que deve cumprir uma grade curricular específica em um determinado turno e segmento.
A. Painel de Controle e Monitoramento
A listagem central oferece indicadores visuais rápidos sobre a completude da grade curricular de cada turma.
- Disciplinas: Mostra quantas matérias já foram vinculadas à turma.
- Aula Vaga Último: Indica se a turma tem aulas vagas no final do turno (crítico para logística).
Através do botão de opções superior, você pode **Importar/Exportar** turmas em lote e imprimir a **Relação Completa** de horários de toda a escola.
B. Cadastro e Dados Estruturais
Ao criar uma turma, a definição do **Turno** é fundamental, pois ditará os horários disponíveis para o algoritmo trabalhar.
C. Matriz Curricular (Vínculo de Disciplinas)
Esta tela define o que será ensinado para esta turma específica. Você seleciona as disciplinas e o sistema herda a carga horária configurada no cadastro base da disciplina.
Importante: A soma dos tempos vinculados deve respeitar a grade horária do turno.
D. Exceções de Tempo (Slots "Sem Aula")
Existem situações onde uma turma **não pode ter aula** em determinados horários (ex: turmas de integral que saem mais cedo na Sexta ou horários religiosos precatados).
Marque apenas os quadradinhos (slots) em que a turma **não terá aula**. A IA garantirá que nenhuma disciplina seja alocada nesses momentos, criando um "tempo vazio" na grade impressa.
Gestão de Ambientes (Salas)
Os Ambientes são os espaços físicos onde as aulas ocorrem. O HorárIA utiliza esses dados para garantir que não haja conflitos de alocação (duas aulas na mesma sala ao mesmo tempo) e para respeitar as preferências de laboratórios e salas especiais.
A. Painel de Gestão e Capacidade
O dashboard de ambientes permite monitorar todos os recursos físicos da instituição, organizados por segmento e status de ativação.
Use o botão **"Imprimir Todos os Horários"** no topo da tela para gerar um arquivo PDF único com as grades de todas as salas, ideal para a sinalização das portas no início do semestre.
B. Cadastro de Novos Espaços
Cadastre salas de aula, laboratórios, quadras e auditórios. Utilize **Códigos** curtos para facilitar a leitura visual nas grades horárias compactas.
C. Sinalização Física (Horário da Sala)
Para manter a organização escolar, o sistema gera uma grade de ocupação exclusiva para cada ambiente, identificando quais turmas e professores ocuparão o espaço em cada tempo.
Nota: A grade por ambiente respeita automaticamente o branding e as logos configuradas nos parâmetros globais.
Segurança e Exclusão
Ao excluir um ambiente que está definido como **"Ambiente Padrão"** em uma disciplina, o sistema removerá essa restrição, o que pode fazer com que a IA aloque aulas dessa matéria em salas inadequadas (ex: aula de laboratório em sala comum).
Gestão de Professores
O Módulo de Professores é o coração do motor de inteligência do HorárIA. Mais do que um simples cadastro, ele define as restrições e possibilidades de alocação que o algoritmo deve respeitar.
A. Painel de Controle e Monitoramento
O dashboard de professores oferece uma visão 360º da saúde de alocação de cada docente, sinalizando rapidamente ausências de vínculos ou folgas configuradas.
- Segmentos: Quantos níveis (ex: Fundamental, Médio) o professor atua.
- Disciplinas: Matérias que ele está apto a lecionar.
- Horários: Contagem de horários preenchidos na agenda de disponibilidade.
Acesse funções de **Importação/Exportação**, impressão de **Horário Completo** e relatórios individuais diretamente pelo menu de contexto (ícone de três pontos).
B. Cadastro e Acessibilidade Mobile
A plataforma é totalmente responsiva, permitindo que coordenadores gerenciem a equipe diretamente de tablets ou smartphones com a mesma riqueza de detalhes.
Dica: Adicione fotos aos perfis para facilitar o reconhecimento visual nas grades de horários e relatórios impressos.
C. Matriz de Atuação (Disciplinas e Segmentos)
Este é o ponto onde você define **quem pode dar o quê e onde**. Sem esses vínculos, o algoritmo de IA não saberá quais professores estão disponíveis para cada turma.
Um professor pode atuar em múltiplos segmentos (ex: Fundamental II e Ensino Médio) simultaneamente.
D. Agenda de Disponibilidade (Grid de IA)
A tela de disponibilidade permite travar os horários em que o professor está apto para trabalhar. Horários marcados como **"Disponível"** (Verde) são os que a IA usará para alocar aulas.
Use os botões **"Marcar todos"** ou os ícones de **Check/X** no topo de cada coluna para configurar dias inteiros com apenas um clique.
E. Relatórios e Transparência
O sistema gera grades individuais de disponibilidade que respeitam o branding institucional configurado nos Parâmetros Globais.
Segurança: Exclusão de Docentes
Ao excluir um professor, todos os seus **vínculos de horários em grades já geradas** serão deletados. Esta ação é irreversível e exigirá uma nova geração de horários para preencher os espaços vazios.
Gestão de Usuários
O Módulo de Gestão de Usuários é o centro de controle de segurança e permissões da plataforma. Ele permite gerenciar quem acessa o sistema, com quais credenciais e quais níveis de permissão cada um possui.
A. Visualização e Listagem Central
O ponto de partida para qualquer gestão. Nesta tela, você tem uma visão panorâmica de todos os colaboradores cadastrados.
Localizado no topo superior direito, abre o formulário para inclusão de um novo colaborador.
Cada registro na tabela possui três botões fundamentais:
- Azul (Lápis): Abre a edição dos dados cadastrais do usuário.
- Ciano (Chave): Gerencia as permissões por segmento (Acesso Coordenador).
- Vermelho (Lixeira): Remove permanentemente o acesso do usuário ao sistema.
B. Cadastro e Edição de Dados
Ao criar ou editar um perfil, informações vitais devem ser preenchidas para garantir o login e o contato institucional.
No final do formulário, existem duas opções críticas:
- Usuário Ativo: Se desmarcado, o usuário será bloqueado e não poderá mais logar.
- Administrador: Caso marcado, este usuário terá poderes totais, podendo gerenciar todos os segmentos e até mesmo outros administradores.
C. Permissões por Segmento (Perfil Coordenador)
Para usuários que não são administradores totais, é necessário definir exatamente quais unidades ou segmentos eles monitoram.
Marque os segmentos (Ensino Médio, Fundamental, etc.) que o coordenador em questão terá acesso ao logar.
O usuário só poderá trabalhar nos horários vinculados a esses segmentos específicos. Administradores totais possuem este controle liberado por padrão para toda a instituição.
Módulo de Vínculos Acadêmicos
Aqui você traduz sua matriz curricular em regras que a IA entenda. Acesse "Vínculos Acadêmicos" para dizer que:
| Turma | Disciplina | Docente | CH Semanal | Ambiente Fixo? |
|---|---|---|---|---|
| 2ª Série EM B | Matemática | Daniel Rocha | 4 aulas | Qualquer Sala |
| Informática 1M | Banco de Dados | Ana Souza | 2 aulas | Lab de Informática 2 |
Motor de Regras e Restrições Avançadas
Esta é a alma do HorárIA. Diferente de montar "post-its" na parede, o gestor insere regras de negócio institucionais que a Inteligência Artificial vai respeitar inegociavelmente ou até onde fisicamente for possível.
Exemplos de Restrições Estratégicas Configuráveis:
O sistema é instruído a empacotar o horário do professor. Se "Bruno Lima" (Física) vai na escola na Quarta, o sistema tenta agrupar todas as suas turmas daquele dia em tempos seguidos. Você pode setar: "Máximo tolerado de 1 janela livre por professor no dia."
Restrição essencial de segurança escolar: a IA não permitirá que uma turma (ex: 6º Ano A) tenha o 1º horário ocupado, o 2º Vago e o 3º ocupado. A grade fecha os "buracos" priorizando a continuidade do discente.
Para Ensino Médio ou Técnico, você pode criar uma restrição de que a 2ª Série A e a 2ª Série B terão aula de Educação Física simultaneamente no mesmo horário, com o mesmo professor, na Quadra Poliesportiva. O motor trava essas turmas juntas no processamento.
Geração Inteligente da Grade (O Algoritmo)
Após definir todos os Vínculos e Restrições, o processo de montagem vira apertar um botão e supervisionar.
- Fixação Manual Prévia (Opcional): Se a diretora exige que todas aulas de Produção Textual sejam na Segunda-feira 1º horário, você usa o modo "Quadro Físico" para cravar esta aula antes de processar. O algoritmo não mexe nela.
- Executar Otimizador: Clique em "Gerar Nova Versão". O HorárIA rodará milhares de permutações combinatórias nos bastidores. A tela pode exibir "Aguarde...". Computadores normais levariam meses tentando testar isso à mão. O HorárIA faz em poucos minutos.
- Diagnóstico de Conflitos: É impossível atender 100% de disponibilidades restritas caso falte carga horária. O sistema alertará se ocorrer um "Unresolvable Conflict" indicando explicitamente o problema (ex: Bruno só pode dar aula sexta, as três turmas que precisam de Bruno na sexta já usam o Lab no mesmo horário). Assim, o gestor toma decisão cirúrgica mudando a regra.
- Publicar para Equipe: Ao finalizar e aprovar o *Score* da grade gerada, clique em publicar. Professores verão imediatamente os horários no celular via portal.
Controle de Acessos e Perfis
O HorárIA B2B é multi-usuário (Tenant). Ele permite que um colégio grande delegue poderes.
- Administrador/Gestor Core: Vê todos os Segmentos. Configura o Turno. Aprova/Publica Grade Geral de toda a unidade.
- Coordenador de Segmento: Só tem acesso às turmas e grades do "Ensino Fundamental I". Ele pode rodar a otimização apenas da vizinhança dele.
- Professor/Docente: Perfil super reduzido. Eles apenas fazem login no seu portal leve para duas coisas: Dizer horários que não podem trabalhar, e visualizar seu Quadro de Aulas aprovado em formato bonito e exportável para PDF.
Gestão de Vínculos Acadêmicos
A Gestão de Vínculos é onde a coordenação define formalmente a carga horária de cada professor para cada turma. É o elo entre o cadastro base e a geração de horários.
Para que uma aula apareça na grade, o professor deve estar vinculado à disciplina e à turma correspondente através deste módulo.
Regras e Restrições
O HorárIA permite configurar regras avançadas para atender a necessidades pedagógicas específicas e otimizar o uso do tempo e dos espaços físicos.
A. Aulas em Conjunto (Sincronização de Grades)
Esta regra é ideal para situações onde turmas diferentes devem ter a mesma disciplina com o mesmo professor exatamente no mesmo horário (ex: turmas de contraturno que compartilham uma palestra ou atividades de Educação Física unificadas).
Ao cadastrar uma aula conjunta, você seleciona o período letivo, o professor/disciplina e a lista de turmas que serão "amarradas" pelo sistema.
Dicas de Uso
- 01. Segure **Ctrl (ou Cmd)** para selecionar múltiplas turmas no formulário de cadastro.
- 02. A IA garantirá que essa aula ocorra simultaneamente para todas as turmas selecionadas, bloqueando o horário do professor para outras atividades.
Removendo Regras de Conjunto
Caso precise desfazer o vínculo de aula compartilhada, utilize o botão de exclusão na listagem principal.
Geração da Grade (Otimizador)
O Motor de Inteligência do HorárIA processa milhares de combinações para encontrar o cenário ideal que respeite as disponibilidades dos professores, as capacidades dos ambientes e as regras pedagógicas das turmas.
A. Métodos de Geração de Cenários
Ao iniciar uma nova grade, você pode escolher entre três abordagens principais, dependendo do nível de automação desejado:
Utiliza o solver interno para buscar uma solução rápida baseada apenas nas restrições básicas de disponibilidade.
Abordagem de alta performance (Google OR-Tools) voltada para grades complexas com muitas restrições conflitantes.
Cria apenas a estrutura de tempos e dias, permitindo que o coordenador monte o horário "do zero" manualmente.
B. Dashboard de Saúde da Grade
Após a geração, o sistema apresenta um resumo da saúde de cada turma. O indicador **"OK"** sinaliza que toda a carga horária foi atendida sem conflitos.
O contador **"8/8 atendidos"** indica que os 8 tempos de aula previstos na matriz curricular daquela turma foram alocados com sucesso na grade semanal.
C. Editor Interativo e Validação em Tempo Real
Ao entrar em uma grade específica, você acessa o editor interativo. Aqui, a coordenação tem controle total sobre cada slot de aula.
Edição por Clique e Troca
Ao clicar em um slot, o sistema exibe o assistente de alocação. Se o professor já estiver em outra turma no mesmo horário, o HorárIA sugerirá automaticamente a **Remoção/Troca** para evitar conflitos.
Ações Rápidas (Individual)
Através do menu de opções da grade, você pode forçar o preenchimento apenas dos slots vazios de uma turma específica usando a IA ou limpar toda a grade para recomeçar o cenário.
O rodapé do editor mostra o **Resumo por Disciplina**. Disciplinas em **Verde (ex: 4/4)** estão totalmente atendidas. Caso exceda ou falte tempos, a barra indicará o alerta visual para correção.
D. Impressão e Documentação Oficial
Após a validação final, a grade pode ser impressa em papel timbrado da instituição, contendo todas as sinalizações acadêmicas necessárias, como as **Aulas em Conjunto**.
Segurança: Exclusão de Períodos
A exclusão de uma grade apaga todos os horários vinculados àquele cenário. Esta ação é drástica e protegida por um modal de confirmação.
Controle de Acesso (Perfis)
O HorárIA utiliza uma estrutura de **Controle de Acesso Baseado em Perfis (RBAC)** para garantir que cada colaborador visualize apenas o que é pertinente à sua função. A segurança dos dados institucionais éPrioridade.
Administrador
Controle total. Gerencia usuários, parâmetros globais da escola, logs de sistema e tem poder de exclusão definitiva sobre qualquer módulo.
Coordenador
Perfil operacional acadêmico. Pode gerenciar turmas, professores, vínculos e gerar as grades horárias. Não possui permissão para alterar configurações globais de sistema.
Professor
Acesso restrito ao **Portal do Professor**. Pode apenas visualizar sua grade aprovada, exportar relatórios pessoais e sinalizar sua disponibilidade de horários.
Sempre que um colaborador for desligado da instituição, **desative sua conta** imediatamente no módulo de Usuários para revogar todos os acessos de API e portal.
Portal do Professor
O Portal do Professor é um ambiente simplificado e intuitivo, focado em dar clareza sobre o quadro de horários e facilitar o processo de montagem da grade na coordenação.
Autonomia na Disponibilidade
O professor sinaliza diretamente no sistema quais dias e turnos está apto a trabalhar. Essa informação alimenta o motor de IA em tempo real, eliminando planilhas manuais e erros de comunicação.
Grade Oficial e Impressão
Após a aprovação da grade pela coordenação, o professor visualiza seu horário completo. Ele tem acesso a um **relatório individualizado** formatado para impressão ou salvamento digital em PDF.
O portal é totalmente responsivo (mobile-friendly), permitindo que o docente consulte suas aulas diretamente do celular na sala dos professores.
Boas Práticas e Performance
Para obter os melhores resultados com o motor de otimização do HorárIA, siga estas diretrizes recomendadas por especialistas em horários escolares.
Respeite a Ordem Lógica
O sistema funciona em cascata. Sempre defina seus **Segmentos** e **Turnos** antes de vincular professores. Sem a base estrutural clara, o algoritmo terá dificuldades em encontrar soluções viáveis.
Equilíbrio de Folgas
Evite que muitos professores do mesmo segmento tenham exatamente a mesma folga no mesmo dia. Se 70% da equipe de Matemática folgar na terça-feira, o algoritmo não conseguirá preencher as aulas desse dia.
Ambientes como Restrição
Use o recurso de **Ambiente Padrão** das disciplinas com sabedoria. Isso garante que a IA nunca aloque uma aula técnica em uma sala inadequada, economizando tempo de troca entre tempos.
Iterações de Cenários
Gere múltiplas grades e salve-as em períodos diferentes para comparação. O otimizador de IA pode encontrar caminhos distintos em cada tentativa, permitindo que você escolha o mais confortável pedagogicamente.