Pular para o conteúdo principal

​
Visão geral

Catálogos são contêineres para produtos. Eles fornecem um fluxo de trabalho estruturado para gerenciar conteúdo de produtos que espelha o controle de versão baseado em git.

​
Estados

  • Draft — editável, não visível para consumidores externos
  • Published — bloqueado para edições diretas, visível via API pública de produtos

​
Operações

Marca o catálogo como ativo. Produtos publicados ficam disponíveis através do endpoint público /api/catalog/products. Um catálogo publicado não pode ser editado diretamente — bifurque-o primeiro.
Reverte o catálogo para estado draft e remove seus produtos do feed público.
Cria uma cópia do catálogo. Use forks para iterar sobre conteúdo (adicionar produtos, editar descrições, executar melhorias de IA) sem afetar a versão ao vivo.
Aplica mudanças de um fork de volta ao catálogo pai. Resolução de conflitos é tratada no nível do produto.
Cada catálogo rastreia estatísticas agregadas:
  • Contagem total de produtos
  • Produtos com pontuação de otimização acima do limite
  • Produtos prontos para feed (todos os campos obrigatórios preenchidos)
  • Timestamp da última publicação

​
Marketplace Hub

Catálogos publicados podem ser listados no Marketplace Hub — a exchange de conteúdo B2B onde outros workspaces podem descobrir, visualizar, clonar ou assinar seu catálogo.
  • Publicar no Hub — tornar seu catálogo descobrível no feed público
  • Assinar — receber atualizações de sync em tempo real quando o publisher lança uma nova versão
  • Clonar — tirar um snapshot estático de um catálogo em um ponto no tempo
  • Resolução de conflitos — quando um catálogo assinado é atualizado, conflitos de campo podem ser resolvidos automaticamente ou manualmente
Veja Marketplace para a visão geral completa do conceito, e a Hub API para acesso programático.

​
Integração com o pipeline de dados

Quando produtos são importados, o pipeline Bronze → Silver → Gold executa automaticamente ou sob demanda:
  • Bronze — ingestão bruta, chaveada por idempotência via source_identifier
  • Silver — normalização (mapeamento de campos, detecção de duplicatas, validação de URLs de imagem)
  • Gold — scoring de otimização (0–100) em 7 estágios da rubrica
Ações em lote acionam estágios do pipeline para uma seleção ou catálogo inteiro:
  • Normalizar (Silver) — executar normalização de campos em massa
  • Analisar (Gold) — computar pontuações de otimização em massa
O comportamento do pipeline (auto-trigger, mapeamentos Silver, pesos Gold) é configurável via Configurações do Pipeline.

​
Melhores práticas

Use o fluxo de trabalho fork → editar → merge para atualizações sazonais. Isso permite que sua equipe itere sobre conteúdo “Primavera 2026” enquanto “Inverno 2025” permanece ao vivo.
Execute o Lote Gold após importar um novo catálogo para obter uma linha de base de qualidade antes de publicar.
Last modified on March 18, 2026