TripTrackingPoint

​

Campos

​

Relacionamentos

• Relaciona-se com Trip.
• Relaciona-se com TripTracking, quando o ponto também atualiza o último ping.
• Relaciona-se com Cooperative.
• Relaciona-se com TransportOperator.
• Relaciona-se com Driver.

​

Regras de Negócio

• Cada ping GPS aceito cria um TripTrackingPoint.
• TripTrackingPoint é append-only: não deve ser atualizado para corrigir trajeto.
• sequence deve ser incremental por tripId.
• acceptedAt ordena o histórico quando houver diferença entre relógio do dispositivo e backend.
• O histórico só recebe pings quando a Trip está IN_PROGRESS.
• Pings rejeitados por status, coordenada inválida ou autorização não entram no histórico aceito.
• cooperativeId, transportOperatorId e driverId devem repetir o contexto da Trip no momento do aceite.
• O último TripTrackingPoint aceito deve refletir os mesmos dados do TripTracking da Trip.
• Retenção, compactação ou arquivamento de pontos antigos deve preservar a rastreabilidade exigida pela operação.

​

Example

{
  "tripTrackingPointId": "01980e33-5bf9-7c09-9f18-c0e7d87b7d12",
  "tripId": "0197a80f-2d8f-7710-b243-b67fb477a1c0",
  "tripTrackingId": "0197a812-12e1-77fb-a2d1-b6fbf0570f89",
  "cooperativeId": "0197a800-24e6-76a2-90ed-ff0f6fba7b0c",
  "transportOperatorId": "01980d30-6a3c-7a42-9182-17ad6324d3aa",
  "driverId": "0197a807-1ec7-75e8-8ff8-df64dd070046",
  "latitude": -23.55052,
  "longitude": -46.63331,
  "accuracyMeters": 12,
  "speedKmh": 42.7,
  "headingDegrees": 126.4,
  "source": "DRIVER_APP_BACKGROUND",
  "recordedAt": "2026-07-04T08:15:08.000Z",
  "acceptedAt": "2026-07-04T08:15:10.000Z",
  "sequence": 42,
  "createdAt": "2026-07-04T08:15:10.000Z"
}