Trip Review

A TripReview é a avaliação que o cliente faz após uma viagem. É um registro único por tripId + orderId. O Order prova a compra. A Trip é a experiência avaliada.

Elegibilidade

O cliente só pode avaliar quando todas as condições abaixo são verdadeiras:

Condição	Erro se falhar
Pedido pertence ao cliente e está pago (`PAID`)	`trip_review.not_eligible`
Ainda não existe avaliação para `tripId + orderId`	`trip_review.already_reviewed`
Há um ticket `VALID` do Order para a Trip com `boardedAt` preenchido	`trip_review.not_eligible`
A Trip avaliada está `COMPLETED`	`trip_review.not_eligible`

Ao buscar um pedido pelo app, a resposta indica se a avaliação está disponível e quais alvos devem aparecer (includeTransportOperator, includeDriver).

Alvos da avaliação

Motorista e permissionário são derivados da Trip avaliada (driverId, transportOperatorId).
Cada nota (rating) é um inteiro de 1 a 5. Comentários são opcionais.
A avaliação é sobre a experiência da Trip.

Fluxo

Ao registrar a avaliação, o pedido retorna com o review anexado.

Resposta oficial da cooperativa

A cooperativa responsável pela operação pode registrar uma resposta oficial na própria TripReview. Essa resposta é direta, pública e materializada junto com a avaliação. Ela pode aparecer no OPS e nas superfícies que exibirem avaliações.

PUT /api/v1/ops/trip-reviews/{tripReviewId}/cooperative-response

{
  "message": "Obrigado pelo feedback. A cooperativa já orientou o permissionário responsável."
}

Regras:

Apenas usuário OPS com acesso à cooperativa da Trip pode responder.
Uma TripReview possui no máximo uma resposta oficial ativa.
Reenviar a resposta substitui o texto anterior e atualiza respondedAt.
A resposta oficial não abre chamado e não substitui o atendimento privado.

Fronteira com SupportCase

Resposta oficial e SupportCase resolvem problemas diferentes:

Fluxo	Uso
Resposta oficial da cooperativa	Posicionamento público e direto dentro da avaliação.
SupportCase	Tratativa privada, conversa operacional, anexos e acompanhamento do atendimento.

Quando o passageiro precisa conversar com atendimento, o botão de contato cria ou abre um SupportCase com relatedTripReviewId.

Moderação

Moderação controla a visibilidade e a curadoria da avaliação.

PATCH /api/v1/ops/trip-reviews/{tripReviewId}/moderation

{
  "status": "HIDDEN",
  "reason": "Comentário ofensivo"
}

Status	Regra
`VISIBLE`	Avaliação visível normalmente.
`FLAGGED`	Avaliação marcada para revisão operacional.
`HIDDEN`	Comentários ficam ocultos nas superfícies públicas.

Notas continuam disponíveis para análise interna. A regra de excluir ou não notas moderadas dos relatórios deve ser decidida pelo filtro moderationStatus no endpoint de tendências.

Regras de curadoria:

Moderação não apaga a TripReview.
HIDDEN oculta comentários públicos, mas preserva notas para análise interna.
FLAGGED mantém a avaliação visível conforme regra de produto, mas sinaliza revisão operacional.
Toda moderação deve registrar usuário, motivo e data.
Histórico de atendimento privado continua em SupportCase, não em TripReview.

Estatísticas e tendências

OPS pode consultar agregações de avaliações para gerar gráficos e tabelas.

GET /api/v1/ops/reports/trip-reviews?range=>=2026-07-01;<=2026-07-31&groupBy=day

Filtros:

Query	Uso
`range`	Período de criação da avaliação.
`groupBy`	Agrupamento da série: `day`, `week` ou `month`.
`cooperativeId`	Filtra avaliações de uma cooperativa.
`transportOperatorId`	Filtra avaliações de um permissionário.
`driverId`	Filtra avaliações de um motorista.
`rating`	Filtra notas por intervalo, por exemplo `<=2`.
`moderationStatus`	Filtra por `VISIBLE`, `FLAGGED` ou `HIDDEN`.
`limit`	Limite de itens em rankings.

Indicadores esperados:

Indicador	Uso
Total de avaliações	Volume recebido no período.
Média por motorista	Ranking e acompanhamento de qualidade do motorista.
Média por permissionário	Ranking e acompanhamento da operação executada.
Baixas avaliações	Detecção de pontos críticos.
Respondidas	Acompanhamento de resposta da cooperativa.
Moderadas/ocultas	Controle de curadoria.

Exemplo de resposta:

{
  "summary": {
    "totalReviews": 128,
    "averageDriverRating": 4.6,
    "averageTransportOperatorRating": 4.3,
    "lowRatingCount": 9,
    "respondedCount": 42,
    "hiddenCount": 3
  },
  "series": [
    {
      "date": "2026-07-01",
      "totalReviews": 12,
      "averageDriverRating": 4.7,
      "averageTransportOperatorRating": 4.5,
      "lowRatingCount": 1
    }
  ],
  "drivers": [
    {
      "driverId": "0197a807-1ec7-75e8-8ff8-df64dd070046",
      "driverName": "João Motorista",
      "totalReviews": 34,
      "averageRating": 4.8,
      "lowRatingCount": 2
    }
  ],
  "transportOperators": [
    {
      "transportOperatorId": "0197a801-6a42-79aa-9e56-d3c85148c0fa",
      "transportOperatorName": "Permissionário Norte",
      "totalReviews": 52,
      "averageRating": 4.2,
      "lowRatingCount": 5,
      "respondedCount": 18
    }
  ]
}

Contato a partir da avaliação

O passageiro pode iniciar atendimento a partir da avaliação usando o botão de contato da revisão. Esse fluxo é diferente da resposta oficial da cooperativa. A conversa operacional privada fica em SupportCase. Quando o contato nasce da avaliação, o chamado deve referenciar:

relatedTripReviewId: avaliação que originou o contato.
relatedOrderId: pedido que deu elegibilidade para a review.

Visão geral

Authorization

Benefits

Billing

Communication

Credit Grant

Export

Fleet

Identity

Observability

Operations

Platform

Sales

Support

Tenant

Elegibilidade

Alvos da avaliação

Fluxo

Resposta oficial da cooperativa

Fronteira com SupportCase

Moderação

Estatísticas e tendências

Contato a partir da avaliação

​Elegibilidade

​Alvos da avaliação

​Fluxo

​Resposta oficial da cooperativa

​Fronteira com SupportCase

​Moderação

​Estatísticas e tendências

​Contato a partir da avaliação

Elegibilidade

Alvos da avaliação

Fluxo

Resposta oficial da cooperativa

Fronteira com SupportCase

Moderação

Estatísticas e tendências

Contato a partir da avaliação