zank-rank
Plataforma de ranking para grupos de jugadores de League of Legends con bot de Discord y análisis IA. Sincroniza LP, rachas y datos desde Riot Games API. Incluye panel web Next.js, bot Discord, sistema de apuestas ZankCoins y análisis diario por Groq. Self-hosted con Docker/SQLite.
Ficha actualizada 26 sept 2026, 0:35 · upstream 26 sept 2026, 0:29 · release sin release detectada
Qué es zank-rank
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
zank-rank es una aplicación web auto-alojada diseñada para grupos de amigos que juegan League of Legends. Proporciona un ranking en tiempo real sincronizado automáticamente desde la API de Riot Games, mostrando LP ganado, rachas y clasificaciones por región (Solo/Duo vs Flex). La interfaz incluye un podio dinámico, perfiles de jugadores con historial de LP y comparativas 1v1, además de "muros de fama y vergüenza" que destacan pentakills o rachas de derrotas.
El sistema integra un bot de Discord que notifica ascensos/descensos de rango con tarjetas visuales y roasts generados por IA mediante Groq. Permite apuestas en tiempo real (ZankCoins) sobre victorias/derrotas, con pagos 2x. Incluye análisis diario automático por jugador y detección de enfrentamientos entre rivales en custom games ("Versus Kings").
La arquitectura usa Next.js 15, React 19, TypeScript, Prisma con SQLite como base de datos local. El despliegue es simplificado con Docker Compose v2, incluyendo servicios para sincronización periódica y análisis diario. Requiere claves API de Riot Games, Groq y configuración de Discord (bot token, canales, verificación).
- Ranking en tiempo real para grupos de amigos jugando League of Legends.
- Bot de Discord que notifica ascensos/descensos con roasts IA.
- Sistema de apuestas ZankCoins sobre victorias/derrotas en custom games.
- Análisis diario automático por jugador generado con Groq.
- Comparativas 1v1 entre jugadores del grupo.
- Muros de fama y vergüenza con reacciones sociales.
- Sincronización automática desde Riot Games API (LP, matches, rachas).
- Análisis IA diario por jugador usando Groq API.
- Bot Discord integrado con comandos /rank y /agregar-jugador.
- Sistema de apuestas ZankCoins con pagos 2x en tiempo real.
- Panel web moderno con Next.js 15 y React 19.
- Self-hosted con Docker Compose simplificado (SQLite + cron).
- Requiere claves API externas (Riot, Groq, Discord) para funcionalidad completa.
- Análisis IA solo disponible si se configura GROQ_API_KEY.
- Base de datos SQLite no escalable para grandes volúmenes de datos.
- Sincronización cada 5 minutos por defecto (POLL_INTERVAL_MINUTES).
- Requiere HTTPS para Discord Interactions Endpoint URL.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Clonar repositorio y crear .env con RIOT_API_KEY, SESSION_SECRET, ADMIN_PASSWORD_HASH. Generar hash admin con docker compose run --rm npm app run hash-admin-password. Ejecutar docker compose up -d para iniciar servicios (app + scheduler). Configurar reverse proxy HTTPS para Discord Interactions Endpoint URL. Backup automático de SQLite en /data/zank.db.bak cada inicio. Actualizar con git pull && docker compose up -d --build.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.