​

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

• 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

• 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)

• 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”.

• 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

• 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).

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

• 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

• 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

​

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