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

# Gerenciamento de Catálogos

> Crie, publique, bifurque e mescle catálogos para fluxos de trabalho estruturados de conteúdo de produtos.

## Criando um catálogo

Cada produto no Alana Shopping vive dentro de um catálogo. Crie um para começar a organizar seus produtos:

```bash theme={null}
curl -X POST "https://app.alana.shopping/api/workspace/{workspaceId}/catalogs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Primavera 2026",
    "description": "Coleção sazonal para Primavera 2026"
  }'
```

## Fluxo de trabalho de publicação

O fluxo de trabalho recomendado para gerenciar conteúdo de produtos segue um padrão **fork-editar-merge**:

```mermaid theme={null}
graph TD
    A["Catálogo Principal (Published)"] -->|fork| B["Cópia de Trabalho"]
    B -->|add products| C["Editar Conteúdo"]
    C -->|AI enhance| D["Otimizar"]
    D -->|review scores| E["Verificação de QA"]
    E -->|merge| A
```

### Publicar um catálogo

```bash theme={null}
curl -X POST ".../catalogs/{catalogId}/publish" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

Uma vez publicado, os produtos do catálogo aparecem no feed público em `/api/catalog/products`.

### Bifurcar para edição

```bash theme={null}
curl -X POST ".../catalogs/{catalogId}/fork" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"name": "Primavera 2026 — Revisão QA"}'
```

### Mesclar mudanças de volta

```bash theme={null}
curl -X POST ".../catalogs/{catalogId}/merge" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"targetCatalogId": "PARENT_CATALOG_ID"}'
```

## Ações em lote

Execute estágios do pipeline em massa na visão do catálogo ou via API:

* **Normalizar (Silver)** — mapeamento de campos, detecção de duplicatas, validação de URLs de imagem para uma seleção ou catálogo inteiro
* **Analisar (Gold)** — scoring de otimização em 7 estágios da rubrica, produz pontuação + lista de gaps por produto

```bash theme={null}
# Lote Silver — normalizar catálogo inteiro
curl -X POST ".../workspace/{workspaceId}/catalogs/{catalogId}/batch/silver" \
  -H "Authorization: Bearer SUA_CHAVE_API" \
  -d '{"scope": "all"}'

# Lote Gold — pontuar catálogo inteiro
curl -X POST ".../workspace/{workspaceId}/catalogs/{catalogId}/batch/gold" \
  -H "Authorization: Bearer SUA_CHAVE_API" \
  -d '{"scope": "all"}'
```

Veja [Ações em Lote](/guides/batch-actions) e a [Pipeline API](/api-reference/pipeline/overview) para referência completa.

## Configurações do pipeline

Customize como Silver e Gold processam seus produtos:

* **Mapeamentos de campos Silver** — mapear nomes de colunas de origem para campos do schema Alana
* **Pesos de scoring Gold** — ajustar pesos por estágio da rubrica (identidade, conteúdo, mídia, etc.)
* **Auto-trigger** — executar Silver automaticamente após Bronze, ou Gold após Silver

Veja [Configurações do Pipeline](/guides/pipeline-settings) para o guia completo de configuração.

## Rastreamento da evolução do score

A pontuação de otimização é rastreada ao longo do tempo em `score_history`. Use isso para medir o impacto de melhorias de conteúdo — antes e depois de executar melhoria com IA ou normalização em lote.

## Estatísticas do catálogo

Cada catálogo rastreia métricas-chave que ajudam você a avaliar qualidade do conteúdo:

* **Total de produtos** — quantos produtos estão no catálogo
* **Contagem pronta para feed** — produtos que passam em todas as regras de validação
* **Pontuação média de otimização** — pontuação média de qualidade em todos os produtos
* **Distribuição de scores** — breakdown por faixas excelente/bom/atenção/ruim
* **Última publicação** — quando o catálogo foi publicado pela última vez

<Tip>
  Busque 100% de produtos prontos para feed antes de publicar. Execute o Lote Gold primeiro para identificar quais produtos precisam de mais atenção.
</Tip>