> ## 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 (QA)

> Testes de Fornecedores

# OmniDom Fornecedores — QA Test Documentation

### 📌 Suíte de Testes

* **Nome da funcionalidade testada:** Listagem, Cadastro e Edição de Fornecedores
* **Módulo/sistema identificado:** Gestão de Suprimentos / OmniDom BackOffice
* **Pré-condições gerais:** Usuário deve estar logado e possuir perfil válido de administração/gestor.

***

### 🧪 Casos de Teste

**CT1: Cadastro válido de Novo Fornecedor (Caminho Feliz)**

* **Tipo:** Positivo
* **Pré-condição:** Estar na página logada de "Fornecedores".
* **Dados de Entrada:** Nome Comercial: "Fornecedor Teste", Razão: "Teste LTDA", CNPJ/CPF: "27.352.880/0001-51", Telefone: "(11) 3411-2000", E-mail: "[teste@fornecedor.com](mailto:teste@fornecedor.com)".
* **Passos:**
  1. Clicar no botão azul "+ Novo Fornecedor".
  2. Inserir todos os campos corretamente com texto padrão.
  3. Clicar no botão "Criar Fornecedor".
* **Resultado Esperado:** O modal central fecha, acionando o toast "Fornecedor criado com sucesso!".
* **Critério de Aprovação:** Identificação orgânica do card inserido no topo da listagem ou no final da grid de cards.
* **Origem:** Observado nas telas

**CT2: Avaliação e Validação de Máscaras na Digitação**

* **Tipo:** Borda / Positivo
* **Pré-condição:** Modal de Novo Fornecedor livre e aberto.
* **Dados de Entrada:** Digitar as sequências puras: 27352880000151 e 1134112000.
* **Passos:**
  1. No campo CNPJ/CPF digitar apenas os números e checar.
  2. No campo Telefone, digitar apenas números correntes e checar.
* **Resultado Esperado:** As strings injetam marcação especial visual automaticamente.
* **Critério de Aprovação:** Textos finalizando em visual `27.352.880/0001-51` ao invés da string numérica isolada pura.
* **Origem:** Observado nas telas

**CT3: Tentar salvar o fluxo sem @ no e-mail**

* **Tipo:** Negativo
* **Pré-condição:** Dados gerais preenchidos.
* **Dados de Entrada:** "fornecedortestegmailcom".
* **Passos:**
  1. Inserir sequencia sem `.` e sem `@` na key de E-mail de contato.
  2. Pressionar Enter ou "Criar Fornecedor".
* **Resultado Esperado:** Mensagem impedindo salvar o cadastro final.
* **Critério de Aprovação:** Destaque de estado vermelho no input ou alerta direto bloqueando envio de API falsa.
* **Origem:** Inferido

**CT4: Filtrar e Buscar Fornecedor existente via CNPJ**

* **Tipo:** Positivo
* **Pré-condição:** Mais de um fornecedor contido na listagem com números variados.
* **Dados de Entrada:** Digitar trecho válido de documento no input: `27.352`.
* **Passos:**
  1. Clicar em "Buscar por nome ou documento...".
  2. Digitar o fragmento.
* **Resultado Esperado:** O(s) fornecedor(es) cujo dado bater com o snippet inserido permanecerão renderizados na tela. Outros fornecedores serão descartados do DOM de visualização.
* **Critério de Aprovação:** Filtro reativo.
* **Origem:** Observado nas telas

***

### 📋 Regras de Negócio Testadas

* **RN1: Máscara Automática de CNPJ/CPF**
  * Casos de teste relacionados: CT2
* **RN2: Validação de E-mail Útil**
  * Casos de teste relacionados: CT3
* **RN3: Resposta Rápida de Busca**
  * Casos de teste relacionados: CT4

***

### ⚠️ Cenários de Exceção

* Validação se modal fechar sem salvar no click em "Cancelar". Não pode reter estado preenchido persistente ao ser reaberto.

***

### 📊 Matriz de Cobertura

| Funcionalidade         | CT Positivo | CT Negativo | CT Borda |
| ---------------------- | ----------- | ----------- | -------- |
| Cadastro de Fornecedor | CT1         | CT3         | -        |
| Entradas com Máscara   | -           | -           | CT2      |
| Listagem & Busca       | CT4         | -           | -        |

***

*Documentação gerada via DocVision Test*