Solución de referencia — Laboratorio 2: motor de rutas

FILTRO        elimina rutas. No se compensa con nada.
FACTOR        ordena las rutas que quedan.

SI SE PONDERAN LOS FILTROS
  una ruta muy barata que no soporta un control exigido
  puede ganar la comparación
  → el motor elige una operación no autorizada

def elegir(pago: Pago, rutas: list[Ruta], pesos: Pesos) -> Decision:
    elegibles = [r for r in rutas if r.admite(pago)]
    if not elegibles:
        return Decision(None, None, motivo="ninguna ruta admite este pago")

    conformes = [r for r in elegibles if r.soporta(pago.controles)]
    if not conformes:
        return Decision(None, None,
                        motivo=f"ninguna ruta soporta {pago.controles}")

    disponibles = [r for r in conformes if r.disponible_ahora()]
    if not disponibles:
        return Decision(None, None, motivo="todas las rutas no disponibles")

    # Regla de la clase 14: el enlace directo gana antes de ponderar.
    enlaces = [r for r in disponibles if r.tipo == "enlace_pagos_inmediatos"]
    if enlaces:
        elegida = min(enlaces, key=lambda r: r.coste_total(pago))
        return Decision(elegida, _siguiente(disponibles, elegida),
                        motivo="enlace de pagos inmediatos disponible")

    ordenadas = sorted(disponibles, key=lambda r: r.puntuacion(pago, pesos))
    return Decision(ordenadas[0], ordenadas[1] if len(ordenadas) > 1 else None,
                    motivo=_explicar(ordenadas[0], ordenadas, pesos))

BIEN   «enlace de pagos inmediatos disponible»
BIEN   «menor coste total (2,4 % frente a 3,1 %) con plazo dentro
        del compromiso; la alternativa es 6 h más rápida y 0,7 pp más cara»
MAL    «mejor puntuación»
MAL    «ruta preferente»

def test_un_filtro_no_se_compensa_con_precio(motor):
    barata_no_conforme = Ruta(coste=0.001, soporta_travel_rule=False)
    cara_conforme = Ruta(coste=0.05, soporta_travel_rule=True)
    pago = Pago(controles={"travel_rule"})

    decision = motor.elegir(pago, [barata_no_conforme, cara_conforme])

    assert decision.ruta is cara_conforme


def test_cambiar_un_peso_cambia_la_eleccion(motor):
    rapida_cara = Ruta(plazo_h=1, coste=0.04)
    lenta_barata = Ruta(plazo_h=30, coste=0.012)

    con_prisa = motor.elegir(pago, [rapida_cara, lenta_barata],
                             Pesos(tiempo=0.8, coste=0.2))
    con_precio = motor.elegir(pago, [rapida_cara, lenta_barata],
                              Pesos(tiempo=0.2, coste=0.8))

    assert con_prisa.ruta is rapida_cara
    assert con_precio.ruta is lenta_barata

{
  "version": "2026-08-06",
  "pesos": { "tiempo": 0.35, "coste": 0.50, "riesgo": 0.15 },
  "motivo_del_cambio": "el coste pesa mas tras la queja de la asociacion",
  "aprobado_por": "comite de pagos",
  "vigente_desde": "2026-08-06"
}