TripSchedule

​

Campos

​

Relacionamentos

• Relaciona-se com Cooperative.
• Relaciona-se com TransportOperator.
• Relaciona-se com Route.
• Relaciona-se com Vehicle.
• Relaciona-se com Driver.
• Relaciona-se com múltiplos TripScheduleStop.
• Relaciona-se com múltiplos TripScheduleItinerary.

​

Regras de Negócio

• Template recorrente que materializa Trip futuras vendáveis em um horizonte móvel de 90 dias (ver Trip Schedules).
• A materialização é idempotente: a chave cooperativeId + transportOperatorId + departureAt + routeId + vehicleId + driverId evita duplicar a mesma viagem.
• A programação deve validar rota ativa, TransportOperator autorizado, motorista vinculado e veículo autorizado antes de materializar novas Trips.
• Criar Trip futura não consome cota. Cota só é reservada ao iniciar e consumida ao concluir a Trip.
• Uma rotina diária re-materializa as programações ACTIVE, estendendo a cobertura conforme o tempo avança.
• Apenas o name é editável; o estado muda via operações dedicadas (pause/resume/delete).

​

Enums

​

TripScheduleFrequency

​

TripScheduleStatus

​

Example

{
  "tripScheduleId": "0197a80d-92d8-7c7a-a1b2-2a745fa19e11",
  "cooperativeId": "0197a800-24e6-76a2-90ed-ff0f6fba7b0c",
  "transportOperatorId": "01980d30-6a3c-7a42-9182-17ad6324d3aa",
  "routeId": "0197a80c-4204-7b77-9005-48cc23677587",
  "vehicleId": "0197a809-3eb8-7eb8-9c4f-8a6c2e7e5b1a",
  "driverId": "0197a807-1ec7-75e8-8ff8-df64dd070046",
  "name": "São Paulo para Ribeirão Preto - manhã",
  "frequency": "DAILY",
  "interval": 1,
  "status": "ACTIVE",
  "departureAt": "2026-07-04T08:00:00.000Z",
  "endAt": null,
  "createdBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "createdAt": "2026-07-03T15:20:00.000Z",
  "updatedBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "updatedAt": "2026-07-03T15:20:00.000Z",
  "deletedBy": null,
  "deletedAt": null
}