242 lines
7.2 KiB
Markdown
242 lines
7.2 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 🚨
|
|
|
|
### ⚠️ 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.** |