# Almoxarifados

## Descrição Geral da Interface

O módulo "**ALMOXARIFADOS"** apresentado é parte do sistema de gerenciamento de frota "CONCEPT RASTREAMENTO", especificamente dedicada ao controle de almoxarifados de pneus. O módulo permite visualizar, cadastrar, editar e excluir locais de armazenamento de pneus (almoxarifados). A interface possui um design limpo e organizado, com uma navegação intuitiva entre as telas de listagem e edição/cadastro. Para acessar clique no menu PNEUS, opção ALMOXARIFADOS

## Elementos da Interface

### Tela de Listagem (Almoxarifados)

#### Seção de Filtros

- **Campo Descrição**: Campo de texto livre para filtrar almoxarifados pelo nome
- **Botão de Pesquisa**: Ícone de lupa que executa a busca com os filtros aplicados
- **Botão Limpar Filtros**: Ícone de documento que limpa todos os filtros aplicados
- **Botão Novo**: Ícone de adição (+) em amarelo que direciona para a tela de cadastro
- **Botão Exportar para CSV**: Ícone de salvamento em verde que exporta a lista para arquivo CSV

#### Tabela de Resultados

- **Coluna NOME**: Exibe a descrição dos almoxarifados cadastrados
- **Paginação**: Controles de navegação entre páginas de resultados (1-4 de 4)
- **Contador de Registros**: Exibe o intervalo e total de registros exibidos

### Tela de Edição/Cadastro (Almoxarifado)

#### Seção de Dados

- **Campo Descrição**: Campo de texto obrigatório para o nome do almoxarifado

#### Botões de Ação

- **Botão Gravar**: Botão verde que salva as alterações
- **Botão Excluir**: Botão vermelho que remove o registro (visível apenas em modo de edição)
- **Botão Voltar**: Botão cinza que retorna à tela de listagem sem salvar alterações

#### Área de Validação

- **Componente de Exibição de Erros**: Exibe mensagens de erro quando campos obrigatórios não são preenchidos

## Propósito e Fluxo de Trabalho

O propósito desta interface é gerenciar locais de armazenamento de pneus da frota, permitindo que os usuários organizem seu inventário por localização física. O fluxo de trabalho segue um padrão CRUD (Criar, Ler, Atualizar, Excluir):

1. **Visualização**: Na tela de listagem, o usuário pode ver todos os almoxarifados cadastrados
2. **Filtro**: O usuário pode filtrar a lista por nome para encontrar um almoxarifado específico
3. **Cadastro**: Através do botão Novo, o usuário acessa a tela de cadastro para criar um novo almoxarifado
4. **Edição**: Ao clicar em um registro na tabela, o usuário é direcionado para a tela de edição
5. **Exclusão**: Na tela de edição, o usuário pode excluir o registro atual
6. **Exportação**: O usuário pode exportar a lista filtrada para um arquivo CSV

## Regras de Negócio e Validações

- O campo Descrição é obrigatório no cadastro e edição
- A exclusão só é permitida para registros existentes (com ID)
- O acesso às funções de gravação e exclusão é controlado por permissões de usuário
- Existem três níveis de permissão: 
    - Acesso Master: Pode realizar todas as operações
    - Acesso de Grupo: Pode realizar operações se o usuário tiver a capacidade apropriada
    - Acesso Individual: Permissões baseadas em configurações individuais
- Os dados são filtrados por empresa do usuário logado
- A paginação é automática baseada no tamanho da página

## Instruções Passo a Passo

### Como Pesquisar Almoxarifados

1. Acesse a tela de listagem de almoxarifados
2. No campo Descrição, digite o texto para filtrar (opcional)
3. Clique no botão de lupa (Pesquisa) para aplicar o filtro
4. Os resultados serão exibidos na tabela abaixo
5. Use os controles de paginação para navegar entre páginas de resultados

### Como Cadastrar um Novo Almoxarifado

1. Na tela de listagem, clique no botão amarelo com ícone de adição (+)
2. Na nova tela, preencha o campo Descrição com o nome do almoxarifado
3. Clique no botão verde "Gravar" para salvar
4. Se houver erros de validação, eles serão exibidos no topo da tela
5. Após o salvamento bem-sucedido, você será redirecionado para a tela de listagem

### Como Editar um Almoxarifado Existente

1. Na tela de listagem, localize o almoxarifado desejado (use filtros se necessário)
2. Clique na linha correspondente na tabela
3. Na tela de edição, modifique o campo Descrição conforme necessário
4. Clique no botão verde "Gravar" para salvar as alterações
5. Após o salvamento bem-sucedido, você será redirecionado para a tela de listagem

### Como Excluir um Almoxarifado

1. Na tela de listagem, localize e clique no almoxarifado que deseja excluir
2. Na tela de edição, clique no botão vermelho "Excluir"
3. Confirme a exclusão quando solicitado
4. Após a exclusão bem-sucedida, você será redirecionado para a tela de listagem

### Como Exportar a Lista para CSV

1. Na tela de listagem, aplique os filtros desejados (opcional)
2. Clique no botão verde com ícone de salvamento
3. O arquivo CSV será gerado e baixado automaticamente

## Perguntas Frequentes (FAQ)

### Gerais

1. **Como faço para encontrar rapidamente um almoxarifado específico?**  
    Use o campo de filtro na seção "Filtros" e digite parte do nome do almoxarifado.
2. **Por que não consigo excluir um almoxarifado?**  
    Isso pode ocorrer por dois motivos: ou você não tem permissões suficientes, ou o almoxarifado está sendo utilizado por outros registros no sistema.
3. **Posso ter dois almoxarifados com o mesmo nome?**  
    Sim, o sistema permite almoxarifados com nomes idênticos, mas isso não é recomendado para evitar confusão.
4. **O que acontece com os pneus registrados em um almoxarifado quando ele é excluído?**  
    Você deve primeiro transferir os pneus para outro almoxarifado antes de excluir um almoxarifado em uso.

### Técnicas

1. **Por que os botões de gravar e excluir estão desabilitados?**  
    Os botões são desabilitados quando o usuário não tem permissão para realizar essas operações. Isso é determinado pelas configurações de acesso do usuário.
2. **Como funciona a paginação da lista?**  
    A paginação é automática e exibe um número fixo de registros por página, permitindo navegar entre as páginas através dos controles na parte inferior da tabela.
3. **O que acontece se eu tentar gravar um almoxarifado sem descrição?**  
    O sistema exibirá uma mensagem de erro informando que o campo descrição é obrigatório e não permitirá o salvamento.
4. **Para que serve o campo ID do almoxarifado?**  
    O ID é um identificador único gerado pelo sistema e usado internamente para relacionar o almoxarifado com outros registros no banco de dados.
5. **Como são aplicadas as permissões de acesso nesta tela?**  
    As permissões são verificadas com base no tipo de acesso do usuário (Master, Grupo ou Individual) e nas capacidades específicas configuradas para o usuário ou grupo.

## Conclusão

A interface de gerenciamento de almoxarifados de pneus é uma ferramenta essencial para organizar e controlar os locais de armazenamento de pneus na gestão de frota. Com operações simples de cadastro, edição, exclusão e pesquisa, ela permite manter o controle eficiente dos almoxarifados da empresa, integrando-se ao fluxo mais amplo de gerenciamento de pneus no sistema.