Saltar al contenido principal

REQ-COM-01 — Chat entre usuarios en línea

· 3 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

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ónEntregable
Tooltip a la izquierda con más datos del usuarioUserCardTooltip (Popover Radix side="left" + flecha) sobre la tarjeta
Iniciar un chat desde la tooltipBotón «Iniciar chat» → ventana de chat flotante
Conversaciones persistidasTablas 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 reconectarEl 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 UNIQUE impide 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​

PiezaRol
database/migrations/032_create_chat_conversaciones_mensajes.sqlTablas conversaciones / mensajes
domains/chat/Servicio, controlador, gateway, DTOs y entidades
src/components/chat/user-card-tooltip.tsxTooltip con datos + «Iniciar chat»
src/components/chat/chat-window.tsx / chat-windows.tsxVentana de chat y host de socket
src/services/contexts/chat-context.tsxEstado 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.tsx y chat-window.test.tsx — 4 casos (tooltip con datos, iniciar chat, historial persistido y envío). tsc EXIT 0 en web y API.
  • API: chat.service.spec.ts y chat.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​