Tickets y Webhooks — pruebas unitarias de soporte e integraciones salientes
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)
| Bloque | Qué fija |
|---|---|
| Listado | Espera con esqueleto, columnas y datos (área, tipo, prioridad, estado, solicitante, asignado, tiempo, SLA, post-atención), vacío, error con reintento |
| Filtros | Búsqueda por botón y Enter, estado/área/tipo/prioridad, «Solo míos» (solo Administrador), SLA excedido, post-atención y «Limpiar filtros» |
| Indicadores | Cada 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 |
| Alta | Tí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 |
| Detalle | Carga 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 tour | Borrado con confirmación y error; recorrido guiado disponible o no |
Webhooks — src/__tests__/webhooks-gestion.test.tsx (24 casos)
| Bloque | Qué fija |
|---|---|
| Panel | Espera, error con reintento, resumen de la integración (activa/deshabilitada, activos, enviadas, fallidas), tabla con eventos y estado, vacío con su acción |
| Entregas | Filas 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ón | Al 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 |
| Acciones | Enví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), eltoast, el tour y la configuración de API; el panel se monta con sus hijos reales (indicadores, rejilla, alta y detalle) dentro de unQueryClientProvider. - Las mutaciones se resuelven invocando lo que devuelve
mutateAsyncy se comprueba el cuerpo exacto que llega al API. - Webhooks: se mockean las funciones de
api/webhooksysonner; las confirmaciones pasan por el modal del sistema (AlertDialog). - Los estados de carga de los esqueletos se localizan por
role="status"y suaria-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 deurlEvidencia().