Glicko DB

Documentación: Español | English | Português

Glicko DB es una aplicación Flask y SQLite para administrar jugadores, ratings, partidas y torneos de una communidad de Go. Ofrece posiciones y estadísticas públicas, junto con pantallas de administración protegidas para importaciones, configuración del rating, copias de seguridad y operaciones de torneos.

Funciones

Posiciones públicas, búsqueda de jugadores, perfiles, historial de partidas, gráficos de rating y conversión de categorías
Cálculo Glicko-2 con parámetros de rating y categoría configurables
Interfaz pública en español, inglés y portugués
Administración de jugadores y partidas con paginación, filtros y ordenación consistente
Biblioteca pública de registros SGF; las cuentas autenticadas pueden cargar archivos sin vincularlos, y los directores de torneo, operadores y administradores pueden vincularlos o desvincularlos
Importación de libros Excel (XLSX), OpenGotha (XML) y archivos de partidas (CSV)
Creación y edición de torneos, importación de OpenGotha, emparejamientos, registro de resultados, clasificación y exportación
Registro de cuentas de miembros y envío de resultados individuales para aprobación administrativa
Reportes públicos por periodo (por defecto, todo el tiempo) con filtros por jugador, exportación CSV/PDF localizada, cambios de rating y rendimiento por oponente, país y club
Noticias publicadas por administradores, con enlaces rápidos a jugadores, torneos, partidas y registros SGF
Sistemas Suizo, Suizo por Categoría, Suizo Acelerado y McMahon
Manejo de descansos y ausencias, copias de seguridad, protecciones de restauración y migraciones SQLite
Torneos en estado borrador ocultos de los listados públicos, con opción administrativa para mostrar borradores
Partidas con hándicap en piedras (estilo Go), con sugerencia automática por diferencia de categoría y ajuste de rating estilo OGS
Instalación como aplicación desde navegadores móviles compatibles, excepto Safari

Ayuda para usuarios

La guía de la interfaz es la referencia para las tareas diarias. También está disponible desde el botón ? de la barra superior o en /help?lang=es. En navegadores móviles compatibles, puedes agregar Glicko DB a la pantalla de inicio como aplicación.

Requisitos

Python 3.10 o posterior
pip
Paquetes de Python:
Flask>=3.0
Flask-WTF>=1.2
Werkzeug>=3.0
openpyxl>=3.1
reportlab>=4.0
Pillow==11.3.0 (requerido por ReportLab para generar PDF)
tzdata>=2024.1 (Windows time zone data)

Ejecución local

Windows PowerShell:

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt
$env:APP_SECRET_KEY = "reemplaza-por-un-valor-aleatorio-largo"
$env:ADMIN_PASSWORD = "elige-una-contrasena-segura"
python app.py

macOS o Linux:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
export APP_SECRET_KEY="reemplaza-por-un-valor-aleatorio-largo"
export ADMIN_PASSWORD="elige-una-contrasena-segura"
python app.py

Abre http://127.0.0.1:5000 en el navegador. La aplicación crea la base de datos SQLite en data/acg_ratings.db durante el primer inicio.

Solo para datos de ejemplo locales, define LOAD_SAMPLE_DATA=1 antes de iniciar. No uses datos de ejemplo en una base de datos de producción.

Configuración

Los valores predeterminados están en config.py.

APP_SECRET_KEY: clave de firma de las sesiones Flask. Debe configurarse en producción.
ADMIN_PASSWORD: contraseña del acceso de administración actual. Debe reemplazarse en producción.
LOAD_SAMPLE_DATA=1: importa rank-final.xlsx si existe y reemplaza el conjunto de datos actual; solo para desarrollo local.
DB_PATH: ubicación de la base de datos SQLite, definida en config.py.
AUDIT_RETENTION_DAYS: número de días para conservar eventos de auditoría; el valor predeterminado es 730.
MAIL_SERVER, MAIL_PORT, MAIL_USERNAME, MAIL_PASSWORD, MAIL_USE_TLS y MAIL_FROM: configuración SMTP para recuperación de contraseñas; PASSWORD_RESET_TTL_SECONDS controla la caducidad del enlace y usa 3600 segundos por defecto.
RECAPTCHA_SITE_KEY y RECAPTCHA_SECRET_KEY: claves de Google reCAPTCHA v3 para el formulario de registro de miembros. La clave secreta se verifica en el servidor y nunca debe exponerse al navegador.
RECAPTCHA_MIN_SCORE: puntuación v3 mínima aceptada para el registro; por defecto es 0.5.
RECAPTCHA_EXPECTED_HOSTNAME: comprobación opcional del hostname en la respuesta; déjalo vacío si la clave sirve para varios hostnames configurados.
La hora predeterminada es UTC-5. Cada cuenta puede elegir una zona IANA; las partidas del mismo día se procesan por ronda y luego por orden de inserción.
/reports usa rangos inclusivos start_date y end_date en la zona fija del servidor. Los totales de pantalla y de las exportaciones CSV/PDF se calculan con los mismos filtros.
Las cuentas tienen roles administrator, tournament_director, operator y member. Los miembros solo envían resultados de su jugador vinculado; los demás roles revisan la cola de aprobación.
/admin/settings permite ajustar los límites de inicio de sesión y la caducidad de recuperación. En producción usa HTTPS, contraseñas únicas y secretos solo en variables de entorno.
Las cuentas autenticadas pueden cargar archivos SGF sin vincularlos. Los administradores, directores y operadores pueden vincularlos o desvincularlos; solo los administradores pueden eliminar archivos.

Hoja de ruta del proyecto

La hoja de ruta está en FUTURE_FEATURES.md. La reconciliación de importaciones, los payloads tipados de OpenGotha, los filtros de auditoría, las mejoras de perfiles y la eliminación explícita de torneos ya están implementados. El trabajo restante incluye mejorar el tema oscuro de BesoGo.

Desarrollo

Regenera las guías HTML después de cambiar sus fuentes Markdown:

python scripts/build_help_html.py

Ejecuta la suite de regresión desde la raíz del proyecto:

pytest -q

Organización del código

Las rutas administrativas están separadas por dominio entre routes/admin_tournaments.py, routes/admin_matches.py, routes/admin_players.py y routes/admin_users.py. La lógica de torneos está separada por responsabilidad entre services/tournament_gotha.py, services/tournament_participants.py, services/tournament_pairing.py, services/tournament_matches.py y services/tournament_standings.py. Las traducciones y la selección de idioma viven en services/i18n.py, mientras que los helpers puros de gráficos de rating viven en services/chart_service.py; services/common.py conserva exports de compatibilidad para los imports existentes. services/tournament_service.py se conserva como fachada de compatibilidad. La suite completa de regresión pasa actualmente 373 pruebas.

Instalación en hosting Linux

Usa Python 3.10 o posterior y crea un entorno virtual nuevo antes de instalar:

python3.11 -m venv .venv
.venv/bin/python -m pip install --upgrade pip
.venv/bin/python -m pip install --only-binary=Pillow -r requirements.txt

Si ese comando indica que no existe una rueda compatible de Pillow, la versión de Python, la arquitectura o la distribución Linux seleccionada por el hosting no es compatible. Selecciona Python 3.10+ x86_64 en el panel del hosting; no intentes compilar Pillow sin las bibliotecas de desarrollo de Python, JPEG, zlib y freetype del sistema.

Las pruebas cubren ratings y gráficos, filtros de jugadores, soporte de idiomas, respaldos, migraciones de torneos, emparejamientos, clasificación, compatibilidad con OpenGotha, moderación de resultados y páginas públicas de torneos.

La cobertura de pruebas también incluye la biblioteca SGF, la sincronización de sus metadatos, la reparación de enlaces faltantes, sus permisos y la restauración desde copias de seguridad.

La funcionalidad de ordenación, filtros y búsqueda consistente ya está entregada y validada en las páginas de jugadores, partidas y torneos.

Licencia y atribución

Glicko-db fue originalmente desarrollado para la comunidad de Go en Colombia por Juan Felipe Samper en 2026.

El sistema Glicko-2 fue publicado por Mark E. Glickman en 2022 al dominio público. La implementación en python es ©2009 Ryan Kirkman y BesoGo es ©2015-2018 Ye Wang. Ambas se distribuyen bajo la licencia MIT.