Controle de Estoque - Peças em Veículos

Descrição da Interface

O modulo apresenta uma interface para gerenciamento de peças e produtos em veículos da frota e faz parte do sistema de gerenciamento de frota da plataforma CONCEPT RASTREAMENTO. A interface segue um padrão visual consistente com cores predominantemente azuis e brancas, com um menu lateral escuro à esquerda. A solução permite gerenciar o estoque de peças distribuídas entre os diferentes veículos da frota, facilitando o controle logístico dos recursos. Para acessar a opção utilize o menu FROTAS e a seção CONTROLE DE ESTOQUE e  opção PEÇAS EM VEÍCULOS.

Elementos da Interface

Tela de Pesquisa (Peças por Veículos)

Seção de Filtros

• Título: "Filtros" (colapsável)
• Campo de Entrada: "Placa do Veículo" - campo de texto para inserir a placa do veículo a ser pesquisado
• Botões de Ação:
  • Botão de Pesquisa (ícone de lupa) - executa a pesquisa com os filtros informados
  • Botão Limpar Filtros (ícone de arquivo) - limpa todos os filtros aplicados
  • Botão Exportar para CSV (ícone de salvar) - exporta os dados da tabela para um arquivo CSV

Tabela de Resultados

• Colunas:
  • # (numeração sequencial)
  • VEÍCULO (exibe a placa ou identificação do veículo)
• Funcionalidades da Tabela:
  • Seleção de linha única
  • Redimensionamento de colunas
  • Ordenação por colunas
  • Animação de linhas
• Rodapé: Contador de registros exibindo a quantidade total

Tela de Detalhes (Peças por Veículo)

Seção de Identificação

• Campo: "Nome" - campo de texto somente leitura que exibe a placa do veículo selecionado
• Botão: "Voltar" - retorna para a tela de pesquisa

Tabela de Peças do Veículo

• Colunas:
  • PEÇA (nome do produto/peça)
  • QTD (quantidade disponível no veículo)
• Funcionalidades:
  • Visualização de todas as peças associadas ao veículo
  • Exibição da quantidade em estoque de cada peça

Propósito e Fluxo de Trabalho

O propósito desta interface é permitir o gerenciamento e consulta do estoque de peças distribuídas entre os veículos da frota. Este módulo é parte de um sistema maior de controle de frota e estoques.

Fluxo Principal:

1. O usuário acessa a tela de pesquisa "Peças por Veículos"
2. Pode filtrar os veículos por placa (opcional)
3. Clica no botão de pesquisa para listar os veículos conforme os filtros
4. A tabela é preenchida com os veículos encontrados
5. O usuário seleciona um veículo clicando na linha correspondente
6. O sistema direciona para a tela de detalhes do veículo selecionado
7. Na tela de detalhes, são exibidas todas as peças associadas ao veículo e suas respectivas quantidades
8. O usuário pode retornar à tela de pesquisa através do botão "Voltar"

Instruções Passo a Passo

Como Pesquisar um Veículo

1. Acesse a tela "Peças por Veículos"
2. No campo "Placa do Veículo", digite a placa completa ou parcial do veículo
3. Clique no botão de pesquisa (ícone de lupa)
4. A tabela exibirá os veículos correspondentes ao critério de pesquisa

Como Limpar os Filtros

1. Na tela "Peças por Veículos", clique no botão limpar filtros (ícone de arquivo)
2. Todos os campos de filtro serão resetados para seus valores padrão
3. A pesquisa não é executada automaticamente, clique no botão de pesquisa para exibir todos os veículos

Como Exportar Dados para CSV

1. Realize a pesquisa desejada para filtrar os veículos
2. Clique no botão exportar para CSV (ícone de salvar)
3. O sistema gerará um arquivo CSV chamado "VeiculosPecas.csv" com os dados da tabela
4. O arquivo será baixado automaticamente para seu computador

Como Visualizar as Peças de um Veículo

1. Na tabela de resultados, clique na linha do veículo desejado
2. O sistema abrirá a tela de detalhes do veículo
3. A tabela inferior exibirá todas as peças associadas ao veículo e suas quantidades
4. Para retornar à lista de veículos, clique no botão "Voltar"

Regras de Negócio e Validações

1. Autenticação:

   • Todas as operações requerem um usuário autenticado
   • O sistema verifica a credencial do usuário em cada requisição
   • Se detectada uma sessão inválida (código 99), o usuário é redirecionado para a tela de login

2. Permissões:

   • As operações são restritas ao cliente e empresa do usuário logado
   • O ID do cliente e empresa são enviados em cada requisição

3. Pesquisa:

   • A pesquisa considera apenas veículos (flag "considerarApenasVeiculos" = true)
   • É possível filtrar por nome/placa do veículo de forma parcial
   • A ordenação padrão não é especificada na interface

4. Visualização de Detalhes:

   • Os detalhes do veículo são recuperados pelo ID
   • A listagem de peças é obtida de um endpoint específico
   • O sistema trata adequadamente quando há apenas um item ou múltiplos itens

5. Exportação:

   • A exportação para CSV usa o ponto e vírgula (;) como separador de colunas
   • O nome do arquivo é fixo: "VeiculosPecas.csv"

Perguntas Frequentes

Como faço para encontrar um veículo específico?

Para localizar um veículo específico, digite a placa completa ou parcial no campo "Placa do Veículo" e clique no botão de pesquisa (ícone de lupa). O sistema retornará todos os veículos que correspondam ao critério informado.

O que significa a quantidade exibida para cada peça?

A quantidade exibida representa o saldo atual da peça disponível naquele veículo específico. Este número reflete o estoque móvel que está alocado ao veículo.

Como posso exportar apenas informações de veículos específicos?

Primeiro, aplique os filtros desejados para exibir apenas os veículos que deseja incluir na exportação. Em seguida, clique no botão de exportar para CSV. O arquivo gerado conterá apenas os registros que estão sendo exibidos na tela.

Por que não consigo adicionar ou editar as quantidades de peças?

Esta tela é projetada apenas para consulta do estoque atual. Para ajustar quantidades ou transferir peças entre veículos, você deve utilizar o módulo de movimentação de estoque do sistema.

O sistema atualiza automaticamente os dados exibidos?

Não, o sistema não atualiza automaticamente os dados. Para ver informações atualizadas, é necessário executar a pesquisa novamente clicando no botão de pesquisa.

Como identifico se uma peça está com estoque baixo?

O sistema atualmente não possui indicadores visuais para estoque baixo na interface de consulta. É recomendável estabelecer procedimentos operacionais para definir níveis mínimos de estoque para cada tipo de peça.

É possível ver o histórico de movimentações de uma peça em um veículo?

Esta funcionalidade não está disponível nesta tela. Para verificar o histórico de movimentações, acesse o módulo de "Histórico de Movimentações" do sistema.

Aspectos Técnicos e Funcionamento

O sistema é estruturado em uma arquitetura cliente-servidor, onde:

1. A interface de usuário é construída com componentes responsivos que se adaptam conforme o tamanho da tela.

2. O carregamento de dados ocorre de forma assíncrona, permitindo que o usuário continue interagindo com a interface enquanto os dados são recuperados.

3. Os dados são recuperados do servidor via requisições HTTP POST, enviando parâmetros como o ID do cliente, ID da empresa, filtros aplicados e configurações de paginação.

4. O sistema trata diferentes cenários de resposta:

   • Quando não há dados para exibir
   • Quando há apenas um registro
   • Quando há múltiplos registros
   • Quando ocorre um erro de autenticação

5. A interface utiliza um grid avançado para exibição dos dados que permite:

   • Redimensionamento de colunas
   • Ordenação de dados
   • Seleção de linhas para navegação

6. A tela de detalhes mantém a consistência visual com a tela principal, facilitando a navegação e usabilidade.

7. A exportação para CSV é realizada diretamente no navegador, sem necessidade de processamento adicional no servidor.

Este módulo se integra com o restante do sistema de controle de frota, permitindo uma gestão eficiente dos recursos distribuídos entre os veículos.