01🚀Primeros pasos
El panel de administración es donde se opera la liga semana a semana: jugadores, equipos, rol de juegos, captura de pinos, handicap, cobranza y comunicación. Se entra desde el portal con el usuario que el club te asignó, y cada liga tiene su propio panel.
Cómo está organizado
Arriba están las pestañas. Cada una es un módulo independiente. Las que usarás cada semana son 🎳 Puntuación, 📥 Capturas Capitanes y 💰 Pagos. Las de configuración (⚙️ Config. Liga, 🎲 Rol de Juegos) se usan al arrancar la temporada y rara vez después.
El flujo de una temporada
- Configurar la liga: semanas, juegos por serie, sistema de handicap, tarifa. (Config. Liga)
- Crear equipos y jugadores, con su promedio base si ya tienen historial. (Equipos, Jugadores)
- Generar el rol de juegos: quién juega contra quién, en qué pista, qué fecha. (Rol de Juegos)
- Cada semana: capturar pinos (o aprobar lo que envían los capitanes), registrar pagos, publicar avisos.
- Al final: playoffs, reporte de temporada, bolsa de premios.
02⚙️Configuración de la liga
Datos generales
| Campo | Para qué sirve |
|---|---|
| Nombre, boliche, ubicación | Se muestran en la página pública, hojas impresas y correos. |
| Presidente, secretario, contacto | Informativos; aparecen en el reglamento y la página pública. |
| Día y hora de juego | Se usan para calcular la semana en juego y en los avisos. |
| Fecha de inicio | Punto de partida para fechar cada semana del rol de juegos. |
| Juegos por serie | Normalmente 3. Define cuántas columnas de juego hay en captura y hojas. |
| Total de semanas | Largo de la temporada regular. El rol de juegos se genera con este número. |
| Pista inicial | Desde qué pista empieza a asignar el rol. |
Jugadores por equipo (para pagos)
De 1 a 6. No limita cuántos jugadores puedes registrar; es la referencia para la cuota del equipo y el indicador "pagados / esperados". Elige 1 jugador (individual) para ligas de singles o mano a mano: cada "equipo" es una persona y todo lo demás funciona igual.
Tarifa y blind
- Tarifa por jugador por día de juego: base de toda la cobranza.
- Castigo por blind (pinos): cuando un jugador no llega, se le anota un blind = su promedio menos este castigo. Ver Puntuación.
Opciones de handicap
Se explican a detalle en Handicap. En resumen:
- Sistema: por porcentaje (base − promedio) × factor, o por rangos de promedio. Se puede configurar distinto para hombres y mujeres.
- Tope de HCP: máximo de pinos de handicap por juego, por género.
- Sin handicap en semana 1: todos juegan scratch la primera semana.
- Mantener promedio base: el HCP se sostiene en el promedio base durante los primeros N juegos (default 9).
Otros
- Recibos de pago: al registrar un pago se envía recibo por correo al jugador (si tiene correo).
- Tema: color de la página pública de la liga.
03👥Equipos
Un equipo tiene nombre, emoji (aparece en todas las pantallas y hojas) y sus jugadores. El orden de los equipos se usa para el rol de juegos y las listas.
- Crear equipo: nombre y emoji. Después agrégale jugadores desde Jugadores.
- Editar perfil del equipo: nombre, emoji, división (informativa).
- Capitán: se marca desde el jugador (Editar Jugador → "Es el capitán de su equipo"). Solo puede haber uno por equipo; al marcar otro, el anterior se desmarca solo. El capitán recibe el enlace de captura (ver Capturas de capitanes).
- Eliminar equipo: solo si no tiene partidos jugados. Un equipo con historial no se puede borrar; oculta a sus jugadores en su lugar.
04📋Jugadores
Dar de alta
Selecciona el equipo, escribe el nombre, elige género y, si ya tiene historial, su promedio base. El promedio base se usa para el handicap mientras el jugador no tiene juegos en esta liga (o durante sus primeros N juegos si la liga tiene activa la regla "mantener promedio base").
Editar jugador
| Campo | Detalle |
|---|---|
| Correo / Teléfono | Para recibos, avisos y WhatsApp. El opt-in de WhatsApp es obligatorio para enviarle mensajes. |
| Género | Define qué fórmula de handicap se le aplica (si la liga las tiene separadas). |
| Senior | Etiqueta informativa (👴 SR) para categorías por edad. |
| Promedio base | Promedio de entrada. Ver Handicap. |
| HCP fijo 🔒 | Bloquea el handicap en un número. Ignora promedio, semana y overrides. Útil para invitados o reglas especiales. |
| Patrocinado 🤝 | No paga cuota en toda la temporada: cada semana que juegue se registra sola como patrocinada. Ver el manual del tesorero. |
| Capitán | Uno por equipo. Recibe el enlace de captura. |
| BowlID | Número de 5 dígitos que une al jugador en todas sus ligas. Ver Página pública y BowlID. |
| Equipo | Cambia al jugador de equipo. Ver abajo. |
Cambiar de equipo a media temporada
En Editar Jugador, bloque azul Equipo: elige el equipo nuevo y guarda. El jugador aparece en el equipo nuevo a partir de la siguiente captura.
Ocultar a un jugador (baja de temporada)
Botón 🚫 Ocultar. Úsalo cuando alguien deja la liga. El jugador desaparece de listas, hoja de juego, captura, cobranza, página pública y rankings de aquí en adelante, pero:
- Sus scores no se borran. Las semanas que jugó siguen mostrándolo y los totales de esas semanas no cambian.
- En Jugadores aparece al final del equipo en la sección gris OCULTOS, con botón ↩ Mostrar para regresarlo.
Quitar (borrar de verdad) solo aparece si el jugador no tiene ningún juego registrado.
Enlace personal del jugador
Cada jugador tiene un enlace único (jugador.php?t=…) donde ve sus promedios, juegos, equipo y pagos sin contraseña. Desde Jugadores puedes generar el enlace, copiarlo o enviarlo por correo al jugador. Si el jugador tiene BowlID, su panel (mi.php) junta todas sus ligas.
05🎲Rol de juegos y calendario
Generar el rol
Con los equipos ya creados, Generar rol crea todos los partidos de la temporada: para cada semana, qué equipo contra cuál y en qué pista, con fecha a partir de la fecha de inicio. Con número impar de equipos, un equipo descansa cada semana.
Calendario
Vista semana por semana con pista, equipos y estado (jugado / pendiente). Desde aquí se puede ajustar una fecha puntual (por ejemplo, un día festivo).
06🎳Puntuación (captura semanal)
Capturar un partido
- Elige la semana (por default abre la semana en juego según el calendario).
- Elige el partido (pista y equipos) y da Cargar. Los partidos ya capturados se marcan con ✓.
- Captura los pinos de cada jugador, juego por juego. Los totales, el HCP y el neto se calculan en vivo.
- Guardar. El partido queda con totales, puntos y ganador.
Columna HCP
- Morado: calculado automáticamente del promedio. Puedes editarlo para ese partido (override).
- Dorado: override manual. Con reset vuelve a la fórmula.
- Verde 🔒: HCP fijo del jugador, se edita en Jugadores.
- BASE: HCP sostenido en el promedio base por la regla "mantener promedio base".
Blind (jugador que no llegó)
Marca la casilla blind del juego que faltó, o usa 🎳 Todo Blind para los tres. Se anota su promedio menos el castigo por blind. Los juegos blind no cuentan para el promedio del jugador ni para sus marcas, pero sí suman al equipo.
Jugar scratch esta semana
Interruptor arriba de la captura: ese partido se juega sin handicap, sin importar la configuración de la liga. Es una excepción puntual por partido.
Cómo se puntúa un partido
Sistema de 4 puntos: 1 punto por cada juego ganado (neto, con handicap) y 1 punto por la serie total. En empate, cada equipo recibe medio punto (se muestra como .5).
Acciones del partido
| Acción | Qué hace |
|---|---|
| 🔄 Recalcular | Vuelve a calcular HCP, netos y puntos con la configuración actual. Úsalo después de cambiar reglas de handicap. |
| Limpiar | Borra los scores del partido y lo deja como no jugado. También invalida los envíos aprobados de los capitanes de esa semana para que puedan volver a capturar. |
| ✨ Generar resumen | La IA escribe una crónica de la jornada con resultados y mejores juegos, para compartir. |
| 🆔 Enviar a BowlID | Manda los pinos crudos (sin handicap) de la semana a BowlID de los jugadores vinculados. Los blind no se envían. |
07📥Capturas de capitanes
Activar
Interruptor Captura por capitán: ACTIVADA / DESACTIVADA. Cuando está activa, cada equipo tiene un enlace (capturar.php?t=…) que puedes copiar o enviar al capitán. Solo el capitán del equipo debería tenerlo.
Qué ve el capitán
Al abrir su enlace ve la primera semana que su equipo todavía no tiene capturada, contra quién juega y la lista de su equipo. Captura los tres juegos de cada jugador, marca blind si alguien faltó, adjunta la foto del marcador y envía. Si ya envió y está pendiente, ve el aviso; si fue rechazado, ve el motivo y puede corregir y reenviar.
Bandeja de pendientes
Arriba a la derecha está la SEMANA EN JUEGO según el calendario. Cada envío muestra equipo, semana, fecha, tabla de pinos y foto (clic para ampliar).
- Corregir un puntaje: los números de la tabla son editables. Si el capitán se equivocó en un juego, corrígelo ahí mismo (se pinta dorado) y aprueba. Queda registrado qué cambiaste.
- Aplicar a semana: por default la semana del envío. Si el capitán capturó con la semana equivocada, verás un aviso ⚠️ y puedes elegir la correcta antes de aprobar.
- ✓ Aprobar: escribe los pinos en el partido y recalcula. Solo toca a los jugadores de ese equipo, nunca al rival.
- ✕ Rechazar: con motivo opcional. El capitán lo ve en su enlace y puede reenviar.
08📊Handicap y promedios
El promedio
Promedio = suma de pinos ÷ juegos registrados, sin contar blinds. Para el handicap de una semana se usan los juegos de las semanas anteriores (la semana 1 usa sus propios juegos). Si el jugador no tiene juegos, se usa su promedio base.
Sistemas de handicap
| Sistema | Cálculo | Ejemplo |
|---|---|---|
| Porcentaje (estándar) | (Base − Promedio) × Factor% | Base 220, factor 80%, promedio 150 → (220−150)×0.8 = 56 |
| Rangos | Tabla de pinos fijos por rango de promedio | 180-219 → 20 · 140-179 → 40 · hasta 139 → 60 |
Base y factor pueden ser distintos para hombres y mujeres. El tope de HCP limita el resultado por género. El HCP nunca es negativo.
Jerarquía: qué manda sobre qué
- Jugar scratch esta semana (partido) o Sin HCP en semana 1 (liga) → HCP 0 para todos.
- HCP fijo 🔒 del jugador.
- Override manual en ese partido.
- Cálculo automático del promedio (con la regla de promedio base si aplica).
Regla "mantener promedio base"
Para ligas donde un jugador con promedio conocido lo conserva durante sus primeros juegos. Se activa en Config. Liga con el número de juegos (default 9).
- Aplica solo a jugadores con promedio base > 0.
- Mientras tenga menos de N juegos registrados (sin blind), su HCP se calcula con el promedio base. En pantalla se marca BASE.
- Al completar N juegos, el HCP pasa al promedio real de todos sus juegos. Como el HCP usa semanas anteriores, si juntó los 9 en las semanas 1-3, la semana 4 ya sale con HCP real.
- El promedio que se muestra en listas siempre es el real; solo el HCP se sostiene.
Hoja de HCP
Desde Promedios y HCP: imprime la lista de todos los jugadores con promedio, juegos y HCP vigente, por equipo. Útil para pegar en el boliche cada semana.
09🖨️Hoja de juego e impresiones
- Hoja de juego: por semana, una hoja por pista con los dos equipos, sus jugadores, promedio y HCP, y espacios para anotar. Se imprime para llevar a las pistas. Los jugadores ocultos no aparecen.
- Hoja de HCP: lista de promedios y handicaps (ver Handicap).
- Reporte de cobranza: resumen imprimible de pagos y adeudos (ver Cobranza).
- Reporte de temporada: standings, mejores marcas y estadísticas de toda la temporada, listo para imprimir o compartir.
10💰Pagos y cobranza
El detalle de cómo registrar cada tipo de pago (efectivo, tarjeta, abonos, patrocinados, pacers, blinds), cómo cuadrar la caja y cómo usar cada reporte está en el Manual del tesorero. Aplica igual si tú llevas la caja desde el panel de admin.
Lo que solo el administrador tiene
- Estado de cuenta: resumen por jugador de toda la temporada: pagado, abonado, pendiente, y totales de la liga.
- Bolsa de premios: la bolsa es un monto definido por la liga (por ejemplo $5,000), que se captura y se guarda aquí junto con los porcentajes de 1º y 2º (3º es automático). Los premios y el cuadro "si fuera la premiación hoy" se calculan sobre ese monto. Lo recaudado real aparece solo como referencia y no incluye pacers ni patrocinados.
- Patrocinado toda la temporada se activa desde Editar Jugador (el tesorero no puede editar jugadores).
- Tarifa y recibos se definen en Config. Liga.
11📢Avisos, envío masivo y reglamento
Avisos
Mensajes que aparecen en la página pública de la liga y en el panel de cada jugador. Tienen título, texto, fecha y se pueden fijar o desactivar. Úsalos para cambios de horario, torneos, cobros.
Envío masivo
Correo (y WhatsApp a quienes dieron opt-in) a toda la liga, a un equipo o a una selección de jugadores. Incluye plantillas para acceso personal, recordatorio de pago y aviso general. Cada envío queda en la bitácora.
Reglamento
Editor del reglamento de la liga. Se publica en la página pública y en el enlace de cada jugador. Se puede pedir a la IA un borrador a partir de la configuración de la liga y editarlo.
12🏆Playoffs y bracket
Al terminar la temporada regular, genera el bracket con los equipos clasificados según los standings (elige cuántos entran). Cada ronda se captura como un partido normal y el ganador avanza solo. El bracket se publica en la página pública (bracket.php) y el campeón queda registrado en el reporte de temporada.
13🌐Página pública y BowlID
Página pública de la liga
Desde el panel hay un botón Ver página pública. Incluye: standings, resultados por semana (matchups.php), destacados de la semana y de la temporada (mejor juego y mejor serie por género), tops, estadísticas por jugador, avisos, reglamento y bracket. Es la que conviene compartir en el grupo de WhatsApp de la liga.
Página del club
Si el club tiene página pública activada (/c/nombre-del-club), ahí aparecen todas sus ligas con enlace a cada una.
BowlID
Identificador de 5 dígitos por jugador, válido en todas las ligas del sistema. Se captura en Editar Jugador. Con BowlID:
- El jugador ve todas sus ligas en un solo panel (
mi.php), aunque sean de clubes distintos. - Sus pinos se pueden enviar a BowlID desde Puntuación para su historial global.
14🎫Soporte
Si algo no funciona o necesitas un ajuste, abre un ticket desde el panel con asunto, descripción y prioridad. El equipo de LigaBoliche lo recibe con el contexto de tu liga. Verás las respuestas en la misma pestaña.
15❓Preguntas frecuentes
Un jugador se cambia de equipo en la semana 17
Editar Jugador → Equipo → elige el nuevo → Guardar. Sus semanas anteriores se quedan con el equipo anterior; conserva promedio e historial. Ver Jugadores.
Un jugador se va de la liga y tiene juegos
No lo borres: 🚫 Ocultar. Sus juegos y los resultados de su equipo no cambian. Ver Jugadores.
El capitán capturó con la semana equivocada
En la bandeja verás el aviso ⚠️ de semana distinta. Elige la semana correcta en "Aplicar a semana" y aprueba. Ver Capturas.
El capitán se equivocó en un puntaje
Corrígelo en la tabla de la bandeja (queda dorado) y aprueba. No hace falta rechazar. Ver Capturas.
Al capitán le sale una semana adelantada
Ese equipo ya tiene pinos en la semana que esperabas. Si fue un error, limpia el partido desde Puntuación: el enlace del capitán regresa a esa semana.
Cambié el handicap y los standings no se movieron
Los partidos ya jugados no se recalculan solos. Usa 🔄 Recalcular en cada partido, o el recálculo masivo en Promedios y HCP. Ver Handicap.
¿Cómo se desempata un juego?
Medio punto para cada equipo, tanto en juego como en serie. Se muestra como .5 en standings.
Un jugador no llegó
Marca blind en sus juegos (o Todo Blind). Su equipo suma su promedio menos el castigo; el jugador no altera su promedio. Ver Puntuación.
Un patrocinado aparece con deuda
Activa "🤝 Patrocinado toda la temporada" en Editar Jugador: sus semanas se corrigen solas. Ver manual del tesorero.
Liga individual (1 jugador por equipo)
En Config. Liga elige "1 jugador (individual)". Cada persona es un equipo. Rol, captura, standings y cobranza funcionan igual. Si la persona no llega, se marca blind como en cualquier equipo.