chore: initial commit
This commit is contained in:
242
README.md
Normal file
242
README.md
Normal file
@@ -0,0 +1,242 @@
|
||||
# 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.**
|
||||
Reference in New Issue
Block a user