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.
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.
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.
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.
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ónDiseñ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.
Matriz de permisos vista resumida de la demo · editable en el panel
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.
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.
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.