Gestión de Ubicaciones Físicas

Descripción General

Las Ubicaciones Físicas son los espacios concretos donde se encuentran instalados activos, materiales o donde operan empleados. Son distintas de los Campos Petroleros (dimensión operacional) — una ubicación es un espacio físico real como un almacén, un edificio, una sala de control o una portería.

Jerarquía de Ubicaciones

Las ubicaciones se organizan en árbol jerárquico:

SITE (Sitio/Instalación)
  └── BUILDING (Edificio)
        └── FLOOR (Piso)
              └── ROOM (Sala/Cuarto)
                    └── AREA (Área)
                          └── ZONE (Zona)
                                ├── RACK (Estante)
                                │     └── CABINET (Gabinete/Estante)
                                └── GATE (Portería/Acceso)

Tipo	Descripción	Uso típico
SITE	Instalación completa	"Base Operativa Boscan", "Patio Industrial Maturín"
BUILDING	Edificio dentro del sitio	"Almacén Central", "Edificio Administrativo"
FLOOR	Piso del edificio	"Planta Baja", "Piso 2"
ROOM	Sala o cuarto	"Sala de Control", "Oficina de Operaciones"
AREA	Área funcional	"Área de Recepción de Materiales", "Zona de Carga"
ZONE	Zona dentro de un área	"Zona de Peligro", "Zona de Inspección"
RACK	Estante o rack de almacenamiento	"Rack A", "Rack B"
CABINET	Gabinete o casillero	"Gabinete 01", "Estante 3"
GATE	Portería o punto de acceso	"Portería Principal", "Acceso Norte"
OTHER	Otro tipo de ubicación	Uso libre

Casos de Uso Principales

Almacenes e Inventario

Las ubicaciones de tipo BUILDING → AREA → RACK → CABINET definen dónde está físicamente cada ítem de inventario. Permite saber exactamente en qué estante se encuentra una tubería o una válvula.

Portería (GATE) y Pases de Salida

Las ubicaciones de tipo GATE son fundamentales para el módulo de Pases de Salida (SICESMA):

• Cada portería de la instalación es una ubicación GATE
• Cuando se emite un pase de salida, se especifica por cuál portería saldrá el material
• El vigilante registra la salida desde esa portería específica

Activos e Instalaciones

Los activos de producción tienen dos campos de ubicación:

• field_id → Campo petrolero (dónde opera)
• location_id → Ubicación física (dónde está instalado)

Crear una Ubicación

Paso 1: Información Básica

Campo	Requerido	Descripción
Nombre	✅	Nombre descriptivo de la ubicación
Código	✅	Código único de identificación
Tipo	✅	SITE, BUILDING, FLOOR, ROOM, AREA, ZONE, RACK, CABINET, GATE, OTHER
Ubicación Padre	❌	Ubicación jerárquicamente superior
Descripción	❌	Descripción adicional

Paso 2: Seleccionar el Tipo y Padre Apropiado

Siga la jerarquía lógica:

1. Primero cree el SITE (instalación o base operativa)
2. Luego los BUILDING dentro del sitio
3. Luego los FLOOR dentro del edificio (si aplica)
4. Luego las ROOM o AREA dentro del piso
5. Finalmente los RACK y CABINET dentro del área

Paso 3: Guardar

Haga clic en "Guardar". La ubicación aparece en el árbol jerárquico.

Navegar el Árbol de Ubicaciones

La lista de ubicaciones muestra la jerarquía visual con indentación:

📍 Base Operativa Maturín (SITE)
  🏢 Almacén Central (BUILDING)
    📦 Área de Tubería (AREA)
      🗄️ Rack A (RACK)
      🗄️ Rack B (RACK)
    📦 Área de Válvulas (AREA)
  🏢 Edificio Administrativo (BUILDING)
    🚪 Portería Principal (GATE)
    🚪 Acceso de Camiones (GATE)

Buenas Prácticas

Nomenclatura

• Use códigos cortos y descriptivos
• Mantenga consistencia: ALM-CENT-RACK-A o BOSCan-BLD-01
• Incluya el tipo en el código cuando sea útil

Profundidad de la Jerarquía

• No cree demasiados niveles si no son necesarios
• Para un almacén simple: SITE → BUILDING → AREA es suficiente
• Para almacenes complejos con múltiples estantes: SITE → BUILDING → AREA → RACK → CABINET

Porterías (GATE)

• Cree una GATE por cada punto de acceso/salida de la instalación
• Use nombres claros: "Portería Principal", "Portería de Carga", "Portería Norte"
• Vincule las GATE al SITE correspondiente como padre

Integración con Otros Módulos

Módulo	Cómo usa las Ubicaciones
Inventario	Cada ítem tiene una ubicación física (estante, área) dentro de un almacén
Activos	Los activos tienen una ubicación física (location_id) además del campo petrolero
Pases de Salida	Las porterías (tipo GATE) se usan para registrar por dónde sale y entra el material