Pular para o conteúdo principal

Como as telas funcionam

Quase todas as telas de cadastro do Codout.School seguem o mesmo padrão: uma listagem em tabela, um botão para criar, ícones para editar e excluir em cada linha, e uma janela (ou página) de formulário. Esta página explica esse padrão uma única vez — as demais seções do manual referem-se a ela em vez de repetir os detalhes.

A listagem (tabela de registros)​

Ao abrir uma tela de cadastro (por exemplo, Usuários do Sistema ou Unidades Escolares), você vê uma tabela com os registros. Ela oferece, de forma padronizada:

Pesquisa​

O botão Pesquisa na barra da tabela abre um campo de busca. A busca é do tipo "contém": digitar parte do nome, e-mail ou telefone já encontra o registro. Cada tela define em quais colunas a busca procura (em geral, as colunas de texto visíveis).

Ordenação​

Clique no título de uma coluna para ordenar por ela; clique de novo para inverter a ordem. A maioria das listas já vem ordenada por nome.

Filtros por coluna​

O ícone de filtro no cabeçalho de cada coluna permite filtrar por condições (igual a, contém, começa com, etc.). Filtros de colunas diferentes se somam.

Paginação​

As listas mostram 50 registros por página por padrão; no rodapé da tabela você pode trocar para 100 ou 200 e navegar entre as páginas. O botão de atualizar (seta circular) recarrega os dados sem sair da tela.

Exportar para Excel​

O botão Excel gera uma planilha com todos os registros (todas as páginas), respeitando os filtros aplicados. Colunas de foto e de ação não entram na planilha.

Colunas e telas menores​

As colunas podem ser redimensionadas arrastando a divisória do cabeçalho. Em telas estreitas (celular/tablet), colunas menos importantes são ocultadas automaticamente para manter a leitura confortável.

Ícones de situação​

Algumas colunas usam ícones e etiquetas em vez de texto:

  • marca verde = ativo/habilitado; ícone de bloqueio vermelho = desabilitado;
  • etiquetas Habilitado/Desabilitado ou Ativo/Inativo;
  • foto do cadastro (quando não há foto, aparece um avatar genérico).

Criar, editar e excluir​

Criar​

O botão NOVO fica no canto superior direito da tela. Ele abre a janela "Novo [nome do cadastro]" com o formulário em branco.

Editar​

O ícone de lápis na coluna "Ação" de cada linha abre a janela "Editar [nome do cadastro]" com os dados preenchidos.

Excluir​

O ícone de X na coluna "Ação" exclui o registro — sempre com confirmação:

Confirma a exclusão? Essa ação não poderá ser revertida!

Escolha Sim para confirmar ou Não para desistir. Ao concluir, aparece "Seu registro foi excluido." e a lista é atualizada.

:::info Regra do sistema Quando um registro não pode ser excluído (por exemplo, porque outros cadastros dependem dele), o sistema mostra a mensagem explicando o motivo em vez de excluir. Se aparecer apenas "Ocorreu uma falha na sua requisição, tente mais tarde.", tente novamente e, se persistir, acione o suporte. :::

:::info Regra do sistema Os botões NOVO, lápis e X só funcionam para quem tem as permissões Criar, Editar e Excluir daquela tela, respectivamente. Ver a listagem exige a permissão Consultar. As permissões são concedidas por perfil em Usuários e permissões. :::

O formulário (janela ou página)​

A maioria dos formulários abre em uma janela sobre a listagem (modal), com os botões Fechar e Salvar. Ao salvar, o botão mostra "Aguarde..." enquanto o sistema processa. Cadastros maiores (como Unidades Escolares) abrem em página própria, com Voltar e Salvar no topo — nesses casos, segurar Ctrl ao clicar em NOVO ou no lápis abre o formulário em uma nova aba do navegador.

Comportamentos padronizados:

  • Campos obrigatórios são marcados com asterisco. Ao salvar com um campo vazio, a mensagem aparece junto ao campo (por exemplo, "Nome e obrigatório").
  • Validações acontecem ao salvar e, em alguns campos, na hora (por exemplo, e-mail duplicado). O formulário permanece aberto até tudo estar válido.
  • Máscaras: telefones, CPF/CNPJ, CEP e datas são formatados automaticamente enquanto você digita.
  • Campos de busca (listas com muitas opções, como funcionário ou unidade): clique e digite para pesquisar — a lista filtra conforme a digitação.
  • Envio de imagens e arquivos: arraste e solte o arquivo na área indicada ("Arraste e solte os arquivos ou Clique aqui") ou clique para escolher. Imagens podem ser recortadas/ajustadas antes do envio; formatos aceitos e tamanhos mínimos são validados na hora (mensagens como "Imagem muito pequena" ou "Tipo de arquivo inválido").

Avisos e mensagens​

  • Avisos de sucesso aparecem como notificações passageiras no canto da tela (por exemplo, "Cadastro salvo com sucesso!", "Cadastro atualizado com sucesso!", "Configurações salvas com sucesso!"). Elas somem sozinhas.
  • Erros de comunicação aparecem em uma caixa de diálogo "Ooops!" com a mensagem "Ocorreu uma falha na sua requisição, tente novamente mais tarde." — em geral basta repetir a ação; se persistir, verifique sua conexão ou acione o suporte.
  • Avisos importantes do dia aparecem no cartão "Notificações Importantes" do painel executivo (veja Navegação). TODO: VALIDATE — não há sino de notificações na barra superior nesta versão do sistema.

Acesso negado​

Se você tentar abrir uma tela sem permissão, o sistema bloqueia o acesso (a tela não abre ou uma página de acesso negado é exibida). Como os menus já escondem o que você não pode usar, isso normalmente só acontece ao usar um endereço direto ou um link antigo. A solução é pedir a permissão ao administrador — cite o nome da tela (por exemplo, "Usuários do Sistema — Consultar").