Saltar al contenido principal

Documentos de la mascota y Personal — pruebas unitarias de las dos pantallas (65 casos)

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

Se cierran las dos pantallas que faltaban del bloque de administración de la clínica: Documentos de la mascota por correo (REQ-NOT-01) y Personal de la clínica (REQ-ADM-03). Ambas solo tenían cubierto su tour guiado —y, en documentos, las tarjetas de documento—. No aparecieron defectos de la aplicación; sí dos lecciones del arnés que quedan anotadas.

1. Documentos de la mascota (32 casos)​

ccf-almacen-web/src/components/__tests__/veterinaria-documentos.test.tsx:

BloqueQué fija
CargaMascotas con su tutor y su correo (o «Sin tutor · sin correo»), historial con sus formatos, consulta inicial (15 por página, sin filtros), avisos de carga y de vacío, errores de las dos consultas y aviso de conexión
HistorialColumnas completas, estado Enviado/Fallido, detalle («Intento N» o el motivo, con «Error desconocido» si falta), acción solo en los fallidos, Refrescar
Filtros y paginaciónTexto, documento y estado con vuelta a la página 1, y paginador
Búsqueda y elecciónBuscador por botón y con Enter, elección con correo del tutor precargado, «Cambiar» para volver a la lista y mascota sin tutor que bloquea el envío
EnvíoBloqueo sin mascota o con correo inválido, cuerpo del envío con el tipo elegido, resultado con destinatario, fallo con motivo, error de generación y cierre del aviso
ReintentosDesde el aviso y desde la fila del historial, fallo del reintento y error de red
RutaMonta la pantalla y sin sesión redirige al armazón

2. Personal de la clínica (33 casos)​

ccf-almacen-web/src/components/__tests__/veterinaria-personal.test.tsx:

BloqueQué fija
ListadoRol con su etiqueta, contacto con máscara o guion, especialidad con «(inactivo)», citas, fecha de alta, marca de desarrollador, carga, vacío, error con descripción, filtro por rol y paginador
Acceso por rolSin Administrador: aviso de restricción, sin acciones y sin consultar el API; con Administrador, las tres acciones por fila
AltaNombre y correo obligatorios, teléfono inválido (mínimo 6 dígitos, con aria-invalid y role="alert"), alta de auxiliar, de médico con especialidad y de administrador sin ficha, tipo de documento del catálogo, error y cancelación
EdiciónPrecarga con teléfono enmascarado, sin rol, documento ni sexo en edición, edición de médico con su especialidad y su estado de agenda, marca de desarrollador y baja lógica por «Archivado»
Contraseña y bajaContraseña temporal con confirmación y su mensaje (correo y clave), error, baja de auxiliar y de médico (por su ficha de agenda), error y cancelación
RutaMonta la pantalla y sin sesión redirige

3. Lecciones del arnés​

  • Nombres accesibles repetidos entre listas: la mascota se elige con un botón cuyo nombre empieza por su nombre («Luna …»), y el historial tiene otro botón «Reintentar el envío de Rocky». Un { name: /Rocky/ } encuentra los dos: hay que anclar el inicio de la expresión (/^Rocky/).
  • El teléfono viaja enmascarado: el campo pinta 300 123 4567 y entrega 3001234567; las aserciones usan el valor visible y el cuerpo del API usa el número sin separadores. En edición, el número precargado se parte por país.

Cómo verificarlo​

cd ccf-almacen-web
npx jest src/components/__tests__/veterinaria-documentos.test.tsx
# Tests: 32 passed, 32 total
npx jest src/components/__tests__/veterinaria-personal.test.tsx
# Tests: 33 passed, 33 total

npx tsc --noEmit y npx eslint siguen limpios, y la familia de veterinaria completa (21 suites, 386 pruebas) pasa en verde.

Archivos clave​

  • ccf-almacen-web/src/components/__tests__/veterinaria-documentos.test.tsx — suite nueva.
  • ccf-almacen-web/src/components/__tests__/veterinaria-personal.test.tsx — suite nueva.
  • ccf-almacen-web/src/components/ui/telefono-campo.tsx — campo con máscara por país que se ejercita desde el formulario.
  • ccf-almacen-web/src/test-utils/radix.ts — utilidades compartidas que usan ambas.