203 lines
6.1 KiB
Markdown
203 lines
6.1 KiB
Markdown
# 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 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.**
|