Bloque 3
Registrar una Ronda
Hay tres formas de meter una tarjeta en la app. Cada una tiene su caso ideal. Antes de explicarlas, entiende la diferencia fundamental entre subir y entregar.
Sección 3.1 — Concepto clave
Subir vs. Entregar
Como jugador, quiero entender por qué a veces meto una tarjeta pero no me suma al ranking.
Subir (estado = completada)
Guardar la tarjeta en tu historial. Siempre afecta a tu hándicap WHS y a tus estadísticas personales.
Entregar (entregas = 1)
Marcar la tarjeta para competición. Solo las entregadas suman puntos al ranking de la liga y ocupan uno de tus slots.
⚠️
¿Por qué puede no entregarse una tarjeta?
1. No alcanza el resultado_mínimo de la temporada.
2. Ya has agotado tus slots y la nueva no mejora tu peor entregada.
3. Slots llenos, sí es mejor, pero no tienes tokens de recompra (ver §3.5).
1. No alcanza el resultado_mínimo de la temporada.
2. Ya has agotado tus slots y la nueva no mejora tu peor entregada.
3. Slots llenos, sí es mejor, pero no tienes tokens de recompra (ver §3.5).
Sección 3.2
Jugar en Directo (Hoyo a Hoyo)
Como jugador, quiero registrar mi puntuación mientras juego, sin tener que acordarme al final.
Flujo
Barra inferior → "Jugar"
→
Seleccionar campo y barras
→
Scorecard
Pantalla de Selección
Busca el club (mínimo 3 caracteres), elige el recorrido (18/ida/vuelta) y selecciona el color de barras. El HCP de juego se ajusta automáticamente.
Scorecard V2 — Entrada de golpes
Cabecera con par, SI y distancia del hoyo. Teclado táctil integrado (botones grandes 1–9) para no activar el teclado del sistema. Botones + / − por jugador para ajuste rápido desde el par sugerido.
Cálculo automático
Los puntos Stableford netos se calculan en tiempo real al introducir cada golpe. Los putts y el GIR se registran automáticamente.
Modo Vista Grande (Accesibilidad)
Se activa desde el botón "Opciones" en la partida o en Ajustes. Presenta los jugadores en tarjetas grandes con botones + y − de alto contraste, ideal para usar con guantes o bajo el sol. El botón "Tarjeta" despliega una mini-scorecard con scroll horizontal centrada en el hoyo actual.
Barra de acción inferior
Modo Normal: Opciones · Vista (rota marcador) · Finalizar · Anular.
Modo Vista Grande: Opciones · Vista · Tarjeta · Fin.
El botón Vista rota entre Stableford, Match, Skins y Sindicato en ambos modos.
Modo Vista Grande: Opciones · Vista · Tarjeta · Fin.
El botón Vista rota entre Stableford, Match, Skins y Sindicato en ambos modos.
Ronda de 9 hoyos
Si tu liga lo permite, puedes jugar solo ida o vuelta. El hándicap se calcula extrapolando a 18 hoyos.
Sección 3.3
Subir Tarjeta Manualmente
Como jugador, quiero registrar una partida sin haber usado la app durante el juego.
Flujo
Barra inferior → "Subir Tarjeta"
→
"Manual"
Campos del formulario
Club y recorrido (con búsqueda) · Barras de salida · Fecha de la ronda · Puntos Stableford totales · Marca "Es torneo" (si aplica) · Tipo de ronda (18 / ida / vuelta).
Criterio de la liga (criterio_liga)
"Antes" — Debes declarar intención antes de jugar. Opciones: "Voy a jugar ahora" (hueco reservado) o "Ya jugué" (sube para hándicap, no cuenta para ranking).
"Después" — Puedes decidir si entregar al subir la tarjeta.
"Todas" — Cualquier tarjeta válida se entrega automáticamente.
"Después" — Puedes decidir si entregar al subir la tarjeta.
"Todas" — Cualquier tarjeta válida se entrega automáticamente.
Validaciones automáticas
Duplicados: Si ya existe una tarjeta idéntica (mismo jugador, fecha, campo, puntos) se bloquea el envío.
Resultado mínimo: Si estás por debajo, la tarjeta se sube pero con entregas = 0.
Recompra: Si has llenado tus slots, se dispara la lógica del §3.5.
Resultado mínimo: Si estás por debajo, la tarjeta se sube pero con entregas = 0.
Recompra: Si has llenado tus slots, se dispara la lógica del §3.5.
Sección 3.4
Subir Tarjeta por Foto (OCR)
Como jugador, quiero registrar la tarjeta sin teclear los 18 hoyos, simplemente haciendo una foto.
Flujo
Barra inferior → "Subir Tarjeta"
→
"Foto (OCR)"
Captura y procesamiento
Usa la cámara o selecciona de galería. El backend optimiza la imagen (brillo, contraste) y extrae con IA (Gemini 2.0): golpes por hoyo (1–18), fecha de la ronda y hándicap de juego anotado.
Formulario de Pre-confirmación
Los valores extraídos se presentan en un formulario editable. Revísalos siempre — la IA es precisa pero no infalible con letra ilegible.
📸
Para una lectura óptima: Fotografía cenital (desde arriba, no en diagonal) · Buena iluminación, sin sombras duras · Tarjeta plana, sin dobleces.
Sección 3.5
El Sistema de Recompra
Como jugador, quiero entender qué pasa cuando ya tengo todas mis tarjetas entregadas y subo una nueva.
Slots limitados
La temporada define cuántas tarjetas cuentan para el ranking (numPartidos, p.ej. 10). Una vez llenos los slots, cada nueva tarjeta se evalúa contra las ya entregadas.
Peor que la peor entregada
La tarjeta se sube para hándicap y estadísticas, pero no se entrega. No ocupa ningún slot.
Mejor que la peor entregada
Entra en juego la recompra. El comportamiento depende de la configuración de tu liga.
| Modalidad | Comportamiento |
|---|---|
| Recompra automática | La sustitución es silenciosa: la peor sale, la nueva entra, el ranking se actualiza sin que tengas que hacer nada. |
| Recompra con tokens | Aparece un diálogo: "Tienes una tarjeta mejor. ¿Gastar un token de recompra?". Si aceptas, se consume un token de tu perfil. |
ℹ️
Consulta tus tokens: En tu Perfil, el contador "Recompras disponibles" muestra cuántos te quedan. Slots separados: Si tu liga tiene torneos activos, hay un mínimo de torneos exigido. Una tarjeta de torneo puede desplazar a una pachanga para cumplir la cuota.