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

# Dashboard (CLI)

> Métricas agregadas da organização (receita, ranking de afiliados, séries temporais) e notificações.

O grupo `dashboard` expõe as métricas agregadas usadas na home e nos relatórios do painel: receita atribuída, ranking de afiliados, conversões, comissões por status e novos afiliados, todas somente leitura. Não há página equivalente na aba SDK nem conceito próprio: os comandos abaixo mapeiam 1:1 os endpoints da API, e os campos seguem a [Referência da API](/docs/convencoes/ids-e-recursos).

## Receita

`revenue-timeseries` compara o período atual com os 30 dias anteriores. É o gráfico-herói da home.

```bash theme={null}
repass dashboard revenue-timeseries --json
```

## Ranking de afiliados

```bash theme={null}
repass dashboard top-affiliates --period 30d --limit 10 --json
```

`--period` aceita `30d`, `90d` ou `ytd` (default `30d`); `--limit` vai até 50 (default 5).

```json repass dashboard top-affiliates --json theme={null}
[
  { "affiliateId": "aff_xxx", "name": "Maria Silva", "earningsCents": 450000, "commissionCount": 12 },
  …
]
```

## Séries temporais

```bash theme={null}
# Conversões não anuladas por bucket de calendário
repass dashboard conversions-timeseries --period 90d --json

# Novos afiliados (por data de criação) por bucket de calendário
repass dashboard new-affiliates-timeseries --period ytd --json
```

## Comissões por status

Soma e contagem de comissões por status no período.

```bash theme={null}
repass dashboard commissions-by-status --period 30d --json
```

## Notificações

O grupo `notifications` (só `list`) traz as notificações da organização: alertas operacionais como falha de sincronização de cupom. Também não tem página SDK equivalente.

```bash theme={null}
repass notifications list --type coupon.sync_failed --json
```

`notifications list` é paginado. Veja [Paginação](/docs/cli/paginacao) para `--all` e cursores.

```json repass notifications list --json theme={null}
[
  { "id": "notif_xxx", "type": "coupon.sync_failed", "title": "Falha ao sincronizar cupom", "readAt": null, "createdAt": "2026-07-01T09:00:00Z" },
  …
]
```

<Note>
  `dashboard` e `notifications` não têm página na aba SDK/conceitos: são específicos do painel operacional e não têm regra de negócio própria para documentar além dos campos retornados. Para o schema completo de cada resposta, consulte a [Referência da API](/docs/convencoes/ids-e-recursos).
</Note>