> ## 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 (Histórias)

> Histórias de Usuário para Fornecedores

# Histórias de Usuário: OmniDom Fornecedores

### 📌 Épico Identificado

* **Nome do épico:** Base de Gestão Contínua de Fornecedores e Cadeia Logística
* **Objetivo de negócio:** Garantir uma ferramenta rápida para listar, buscar os responsáveis pela mercadoria, e permitir manutenção direta nos dados de contato do faturamento da retaguarda comercial.
* **Módulo/sistema identificado:** Módulo Fornecedores / Plataforma OmniDom

***

### 📖 Histórias de Usuário

**HU1: Busca Híbrida e Renderização na Listagem de Fornecedores**

* **Como** Gestor de Suprimentos
* **Quero** visualizar todos os fornecedores cadastrados organizados em forma de cards ou grid para ter uma visão geral e pesquisar nomes da minha base na barra central
* **Para que** eu encontre o parceiro desejado para entrar em contato ou reativar vínculos antigos de produtos homologados
* **Prioridade sugerida:** Alta
* **Estimativa de complexidade:** M

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

* **CA1:** Dado que eu acesso o sub-modulo "Fornecedores" do menu / Quando acesso essa página específica / Então a lista de entidades carrega automaticamente agrupando (Nome, E-mail, Telefone e uma SKU fiscal identificadora interna) de cada um. (Visível nas telas)
* **CA2:** Dado que coloco números de um CNPJ conhecido ou letras do nome parceiro / Quando uso o input de busca superior / Então visualizo a restrição na tela apenas exibindo resultado igualitário isolado sem *refreshs* brutos (Visível nas telas)

**📋 Regras de Negócio Relacionadas**

* **RN1:** Barra de Consulta Universal Front-End
  * **Condição:** Inserir dados na Textbox superior.
  * **Comportamento:** A busca vasculha simultaneamente pelo padrão "Identificador Alfanumérico" *OU* "Nome Fantasia".

***

**HU2: Processo Unilateral de Cadastro do Novo Fornecedor**

* **Como** Administrador do Módulo
* **Quero** acionar o gatilho "*Novo Fornecedor*" para abrir formulário e transcrever as chaves essenciais: Nome Comercial, Razão Social, CNPJ / CPF, Telefone fixo/móvel e E-mail.
* **Para que** seja factível encomendar novos lotes com empresas que estendem as margens da plataforma ou ampliam as frentes de logística B2B.
* **Prioridade sugerida:** Alta
* **Estimativa de complexidade:** M

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

* **CA3:** Dado que pressiono "Novo Fornecedor" / Quando o *backdrop* e o *overlay* modal aparecem / Então visualizo 5 inputs padronizados, com call-to-action azul validativo e um botão abortivo (cancelamento secundário) ao redor (Visível nas telas)
* **CA4:** Dado que digito as credenciais no "Criar" / Quando o pacote tem sucesso pela malha HTTP / Então pego uma confirmação "Toast" da palavra "Sucesso!" na UI base (Visível nas telas/Observado na grid).

**📋 Regras de Negócio Relacionadas**

* **RN2:** Aplicação de Máscaras Fiscais e Tel
  * **Condição:** Digitação em campos tipo Documento.
  * **Comportamento:** Máscara reativa (ex `###.###.###/####-##`).

***

**HU3: Edição Direta do Fornecedor Retido**

* **Como** Analista de Dados BackOffice
* **Quero** atualizar um número de telefone divergente ou um e-mail de SAC modificado usando o atalho de "Visualizar Detalhes"
* **Para que** e-mails de compras automáticas não retornem como Hard-Bounces ao antigo atendente deles.
* **Prioridade sugerida:** Baixa
* **Estimativa de complexidade:** P

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

* **CA5:** Dado que navego para um card específico de um "Fornecedor A" e clico nele / Quando optado o painel de propriedades editáveis / Então recebo estado de tela muito similar à sua Criação natural, com campos editáveis reescritos pela API de leitura (Visível nas telas)

***

### 🗂️ Backlog Sugerido

| ID  | História                                                  | Prioridade | Tamanho |
| --- | --------------------------------------------------------- | ---------- | ------- |
| HU1 | Visualização e Busca e Filtro  (Listagem de Fornecedores) | Alta       | M       |
| HU2 | Processo de Cadastro do Novo Fornecedor (Modal)           | Alta       | M       |
| HU3 | Edição Direta do Fornecedor Retido (Ver Detalhes)         | Baixa      | P       |

***

### 📝 Definition of Ready

* ✅ Critérios de aceitação definidos
* ✅ Regras de negócio mapeadas
* ✅ Estrutura de UI provada (Via Capturas de Vídeo UI/UX da Dom)
* ⬜ Especificação Swagger/Endpoint de `/fornecedores/` confirmada.