El sistema define 5 roles con permisos diferenciados. Cada usuario tiene un rol global o roles por yard (multi-yard nativo, ADR-008).
Los 5 roles
Admin
Configuración global del sistema y gestión de usuarios y patios.
- Crea/edita yards (perímetros, zonas, layout).
- Administra catálogos cerrados (Carrier, Line, etc.).
- Asigna roles a usuarios (incluyendo roles por yard).
- Configura integraciones (Samsara, webhooks).
Acceso: Web únicamente.
Audiencia típica: IT del cliente o equipo de operaciones central.
Yard Manager (jefe de patio)
Supervisión del patio y resolución de excepciones.
- Edita el layout de zonas de su yard (con versionado).
- Fuerza el cierre de registros de entrada por error.
- Cambia zona de un trailer sin esperar al rondín.
- Consulta bitácora del personal de patio en su turno.
- Resuelve anomalías con razón documentada.
Acceso: Web principal, ocasional desde móvil.
Audiencia típica: jefe de patio o encargado de turno.
Operator (personal de patio)
Captura primaria de la operación. También llamado patiero o yardista.
- Registra entradas (QR de hoja de salida o captura manual).
- Registra salidas con verificación de sellos.
- Confirma/corrige zonas en rondín.
- Reporta anomalías e incidentes con foto.
Acceso: Móvil principal (en campo y caseta) · puede usar Web.
Audiencia típica: personal en garita, rondín u oficina rotando.
Gate Operator (caseta)
Vista especializada para personal de vigilancia.
- Monitor de trailers aproximándose (detección anticipada por GPS).
- Lista en vivo de cruces de entrada/salida.
- Alerta cuando un trailer sale sin haber sido liberado en sistema.
- Botón rápido para registrar visitantes.
Acceso: Web en monitor de caseta.
Audiencia típica: personal de vigilancia en garita de entrada/salida.
Viewer (consulta)
Solo lectura.
- Consulta de trailers, zonas, eventos, anomalías.
- Dashboard y reportes en formato lectura.
- Sin permisos para modificar nada.
Acceso: Web.
Audiencia típica: auditoría, gerencia, integraciones internas.
Matriz resumen de permisos
| Acción | Admin | Yard Manager | Operator | Gate Operator | Viewer |
|---|
| Registrar entrada / salida | ✅ | ✅ | ✅ | ✅ | — |
| Confirmar / corregir zona en rondín | ✅ | ✅ | ✅ | — | — |
| Forzar cierre de Assignment | ✅ | ✅ | — | — | — |
| Editar layout de zonas | ✅ | ✅ | — | — | — |
| Resolver anomalías | ✅ | ✅ | reporta | reporta | — |
| Administrar catálogos | ✅ | — | — | — | — |
| Gestionar usuarios y permisos | ✅ | parcial (su yard) | — | — | — |
| Vista de caseta (entrada/salida en vivo) | ✅ | ✅ | ✅ | ✅ | ✅ |
| Reportes y consulta histórica | ✅ | ✅ | ✅ | ✅ | ✅ |
Multi-yard: permisos por patio
Un mismo usuario puede tener roles distintos en patios distintos:
| Usuario | Patio Dulces Nombres | Patio Saltillo |
|---|
| María (jefa central) | YardManager | YardManager |
| Juan (operador rotativo) | Operator | Operator |
| Pedro (auditor) | Viewer | Viewer |
| Lucía (jefa Saltillo) | — | YardManager |
Esto se gestiona vía la entidad UserYardAccess (ADR-008).
Siguiente paso