La solución se apoya en ocho pilares. Cada uno responde a un problema concreto del sistema actual y está alineado con uno o varios ADRs vigentes (referencias entre paréntesis).
1. Digital twin del patio por zonas
Representación digital del patio físico organizado en zonas con polígono geográfico y nombre operativo (“Zona Norte”, “Refrigerados”).
La zona es la unidad operativa mínima, no slots ni postes con QR — porque en la operación real esas marcas no existen.
Versionado de layout: si rediseñas las zonas, el histórico previo se preserva.
2. Captura primaria por el personal de patio
Dos modos para registrar entrada/salida:
El personal de patio es la fuente de verdad operativa.
3. GPS Samsara como confirmación
El GPS Samsara no genera eventos — los confirma. Reporta tres señales:
Si el GPS reporta sin captura previa, se genera anomalía.
4. Rondín de confirmación de zonas
El personal de patio recorre el patio y valida o corrige las zonas sugeridas por GPS.
Cierra el ciclo: GPS sugiere, personal valida en campo.
Para trailers visitantes sin GPS, la confirmación en rondín es obligatoria dentro del umbral (sugerencia 4 h) o se genera anomalía VisitorZoneUnconfirmed.
5. Multi-yard nativo
Soporte multi-patio desde Sprint 1. Un mismo usuario puede tener acceso a uno o varios yards con permisos distintos por yard (modelo UserYardAccess).
Sin retrabajos posteriores para soportar más patios.
6. Operación offline tolerante
PWA con outbox local: la app móvil sigue funcionando aunque pierda señal.
Las operaciones se guardan localmente y se sincronizan automáticamente al recuperar red.
Resolución clara de conflictos si dos personas tocaron el mismo trailer.
7. Catálogos cerrados
Carrier, Line, TripType, ContentType, Origin, Destination — todos como catálogos administrados, no texto libre.
Elimina los workarounds como "NO PONER VALOR EN BLANCO" y el comodín "patio dulces nombres" del sistema actual.
8. Sellos como entidad de primera clase
TrailerSeal modelado como entidad propia. Capturados al entrar y verificados al salir.
Si no coinciden: anomalía SealMismatch de severidad High.
Cadena de custodia aduanal completa.
Aunque no es uno de los 8 pilares estructurales, vale destacar la inspección rápida 360° que se ejecuta al ingreso y al egreso:
Tiempo adicional al registro: ~30 segundos.
