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

# Visão Geral (painel)

> Painel operacional com indicadores, atalhos e avisos institucionais.

A tela **Visão Geral** é o painel principal do sistema. Ela concentra indicadores, pendências e atalhos para as rotinas mais frequentes do dia a dia.

## Quem pode usar

> [card] Perfis com acesso
>
> Administradores, supervisores, servidores, agentes, leiloeiros e cidadãos (com visões diferenciadas).

> [card] Permissão necessária
>
> Capacidade `dashboard.view`. Agentes usam a rota própria `/agent`.

## Como acessar

No menu lateral, vá em **Operação** e clique em **Visão Geral**.

## Estrutura da tela

A tela é dividida em quatro grandes áreas, lidas de cima para baixo:

**1. Cabeçalho do painel**

Mostra o título "Visão Geral", a descrição "Dados consolidados de todas as unidades às quais você tem acesso" e o botão **"Atualizar"** (com ícone de setas circulares). Use o botão para recarregar os dados quando precisar.

**2. Requer sua atenção**

Cards coloridos que alertam sobre pendências imediatas. Cada card mostra um número destacado e um link para a área respectiva:

* **Caixa de Entrada:** quantos processos aguardam ação nas suas unidades e, em amarelo, quantos ainda não foram recebidos.
* **Minhas tarefas:** quantas tarefas estão atribuídas a você, com destaque em amarelo para prazos de hoje e em vermelho para tarefas vencidas.
* **Alertas do Pátio:** (visível apenas para quem tem `patio.read`) quantos veículos estão com prazo condicionado vencido.

> [!TIP]
>
> A cor de cada card muda conforme a gravidade: azul para atenção normal, amarelo para prazos iminentes e vermelho para situações críticas.

**3. Comandos principais**

Botões de acesso direto para criar processos, consultar processos, abrir a caixa de entrada, abrir tarefas ou registrar entrada de veículo no pátio. Apenas os botões compatíveis com o seu perfil aparecem.

**4. Painel de Avisos**

Carrossel de avisos publicados pela coordenação. Avisos ativos rolam automaticamente a cada 7 segundos. Se houver apenas um aviso, ele fica fixo.

## Painel de Avisos

O Painel de Avisos exibe comunicados institucionais. Cada aviso mostra:

* **Título**
* **Conteúdo** (links dentro do texto são clicáveis)
* **Data de publicação**
* **Data de expiração**, quando houver
* **Grau de importância:** Baixa, Normal, Alta ou Crítica

### Para quem publica avisos

Quem possui a capacidade `announcements.manage` (geralmente administradores e supervisores) vê todos os avisos, inclusive os inativos ou expirados, e pode:

* Clicar em **"Novo Aviso"** para criar um comunicado
* Editar um aviso existente (ícone de lápis)
* Ativar ou desativar um aviso (chave de alternância)
* Excluir um aviso (ícone de lixeira)

> [!WARNING]
>
> Avisos inativos ou expirados não aparecem para os demais usuários.

### Criando um aviso

**1. Abrir o formulário**

Clique em **"Novo Aviso"** no canto superior direito do Painel de Avisos.

**2. Preencher os campos**

* **Título:** obrigatório
* **Conteúdo:** obrigatório; links digitados diretamente ficam clicáveis
* **Importância:** Baixa, Normal, Alta ou Crítica
* **Validade (opcional):** data em que o aviso deixa de ser exibido automaticamente

**3. Salvar**

Clique em **"Criar"**. O aviso entra no carrossel imediatamente.

## Resumo da unidade

Na parte inferior, há duas colunas:

| Coluna | Conteúdo |
| - | - |
| **Processos recentes** | Lista os 5 processos mais atualizados das suas unidades, com número, assunto, status e data/hora da última modificação. Clique em qualquer processo para abrir sua página de detalhe. |
| **Resumo da unidade** | Métricas compactas: processos ativos, processos pendentes, veículos no pátio (se visível) e alertas operacionais. Administradores também veem a distribuição por unidade. |

> [!NOTE]
>
> A seção "Mais informações" (expansível na parte inferior) oferece acesso à Agenda completa no módulo Tarefas, além da distribuição de processos por unidade para administradores.


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