Guía de Pruebas del Sistema

Guía de Pruebas del Sistema - Te Afirmo

📋 Resumen

Esta guía te ayudará a probar todas las funcionalidades del sistema de manera sistemática.

---

🔧 Preparación

Variables de Entorno Requeridas

Verifica que todas estas variables estén configuradas en tu .env y en Vercel:

# Email (Resend)
RESEND_API_KEY=re_...
RESEND_FROM_EMAIL=Te Afirmo <notificaciones@teafirmo.cl>

# Almacenamiento (Backblaze)
BACKBLAZE_KEY_ID=005...
BACKBLAZE_APPLICATION_KEY=K005...
BACKBLAZE_BUCKET=gestor-documentos-miguel

# Base de Datos (Turso)
TURSO_DATABASE_URL=libsql://...
TURSO_AUTH_TOKEN=eyJ...

# CRM (GoHighLevel)
GHL_API_KEY=pit-...
GHL_LOCATION_ID=Km2n...

# Webhooks (opcional, requiere premium)
WEBHOOK_SECRET=23673eaa75168a93b6dd5cb5e192fb3f...

Pipelines de GoHighLevel

Verifica que estos pipelines existan en GoHighLevel:

1. Contacto Principal - Garantías y Licitaciones

   • ID: 3EGOkCpeYW6q2E3UMQhq
   • Etapas: Nuevo Lead, En Proceso, Contactado, Calificado, Cotizado, Cierre

2. Consulta Nicolás Larraín

   • ID: rKtL8bjXjLRInOLRPHWS
   • Etapas: Nueva Consulta, En Revisión, Respondido, Cerrado

---

🧪 Pruebas por Módulo

1. 📝 Pruebas de Formularios

1.1 Formulario Principal de Contacto (ContactForm.tsx)

Ubicación: Página principal (/) o página de contacto (/contacto)

Prueba 1: Proveedor Adjudicado

• Seleccionar “Proveedor Adjudicado”
• Completar todos los campos:
  • Nombre: Test Proveedor
  • Apellido: Adjudicado
  • RUT: 12.345.678-9
  • Teléfono: +56 9 1234 5678
  • Email: test.proveedor@test.com
  • Tipo de inversor: Persona Natural
• Aceptar políticas de privacidad
• Enviar formulario
• Verificar mensaje de éxito
• Verificar en GoHighLevel:
  • Contacto creado/actualizado
  • Oportunidad creada en pipeline “Contacto Principal”
  • Etapa: “Nuevo Lead”
  • Tags: Formulario Contacto, Garantías, Proveedor Adjudicado
• Verificar emails enviados a:
  • conversemos@teafirmo.cl
  • mcaniuqueo@gmail.com
• Verificar en Turso (tabla form_submissions)

Prueba 2: Empresa Oferente

• Seleccionar “Empresa Oferente”
• Completar todos los campos:
  • Nombre: Test Empresa
  • Apellido: Oferente
  • RUT: 76.543.210-K
  • Teléfono: +56 9 8765 4321
  • Email: test.empresa@test.com
  • Tipo de inversor: Persona Jurídica
• Aceptar políticas de privacidad
• Enviar formulario
• Verificar mismo flujo que Prueba 1
• Verificar tag: Empresa Oferente

Prueba 3: Validación de Errores

• Intentar enviar sin aceptar políticas → Debe mostrar error
• Intentar enviar sin email → Debe mostrar error
• Intentar enviar sin nombre → Debe mostrar error
• Intentar enviar email inválido → Debe mostrar error

1.2 Formulario de Nicolás Larraín (SectionAdvisor.astro)

Ubicación: Aparece en varias páginas (footer/prefooter)

Prueba:

• Completar formulario:
  • Nombre: Test Nicolás
  • Email: test.nicolas@test.com
  • Mensaje: Esta es una prueba del formulario de Nicolás Larraín
• Enviar formulario
• Verificar mensaje de éxito verde
• Verificar en GoHighLevel:
  • Contacto creado/actualizado
  • Oportunidad creada en pipeline “Consulta Nicolás Larraín”
  • Etapa: “Nueva Consulta”
  • Tags: Consulta Nicolás, Licitaciones
• Verificar emails enviados

1.3 Formulario de Nicolás Larraín (nico-experto.astro)

Ubicación: Página /nico-experto

Prueba:

• Navegar a /nico-experto
• Completar formulario:
  • Nombre: Test Experto
  • Email: test.experto@test.com
  • Mensaje: Esta es una prueba del formulario experto
• Enviar formulario
• Verificar mensaje de éxito
• Verificar mismo flujo que formulario anterior
• Verificar origen: nico-experto en datos

---

2. 🔐 Pruebas de Autenticación y Registro

2.1 Registro de Usuario

Prueba 1: Registro Persona Natural

• Navegar a página de registro
• Seleccionar “Persona Natural”
• Completar:
  • Email: test.natural@test.com
  • Contraseña: Test123456
  • Nombre: Test Natural
• Registrar
• Verificar email con código TOTP recibido
• Verificar en Turso (tabla users):
  • Usuario creado
  • email_verified = 0
  • role = 'natural'
• Verificar que NO se crea lead en GoHighLevel (solo se guarda en Turso)

Prueba 2: Registro Persona Jurídica

• Mismo flujo pero con role = 'juridica'

Prueba 3: Verificación de Email

• Usar código TOTP recibido por email
• Verificar cuenta
• Verificar en Turso:
  • email_verified = 1
• Verificar email de bienvenida recibido
• Verificar que email de bienvenida incluye checklist de documentos

2.2 Inicio de Sesión

Prueba:

• Intentar iniciar sesión con credenciales válidas
• Verificar sesión creada
• Verificar acceso al panel correspondiente
• Intentar iniciar sesión con credenciales inválidas
• Verificar error de autenticación

---

3. 📄 Pruebas de Gestión de Documentos

3.1 Subida de Documentos

Prueba 1: Subir Documento Válido

• Iniciar sesión como usuario registrado
• Navegar al panel (Persona Natural o Jurídica)
• Seleccionar categoría de documento (ej: Carpeta Tributaria)
• Subir archivo PDF válido (< 10MB)
• Verificar mensaje de éxito
• Verificar en Backblaze:
  • Archivo subido en users/{userId}/documents.json
• Verificar en GoHighLevel:
  • Contacto sincronizado
  • Tags actualizados según documentos
  • Campos personalizados actualizados (completitud_perfil, documentos_completados)
• Verificar email de confirmación de subida recibido

Prueba 2: Validación de Archivos

• Intentar subir archivo > 10MB → Debe mostrar error
• Intentar subir archivo con formato inválido → Debe mostrar error
• Intentar subir archivo válido pero grande (5-10MB) → Debe mostrar advertencia pero permitir

---

4. 📊 Pruebas del Dashboard Administrativo

4.1 Acceso al Dashboard

Prueba:

• Iniciar sesión como administrador
• Navegar a /panel/administrador
• Verificar acceso permitido
• Intentar acceder sin ser admin → Debe redirigir

4.2 Métricas en Tiempo Real

Prueba:

• Verificar que se muestran las tarjetas de métricas:
  • Total Usuarios
  • Perfiles Completos
  • Total Documentos
  • Completitud Promedio
• Verificar que los números son correctos
• Verificar alertas críticas (si hay documentos vencidos)

---

🚀 Cómo Ejecutar las Pruebas

1. Pruebas Locales:

   bun run dev
   # Navegar a http://localhost:4321

2. Pruebas en Producción:

   bun run build
   bun run preview
   # O verificar en Vercel después de deploy

---

Última actualización: 2025-01-27

Nota: Guarda este documento y marca cada prueba conforme la completes. Esto te ayudará a identificar qué funcionalidades necesitan atención.