EventPass
Estudiantes: Fabian y Rueda
Aplicación publicada (Vercel): https://eventpass-zeta.vercel.app
Repositorio: https://github.com/BL8X3R/eventpass
EventPass es una aplicación web pública para descubrir e inscribirse en eventos de la comunidad tech y de emprendimiento (meetups, hackatones, talleres, networking). El frontend es un cliente estático publicado en Vercel; toda la lógica de negocio vive en n8n: validaciones, estados, cupos, lista de espera, idempotencia, persistencia en Google Sheets y notificaciones por Gmail y Telegram. Un asistente con IA (Google Gemini) responde dudas en modo solo lectura.
Contenido
- Arquitectura general
- Tecnologías
- Workflows, triggers y Google Sheets
- Comunicación frontend → n8n
- Endpoints
- Estados
- Hashing de contraseñas
- Manejo de sesiones
- Idempotencia
- Lista de espera y reasignación
- Servicio central de notificaciones
- Asistente IA y sus restricciones
- Datos de prueba
- Variables de entorno
- Cómo ejecutar el proyecto
- Estructura del repositorio
- Examen — Check-in digital
1. Arquitectura general
Navegador (Vercel: HTML/CSS/JS estático)
│ fetch POST JSON │ Chat (POST /chat)
▼ ▼
┌──────────────────────── n8n (Docker + túnel HTTPS) ────────────────────────┐
│ WF01 Usuarios WF02 Auth WF03 Telegram WF05 Catálogo WF06 Inscrip. │
│ WF04 Admin (Form) WF07 Reasignación (cron) WF08 Recordatorios (cron) │
│ WF10 Assistant (Chat Trigger + Gemini) │
│ │ Execute Sub-workflow │
│ ▼ │
│ WF09 Notificaciones ──► Gmail + Telegram │
└─────────────────────────────────┬──────────────────────────────────────────┘
▼
Google Sheets (10 archivos independientes: EP01 … EP10)
Principios aplicados:
- El frontend es solo cliente. No conoce Google Sheets ni guarda reglas de negocio; envía solicitudes y muestra lo que n8n responde. La sesión en
localStorage es una comodidad: n8n la revalida en cada operación.
- Un archivo de Sheets por dominio. Cada workflow escribe su información principal en su propio archivo; puede leer otros dominios cuando lo necesita (por ejemplo, WF06 lee sesiones, usuarios, vinculaciones y eventos).
- Borrado lógico en todo. Nada se elimina físicamente: usuarios, eventos e inscripciones cambian de estado.
- Notificaciones centralizadas. Ningún workflow envía Gmail o Telegram por su cuenta: todos llaman a WF09.
- Respuestas uniformes. Todos los webhooks responden
{ ok: true, mensaje, data } o { ok: false, error: { codigo, mensaje } } con el código HTTP adecuado (200, 201, 400, 401, 403, 404, 409, 412).
Patrón interno de los workflows con webhook
Para que cada responsabilidad sea identificable, los workflows siguen la misma forma:
Webhook → Leer hojas necesarias → Code "Validar solicitud" → Switch por operación
→ Code de decisión de cada operación → IF → Google Sheets (append/update)
→ Code "Armar respuesta" → Respond to Webhook → (auditoría / notificación)
Cada Code de decisión produce la fila a guardar y, aparte, _body (respuesta HTTP), _auditoria y _notificacion. El nodo Armar respuesta toma la respuesta del nodo de decisión más específico que se ejecutó. La respuesta HTTP se envía antes de auditar y notificar, así una falla de Gmail o Telegram nunca deja al usuario esperando.
2. Tecnologías
| Capa | Tecnología |
|---|
| Frontend | HTML, CSS y JavaScript sin frameworks (módulos ES). Tipografía Archivo (Google Fonts). |
| Publicación | Vercel (build: node scripts/build.mjs → dist/) |
| Orquestación y reglas | n8n 2.x en Docker (Webhook, Form Trigger, Schedule Trigger, Telegram Trigger, Chat Trigger, Execute Sub-workflow, Code, Switch, IF, Filter, Sort, Aggregate, Google Sheets, Gmail, Telegram, AI Agent) |
| Persistencia | Google Sheets (10 archivos) |
| Mensajería | Gmail (OAuth2) y Telegram Bot API |
| IA | Google Gemini (gemini-3.5-flash-lite) mediante el nodo AI Agent de n8n |
| Exposición pública de n8n | Túnel HTTPS de ngrok con dominio estático |
| Generación de workflows | scripts/n8n/ (Node.js): genera, sube y exporta los workflows por la API de n8n |
This is the beginning of the README. Read the rest at the original. Read the full README ↗
