Nicaragua City Pass — Arquitectura Visual
Nicaragua City Pass · Arquitectura v1.2

Mapa visual de la plataforma

Visión de extremo a extremo de la experiencia de Usuario (turista), Negocio (operador) y Admin (equipo), integrada con WordPress, Supabase, Stripe y n8n. [file:1]

Pases 24/48/72h
Validación QR < 1s
Itinerario personalizado
Panel Negocio con KPIs
Admin con RBAC + 2FA
Panel Usuario
Turista · compra, planifica y usa su City Pass
Desde la landing en WordPress hasta las validaciones QR, todo el flujo del viajero se apoya en Supabase, Stripe y un dashboard en Next.js. [file:1]
Journey principal del turista
  1. 1. Descubre Landing (WordPress/WooCommerce) con CTAs a registro/login y explicación de cómo funciona el City Pass. [file:1]
  2. 2. Se registra /auth/register en Supabase Auth, verificación de email y creación de user_profile con datos básicos. [file:1]
  3. 3. Se perfila Onboarding de 7 preguntas (duración, intereses, ritmo, presupuesto, accesibilidad, etc.) para alimentar el motor de itinerarios. [file:1]
  4. 4. Explora /dashboard/experiences con grid de experiencias, filtros y modal de personalización con precio dinámico. [file:1]
  5. 5. Agrega al carrito cart_items en Supabase con selected_options (JSON) y calculated_price para cada pass/experiencia. [file:1]
  6. 6. Paga /checkout → Stripe Checkout; webhook en Edge Function crea order, limpia carrito y dispara emails/voucher PDF. [file:1]
  7. 7. Viaja Dashboard “Mis pases activos”, QR listo para escanear, reservas con margen de 3h, reviews y galería de fotos. [file:1]
WordPress Landing Supabase Auth Supabase DB Stripe Checkout Edge Functions
Capas de interfaz
Dashboard Home
Saludo, estado del pass (activo / próximo a vencer / vencido), quick actions para QR y resumen de experiencias visitadas. [file:1]
Rutas & Experiencias
Grid con estado de cada experiencia (visitado, pendiente, vencido), reservas, reviews y mapa. [file:1]
Itinerario sugerido
Timeline día a día (tipo Gantt) con horas, actividades, alertas y opciones para editar y compartir. [file:1]
Métricas personales
KPIs de viaje: experiencias visitadas, tiempo promedio, dinero ahorrado, próximas expiraciones. [file:1]
Notificaciones & referidos
Centro de alertas (expiraciones, reservas, nuevas experiencias) y programa de referidos con código único. [file:1]
Panel Negocio
Operador · valida, agenda y optimiza
El operador se conecta con login seguro, escanea QRs en <1s, gestiona reservas y lee métricas accionables para su negocio. [file:1]
Flujo operativo diario
  1. 1. Login seguro Correo, password robusto, 2FA y controles de sesión (rate limiting, IP, dispositivos confiables). [file:1]
  2. 2. Dashboard negocio Header con nombre del tour, estado online, capacidad y KPIs del día (validaciones, ingresos, ocupación). [file:1]
  3. 3. Escaneo QR /business/scanner con cámara, overlay y validación automática de QR, pago, vigencia y capacidad. [file:1]
  4. 4. Resultado Feedback visual y sonoro: acceso permitido, denegado o advertencia con opción de override auditado. [file:1]
  5. 5. Agendamientos Vista calendario/lista con próximas reservas, filtros y acciones directas (contacto, marcar asistencia). [file:1]
  6. 6. Analytics Tendencias, demografía, feedback de usuarios y recomendaciones para mejorar ocupación e ingresos. [file:1]
Estados de validación
✅ VÁLIDO — acceso permitido, visita registrada, animación verde y beep positivo. [file:1]
❌ NO VÁLIDO — vencido, ya visitado, pago pendiente, capacidad llena o usuario bloqueado. [file:1]
⚠️ ADVERTENCIA — casos límite (por ejemplo, pass cerca de vencer) con decisión manual y logging. [file:1]
Módulos clave
QR Scanner avanzado
Modo offline, linterna, entrada manual, historial de escaneos y opciones de accesibilidad (audio, alto contraste). [file:1]
Próximas reservas
Calendario y lista con filtros por día, experiencia y estado; notificaciones push/email por nueva reserva. [file:1]
Métricas de negocio
KPIs principales, gráficas por día/hora, top usuarios, procedencia y comparativas con otros negocios. [file:1]
Recomendaciones IA
Insights como picos de demanda, países en crecimiento y oportunidades de promociones. [file:1]
Panel Admin
Equipo interno · catálogo, seguridad y métricas globales
Panel crítico con RBAC de 5 roles, 2FA obligatorio, IP whitelist y audit log completo para cada cambio. [file:1]
Núcleo de control
  1. 1. Login crítico Contraseñas fuertes, 2FA obligatorio (SMS/App/WebAuthn) e IP whitelist estricta. [file:1]
  2. 2. Dashboard admin Vista general con métricas globales, alertas y accesos a Experiencias, Usuarios, Negocios y Métricas. [file:1]
  3. 3. CMS de experiencias Crear/editar experiencias, opciones dinámicas, precios, estados y versionado con auditoría. [file:1]
  4. 4. Gestión de usuarios Búsquedas, histórico, suspensiones, exportación de datos y soporte a incidencias. [file:1]
  5. 5. Gestión de negocios Alta/edición, comisiones, validaciones, fraude, estados y soft delete con recuperación. [file:1]
  6. 6. Métricas globales Revenue, funnels, cohortes, segmentación geográfica, alertas y reporting automático. [file:1]
RBAC y seguridad
Roles
FOUNDER, OPERATIONS, BUSINESS ANALYST, SUPPORT y FINANCE con permisos definidos por módulo y acción. [file:1]
Audit log
Registra quién hizo qué, cuándo y desde dónde; exportable para compliance y forense. [file:1]
Refunds & disputas
Flujos para revisar reembolsos, disputar cargos entre usuario-negocio y aplicar baneos si es necesario. [file:1]
Data & exports
Exportaciones CSV/Excel, integración con Google Sheets y API para análisis externo. [file:1]
Stack & orquestación
Frontend
Landing en WordPress/WooCommerce; paneles en Next.js + React + ShadcnUI para usuario, negocio y admin. [file:1]
Backend & datos
Supabase (Auth, Postgres, RLS, Edge Functions) como fuente única de verdad para usuarios, pases, órdenes y validaciones. [file:1]
Pagos & workflows
Stripe para cobros y webhooks; n8n para orquestar emails, notificaciones, sincronizaciones y reportes. [file:1]