Documento técnico · Propuesta

Arquitectura de la plataforma CTM

Cómo se conectan la app del pasajero, las terminales de autoservicio, los validadores de los buses y el panel de administración. Una sola cuenta, un solo saldo y un registro auditable de cada venta y cada abordaje.

Se compra solo en la terminal Se paga con el saldo de la cuenta Capacidad por cantidad, sin asientos El validador nunca cobra

Arquitectura de referencia para la etapa de propuesta. Las cifras de la demo son ficticias y las decisiones marcadas como pendientes se definen con CTM.

01 · Vista del sistema

Cuatro canales, un mismo núcleo

Cada dispositivo habla con una API única. Los servicios publican eventos (venta, abordaje, recarga) que alimentan la app, el panel y la conciliación sin acoplarse entre sí. Toque un bloque para ver su responsabilidad.

02 · Secuencia

Una compra en la terminal, de punta a punta

La capacidad y el saldo se descuentan en una sola transacción: o se emite el boleto completo o no se cobra nada. Cada solicitud lleva una clave de idempotencia para que un reintento de la terminal no duplique el cobro.

Pulse reproducir o recorra los pasos.

Atomicidad

Bloqueo de la fila de la salida y del saldo de la cuenta dentro de la misma transacción de PostgreSQL. Sin sobreventa aunque dos terminales vendan a la vez.

Idempotencia

La terminal genera un identificador por intento. Si se corta la red y reintenta, la API devuelve el mismo boleto en lugar de cobrar dos veces.

Reimpresión sin cobro

Si la impresora falla, el boleto ya existe y se reimprime desde la terminal o se usa el QR de la app. Nunca se emite un segundo cargo.

03 · Modelo de datos

Entidades principales

El saldo no es un número editable: se calcula desde un libro de movimientos inmutable (recargas, compras, reembolsos). Pase el cursor por una relación para resaltar la entidad vinculada.

04 · Operación en ruta

El validador sigue funcionando sin señal

Antes de cada salida el validador descarga la lista firmada de boletos de esa salida. En zonas sin cobertura valida contra esa lista, guarda los abordajes en cola y los sincroniza al recuperar la conexión.

Reglas del modo sin conexión

  • Valida firma y versión del QR localmente; un ticket impreso reportado como perdido queda anulado por versión.
  • Marca el boleto como usado en el dispositivo para impedir un segundo uso en el mismo bus.
  • Una compra posterior a la última descarga no está en la lista local: el procedimiento asistido se define con CTM.
  • Al reconectar, el servidor es la fuente de verdad: si dos validadores registraron el mismo boleto, gana el primer abordaje y el otro queda como incidencia.
  • Nunca descuenta saldo, ni con conexión ni sin ella.

Estado actual de la flota datos de la demo

Probar el validador sin conexión
05 · Seguridad y datos personales

Diseñada para no guardar lo que no necesita

Biometría, tarjetas y saldo son datos sensibles. La plataforma los aísla, los cifra y deja constancia de cada acceso.

Biometría como plantilla

Se guarda una plantilla matemática cifrada, nunca la foto ni la imagen de la huella. Requiere consentimiento expreso, se puede revocar desde la app y siempre existe un medio alternativo (tarjeta o QR).

Tarjetas tokenizadas

La tarjeta CTM solo contiene un token que identifica la cuenta. No almacena saldo ni datos personales: si se pierde, se bloquea el token y se emite una reposición.

QR firmados y versionados

El QR del boleto lleva identificador, versión y firma. Al reportar un ticket perdido sube la versión y el papel deja de valer, mientras el QR de la app sigue activo. El QR de cuenta rota cada 30 segundos.

Roles y permisos

Siete roles con permisos por módulo. Nadie puede editar un saldo ni ver datos biométricos desde el panel; las anulaciones exigen motivo.

Auditoría inmutable

Cada venta, anulación, bloqueo, cambio de tarifa o de permisos queda registrado con usuario, fecha, dispositivo y detalle. El registro solo admite inserciones.

Cifrado y sesiones

TLS en todos los canales, cifrado en reposo de la base de datos, dispositivos registrados con certificado propio y sesiones del panel con doble factor.

Cumplimiento normativo por validar. El tratamiento de datos biométricos y personales debe alinearse con la Ley Orgánica de Protección de Datos Personales del Ecuador. Las condiciones exactas (consentimiento, retención, responsables) forman parte de las decisiones pendientes.

Matriz de permisos vista resumida de la demo · editable en el panel

06 · Integraciones

Lo que se conecta por fuera

Cada integración vive detrás de un adaptador. Cambiar de proveedor de pagos o de mensajería no toca la lógica de ventas.

07 · Escalabilidad e infraestructura

Contenedores, una base sólida y crecimiento horizontal

La API no guarda estado: se agregan réplicas detrás del proxy cuando sube la demanda. PostgreSQL es la fuente de verdad, con réplica de lectura para reportes y respaldos automáticos.

Estimador de carga orientativo

Supone 1,6 boletos por compra, 1 KB por boleto y 3 eventos por boleto. El volumen real es una decisión pendiente (punto 12).

Esta demostración

  • Sitio estático servido por nginx en un contenedor Docker, desplegable con Dokploy.
  • Sin servidor de aplicación: los datos ficticios viven en el navegador y se comparten entre pestañas.
  • La app, la terminal, el validador y el panel leen el mismo almacén, así una compra aparece al instante en todas las vistas.
  • En producción, ese almacén se reemplaza por la API y PostgreSQL descritos arriba.
08 · Por definir con CTM

Decisiones pendientes

Estas preguntas condicionan el diseño final. La demo usa supuestos explícitos y no inventa respuestas. Filtre por el componente afectado.

Pendientes comerciales

No se ha decidido licencia, desarrollo contratado, servicio gestionado, alojamiento, propiedad intelectual, mantenimiento ni soporte. No se presentan precios ni compromisos de entrega como aprobados.

Descartado por el cliente

Las dudas pendientes no reabren estas opciones.