Usa el contrato de reseñas revisado

Driver App puede mostrar un formulario de reseña del cliente para algunos pedidos individuales anteriores. La visibilidad del control, una calificación seleccionada, el texto local de éxito y una acción oculta son distintos de la autorización, la persistencia aceptada, la publicación, la moderación, los informes o la finalización del plugin.

Aquí no se confirma el envío de reseñas ni sus efectos sobre duplicados, plugins, clientes o pedidos agrupados.

Disponibilidad

Superficie	Límite público actual
Acción individual	Puede aparecer para un pedido anterior configurado que cumpla las comprobaciones locales de visibilidad, tenga cliente y no tenga un objeto de reseña con valor verdadero; la elegibilidad de API se determina por separado.
Calificación existente	Se puede mostrar si la calificación tiene valor verdadero; un objeto de reseña puede ocultar la acción sin mostrar una calificación.
Entrada de calificación	La interfaz ofrece opciones del uno al cinco; el valor local inicial es inferior al mínimo aceptado.
Comentarios	Los comentarios rápidos según la calificación y el texto libre opcional forman un único comentario de solicitud.
Duplicado	La investigación del servidor rechaza una reseña existente para el mismo pedido/relación.
Plugins	La persistencia y los filtros/acciones de plugins son etapas distintas de resolución.
Reseña de grupo	Existe código fuente, pero la composición aceptada de Driver oculta el control de forma predeterminada.

Requisitos previos

• Exige un Driver autenticado, una relación autorizada entre pedido individual y cliente, un estado de pedido anterior compatible y ninguna reseña coincidente previa.
• Exige una calificación dentro del rango aceptado antes de enviar cualquier solicitud.
• Trata la identidad del cliente, calificación, comentarios, relación con el pedido y respuesta como datos privados y limitados al propósito.
• Desactiva el envío repetido y conserva un estado veraz de pendiente/error/resultado.
• Mantén las escrituras de reseñas, plugins, eventos, avisos, sockets y publicación fuera de la ejecución de documentación.

Límites de responsabilidad

Responsable	Responsabilidad
Interfaz de detalles	Decidir si mostrar candidatos según los campos de pedido/reseña devueltos.
Modal de reseña	Estado de calificación/comentario, texto de privacidad, validación y presentación de pendiente/error.
Controlador del cliente	Enviar una intención y conciliar la respuesta antes del evento/cierre local.
Contrato de reseñas de API	Validar la existencia del pedido, relación Driver/cliente, calificación mínima y duplicados.
Responsables de plugins/informes	Moderar, filtrar, publicar, informar o activar pasos posteriores a la persistencia.
Responsable de grupos	Definir comportamiento de reseñas atómico o por integrante; el control actual permanece inactivo.

Entradas y resultados

El modal individual combina la calificación seleccionada, cero o más comentarios rápidos y texto libre opcional. El control Enviar actual puede seguir siendo pulsable con una calificación inicial no válida y mientras carga; que la interfaz permita pulsarlo no equivale a validación ni protección contra duplicados.

La investigación de API aceptada valida la relación entre Driver y cliente del pedido, la calificación mínima y la reseña coincidente previa. Después, una respuesta del cliente que parece correcta puede mostrar un aviso, emitir un evento local, cerrar el modal y combinar el estado local del pedido. Esos pasos posteriores no demuestran resolución del plugin, moderación, publicación, informes, ejecución única ni persistencia en un despliegue.

Seguridad y privacidad

• Valida del lado del servidor a quien reseña, al cliente destinatario, la relación con el pedido, la calificación mínima y la duplicación antes de persistir.
• No incluyas en los comentarios datos de contacto, detalles de salud/seguridad, información de pago, direcciones, credenciales ni datos innecesarios del pedido.
• No publiques códigos privados de estado, endpoints, cargas, identificadores, tokens, medios del cliente, configuración de plugins ni detalles de pruebas de seguridad.
• Haz idempotentes las solicitudes repetidas o concilia explícitamente duplicados y fallos parciales de plugins.
• Considera las estrellas locales, el aviso, el cierre del modal y la acción oculta solo elementos de presentación.

Límites y estados de fallo

Estado	Interpretación requerida
Acción visible	Solo es un candidato del cliente; la relación/duplicación aún puede fallar.
Acción ausente	Un objeto, categoría, cliente o estado local existente puede ocultarla.
No se ve ninguna estrella	No demuestra que no exista un objeto de reseña.
Calificación inicial	No cumple el mínimo aceptado por el servidor.
Botón pulsable durante la carga	No se ha establecido la prevención de solicitudes repetidas.
Aviso/cierre de modal	Paso posterior del cliente, no recibo durable, de plugin o publicación.
Respuesta de duplicado	Ya existe una reseña coincidente; no reintentes a ciegas.
Control de grupo ausente	La composición actual lo mantiene inactivo; no es prueba de éxito con grupos.
Fallo del plugin	La persistencia y el comportamiento posterior pueden resolverse por separado.

Diagnóstico

Falta el cliente de la reseña

Comprueba la categoría de pedido individual, la presencia del cliente y el objeto de reseña devuelto. No deduzcas si existe una reseña solo por la estrella visible.

Enviar está disponible antes de elegir una calificación

No envíes. Exige una calificación explícita del uno al cinco y un comentario revisado que proteja la privacidad antes de que una futura integración autorizada pueda construir la solicitud.

Se cierra el modal, pero la reseña no aparece en otra parte

El evento/combinar datos local y el plugin/publicación/informes son etapas separadas. No vuelvas a pulsar; concilia con la persona responsable aprobada de reseñas.

El código fuente parece permitir reseñar una entrega agrupada

La composición aceptada oculta ese control. No publiques un procedimiento para grupos ni deduzcas que las reseñas de cada integrante se realizan de forma atómica a partir de código inactivo.

Guías relacionadas: Reseñar a un cliente · Usar el contrato de comunicación revisado · Revisar los detalles del pedido · Ver entregas agrupadas