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

1. Arquitectura general
2. Tecnologías
3. Workflows, triggers y Google Sheets
4. Comunicación frontend → n8n
5. Endpoints
6. Estados
7. Hashing de contraseñas
8. Manejo de sesiones
9. Idempotencia
10. Lista de espera y reasignación
11. Servicio central de notificaciones
12. Asistente IA y sus restricciones
13. Datos de prueba
14. Variables de entorno
15. Cómo ejecutar el proyecto
16. Estructura del repositorio
17. 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

여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗