Files

Jorge Teixeira b15f89d40f chore: update readme

2025-09-13 16:47:24 +02:00

6.1 KiB

Raw Permalink Blame History

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:

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

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

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:

cp .env.example .env

Edita .env con tus preferencias:

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

# 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

# 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

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)

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

# ⚠️ 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

Abre el navegador en la pagina de denuncias de LaLiga
Cierra automaticamente los popups de cookies y modales
Rellena el formulario con los datos de cada denuncia
Sube la imagen de evidencia (si se especifica)
Envia el formulario y espera confirmacion
Vuelve al formulario para la siguiente denuncia (si hay mas)
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.

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 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.

6.1 KiB Raw Permalink Blame History