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

Sistema de Controle de Estoque - Depósitos de Produtos

1. Descrição da Interface

O ~~sistema~~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

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
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
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

Acesse a tela de listagem de depósitos
(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
Clique no botão de pesquisa (ícone de lupa)
Visualize os resultados na tabela abaixo
Para limpar os filtros, clique no botão com ícone de arquivo

Como Criar um Novo Depósito

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

Como Editar um Depósito Existente

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

Como Excluir um Depósito

Na tela de listagem, clique na linha do depósito que deseja excluir
Na tela de edição, clique no botão "Excluir"
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
Após a exclusão bem-sucedida, o sistema retornará à tela de listagem

Como Exportar a Lista de Depósitos para CSV

Na tela de listagem, 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
O arquivo será nomeado como "DepositoPecas.csv"

5. Regras de Negócio

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
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
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
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
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

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

Tentativa de Excluir Depósito com Produtos

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

Erro de Autenticação

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

Erro no Servidor

Se ocorrer qualquer erro no servidor durante as operações
Sistema captura o erro e registra no log
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