Ubicaciones de Almacén — Sistema de ubicaciones físicas (zona/pasillo/estante/nivel)
· 3 min de lectura
Implementación de la mejora INV-001 (prioridad Alto) para organizar el almacén físico en una jerarquía de ubicaciones y asociar cada producto a su ubicación física exacta.
📋 Alcance
Jerarquía de ubicaciones:
Zona → Pasillo → Estante → Nivel
Cada nivel se administra de forma independiente y el nivel es la unidad de ubicación física asignada al producto.
🔧 Backend (ccf-almacen-api)
Nuevas tablas (migración 004_create_ubicaciones_tables.sql)
zonas(id_zona,nombreúnico,descripcion,activo).pasillos(id_pasillo,id_zonaFK →zonas,nombreúnico por zona,descripcion,activo).estantes(id_estante,id_pasilloFK →pasillos,nombreúnico por pasillo,descripcion,activo).niveles(id_nivel,id_estanteFK →estantes,nombreúnico por estante,descripcion,activo).
Todas las FK usan ON DELETE RESTRICT y se agregan índices de filtrado por padre, secuencias id por tabla y COMMENT sobre tablas y columnas (regla 13). Únicas colectivas por (padre, nombre) garantizan integridad.
Relación a productos (migración 005_add_nivel_fk_to_productos.sql)
ALTER TABLE productos ADD COLUMN id_nivel INTEGER+ FKfk_productos_nivel(ON DELETE RESTRICT) + índiceidx_productos_id_nivel.
Nuevo dominio src/domains/ubicaciones/
- Entidades:
zona.entity,pasillo.entity,estante.entity,nivel.entity(relacionesManyToOne/OneToMany). - DTOs:
create/updatepor nivel (validaciónclass-validator). ubicaciones.service.ts: CRUD por nivel + listados filtrados por padre y bloqueo de borrado cuando existen hijos.- 4 controladores REST:
@Controller('api/zonas'),.../pasillos,.../estantes,.../niveles.
Cambios en productos
producto.entity.ts: columnaid_nivel+ relaciónnivel(ManyToOne →Nivel).create-producto.dto/update-producto.dto:idNivelopcional (IsOptional,IsNumber,IsPositive).productos.module.ts: registraNivelenforFeatureyapp.module.ts: registra las 4 entidades enforRoot(entities: [...]).productos.service.ts: las consultas incluyen ahoranivel,nivel.estante,nivel.estante.pasillo,nivel.estante.pasillo.zona.
Permisos
Los CRUD de ubicaciones requieren roles Admin / Almacenista (@Roles).
💻 Frontend (ccf-almacen-web)
- Modelo
IZona | IPasillo | IEstante | INively helperformatearRutaNivelensrc/models/ubicacion.entity.ts. - Cliente API en
src/api/ubicacion.ts(CRUD + filtros por padre). product.entity.ts(frontend):idNivel/nivel+ métodoobtenerUbicacion().- Formulario de producto: nueva sección Ubicación en el Almacén con selects en cascada (zona → pasillo → estante → nivel) y
idNivelen el schema zod; el nivel se precarga al editar y se persiste en creación/edición. - Lista de productos: nueva columna Ubicación con la ruta formateada.
- Detalle de producto: bloque Ubicación con la ruta completa.
- Pantalla de gestión
components/ubicaciones/ubicaciones-management.tsx: navegación jerárquica lateral + CRUD por nivel. - Menú lateral: ítem Ubicaciones.
📚 Documentación (ccf-almacen-wiki)
- Nuevo manual Ubicaciones Físicas de Almacén (
manuales/inventarios/ubicaciones.md), registrado en el índice De usuario. - Actualizado el backlog de mejoras (
mejoras-propuestas-almacen.md) marcando INV-001 como implementada.
🧪 Verificación
- Backend:
npx tsc --noEmitsin errores. - Frontend:
npx tsc --noEmitsin errores. - Las migraciones siguen el patrón idempotente y respetan la convención de nombres del framework.
