Laboratorio simulado
Pruebe failover sin riesgo
Fuerce un error en el adaptador de voz y observe cómo Router-Z intenta el siguiente canal, con evidencia registrada por cada intento.
Serie 01 · Build a Tiny CPaaS · Capítulo 3 de 5 · Routing
Decida el canal y registre la evidencia
Aprenda a separar la decisión de enrutamiento de la ejecución del canal. El router evalúa la política, verifica la firma y delega a un adaptador. Cada decisión produce una evidencia auditable para medición y multitenencia. Plataforma Mobiconnect: Business API y AI sobre Open Telco, Open API, CAMARA y GSMA Open Gateway.
Avanzado
Sandbox simulado
Alcance verificado. Esta lección se ejecuta en el navegador, con datos simulados. Sin APIs CAMARA productivas desde la academia. Sin Entitlements pagados en ub3r.io; el cobro vía Entitlements se configura en el Hub. Rendimiento y disponibilidad: NO MEDIDO.
01 · Objetivos
Qué construirá en esta lección
Al finalizar, usted distinguirá tres responsabilidades: decidir, ejecutar y registrar. Esta separación permite cambiar de canal sin reescribir la lógica de negocio y facilita la auditoría por tenant.
- Decidir: evaluar tenant, channels y policy sin efectos secundarios.
- Ejecutar: delegar a un único adaptador por intento (voz, mensajería o QoD simulado).
- Registrar: añadir al ledger un evento por cada intento, exitoso o no.
Políticas admitidas en el simulador
| Política | Comportamiento | Uso |
|---|---|---|
| verified-only | Solo enruta si la firma, el antirrepetición, el tenant y el canal se verifican correctamente. En caso contrario, registra el rechazo y no ejecuta. | Por defecto. Recomendada. |
| least-cost | Ordena los canales por coste configurado y prueba uno a la vez, en orden. | Coste [por validar] en sandbox. |
| failover | Si el adaptador probado devuelve error, intenta el siguiente canal disponible. Cada intento queda registrado; solo puede haber un resultado exitoso por mensaje. | Requiere evidencia por intento. |
02 · Diagrama
Cómo decide Router-Z
El mensaje ingresa una sola vez. Router-Z evalúa la política, verifica firma, antirrepetición, tenant y canal; después, un adaptador ejecuta por intento. En modo failover puede haber varios intentos sucesivos, pero solo uno puede resultar exitoso. El ledger y la medición observan, no deciden.
Lea el diagrama asíLa API aporta el contexto del tenant de ejemplo. Router-Z aplica la política y verifica firma, antirrepetición, tenant y canal. El adaptador probado ejecuta el intento. Ledger y Metering reciben la misma evidencia por cada intento.
Error frecuenteMezclar decisión y ejecución en el adaptador impide auditar y cambiar de canal sin riesgo. Mantenga la decisión pura, verificable y registre cada intento, no solo el resultado final.
03 · Pseudocódigo de referencia
El contrato mínimo de Router-Z
Pseudocódigo — no se ejecuta en esta páginaTres funciones, un contrato. El bloque siguiente describe el comportamiento evaluado en los ejercicios de esta lección como referencia conceptual; no corresponde a código ejecutado en el navegador.
// router.pseudo — contrato de referencia, no ejecutado en esta página
const route = router.route(msg, {
tenant: "tenant-demo",
channels: ["voice", "messaging", "qod"],
policy: "verified-only"
});
for (const intento of route.intentos) {
ledger.append(intento.evidencia); // se registra cada intento
if (intento.verified) {
adapter.execute(intento.channel, msg);
break; // un único intento exitoso posible
}
}Campos de la evidencia por intento
| Campo | Contenido |
|---|---|
| tenant | Identificador del tenant de ejemplo. Sin datos personales. |
| channel | Canal probado en este intento: voz, mensajería o QoD simulado. |
| policy | Política aplicada y orden de evaluación. |
| verified | Resultado booleano de la verificación de firma, antirrepetición, tenant y canal. |
| rejection | Motivo registrado cuando verified es falso. |
Regla de cobro. Sin Entitlements pagados en ub3r.io. La medición de esta lección es didáctica; el cobro vía Entitlements se configura en el Hub. Ver producto.
04 · Ejercicios calificados
Ejercicio 3.1 — Seleccione y justifique el canal
Lea el caso, seleccione una opción, redacte su justificación y compruebe su criterio con la solución. El resultado no se envía a ningún servidor; contenido y solución visibles sin JavaScript.
Ver solución y explicación — Ejercicio 3.1
Respuesta correcta: A. Con failover, Router-Z prueba los canales en el orden declarado tras cada fallo. Mensajería es el siguiente canal en la lista y no se ha agotado. La opción B viola el contrato de un intento por canal antes de avanzar. La opción C omite el orden declarado sin justificación de política.
Progreso local. Al comprobar el ejercicio 3.1, esta página marca el capítulo 3 como «en curso» únicamente en este navegador, sin enviar datos a ningún servidor.
Lista de comprobación
- intento 1 → channel: voice → verified: false
- ledger.append(rejection: "adapter-error")
- intento 2 → channel: messaging → verified: true
- ledger.append(evidence: "executed")
- Resultado: un único intento exitoso registrado
05 · Siguiente paso
Continúe la serie
Practique el mismo contrato con fallos de adaptador en el laboratorio simulado, o revise el catálogo completo.
Capítulo 4 de 5
Medición por tenant
Convierta la evidencia de esta lección en cargos auditables con límites configurables mediante Entitlements.
Producto
De aprender a construir
Explore cómo el mismo contrato de Router-Z se traslada al producto de Mobiconnect, con Entitlements configurables por tenant.