Saltar al contenido principal

Documentos de la mascota — el ciclo del envío y tres defectos corregidos

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

La pantalla Documentos de la mascota ya tenía cubierto el recorrido principal (32 casos) y sus tarjetas. Al completar lo que faltaba —catálogo de documentos, ciclo del aviso, estados de envío y búsqueda— aparecieron tres defectos reales: el historial no mostraba la hora, el buscador de mascotas no tenía nombre accesible y el aviso de éxito dejaba un separador suelto cuando el registro no traía archivo.

1. Qué se añadió (17 casos)​

ccf-almacen-web/src/components/__tests__/veterinaria-documentos-envio.test.tsx (14):

BloqueQué fija
Contrato y accesibilidadLa etiqueta «1. Mascota» nombra al buscador; la mascota se envía con _id cuando existe y con id cuando no; el correo escrito a mano viaja recortado; una búsqueda de solo espacios no envía search
Ciclo del avisoCambiar de mascota o de documento limpia el aviso anterior; un envío correcto no ofrece «Reintentar» (sí «Cerrar aviso»); un envío sin nombreArchivo no deja un separador suelto; el reintento desde el historial deja su propio aviso
Estado del envíoMientras envía, el botón dice «Enviando…» y queda bloqueado, igual que los reintentos del historial
Historial y paginaciónLa columna «Fecha y hora» trae día y hora del negocio (incluida la medianoche como 00:00); la búsqueda recorta espacios; enviar desde la página 3 vuelve a la 1 con una sola recarga
Búsqueda de mascotas«Buscando…» y el botón bloqueado mientras consulta

ccf-almacen-web/src/components/__tests__/veterinaria-documentos-catalogo.test.tsx (3): las etiquetas de las tarjetas y del filtro salen de catalogos.documentos; un documento que falta conserva su etiqueta de fábrica; un valor desconocido del API no añade tarjetas; y el envío viaja con el valor, nunca con la etiqueta visible.

2. Defecto corregido: el historial no mostraba la hora​

La columna se llama «Fecha y hora», el registro trae creadoEn como instante ISO y el manual ya prometía fecha y hora; sin embargo formatoFechaHora recortaba los diez primeros caracteres, así que dos envíos del mismo día eran indistinguibles.

formatoFechaHora ahora reconoce el instante ISO y pinta día y hora en la zona del negocio (America/Bogota), con hourCycle: 'h23' para que la medianoche sea 00:00 y no 24:00. Con (fecha, hora) separadas —las citas de la agenda y del tablero— se comporta igual que antes.

3. Defecto corregido: el buscador de mascotas sin nombre accesible​

El campo solo tenía placeholder, que no es una etiqueta (WCAG 1.3.1 / 4.1.2): un lector de pantalla anunciaba un cuadro de texto sin nombre. La etiqueta «1. Mascota» ahora está asociada con htmlFor/id.

4. Defecto corregido: separador suelto en el aviso de éxito​

El aviso se construía como `${nombreArchivo ?? ''} · ${destinatario}`: si el registro no traía nombre de archivo, el operador veía « · correo@…». Ahora se muestran solo los datos presentes.

Cómo verificarlo​

cd ccf-almacen-web
npx jest src/components/__tests__/veterinaria-documentos
# Tests: 58 passed, 58 total (5 suites)

npx tsc --noEmit, npx eslint y la suite completa del web (165 suites, 1435 pruebas) siguen en verde.

Archivos clave​

  • ccf-almacen-web/src/components/__tests__/veterinaria-documentos-envio.test.tsx — ciclo del envío y bordes.
  • ccf-almacen-web/src/components/__tests__/veterinaria-documentos-catalogo.test.tsx — etiquetas del catálogo.
  • ccf-almacen-web/src/components/veterinaria/veterinaria-ui.tsx — formatoFechaHora con instantes ISO.
  • ccf-almacen-web/src/components/veterinaria/veterinaria-documentos.tsx — etiqueta del buscador y aviso sin separador suelto.
  • ccf-almacen-wiki/docs/manuales/veterinaria/documentos-por-correo.md — comportamiento visible actualizado.