Análises
Análises unitárias realizadas a cada circulação
Análises
As análises unitárias são verificações automáticas executadas individualmente sobre cada circulação realizada. O seu principal objetivo é avaliar, de forma objetiva e consistente, a qualidade operacional de cada viagem, identificando comportamentos esperados, desvios e situações anómalas.
Cada circulação é sujeita a um conjunto de testes baseados em diferentes fontes de dados operacionais, como eventos de localização do veículo, percurso planeado, horários e validações APEX.
Estas verificações permitem confirmar se a viagem decorreu dentro dos parâmetros definidos e suportam processos de monitorização contínua da operação.
Os resultados produzidos por cada análise são classificados segundo estados normalizados, tais como:
- pass — a circulação cumpre o critério analisado;
- fail — foi identificado incumprimento ou comportamento anómalo;
- skip — não existem dados suficientes para avaliar;
- error — ocorreu um erro inesperado durante a execução.
Este modelo de avaliação contribui diretamente para o acompanhamento de SLAs (Service Level Agreements), deteção precoce de problemas operacionais, auditoria de desempenho e melhoria contínua do serviço prestado.
| Analise | Descrição |
|---|---|
| AT_LEAST_ONE_VEHICLE_EVENT_ON_FIRST_STOP | Verifica se existiu pelo menos um evento de localização do veículo na primeira paragem do percurso. |
| ENDED_AT_LAST_STOP | Verifica se a circulação terminou na última paragem prevista do percurso. |
| EXPECTED_APEX_VALIDATION_INTERVAL | Verifica se os intervalos entre validações APEX seguem o comportamento esperado. |
| EXPECTED_DRIVER_ID_QTY | Esta análise verifica se o número de motoristas associados a uma circulação (driver_ids) é coerente com a operação. |
| EXPECTED_START_TIME | Esta análise verifica se a circulação iniciou no horário previsto, comparando o tempo de início observado (start_time_observed) com o tempo de início planeado (start_time_scheduled). |
| EXPECTED_VEHICLE_EVENT_DELAY | Esta análise verifica se existe atraso excessivo entre o momento em que o evento do veículo ocorreu (created_at) e o momento em que foi recebido no sistema (received_at). |
| EXPECTED_VEHICLE_EVENT_INTERVAL | Esta análise verifica se o intervalo médio entre eventos de localização do veículo está dentro do intervalo esperado. |
| EXPECTED_VEHICLE_EVENT_QTY | Esta análise verifica se a quantidade de eventos de localização do veículo recebidos para a circulação é suficiente, comparando o número observado com o número esperado. |
| EXPECTED_VEHICLE_ID_QTY | Esta análise verifica se a circulação teve um número coerente de veículos associados. |
| MATCHING_APEX_LOCATIONS | Verifica se existem transações de localização APEX para todas as paragens do percurso da viagem (path). |
| MATCHING_VEHICLE_IDS | Verifica se os `Vehicle IDs presentes nas transações APEX (validações e/ou localizações) coincidem com os Vehicle IDs observados nos Vehicle Events da viagem. |
| SIMPLE-ONE-APEX-VALIDATION | Esta análise verifica se a circulação teve pelo menos uma validação APEX |
| SIMPLE_ONE_VEHICLE_EVENT_OR_APEX_VALIDATION | Esta análise verifica se a circulação possui algum registo mínimo de operação |
| SIMPLE_THREE_VEHICLE_EVENTS | Esta análise verifica se existem **eventos de veículo em três segmentos-chave da viagem |
| TRANSACTION_SEQUENTIALITY | Esta análise verifica se faltam transações APEX (Locations, On-board Sales, On-board Refunds e Validations) para a circulação, avaliando a sequencialidade do contador ASE por cada SAM Serial Number. |