Receitas e Despesas - Grupos de Receitas

Descrição da Interface

A interface apresentada é parte de um sistema de gerenciamento de frota, especificamente dedicada ao cadastro e gerenciamento de Grupos de Receitas de veículos. Esta interface é composta por duas telas principais:

Tela de Pesquisa/Listagem: Permite filtrar, pesquisar e visualizar os grupos de receitas existentes no sistema.
Tela de Edição/Cadastro: Permite criar novos grupos de receitas ou modificar grupos existentes.

O sistema possui um design limpo e funcional com elementos visuais intuitivos como botões coloridos, tabela de dados com cabeçalhos em destaque, e formulários organizados com campos bem identificados.

Elementos das Telas

Tela de Pesquisa/Listagem "Grupos de Receitas"

Seção de Filtros

Filtro de Código: Campo de texto para buscar pelo código do grupo de receita
Filtro de Nome: Campo de texto para buscar pelo nome do grupo de receita
Botões de Ação:
- Pesquisa (ícone de lupa): Aplica os filtros informados
- Limpar Filtros (ícone de arquivo): Limpa os valores digitados nos filtros
- Novo (ícone de adição): Redireciona para a tela de cadastro de novo grupo
- Exportar para CSV (ícone de salvar): Exporta a lista apresentada para um arquivo CSV

Tabela de Listagem

Colunas:
- #: Número sequencial da linha na tabela
- CÓDIGO: Código do grupo de receita
- NOME: Nome descritivo do grupo de receita
Funcionalidade: Ao clicar em uma linha, o sistema redireciona para a tela de edição do registro selecionado

Rodapé

Contador de Registros: Mostra o número total de registros listados (ex: "REGISTROS: 4")

Tela de Edição/Cadastro "Grupo Receita"

Área de Mensagens de Erro

Alerta de Validação: Exibe mensagens de erro quando há problemas nos campos preenchidos
Botão de Fechar: Permite fechar a mensagem de erro

Formulário

Campo Código: Campo obrigatório para informar o código do grupo de receita
Campo Nome: Campo obrigatório para informar o nome descritivo do grupo de receita

Botões de Ação

Gravar: Salva o registro com as informações preenchidas
Excluir: Remove o registro atual (visível apenas em modo de edição)
Voltar: Retorna para a tela de listagem sem salvar alterações

Propósito e Fluxo de Trabalho

O propósito desta interface é permitir o gerenciamento completo de grupos de receitas de veículos, que são utilizados para categorizar as receitas obtidas na operação da frota.

Fluxo de Trabalho Típico:

O usuário acessa a tela de listagem para visualizar os grupos de receitas existentes
O usuário pode filtrar a lista usando os campos de código e nome
Para criar um novo grupo, o usuário clica no botão "Novo"
Para editar um grupo existente, o usuário clica na linha correspondente na tabela
Na tela de edição/cadastro, o usuário preenche os campos obrigatórios (código e nome)
O usuário salva as alterações clicando no botão "Gravar"
Se necessário, o usuário pode excluir um grupo existente usando o botão "Excluir"

Instruções Passo a Passo

Como Pesquisar Grupos de Receitas

Acesse a tela "Grupos de Receitas"
Digite o código e/ou nome no campo de filtro correspondente
Clique no botão de pesquisa (ícone de lupa)
Os resultados serão exibidos na tabela abaixo
Para limpar os filtros, clique no botão com ícone de arquivo

Como Criar um Novo Grupo de Receitas

Acesse a tela "Grupos de Receitas"
Clique no botão "Novo" (ícone de adição)
Preencha o campo "Código" com o identificador desejado
Preencha o campo "Nome" com a descrição do grupo
Clique no botão "Gravar"
Se todos os campos obrigatórios estiverem preenchidos, o sistema retornará à tela de listagem

Como Editar um Grupo de Receitas

Acesse a tela "Grupos de Receitas"
Localize o grupo desejado na tabela (use os filtros se necessário)
Clique na linha correspondente ao grupo que deseja editar
Modifique os campos "Código" e/ou "Nome" conforme necessário
Clique no botão "Gravar"

Como Excluir um Grupo de Receitas

Acesse a tela "Grupos de Receitas"
Localize o grupo desejado na tabela (use os filtros se necessário)
Clique na linha correspondente ao grupo que deseja excluir
Na tela de edição, clique no botão "Excluir"
O sistema retornará à tela de listagem se a exclusão for bem-sucedida

Como Exportar Dados para CSV

Acesse a tela "Grupos de Receitas"
Aplique os filtros desejados (opcional)
Clique no botão "Exportar para CSV" (ícone de salvar)
O sistema gerará um arquivo CSV com os dados exibidos na tabela

Regras de Negócio e Validações

Validações de Formulário

O campo "Código" é obrigatório
O campo "Nome" é obrigatório
A validação ocorre ao clicar no botão "Gravar"
Se houver erros, eles serão exibidos na área de mensagens no topo da tela

Permissões de Acesso

As operações de gravar e excluir estão sujeitas a permissões de usuário
Existem três níveis de acesso:
- Acesso Master: Tem permissão total para todas as operações
- Acesso de Grupo com capacidade Master: Pode realizar todas as operações
- Acesso de Grupo sem capacidade Master: Depende da permissão específica "grupoPodeSeAlterar"
- Acesso Individual: Regras específicas se aplicam

Regras de Exclusão

Não é possível excluir um grupo de receita que possua receitas vinculadas
O sistema verifica a quantidade de receitas vinculadas antes de permitir a exclusão
Mensagens de erro específicas são exibidas para 1 ou mais receitas vinculadas

Perguntas Frequentes

Gerais

Como posso encontrar um grupo de receita específico?
- Utilize os campos de filtro na tela de listagem para buscar pelo código ou nome do grupo.
Por que não consigo excluir um grupo de receita?
- Os grupos de receita que possuem receitas vinculadas não podem ser excluídos. É necessário primeiro desvincular ou excluir todas as receitas associadas.
Quem pode criar ou modificar grupos de receita?
- Usuários com acesso Master ou com permissão específica podem criar ou modificar grupos. Verifique com o administrador do sistema se você precisa de acesso.
O que acontece se eu tentar cadastrar um grupo com código já existente?
- O sistema não permitirá o cadastro e exibirá uma mensagem de erro informando que o código já está em uso.
Como sei quantos grupos de receita estão cadastrados?
- O contador no rodapé da tabela de listagem exibe o número total de registros encontrados.

Técnicas

Como obter um relatório completo dos grupos de receita?
- Utilize a funcionalidade "Exportar para CSV" para gerar um arquivo que pode ser aberto em ferramentas como Excel.
O que significa o campo "Código" de um grupo de receita?
- O código é um identificador único para o grupo, usado em relatórios e para vinculação com receitas.
É possível alterar o código de um grupo já existente?
- Sim, é possível alterar o código de um grupo existente, mas deve-se ter cuidado pois isso pode afetar relatórios e vinculações.
Existe um limite de caracteres para o nome do grupo?
- O campo nome não possui um limite explícito na interface, mas recomenda-se usar nomes concisos e descritivos.
Como saber se um grupo de receita está sendo utilizado?
- O sistema impede a exclusão de grupos com receitas vinculadas e informa a quantidade de vínculos existentes.

Detalhes Adicionais de Funcionamento

O sistema utiliza uma arquitetura cliente-servidor, onde a interface web comunica-se com serviços backend. Os grupos de receita são fundamentais para a organização financeira da frota, permitindo categorizações como "viagens", "gastos básicos" e outras categorias personalizadas.

O processo de validação ocorre tanto no cliente (verificação de campos obrigatórios) quanto no servidor (verificação de duplicidades e integridade referencial). Todas as ações são registradas em log para auditoria e recuperação em caso de erros.

A funcionalidade de exportação para CSV permite aos usuários realizar análises avançadas dos dados em ferramentas externas, facilitando a geração de relatórios e dashboards personalizados.

Para operações em lote ou integrações com outros sistemas, recomenda-se utilizar a API correspondente, que não está disponível através desta interface visual.