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

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

***

## 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`
</Note>

**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`
</Note>

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`
</Note>

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>

**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              |