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

# Filtros e páginas

> Filtros globais, filtros por widget e organização do dashboard em múltiplas páginas (abas).

# Filtros e páginas

Dois recursos transformam um dashboard estático em uma ferramenta interativa: **filtros** (globais e por widget) e **páginas** (abas dentro do mesmo dashboard).

***

## Filtros globais

Os filtros globais aparecem no topo do dashboard e afetam **todos os widgets** que dependem da coluna filtrada.

### Adicionar um filtro global

<Steps>
  <Step title="Abrir editor">
    Edite o dashboard e clique em **Filtros** na toolbar superior.
  </Step>

  <Step title="Escolher coluna">
    Selecione qual coluna o filtro vai controlar (ex: `created_at`, `origem`, `status`).
  </Step>

  <Step title="Definir tipo de filtro">
    * **Data** — calendário com presets (hoje, ontem, últimos 7/30/90 dias, este mês, mês passado, intervalo customizado)
    * **Seleção** — dropdown com valores únicos da coluna
    * **Texto** — campo livre com operadores (contém, igual, etc.)
    * **Número** — entre, maior que, menor que
  </Step>

  <Step title="Configurar visualização">
    * **Label** — nome exibido para o usuário
    * **Valor padrão** — pré-seleciona um valor ao abrir
    * **Obrigatório** — força o usuário a escolher
  </Step>
</Steps>

### Como o filtro global afeta os widgets

Cada widget pode ter colunas mapeadas para receber o filtro:

* Se o widget consulta uma tabela que tem a mesma coluna → o filtro é aplicado automaticamente
* Se a coluna não existe na tabela do widget → o filtro é ignorado para aquele widget

<Tip>
  Use filtros globais para **período** sempre que possível. Permite que o mesmo dashboard sirva para hoje, semana, mês ou trimestre.
</Tip>

***

## Filtros por widget

Cada widget pode ter seus próprios filtros, configurados na aba **Filtros** do editor de widget. Esses filtros são **acumulativos** com os globais.

### Operadores disponíveis

| Operador                     | Tipos suportados |
| ---------------------------- | ---------------- |
| **igual / diferente**        | Todos            |
| **contém / não contém**      | Texto            |
| **começa com / termina com** | Texto            |
| **maior que / menor que**    | Número, Data     |
| **entre**                    | Número, Data     |
| **vazio / preenchido**       | Todos            |
| **em (lista)**               | Texto, Seleção   |

Você pode combinar múltiplos filtros com lógica **E** (todos precisam bater).

***

## Páginas (abas)

Um dashboard pode ter **múltiplas páginas** organizadas em abas no topo.

### Quando usar páginas

* Separar visões por audiência (Diretoria | Operacional | Marketing)
* Separar por temporalidade (Visão Anual | Mês Atual | Comparativo)
* Separar por área (Vendas | Suporte | Financeiro)

### Gerenciar páginas

| Ação                           | Como fazer                                              |
| ------------------------------ | ------------------------------------------------------- |
| **Criar**                      | Clique no `+` ao lado das abas                          |
| **Renomear**                   | Duplo clique no nome da aba                             |
| **Reordenar**                  | Arraste a aba para a posição desejada                   |
| **Excluir**                    | Menu da aba → Excluir (widgets da página são removidos) |
| **Mover widget entre páginas** | Menu do widget → Mover para...                          |

<Warning>
  Os **filtros globais** valem para o dashboard inteiro (todas as páginas). Para filtros restritos a uma página, use filtros no widget.
</Warning>

***

## Filtros em modo público

Quando o dashboard é compartilhado publicamente, os filtros aparecem para o visualizador. Algumas variáveis especiais podem ser pré-resolvidas a partir da URL ou da sessão de acesso (ex: `{{viewer_email}}`), permitindo personalização por usuário.

***

## Boas práticas

<Tip>
  * **Comece com 1 página** e divida só quando o dashboard ficar denso (10+ widgets).
  * Use **filtro de período global** em todo dashboard de operação.
  * Para dashboards públicos, defina **valor padrão** nos filtros para que abram úteis sem clique.
</Tip>

***

## Próximo passo

<Card title="Modelos prontos" icon="wand-magic-sparkles" href="/dados/dashboards-modelos">
  Use templates para criar dashboards completos em um clique.
</Card>