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

# Pátio

> Controle de veículos apreendidos: entrada, fotos, irregularidades, liberação e cancelamentos de DRV.

O módulo **Pátio** gerencia o ciclo completo dos veículos apreendidos, desde o registro do recolhimento até a liberação ou leilão.

## Quem pode usar

| Perfil | Permissões no pátio |
| - | - |
| Administrador | Leitura, gestão, dados financeiros, revisão de cancelamentos e liberação com override |
| Supervisor | Leitura, gestão, dados financeiros e revisão de cancelamentos |
| Servidor | Leitura e gestão (entrada de veículos, liberações) |
| Agente | Registra recolhimentos pelo app mobile; consulta seus próprios veículos |

A capacidade `patio.read` abre a tela de lista. `patio.manage` permite registrar entrada. `patio.financial.read` exibe dados de arrecadação. `patio.cancellations.review` habilita a aba de cancelamentos de DRV.

## Como acessar

No menu lateral, vá em **Operação** e clique em **Pátio**.

## Tela principal (lista de veículos)

Ao abrir o Pátio, você vê:

1. **Botão "Registrar Entrada"**: inicia o cadastro de um novo veículo recolhido.
2. **Abas** (para quem tem `patio.cancellations.review`):
   * **Veículos:** lista todos os veículos do pátio.
   * **Cancelamentos DRV:** fila de solicitações de cancelamento de Documento de Remoção Veicular.
3. **Cards de indicadores:**
   * **Total no Pátio**
   * **Lib. Condicionada**
   * **Prazo Vencido**
   * **Arrecadação** (visível apenas para quem tem `patio.financial.read`)

### Filtros da lista

> [accordion] Filtros de busca e status
>
> * **Campo de busca:** pesquise por placa, chassi, número do DRV, modelo, cor ou descrição.
> * **Status:** Todos, Aguardando recebimento, No Pátio, Lib. Condicionada, Liberado ou Leiloado.
> * **Datas:** filtre por período de entrada no pátio e/ou por período de recolhimento.
> * **Exibir DRVs cancelados:** checkbox para incluir veículos cujo DRV foi cancelado.

> [accordion] Período de arrecadação (admin/supervisor)
>
> Seletor com três opções: **Mês atual**, **Total geral** ou **Período personalizado** (com campos "De" e "Até").

### Cards de veículos

Cada veículo aparece como um card clicável com:

* Placa (ou "Não registrado" / "SUCATA")
* Número do DRV
* Status (badge colorido)
* Marca/modelo, cor e chassi
* Dias no pátio e data de entrada
* Valor em aberto (para quem vê financeiro)
* Quantidade de pendências (irregularidades não resolvidas)
* Destaque vermelho na borda esquerda quando o prazo condicionado está vencido

**1. Acessar o detalhe**

Clique no card do veículo para abrir a tela de detalhe, onde é possível gerenciar pagamentos, irregularidades, liberações e histórico.

## Registrar entrada de veículo

**1. Iniciar**

Clique em **"Registrar Entrada"** na tela principal do Pátio ou no botão de comando rápido do painel.

**2. Preencher o formulário**

O formulário é dividido em seções. Campos com asterisco são obrigatórios.

**Dados do Recolhimento**

* Matrícula e nome do agente (pré-preenchidos)
* Data e hora do recolhimento
* Endereço completo (logradouro, número, bairro, complemento, cidade, UF)
* Pátio de destino
* Opção **"DRV antigo"** para veículos recolhidos antes da digitalização

**Identificação do Veículo** Escolha o **status de registro**:

* **Normal:** veículo com placa brasileira regular
* **Não registrado:** sem placa; obrigatório informar chassi ou número do motor
* **Estrangeiro:** placa de outro país
* **Sucata:** veículo baixado; preenchimento reduzido

Preencha placa, UF da placa, tipo de veículo, marca/modelo, cor, ano de fabricação, RENAVAM, chassi e número do motor (conforme aplicável).

**Proprietário e Condutor**

* Nome e CPF do proprietário
* Checkbox "Proprietário é o condutor"
* Se não for, nome e documento do condutor (CPF, CNH ou RG)
* Checkbox "Condutor não identificado"

**Motivo do Recolhimento**

* Motivo (lista padrão ou "Outros")
* Amparo legal
* Informações adicionais

**Estado Geral do Veículo**

* Odômetro (ou "Não verificado")
* Nível de combustível
* Situação da lataria, pintura e pneus
* Equipamentos faltantes ( lista pré-definida com checkboxes)
* Equipamentos de som
* Observações

**Pertences**

* Chave, documentos e outros pertences

**Serviço de Remoção**

* Tipo: próprio, contratado ou outro
* Nome da transportadora (quando contratado)
* Responsável pela remoção

**Irregularidades** Lista pré-definida (licenciamento atrasado, IPVA em atraso, placa adulterada etc.) com checkboxes, além de campo para adicionar irregularidades livres. O sistema adiciona automaticamente irregularidades de acordo com o estado do veículo (por exemplo, pneu careca ou furado).

**Fotos** Utilize o componente de upload para anexar fotos do veículo. As imagens ficam armazenadas na galeria do veículo.

**3. Salvar**

Clique em **"Registrar Entrada"** no final do formulário. O sistema valida todos os campos obrigatórios e cria o registro do veículo.

> [!WARNING]
>
> Veículos com status "Sucata" recebem custos zerados automaticamente e não podem voltar a circular.

## Detalhe do veículo

A tela de detalhe exibe abas com informações completas:

> [accordion] Informações gerais
>
> Placa, status atual, dados do recolhimento, destino, tempo de permanência e valor total em aberto (quando aplicável).

> [accordion] Fotos
>
> Galeria de imagens na grade de fotos do pátio. Clique em qualquer imagem para ampliar.

> [accordion] Pagamentos
>
> Histórico de pagamentos recebidos, com data, valor e tipo. Quem tem permissão financeira também registra novos pagamentos aqui.

> [accordion] Irregularidades
>
> Lista de irregularidades com status "Pendente" ou "Resolvida". É possível adicionar novas irregularidades e alterar o status das existentes.

> [accordion] Liberações
>
> Histórico de todas as liberações (definitivas e condicionadas) vinculadas ao veículo.

> [accordion] Histórico
>
> Linha do tempo de todas as ações realizadas sobre o veículo, com data, hora e nome do responsável.

## Liberação de veículo

A liberação só é possível quando o veículo está com status "No Pátio".

**1. Selecionar a autorização**

Na aba de liberação do detalhe do veículo, escolha a **autorização de liberação** previamente emitida no módulo de processos/documentos.

**2. Informar o recebedor**

Preencha o nome e o CPF/CNPJ da pessoa que retira o veículo.

**3. Coletar assinatura**

O sistema oferece duas formas:

* **Assinatura do cidadão:** envia notificação para assinatura eletrônica
* **Assinatura física:** anexe o PDF do termo assinado manualmente
* **Sem assinatura:** para casos excepcionais, desde que seu perfil permita

**4. Confirmar a saída**

Clique em **"Confirmar Liberação"**. O status do veículo muda para "Liberado" (saída definitiva) ou "Lib. Condicionada" (saída com prazo de retorno).

> [!NOTE]
>
> Liberações condicionadas exigem um prazo de retorno definido no documento de autorização. Se o veículo não retornar até a data estipulada, o sistema gera alerta no painel e na lista do pátio.

## Cancelamento de DRV

O cancelamento de DRV segue um fluxo com aprovação de supervisor:

**1. Solicitar**

Na tela de detalhe do veículo, clique em **"Solicitar Cancelamento de DRV"**. Preencha o motivo com no mínimo 10 caracteres e confirme.

**2. Análise**

O status do veículo muda para "Cancelamento pendente". O supervisor recebe a solicitação na aba **Cancelamentos DRV**.

**3. Decisão**

O supervisor pode **Aprovar** ou **Negar** a solicitação. Em caso de recusa, deve informar o motivo. O agente solicitante recebe notificação do resultado.

| Status do veículo | Significado |
| - | - |
| Ativo | DRV válido |
| Cancelamento pendente | Aguardando aprovação do supervisor |
| Cancelado | DRV cancelado; o veículo pode ser ocultado da lista principal |

> [!WARNING]
>
> Veículos com DRV cancelado aparecem com opacidade reduzida na lista e com uma borda cinza à esquerda. Somente quem ativa o filtro "Exibir DRVs cancelados" os vê.

## Status dos veículos no pátio

| Status | Descrição |
| - | - |
| Aguardando recebimento | Recolhimento registrado, mas veículo ainda não chegou ao pátio |
| No Pátio | Veículo recebido e sob custódia |
| Lib. Condicionada | Veículo liberado temporariamente com prazo de retorno |
| Liberado | Veículo retirado definitivamente |
| Leiloado | Veículo encaminhado para leilão |


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