Tipos de Receita

Tipos de Receita de Veículos

Descrição da Interface

O sistema apresenta uma interface para gerenciamento de tipos de receita relacionados a veículos. A interface é composta por duas telas principais: uma para listagem e filtro de tipos de receita, e outra para adição e edição desses registros.

A primeira tela mostra uma tabela com os tipos de receita cadastrados, incluindo informações como tipo, status e se é um tipo padrão. Acima da tabela, há uma seção de filtros que permite buscar por tipos específicos e filtrar apenas os registros ativos.

A segunda tela é um formulário de edição/criação que permite adicionar novos tipos de receita ou modificar os existentes, contendo campos para o nome do tipo e seu status (ativo/inativo).

O sistema segue um padrão visual consistente, com um menu lateral à esquerda e o conteúdo principal ocupando a maior parte da tela. A interface utiliza um esquema de cores profissional com destaque para ações principais.

Elementos da Interface

Tela de Listagem (Tipos de Receitas)

Cabeçalho:

• Título: "Tipos de Receitas"

Seção de Filtros:

• Campo de texto "Tipo": permite filtrar por nome do tipo de receita
• Checkbox "Somente Ativos": quando marcado, exibe apenas os tipos de receita ativos
• Botões de ação:
  • Pesquisa (ícone de lupa): executa a pesquisa com os filtros aplicados
  • Limpar Filtros (ícone de documento): limpa todos os filtros aplicados
  • Novo (ícone de adição): cria um novo registro
  • Exportar para CSV (ícone de salvar): exporta os dados da tabela para um arquivo CSV

Tabela de Tipos de Receita:

• Colunas:

  • (número sequencial)

  • TIPO (nome do tipo de receita)
  • STATUS (ATIVO/INATIVO)
  • PADRÃO (SIM/-)
• Contador de registros: exibe o total de registros encontrados

Tela de Edição (Tipo de Receita)

Cabeçalho:

• Título: "Tipo de Receita"

Seção de Alerta de Erro:

• Exibe mensagens de erro quando há problemas de validação

Formulário:

• Campo de texto "Tipo": nome do tipo de receita (obrigatório)
• Checkbox "ativo": define se o tipo de receita está ativo
• Botões de ação:
  • Gravar: salva as alterações
  • Excluir: remove o registro (visível apenas quando editando um registro existente que não seja padrão)
  • Voltar: retorna à tela de listagem

Propósito e Fluxo de Trabalho

O propósito desta interface é gerenciar os tipos de receita relacionados a veículos em um sistema de gestão de frota. Estes tipos categorizam as diferentes fontes de receita que podem ser geradas pelos veículos da frota.

Fluxo de Trabalho Principal:

1. Listagem e Consulta:

   • O usuário acessa a tela de listagem para visualizar todos os tipos de receita cadastrados
   • Pode aplicar filtros para encontrar registros específicos
   • Visualiza informações como tipo, status e se é um registro padrão

2. Criação de Novo Tipo de Receita:

   • O usuário clica no botão "Novo"
   • Preenche o campo "Tipo" (obrigatório)
   • Define se o tipo será ativo ou não
   • Clica em "Gravar" para salvar

3. Edição de Tipo de Receita Existente:

   • O usuário seleciona um registro na tabela
   • Modifica os campos desejados
   • Clica em "Gravar" para salvar as alterações

4. Exclusão de Tipo de Receita:

   • O usuário seleciona um registro na tabela
   • Clica em "Excluir" (disponível apenas para registros não padrão)
   • Confirma a exclusão

5. Exportação de Dados:

   • O usuário aplica os filtros desejados
   • Clica no botão "Exportar para CSV"
   • O sistema gera um arquivo CSV com os dados filtrados

Instruções Passo a Passo

Como Consultar Tipos de Receita

1. Acesse a tela "Tipos de Receitas"
2. Na seção de filtros, você pode:
   • Preencher o campo "Tipo" para buscar por um nome específico
   • Marcar ou desmarcar "Somente Ativos" para filtrar por status
3. Clique no botão de pesquisa (ícone de lupa)
4. A tabela será atualizada com os resultados da pesquisa
5. Para limpar os filtros, clique no botão "Limpar Filtros" (ícone de documento)

Como Criar um Novo Tipo de Receita

1. Na tela de listagem, clique no botão "Novo" (ícone de adição)
2. Você será direcionado para a tela de edição
3. Preencha o campo "Tipo" com o nome do novo tipo de receita
4. Marque o checkbox "ativo" se desejar que o tipo esteja ativo
5. Clique no botão "Gravar"
6. Se não houver erros, você será redirecionado para a tela de listagem

Como Editar um Tipo de Receita Existente

1. Na tela de listagem, clique na linha do registro que deseja editar
2. Você será direcionado para a tela de edição com os dados preenchidos
3. Altere os campos desejados
4. Clique no botão "Gravar"
5. Se não houver erros, você será redirecionado para a tela de listagem

Como Excluir um Tipo de Receita

1. Na tela de listagem, clique na linha do registro que deseja excluir
2. Na tela de edição, verifique se o botão "Excluir" está disponível
   • Nota: Tipos de receita padrão não podem ser excluídos
3. Clique no botão "Excluir"
4. Se a exclusão for bem-sucedida, você será redirecionado para a tela de listagem

Como Exportar Dados para CSV

1. Na tela de listagem, aplique os filtros desejados
2. Clique no botão "Exportar para CSV" (ícone de salvar)
3. O arquivo será gerado e baixado automaticamente

Regras de Negócio

Com base na análise do código fornecido, as seguintes regras de negócio foram identificadas:

1. Campos Obrigatórios:

   • O campo "Tipo" é obrigatório para criar ou editar um tipo de receita

2. Tipos de Receita Padrão:

   • Existem tipos de receita marcados como "padrão" no sistema
   • Tipos de receita padrão não podem ser alterados
   • Tipos de receita padrão não podem ser excluídos
   • O sistema verifica e cria automaticamente tipos padrão quando necessário

3. Permissões de Acesso:

   • As operações de gravação e exclusão estão sujeitas a verificações de permissão
   • Existem três níveis de acesso:
     • Acesso Master: permissão total
     • Acesso de Grupo: depende das permissões configuradas para o grupo
     • Acesso Individual: restrições específicas por usuário

4. Validações:

   • O sistema valida se o campo "Tipo" foi preenchido antes de gravar
   • Exibe mensagens de erro quando a validação falha

5. Filtros:

   • É possível filtrar por nome do tipo
   • É possível filtrar por status (ativo/inativo)

Perguntas Frequentes

Por que não consigo excluir certos tipos de receita?

Os tipos de receita marcados como "padrão" não podem ser excluídos. Estes são tipos essenciais para o funcionamento do sistema. Eles são identificados pela coluna "PADRÃO" com valor "SIM" na tabela de listagem.

Por que não consigo editar certos tipos de receita?

Assim como na exclusão, os tipos de receita padrão não podem ser alterados. Qualquer tentativa de salvar alterações em um tipo padrão resultará em um erro.

Como faço para ver apenas os tipos de receita ativos?

Na tela de listagem, marque o checkbox "Somente Ativos" na seção de filtros e clique no botão de pesquisa.

O que significa o valor "SIM" na coluna PADRÃO?

Indica que o tipo de receita é um tipo padrão do sistema, criado automaticamente e protegido contra alterações e exclusões.

Como posso exportar apenas determinados tipos de receita para CSV?

Aplique os filtros desejados na tela de listagem para exibir apenas os registros de interesse e então clique no botão "Exportar para CSV".

Quem pode criar novos tipos de receita?

Usuários com permissão de gravação podem criar novos tipos. Isso inclui usuários com acesso Master e usuários de grupos com permissão de alteração.

É possível reativar um tipo de receita inativo?

Sim. Selecione o tipo de receita na listagem, e na tela de edição, marque o checkbox "ativo" e clique em "Gravar".

O que acontece se eu tentar criar um tipo de receita sem nome?

O sistema exibirá uma mensagem de erro indicando que o campo é obrigatório e não permitirá o salvamento até que seja preenchido.