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

# Catalog API

> Endpoints para explorar o data lake: árvore de camadas, contagem de linhas, prévia de dados e lineage de pipelines.

A **Catalog API** faz parte da camada de Data Engineering da strattum.ai. Ela expõe metadados do data lake (camadas `raw` e `clean`) sem mover dados — as contagens são lidas dos footers dos arquivos Parquet e as prévias limitadas a uma amostra configurável.

## Base URL

```
http://localhost:8001
```

Em produção, o endereço é configurado no deployment BYOC do cliente.

## Autenticação

A versão 1.0 não exige autenticação — o acesso é controlado pela rede privada do cliente (VPC/VLAN).

## Arquitetura de camadas

| Camada  | Onde vive                                             | Quem escreve       |
| ------- | ----------------------------------------------------- | ------------------ |
| `raw`   | Delta tables em `/data/raw/{connector}/{table}/`      | Conectores dlt     |
| `clean` | DuckDB schema `main_clean` em `/data/strattum.duckdb` | Transformações dbt |

## Endpoints

<CardGroup cols={2}>
  <Card title="GET /catalog/tree" icon="sitemap" href="/api-reference/catalog/tables">
    Árvore completa — todos os conectores, tabelas raw e modelos clean.
  </Card>

  <Card title="GET /catalog/layers" icon="layer-group" href="/api-reference/catalog/tables">
    Resumo das camadas com contagem de tabelas por camada.
  </Card>

  <Card title="GET /catalog/counts" icon="chart-bar" href="/api-reference/catalog/tables">
    Contagem de linhas de todas as tabelas (leitura de metadados Parquet — rápida).
  </Card>

  <Card title="GET /catalog/preview" icon="eye" href="/api-reference/catalog/tables">
    Prévia das primeiras linhas de uma tabela raw ou modelo clean.
  </Card>

  <Card title="GET /v1/lineage" icon="diagram-project" href="/api-reference/catalog/lineage">
    Grafo de lineage completo: conectores, modelos dbt, Memory e Knowledge.
  </Card>
</CardGroup>