Trip

​

Campos

​

Relacionamentos

• Relaciona-se com Cooperative por cooperativeId.
• Relaciona-se com TransportOperator por transportOperatorId.
• Relaciona-se opcionalmente com TripSchedule por tripScheduleId.
• Relaciona-se com Route por routeId.
• Relaciona-se com Vehicle por vehicleId.
• Relaciona-se com Driver por driverId.
• Relaciona-se com múltiplos Ticket.
• Relaciona-se com múltiplos TripStop.
• Relaciona-se com múltiplos TripItinerary.
• Relaciona-se com múltiplos TripEvent.
• Relaciona-se com múltiplos TripSeatSegment.
• Relaciona-se com múltiplos TripReview.
• Relaciona-se 1:1 com TripTracking.

​

Regras de Negócio

• Representa uma partida programada de uma rota aprovada.
• A Trip é materializada pela cooperativa, de forma avulsa ou a partir de uma TripSchedule.
• tripScheduleId fica null em viagens avulsas e preenchido quando a Trip nasceu de uma programação recorrente.
• A chave cooperativeId + transportOperatorId + departureAt + routeId + vehicleId + driverId identifica uma viagem materializada e evita duplicidade.
• Antes de iniciar, o sistema deve validar:
  • rota ACTIVE;
  • TransportOperator autorizado na rota via TransportOperatorRoute;
  • TransportOperator regular;
  • veículo ativo e autorizado via VehicleTransportOperator;
  • motorista com CNH válida e vínculo ativo via DriverTransportOperator;
  • limite disponível na TransportOperatorRoutePolicy vigente.
• Trip criada ou agendada não consome cota.
• Trip iniciada pode reservar cota.
• Trip concluída consome cota definitiva e pode gerar cálculo de subsídio por km.
• Trip cancelada libera reserva de cota e não consome cota definitiva.
• Horários reais de execução devem ser derivados da sequência de TripStop, não duplicados na Trip.
• Quilometragem executada deve ser derivada de TripTrackingPoint ou do fechamento auditado em TransportOperatorSubsidySettlement, conforme a política vigente.
• O último ping GPS aceito fica em TripTracking.
• Trip não guarda campos de tracking diretamente.
• A Trip só deve aceitar atualização de tracking enquanto status = IN_PROGRESS.
• Se o app do motorista parar de enviar localização por tempo acima da tolerância operacional, TripTracking.acceptedAt fica como fonte para detectar tracking desatualizado.

​

Enums

​

TripStatus

​

Example

{
  "tripId": "0197a80f-2d8f-7710-b243-b67fb477a1c0",
  "cooperativeId": "0197a800-24e6-76a2-90ed-ff0f6fba7b0c",
  "transportOperatorId": "01980d30-6a3c-7a42-9182-17ad6324d3aa",
  "tripScheduleId": "0197a80d-92d8-7c7a-a1b2-2a745fa19e11",
  "routeId": "0197a80c-4204-7b77-9005-48cc23677587",
  "vehicleId": "0197a809-3eb8-7eb8-9c4f-8a6c2e7e5b1a",
  "driverId": "0197a807-1ec7-75e8-8ff8-df64dd070046",
  "departureAt": "2026-07-04T08:00:00.000Z",
  "estimatedArrivalAt": "2026-07-04T12:30:00.000Z",
  "status": "IN_PROGRESS",
  "createdBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "createdAt": "2026-07-03T15:30:00.000Z",
  "updatedBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "updatedAt": "2026-07-03T15:30:00.000Z",
  "deletedBy": null,
  "deletedAt": null
}