REQ-COM-01 — Chat entre usuarios en línea
· 3 min de lectura
Implementación del requerimiento REQ-COM-01 (Chat entre usuarios en línea), dentro de Comunicación y con prioridad Media. El panel «Usuarios en línea» de la barra lateral derecha ya mostraba quién estaba conectado, pero no permitía hacer nada con esa información.
📋 Alcance
| Criterio de aceptación | Entregable |
|---|---|
| Tooltip a la izquierda con más datos del usuario | UserCardTooltip (Popover Radix side="left" + flecha) sobre la tarjeta |
| Iniciar un chat desde la tooltip | Botón «Iniciar chat» → ventana de chat flotante |
| Conversaciones persistidas | Tablas conversaciones/mensajes + endpoints /api/chat |
| Un único hilo por par de usuarios | Índice UNIQUE (id_usuario_1, id_usuario_2) + obtenerOCrearConversacion() |
| Mensajes a desconectados mostrados al reconectar | El mensaje se persiste siempre; el historial se lee de BD |
⚙️ Cómo funciona
- Persistencia primero: la base de datos es la fuente de verdad; Socket.io solo entrega en vivo a quien está conectado. Por eso un mensaje a un usuario desconectado no se pierde: queda guardado y aparece en su historial al volver.
- Hilo único: los dos ids del par se guardan ordenados y un índice
UNIQUEimpide hilos duplicados, incluso si dos usuarios abren el chat a la vez. - Tooltip con datos: al hacer clic en la tarjeta se muestran avatar, nombre, rol, estado y los datos disponibles (correo, usuario, oficina y teléfono), más la opción de iniciar el chat.
- Tiempo real: cada cliente se une a su sala
user-<id>; al enviar un mensaje, el servidor lo persiste y lo emite a las salas del remitente y del destinatario.
🧩 Detalles de implementación
| Pieza | Rol |
|---|---|
database/migrations/032_create_chat_conversaciones_mensajes.sql | Tablas conversaciones / mensajes |
domains/chat/ | Servicio, controlador, gateway, DTOs y entidades |
src/components/chat/user-card-tooltip.tsx | Tooltip con datos + «Iniciar chat» |
src/components/chat/chat-window.tsx / chat-windows.tsx | Ventana de chat y host de socket |
src/services/contexts/chat-context.tsx | Estado de las ventanas abiertas |
Sin dependencias nuevas: se reutiliza
socket.io, Radix (@radix-ui/react-popover), axios y React Query ya presentes. Sin restricción de rol (cualquier usuario autenticado puede chatear).
🧪 Pruebas
- Web:
src/components/__tests__/user-card-tooltip.test.tsxychat-window.test.tsx— 4 casos (tooltip con datos, iniciar chat, historial persistido y envío).tscEXIT 0 en web y API. - API:
chat.service.spec.tsychat.controller.spec.ts(hilo único, persistencia + emisión, marcado de leído y conteo de no leídos).
Nota de entorno: la suite Jest del API no corre en este entorno (Node v22; NestJS 12 es ESM y Jest exige Node ≥ 24.9). Se comprobó que un spec existente falla igual.
📚 Documentación
- Spec: REQ-COM-01: Chat entre usuarios en línea
- Manual: Chat entre usuarios en línea
- Framework:
ccf-almacen-framework/DOMINIOS/COMUNICACION.md
