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

# Fornecedores (Funcional)

> Gestão de Fornecedores

# Gestão de Fornecedores (OmniDom)

### 📌 Visão Geral

* **Nome da funcionalidade:** Gestão de Fornecedores
* **Objetivo principal:** Permitir a administração completa dos fornecedores parceiros, incluindo a busca, listagem, cadastro e edição.
* **Perfil de usuário:** Administradores, gestores de compras e suprimentos.
* **Pré-requisitos de acesso:** Login ativo e permissões ao módulo de Fornecedores.

***

### 🔢 Passo a Passo

**Passo 1: Acesso e Listagem**

* O usuário acessa o módulo "Fornecedores" pelo menu.
* O usuário vê a barra de busca centralizada, o botão azul "+ Novo Fornecedor" e os cards dos fornecedores já cadastrados.
* O usuário pode visualizar os dados resumidos de cada parceiro (Nome, E-mail, Telefone e SKU/ID) nos cards.

**Passo 2: Busca de Fornecedores**

* O usuário digita no campo "Buscar por nome ou documento...".
* Resultado esperado: A lista de cards é filtrada exibindo apenas fornecedores correspondentes à pesquisa.

**Passo 3: Cadastro de Novo Fornecedor**

* O usuário clica no botão "+ Novo Fornecedor".
* O modal "Novo Fornecedor" é aberto centralizado na tela.
* O usuário preenche os campos disponíveis: Nome Comercial, Razão Social, CNPJ/CPF, Telefone e E-mail de Contato.
* O usuário clica em "Criar Fornecedor".
* Resultado esperado: O modal é fechado automaticamente, a notificação (toast verde) "Fornecedor criado com sucesso!" é exibida e o card correspondente aparece adicionado na lista de resultados sem necessidade de recarregar a página.

**Passo 4: Edição de Fornecedor Existente**

* O usuário clica no botão "Ver Detalhes" dentro do card de um fornecedor já existente.
* O modal "Editar Fornecedor" é aberto com todos os dados atuais previamente preenchidos para alteração.

***

### 📋 Regras de Negócio

* **RN01: Formato de Máscaras (Documentos e Contato)**
  * **Descrição:** Campos específicos têm formatação numérica automática visual.
  * **Condição:** Ao inserir dígitos numéricos no CNPJ/CPF e Telefone.
  * **Comportamento:** O sistema aplica a máscara isolando blocos conforme a padronização oficial. (ex: (11) 3411-2000 e 27.352.880/0001-51).
* **RN02: Validação de E-mail de Contato**
  * **Descrição:** O fornecedor deve apresentar um e-mail estruturalmente válido para envio.
  * **Condição:** Na tentativa de salvar o registro.
  * **Comportamento:** O sistema requer que o valor cumpra o formato de provedor eletrônico clássico (`usuario@dominio.com`).
* **RN03: Pesquisa e Filtro de Dados Híbrido**
  * **Descrição:** O input de busca tem dupla responsabilidade.
  * **Condição:** Acesso comum na listagem principal.
  * **Comportamento:** Filtra tanto pelo fragmento inicial do nome comercial, quanto pelos caracteres identificadores do documento fiscal.

***

### ✅ Critérios de Aceitação

* **CA01: Salvar Novo Cadastro**
  * **Dado que:** o usuário preencheu todos os campos requeridos dentro do modal.
  * **Quando:** clica para criar.
  * **Então:** um pop-up de sucesso deve avisar e injetar os dados no *front*.
* **CA02: Iniciar Cadastro sem Máscara**
  * **Dado que:** o usuário insira números no CNPJ/CPF puros.
  * **Quando:** ocorre a digitação contínua.
  * **Então:** formatações como pontos e barras/hífens aparecerão.

***

### ⚠️ Pontos de Atenção

* Sempre verificar se o fornecedor já consta na base antes de cadastrar para evitar duplicidade estrutural indesejada (identidade por CNPJ/CPF).

***

### 💡 Dicas para o Usuário

* Para pesquisar com absoluta precisão uma empresa, a digitação do CNPJ da matriz é infinitamente mais confiável que fragmentos do `Nome fantasia`.
* Lembre-se que o "E-mail de contato" será o ponto central para emissão/cotação de pedidos no módulo de compras futuro.