📋 Propuesta de Mejoras - Travel Template Storefront

Cliente: Tania Viajes
URL Producción: https://taniaviajes.cadences.app
Fecha: 26 de Diciembre 2025
Versión: 1.0

🎯 Resumen Ejecutivo

Este documento presenta las mejoras propuestas para evolucionar el storefront de viajes desde una web estática hacia una plataforma completa con gestión de contenido, analytics y automatizaciones.

📊 Estado Actual

Stack Tecnológico

Limitaciones Actuales

1. Contenido hardcodeado en archivos TypeScript (trips.ts, destinations.ts)
2. Sin panel de administración - cualquier cambio requiere desarrollador
3. Sin analytics - no hay tracking de visitas ni conversiones
4. Sin formularios funcionales - contacto solo via WhatsApp/email
5. Sin SEO dinámico - meta tags estáticos

🚀 Mejoras Propuestas

Fase 1: Panel de Administración (MVP)

1.1 Autenticación

• Google OAuth para login seguro
• Verificación contra base de clientes de Cadences
• Control de acceso por tierSpecials: "taniaviajes"

1.2 Gestión de Contenido

• CRUD de Destinos: crear, editar, archivar destinos
• CRUD de Viajes: gestionar trips con editor visual
• Gestor de Imágenes: subida a Cloudflare R2 con optimización automática
• Editor de Itinerarios: drag & drop para ordenar días

1.3 Infraestructura

Cloudflare D1 (SQLite) → Contenido + Analytics
Cloudflare R2          → Almacenamiento de imágenes
Cloudflare Workers     → API endpoints

Estimación: 15-20 horas de desarrollo

Fase 2: Analytics y Tracking

2.1 Métricas de Visitas

• Páginas vistas por destino/viaje
• Tiempo de permanencia
• Tasa de rebote
• Fuentes de tráfico

2.2 Métricas de Conversión

• Clicks en "Reservar" / "Consultar"
• Clicks en WhatsApp
• Formularios enviados
• Descargas de PDF (si se implementa)

2.3 Datos Geográficos

• País de origen (vía Cloudflare headers)
• Dispositivo (mobile/desktop/tablet)
• Navegador
• Horarios de mayor actividad

2.4 Dashboard Visual

• Gráficas de tendencias
• Mapa de calor por países
• Top 10 viajes más vistos
• Alertas de picos de tráfico

Estimación: 8-10 horas de desarrollo

Fase 3: Funcionalidades Avanzadas

3.1 Formulario de Cotización

• Formulario multi-paso con datos del viaje
• Guardado automático en Cadences como Lead/Tarea
• Notificación por email/WhatsApp al agente
• Confirmación automática al cliente

3.2 Generador de PDF

• Itinerario descargable en PDF
• Branding personalizado
• QR code para compartir
• Versión imprimible

3.3 Sistema de Favoritos

• Guardar viajes favoritos (localStorage o con cuenta)
• Comparador de viajes
• Lista de deseos compartible

3.4 Calendario de Disponibilidad

• Fechas de salida por viaje
• Plazas disponibles
• Precio por temporada
• Alertas de últimas plazas

Estimación: 25-30 horas de desarrollo

Fase 4: Integraciones

4.1 Integración con Cadences

• Sincronización bidireccional de contenido
• Viajes como Tasks en Cadences
• Destinos como Projects (tipo DATA_TABLE)
• Leads automáticos desde formularios

4.2 Email Marketing

• Integración con Mailchimp/Brevo
• Newsletter de nuevos destinos
• Emails de seguimiento post-consulta
• Recordatorios de viajes guardados

4.3 Redes Sociales

• Meta Pixel para retargeting
• Google Analytics 4
• Schema.org para rich snippets
• Open Graph optimizado

Estimación: 15-20 horas de desarrollo

💰 Presupuesto de Infraestructura

📅 Roadmap Propuesto

Q1 2025 (Ene-Mar)
├── ✅ Fase 0: Storefront estático (COMPLETADO)
├── 🔄 Fase 1: Admin Panel MVP
│   ├── Semana 1-2: Auth + Infraestructura
│   └── Semana 3-4: CRUD de contenido

Q2 2025 (Abr-Jun)
├── Fase 2: Analytics
│   ├── Semana 1: Tracking básico
│   └── Semana 2-3: Dashboard
├── Fase 3.1: Formulario de cotización

Q3 2025 (Jul-Sep)
├── Fase 3.2: Generador PDF
├── Fase 3.3: Sistema favoritos
├── Fase 4.1: Integración Cadences

Q4 2025 (Oct-Dic)
├── Fase 3.4: Calendario disponibilidad
├── Fase 4.2-4.3: Integraciones marketing
└── Optimizaciones y refinamientos

🔧 Mejoras Técnicas Pendientes

SEO

• Sitemap dinámico (/sitemap.xml)
• Robots.txt optimizado
• Meta descriptions únicas por página
• Schema.org para TravelAgency y TouristTrip
• Canonical URLs

Performance

• Lazy loading de imágenes
• Precarga de rutas críticas
• Service Worker para offline
• Compresión Brotli
• Cache headers optimizados

Accesibilidad

• ARIA labels completos
• Navegación por teclado
• Contraste de colores WCAG AA
• Alt text en todas las imágenes
• Focus states visibles

UX/UI

• Skeleton loaders
• Transiciones suaves entre páginas
• Toast notifications
• Breadcrumbs en páginas internas
• Botón "volver arriba"

📝 Notas Adicionales

Modelo de Datos Propuesto (Cadences)

📁 Proyecto: "Marruecos" (tipo: data_table)
├── dataSchema: [bestTimeToVisit, capital, currency...]
├── 📋 Task: "Aventura Desierto"
│   ├── attachments: [hero.jpg, gallery/*.jpg]
│   ├── dataSchema: [duration, price, highlights...]
│   └── dataRows: [día1, día2, día3...]

Consideraciones de Seguridad

• Tokens JWT con expiración corta (1h)
• Rate limiting en API endpoints
• Validación de inputs en servidor
• CORS configurado solo para dominio propio
• CSP headers estrictos

✅ Próximos Pasos

1. Revisar y aprobar este documento de propuesta
2. Priorizar qué fases son más urgentes
3. Definir alcance exacto de Fase 1
4. Iniciar desarrollo del Admin Panel

Documento generado por el equipo de desarrollo de Cadences