Aptli

Sitios

Los sitios representan ubicaciones de almacenamiento donde se mantiene el inventario. Los sitios pueden ser ubicaciones físicas (almacenes), sitios de campo, o ubicaciones lógicas (trabajadores individuales, vehículos).

Tipos de Sitio (Implícitos)

Jerarquía de Sitios:

Almacén Central
├── Gran capacidad, acceso controlado
├── Personal con permiso canFacilitatePickups
└── Punto de recepción primario (proveedores → almacén)

Sitios de Preparación de Campo
├── Temporales, específicos del proyecto
├── Capacidad media
└── Transferencias desde almacén → consumo por trabajadores

Sitios Personales (Trabajadores)
├── Auto-creados en la primera recogida QR
├── Inventario móvil (sigue al trabajador)
└── Transacciones de consumo (el trabajo agota el stock)

Sitios de Vehículo
├── Referencia al activo del vehículo o operador
├── Almacenamiento móvil (tripulaciones en viaje)
└── El stock se mueve con el vehículo

Página de sitios mostrando ubicaciones de almacenamiento con tipos e información de capacidad

Aptli usa tipos de sitio implícitos basados en campos presentes:

Sitios Físicos

Sitios con geometría (coordenadas GPS o polígonos de área):

  • Almacenes centrales
  • Centros de distribución regionales
  • Áreas de preparación de campo
  • Patios de almacenamiento

Ejemplo:

Nombre: "Almacén Central"
Geometría: Punto en (lat: 40.7128, lng: -74.0060)
Dirección: "123 Storage Way, New York, NY"

Sitios Personales

Sitios con referencia a usuario o vehículo (sin geometría):

  • Inventario de trabajador individual
  • Inventario de vehículo
  • Equipo móvil

Ejemplo:

Nombre: "Inventario Personal de John"
Referencia: { user_id: "..." }

Este diseño evita problemas de sincronización de enum - la presencia de geometría vs. referencia determina el comportamiento implícito.

Campos del Sitio

Información Básica:

  • Nombre - Nombre descriptivo
  • Tipo - Categoría para filtrado (almacén, campo, vehículo, personal)
  • Geometría - Coordenadas GPS o área de polígono (opcional)
  • Referencia - Enlace a usuario o vehículo (opcional)
  • Dirección - Dirección física para almacenes

Seguimiento de Inventario:

  • Artículos de Stock - Array de recursos mantenidos en este sitio (gestionados vía transacciones)
  • Capacidad - Máximo opcional de volumen/unidades (alertas cuando se acerca al límite)

Control de Acceso:

  • Personal Autorizado - Usuarios que pueden crear recepciones/ajustes en este sitio
  • Requiere Supervisión - Si es verdadero, se requiere permiso canFacilitatePickups para transferencias

Creación de Sitios

Sitio Físico:

  1. Navegar a Inventario → Sitios
  2. Hacer clic en "Agregar Sitio"
  3. Ingresar nombre, tipo, dirección
  4. Hacer clic en el mapa para establecer geometría (punto o polígono)
  5. Establecer capacidad si aplica
  6. Guardar

Sitio Personal (Auto-Creado): Cuando el trabajador escanea el primer código QR de recogida:

  • Sitio personal creado automáticamente
  • Nombrado: "Inventario Personal de Nombre del Trabajador"
  • Referencia establecida al ID de usuario del trabajador
  • No se necesita creación manual

Sitio de Vehículo:

  1. Crear sitio con referencia al activo del vehículo
  2. O referencia al usuario que opera el vehículo
  3. Los artículos de stock rastrean qué hay en el vehículo
  4. Útil para inventario móvil (tripulaciones en viaje)

Patrones de Uso de Sitios

Almacén Central

  • Propósito: Recepción y almacenamiento primario
  • Características: Gran capacidad, acceso controlado, ubicación fija
  • Transacciones: Recepciones de proveedores, transferencias a trabajadores/sitios de campo
  • Personal: Gerentes de almacén con permiso canFacilitatePickups

Sitio de Preparación de Campo

  • Propósito: Almacenamiento temporal cerca del área de trabajo activa
  • Características: Capacidad media, específico del proyecto, temporal
  • Transacciones: Transferencias desde almacén, consumo por trabajadores
  • Ciclo de Vida: Creado para el proyecto, vaciado al completar el proyecto

Sitio Personal (Trabajador)

  • Propósito: Inventario móvil para individuo
  • Características: Capacidad pequeña, se mueve con el trabajador, específico del trabajador
  • Transacciones: Recogidas vía escaneo QR, consumo vía reportes, devoluciones al almacén
  • Acceso: Solo el trabajador puede consumir de su sitio personal

Sitio de Vehículo

  • Propósito: Inventario que viaja con el vehículo de la tripulación
  • Características: Capacidad media, se mueve con el vehículo, específico de la tripulación
  • Transacciones: Similar al sitio personal pero para tripulaciones multi-persona
  • Seguimiento: Útil para cumplimiento (qué materiales están en sitio)

Transacciones de Sitios

Ver toda la actividad en un sitio:

  • Navegar a la vista de detalle del sitio
  • "Historial de Transacciones" muestra:
    • Todas las recepciones, transferencias entrantes/salientes, consumos
    • Artículos de stock actuales y volúmenes
    • Personal que realizó las transacciones

Ayuda a responder:

  • ¿Qué inventario hay actualmente en este sitio?
  • ¿Qué salió del sitio recientemente?
  • ¿Quién recibió materiales de este sitio?

Seguimiento GPS para Transferencias

Cuando se escanea QR de recogida:

  • La transacción registra scanLocation (coordenadas GPS)
  • Valida que el trabajador estaba físicamente en el sitio fuente (si el sitio tiene geometría)
  • Registro de auditoría muestra dónde ocurrió el escaneo
  • Ayuda a detectar transferencias no autorizadas

Validación de Geocerca (Opcional): Configurar almacén para requerir escaneo dentro de radio de 50m

  • Previene escaneo QR remoto (captura de pantalla enviada a amigo)
  • Transacción rechazada si GPS está demasiado lejos de la geometría del sitio

Organización de Artículos de Stock

Cada sitio contiene artículos de stock:

Almacén Central
  ├── Cable Cat6: 500m
  ├── Soporte de Montaje: 200 unidades
  └── Kits de Instalación: 15 unidades

Inventario Personal de John
  ├── Cable Cat6: 10m
  └── Soporte de Montaje: 5 unidades

Navegación:

  • Desde sitio: ver todos los artículos de stock en esta ubicación
  • Desde artículo de stock: ver qué sitio contiene este inventario
  • Relación bidireccional

Alertas de Capacidad de Sitios

Establecer límites de capacidad para prevenir sobrecarga:

  • Basado en Volumen: Total de metros cúbicos/pies
  • Basado en Peso: Máximo de kilogramos/libras
  • Basado en Conteo: Máximo número de unidades

Cuando se acerca a la capacidad:

  • Alerta mostrada en la vista del sitio
  • Previene recepciones adicionales si está sobre capacidad
  • Promueve redistribución a otros sitios

Mejores Prácticas

Nombrar Consistentemente:

  • Sitios físicos: Incluir identificador de ubicación (ej. "Almacén - NYC", "Sitio de Campo - Proyecto Alfa")
  • Sitios personales: Los nombres auto-generados funcionan bien ("Inventario de Nombre")
  • Sitios de vehículo: Incluir ID del vehículo (ej. "Camión 42", "Van - Licencia ABC123")

Usar Geometría para Sitios Físicos:

  • Habilita filtrado por proximidad (encontrar sitio más cercano con recurso)
  • Valida recogidas QR (trabajador en ubicación correcta)
  • Muestra sitios en vista de mapa

Limitar Creación de Sitios Personales:

  • Crear solo cuando el trabajador necesita responsabilidad de inventario
  • No todos los usuarios necesitan sitios personales
  • Creados automáticamente en la primera recogida (no pre-crear)

Auditar Regularmente:

  • Revisar sitios con cero artículos de stock (sitios no utilizados)
  • Archivar sitios de campo después de completar el proyecto
  • Conciliar sitios personales durante conteos de ciclo