Saltar al contenido principal

REQ-UX-02 — Card «Resumen por almacén» estandarizada

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

Estandariza la card «Resumen por almacén» de la pestaña inicial (página Inicio) para que la pantalla se lea mejor de un vistazo, y de paso corrige tres defectos que aparecieron al intervenirla.

Dos requerimientos con el mismo código

El catálogo tiene dos REQ-UX-02: «Atajos de teclado» (UX-002) y este. Se mantiene la etiqueta tal como llegó el requerimiento, pero conviene renumerar uno en el documento de origen.


📋 Alcance​

Criterio de aceptaciónEntregable
CA1 · La card está estandarizada en InicioUn único componente compone la card completa con los componentes shadcn y los tokens del sistema visual
CA2 · «Actualizar» y ocultar estadísticas despegados de la parte superiorAmbos viven en el CardHeader de la card, que aporta p-6 de respiro, agrupados con etiqueta accesible
CA3 · Contenido en dos columnasA la izquierda las tarjetas estadísticas del panel en dos columnas apiladas; a la derecha la tabla grid «Inventario de Bodega»
CA4 · La pantalla inicial se visualiza correctamenteFuera el h-80 que recortaba las gráficas, fuera el render duplicado en móvil y «Actualizar» funcionando

🎯 La distribución​

┌─ Resumen por almacén ──────────────────── [ 👁 ] [ Actualizar ] ┐
│ selector de bodega · totales de la bodega │
│ │
│ Estadísticas del panel │ Inventario de Bodega │
│ ┌────────┐ ┌────────┐ │ ┌────────────────────────────┐ │
│ │ Total │ │ Total │ │ │ SKU │ Producto │ … │Estado │ │
│ │Productos│ │Solicit.│ │ │ … │ … │ … │Normal │ │
│ └────────┘ └────────┘ │ └────────────────────────────┘ │
│ ┌────────┐ ┌────────┐ │ │
│ │Alertas │ │Movimien│ │ │
│ └────────┘ └────────┘ │ │
└────────────────────────────────────────────────────────────────┘

🧩 Qué cambió​

  1. Los controles suben a la card. Antes vivían en un bloque suelto fuera de ella, pegados a su borde. Ahora están en la cabecera, con la separación del CardHeader, y agrupados bajo una etiqueta accesible. Siguiendo sistema visual del frontend usan variantes de shadcn en lugar de las clases de tema anteriores: dentro de la card, un solo lenguaje visual.
  2. Dos columnas. Las cuatro tarjetas estadísticas del panel (Total Productos, Total de Solicitudes, Alertas de Stock y Movimientos) pasan a la columna izquierda en dos columnas apiladas hacia abajo; la tabla del inventario de la bodega ocupa la derecha, así que deja de quedar fuera de la vista inicial.
  3. «Actualizar» ya hace algo. No tenía onClick: ahora recarga el resumen y el inventario de la bodega, y refresca también las estadísticas del panel.
  4. El ojo sigue mandando. Alterna la visibilidad de la columna izquierda y, con las estadísticas ocultas, deja un estado explicativo en su lugar (en vez de un hueco vacío).
  5. Los totales de la bodega no se movieron. Se evaluó llevarlos también a la columna izquierda y se descartó: son contexto del selector y alargaban en exceso esa columna, justo lo que se quería evitar.

🐞 Defectos corregidos de paso​

HallazgoCorrección
La card se renderizaba dos veces en móvil (una en la rama isMobile y otra incondicional al final)Cada rama monta la suya: móvil y escritorio son mutuamente excluyentes
El botón «Actualizar» estaba muerto (sin onClick)Recarga resumen, inventario y estadísticas
El contenedor de las gráficas estaba fijado a h-80 (320 px)Se elimina la altura fija; el contenido fluye
Import de EyeOff sin uso en el dashboard tras mover el botónSe retira

🧪 Verificación​

  • ccf-almacen-web/src/components/__tests__/resumen-almacen-card.test.tsx — 10 pruebas: controles dentro de la cabecera, orden del DOM de las dos columnas, rejilla de dos columnas de las estadísticas, tabla grid a la derecha, estado vacío al ocultar, recarga real al pulsar «Actualizar» (segunda llamada a la API) y modo móvil apilado.
  • npx tsc --noEmit -p tsconfig.json — 0 errores.
  • Suite de la web: 36 suites, 238 pruebas, con los mismos 3 fallos previos (sesiones, login-2fa, sesion-aviso) ya conocidos y ajenos a este cambio.

📚 Documentación​

⏳ Pendiente​

  1. Renumerar uno de los dos REQ-UX-02 en el catálogo de origen.
  2. El botón «Actualizar» de la vista móvil sigue sin onClick (su bloque de cabecera es distinto y quedó fuera del alcance acordado: en móvil se mantiene el diseño actual). Conviene conectarlo en una entrega aparte.