Simulador de Telemetría GPS (services/telemetry_simulator/)
Motor asíncrono en Python que emula la cinemática de ~8,000 vehículos y emite pulsos de ubicación y estado cada 15 segundos hacia RabbitMQ.
1. Tareas Técnicas Cubiertas (Jira / Scrum)
RWI-38— movement generator within zone polygons: Cinemática polar proyectada a coordenadas decimales con rebote en las fronteras de la ciudad y resolución de zona en microsegundos mediante R-Tree (ZoneLocator).RWI-39— free/occupied/out-of-service state machine: Máquina de estados con matriz estocástica markoviana (available,busy,offline,maintenance).RWI-40— injection of "silent" vehicles and invalid coordinates: Motor de inyección de anomalías disjuntas (silent_idsyout_of_city_ids) con temporizador de retardo configurable (DEFECT_DELAY_SECONDS).
2. Arquitectura y Flujo de Ejecución
3. Contrato del Mensaje JSON
Los mensajes emitidos hacia el exchange telemetria.viajes cumplen con el siguiente contrato:
{
"vehicle_id": "4b68e547-3844-5d9c-bd18-4712534a17bd",
"zone_id": 142,
"lat": 40.771234,
"lon": -73.985671,
"status": "available",
"last_seen_at": "2026-10-13T12:00:00.123456+00:00"
}
4. Pruebas Automatizadas
uv run pytest services/telemetry_simulator/tests/ -v
Casos de prueba verificados:
test_mensaje_tiene_los_campos_del_contrato: Validación estricta de claves y tipos.test_los_vehiculos_siempre_se_mueven_dentro_de_la_ciudad: Cinemática confinada en cuadrante urbano.test_porcentajes_de_defectos_son_exactos_y_disjuntos: Verificación de conjuntos disjuntos.test_coordenadas_defectuosas_quedan_fuera_de_la_ciudad: Validación de anomalías espaciales.