Saltar al contenido principal

Tickets y Webhooks — pruebas unitarias de soporte e integraciones salientes

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

Tickets de soporte (/tickets, REQ-SUP-01) y Webhooks (/webhooks, TEC-011) son los dos módulos de comunicación del sistema: uno recibe solicitudes de las áreas, el otro las emite hacia sistemas de terceros. Ahora suman 59 casos de prueba entre ambos, además del humo que ya existía del panel.

1. Qué se cubre​

Tickets — src/__tests__/tickets-gestion.test.tsx (35 casos)​

BloqueQué fija
ListadoEspera con esqueleto, columnas y datos (área, tipo, prioridad, estado, solicitante, asignado, tiempo, SLA, post-atención), vacío, error con reintento
FiltrosBúsqueda por botón y Enter, estado/área/tipo/prioridad, «Solo míos» (solo Administrador), SLA excedido, post-atención y «Limpiar filtros»
IndicadoresCada tarjeta filtra su estado y se alterna; «Críticos» resuelve el código del catálogo; paginación y tamaño de página; refresco
AltaTítulo y descripción obligatorios, área y tipo obligatorios, payload con prioridad/observaciones, registro post-atención con canal/fecha/atendido/estado inicial, error y visibilidad por rol
DetalleCarga por id, información y tiempos/SLA, hilo de respuestas con evidencias, respuesta pública y nota interna con cambio de estado, error al responder, cambio de estado con confirmación, asignación, alta y baja de evidencias, estado final sin acciones y estados de carga/error
Eliminación y tourBorrado con confirmación y error; recorrido guiado disponible o no

Webhooks — src/__tests__/webhooks-gestion.test.tsx (24 casos)​

BloqueQué fija
PanelEspera, error con reintento, resumen de la integración (activa/deshabilitada, activos, enviadas, fallidas), tabla con eventos y estado, vacío con su acción
EntregasFilas con estado, intentos n/m y código HTTP; sin entregas; filtros por evento y estado; paginación por cursor con «Cargar más» y su error
Alta y ediciónAl menos un evento, payload recortado con timeouts e intentos, secreto mostrado una sola vez, «Entendido» para ocultarlo, error al crear y edición precargada sin alterar eventos
AccionesEnvío de prueba, desactivación con confirmación, rotación de secreto con confirmación, reintento de entrega, «Actualizar» y cancelaciones sin efectos

2. Un defecto real corregido​

Al abrir el detalle de un ticket con evidencias, urlEvidencia() leía config[environment] y el mapa solo declara development y production: con cualquier otro NODE_ENV (las pruebas, por ejemplo) la entrada es undefined y el render del detalle rompía con Cannot read properties of undefined (reading 'apiDashboard'). Ahora cae a config.development cuando el entorno no está declarado, de modo que la URL de la evidencia se resuelve igual que en desarrollo.

3. Patrón de las pruebas​

  • Tickets: se mockean los hooks de React Query (use-tickets), el toast, el tour y la configuración de API; el panel se monta con sus hijos reales (indicadores, rejilla, alta y detalle) dentro de un QueryClientProvider.
  • Las mutaciones se resuelven invocando lo que devuelve mutateAsync y se comprueba el cuerpo exacto que llega al API.
  • Webhooks: se mockean las funciones de api/webhooks y sonner; las confirmaciones pasan por el modal del sistema (AlertDialog).
  • Los estados de carga de los esqueletos se localizan por role="status" y su aria-label («Cargando tickets…», «Cargando webhooks…»), no por texto visible.

4. Cómo verificarlo​

cd ccf-almacen-web
npx jest src/__tests__/tickets-gestion.test.tsx src/__tests__/webhooks-gestion.test.tsx
# Test Suites: 2 passed, 2 total
# Tests: 59 passed, 59 total

npx tsc --noEmit y npx eslint pasan sin errores.

Archivos clave​

  • ccf-almacen-web/src/__tests__/tickets-gestion.test.tsx — suite del panel de soporte.
  • ccf-almacen-web/src/__tests__/webhooks-gestion.test.tsx — suite de administración de webhooks.
  • ccf-almacen-web/src/components/tickets/ — panel, rejilla, alta, detalle y catálogos.
  • ccf-almacen-web/src/components/webhooks/webhooks-dashboard.tsx — CRUD, secreto y entregas.
  • ccf-almacen-web/src/components/tickets/ticket-catalogos.ts — corrección de urlEvidencia().