# ⚡ GUÍA DE INICIO RÁPIDO - En 30 Minutos

## 🎯 Objetivo

En 30 minutos tendrás el sistema funcionando y habrás creado tu primera campaña QR.

---

## ✅ PASO 1: Ejecutar Migraciones (5 min)

```bash
cd C:\xampp\htdocs\alcaldIA2

# Migrar base de datos central
php artisan migrate

# Migrar base de datos de tenant
php artisan tenants:migrate
```

**Resultado**: 30+ tablas creadas ✅

---

## ✅ PASO 2: Crear Tenant de Prueba (2 min)

```bash
php artisan tinker
```

Copia y pega:

```php
$campaign = App\Models\Campaign::create([
    'name' => 'Alcaldía Demo 2024',
    'slug' => 'demo',
    'email' => 'demo@campaña.com',
    'candidate_name' => 'Juan Pérez',
    'level' => 'municipal',
    'jurisdiction' => 'Bogotá',
    'status' => 'active',
    'plan' => 'pro',
    'trial_ends_at' => now()->addDays(30),
]);

$campaign->domains()->create(['domain' => 'demo.test']);
```

**Resultado**: Tenant creado ✅

---

## ✅ PASO 3: Crear Usuario Admin (2 min)

Aún en `tinker`:

```php
$campaign->run(function () {
    $user = App\Models\User::create([
        'name' => 'Admin',
        'email' => 'admin@demo.test',
        'password' => bcrypt('password123'),
        'is_active' => true,
    ]);
    
    echo "Usuario creado: {$user->email}\n";
    echo "Password: password123\n";
});

exit
```

**Resultado**: Usuario admin creado ✅

---

## ✅ PASO 4: Iniciar Servidor (1 min)

```bash
# Terminal 1
php artisan serve

# Terminal 2
npm run dev
```

**Resultado**: Sistema corriendo en http://localhost:8000 ✅

---

## ✅ PASO 5: Crear Primera Campaña QR (5 min)

Usar Postman o cURL:

```bash
# 1. Login
curl -X POST http://localhost:8000/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"admin@demo.test","password":"password123"}'

# Guarda el token que te devuelve

# 2. Crear campaña de afiches
curl -X POST http://localhost:8000/api/poster-qr/campaigns \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Prueba Afiches",
    "type": "poster",
    "start_date": "2024-10-15",
    "total_posters": 10
  }'

# Guarda el ID de campaña (ej: 1)

# 3. Generar 10 QR
curl -X POST http://localhost:8000/api/poster-qr/campaigns/1/generate-codes \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "quantity": 10,
    "base_url": "http://localhost:8000/qr-landing"
  }'
```

**Resultado**: 10 códigos QR generados ✅

---

## ✅ PASO 6: Probar Landing Page (3 min)

```bash
# Abre en navegador:
http://localhost:8000/qr-landing?qr=QR-ABC12345
# (Usa uno de los códigos generados)

# Llena el formulario:
- Nombre: Test User
- Email: test@test.com
- Intereses: Seguridad
- Nivel de apoyo: Muy interesado
- ✅ Acepto tratamiento de datos

# Enviar
```

**Resultado**: Primer lead capturado ✅

---

## ✅ PASO 7: Ver Análisis (2 min)

```bash
# Ver leads capturados
curl http://localhost:8000/api/qr-leads \
  -H "Authorization: Bearer TU_TOKEN"

# Ver análisis de campaña
curl http://localhost:8000/api/qr-leads/campaign/1/analysis \
  -H "Authorization: Bearer TU_TOKEN"
```

**Resultado**: Ver datos capturados ✅

---

## ✅ PASO 8: Configurar WhatsApp (OPCIONAL - 5 min)

```bash
# 1. Ir a https://business.facebook.com/
# 2. Crear cuenta WhatsApp Business
# 3. Obtener Phone Number ID y Access Token
# 4. Agregar a .env:

WHATSAPP_ACCESS_TOKEN=tu_token
WHATSAPP_PHONE_NUMBER_ID=tu_phone_id
WHATSAPP_VERIFY_TOKEN=mi_token_secreto

# 5. Crear template
curl -X POST http://localhost:8000/api/whatsapp/templates \
  -H "Authorization: Bearer TU_TOKEN" \
  -d '{
    "name": "Bienvenida",
    "category": "bienvenida",
    "content": "¡Hola {{nombre}}! Gracias por tu interés..."
  }'
```

**Resultado**: WhatsApp configurado ✅

---

## ✅ PASO 9: Enviar Primer WhatsApp (2 min)

```bash
# Crear campaña de WhatsApp
curl -X POST http://localhost:8000/api/whatsapp/campaigns \
  -H "Authorization: Bearer TU_TOKEN" \
  -d '{
    "name": "Prueba WhatsApp",
    "whatsapp_template_id": 1,
    "target_type": "all_leads"
  }'

# Enviar
curl -X POST http://localhost:8000/api/whatsapp/campaigns/1/send \
  -H "Authorization: Bearer TU_TOKEN"
```

**Resultado**: WhatsApp enviado a tu lead de prueba ✅

---

## ✅ PASO 10: Ver Dashboard (3 min)

```bash
# Abrir en navegador:
http://localhost:8000/dashboard

# O via API:
curl http://localhost:8000/api/dashboard/overview \
  -H "Authorization: Bearer TU_TOKEN"
```

**Resultado**: Dashboard con tus métricas ✅

---

## 🎉 ¡COMPLETADO!

En 30 minutos has:

✅ Instalado el sistema  
✅ Creado tenant  
✅ Generado 10 QR  
✅ Capturado 1 lead  
✅ Enviado WhatsApp  
✅ Visto dashboard  

---

## 🚀 PRÓXIMOS PASOS

### Hoy:
1. Genera 50 QR más
2. Imprime 50 afiches
3. Colócalos en 2 barrios diferentes

### Esta Semana:
1. Espera que la gente escanee
2. Monitorea dashboard diariamente
3. Cuando tengas 20+ leads, analiza por territorio

### Próxima Semana:
1. Identifica barrio con más apoyo
2. Organiza evento allá
3. Invita por WhatsApp
4. Mide resultados

### Mes 1:
1. Escala a 500 afiches
2. Captura 200+ leads
3. Convierte en 50+ voluntarios
4. Registra competencia
5. Monitorea redes sociales

### Día D (Elección):
1. Abre dashboard GOTV
2. Moviliza 500 votantes
3. Monitorea en tiempo real
4. **¡GANA!** 🎉

---

## 📞 AYUDA

¿Problemas?

1. Ver `docs/installation.md` - Troubleshooting
2. Ver `docs/api.md` - Referencia de endpoints
3. Ver `docs/IMPLEMENTACION-COMPLETA-TOP5.md` - Guía completa

---

**¡Sistema listo! Ahora a ganar elecciones con datos reales.** 🚀

---

**Tiempo total**: 30 minutos  
**Complejidad**: Fácil  
**Resultado**: Sistema electoral profesional funcionando