RutaViva Mobility · Plataforma de Datos y Tarifas Dinámicas
Bienvenido al centro oficial de documentación técnica de RutaViva Mobility, plataforma integral para la gestión de flota (~8,000 vehículos), ingesta de telemetría GPS en tiempo real, tarificación dinámica (surge pricing) y analítica de datos.
🎯 Objetivos de la Plataforma
- Reducción del Tiempo de Espera: Disminuir el tiempo promedio de espera en horas pico en un 25% optimizando la asignación y reposicionamiento de la flota.
- Utilización Eficiente: Aumentar la utilización de vehículos en horas valle en un 15%.
- Auditoría Transaccional Inmutable: Garantizar que cada tarifa cobrada sea reconstruible y auditable matemáticamente (factores de presión, clima, multiplicador exacto y versión de reglas).
- Automatización Regulatoria: Generación periódica y automática de reportes de calidad de servicio para la autoridad de tránsito.
🏗️ Mapa de Navegación
📦 Estado Actual del Sistema (Sprint 2 Completado)
- Infraestructura Base Unificada: Contenedores en Docker Compose con PostgreSQL 16 (13 entidades operacionales modeladas mediante Alembic) y RabbitMQ 3.12 con red interna compartida (
rutaviva_network). - Seed CLI: Poblamiento idempotente y determinista del catálogo espacial de NYC y 8,000 conductores sintéticos con integridad referencial y filtro legal (RN-09).
- Simulador de Telemetría: Motor asíncrono con R-Tree espacial (
GeoPandas) publicando cada 15s hacia RabbitMQ con inyección configurable de defectos (HU-02). - Pressure Worker: Consumidor asíncrono continuo de eventos GPS y cálculo de ventanas móviles de presión, factores climáticos, topes regulatorios y persistencia atómica en
zone_state. - API de Multiplicador & Auditoría: Microservicio FastAPI en capas con cotización en tiempo real, creación transaccional de viajes (
POST /trip-requests, RN-07, RN-12), auditoría matemática inmutable (GET /audit/{trip_id}, CA-05) y seguridad restringida para rol auditor (RNF-06). - Simulador de Solicitudes: Emulador concurrente de demanda y ráfagas masivas configurables (
HU-01,CA-10). - Suite de Pruebas Automatizadas: 14 tests automatizados con
pytestcubriendo las reglas de negocio y criterios de aceptación.