OlumaOluma — Ajuda
Padrões comuns

Formulários e painéis

Como o Oluma organiza criação e edição de registros: painéis inferiores, janelas, tipos de campo e validação.

Quase toda criação ou edição de registro no Oluma acontece dentro de um painel que abre por cima da página atual. Isso evita que você perca o contexto da lista que estava vendo.

Painel inferior

A maioria dos formulários — novo agendamento, novo cliente, transação financeira, edição de membro da equipe — abre como painel inferior.

No computador, o painel aparece centralizado, com o conteúdo da página por trás escurecido.

No celular, o painel sobe a partir da base da tela, ocupando até 85% da altura. Você pode arrastar para baixo pela borda superior para fechar.

Painel inferior aberto com título no topo, formulário no meio e botões Cancelar e Salvar fixos no rodapé

A estrutura do painel é sempre a mesma:

  • Cabeçalho — título da ação (ex: "Novo cliente", "Editar membro").
  • Botão fechar (X) — no canto superior direito.
  • Conteúdo — o formulário em si, com rolagem se passar da altura disponível.
  • Rodapé — botões de ação. Normalmente Cancelar (à esquerda ou no meio) e Salvar (à direita).

Para fechar sem salvar:

  • Clique em Cancelar.
  • Clique no X no canto.
  • Clique fora do painel (na área escurecida).
  • Pressione Esc.

Fechar o painel descarta o que você digitou. Se já preencheu muita coisa, prefira Salvar antes de sair.

Janelas de confirmação

Para ações que mudam o sistema de forma significativa (cancelar, excluir, marcar como pago), o Oluma abre uma janela de confirmação menor, com a pergunta e dois botões.

Use sempre que precisar tem certeza do que está fazendo — o sistema não age sem o segundo clique.

Confirmar uma exclusão geralmente não tem volta. Em quase todos os módulos, prefira desativar a excluir.

Campos do formulário

Os principais tipos de campo:

  • Texto — para nome, observações, e-mail. Aceita digitação livre.
  • Número — para quantidades, valores, durações em minutos.
  • Data e hora — abrem um seletor próprio quando você clica.
  • Selecione com busca — escolher cliente, serviço, profissional, conta. Veja Filtros e busca.
  • Chave liga/desliga — usada para opções como "Ativo", "Permitir conflito", "Atende clientes".
  • Grupo de pílulas — escolha entre poucas opções fixas (ex: Dia, Semana ou Mês na visualização da agenda).
  • Caixas com máscara — campos como CPF e telefone formatam automaticamente enquanto você digita.

Campos obrigatórios

Campos obrigatórios são marcados com um asterisco (*) ao lado do nome. Tentar salvar sem preencher mostra uma mensagem de erro e foca o campo em falta.

Validação ao salvar

Se algum campo estiver inválido (data anterior à atual quando isso é proibido, e-mail mal formatado, número fora do limite), você vê uma mensagem em vermelho na parte superior do painel ou abaixo do campo, e o foco vai para a primeira ocorrência.

Notificações de sucesso e erro

Depois de salvar, o sistema mostra uma notificação rápida no canto da tela:

  • Verde — operação concluída ("Cliente cadastrado com sucesso", "Configurações salvas").
  • Vermelho — falha ou erro de validação.

A notificação some sozinha após alguns segundos. Você pode fechá-la antes clicando no X.

Perguntas frequentes

  • O painel travou no carregamento. Pode ter sido perda de conexão. Feche, recarregue a página e tente de novo. O Oluma só salva quando o servidor confirma — se você não viu a notificação verde, nada foi gravado.
  • Posso minimizar um painel para consultar outra coisa? Não, painéis sempre ocupam o foco. Se precisar consultar outra tela, salve, faça a consulta e abra o formulário de novo.
  • Tem atalhos de teclado? Esc fecha o painel. Em campos de texto longos, Tab avança para o próximo campo e Shift+Tab volta.

Nesta página