TripReview

​

Campos

​

Relacionamentos

• Relaciona-se com Customer.
• Relaciona-se com Trip.
• Relaciona-se com Order.
• Relaciona-se indiretamente com Checkout via Order.checkoutId.
• Relaciona-se com Cooperative.
• Relaciona-se com TransportOperator.
• Relaciona-se com Driver.
• Relaciona-se com User, quando houver resposta ou moderação.
• 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.
• cooperativeId, transportOperatorId e driverId devem repetir os dados da Trip avaliada.
• overallRating é obrigatório para consolidar satisfação geral da viagem.
• vehicleRating deve ser usado quando a avaliação separar qualidade do veículo da avaliação do permissionário.
• A cooperativa da Trip pode registrar uma resposta oficial em cooperativeResponseMessage.
• A resposta oficial é pública, direta e materializada na TripReview.
• Conversa operacional privada continua em SupportCase com relatedTripReviewId.
• Uma TripReview possui no máximo uma resposta oficial ativa; novas respostas substituem a anterior.
• Moderação controla visibilidade de comentários e curadoria, sem apagar a avaliação.
• Moderação deve preservar notas para análise interna, mesmo quando comentários públicos forem ocultados.
• Estatísticas e tendências devem considerar moderationStatus, respondedAt, driverRating e transportOperatorRating.

​

Enums

​

TripReviewModerationStatus

​

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",
  "cooperativeId": "0197a800-24e6-76a2-90ed-ff0f6fba7b0c",
  "transportOperatorId": "01980d30-6a3c-7a42-9182-17ad6324d3aa",
  "driverId": "0197a807-1ec7-75e8-8ff8-df64dd070046",
  "overallRating": 5,
  "driverRating": 5,
  "driverComment": "Motorista pontual e cuidadoso.",
  "transportOperatorRating": 4,
  "transportOperatorComment": "Viagem confortável e bem organizada.",
  "vehicleRating": 4,
  "overallComment": "Experiência geral muito boa.",
  "cooperativeResponseMessage": "Obrigado pelo feedback. A cooperativa já orientou o permissionário responsável.",
  "respondedByCooperativeId": "0197a800-24e6-76a2-90ed-ff0f6fba7b0c",
  "respondedByUserId": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "respondedAt": "2026-07-04T14:20:00.000Z",
  "moderationStatus": "VISIBLE",
  "moderationReason": null,
  "moderatedByUserId": null,
  "moderatedAt": null,
  "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"
}