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

# Primeiros passos

> Como acessar o DMGTTRANS, recuperar senha, navegar no menu, usar notificações, chat institucional e perfil.

Este guia explica como acessar o sistema, navegar entre as telas e usar os recursos que facilitam o dia a dia, como notificações, chat entre unidades e salvamento automático de rascunhos.

## Como acessar o sistema

A tela de acesso esta em **Identificação do usuário**. Você deve informar sua **matrícula funcional** e sua **senha** nos campos indicados e clicar em **"Entrar no sistema"**.

Cuidado ao digitar: o campo de matrícula aceita apenas números. Se você errar a senha ou a matrícula, o sistema exibe a mensagem **"Matrícula ou senha inválida"**. Caso você tente muitas vezes seguidas, aparece a mensagem **"Muitas tentativas de login. Aguarde \[X] minuto(s) e tente novamente."**

> [!NOTE]
>
> Se aparecer a mensagem **"O relógio deste computador parece incorreto. Ajuste data e hora do Windows e tente novamente"**, verifique o relógio do seu dispositivo antes de tentar novamente.

Depois do login bem-sucedido, o sistema redireciona você para a tela inicial do seu perfil:

* Agente: recolhimentos.
* Leiloeiro: portal do leiloeiro.
* Cidadão: portal do cidadão.
* Demais: painel de visão geral.

## Recuperar ou redefinir senha

Na tela de acesso, clique em **"Esqueci minha senha"**. Informe seu **email funcional** (o email vinculado ao seu cadastro) e clique em **"Enviar link de recuperação"**. O sistema envia um email com um link. Acesse o link para criar uma nova senha. A senha deve ter pelo menos 6 caracteres.

Se você recebeu um convite para criar cadastro, o link funciona da mesma forma, mas com o texto **"Definir Senha"** e a mensagem de boas-vindas.

> [!WARNING]
>
> O link de recuperação pode expirar. Se isso acontecer, volte à tela de acesso e solicite um novo.

## Portal do cidadão: acesso e cadastro

Cidadãos acessam o sistema pelo mesmo endereço e fazem login com matrícula e senha. Se houver opção de cadastro público, ela fica disponível na tela inicial do portal. O cidadão pode acompanhar processos e abrir requerimentos sem precisar acessar as telas administrativas.

## Página inicial por perfil

Cada perfil é direcionado para a página mais relevante ao fazer login:

| Perfil | Destino após o login |
| - | - |
| Administrador / Supervisor / Servidor | Visão Geral ("/dashboard") |
| Agente | Recolhimentos ("/agent/my-recoveries") |
| Leiloeiro | Portal do leiloeiro ("/auction-partner") |
| Cidadão | Portal do cidadão ("/citizen") |

## Menu lateral, cabeçalho e navegação do agente

Para administradores, supervisores e servidores, o sistema exibe um menu lateral à esquerda com as seções: Operação, Apoio Técnico e Administração. Cada item leva a uma funcionalidade específica. O item **Processos** pode ser expandido para mostrar Caixa de Entrada, Consulta Processual e Caixa de Saída.

No topo da tela, o cabeçalho mostra o nome da funcionalidade atual (por exemplo, "Visão Geral", "Fiscalização" ou "Administração do Sistema") e o menu do usuário, onde você acessa **"Meu perfil"** e **"Encerrar sessão"**.

Agentes de campo usam um layout especial, otimizado para celular. No topo aparecem a logo, a notificação e o menu do usuário. Na parte inferior da tela, há três abas: **Recolhimentos**, **Fiscalização** e **Alcoolemia**. Toque em cada aba para alternar entre as funções.

## Notificações

No cabeçalho, clique no ícone de sino para abrir o painel de notificações. Lá aparecem alertas como:

* chegada de processos na Caixa de Entrada;
* documentos assinados;
* avisos de sucesso, alerta ou erro.

Cada notificação mostra um ícone de tipo, título, mensagem e tempo relativo (por exemplo, "há 5 minutos"). Notificações não lidas aparecem com um ponto azul.

Você pode:

* clicar em uma notificação para ir direto à tela indicada;
* clicar em **"Marcar todas como lidas"**;
* excluir notificações individualmente ou clicar em **"Limpar"** para remover todas.

O sistema também exibe o número de processos novos na Caixa de Entrada diretamente no menu lateral, ao lado de **"Caixa de Entrada"**.

## Chat institucional

O sistema disponibiliza um **chat institucional** para conversas entre unidades. Ele aparece como um botão flutuante no canto inferior direito da tela (não visível em celulares).

Ao abrir o chat, você vê a lista de conversas existentes entre unidades. Para iniciar uma nova conversa, clique no botão **"Nova conversa"**, escolha a unidade pela qual você fala e a unidade destinatária, depois clique em **"Abrir conversa"**.

Cada mensagem mostra o nome do remetente, a unidade e o horário. O histórico fica disponível por 30 dias. Se você estiver vinculado a mais de uma unidade, pode escolher por qual delas responder. O contador de mensagens não lidas aparece no botão flutuante do chat.

## Meu perfil

Acesse **"Meu perfil"** pelo menu do usuário no cabeçalho. Nessa tela você vê:

* Nome completo (pode editar);
* E-mail;
* CPF (mascarado, quando preenchido);
* Matrícula funcional;
* Perfil no sistema (Administrador, Supervisor, Servidor, Agente, Leiloeiro ou Cidadão);
* Unidades vinculadas.

Na seção **"Segurança"**, clique em **"Alterar Senha"** para redefinir sua senha.

## Rascunhos automáticos de formulário

Enquanto você preenche formulários no sistema, os valores digitados são salvos automaticamente no navegador como rascunho. Se a página travar ou for fechada, ao retornar para a mesma tela o sistema tenta repor os campos com os últimos valores informados. Isso não ocorre na lista do Pátio.

## Instalação como aplicativo (PWA e Android)

O DMGTTRANS funciona como um Progressive Web App (PWA). Isso significa que você pode instalá-lo no celular ou computador:

* No navegador Chrome ou Edge, vá em **Adicionar à tela inicial** (ou **Instalar app**).
* No iPhone, use **Compartilhar > Adicionar à Tela de Início**.

O sistema também possui um app Android nativo, gerado com Capacitor, que pode ser instalado diretamente no dispositivo do agente.

> [!TIP]
>
> Instalar o app facilita o acesso rápido e elimina a necessidade de digitar o endereço toda vez.


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