Skip to main content
O TripReview representa a avaliação de uma Trip comprada dentro de um Order. O Order define a elegibilidade da compra; a Trip é a experiência avaliada.

Campos

CampoTipoDescrição
tripReviewIdUUIDIdentificador único
tripIdUUIDViagem avaliada
orderIdUUIDPedido que originou a viagem avaliada
customerIdUUIDCliente que avaliou
driverIdUUIDMotorista avaliado
companyIdUUIDEmpresa avaliada
driverRatingIntNota do motorista (1 a 5)
driverCommentString?Comentário sobre o motorista
companyRatingIntNota da empresa (1 a 5)
companyCommentString?Comentário sobre a empresa
createdByUUID?Usuário que criou o registro, quando aplicável
createdAtDateTimeData de criação
updatedByUUID?Usuário que fez a última atualização, quando aplicável
updatedAtDateTimeData da última atualização

Relacionamentos

  • Relaciona-se com Customer
  • Relaciona-se com Trip
  • Relaciona-se com Order
  • Relaciona-se indiretamente com Checkout via Order.checkoutId
  • Relaciona-se com Driver
  • Relaciona-se com Company
  • Pode originar SupportCase, quando o passageiro usa o botão de contato na revisão

Regras de Negócio

  • Registro único por viagem dentro do pedido: tripId + orderId deve ser único.
  • Um Order pode ter múltiplos TripReviews, um para cada Trip comprada.
  • Um checkout pode ter múltiplos TripReviews indiretamente pelos Orders gerados.
  • checkoutId não deve ser duplicado nesta entidade; ele é derivado por orderId -> Order.checkoutId.
  • A avaliação cobre a experiência daquela Trip.
  • Cada nota (rating) é um inteiro de 1 a 5.
  • Só pode ser criada quando o pedido está PAID, possui um ticket VALID da mesma Trip já embarcado e a Trip está COMPLETED.
  • A resposta/tratativa operacional da avaliação não fica em TripReview. Quando o passageiro usa o botão de contato, o atendimento deve ser registrado em SupportCase com relatedTripReviewId.
Veja o fluxo de elegibilidade em Trip Review.

Example

{
  "tripReviewId": "0197a815-0fcf-704b-b703-f460b25515d4",
  "tripId": "0197a80f-2d8f-7710-b243-b67fb477a1c0",
  "orderId": "0197a813-0fb9-7d42-9c81-50c0f6d9ae5a",
  "customerId": "0197a7f6-4d36-7c0a-a7cb-54fcb33a3148",
  "driverId": "0197a807-1ec7-75e8-8ff8-df64dd070046",
  "companyId": "0197a801-6a42-79aa-9e56-d3c85148c0fa",
  "driverRating": 5,
  "driverComment": "Motorista pontual e cuidadoso.",
  "companyRating": 4,
  "companyComment": "Viagem confortável e bem organizada.",
  "createdBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "createdAt": "2026-07-04T13:10:00.000Z",
  "updatedBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "updatedAt": "2026-07-04T13:10:00.000Z"
}