Fix — «Almacén guardado» sin guardarse + estandarización de la gestión de Almacenes
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.tsxsrc/components/inventory/stock-loading.tsxsrc/components/ubicaciones/ubicaciones-management.tsxsrc/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):
| Antes | Ahora (estándar) |
|---|---|
container mx-auto pb-2 w-full px-2 | p-4 md:p-6 |
h1 text-3xl font-bold + icono azul | h1 text-2xl font-semibold + subtítulo text-muted-foreground |
Card border-blue-100 con cabecera propia | Header + 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-hoc | Patró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 listadosrc/pages/almacenes.tsx— UI estandarizada, selector de responsable y gating por rolsrc/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.
