Axtra Access — Sistema Multi-Tenant de Eventos, Control de Aforo y QR con Telegram Mini App
FastAPI · Telegram Mini App · PostgreSQL RLS · Concurrencia
Plataforma integral multi-tenant para productoras de eventos, discotecas y organizadores. Combina un bot interactivo de Telegram con roles jerárquicos (Admin, Promotor, Operador en puerta), una Telegram Mini App con escáner QR en cámara, base de datos PostgreSQL con Row-Level Security (RLS) nativo y control de aforo en tiempo real con bloqueo pesimista (SELECT ... FOR UPDATE) para prevenir sobreventas.
El Desafío Operativo
En eventos masivos y locales nocturnos, la reventa de entradas falsas, la duplicación de pases QR y el descontrol en listas de promotores causan pérdidas económicas, colapso de filas en puerta y sanciones por superar el aforo permitido por ley. Los sistemas tradicionales requieren instalar aplicaciones móviles pesadas o no aíslan la información de distintas marcas y locales.
La Solución de Ingeniería
Se diseñó un ecosistema Telegram-First donde el equipo no instala nada externo. El administrador gestiona marcas, tipos de entrada y comisiones desde el bot; los promotores registran invitados y generan pases QR dinámicos; y los operadores validan accesos desde la Telegram Mini App escaneando con la cámara de su celular. A nivel de infraestructura, PostgreSQL aplica políticas de Row-Level Security (RLS) que aíslan la información de cada negocio en el motor de base de datos, y transacciones atómicas con bloqueo pesimista garantizan que el aforo nunca supere la capacidad autorizada.
Decisiones de Arquitectura & Componentes Críticos
Implementación modular y decisiones técnicas orientadas a resiliencia, mantenibilidad y consistencia transaccional.
Row-Level Security (RLS) Nativo en PostgreSQL
Aislamiento multi-tenant forzado a nivel de motor SQL mediante SET app.current_marca_id, garantizando que ninguna consulta o reporte filtre datos entre marcas rivales.
Control Estricto de Aforo con Bloqueo Pesimista (SELECT ... FOR UPDATE)
Algoritmo de concurrencia transaccional en PostgreSQL probado bajo estrés para prevenir condiciones de carrera y sobreventa ante escaneos simultáneos en múltiples puertas.
Telegram Mini App (WebApp) con Escáner QR en Cámara
Interfaz oscura en HTML5 y JavaScript embebida en Telegram para operadores de puerta con detección de fraudes en tiempo real y modo de contingencia sin QR.
Composición Automatizada de Entradas y Calibrador Visual
Motor de renderizado en Python (Pillow + qrcode) que superpone nombres y códigos QR dinámicos sobre flyers del evento con cuadrícula de calibración milimétrica.
Stack Tecnológico Utilizado
Lenguajes, frameworks, bases de datos y librerías utilizadas en la implementación de este proyecto:
Auditoría de Código y Repositorio en GitHub
Revisa la estructura de carpetas, tests unitarios, Dockerfile y documentación técnica directamente en el repositorio público.
¿Planeas implementar un sistema con este nivel de arquitectura?
Diseño y desarrollo sistemas de software a medida, APIs transaccionales y automatización de datos para empresas y proyectos en Tacna y todo el Perú.