Saltar al contenido principal

Fix — «Almacén guardado» sin guardarse + estandarización de la gestión de Almacenes

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

Se reportó que al crear un almacén la interfaz mostraba el mensaje de guardado exitoso, pero el registro no se guardaba. Además, la pantalla Almacenes lucía distinta al resto del módulo y su formulario no permitía designar responsable.


🐞 Causa raíz: error silenciado en la capa API​

En src/api/almacenes.ts las operaciones de escritura atrapaban el error y devolvían null en lugar de propagarlo:

// ANTES (bug)
try {
const response = await axios.post(url, data, { headers: authHeaders() });
return response.data;
} catch (error) {
logger.error('Error creating almacen:', error);
return null; // ← se traga el error
}

Como el hook de mutación (useCreateWarehouse) siempre resolvía (con null), el handleSave de la página mostraba el toast «Almacén creado» aunque el POST hubiera fallado con 403 (rol sin permiso), 409 (nombre duplicado) o 400 (validación).

La causa del fallo real quedaba invisible. El síntoma era el falso positivo de éxito.

Corrección: las funciones de almacenes.ts ahora propagan el error (mismo patrón que src/api/transferencias.ts), por lo que React Query lo expone y la interfaz muestra el mensaje del backend.

// DESPUÉS
export const createAlmacen = async (data: CreateAlmacenRequest) => {
const response = await axios.post(baseUrl(), data, { headers: authHeaders() });
return response.data;
};

Se aplicó a getAllAlmacenes, createAlmacen, updateAlmacen, deleteAlmacen y setAlmacenActivo.

Ajuste de consumidores​

getAllAlmacenes() dejó de devolver null en error; se blindaron los 4 consumidores que dependían de ese comportamiento tolerante para no generar rechazos no manejados:

  • src/pages/products.tsx
  • src/components/inventory/stock-loading.tsx
  • src/components/ubicaciones/ubicaciones-management.tsx
  • src/components/requests/request-dispatch.tsx

🖥️ Estandarización visual de la página Almacenes​

La pantalla se alineó al patrón de sus hermanas INV-002 (transferencias.tsx, devoluciones.tsx):

AntesAhora (estándar)
container mx-auto pb-2 w-full px-2p-4 md:p-6
h1 text-3xl font-bold + icono azulh1 text-2xl font-semibold + subtítulo text-muted-foreground
Card border-blue-100 con cabecera propiaHeader + tabla en overflow-x-auto rounded-md border
Botones con colores hardcodeados (bg-blue-600, bg-green-600…)Variantes estándar (default, ghost, outline)
Estados de carga/error/vacío ad-hocPatrón con role="status" / role="alert" y mensajeError()

Además, el botón Recargar y el contador «X de Y almacén(es)» siguen la convención del resto.


➕ Formulario funcional​

  • Se añadió el selector Responsable (antes el campo existía en el estado pero no tenía input): ahora se puede designar el usuario encargado al crear/editar una bodega.
  • Gating por rol: las acciones de escritura (Nuevo/Editar/Inactivar/Eliminar) solo se muestran a Administrador y Almacenista (roles que el backend autoriza). La gestión de usuarios por bodega y la eliminación quedan solo para Administrador. Esto evita el 403 silencioso que originaba el síntoma para roles sin permiso.

✅ Verificación​

tsc --noEmit, next lint y next build en 0 en ccf-almacen-web.


🔑 Archivos clave​

Frontend (ccf-almacen-web)

  • src/api/almacenes.ts — propagación de errores (fix)
  • src/hooks/use-warehouses.ts — tipo de retorno del listado
  • src/pages/almacenes.tsx — UI estandarizada, selector de responsable y gating por rol
  • src/pages/products.tsx, src/components/inventory/stock-loading.tsx, src/components/ubicaciones/ubicaciones-management.tsx, src/components/requests/request-dispatch.tsx — manejo del error del listado

Backend (ccf-almacen-api) — sin cambios. Contrato de POST/PUT /api/almacenes: roles Administrador y Almacenista; DELETE y GET /:id/usuarios: Administrador.

Manual de usuario: Gestionar Almacenes.