REQ-UX-02 — Card «Resumen por almacén» estandarizada
· 4 min de lectura
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ón | Entregable |
|---|---|
| CA1 · La card está estandarizada en Inicio | Un ú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 superior | Ambos viven en el CardHeader de la card, que aporta p-6 de respiro, agrupados con etiqueta accesible |
| CA3 · Contenido en dos columnas | A 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 correctamente | Fuera 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ó
- 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. - 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.
- «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. - 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).
- 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
| Hallazgo | Correcció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ón | Se 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
- UX-002: Estandarización de la card «Resumen por almacén»
- Dashboard General (Inicio) — actualizado
- Gestionar almacenes — usa el selector de la card
⏳ Pendiente
- Renumerar uno de los dos
REQ-UX-02en el catálogo de origen. - 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.
