🥊 Sistema de Predicciones - La Velada del Año VI

Este documento te guía paso a paso para configurar y usar el sistema de predicciones para La Velada del Año VI.

🚀 Configuración Inicial

1. Variables de Entorno

Asegúrate de tener configuradas las variables de entorno para Turso:

TURSO_DATABASE_URL=libsql://your-database-url
TURSO_AUTH_TOKEN=your-auth-token

2. Crear las Tablas

Ejecuta el comando para crear las tablas e inicializar los datos:

pnpm db:init

Este comando:

• ✅ Crea la tabla predictions para almacenar el conteo de votos
• ✅ Crea la tabla user_votes para tracking de usuarios
• ✅ Inserta registros iniciales para todos los combates con 0 votos
• ✅ Muestra un resumen de lo creado

3. Verificar la Configuración

Comprueba que todo esté funcionando correctamente:

pnpm db:check

Este comando muestra:

• 📊 Estadísticas de las tablas
• 🥊 Predicciones por combate
• 👑 Top luchadores y combates
• 🔍 Estado de integridad de datos

🧪 Probar el Sistema

Simular Votos de Prueba

Para probar la funcionalidad completa:

pnpm db:test

Este script simula:

• 👥 5 usuarios votando en diferentes combates
• 🔄 Cambios de voto
• 📊 Cálculo de porcentajes
• ✅ Verificación de integridad

📋 Combates Disponibles

🔌 API Endpoints

Obtener Predicciones

# Todas las predicciones
GET /api/predictions

# Predicciones de un combate específico
GET /api/predictions?combat_id=1-peereira-vs-rivaldios

Respuesta:

{
  "combat_id": "1-peereira-vs-rivaldios",
  "predictions": [
    {
      "fighter_id": "peereira",
      "votes": 150,
      "percentage": 60
    },
    {
      "fighter_id": "rivaldios",
      "votes": 100,
      "percentage": 40
    }
  ],
  "total_votes": 250
}

Registrar Voto

POST /api/predictions
Content-Type: application/json

{
  "combat_id": "1-peereira-vs-rivaldios",
  "fighter_id": "peereira"
}

Requisitos:

• 🔐 Usuario autenticado (sesión requerida)
• ✅ combat_id y fighter_id válidos

Respuesta:

{
  "message": "Voto registrado correctamente",
  "combat_id": "1-peereira-vs-rivaldios",
  "fighter_id": "peereira",
  "votes": 151
}

🎯 Funcionalidades

Control de Votos Únicos

• 👤 Cada usuario puede votar una sola vez por combate
• 🔄 Si cambia su voto, se actualiza automáticamente el conteo
• ⚠️ Si vota por el mismo luchador, recibe confirmación

Integridad de Datos

• 🔗 Los votos se mantienen sincronizados entre tablas
• 📊 Al cambiar un voto, se decrementa el contador anterior
• ✅ Garantiza que los totales sean siempre precisos

Privacidad

• 🔒 No expone información de usuarios en respuestas GET
• 👤 Los votos se asocian automáticamente con el usuario autenticado

🛠️ Comandos Disponibles

📊 Estructura de la Base de Datos

Tabla predictions

CREATE TABLE predictions (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  combat_id TEXT NOT NULL,
  fighter_id TEXT NOT NULL,
  votes INTEGER DEFAULT 0,
  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
  UNIQUE(combat_id, fighter_id)
);

Tabla user_votes

CREATE TABLE user_votes (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  combat_id TEXT NOT NULL,
  fighter_id TEXT NOT NULL,
  user_id TEXT NOT NULL,
  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
  UNIQUE(combat_id, user_id)
);

🔧 Mantenimiento

Backup de Datos

# Exportar predicciones
sqlite3 your-database.db ".dump predictions user_votes" > backup.sql

Estadísticas Útiles

-- Total de votos por combate
SELECT combat_id, SUM(votes) as total_votes
FROM predictions
GROUP BY combat_id
ORDER BY total_votes DESC;

-- Usuarios más activos
SELECT user_id, COUNT(*) as votes_count
FROM user_votes
GROUP BY user_id
ORDER BY votes_count DESC
LIMIT 10;

🚨 Troubleshooting

Error: "Tabla no existe"

pnpm db:init

Error: "Usuario no autenticado"

Verificar que el usuario tenga una sesión válida en auth-astro.

Error: "Combate no encontrado"

Verificar que el combat_id esté en la lista de combates disponibles.

Error: "Luchador no encontrado"

Verificar que el fighter_id esté en la lista de luchadores disponibles.

📈 Próximos Pasos

1. Configurar autenticación con auth-astro
2. Crear componentes de UI para mostrar predicciones
3. Implementar botones de voto interactivos
4. Agregar notificaciones de cambios de voto
5. Crear dashboard de estadísticas en tiempo real

📞 Soporte

Si encuentras algún problema:

1. Ejecuta pnpm db:check para diagnosticar
2. Revisa los logs del servidor
3. Verifica las variables de entorno
4. Consulta la documentación completa en DATABASE_PREDICTIONS.md

¡El sistema de predicciones está listo para La Velada del Año VI! 🥊✨