> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alana.shopping/llms.txt
> Use this file to discover all available pages before exploring further.

# Catálogos

> Fluxos de trabalho de catálogo semelhantes ao git — publique, bifurque, mescle e versione seu conteúdo de produtos.

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

## Ciclo de vida do catálogo

```mermaid theme={null}
graph LR
    A["Draft"] -->|publish| B["Published"]
    B -->|unpublish| A
    A -->|fork| C["Fork"]
    C -->|merge| A
```

### 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

<AccordionGroup>
  <Accordion title="Publicar">
    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.
  </Accordion>

  <Accordion title="Despublicar">
    Reverte o catálogo para estado draft e remove seus produtos do feed público.
  </Accordion>

  <Accordion title="Bifurcar (Fork)">
    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.
  </Accordion>

  <Accordion title="Mesclar (Merge)">
    Aplica mudanças de um fork de volta ao catálogo pai. Resolução de conflitos é tratada no nível do produto.
  </Accordion>
</AccordionGroup>

## Estatísticas do catálogo

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](/concepts/marketplace) para a visão geral completa do conceito, e a [Hub API](/api-reference/hub/overview) 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](/guides/pipeline-settings).

## Melhores práticas

<Tip>
  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.
</Tip>

<Tip>
  Execute o **Lote Gold** após importar um novo catálogo para obter uma linha de base de qualidade antes de publicar.
</Tip>