Glicko DB

Ayuda de la interfaz

Consulta las rutas y notas de integración y el README en español. También puedes abrir esta guía desde el botón ? de la barra superior o en /help?lang=es.

Accesibilidad y dispositivos

Tabla de contenidos

Interfaz pública

No se requiere una cuenta para /, /rankings, /players, /player/view?id=<player_id>, /matches, /tournaments, /tournaments/<tournament_id>, /reports, /category y /sgf-library. Estas páginas ofrecen posiciones, perfiles, historial de partidas, torneos públicos, clasificaciones, información de ratings, reportes y visualización o descarga de SGF.

Haz clic en cualquier captura para ampliarla sin salir de esta guía. Cierra la vista con Esc, el botón de cierre o haciendo clic fuera de la imagen.

Página pública de inicio

La página pública ofrece navegación, controles de idioma y tema, posiciones, estadísticas y enlaces al contenido público.

Las páginas aceptan ?lang=es, ?lang=en o ?lang=pt; usa AAAA-MM-DD en los filtros y campos de fecha.

Posiciones y directorio de jugadores

Perfil público de Acuña, Carlos

Perfil público con rating actual, categoría y resumen de actividad del jugador seleccionado.

Partidas y visor SGF

Torneos públicos

Detalle público de un torneo

Detalle de un torneo con selector de ronda, mesas emparejadas, resultados y clasificación.

Reportes periódicos y exportación

Conversor de categoría

La página /category convierte un rating Glicko a categoría Dan/Kyu y muestra la fórmula, las constantes configuradas y la escala completa. Dos controles desplegables, cerrados inicialmente, muestran la fórmula de conversión de categorías y la fórmula Glicko-2 con sus parámetros actuales; los valores configurables se destacan también en /admin/ratings.

La fuerza aumenta de 30 kyu a 1 kyu, después de 1 dan a 9 dan: en kyu un número menor es más fuerte, pero en dan lo es un número mayor. Los límites de la escala interna continua son -N para N kyu y N - 1 para N dan (no existe 0 kyu ni 0 dan); la categoría entera se obtiene con floor sobre ese valor. Un valor mostrado con decimales puede redondearse visualmente al límite siguiente aunque el valor sin redondear aún no lo haya alcanzado.

El campo Glicko ocupa todo el ancho disponible del formulario. En /admin/categories, los campos GLICKO_K y GLICKO_M son más anchos y están centrados; se apilan cuando no caben juntos en pantallas estrechas.

Noticias públicas

La página /news/<article_id> muestra el artículo publicado y transforma las etiquetas de jugadores, torneos y partidas en enlaces relacionados.

Biblioteca SGF

La biblioteca pública (/sgf-library) muestra archivos SGF de uploads/sgf, con o sin partida vinculada, sujetos a las reglas de visibilidad: - Al subir archivos, valida el tamaño, la codificación UTF-8 y la estructura básica SGF. - Sincroniza metadatos del encabezado SGF (jugadores blanco y negro, rangos, evento, fecha y resultado) con la partida asociada en la base de datos. - Si un archivo desaparece, su referencia se conserva pero el enlace no se muestra; vuelve a funcionar si el archivo reaparece con el mismo nombre de almacenamiento. - Desvincular un archivo o borrar la partida conserva el registro en la biblioteca; solo los administradores pueden borrar el archivo físico definitivamente.

Los administradores pueden seleccionar varios archivos SGF y eliminarlos en una sola acción. Las partidas y los resultados pendientes vinculados se conservan y se limpian sus referencias SGF antes de eliminar los archivos.

Interfaz de miembros

Los jugadores de la comunidad pueden registrar una cuenta personal para gestionar sus preferencias y enviar resultados de torneos o partidas individuales.

Registro e inicio de sesión

  1. Abre /admin/register para crear una cuenta proporcionando nombre de usuario, correo electrónico y contraseña (mínimo 8 caracteres). El formulario incluye protección Google reCAPTCHA v3.
  2. Las cuentas nuevas reciben automáticamente el rol member.
  3. Inicia sesión en /admin/login. Para reportar resultados, solicita el vínculo con tu ficha en Reportar resultados y espera la aprobación.

Gestión de perfil y preferencias

El menú Usuario reúne Menú de Admin (según permisos), Reportar Resultados, Perfil y Cerrar sesión. Ábrelo con el ratón, el teclado o mediante toque; pulsa Esc para cerrarlo.

Desde /admin/profile, cada usuario autenticado puede: - Actualizar su dirección de correo electrónico para notificaciones y recuperación. - Cambiar el idioma preferido de la interfaz (Español, English, Português). - Alternar entre el tema claro y el tema oscuro. - Seleccionar su zona horaria IANA entre opciones estables, aunque compartan el ajuste UTC actual (por ejemplo, UTC y Europe/London en invierno). El ajuste mostrado cambia con el horario de verano; una zona válida guardada fuera de la lista sugerida sigue disponible al editar el perfil. - Cambiar su contraseña actual ingresando la contraseña anterior y la nueva confirmada. - En Tokens de acceso a la API, crear y revocar tokens personales para la API autenticada tras confirmar su contraseña actual. Cada token se muestra una sola vez y dura hasta 90 días (30 por defecto). Los administradores eligen sus permisos (scopes); las demás cuentas reciben los que permiten sus roles actuales, indicados en el formulario. Un token nunca concede más que los permisos actuales del rol, y las operaciones de la API solo funcionan cuando un operador las habilita (ver la guía de la API).

Perfil del miembro

Pantalla de perfil de usuario para gestionar idioma, tema, zona horaria y contraseña.

Recuperación de contraseña

  1. Si olvidaste tu contraseña, haz clic en ¿Olvidaste tu contraseña? en /admin/login o ingresa a /admin/forgot-password.
  2. Ingresa tu correo registrado. Si existe en el sistema, recibirás un enlace de un solo uso con token hash criptográfico.
  3. El enlace expira automáticamente según el tiempo configurado (PASSWORD_RESET_TTL_SECONDS, por defecto 3600 segundos).
  4. Abre el enlace /admin/reset-password/<token> e ingresa tu nueva contraseña. Por motivos de seguridad, la respuesta no revela si un correo está registrado o no.

Reportar resultados

Los miembros pueden reportar resultados de partidas en /admin/report-results:

  1. Vínculo con jugador: si tu cuenta de miembro no tiene jugador vinculado, selecciona tu ficha entre los jugadores sin cuenta vinculada y usa Solicitar vínculo en esta página. Solo puede haber una solicitud pendiente por cuenta. Un gestor del país/región del jugador o un administrador la aprueba o rechaza en Resultados por aprobar (/admin/result-submissions), con una nota opcional. La solicitud no vincula la cuenta ni habilita el reporte hasta su aprobación. Después, inicia sesión de nuevo. Aquí puedes ver el historial y las notas; tras un rechazo puedes solicitar otro vínculo. La disponibilidad se verifica de nuevo al aprobar para evitar que dos cuentas reclamen al mismo jugador. Los administradores pueden seguir asignando vínculos directamente.
  2. Formulario de envío:
    • Oponente: selecciona el jugador rival de la lista de jugadores activos.
    • Color: indica si jugaste con Blancas o Negras.
    • Resultado: indica si ganaron Blancas (1-0), ganaron Negras (0-1) o Tablas (1/2-1/2).
    • Fecha: fecha en que se jugó la partida (AAAA-MM-DD).
    • Evento y Lugar: nombre del torneo o club y ciudad donde se disputó.
    • Ronda: número de ronda si corresponde.
    • Piedras de hándicap: cantidad de piedras (0 a 9) otorgadas a Negras.
    • Archivo SGF (opcional): carga el archivo .sgf con el registro de jugadas.
  3. Estado de envío: una vez enviada, la partida queda en estado Pendiente en la cola de moderación (/admin/result-submissions). No afecta rankings, ratings ni reportes públicos hasta que sea revisada y aprobada por el equipo administrativo.

Envío de resultados de miembros

La pantalla muestra el requisito de vincular un jugador y el área de envíos pendientes.

Panel de administración

Inicia sesión en /admin/login con una cuenta con rol administrativo. El menú se adapta automáticamente según los permisos asignados: - member: acceso a perfil y reporte de resultados de su jugador vinculado. - country_organizer / regional_organizer (Organizadores): gestión de jugadores y torneos, incluyendo creación de jugadores desde torneos, edición/eliminación de jugadores, partidas, vinculación SGF, importación de torneos, participantes, emparejamientos, rondas, resultados y exportaciones. - country_manager / regional_manager (Gestores): las herramientas de los organizadores, además de importación de jugadores dentro del ámbito, noticias y moderación de resultados. - administrator: control total de la plataforma, incluyendo jugadores, configuración de ratings/categorías, copias de seguridad, gestión de usuarios, auditoría y parámetros del sistema.

Los tres niveles de acceso son Global, Regional y País. Los administradores tienen acceso global. Los roles de país requieren un país, que puede heredarse del jugador vinculado cuando no se selecciona uno explícito; los regionales requieren una región explícita admitida (actualmente América Latina, identificada como latam). Un rol de país no puede usar una región ni un rol regional un país. Sin un ámbito válido compatible, las rutas geográficas se deniegan. El personal puede gestionar jugadores dentro del ámbito, partidas con al menos un jugador dentro del ámbito y torneos cuyo país pertenezca al ámbito.

Herramientas Organizadores Gestores Administradores
Jugadores, torneos, partidas y registros SGF País/región asignado País/región asignado Global
Importación de jugadores y moderación de resultados No País/región asignado Global
Noticias No Sí (noticias compartidas del sitio) Sí
Copias de seguridad, importaciones globales, recálculo de ratings y categorías No No Solo global
Usuarios, auditoría y configuración No No Solo global

El menú agrupa las tareas en Jugadores y competición (jugadores, partidas, torneos y resultados por aprobar), Importaciones y ratings (importación de jugadores, importación general, ratings y categorías), Contenido y registros de partidas (noticias y biblioteca SGF) y Administración del sitio (usuarios, configuración, copias de seguridad, auditoría y estadísticas). Cada tarjeta completa es un enlace accesible por teclado, sin un enlace «Abrir» separado. Solo aparecen las herramientas permitidas y las secciones con tarjetas visibles; la organización no cambia los permisos.

Las cuentas operator migran a regional_manager y las tournament_director a regional_organizer; ambas reciben el ámbito de América Latina, sustituyendo cualquier país anterior. La migración invalida sus sesiones y tokens existentes una sola vez.

Gestión de torneos

1. Creación y configuración de torneos (/admin/tournaments)

2. Gestión de participantes

3. Emparejamientos, rondas y registro de resultados

Detalle del torneo y rondas

Panel de control de ronda de torneo: emparejamientos, mesas, selector de resultados y clasificación.

4. Procesamiento de rondas y cálculo de rating

Gestión de datos

1. Asistente de importación con vista previa (/admin/import)

Permite cargar datos históricos o torneos masivos: - Formatos aceptados: - Libro Excel (.xlsx): importa el conjunto completo de jugadores y partidas reemplazando los datos actuales. - XML de OpenGotha (.xml): importa metadatos del torneo, jugadores, partidas y piedras de hándicap. - Archivo CSV (.csv): columnas date, white, black, result y opcional handicap (0 a 9). - Crea una copia de seguridad antes de importar un libro que reemplace los datos activos. - Los límites de importación son 10 MiB por archivo, 100 MiB de contenido descomprimido para XLSX y 10 000 filas por hoja, CSV o conjunto combinado de participantes/partidas XML. La importación de jugadores de /admin/players conserva límites más estrictos: 5 MiB y 1000 jugadores. - Las cargas OpenGotha desde /admin/import y /admin/tournaments usan el mismo flujo de revisión y aprobación por etapas. Revisa o edita la configuración del torneo, el resumen de operaciones, las advertencias y las decisiones de participantes; la vista previa no modifica la base de datos. Usa Aprobar e importar solo después de revisar el resumen actualizado. Si cambian los jugadores o torneos mientras la vista está abierta, tendrás que cargar el archivo de nuevo. - Reconciliación explícita de jugadores: - La vista previa clasifica cada registro como Coincidencia exacta, Sugerencia difusa, Jugador nuevo o Duplicado. - El personal autorizado puede decidir por cada jugador: vincular al existente, crear nuevo o rechazar la fila. - Permite editar metadatos del torneo antes de confirmar la importación. - El CSV se valida antes de escribir: fechas, resultados (1-0, 0-1 o 1/2-1/2), hándicap, jugadores existentes y errores por fila/campo. Cualquier error bloquea toda la importación; las escrituras confirmadas son transaccionales. - La vista previa XLSX identifica filas/hojas con datos inválidos y no reemplaza datos si hay errores. La sustitución sigue exigiendo confirmación explícita y una copia previa verificada. - La vista previa OpenGotha informa partidas con jugadores no presentes en el XML. El recibo final muestra cantidades, advertencias y el estado de ratings. El torneo importado queda como borrador: no afecta inmediatamente a los ratings; al completarlo, las partidas elegibles pueden marcar la fecha afectada para recálculo. - Si DEFER_RATING_REPLAY_ON_IMPORT está activado, la importación se completa, pero se muestra un aviso de que los ratings pueden quedar desactualizados hasta ejecutar el recálculo aplazado.

Vista previa y reconciliación de importación

Ejemplo de vista previa y reconciliación de importación. Las importaciones de torneos OpenGotha usan una pantalla específica de revisión y aprobación.

2. Administración de jugadores (/admin/players)

Al seleccionar una categoría inicial, el campo de rating muestra un decimal; al guardar se conserva la precisión de la conversión para no bajar de categoría. Los ratings introducidos manualmente conservan su precisión.

3. Administración de partidas (/admin/matches)

4. Configuración de ratings y categorías (/admin/ratings y /admin/categories)

5. Moderación de resultados (/admin/result-submissions)

Tareas administrativas y de seguridad

1. Copias de seguridad y restauración (/admin/backups)

Gestión de copias de seguridad

Lista de copias con acciones de crear, restaurar y eliminar.

2. Gestión de usuarios (/admin/users)

3. Publicación de noticias (/admin/news)

4. Registro y revisión de auditoría (/admin/audit)

5. Estadísticas del sitio (/admin/analytics)

6. Configuración de seguridad de la aplicación (/admin/settings)

Guía de solución de problemas

  1. Acceso denegado (403): verifica tu rol de organizador, gestor o administrador y su ámbito geográfico compatible. La importación de jugadores, las noticias y la moderación requieren un gestor o administrador; las operaciones globales requieren un administrador.
  2. No puedo enviar resultados como miembro: confirma en /admin/users que tu cuenta esté vinculada a una ficha de jugador activa.
  3. Errores al importar archivos: - Verifica que el CSV use codificación UTF-8 y contenga las columnas obligatorias date, white, black, result. - Asegúrate de que las fechas tengan el formato AAAA-MM-DD y los resultados sean exclusivamente 1-0, 0-1 o 1/2-1/2. - Comprueba que el hándicap esté en el rango de 0 a 9 piedras.
  4. Archivos SGF no encontrados: la referencia se conserva sin mostrar un enlace roto. Si el operador devuelve el archivo a uploads/sgf con su nombre de almacenamiento original, el vínculo vuelve a funcionar; una nueva carga recibe otro nombre y debe vincularse explícitamente.
  5. Restauración de base de datos: tras restaurar una copia, el sistema ejecuta las migraciones pendientes y reconstruye el índice FTS5 antes de aceptar peticiones.
  6. Seguridad en producción: mantén siempre variables secretas (APP_SECRET_KEY, ADMIN_PASSWORD, credenciales SMTP y claves reCAPTCHA) configuradas en el entorno del servidor y nunca en el repositorio de código.
^