Skip to main content

​
Gestão de Depósitos (OmniDom)

​
📌 Visão Geral

  • Nome da funcionalidade: Gestão de Depósitos
  • Objetivo principal: Cadastro, edição e gerenciamento de locais físicos de estoque, vinculando-os a empresas e definindo localizações geográficas precisas via CEP.
  • Perfil de usuário: Administradores de Estoque, Gerentes de Logística e Gestores BackOffice.
  • Pré-requisitos de acesso: Login ativo e permissões administrativas no módulo de Logística/Depósitos.

​
🔢 Passo a Passo

Passo 1: Iniciar Novo Cadastro
  • O usuário acessa a listagem de Depósitos e clica no botão ”+ Novo Depósito”.
  • O modal de criação de depósito é exibido.
Passo 2: Preenchimento de Dados Iniciais
  • O usuário seleciona a Empresa Vínculo à qual o depósito pertence.
  • O usuário preenche o Nome, Código Interno e Tipo de Estrutura (ex: Loja / Ponto de Venda).
Passo 3: Localização e Integração de CEP
  • O usuário insere um CEP válido (ex: 09540-000).
  • O usuário aciona a busca de endereço.
  • O sistema preenche automaticamente os campos de logradouro, bairro e cidade.
Passo 4: Confirmação Geográfica e Salvamento
  • O usuário prossegue e o sistema pode solicitar uma confirmação do endereço.
  • O usuário salva o registro.
  • Resultado esperado: Exibição do toast “Depósito criado com sucesso!” e inclusão na listagem.
Passo 5: Definir Depósito Padrão
  • O usuário acessa o menu de ações de um depósito na listagem.
  • O usuário opta por marcá-lo como “Padrão”.
  • Resultado esperado: A tag de destaque de Depósito Padrão é movida para este item e o toast “Depósito definido como padrão” aparece.

​
📋 Regras de Negócio

  • RN01: Automação de Endereçamento
    • Descrição: O sistema deve consumir serviço de CEP.
    • Condição: Ao inserir um CEP válido e buscar.
    • Comportamento: Preenche logradouro e cidade instantaneamente.
  • RN02: Mapeamento Operacional por Estrutura
    • Descrição: O Tipo de Estrutura reflete uma nomenclatura de sistema.
    • Condição: Na seleção do dropdown (ex: Loja).
    • Comportamento: O sistema o categoriza logicamente, gerando tags visuais baseadas no ramo da estrutura.
  • RN03: Exclusividade de Depósito Padrão
    • Descrição: A centralização do estoque primário atende a um nó unitário.
    • Condição: Ao definir um local como “Padrão”.
    • Comportamento: O sistema remove a flag de padrão de qualquer outro depósito existente, mantendo apenas este ativo como o centro de distribuição default.

​
✅ Critérios de Aceitação

  • CA01: Busca de CEP Eficaz
    • Dado que: o usuário digita um CEP funcional em área coberta.
    • Quando: o sistema processa a requisição conectada com a API.
    • Então: todos os campos sensíveis de localização são destravados e auto-preenchidos.
  • CA02: Transferência de Padrão
    • Dado que: já existe um depósito A marcado como Padrão.
    • Quando: o usuário seleciona a ação “Tornar Padrão” no depósito B.
    • Então: a tag visual é instantaneamente transferida de A para B e o toast de sucesso alerta o usuário.

​
⚠️ Pontos de Atenção

  • Sempre revisar o campo numérico após a busca de CEP, garantindo que número e complementos manuais sejam injetados em seguida.

​
💡 Dicas para o Usuário

  • Padronize inteligentemente os Códigos Internos (ex: SP-01, RJ-02) da cadeia para facilitar a busca rápida em listagens logísticas volumosas.