PADEL SCOUTING
Sistema personal de scouting y coaching de pádel para Fran.
Aplicación web mobile-first, sin backend, sin login, sin instalación.
Cada partido alimenta datos. Los datos alimentan la estrategia del siguiente partido.
JUGAR → REGISTRAR → ACUMULAR → ANALIZAR → PREPARAR → JUGAR
Qué es
Cuatro pantallas y un único objetivo: que registrar un partido cueste menos de 2 minutos desde el
móvil, sentado en el banquillo, y que con el tiempo esos registros se conviertan en decisiones tácticas.
| Pantalla | Para qué |
|---|
| Barra de arriba | Título con la competición debajo (tócala para cambiar), ⚙ Configuración, 🏠 Inicio, ☰ Menú y tu perfil. |
| Este mes | Tu grupo en curso: fechas, comparativa con cada rival, probabilidad de subir o bajar, y el resultado al terminar. |
| La pista | Inicio. Pista azul en perspectiva que es el menú: tocas una zona y la bola vuela hasta ella. Marcador con puesto, forma y balance. |
| Nuestra temporada | Números, escalera animada (5 métricas), mes a mes, acantilado, todos los partidos, rivales y techo. |
| La liga | Clasificación general ordenable, explorador de cualquier pareja y carga de datos. |
| Crónica | Tres actos, Ernesto & Jordi, izquierda y derecha, los dos niveles del club. |
| Mi perfil | Foto, quién eres en la liga, categoría, mixto y qué ver al abrir. |
| Configuración | Competición al abrir, carga de datos de la liga y copia de seguridad. |
| Rival | Eliges la pareja que te toca y salen proyección, historial directo, comparativa y lectura. |
| Registrar | Formulario rápido post-partido. |
| Historial | Tarjeta por partido, con filtros por rival, arquetipo, resultado y fecha. |
| Análisis | Win rate por arquetipo, juego medio de lectura, evolución temporal. |
| Briefing | Eliges el arquetipo esperado → máximo 3 bullets accionables antes de jugar. |
La fuente de verdad funcional es PROJECT_SPEC.md.
El historial de cambios está en CHANGELOG.md.
Cómo ejecutarlo
No hay que instalar ni compilar nada.
Opción 1 — abrir el archivo directamente
Haz doble clic en index.html. Se abre en el navegador y funciona.
Opción 2 — servidor local (recomendado si algo no carga bien)
cd PadelScouting
python3 -m http.server 8000
Luego abre http://localhost:8000 en el navegador.
Opción 3 — en el móvil
Publica la carpeta en GitHub Pages, Netlify o Vercel y añade la URL a la pantalla de inicio del
teléfono. Así se abre como si fuera una app.
⚠️ Los datos viven en el navegador donde registras. Si registras en el móvil y luego abres la web
en el ordenador, no verás los mismos partidos: hay que mover los datos con export/import.
Dónde se guardan los datos
En el localStorage del navegador, bajo la clave padel-scouting.v1. Eso significa:
- Los datos siguen ahí aunque cierres el navegador o apagues el móvil.
- No se sincronizan entre dispositivos.
- Si borras los datos de navegación / caché del sitio, se borran los partidos.
Por eso el backup no es opcional.
Backup y restauración
Exportar (guardar copia):
- Entra en Historial y baja hasta la tarjeta Datos.
- Pulsa Exportar JSON.
- Se descarga un archivo
.json. Guárdalo en Drive, en el correo, donde quieras.
Importar (restaurar o mover a otro dispositivo):
- En esa misma tarjeta, pulsa Importar JSON.
- Elige el archivo
.json.
- La app valida el archivo y pide confirmación antes de reemplazar lo que tengas.
Formato del backup:
{ "version": 1, "exportedAt": "2026-09-22T10:00:00.000Z", "matches": [] }
Recomendación: exportar una vez al mes o después de cada jornada de liga.
Arquitectura
PadelScouting/
├── index.html estructura, navegación, carga de recursos
├── manifest.webmanifest para instalarla como app en el móvil
├── assets/ escudo del club: favicon, iconos de app y logo
├── css/
│ └── styles.css variables, componentes, responsive
├── js/
│ ├── liga-parser.js lee la clasificación de la liga (navegador y Node)
│ ├── liga.js motor: rating, simulación y calibración
│ ├── db.js lectura desde Supabase con caché local
│ ├── views-liga.js pantalla Rival y carga de datos
│ ├── views-temporada.js Nuestra temporada (secciones 01–06)
│ ├── views-general.js La pista (inicio), La liga y Crónica
│ ├── court.js la pista (foto o dibujo), la pelota y los iconos
│ ├── views-estemes.js Este mes: ronda en curso, avisos al abrir, resultados
│ ├── sync.js el registro de scouting sincronizado con la cuenta
│ ├── shell.js barra de arriba, panel ☰, Mi perfil, Configuración, bienvenida
│ ├── data.js catálogos (arquetipos, patrones, funcionó, no funcionó, estados)
│ ├── storage.js leer/guardar/editar/borrar · export · import · validación
│ ├── analysis.js win rate, medias, evolución, muestra insuficiente
│ ├── briefing.js reglas de briefing por arquetipo
│ └── app.js navegación, render, eventos, formularios
├── PROJECT_SPEC.md qué construimos y por qué
├── README.md cómo funciona y cómo trabajar con él
└── CHANGELOG.md qué ha cambiado
Separación de responsabilidades: UI → lógica → datos. Nada de meter toda la app en app.js, y los
catálogos en un solo sitio (data.js) para que no haya dos listas de patrones distintas conviviendo.
Sin frameworks, sin build, sin dependencias: HTML + CSS + JavaScript plano. Es suficiente y evita que
el proyecto se vuelva difícil de mantener.
El motor de proyección
Hereda la estructura del motor predictivo ya validado: fuerzas → distribución → simulación →
derivados → calibración.
- Cada pareja tiene un rating que parte de su grupo de entrada y se mueve partido a partido.
- La diferencia de rating se convierte en probabilidad de ganar un juego, con una escala
ajustada contra los partidos reales de la liga.
- Se simulan 4.000 partidos (sets a 6 con tie-break, super tie-break a 10).
- Todo lo que ves —probabilidad de ganar, reparto 2-0/2-1/1-2/0-2, juegos esperados— sale de
esa misma simulación. Nunca hay dos cálculos en paralelo.
- El acierto se mide contra los partidos ya jugados y se publica en la propia app.
Con los datos del primer semestre el motor acierta quién gana el 61,3% de las veces (moneda
al aire: 50%). Es una ayuda para preparar el partido, no un pronóstico fiable, y la app lo dice.
Un detalle que costó encontrar: en la tabla de la liga, el equipo listado primero gana el 89,4%
de los partidos. Ese orden depende del propio resultado, así que no mide nada. La calibración se
hace en orientación neutra para no engañarse con ese 89%.
Alcance de V1
Formato de partido: al mejor de 3, con dos sets normales y super tie-break a 10 como tercero.
El super tie-break no cuenta como juegos.
Incluye: registro rápido, persistencia local, edición, historial con filtros, análisis por arquetipo
con protección ante muestras pequeñas, briefing de 3 bullets, export/import JSON.
No incluye (decidido explícitamente): backend, login, multiusuario, predicción de resultados, IA
generativa de análisis, tracking punto a punto, estadísticas de cada golpe, ratings avanzados.
Fases futuras
- V2 — análisis por patrón, evolución de patrones, recomendaciones por frecuencia, briefing adaptativo.
- V3 — rating por faceta (saque/resto, red/fondo), modelo de pareja, motor predictivo.
Ninguna de las dos se construye hasta que haya suficientes partidos acumulados para justificarla.
Primero datos, después modelo.
Cómo trabajar en el repo
- Rama principal:
main. Los cambios relevantes van por PR.
- Cada PR actualiza
CHANGELOG.md y la documentación que corresponda.
- Toda revisión termina declarando qué se verificó y qué no.
