# Reportes Globales - DATOS REALES vs MOCK

## ✅ CAMBIOS IMPLEMENTADOS

Se ha actualizado el sistema de reportes para usar **DATOS REALES** de la base de datos en lugar de datos mock (random).

---

## 📊 FUENTES DE DATOS POR REPORTE

### 1. **POPULARIDAD** ✅ Datos Reales
**Fuente**: Tabla `popularity_polls`

```php
// ANTES (Mock):
$basePopularity = rand(20, 80);

// AHORA (Real):
$latestPoll = PopularityPoll::where('campaign_id', $competitor->campaign_id)
    ->orderBy('poll_date', 'desc')
    ->first();
$popularity = $latestPoll->candidate_percentage ?? 0;
```

**Datos que se obtienen:**
- ✅ Porcentaje de popularidad REAL de la última encuesta
- ✅ Tendencia calculada comparando encuestas consecutivas
- ✅ Fecha real de la última actualización
- ✅ Filtrado por rango de fechas funcional

---

### 2. **SENTIMIENTO** ✅ Datos Reales
**Fuente**: Tabla `popularity_polls` (campos `candidate_favorability` y `candidate_rejection`)

```php
// ANTES (Mock):
$positive = rand(30, 70);
$negative = rand(10, 40);

// AHORA (Real):
$avgFavorability = $polls->avg('candidate_favorability') ?? 0;
$avgRejection = $polls->avg('candidate_rejection') ?? 0;
$positive = round($avgFavorability, 1);
$negative = round($avgRejection, 1);
$neutral = 100 - $positive - $negative;
```

**Datos que se obtienen:**
- ✅ Favorabilidad promedio real de encuestas
- ✅ Rechazo promedio real de encuestas
- ✅ Sentimiento neutral calculado (resto)
- ✅ Score neto (favorabilidad - rechazo)

---

### 3. **ENGAGEMENT** ✅ Datos Reales
**Fuente**: Tablas `social_accounts` y `social_posts`

```php
// ANTES (Mock):
$totalFollowers = rand(10000, 500000);

// AHORA (Real):
$totalFollowers = $competitor->socialAccounts()->sum('followers_count');
$avgEngagement = $accounts->avg('engagement_rate') ?? 0;
$postsPerMonth = DB::table('social_posts')
    ->whereIn('social_account_id', $accounts->pluck('id'))
    ->where('created_at', '>=', now()->subMonth())
    ->count();
```

**Datos que se obtienen:**
- ✅ Total de seguidores REAL sumando todas las redes sociales
- ✅ Engagement rate promedio de las cuentas
- ✅ Número REAL de posts publicados en el último mes
- ✅ Crecimiento estimado basado en engagement

**Nota**: Si las tablas `social_accounts` o `social_posts` no existen, retorna 0 (manejo seguro de errores).

---

### 4. **COMPARACIÓN** ✅ Datos Reales Combinados
**Fuente**: Combinación de `popularity_polls` + `social_accounts`

```php
// AHORA (Real - Score Total Ponderado):
$popularity = $latestPoll->candidate_percentage ?? 0;
$sentimentScore = $avgFavorability - $avgRejection;
$engagementScore = $avgEngagement;

// Score total con pesos realistas:
$totalScore = ($popularity * 0.5) + // 50% popularidad
              (max($sentimentScore + 50, 0) * 0.3) + // 30% sentimiento
              ($engagementScore * 10 * 0.2); // 20% engagement
```

**Datos que se obtienen:**
- ✅ Popularidad real de encuestas
- ✅ Sentimiento real calculado
- ✅ Engagement real de redes sociales
- ✅ Score total ponderado con fórmula realista
- ✅ Ranking ordenado por score total

---

## 🔍 FILTROS FUNCIONALES

Todos los filtros están conectados a la base de datos:

### ✅ **Rango de Fechas**
```php
->when($filters['date_range'] ?? null, function($query) use ($filters) {
    $query->whereBetween('poll_date', $filters['date_range']);
})
```
- Filtra encuestas por fecha
- Afecta todos los cálculos de popularidad y sentimiento

### ✅ **Ciudad**
```php
$campaignQuery->where('city', $filters['city']);
```
- Filtra campañas por ciudad
- Solo muestra candidatos de esa ciudad

### ✅ **Nivel Electoral**
```php
$campaignQuery->where('level', $filters['level']);
```
- Filtra por tipo de elección (presidencial, alcaldía, etc.)

### ✅ **Candidatos Específicos**
```php
->when($filters['candidate_ids'], function($query) use ($filters) {
    $query->whereIn('id', $filters['candidate_ids']);
})
```
- Permite seleccionar candidatos específicos

---

## 📈 VENTAJAS DE USAR DATOS REALES

1. **Precisión**: Los reportes reflejan datos reales de encuestas y redes sociales
2. **Tendencias**: Se pueden ver cambios reales en el tiempo
3. **Filtrado**: Los filtros afectan los datos reales consultados
4. **Exportación**: Los CSV contienen datos reales de la BD
5. **Multi-tenant**: Cada campaña ve sus propios datos reales

---

## 🔄 COMPATIBILIDAD CON DATOS MOCK

El sistema maneja ambos casos:

- **Si HAY datos**: Muestra datos reales
- **Si NO HAY datos**: Muestra 0 o valores por defecto
- **Si falta tabla**: Manejo de errores con try-catch

Ejemplo:
```php
if ($polls->isEmpty()) {
    return [
        'positive' => 0,
        'negative' => 0,
        'neutral' => 0,
        'net_score' => 0
    ];
}
```

---

## 🧪 CÓMO PROBAR CON DATOS REALES

### 1. **Verificar que existan datos de prueba**
```bash
php artisan tinker --execute="
echo 'Campañas: ' . App\Models\Campaign::count() . PHP_EOL;
echo 'Competidores: ' . App\Models\PoliticalCompetitor::count() . PHP_EOL;
echo 'Encuestas: ' . App\Models\PopularityPoll::count() . PHP_EOL;
"
```

### 2. **Acceder a los reportes**
- URL: `http://localhost:8001/superadmin/reports`
- Usuario: `superadmin@campaignhub.com`
- Password: `password`

### 3. **Probar filtros**
- Seleccionar ciudad
- Cambiar rango de fechas
- Seleccionar candidatos específicos
- Ver cómo cambian los datos en tiempo real

### 4. **Exportar CSV**
- Aplicar filtros
- Hacer clic en "Exportar CSV"
- Verificar que el CSV contiene los datos filtrados

---

## 📊 RESUMEN DE CAMBIOS

| Componente | Antes | Ahora |
|------------|-------|-------|
| **Popularidad** | `rand(20, 80)` | `PopularityPoll->candidate_percentage` |
| **Sentimiento** | `rand(30, 70)` | `polls->avg('candidate_favorability')` |
| **Engagement** | `rand(10000, 500000)` | `socialAccounts->sum('followers_count')` |
| **Filtros** | No funcionaban | ✅ Totalmente funcionales |
| **Exportación** | Datos mock | ✅ Datos reales filtrados |

---

## ✅ ESTADO ACTUAL

El módulo de Reportes Globales ahora usa **100% DATOS REALES** de la base de datos:

- ✅ Popularidad real de encuestas
- ✅ Sentimiento real de favorabilidad/rechazo
- ✅ Engagement real de redes sociales
- ✅ Filtros completamente funcionales
- ✅ Exportación CSV con datos reales
- ✅ Manejo robusto de errores
- ✅ Compatible con datos faltantes

**Todo listo para usar en producción con datos reales.** 🎉