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

# Transportes

> Cadastro, vistorias anuais e fiscalização de taxistas e mototaxistas em Gravatá/PE.

O módulo Transportes mantém o cadastro dos permissionários e veículos de transporte individual, além de organizar as vistorias anuais obrigatórias.

## Quem pode usar

| Permissão | Perfis |
| - | - |
| **transportes.read** | admin, supervisor, servidor, agente (consulta) |
| **transportes.manage** | admin, supervisor, servidor, agente (cadastros e edições) |
| **transportes.inspect** | admin, supervisor, servidor, agente (vistorias de campo) |
| **transportes.review** | admin, supervisor, servidor (revisão de vistorias enviadas) |

O menu lateral exibe **Transportes** em **Operação** para quem tem **transportes.read**.

## Visão geral

A tela principal possui duas abas:

* **Cadastros**: lista de taxistas e mototaxistas com dados da pessoa e do veículo.
* **Vistorias**: todas as vistorias do ano atual, com status e indicação de revisão pendente.

Sobre cada aba, há uma busca global por nome, inscrição, CPF, placa ou modelo, e um filtro por tipo: **Taxistas** ou **Mototaxistas**.

## Cadastros

Cada cartão mostra:

* Nome do permissionário.
* Número de inscrição.
* Placa, modelo e cor do veículo atual.
* Indicador de **"Revisão pendente"**, quando aplicável.

### Cadastro completo (dados obrigatórios)

Para a vistoria ser iniciada, todos os campos obrigatórios devem estar preenchidos:

| Campo | Descrição |
| - | - |
| Nome | Nome completo do permissionário |
| CPF/CNPJ | Documento com validação automática |
| Telefone | Com DDD; o sistema acrescenta 81 caso omitido |
| CNH | Número da habilitação |
| Validade da CNH | Data de vencimento |
| Praça/área | Área de atuação |
| Placa | Placa do veículo atual |
| Modelo | Modelo do veículo |
| Ano de fabricação | Quatro dígitos |
| Ano do modelo | Quatro dígitos |
| Cor | Selecionada de lista oficial |

**1. Abrir o cadastro**

Clique no cartão do permissionário.

**2. Completar dados**

Se o cadastro estiver incompleto, o botão **Atualizar cadastro** abre o formulário. O texto digitado é convertido automaticamente para CAIXA ALTA. Preencha todos os campos obrigatórios e clique em **Salvar cadastro**.

> [!NOTE]
>
> Alterações são registradas automaticamente na **Linha do tempo** do cadastro.

## Vistorias anuais

A vistoria deve ser feita a cada ano calendário. O status pode ser:

| Status | Condição |
| - | - |
| **Sem vistoria no ano** | Nenhuma vistoria criada para o exercício atual |
| **Em preenchimento** | Vistoria iniciada, ainda não enviada |
| **Revisão pendente** | Vistoria enviada, aguardando segundo servidor |
| **Aprovado** | Revisão aprovada |
| **Reprovado** | Revisão rejeitada |

### Como realizar a vistoria

**1. Verificar cadastro**

Se o cadastro estiver incompleto, o sistema avisa quais campos faltam.

**2. Iniciar ou continuar**

Clique em **Iniciar vistoria \[ano]** ou **Continuar vistoria \[ano]**.

**3. Responder os quesitos**

Cada quesito é agrupado por tema. Clique em **Conforme** ou **Não conforme**. Adicione observações em cada quesito quando necessário.

**4. Anexar fotos**

Use **Tirar foto** (câmera do dispositivo) ou **Escolher da galeria** (até cinco fotos).

**5. Concluir a vistoria**

Escolha o resultado: **Aprovado** ou **Reprovado**. Selecione o **Servidor responsável** de uma lista de usuários com permissão. Informe a **Senha** do servidor selecionado. Adicione observações finais e clique em **Registrar vistoria**.

> [!WARNING]
>
> A escolha do servidor responsável é protegida por senha própria. O sistema verifica a senha autenticando o usuário selecionado sem encerrar a sessão do operador atual.

### Revisão da vistoria

Vistorias aprovadas ficam com status **Revisão pendente**. Um segundo usuário com permissão **transportes.review** deve revisar.

O revisor não pode ser a mesma pessoa que realizou a vistoria.

**1. Identificar vistorias pendentes**

Em **Vistorias** ou no cadastro, veja o marcador **Revisar**.

**2. Abrir revisão**

Clique em **Revisar vistoria** e selecione o revisor.

**3. Informar senha e decisão**

Informe a senha do revisor selecionado. Escolha **Aprovar** ou **Rejeitar**. Em caso de rejeição, a justificativa é obrigatória.

> [!NOTE]
>
> Vistorias reprovadas abrem um novo ciclo. O permissionário pode ser reavaliado no mesmo ano.

## Histórico e linha do tempo

Cada cadastro exibe duas abas internas:

* **Vistorias**: lista de todas as vistorias do permissionário, inclusive histórico importado de sistema legado.
* **Linha do tempo**: registros de eventos cadastrais como alterações de dados.

## Filtros e busca

Use o campo de busca para localizar rapidamente por:

* Nome, inscrição ou CPF do permissionário.
* Placa, modelo ou cor do veículo.
* Status da vistoria.

A aba **Vistorias** mostra apenas vistorias do ano atual por padrão, com o número total exibido no cabeçalho.


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