# Acionamento e Desacionamento de Atuadores

## Descrição da Interface

A funcionalidade de "Atuadores" permite o gerenciamento e controle de saídas externas dos dispositivos rastreadores instalados nos veículos. A tela está dividida em duas seções principais: "Saída 2" e "Saída 3", cada uma permitindo o acionamento e desacionamento de funcionalidades específicas em veículos selecionados.

O layout é organizado e intuitivo, com cada seção contendo um seletor de veículos, botões de ação para ativar ou desativar a saída correspondente, e um botão para acessar o histórico de acionamentos. Quando o histórico é exibido, uma tabela mostra detalhes como o tipo de comando, data/hora das operações e status.

A interface faz parte do sistema de gerenciamento de frota da plataforma CONCEPT RASTREAMENTO, acessível através de navegador web. Para acionar e/ou desacionar atuadores utilize a opção de menu CONFIGURAÇÕES e clique no icone ATUADORES.

## Elementos da Interface

### Seção Saída 2

1. **Caixa de Seleção de Veículo**
    
    
    - Tipo: Dropdown com pesquisa
    - Valores: Lista de veículos que possuem funcionalidade de Saída 2
    - Formato da exibição: Marca, Modelo, Placa, Identificação opcional (labelVeiculo) e Condutor
    - Validação: Apenas veículos com a propriedade "possuiSaida2" como verdadeira são exibidos
2. **Botões de Ação**
    
    
    - Botão "ATIVAR" 
        - Estado: Desabilitado se nenhum veículo estiver selecionado ou se não houver veículos disponíveis
        - Função: Envia comando para ativar a Saída 2 do veículo selecionado
    - Botão "DESATIVAR" 
        - Estado: Desabilitado se nenhum veículo estiver selecionado ou se não houver veículos disponíveis
        - Função: Envia comando para desativar a Saída 2 do veículo selecionado
3. **Botão Histórico**
    
    
    - Estado: Desabilitado se nenhum veículo estiver selecionado
    - Função: Busca e exibe o histórico de comandos da Saída 2 para o veículo selecionado
4. **Tabela de Histórico**
    
    
    - Visibilidade: Exibida apenas após clicar no botão Histórico e quando existem registros
    - Colunas: 
        - Comando: Tipo de comando enviado (ATIVAR/DESATIVAR)
        - Solicitado em: Data e hora da solicitação do comando
        - Enviado em: Data e hora do envio do comando
        - Executado em: Data e hora da execução do comando
        - Status: Estado do comando (EXECUTADO, CANCELADO, etc.)
        - Origem: Usuário ou sistema que originou o comando
5. **Mensagem de Resultado Zero**
    
    
    - Visibilidade: Exibida quando nenhum registro de histórico é encontrado para o veículo selecionado

### Seção Saída 3

1. **Caixa de Seleção de Veículo**
    
    
    - Tipo: Dropdown com pesquisa
    - Valores: Lista de veículos que possuem funcionalidade de Saída 3
    - Formato da exibição: Marca, Modelo, Placa, Identificação opcional (labelVeiculo) e Condutor
    - Validação: Apenas veículos com a propriedade "possuiSaida3" como verdadeira são exibidos
2. **Botões de Ação**
    
    
    - Botão "ATIVAR" 
        - Estado: Desabilitado se nenhum veículo estiver selecionado ou se não houver veículos disponíveis
        - Função: Envia comando para ativar a Saída 3 do veículo selecionado
    - Botão "DESATIVAR" 
        - Estado: Desabilitado se nenhum veículo estiver selecionado ou se não houver veículos disponíveis
        - Função: Envia comando para desativar a Saída 3 do veículo selecionado
3. **Botão Histórico**
    
    
    - Estado: Desabilitado se nenhum veículo estiver selecionado
    - Função: Busca e exibe o histórico de comandos da Saída 3 para o veículo selecionado
4. **Tabela de Histórico**
    
    
    - Visibilidade: Exibida apenas após clicar no botão Histórico e quando existem registros
    - Colunas: 
        - Comando: Tipo de comando enviado (ATIVAR/DESATIVAR)
        - Solicitado em: Data e hora da solicitação do comando
        - Enviado em: Data e hora do envio do comando
        - Executado em: Data e hora da execução do comando
        - Status: Estado do comando (EXECUTADO, CANCELADO, etc.)
        - Origem: Usuário ou sistema que originou o comando
5. **Mensagem de Resultado Zero**
    
    
    - Visibilidade: Exibida quando nenhum registro de histórico é encontrado para o veículo selecionado

## Propósito e Fluxo de Trabalho

O propósito desta tela é permitir o controle remoto de dispositivos conectados às saídas dos rastreadores veiculares. Estas saídas podem controlar diversos equipamentos ou funções, como bloqueio/desbloqueio do veículo, acionamento de sirenes, controle de câmaras frias, entre outros.

### Fluxo de trabalho típico:

1. O usuário acessa a tela de Atuadores
2. O sistema carrega automaticamente as listas de veículos que possuem funcionalidades de Saída 2 e Saída 3
3. O usuário seleciona um veículo na seção desejada (Saída 2 ou Saída 3)
4. Com um veículo selecionado, o usuário pode: 
    - Ativar a saída correspondente (enviando comando de ativação)
    - Desativar a saída correspondente (enviando comando de desativação)
    - Visualizar o histórico de comandos enviados para aquela saída daquele veículo

Após o envio de um comando, o sistema exibe uma mensagem de sucesso ou erro, dependendo do resultado da operação.

### Regras de negócio importantes:

- O sistema trata diferentemente os comandos de ativação/desativação conforme a marca do módulo rastreador. Para módulos MaxtrackMTC, o sistema inverte a lógica dos comandos (envia o comando DESACTIVATE quando o usuário clica em ATIVAR e vice-versa).
- Os comandos são assíncronos: há um tempo entre a solicitação, o envio efetivo, e a execução no veículo.
- Os registros históricos mostram todo esse ciclo de vida do comando, facilitando a auditoria e a solução de problemas.

## Instruções Passo a Passo

### Para Ativar uma Saída:

1. Acesse a tela de Atuadores
2. Na seção correspondente à saída desejada (Saída 2 ou Saída 3), clique no seletor de veículos
3. Selecione o veículo desejado na lista (apenas veículos compatíveis são exibidos)
4. Clique no botão "ATIVAR"
5. Aguarde a mensagem de confirmação do sistema

### Para Desativar uma Saída:

1. Acesse a tela de Atuadores
2. Na seção correspondente à saída desejada (Saída 2 ou Saída 3), clique no seletor de veículos
3. Selecione o veículo desejado na lista (apenas veículos compatíveis são exibidos)
4. Clique no botão "DESATIVAR"
5. Aguarde a mensagem de confirmação do sistema

### Para Visualizar o Histórico de Comandos:

1. Acesse a tela de Atuadores
2. Na seção correspondente à saída desejada (Saída 2 ou Saída 3), clique no seletor de veículos
3. Selecione o veículo desejado na lista
4. Clique no botão "Histórico"
5. Visualize a tabela com os registros de comandos para aquela saída
6. Se nenhum registro for encontrado, uma mensagem informativa será exibida

## Perguntas Frequentes

### 1. O que são as Saídas 2 e 3?

As Saídas 2 e 3 são conexões físicas nos rastreadores veiculares que permitem controlar dispositivos ou funções específicas do veículo remotamente, como bloqueio/desbloqueio, sirenes, equipamentos adicionais, entre outros.

### 2. Por que alguns veículos não aparecem na lista de seleção?

Apenas veículos equipados com rastreadores que possuem as funcionalidades de Saída 2 ou Saída 3 são exibidos nas respectivas listas. Se um veículo não aparece, provavelmente seu rastreador não suporta essa funcionalidade.

### 3. Quanto tempo leva para um comando ser executado?

O tempo varia conforme a conectividade do veículo e do rastreador. Normalmente, o comando é enviado em segundos, mas a execução efetiva depende do rastreador receber o sinal. O histórico mostra os momentos exatos de solicitação, envio e execução.

### 4. O que significam os diferentes status nos registros históricos?

- EXECUTADO: O comando foi recebido e executado pelo rastreador
- CANCELADO: O comando foi cancelado antes da execução
- Outros status podem incluir "PENDENTE" (aguardando envio) ou "ENVIADO" (aguardando confirmação de execução)

### 5. Por que meu comando não foi executado?

Várias razões podem levar à falha na execução de um comando, como:

- Problemas de comunicação com o rastreador (veículo em área sem sinal)
- Falha no próprio rastreador
- Incompatibilidade entre o comando e a configuração atual do veículo
- Dispositivo sem alimentação elétrica

### 6. É possível programar acionamentos automáticos para as saídas?

Esta interface é destinada ao acionamento manual. Para acionamentos programados ou automatizados, consulte as funcionalidades de agendamento ou regras de negócio do sistema.

### 7. Por que os botões de ativação/desativação estão desabilitados?

Os botões ficam desabilitados quando nenhum veículo está selecionado ou quando não há veículos compatíveis disponíveis para seleção.

### 8. O que acontece se eu mudar de veículo após visualizar o histórico?

Ao selecionar um novo veículo, o histórico exibido anteriormente é limpo. Para visualizar o histórico do novo veículo selecionado, é necessário clicar novamente no botão "Histórico".

## Considerações Especiais

- A interface trabalha com rastreadores de diferentes fabricantes, e alguns deles (como o MaxtrackMTC) têm comportamento invertido nos comandos, o que é tratado automaticamente pelo sistema.
- Os tempos exibidos no histórico são importantes para diagnóstico de problemas, pois mostram se houve atraso entre a solicitação e o envio, ou entre o envio e a execução.
- Para que um veículo apareça nas listas de seleção, além de possuir um rastreador compatível, é necessário que o sistema reconheça que o rastreador está ativo.
- A interface foi projetada para ser intuitiva, exibindo apenas os veículos relevantes para cada tipo de saída e desabilitando ações quando não são aplicáveis.