Skip to main content

Controle de Estoque - Categoria de Peças/Produtos

Visão Geral

O módulo de Categorias de Produtos faz parte do sistema de Controle de Estoque da plataforma de gerenciamento de frota. Este módulo permite aos usuários organizar seus produtos em categorias lógicas, facilitando a navegação, busca e gerenciamento do inventário.

Interface do Usuário

Tela de Pesquisa (Lista de Categorias)

A tela principal apresenta um layout organizado em duas seções principais:

  1. Seção de Filtros: Localizada na parte superior, permite refinar a busca de categorias.
  2. Tabela de Resultados: Exibe as categorias encontradas com suas informações principais.

Elementos da Tela de Pesquisa

  • Título da Página: "Categorias de Peças"
  • Seção de Filtros:
    • Campo de texto "Nome": Permite filtrar categorias pelo nome
    • Campo de texto "Descrição": Permite filtrar categorias pela descrição
    • Botões de ação:
      • Botão "Pesquisa" (ícone de lupa): Executa a busca com os filtros aplicados
      • Botão "Limpar Filtros" (ícone de arquivo): Remove todos os filtros aplicados
      • Botão "Novo" (ícone de mais): Direciona para a tela de cadastro de nova categoria
      • Botão "Exportar para CSV" (ícone de salvar): Exporta a lista para um arquivo CSV
  • Tabela de Resultados:
    • Colunas: "#" (número sequencial), "NOME", "DESCRIÇÃO"
    • Linhas: Cada categoria é exibida em uma linha com seus respectivos dados
    • Rodapé: Mostra o número total de registros encontrados

Tela de Edição/Cadastro

A tela de edição/cadastro permite criar novas categorias ou modificar categorias existentes.

Elementos da Tela de Edição/Cadastro

  • Título da Página: "Categoria de Peças"
  • Área de Mensagens de Erro: Exibe erros de validação quando ocorrem
  • Formulário de Cadastro:
    • Campo de texto "Nome": Nome da categoria (obrigatório)
    • Campo de texto "Descrição": Descrição detalhada da categoria (opcional)
  • Botões de Ação:
    • Botão "Gravar": Salva as alterações
    • Botão "Excluir": Remove a categoria (visível apenas para registros existentes)
    • Botão "Voltar": Retorna à tela de pesquisa sem salvar alterações

Funcionalidades e Regras de Negócio

Pesquisa de Categorias

  • A pesquisa pode ser realizada por nome e/ou descrição
  • Os resultados são exibidos em formato de tabela
  • A pesquisa distingue entre resultados únicos e múltiplos
  • É possível exportar os resultados para um arquivo CSV

Cadastro de Categorias

  • O campo Nome é obrigatório
  • O campo Descrição é opcional
  • Cada categoria possui um ID único gerado pelo sistema
  • Categorias existentes podem ser editadas através da mesma interface

Exclusão de Categorias

  • Só é possível excluir categorias que não possuem produtos associados
  • O sistema verifica se existem produtos associados antes de permitir a exclusão
  • Mensagens específicas são exibidas dependendo da quantidade de produtos associados:
    • "Não é possível remover a categoria. Existem X produtos associados." (para múltiplos produtos)
    • "Não é possível remover a categoria. Existe 1 produto associado." (para um único produto)

Controle de Acesso

  • As ações de gravação e exclusão dependem do nível de permissão do usuário
  • Existem três níveis de acesso: Acesso Master, Acesso de Grupo e Acesso Individual
  • Apenas usuários com permissão apropriada podem criar, editar ou excluir categorias

Fluxo de Trabalho

Pesquisar Categorias

  1. Acesse a tela de listagem de categorias
  2. Opcional: Preencha os campos de filtro por nome e/ou descrição
  3. Clique no botão de pesquisa (ícone de lupa)
  4. Os resultados serão exibidos na tabela abaixo
  5. Para limpar os filtros, clique no botão "Limpar Filtros"

Criar Nova Categoria

  1. Na tela de listagem, clique no botão "Novo" (ícone de mais)
  2. Preencha o campo "Nome" (obrigatório)
  3. Opcional: Preencha o campo "Descrição"
  4. Clique no botão "Gravar"
  5. Se todos os campos obrigatórios estiverem preenchidos, a categoria será criada e você retornará à tela de listagem
  6. Se houver erros de validação, eles serão exibidos no topo da tela

Editar Categoria Existente

  1. Na tela de listagem, clique na linha da categoria que deseja editar
  2. A tela de edição será aberta com os dados da categoria selecionada
  3. Modifique os campos desejados
  4. Clique no botão "Gravar"
  5. Se todos os campos obrigatórios estiverem preenchidos, as alterações serão salvas e você retornará à tela de listagem

Excluir Categoria

  1. Na tela de listagem, clique na linha da categoria que deseja excluir
  2. Na tela de edição, clique no botão "Excluir"
  3. O sistema verificará se existem produtos associados a esta categoria
  4. Se não houver produtos associados, a categoria será excluída e você retornará à tela de listagem
  5. Se houver produtos associados, uma mensagem de erro será exibida informando a impossibilidade de exclusão

Exportar para CSV

  1. Na tela de listagem, aplique os filtros desejados (opcional)
  2. Clique no botão "Exportar para CSV" (ícone de salvar)
  3. O sistema gerará um arquivo CSV com os dados exibidos na tabela
  4. O arquivo será baixado automaticamente com o nome "CategoriaProduto.csv"

Detalhes Técnicos (Invisíveis para o Usuário)

A interface se comunica com o backend através de endpoints REST específicos que executam operações CRUD (Create, Read, Update, Delete) nas categorias de produtos. Os dados são transmitidos usando o formato URL-encoded e as respostas são processadas em formato JSON.

As operações são autenticadas e verificadas contra as permissões do usuário atual, utilizando o ID do cliente e da empresa armazenados no estado da aplicação.

Perguntas Frequentes

1. Por que não consigo excluir uma categoria?

As categorias que possuem produtos associados não podem ser excluídas. Você precisa primeiro remover ou reclassificar todos os produtos associados a essa categoria antes de poder excluí-la.

2. Como sei quantos produtos estão associados a uma categoria?

Ao tentar excluir uma categoria com produtos associados, o sistema exibirá uma mensagem informando a quantidade de produtos vinculados.

3. É possível mover produtos de uma categoria para outra?

Sim, isso é possível através do módulo de gerenciamento de produtos. Selecione o produto desejado, edite suas informações e altere a categoria associada.

4. Quais filtros posso usar para encontrar uma categoria específica?

Você pode filtrar as categorias pelo nome e/ou pela descrição. Basta preencher os campos correspondentes na seção de filtros e clicar no botão de pesquisa.

5. Quem pode criar novas categorias no sistema?

Apenas usuários com permissões de gravação ou capacidade Master podem criar, editar ou excluir categorias. Se você não tem acesso a essas funcionalidades, entre em contato com o administrador do sistema.

6. Por que vejo o botão "Excluir" cinza (desabilitado)?

O botão "Excluir" só fica ativo para categorias já existentes (que possuem um ID) e quando o usuário tem permissões adequadas. Se você está criando uma nova categoria, este botão não estará disponível.

7. Como exportar apenas algumas categorias para CSV?

Utilize os filtros disponíveis para restringir a lista de categorias apenas àquelas que deseja exportar. Em seguida, clique no botão "Exportar para CSV". Apenas as categorias exibidas na tabela serão incluídas no arquivo exportado.

Back to top