Controle de Estoque - Depósito de Peças/Produtos

1. Descrição da Interface

O módulo apresenta uma interface para gerenciamento de depósitos de produtos, que faz parte de um sistema maior de controle de estoque para gerenciamento de frota. A interface é dividida em duas telas principais: uma tela de listagem de depósitos (com filtros e uma tabela de resultados) e uma tela de edição/criação de depósitos (com campos para inserção de dados e lista de produtos associados ao depósito).

A interface possui um design limpo e intuitivo, com um menu de navegação vertical à esquerda e o conteúdo principal ocupando a maior parte da tela. Os elementos visuais incluem cartões (cards) que agrupam funcionalidades relacionadas, campos de entrada de dados, botões de ação e tabelas para exibição de informações. Para acessar a opção utilize o menu FROTAS e a seção CONTROLE DE ESTOQUE e  opção DEPÓSITO DE PEÇAS.

2. Elementos da Interface

Tela de Listagem (Depósitos de Peças)

Seção de Filtros

• Nome: Campo de texto para filtrar depósitos pelo nome
• Desconsiderar Saldo: Checkbox para filtrar depósitos que têm a opção "desconsiderar saldo" ativada
• Botões de Ação:
  • Pesquisar (ícone de lupa): Aplica os filtros e atualiza a lista
  • Limpar Filtros (ícone de arquivo): Remove todos os filtros aplicados
  • Novo (ícone de adição): Cria um novo registro de depósito
  • Exportar para CSV (ícone de salvar): Exporta a lista atual para um arquivo CSV

Tabela de Resultados

• Colunas:

  • (número sequencial)

  • Nome (nome do depósito)
  • Desconsiderar Saldo (exibe "X" se ativado, "-" se desativado)
• Funcionalidade: Ao selecionar uma linha, o sistema navega para a tela de edição do depósito selecionado
• Contagem de Registros: Exibe o número total de registros na parte inferior da tabela

Tela de Edição (Depósito de Peças)

Seção de Dados do Depósito

• Nome: Campo de texto obrigatório para o nome do depósito
• Desconsiderar Saldo: Checkbox para indicar se o depósito deve desconsiderar o saldo de produtos
• Botões de Ação:
  • Gravar: Salva as alterações realizadas
  • Excluir: Remove o depósito (visível apenas para registros existentes)
  • Voltar: Retorna à tela de listagem

Seção de Produtos no Depósito

• Tabela de Produtos:
  • Produto: Nome do produto
  • QTD: Quantidade em estoque do produto no depósito
• Mensagem: Exibe "Nenhum produto." quando não há produtos associados ao depósito

Seção de Validação

• Exibe mensagens de erro quando há problemas com os dados inseridos
• Exemplo: "Nome obrigatório" quando o campo nome está vazio

3. Propósito e Fluxo de Trabalho

Propósito

O sistema serve para gerenciar depósitos de produtos (peças) utilizados na manutenção de uma frota de veículos. Permite criar, editar, listar e excluir depósitos, além de visualizar os produtos armazenados em cada depósito e suas respectivas quantidades.

Fluxo de Trabalho Principal

1. Listagem de Depósitos:

   • O usuário visualiza todos os depósitos cadastrados
   • Pode aplicar filtros para encontrar depósitos específicos
   • Pode criar um novo depósito ou selecionar um existente para edição

2. Criação/Edição de Depósito:

   • O usuário preenche ou altera os dados do depósito (nome, opção de desconsiderar saldo)
   • Se estiver editando um depósito existente, pode visualizar os produtos associados e suas quantidades
   • Ao salvar, o sistema valida os dados e exibe mensagens de erro se necessário
   • Ao excluir, o sistema verifica se não há produtos associados antes de permitir a exclusão

3. Exclusão de Depósito:

   • O usuário só pode excluir um depósito se não houver produtos associados a ele
   • O sistema exibe uma mensagem de erro se a exclusão não for possível

4. Instruções Passo a Passo

Como Consultar Depósitos

1. Acesse a tela de listagem de depósitos
2. (Opcional) Preencha os filtros desejados:
   • Digite um nome ou parte do nome no campo "Nome"
   • Marque a opção "Desconsiderar Saldo" se desejar filtrar por essa característica
3. Clique no botão de pesquisa (ícone de lupa)
4. Visualize os resultados na tabela abaixo
5. Para limpar os filtros, clique no botão com ícone de arquivo

Como Criar um Novo Depósito

1. Na tela de listagem, clique no botão "Novo" (ícone de adição)
2. Na tela de edição, preencha o campo "Nome" (obrigatório)
3. (Opcional) Marque a opção "Desconsiderar Saldo" se necessário
4. Clique no botão "Gravar" para salvar o novo depósito
5. Se houver algum erro de validação, corrija-o e tente novamente
6. Após salvar com sucesso, o sistema retornará à tela de listagem

Como Editar um Depósito Existente

1. Na tela de listagem, clique na linha do depósito que deseja editar
2. Na tela de edição, altere os campos desejados:
   • Modifique o nome do depósito
   • Marque ou desmarque a opção "Desconsiderar Saldo"
3. Visualize os produtos associados ao depósito na tabela inferior
4. Clique no botão "Gravar" para salvar as alterações
5. Para retornar sem salvar, clique no botão "Voltar"

Como Excluir um Depósito

1. Na tela de listagem, clique na linha do depósito que deseja excluir
2. Na tela de edição, clique no botão "Excluir"
3. O sistema verificará se é possível excluir o depósito:
   • Se não houver produtos associados, o depósito será excluído
   • Se houver produtos associados, o sistema exibirá uma mensagem de erro
4. Após a exclusão bem-sucedida, o sistema retornará à tela de listagem

Como Exportar a Lista de Depósitos 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á nomeado como "DepositoPecas.csv"

5. Regras de Negócio

1. Validação de Nome:

   • O campo "Nome" é obrigatório para todos os depósitos
   • Se o usuário tentar salvar um depósito sem nome, o sistema exibirá uma mensagem de erro

2. Exclusão de Depósito:

   • Um depósito só pode ser excluído se não houver produtos associados a ele
   • O sistema verifica a quantidade de produtos associados antes de permitir a exclusão
   • Se houver produtos associados, o sistema exibe uma mensagem informando a quantidade de produtos que impedem a exclusão

3. Desconsiderar Saldo:

   • A opção "Desconsiderar Saldo" permite que o depósito seja usado sem considerar o saldo dos produtos para fins de cálculos ou reservas

4. Permissões de Acesso:

   • As ações de gravar e excluir só estão disponíveis para usuários com permissão de gravação ou capacidade master
   • O sistema verifica as permissões do usuário logado antes de habilitar os botões correspondentes

5. Visualização de Produtos:

   • O sistema exibe automaticamente todos os produtos associados ao depósito na tabela de produtos
   • A quantidade de cada produto é mostrada na coluna "QTD"

6. Perguntas Frequentes

O que significa a opção "Desconsiderar Saldo"?

A opção "Desconsiderar Saldo" indica que o depósito não será considerado nos cálculos de saldo de estoque. Isso pode ser útil para depósitos temporários, depósitos de manutenção ou outros casos especiais onde os produtos não devem afetar o saldo total disponível.

Por que não consigo excluir um depósito?

Não é possível excluir um depósito que possua produtos associados. Isso acontece para manter a integridade dos dados, já que os produtos precisam estar sempre associados a um depósito. Para excluir o depósito, primeiro transfira ou remova todos os produtos associados a ele.

Como posso ver quantos produtos existem em um depósito?

Ao acessar a tela de edição de um depósito, a tabela na parte inferior exibirá todos os produtos associados ao depósito e suas respectivas quantidades.

É possível transferir produtos entre depósitos?

Esta funcionalidade não está disponível diretamente nesta tela. Para transferir produtos entre depósitos, é necessário utilizar a função de movimentação de estoque disponível em outra parte do sistema.

Os usuários têm permissões diferentes para gerenciar depósitos?

Sim, o sistema possui controle de permissões. Apenas usuários com permissão de gravação ou capacidade master podem criar, editar ou excluir depósitos. Todos os usuários podem visualizar a lista de depósitos e seus detalhes.

Como faço para exportar a lista de depósitos?

Na tela de listagem, clique no botão "Exportar para CSV" (ícone de salvar). O sistema exportará todos os depósitos exibidos na tabela para um arquivo CSV chamado "DepositoPecas.csv".

Posso filtrar os depósitos por algum critério específico?

Sim, a tela de listagem oferece filtros por nome e pela opção "Desconsiderar Saldo". Preencha os campos desejados e clique no botão de pesquisa para aplicar os filtros.

7. Fluxos de Exceção

Tentativa de Salvar sem Nome

1. Usuário tenta salvar um depósito sem preencher o campo "Nome"
2. Sistema exibe mensagem de erro: "Nome obrigatório"
3. Usuário deve corrigir o erro e tentar novamente

Tentativa de Excluir Depósito com Produtos

1. Usuário tenta excluir um depósito que possui produtos associados
2. Sistema verifica a quantidade de produtos associados
3. Sistema exibe mensagem de erro: "Não é possível remover o depósito, pois existe(m) X produto(s) associado(s)."
4. Usuário deve remover os produtos do depósito antes de tentar excluí-lo novamente

Erro de Autenticação

1. Se a sessão do usuário expirar durante as operações
2. Sistema identifica código 99 na resposta
3. Sistema redireciona automaticamente para a tela de login

Erro no Servidor

1. Se ocorrer qualquer erro no servidor durante as operações
2. Sistema captura o erro e registra no log
3. Sistema exibe uma mensagem genérica: "Erro ao [operação] depósito"

8. Considerações Adicionais

• O sistema faz parte de um módulo maior de controle de estoque para gestão de frota
• A interface utiliza componentes visuais modernos para melhorar a experiência do usuário
• As operações são protegidas por um sistema de autenticação e autorização
• As mensagens de erro são exibidas de forma clara e destacada para facilitar a correção
• O sistema registra logs para todas as operações, facilitando a identificação de problemas