Skip to main content

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