2026-07-03 — Chat por salas y soporte por orden

Para front-end, mobile e integradores de /api/v1.

Summary

El chat se reorganiza en torno a salas (chat rooms). Cada sala pertenece a una orden y tiene un type: ORDER_CLIENT_DRIVER (cliente ↔ conductor) o ORDER_ADMIN_SUPPORT (conductor ↔ soporte). El flujo antiguo /chat/{orderId} deja de existir: ahora se resuelve la sala una vez y luego se lee y escribe por roomId. Además se estrena el chat de soporte por orden, con bandeja y modelo de claim para el panel admin.

Breaking changes

GET/POST /chat/{orderId} se eliminan

El chat cliente ↔ conductor ya no se accede por orden directa. Primero conviene resolver la sala y luego operar por roomId.

• Afecta: GET /chat/{orderId} y POST /chat/{orderId} (cliente/conductor). Ambos removidos.
• Migración: llamar POST /orders/{orderId}/chat-rooms con {"type": "ORDER_CLIENT_DRIVER"} para obtener id, channel y los últimos mensajes; luego usar GET/POST /chat-rooms/{roomId}/messages. El envío exige content de 1–500 caracteres.

El canal en tiempo real del chat cambia a chat.rooms.{id}

El evento chat.message ya no viaja por orders.{id}.client / orders.{id}.driver, sino por el canal dedicado de la sala.

• Afecta: suscriptores del evento chat.message.
• Migración: suscribirse al channel que devuelven las respuestas de resolver/listar la sala (chat.rooms.{id}), en vez de construir el nombre desde el orderId.

New

Chat cliente ↔ conductor por salas

Cada mensaje incluye sender_role (CLIENT, DRIVER o ADMIN). La sala cliente ↔ conductor se abre con la orden pagada (CONFIRMED hasta DELIVERED).

Soporte por orden (conductor ↔ admin)

El conductor abre la sala de soporte con POST /orders/{orderId}/chat-rooms y {"type": "ORDER_ADMIN_SUPPORT"}, disponible mientras la orden está activa. Del lado del panel, el soporte es global (sin scoping por ciudad) y usa un modelo de claim.

Los errores del lado admin usan { "error": "SupportError", "message": "…" }; los del lado cliente/conductor, { "error": "ChatError", "message": "…" }.

WebSocket

order-support.queue avisa a todos los admins activos que una sala entró al pool, fue reclamada o liberada, para refrescar la bandeja en vivo. Los mensajes en sí siguen yendo por chat.rooms.{id} (solo miembros activos de la sala).