# 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 🚨

## ⚠️ IMPORTANTE: USO RESPONSABLE

**Este proyecto es para denuncias REALES de emisiones ilegales. Úsalo responsablemente.**

### 🚫 NUNCA ejecutes este comando:
```bash
docker run -e USE_MOCK_DATA=true -e USE_TOR=true git.teixe.es/teixe/laliga-denuncias:latest
```

**¿Por qué?** Este comando genera y envía denuncias falsas automáticamente al sitio oficial de LaLiga. 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

# Usar proxy Tor para anonimato (opcional)
USE_TOR=false

# Direccion del proxy Tor (SOCKS5)
TOR_PROXY=socks5://127.0.0.1:9050
```

## 🔧 Como Ejecutar

### Opcion 1: Usando Docker (Recomendado)

```bash
# Usar imagen precompilada desde GitHub Container Registry
docker run -v $(pwd)/denuncias.yml:/app/denuncias.yml \
           -v $(pwd)/images:/app/images \
           -v $(pwd)/.env:/app/.env \
           git.teixe.es/teixe/laliga-denuncias:latest

# O construir localmente si prefieres
docker build -t laliga-denuncias .
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
# Ejecutar con denuncias reales del archivo denuncias.yml
docker run -v $(pwd)/denuncias.yml:/app/denuncias.yml \
           -v $(pwd)/images:/app/images \
           -e HEADLESS=false \
           git.teixe.es/teixe/laliga-denuncias:latest
```

### Modo Prueba (SOLO PARA DESARROLLO)
```bash
# ⚠️ NUNCA usar en produccion contra LaLiga real
docker run -e USE_MOCK_DATA=true \
           -e TARGET_URL=http://localhost:3000 \
           git.teixe.es/teixe/laliga-denuncias:latest
```

## 🔍 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

## 🔒 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

## 🤝 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.**