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

# Dashboard

> Visão geral da saúde da plataforma em tempo real — conectores, pipelines, memória, conhecimento, evals e infraestrutura em um único painel.

O **Dashboard** é a página inicial do Strattum Console após o login (`/dashboard`). Ele apresenta o estado operacional completo da plataforma organizado em três áreas principais: um banner de alertas ativos, quatro cards de saúde por camada, e uma tabela de status dos conectores configurados.

***

## Banner de Alertas

Uma barra fixa no topo da página exibe o número de problemas que requerem atenção imediata no formato **"X issues requerem atenção"**, acompanhada de um link "Ver →".

Ao clicar no link, a página ancora automaticamente no [Painel "Requer Atenção"](#painel-requer-atenção), sem navegação para outra página. O contador reflete apenas itens não descartados (dismissed).

> [!NOTE]
>
> O banner só aparece quando há pelo menos um item ativo no painel "Requer Atenção". Quando a fila está limpa, o banner não é exibido.

***

## Painel "Requer Atenção"

Lista consolidada de todos os itens que precisam de ação no momento. Cada item exibe:

| Elemento | Descrição |
| - | - |
| Ícone de severidade | Visual indicando criticidade (erro, aviso, informação) |
| Descrição | Texto explicativo do problema identificado |
| Timestamp | Quando o problema foi detectado |
| Link de ação | Atalho direto para a tela onde o problema pode ser resolvido |
| Botão de dismiss (×) | Remove o item do painel sem resolver o problema subjacente |

### Exemplos de itens típicos

* **Conector com erro** — falha de conexão ou autenticação em uma fonte de dados configurada
* **Transformação falhou** — execução dbt com erro na última run
* **Conector sem transformação** — fonte de dados ativa mas sem pipeline dbt associado
* **Entidades aguardando revisão** — entidades extraídas pelo NER que precisam de validação manual em `/memory/ner-review`

***

## Cards de Saúde (Grid 2×2)

Os quatro cards cobrem cada camada da plataforma. Cada card usa a cor da camada correspondente como acento visual.

### 1. Data Engineering

> [!NOTE]
>
> Cor de acento: indigo `#3730A3`

**KPIs principais:** número de conectores ativos e número de transformações dbt configuradas.

**Pipelines Hoje** — grid interno 2×2 com mini blocos de status coloridos:

| Dimensão | Status verde (ok) | Status vermelho (falha) |
| - | - | - |
| Conectores | Execuções bem-sucedidas | Falhas — clicável, leva para `/pipelines?status=failed&type=connector` |
| Transformações (dbt) | Execuções bem-sucedidas | Falhas — clicável, leva para `/pipelines?status=failed&type=dbt` |

**Warnings exibidos no card:**

* Conectores sem transformação associada → link "Criar" para configurar um pipeline dbt
* Violações de governança detectadas → link "Ver" para a lista de violações

***

### 2. AI Engineering

> [!NOTE]
>
> Cor de acento: violet `#6D28D9`

O card é dividido em dois painéis lado a lado:

**Painel Memory** (fundo violeta)

* Total de entidades consolidadas na base
* Chips coloridos por tipo de entidade: Pessoa, Empresa, Produto, Evento
* Status dos pipelines de entity resolution (ok / falha)

**Painel Knowledge** (fundo teal)

* Total de documentos indexados
* Total de chunks gerados
* Status dos pipelines de indexação (ok / falha)

**Warning:** entidades aguardando revisão NER → link direto para `/memory/ner-review`

**Badge positivo:** quando a fila de revisão NER está vazia por 3 ou mais dias consecutivos, o card exibe o badge **"Fila em dia"** sinalizando operação saudável.

***

### 3. Ops Engineering

> [!NOTE]
>
> Cor de acento: teal `#0D9488`

O card é dividido em dois painéis lado a lado:

**Painel Evals** (fundo teal)

* Gauge circular SVG exibindo o percentual de qualidade do contexto
* Número de suites de avaliação configuradas
* Data e hora do último eval executado

**Painel Observability** (fundo laranja)

* Custo estimado em tokens nos últimos 7 dias
* Taxa de erros em percentual
* Total de traces registrados
* Total de tokens consumidos

> [!WARNING]
>
> Evals e Observability medem a qualidade do **contexto entregue ao agente** — não o comportamento do LLM nem a qualidade das respostas. O time de dados controla o contexto; o modelo é responsabilidade do LLM provider.

**Warning:** alertas ativos de Observability → link para `/observability`

***

### 4. Infraestrutura

**KPI principal:** custo mensal em reais (R\$) com pill de tendência indicando variação percentual em relação ao período anterior (↑ aumento / ↓ redução).

**Recursos** — três gauges circulares SVG lado a lado:

| Gauge | Recurso monitorado |
| - | - |
| CPU | Uso percentual de processamento |
| Memória | Uso percentual de RAM |
| Disco | Uso percentual de armazenamento |

As cores dos gauges seguem lógica semafórica:

* **Verde** — uso abaixo de 70%
* **Amarelo** — uso entre 70% e 85%
* **Vermelho** — uso acima de 85%

***

## Seção "Pipeline de Dados"

Localizada abaixo dos quatro cards, a seção exibe uma tabela com todos os conectores configurados na plataforma.

**Colunas da tabela:**

| Coluna | Conteúdo |
| - | - |
| Conector | Nome e ícone da fonte de dados |
| Ingestão | Status visual da última execução de ingestão |
| Transformação | Status visual da última execução dbt associada |
| Destino | Destino de dados configurado |

Cada coluna de status usa indicadores visuais coloridos (verde = sucesso, vermelho = falha, cinza = não configurado ou sem execução recente).

Um botão de **refresh** no canto superior direito da seção atualiza os dados sem recarregar a página.

***

## Elementos Visuais do Dashboard

### Radial Gauges

Gauges circulares renderizados em SVG, usados nos cards de Ops Engineering (Evals) e Infraestrutura. As cores seguem a lógica semafórica: verde abaixo de 70%, amarelo entre 70–85%, vermelho acima de 85%.

### Mini Stat Blocks

Blocos compactos coloridos usados no card de Data Engineering para representar contagens de execuções:

* **Verde** — execuções bem-sucedidas
* **Vermelho** — falhas (clicáveis, com filtro pré-aplicado na URL)
* **Cinza** — estado neutro ou sem dados

### Entity Chips

Pills coloridos usados no painel Memory para categorizar entidades por tipo. Cada tipo de entidade tem uma cor distinta para identificação visual rápida.

### Warning Rows

Linhas com fundo amarelo exibidas nos cards quando há alertas ativos. Cada linha contém um ícone de aviso (⚠), texto descritivo do problema e um link direto para a ação recomendada.

***

## Arquivos de referência (codebase)

| Arquivo | Responsabilidade |
| - | - |
| `app/(app)/dashboard/page.tsx` | Página Next.js — entry point do dashboard |
| `components/dashboard/dashboard-page-client.tsx` | Client component principal — orquestra os subcomponentes |
| `components/dashboard/layer-health-cards.tsx` | Quatro cards de saúde em grid 2×2 |
| `components/dashboard/attention-panel.tsx` | Painel "Requer Atenção" e lógica de dismiss |
| `components/dashboard/data-pipeline-section.tsx` | Tabela de status dos conectores com refresh |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.