Saltar al contenido principal

Auditoría y Trazabilidad Inmutable

Uno de los principales objetivos de negocio de RutaViva es garantizar que cualquier tarifa cobrada pueda ser reconstruida con precisión matemática meses o años después de realizado el viaje.


1. La Entidad fare_audit​

Por cada registro en trip_request, la API persiste de forma atómica una fila en fare_audit:

CREATE TABLE fare_audit (
trip_id UUID PRIMARY KEY REFERENCES trip_request(trip_id),
base_fare NUMERIC(10,2) NOT NULL CHECK (base_fare mayor a 0),
multiplier NUMERIC(3,2) NOT NULL CHECK (multiplier BETWEEN 1.0 AND 2.0),
charged_fare NUMERIC(10,2) NOT NULL CHECK (charged_fare mayor a 0),
pressure_index DOUBLE PRECISION NOT NULL,
rain_mm_h DOUBLE PRECISION NOT NULL DEFAULT 0,
rule_version_id INTEGER NOT NULL REFERENCES tariff_rule_version(rule_version_id),
degraded BOOLEAN NOT NULL DEFAULT FALSE
);

2. Reconstrucción de Tarifas (CA-05)​

El endpoint GET /audit/{trip_id} permite leer:

  • Tarifa Base: Ejemplo: \15.000.
  • Multiplicador: Ejemplo: 1.5.
  • Tarifa Cobrada: \15.000 \times 1.5 = \22.500.
  • Factores Operacionales: Presión = 4.0, Lluvia = 5.0 mm/h, Versión de Reglas = 1.
  • Estado de Degradación: Indica si el cálculo provino del worker o fue un fallback seguro (degraded = true).

Principio de Auditoría: La auditoría lee valores históricos persistidos, nunca recalcula en vivo, ya que un recálculo con reglas tarifarias futuras arrojaría un resultado divergente.