Guía de Comprobación de Integridad del Sistema
Sigue estos 5 pasos para verificar que todo el ecosistema de RutaViva está operando correctamente de punta a punta, sin errores de concurrencia ni brechas en la auditoría inmutable.
1. Ejecución de la Suite de Pruebas Automáticas
Corre las pruebas unitarias y de integración que validan límites regulatorios, orden de factores y seguridad:
uv run pytest services/ -v
Resultado esperado: Todas las pruebas pasan exitosamente (
14 passed).
2. Verificar Flujo de Mensajes en RabbitMQ
Ingresa a la consola web en http://localhost:15672 (credenciales: admin / admin1234).
- En la sección Queues, la cola
telemetria.vehiculosdebe mostrar flujo activo de mensajes generados por el simulador de telemetría y consumidos por el worker de presión (ack en tiempo real).
3. Verificar el Estado Precomputado de Zonas (zone_state)
Consulta la base de datos para confirmar que el worker actualiza las 265 zonas de NYC con su oferta y demanda:
docker exec rutaviva_postgres psql -U admin -d rutaviva_db -c \
"SELECT zone_id, multiplier, pressure_index, free_vehicles, requests_last_10min, computed_at FROM zone_state ORDER BY zone_id ASC LIMIT 5;"
- Los valores de
multiplierdeben encontrarse en el rango legal $[1.0, 2.0]$ (o máximo $1.5$ en horario nocturno según RN-05).
4. Prueba Transaccional Completa (Cotización, Creación y Cancelación)
Paso A: Cotizar y Crear una Solicitud de Viaje (F5, RN-07)
Envía una solicitud para una zona concurrida (ej. Zona 161 - Midtown Manhattan):
curl -s -X POST http://localhost:8000/trip-requests \
-H "Content-Type: application/json" \
-d '{
"zone_id": 161,
"base_fare": 20.0
}'
Respuesta esperada:
{
"trip_id": "03b23c63-11e3-4182-a733-ef903432a101",
"zone_id": 161,
"requested_at": "2026-10-19T11:54:28.357910Z",
"status": "created",
"base_fare": 20.0,
"multiplier": 1.8,
"charged_fare": 36.0,
"degraded": false
}
Paso B: Cancelar la Solicitud (CA 1.2)
Si el pasajero decide no proceder, la solicitud se marca como cancelada sin eliminarse:
curl -s -X POST http://localhost:8000/trip-requests/<TU_TRIP_ID>/cancel
Respuesta esperada:
{
"trip_id": "<TU_TRIP_ID>",
"status": "cancelled"
}
5. Consultar la Auditoría Inmutable (RN-12, RNF-06)
Usa el trip_id generado para validar la trazabilidad exacta del cálculo tarifario mediante credenciales de rol auditor:
curl -s -X GET http://localhost:8000/audit/<TU_TRIP_ID> \
-H "X-Auditor-Role: auditor" \
-H "X-Auditor-Key: auditor-secret-token"
Respuesta esperada:
{
"trip_id": "<TU_TRIP_ID>",
"base_fare": 20.0,
"multiplier": 1.8,
"charged_fare": 36.0,
"pressure_index": 1.45,
"rain_mm_h": 0.0,
"rule_version_id": 1,
"created_at": "..."
}
(Cualquier intento sin cabeceras o con rol inválido responderá HTTP 403 Forbidden).