# Sistema Automatizado de Denuncias LaLiga

Este proyecto automatiza el envio de denuncias de emisiones ilegales de contenido deportivo a traves del formulario oficial de LaLiga.

## 🚨 AVISO CRÍTICO - LEER ANTES DE USAR 🚨

### ⚠️ NUNCA USAR DATOS MOCK EN PRODUCCIÓN ⚠️

**🛑 IMPORTANTE: Este proyecto NUNCA debe ejecutarse con `USE_MOCK_DATA=true` contra el sitio web real de LaLiga (https://laligabares.com/denuncias/). Los datos mock estan disenados UNICAMENTE para pruebas en entornos de desarrollo.**

**🛑 NO USES VPN: Si vas a hacer denuncias reales, NO uses VPN. LaLiga necesita saber que eres un denunciante serio y local.**

### 🚫 COMANDO PROHIBIDO EN PRODUCCIÓN:

```bash
# ⚠️ NUNCA EJECUTAR ESTE COMANDO CONTRA EL SITIO REAL DE LALIGA ⚠️
docker run -e USE_MOCK_DATA=true laliga-denuncias
# ⚠️ ESTE COMANDO ENVIARÁ DATOS FALSOS AL SITIO OFICIAL ⚠️
```

**Este comando generará y enviará denuncias falsas automáticamente. Solo debe usarse en entornos de desarrollo con URLs de prueba.**

---

## 🎯 Proposito

Facilitar el proceso de denuncia de establecimientos que emiten contenido deportivo sin la licencia correspondiente, automatizando el llenado y envio del formulario oficial.

## 📋 Prerrequisitos

- Docker instalado en tu sistema
- Imagenes de evidencia de las emisiones ilegales (formato: jpg, jpeg, png, gif, bmp)

## 🚀 Configuracion para Denuncias Reales

### 1. Preparar las Imagenes de Evidencia

```bash
# Reemplaza las imagenes de ejemplo con tus evidencias reales
rm -rf images/*
cp /ruta/a/tus/fotos/* images/
```

**Importante**: Las imagenes deben mostrar claramente:
- La pantalla completa del televisor
- La emision ilegal en curso
- Evidencia visual del contenido sin licencia

### 2. Configurar las Denuncias

Edita el archivo `denuncias.yml` con tus datos reales:

```yaml
denuncias:
  - # Primera denuncia
    nombre_local: "Nombre real del establecimiento"
    direccion: "Direccion completa y real"
    codigo_postal: "Codigo postal real"
    municipio: "Ciudad real"
    evento_deportivo: "Evento especifico que estaban emitiendo"
    descripcion: "Descripcion detallada de lo que observaste"
    email_contacto: "tu-email@ejemplo.com"  # Opcional
    imagen: "nombre-de-tu-foto.jpg"  # Debe estar en images/
    
  - # Puedes anadir mas denuncias aqui
    nombre_local: "Otro establecimiento"
    # ... mas campos
```

### 3. Configurar Variables de Entorno

Crea tu archivo `.env`:

```bash
cp .env.example .env
```

Edita `.env` con tus preferencias:

```env
# URL del formulario (NO CAMBIAR para denuncias reales)
TARGET_URL=https://laligabares.com/denuncias/

# Mostrar navegador (util para verificar el proceso)
HEADLESS=false

# SIEMPRE false para denuncias reales
USE_MOCK_DATA=false
```

## 🔧 Como Ejecutar

### Opcion 1: Usando Docker (Recomendado)

```bash
# Construir la imagen
docker build -t laliga-denuncias .

# Ejecutar con archivos locales
docker run -v $(pwd)/denuncias.yml:/app/denuncias.yml \
           -v $(pwd)/images:/app/images \
           -v $(pwd)/.env:/app/.env \
           laliga-denuncias
```

### Opcion 2: Ejecucion Local

```bash
# Instalar dependencias
uv sync

# Ejecutar el script
uv run python main.py
```

## 📝 Campos del Formulario

### Obligatorios:
- **nombre_local**: Nombre exacto del establecimiento
- **direccion**: Direccion completa (calle, numero)
- **codigo_postal**: Codigo postal del establecimiento
- **municipio**: Ciudad donde se encuentra

### Opcionales:
- **evento_deportivo**: Que partido o evento estaban emitiendo
- **descripcion**: Descripcion detallada de la situacion observada
- **email_contacto**: Tu email para seguimiento (recomendado)
- **imagen**: Nombre del archivo de evidencia fotografica

## 🖼️ Gestion de Imagenes

### Imagenes Disponibles
El script buscara automaticamente imagenes en la carpeta `images/`:
- Formatos soportados: jpg, jpeg, png, gif, bmp
- Tamano maximo: 5MB por imagen

### Especificar Imagen por Denuncia
```yaml
imagen: "evidencia-bar-centro.jpg"  # Usar imagen especifica
imagen: ""                          # No subir imagen
# imagen: (campo omitido)           # No subir imagen
```

## ⚙️ Modos de Operacion

### Modo Produccion (Denuncias Reales)
```bash
# Configuracion en .env
USE_MOCK_DATA=false
HEADLESS=false  # Para ver el proceso
```

### Modo Prueba (SOLO PARA DESARROLLO)
```bash
# ⚠️ NUNCA usar en produccion
USE_MOCK_DATA=true
TARGET_URL=http://localhost:3000  # URL de prueba
```

## 🔍 Que Hace el Script

1. **Abre el navegador** en la pagina de denuncias de LaLiga
2. **Cierra automaticamente** los popups de cookies y modales
3. **Rellena el formulario** con los datos de cada denuncia
4. **Sube la imagen** de evidencia (si se especifica)
5. **Envia el formulario** y espera confirmacion
6. **Vuelve al formulario** para la siguiente denuncia (si hay mas)
7. **Registra todo el proceso** en logs detallados

## 📊 Logs y Seguimiento

El script proporciona logs detallados:
```
2023-09-11 14:23:45 - INFO - Opening browser to: https://laligabares.com/denuncias/
2023-09-11 14:23:46 - INFO - Cookie consent dialog closed
2023-09-11 14:23:48 - INFO - Popup modal closed
2023-09-11 14:23:49 - INFO - --- Processing submission 1/3 ---
2023-09-11 14:23:49 - INFO - Submitting for: Bar Deportivo Centro
2023-09-11 14:23:50 - INFO - Filling form with data...
2023-09-11 14:23:51 - INFO - Using specified image: /app/images/evidencia1.jpg
2023-09-11 14:23:52 - INFO - Form submitted successfully
```

## 🔒 Consideraciones Legales y Eticas

- **Solo denuncias veraces**: Usa este sistema unicamente para denuncias reales y verificadas
- **Evidencia real**: Las imagenes deben ser autenticas y tomadas por ti
- **Responsabilidad**: Eres responsable de la veracidad de las denuncias enviadas
- **Uso apropiado**: No abuses del sistema de denuncias

## 🛠️ Solucion de Problemas

### El navegador no se abre
```bash
# Verificar que Docker tiene permisos de display
xhost +local:docker  # En Linux

# O usar modo headless
echo "HEADLESS=true" >> .env
```

### Imagenes no se suben
```bash
# Verificar formato y tamano
ls -la images/
file images/*  # Verificar formato
du -h images/*  # Verificar tamano (max 5MB)
```

### Formulario no se envia
- Verificar que todos los campos obligatorios estan completos
- Comprobar la conexion a internet
- Revisar los logs para errores especificos

## 📞 Soporte

Si encuentras problemas tecnicos:
1. Revisa los logs detallados
2. Verifica tu configuracion en `denuncias.yml`
3. Comprueba que las imagenes son validas
4. Asegurate de usar `USE_MOCK_DATA=false` para denuncias reales

---

## 🤝 Contribuir

¡Las contribuciones son bienvenidas! Si quieres ayudar a mejorar este proyecto, consulta nuestra [Guía de Contribución](CONTRIBUTING.md).

### Formas de Contribuir:
- 🐛 Reportar errores o problemas
- 💡 Sugerir nuevas funcionalidades
- 🔧 Mejorar el código existente
- 📚 Mejorar la documentación
- 🌐 Añadir soporte para otros idiomas

## 📄 Licencia

Este proyecto está licenciado bajo la Licencia AGPL-3.0-or-later. Consulta el archivo [LICENSE](LICENSE) para más detalles.

## ⚠️ Recordatorio Final

**Este sistema debe usarse responsablemente y solo para denuncias legitimas de emisiones ilegales. LaLiga utiliza estos reportes para proteger los derechos de transmision deportiva.**