> ## Documentation Index
> Fetch the complete documentation index at: https://docs.domsoftware.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Depósitos (Funcional)

> Gestão de Depósitos

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