# 🚀 GUÍA RÁPIDA DE ACCESO - CAMPAIGNHUB

## ✅ MÓDULOS QUE PUEDES USAR AHORA MISMO

### **1. 🗳️ ENCUESTAS EN LA CALLE** ⭐

**Dashboard Super Admin** (Ver resultados):
```
URL: http://localhost:8001/superadmin/street-surveys
Login: superadmin@campaignhub.com / password

LO QUE VERÁS:
✅ 433 respuestas de encuestas reales
✅ 5 gráficos interactivos:
   - Preferencia de candidatos (Bar chart)
   - Distribución por edad (Doughnut)
   - Distribución por género (Pie)
   - Top preocupaciones ciudadanas (Horizontal bar)
   - Respuestas por fecha (Line chart)
✅ Filtros avanzados (país, departamento, ciudad, edad, género, fechas)
✅ Tabla Top 20 ciudades con más respuestas
✅ Botón "Exportar a Excel"
```

**Formulario Encuestador** (Hacer encuesta):
```
URL: http://localhost:8001/survey
(SIN LOGIN - Acceso público)

LO QUE VERÁS:
✅ Formulario móvil profesional de 6 pasos
✅ Paso 1: Seleccionar ubicación (País → Estado → Ciudad)
✅ Paso 2: Elegir candidato (se filtran por la ciudad)
✅ Paso 3: ¿Qué te gusta del candidato?
✅ Paso 4: ¿Qué no te gusta?
✅ Paso 5: ¿Qué te preocupa? (seleccionar hasta 3 temas)
✅ Paso 6: Datos demográficos (edad, género, nivel socioeconómico)
✅ Pantalla de éxito final
```

---

### **2. 📍 QR AFICHES GEOREFERENCIADOS + MAPA DE CALOR** ⭐

**Dashboard con Mapa** (Candidato):
```
URL: http://localhost:8001/qr-campaigns/dashboard
Login: admin@campaign.com / password

LO QUE VERÁS:
✅ 4 estadísticas principales:
   - Total afiches: 134
   - Escaneos totales: 4,161
   - Escaneos hoy
   - % que votarían por ti

✅ PESTAÑA 1: MAPA DE CALOR INTERACTIVO 🗺️
   - Mapa de tu ciudad con Leaflet.js
   - Marcadores azules = tus afiches instalados
   - Zonas de calor (rojo/amarillo/verde) = dónde escanean más
   - Click en marcador = ver detalles del afiche
   - Ver cantidad de escaneos por afiche

✅ PESTAÑA 2: MIS AFICHES
   - Tabla con 134 afiches instalados
   - Ver ubicación exacta de cada uno
   - Ver cuántos escaneos tiene cada afiche
   - Código QR de cada afiche
   - Botón "Ver QR" (abre en nueva pestaña)
   - Botón "Descargar QR" (imagen PNG)
   - Botón "Crear Nuevo Afiche"

✅ PESTAÑA 3: ANÁLISIS
   - Gráfico: Escaneos por fecha (últimos 30 días)
   - Gráfico: Distribución de sentimientos (positivo/negativo/neutral)
   - Gráfico: Top afiches con más escaneos
   - Análisis por zona geográfica
```

**Crear Nuevo Afiche**:
```
1. Click en "Nuevo Afiche"
2. Modal se abre con formulario:
   - Nombre del afiche
   - Ubicación exacta (ej: "Calle 45 #23-10")
   - Geolocalización (País → Departamento → Ciudad)
   - Coordenadas (lat/lng) - puede usar "Mi ubicación"
   - Tamaño (A4, A3, Banner)
   - Fecha de instalación
3. Click "Crear Afiche"
4. Sistema genera código QR único
5. Te muestra el QR para descargar
6. Aparece en el mapa inmediatamente
```

**Escaneo Público** (Persona en la calle):
```
URL: http://localhost:8001/qr/{CODE}
Ejemplo: http://localhost:8001/qr/QR-NOB8FZTFFGLV
(SIN LOGIN)

LO QUE VERÁS:
✅ Header con info del candidato (nombre, logo, ubicación del afiche)
✅ Calificar con estrellas (1-5)
✅ Dejar opinión por escrito
✅ Votar: ¿Votarías por este candidato? (Sí/No)
✅ Datos demográficos opcionales (edad, género)
✅ Email para recibir actualizaciones
✅ Captura automática de ubicación GPS
✅ Pantalla de éxito: "¡Gracias! Tu opinión ha sido registrada"
```

---

## 🔑 USUARIOS DE PRUEBA

### **Super Admin**:
```
Email: superadmin@campaignhub.com
Password: password
```

### **Campaign Admin** (Candidato):
```
Email: admin@campaign.com
Password: password
```

### **Coordinador**:
```
Email: coord@campaign.com
Password: password
```

### **Voluntario**:
```
Email: vol@campaign.com
Password: password
```

---

## 📊 DATOS DE PRUEBA DISPONIBLES

- ✅ **433 respuestas** de encuestas en la calle
- ✅ **134 afiches QR** georeferenciados
- ✅ **4,161 escaneos** de QR con opiniones
- ✅ **3,364 posts** de redes sociales
- ✅ **23 campañas** diferentes
- ✅ **90+ competidores** políticos

**Total: ~8,500 registros de prueba listos para explorar**

---

## 🎯 FLUJO COMPLETO DEL SISTEMA QR

### **Para el Candidato** (Campaign Admin):

1. Login en `/login` (`admin@campaign.com`)
2. Ir a `/qr-campaigns/dashboard`
3. Click "Nuevo Afiche"
4. Llenar ubicación exacta (ej: "Parque Central")
5. Agregar coordenadas (usar "Mi ubicación" si estás en el lugar)
6. Crear afiche → Sistema genera QR único
7. Descargar imagen QR
8. **Imprimir afiche e instalarlo en el lugar georeferenciado**
9. La gente escanea el QR desde sus celulares
10. Dejan sus opiniones
11. **Volver al dashboard → Ver mapa de calor actualizado**
12. Ver en qué zonas hay más escaneos
13. Leer opiniones por zona
14. **Identificar zonas con sentimiento negativo → Enfocar campaña ahí**

### **Para la Persona en la Calle** (Público):

1. Ve afiche del candidato pegado en la pared
2. Escanea QR con su celular
3. Se abre `/qr/{CODE}` automáticamente
4. Ve info del candidato
5. Califica con estrellas
6. Deja opinión
7. Vota Sí/No
8. (Opcional) Deja email para recibir noticias
9. Click "Enviar"
10. **Su ubicación GPS + opinión quedan registradas**
11. Ve mensaje "¡Gracias!"

### **Para el Candidato** (Análisis):

1. Ver mapa de calor
2. **Zonas rojas/calientes = Mucha actividad**
3. **Zonas frías/azules = Poca actividad**
4. Click en marcador azul (afiche)
5. Ver cuántos escaneos tiene ese afiche específico
6. Ver opiniones de esa zona
7. **Decidir dónde instalar más afiches**
8. **Identificar zonas que necesitan más campaña**

---

## ✅ RESUMEN

**FUNCIONANDO 100%**:
- ✅ Encuestas en la Calle (2 vistas)
- ✅ QR Afiches Georeferenciados (2 vistas)
- ✅ Mapa de calor interactivo
- ✅ 4,594 registros de prueba

**RUTAS CREADAS (35)**:
- ✅ 15 rutas con vista funcional
- ⏳ 20 rutas pendientes de vista

**BASE DE DATOS (38 tablas)**:
- ✅ 100% completada para 20 módulos

**¡PRUEBA LOS MÓDULOS QR Y ENCUESTAS AHORA!** 🎉