Modelos de Datos
Esta sección explica en detalle la estructura de datos del sistema Paso Rápido, incluyendo las entidades principales, sus relaciones y propósitos específicos.Arquitectura de Datos
Principios Fundamentales
Multi-Tenancia
Aislamiento por OrganizaciónCada organización tiene sus datos completamente separados mediante el campo
org_id en todas las tablas principales.- Seguridad garantizada entre organizaciones
- Escalabilidad horizontal
- Gestión independiente de datos
Trazabilidad
Auditoría CompletaTodos los cambios importantes se registran con timestamps y usuarios responsables.
- Campos
created_atyupdated_at - Historial de validaciones
- Registro de acciones de usuarios
Entidades Principales
1. Organizaciones
- Estructura
- Campos Detallados
- Relaciones
2. Usuarios y Membresías

- Estructura
- Roles Disponibles
3. Vehículos

- Estructura
- Campos Detallados
- Categorías de Vehículos
4. Asignaciones de Tags
- Estructura
- Gestión de Asignaciones
- Estados y Tipos
5. Estaciones de Peaje
- Estructura
- Información Geográfica
- Tarifas y Validación
6. Cargos de Peaje
- Estructura
- Campos de Validación
- Estados de Cargo
7. Datos de Telemetría GPS
- Estructura
- Sincronización con ERM Karma
- Uso en Validaciones
Relaciones Entre Entidades
Diagrama de Relaciones
Flujo de Datos Principal

1
Configuración Inicial
Entidades: Organizations, Users, Cars, Projects
- Se crea la organización y usuarios
- Se importan vehículos y proyectos desde ERM Karma
- Se configura la integración API
Base de datos preparada para operación.
2
Gestión de Tags
Entidades: tag_assignments, cars
- Se asignan tags a vehículos específicos
- Se define categoría y período de vigencia
- Se mantiene historial de cambios
Las asignaciones correctas son críticas para validaciones precisas.
3
Importación de Cargos
Entidades: toll_charges, tolls
- Se importan cargos desde archivos CSV
- Se asocian con estaciones conocidas
- Se inicia proceso de validación
4
Validación Automática
Entidades: edata_telemetry, toll_charges

- Se obtienen datos GPS relevantes
- Se ejecutan algoritmos de validación
- Se actualizan estados y resultados
5
Revisión y Reportes
Entidades: toll_charges (estados finales)
- Se revisan casos sospechosos manualmente
- Se generan reportes ejecutivos
- Se documentan decisiones para auditoría
Los reportes pueden exportarse a Excel para análisis adicional.
Integridad y Consistencia
Restricciones de Negocio
Unicidad de Tags
Unicidad de Tags
Consistencia Temporal
Consistencia Temporal
Regla: Los cargos solo pueden validarse con datos GPS contemporáneosImplementación:
- Ventana de tiempo configurable para matching
- Validación de timestamps coherentes
- Manejo de zonas horarias
Aislamiento de Organizaciones
Aislamiento de Organizaciones
Regla: Los datos de una organización nunca deben ser visibles para otraImplementación:
- Row Level Security (RLS) en todas las tablas
- Filtrado automático por org_id
- Validación de permisos en cada consulta
Políticas de Retención
- Datos Operativos
- Logs de Sistema
- Reportes Generados
Período: 2 años mínimo
- Cargos de peaje y validaciones
- Datos GPS de telemetría
- Asignaciones de tags
