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.

AnaliseDescrição
AT_LEAST_ONE_VEHICLE_EVENT_ON_FIRST_STOPVerifica se existiu pelo menos um evento de localização do veículo na primeira paragem do percurso.
ENDED_AT_LAST_STOPVerifica se a circulação terminou na última paragem prevista do percurso.
EXPECTED_APEX_VALIDATION_INTERVALVerifica se os intervalos entre validações APEX seguem o comportamento esperado.
EXPECTED_DRIVER_ID_QTYEsta análise verifica se o número de motoristas associados a uma circulação (driver_ids) é coerente com a operação.
EXPECTED_START_TIMEEsta 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_DELAYEsta 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_INTERVALEsta análise verifica se o intervalo médio entre eventos de localização do veículo está dentro do intervalo esperado.
EXPECTED_VEHICLE_EVENT_QTYEsta 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_QTYEsta análise verifica se a circulação teve um número coerente de veículos associados.
MATCHING_APEX_LOCATIONSVerifica se existem transações de localização APEX para todas as paragens do percurso da viagem (path).
MATCHING_VEHICLE_IDSVerifica 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-VALIDATIONEsta análise verifica se a circulação teve pelo menos uma validação APEX
SIMPLE_ONE_VEHICLE_EVENT_OR_APEX_VALIDATIONEsta análise verifica se a circulação possui algum registo mínimo de operação
SIMPLE_THREE_VEHICLE_EVENTSEsta análise verifica se existem **eventos de veículo em três segmentos-chave da viagem
TRANSACTION_SEQUENTIALITYEsta 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.

On this page