1. Que es Nvito
Nvito es una plataforma SaaS multi-tenant integral para crear, gestionar y vivir eventos sociales. Permite a los usuarios disenar invitaciones digitales personalizadas, gestionar invitados y confirmaciones (RSVP), coordinar logistica del evento, interactuar en tiempo real el día del evento y analizar resultados — todo desde un solo ecosistema con generación asistida por inteligencia artificial.
La plataforma está compuestá por seis aplicaciones principales:
| Aplicación | Descripción |
|---|---|
| nvito-api | Backend centralizado (API REST) que gestióna toda la lógica de negocio, datos, integraciones y servicios |
| nvito-admin | Dashboard administrativo donde los usuarios crean, configuran y gestiónan sus eventos e invitaciones |
| nvito-invitations | Servidor público que renderiza los micrositios de invitación para los invitados finales |
| nvito-client | App movil nativa (iOS/Android) para interacción en tiempo real el día del evento: check-in QR, galería, audio guestbook, push |
| nvito-pwa | Progressive Web App (Next.js + BFF) que replica la funcionalidad de nvito-client accesible via URL sin instalación |
| nvito-landing | Landing page pública de Nvito (nvito.mx). Sitio Coming Soon con animaciones cinematograficas, zero JavaScript, desplegado en Cloudflare Pages. |
Propuestá de valor
- Elimina la rigidez - Usa IA para generar micrositios personalizados desde lenguaje natural
- Unifica la experiencia - Un solo lugar para invitación, RSVP, galería, música y logistica
- Automatiza la gestión - Confirmaciones inteligentes, estadisticas en tiempo real
- Optimiza para movil - Diseño mobile-first con rendimiento excepcional
- Escala con el negocio - Modelo multi-tenant para B2C y marca blanca B2B
2. Problema que Resuelve
Las soluciones actuales de invitaciones (tanto fisicas como digitales) presentan limitaciones significativas:
| Problema | Impacto |
|---|---|
| Invitaciones fisicas costosas | Impresion, diseño y envio representan un gasto elevado y tiempos largos de producción |
| Plantillas rigidas | Las alternativas digitales existentes no permiten personalización más alla de textos y colores predefinidos |
| Sin inteligencia | No existe asistencia para crear contenido o diseño; todo es manual |
| Gestión manual de invitados | RSVPs, listas de invitados y logistica requieren hojas de calculo y trabajo manual |
| Fragmentacion de herramientas | Se necesitan múltiples aplicaciones para invitación, RSVP, fotos, música, mesa de regalos |
| Experiencia movil deficiente | Muchos sitios no estan optimizados para el uso mayoritario en dispositivos moviles |
| Sin analiticas | No hay visibilidad sobre quien abrio la invitación, quien confirmo, ni metricas de engagement |
Nvito resuelve todo esto al ofrecer una solución integral que combina creación con IA, gestión de invitados, RSVP, analiticas y distribución en una sola plataforma.
3. Tipos de Eventos Soportados
La plataforma soporta 14 tipos de eventos, cada uno con secciones y configuraciones específicas:
| # | Tipo de Evento | Descripción | Secciones Tipicas |
|---|---|---|---|
| 1 | Boda | Ceremonias de matrimonio | Hero, Nuestra Historia, Itinerario, Galería, RSVP, Hospedaje, Mesa de Regalos |
| 2 | XV Años | Fiestás de quinceañera | Hero, Mensaje, Itinerario, Galería, RSVP, Mesa de Regalos, Dress Code |
| 3 | Bautizo | Ceremonias de bautismo | Hero, Mensaje, Padrinos, Itinerario, RSVP, Galería |
| 4 | Cumpleaños | Fiestás de cumpleaños | Hero, Mensaje, Itinerario, RSVP, Galería |
| 5 | Primera Comunión | Ceremonias religiosas | Hero, Mensaje, Itinerario, RSVP, Galería |
| 6 | Baby Shower | Celebración pre-bebé | Hero, Mensaje, Juegos, RSVP, Mesa de Regalos |
| 7 | Graduación | Ceremonias y fiestás de graduación | Hero, Mensaje, Itinerario, RSVP, Galería |
| 8 | Confirmación | Ceremonias religiosas de confirmación | Hero, Padrinos, Itinerario, RSVP, Galería |
| 9 | Aniversario | Celebraciones de aniversario | Hero, Nuestra Historia, Timeline, Galería, RSVP |
| 10 | Revelación de Género | Gender reveal parties | Hero, Mensaje Sorpresa, Countdown, Galería, RSVP |
| 11 | Fiestá de Compromiso | Fiestás de compromiso / engagement | Hero, Nuestra Historia, Itinerario, Galería, RSVP |
| 12 | Despedida de Soltera/o | Despedidas previas a la boda | Hero, Itinerario, Dress Code, Ubicaciones, RSVP |
| 13 | Evento Corporativo | Eventos empresariales y conferencias | Hero, Agenda, Ubicación, Registro de Asistentes |
| 14 | Otro | Eventos personalizados | Configurable según necesidad del usuario |
4. Actores del Sistema
4.1 Roles y responsabilidades
| Actor | Nivel | Responsabilidades principales |
|---|---|---|
| Super Admin | Plataforma | Administración global de la plataforma, gestión de tenants, templates, configuración del sistema |
| Platform Admin | Plataforma | Administrador de plataforma, lectura cross-org, escritura en organizaciones asignadas |
| Organization Owner | Organización | Propietario de la organización, gestión completa de su tenant, facturacion, miembros |
| Organization Admin | Organización | Ayuda a gestionar la organización, puede crear eventos y gestionar miembros |
| Event Manager | Evento | Crea y gestióna eventos, configura invitaciones, administra invitados |
| Event Editor | Evento | Edita contenido de invitaciones y eventos asignados |
| Event Collaborator | Evento | Colabora en la gestión de invitados y RSVPs |
| Event Viewer | Evento | Solo lectura, puede ver información del evento y estadisticas |
| Guest (Invitado) | Publico | Recibe la invitación, visualiza el micrositio, confirma asistencia (RSVP) |
4.2 Diagrama de actores e interacciones
Actores y Roles del Sistema
Plataforma
Super AdminAcceso total a la plataforma
Platform AdminGestiona organizaciones asignadas
Organizacion
OwnerDueno de la organizacion
AdminAdministrador de organizacion
Evento
ManagerGestiona todo el evento
EditorEdita contenido del evento
Evento
CollaboratorColabora en tareas especificas
ViewerSolo lectura
Actores Externos
HostAnfitrion / Cliente contratante
GuestInvitado al evento
5. Alcance Actual (V1)
5.1 Estado del proyecto
El MVP de Nvito está completado y se encuentra actualmente en fase de pruebas con los siguientes entornos disponibles:
| Entorno | Proposito | Estado |
|---|---|---|
| LOCAL | Desarrollo local con Docker Compose | Activo |
| DEV | Entorno de desarrollo remoto compartido | Activo |
| TEST | Entorno de pruebas pre-producción | Activo |
| PRODUCTION | Entorno de producción | Pendiente |
Metricas de calidad
| Proyecto | Test Suites | Tests | Pass Rate | Cobertura |
|---|---|---|---|---|
| nvito-api | 233 | ~3,800 | 100% | 116/116 servicios, 48/48 controllers |
| nvito-admin | 140 | 1,378 | 100% | 33/33 services, 17/17 actions, 16/16 schemas |
| nvito-invitations | 16 | 180 | 100% | 6/6 servicios, 5/5 schemas |
| nvito-client | 29 | 223 | 100% | 7/7 servicios, 3/3 schemas |
| nvito-pwa | 18 | 204 | 100% | 8/8 servicios, BFF security |
Todos los proyectos mantienen TypeScript strict mode, 0 as any en producción, y JSDoc en español.
5.2 Funcionalidades core implementadas
| Categoría | Funcionalidades |
|---|---|
| Autenticación | Registro, login, gestión de sesiones via Clerk, roles y permisos |
| Eventos | CRUD completo de eventos, 14 tipos soportados, configuración avanzada |
| Invitaciones | Creación con IA, editor visual, publicación, preview, temas y estilos |
| Secciones | Hero, historia, itinerario, galería, RSVP, hospedaje, mesa de regalos, dress code |
| Invitados | CRUD, importación Excel, agrupación por familias, pases individuales |
| RSVP | Confirmación publica, estadisticas, filtros, notificaciones |
| Plantillas | Sistema de templates predefinidos por tipo de evento |
| Generación IA | Generación de invitaciones desde lenguaje natural con GPT-4o y Claude |
5.3 Funcionalidades adicionales implementadas
| Categoría | Funcionalidades |
|---|---|
| Mesa de regalos | Registro de regalos con enlaces externos |
| Hospedaje | Información de alojamiento para invitados foraneos |
| Mesas/Seating | Asignación de invitados a mesas para el evento |
| QR Check-in | Generación de códigos QR por invitado para check-in en el evento |
| Analiticas | Vistas de invitación, tasas de RSVP, metricas de engagement |
| Ubicaciones | Integración con mapas (Mapbox), GPS y "Como llegar" |
| Multimedia | Upload de fotos, galería, reproductor de música embebido |
| Notificaciones | Email transaccional (registro, RSVP, recordatorios) |
| Envio de invitaciones via Twilio WhatsApp API | |
| Pagos | Links de pago y procesamiento via Stripe, webhooks de estado |
| Push Notif. | Notificaciones push a la app movil via Expo Push API |
5.4 Excluido del MVP (Post-V1)
| Funcionalidad | Razon |
|---|---|
| Sistema de suscripciones recurrentes | Implementación parcial con Stripe (links de pago), suscripciones recurrentes pendientes |
| White-label B2B completo | Complejidad adicional para primera versión |
Nota: Pagos con Stripe y App movil nativa (nvito-client) fueron originalmente excluidos del MVP pero ya estan implementados.
6. Stack Tecnologico
6.1 Backend (nvito-api)
| Tecnologia | Versión | Proposito |
|---|---|---|
| NestJS | 11.x | Framework backend, arquitectura modular |
| TypeScript | 5.7 | Lenguaje principal, tipado estático |
| Prisma | 5.22 | ORM para acceso a base de datos |
| PostgreSQL | 15 | Base de datos relacional principal |
| Bull | 4.x | Sistema de colas para tareas asincronas |
| Redis | 7.x | Cache, colas de trabajo, sesiones |
| nodemailer | 8.x | Envio de correos electronicos (SMTP) |
| Twilio | 5.x | Envio de mensajes WhatsApp |
| OpenAI SDK | 6.x | Integración con GPT-4o para generación IA |
| Anthropic SDK | 0.71 | Integración con Claude Sonnet 4.6 para generación IA |
| Stripe | 20.x | Procesamiento de pagos y suscripciones |
| Sharp | 0.34 | Procesamiento y optimizacion de imagenes |
| QRCode | 1.5 | Generación de códigos QR para check-in |
| Zod | 4.x | Validación de esquemas |
| Winston | 3.x | Sistema de logging estructurado |
| Swagger | 11.x | Documentación automática de la API |
| Helmet | 8.x | Seguridad HTTP headers |
6.2 Frontend Admin (nvito-admin)
| Tecnologia | Versión | Proposito |
|---|---|---|
| Next.js | 16.1 | Framework React con App Router + Server Actions |
| React | 19.2 | Libreria de interfaces de usuario |
| React Compiler | - | Memoizacion automática de componentes |
| TypeScript | 5.x | Lenguaje principal (strict mode) |
| Tailwind CSS | 4.x | Framework de estilos utility-first |
| shadcn/ui | - | Componentes de UI basados en Radix |
| Radix UI | Multiples | Primitivos de UI accesibles |
| TanStack React Query | 5.x | Gestión de estado del servidor y cache |
| React Hook Form | 7.x | Gestión de formularios |
| Clerk | 6.x | Autenticación y gestión de usuarios |
| Zod | 4.x | Validación (formularios + server actions + response) |
| Recharts | 3.x | Graficas y visualización de datos |
| Framer Motion | 12.x | Animaciones |
| Lucide React | 0.563 | Iconografia |
| date-fns | 4.x | Manipulacion de fechas |
| dnd-kit | 6.x | Drag and drop (reordenamiento de secciones) |
| Vitest | 4.x | Framework de testing (140 suites, 1,378 tests) |
6.3 Frontend Invitaciones (nvito-invitations)
| Tecnologia | Versión | Proposito |
|---|---|---|
| Next.js | 16.1 | Framework React con SSR/SSG |
| React | 19.2 | Libreria de interfaces de usuario |
| TypeScript | 5.x | Lenguaje principal |
| Tailwind CSS | 3.4 | Framework de estilos utility-first |
| ua-parser-js | 2.x | Detección de dispositivo del invitado |
6.4 App Movil (nvito-client)
| Tecnologia | Versión | Proposito |
|---|---|---|
| Expo | 54.x | Plataforma de desarrollo React Native |
| React Native | 0.81.x | Framework de UI nativa |
| TypeScript | 5.9 | Lenguaje principal |
| Expo Router | 6.x | Navegación file-based |
| NativeWind | 4.x | Tailwind CSS para React Native |
| TanStack React Query | 5.x | Cache y fetching de datos |
| expo-camera | 17.x | Escaneo QR y captura de fotos |
| expo-av | 16.x | Grabacion y reproducción de audio |
| expo-notifications | 0.32.x | Push notifications via Expo Push API |
| expo-secure-store | 15.x | Almacenamiento seguro de tokens |
| date-fns | 4.x | Formateo de fechas |
| Zod | 4.x | Validación de esquemas |
6.5 PWA (nvito-pwa)
| Tecnologia | Versión | Proposito |
|---|---|---|
| Next.js | 16.1 | Framework React con App Router + BFF proxy |
| React | 19.2 | Libreria de interfaces de usuario |
| TypeScript | 5.x | Lenguaje principal (strict mode) |
| Tailwind CSS | 4.x | Framework de estilos utility-first |
| TanStack React Query | 5.x | Cache y fetching de datos |
| Zod | 4.x | Validación de schemas |
| html5-qrcode | 2.x | Escaneo QR via MediaDevices API |
| Vitest | 4.x | Framework de testing (18 suites, 204 tests) |
6.6 Infraestructura y servicios
| Tecnologia | Proposito |
|---|---|
| Clerk | Autenticación, gestión de usuarios y sesiones |
| Cloudflare R2 | Almacenamiento de objetos (imagenes, archivos) en producción |
| MinIO | Almacenamiento S3-compatible para desarrollo local |
| MailDev | Servidor SMTP local para pruebas de email en desarrollo |
| Mailtrap | Servicio de email para entornos DEV y TEST |
| Twilio | API de WhatsApp para envio de invitaciones |
| Mapbox | Servicio de mapas y geocodificacion |
| OpenAI (GPT-4o) | Modelo de IA para generación de contenido e invitaciones |
| Anthropic (Claude Sonnet 4.6) | Modelo de IA alternativo para generación |
| Stripe | Procesamiento de pagos y links de pago |
| GitLab CI | Pipeline de integración y despliegue continuo |
| Coolify v4 | Plataforma de hosting self-hosted (Docker en VPS) |
| Docker / Docker Compose | Contenedorizacion de servicios |
| Bitwarden Secrets Manager | Gestión segura de secretos y variables de entorno |
7. Repositorios
La plataforma sigue una arquitectura multi-repo, con cada aplicación en su propio repositorio de GitLab:
| Repositorio | Aplicación | Descripción | Puerto Local |
|---|---|---|---|
invitia/invia-api | nvito-api | Backend API REST (NestJS) | 3000 |
invitia/invia-admin | nvito-admin | Dashboard administrativo (Next.js) | 5050 |
invitia/invia-invitations | nvito-invitations | Servidor público de invitaciones (Next.js) | 3001 |
invitia/nvito-client | nvito-client | App movil nativa (React Native / Expo) | 8081 (Metro) |
invitia/nvito-pwa | nvito-pwa | Progressive Web App (Next.js + BFF) | 3002 |
invitia/nvito-landing | nvito-landing | Landing page pública | 4321 |
invitia/nvito-docs | nvito-docs | Hub de documentación | 3333 |
Estructura de ramas
| Rama | Proposito |
|---|---|
main | Rama principal, código estable para producción |
develop | Rama de desarrollo e integración |
feature/* | Ramas de funcionalidades nuevas |
fix/* | Ramas de correccion de errores |
hotfix/* | Correcciones urgentes sobre producción |
8. Diagrama de Interacción entre Actores y Aplicaciones
Mapa de Interacciones del Sistema
Actores Internos
Super Admin
Platform Admin
Owner
Org Admin
Manager
Editor
Collaborator
Viewer
Actores Externos
HostAnfitrion / Cliente
GuestInvitado al evento
Aplicaciones Nvito
nvito-adminPanel de administracion
nvito-invitationsInvitaciones publicas
nvito-clientApp movil iOS/Android
nvito-pwaProgressive Web App
Sitios Estaticos (Cloudflare Pages)
nvito-landingLanding page publica
Aplicaciones Nvito
nvito-apiBackend NestJS
Servicios Externos
ClerkAuth + SSO
OpenAI / ClaudeIA generativa
Cloudflare R2Object Storage
Upstash RedisCache + Queues
Neon PostgreSQLBD principal
TwilioWhatsApp + SMS
StripePagos
Email SMTPCorreos transaccionales
9. Vision Estrategica
9.1 Declaracion de vision
"Transformar la manera en que las personas crean, gestiónan y viven eventos sociales inolvidables, democratizando el acceso a herramientas inteligentes que cualquiera puede usar en minutos."
9.2 Oportunidad de mercado
El mercado global de software de invitaciones electronicas se valora en 2,000 millones de USD en 2025, con un crecimiento proyectado a 6,000 millones para 2033 (CAGR 15%). Mexico representa una oportunidad particular debido a la alta penetracion movil (>90%), la cultura de celebraciones familiares arraigada y la ausencia de competidores locales con soluciones tecnológicamente avanzadas.
9.3 Principios guia
- Mobile-First: El 85%+ del trafico será movil; se disena para movil primero
- IA como Asistente: La IA sugiere y ayuda; el usuario mantiene el control final
- Simplicidad sobre Complejidad: Menos opciones, mejor experiencia
- Inclusion Digital: Accesible para usuarios de todas las edades y habilidades técnicas
- Privacidad por Diseño: Los datos de los usuarios son tratados con el máximo cuidado
10. Referencias
| Documento | Ubicación |
|---|---|
| Arquitectura del sistema | Arquitectura del Sistema |
| Estructura de datos | Modelo de Datos |
| Flujos principales | API Overview |
| Guia de desarrollo | Guia de Desarrollo Local |
Documento generado para la versión 1.0 de la plataforma Nvito - Febrero 2026