> ## 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 do agente

> Como o agente de trânsito usa o sistema no app Android em campo: menu, navegação e acesso às rotas operacionais.

Este guia é voltado ao perfil **agente** e explica como usar o sistema no celular, pelo app Android DMGTTRANS. Logo após o login, você é direcionado automaticamente para a tela **Recolhimentos**.

## Quem pode usar

* **Perfil:** agente.
* **Permissão necessária:** `agent.access`.
* **Dispositivo:** celular Android com o app DMGTTRANS instalado.

> [!NOTE]
>
> Para instalar ou atualizar o app, procure o Comando da Guarda Civil Municipal (GCM) ou a coordenação de TI.

## Menu inferior do agente

O app tem navegação por abas, fixada na parte de baixo da tela. São três botões:

| Aba | Ícone | Destino | Permissão |
| - | - | - | - |
| **Recolhimentos** | Car | `/agent/my-recoveries` | `agent.recoveries.read` |
| **Fiscalização** | Shield | `/agent/enforcement` | `agent.enforcement` |
| **Alcoolemia** | Wind | `/agent/alcoolemia` | `agent.alcoolemia` |

A aba ativada fica destacada com uma linha colorida na parte superior do botão e o plano de fundo claro.

**1. Abrir o app**

Toque no ícone **DMGTTRANS** no celular e faça login com sua matrícula e senha.

**2. Usar as abas**

Na parte inferior da tela, toque em **Recolhimentos**, **Fiscalização** ou **Alcoolemia** para alternar entre as áreas de trabalho.

**3. Acessar ações internas**

Dentro de cada aba, use os botões **Novo (+)** ou toque em um item da lista para consultar detalhes.

## Recolhimentos

Na tela **Recolhimentos** você vê:

* Uma barra de busca para filtrar por placa, modelo ou número do DRV.
* Três cards rápidos: **Total**, **No Pátio** e **Liberados**.
* Lista dos veículos recolhidos por você, ordenados do mais recente para o mais antigo.
* Um botão flutuante **(+)** para iniciar um **Novo Recolhimento**.

## Fiscalização e alcoolemia

As telas de **Fiscalização** e **Alcoolemia** seguem o mesmo layout usado no desktop, adaptado para telas pequenas. O fluxo do agente difere em poucos pontos:

* O campo **matrícula do agente** vem preenchido automaticamente com seus dados.
* O endereço da ocorrência já inicia com cidade **Gravatá** e estado **PE**.
* Em fiscalização, é possível criar três tipos de registro: **AN** (Auto de Notificação), **AI** (Auto de Infração) e **AAR** (Auto de Apreensão e Remoção).
* Em alcoolemia, o campo do agente é somente leitura e você deve selecionar o **equipamento etilômetro** ativo.

Para os detalhes de preenchimento dos formulários, consulte:

> [card] [Fiscalização](https://dmgttrans.mintlify.site/operacao/fiscalizacao.md)
>
> Campos, seções e regras dos autos de fiscalização.

> [card] [Alcoolemia](https://dmgttrans.mintlify.site/operacao/alcoolemia.md)
>
> Registro de testes de alcoolemia, equipamentos e valores medidos.

## Dados do agente no cabeçalho

No topo do app, ao tocar no avatar com suas iniciais, você abre um menu com:

* Seu nome completo.
* A legenda **Agente de Trânsito**.
* Sua matrícula.
* A opção **Meu perfil**.
* O botão **Encerrar sessão**.

> [!WARNING]
>
> Se sair do app ou ficar muito tempo inativo, será necessário fazer login novamente por segurança.

## Diferenças entre app e navegador

| Função | App Android | Navegador comum |
| - | - | - |
| Impressão de comprovantes DRV | Sim, via Bluetooth | Apenas visualização |
| Acesso à câmera | Direto pelo app | Limitado pelo navegador |
| Assinatura do cidadão em campo | Nativo via app | PWA com limitações |

> [!NOTE]
>
> A impressão térmica de comprovantes só funciona no app Android DMGTTRANS. No navegador, o sistema mostra apenas a tela do comprovante.


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