Descargar jugadas (CSV) en Ejes y Recursos — Segunda (resto de ligas pendiente)

- Nueva tabla per-secuencia vendor/data/plays/<liga>/<temp>/plays.parquet: partido,
local/visitante, equipo/rival, fecha, resultado final del partido, min:seg inicio/fin,
cantidad de pases, si tuvo tiro, xG acumulado, tipo de jugada (origen → desenlace, ej
"Corner → Gol"), bloque y flags de recurso. Se arma con scripts/build_plays_table.py.
- Endpoints /api/plays/ejes (todas las secuencias del equipo) y /api/plays/recursos
(filtra por lado/recurso/bloques) que devuelven CSV. plays_data.py + routes_plays.py.
- Botones "Descargar jugadas (CSV)" en Ejes (sección 4) y Recursos (sección 5). El 6 no
lleva (es a nivel partido). Por ahora solo Segunda tiene datos.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

src/racing_reports/api/routes_plays.py

@@ -0,0 +1,44 @@
+"""Endpoints de descarga de jugadas (CSV) para Ejes y Recursos."""
+
+from __future__ import annotations
+
+from fastapi import APIRouter, Depends, HTTPException
+from fastapi.responses import Response
+
+from racing_reports import plays_data
+from racing_reports.api.deps import require_auth
+
+router = APIRouter(prefix="/api/plays")
+
+
+def _csv_response(text: str, filename: str) -> Response:
+    return Response(content=text, media_type="text/csv; charset=utf-8",
+                    headers={"Content-Disposition": f'attachment; filename="{filename}"'})
+
+
+def _slug(s: str) -> str:
+    return "".join(c if c.isalnum() else "_" for c in s).strip("_")
+
+
+@router.get("/available", dependencies=[Depends(require_auth)])
+def available(league: str, season: str) -> dict:
+    return {"available": plays_data.available(league, season)}
+
+
+@router.get("/ejes", dependencies=[Depends(require_auth)])
+def ejes(league: str, season: str, team: str) -> Response:
+    try:
+        csv = plays_data.ejes_csv(league, season, team)
+    except FileNotFoundError as exc:
+        raise HTTPException(status_code=404, detail=str(exc))
+    return _csv_response(csv, f"jugadas_{_slug(team)}_{_slug(season)}.csv")
+
+
+@router.get("/recursos", dependencies=[Depends(require_auth)])
+def recursos(league: str, season: str, team: str, lado: str = "of",
+             recurso: str = "todos", bloques: str | None = None) -> Response:
+    try:
+        csv = plays_data.recursos_csv(league, season, team, lado, recurso, bloques)
+    except FileNotFoundError as exc:
+        raise HTTPException(status_code=404, detail=str(exc))
+    return _csv_response(csv, f"jugadas_{_slug(team)}_{recurso}_{_slug(season)}.csv")

src/racing_reports/plays_data.py

@@ -0,0 +1,67 @@
+"""Descarga de "jugadas" (secuencias) en CSV para los gráficos de Ejes y Recursos.
+
+Lee ``vendor/data/plays/<slug>/<season>/plays.parquet`` (1 fila por secuencia con partido,
+local/visitante, resultado, tiempos, pases, tiro, xG acumulado, tipo de jugada, bloque y
+flags de recurso). Filtra por equipo (y por recurso/bloque en Recursos) y arma el CSV.
+"""
+from __future__ import annotations
+
+import io
+from functools import lru_cache
+
+import pandas as pd
+
+from racing_reports import vendor_env
+
+# columnas visibles del CSV (orden y nombres para el usuario)
+CSV_COLS = ["matchId", "local", "visitante", "equipo", "rival", "fecha", "resultado_final",
+            "min_inicio", "seg_inicio", "min_fin", "seg_fin", "n_pases", "tiro",
+            "xg_acumulado", "tipo_jugada"]
+RENAME = {"matchId": "partido"}
+
+
+def _slug(text: str) -> str:
+    return "".join(c.lower() if c.isalnum() else "-" for c in text).strip("-")
+
+
+@lru_cache(maxsize=8)
+def _df(league: str, season: str) -> pd.DataFrame:
+    p = vendor_env.DATA_DIR / "plays" / _slug(league) / str(season) / "plays.parquet"
+    if not p.exists():
+        raise FileNotFoundError(f"Sin jugadas para {league} {season}")
+    return pd.read_parquet(p)
+
+
+def available(league: str, season: str) -> bool:
+    p = vendor_env.DATA_DIR / "plays" / _slug(league) / str(season) / "plays.parquet"
+    return p.exists()
+
+
+def _to_csv(df: pd.DataFrame) -> str:
+    out = df[CSV_COLS].rename(columns=RENAME)
+    buf = io.StringIO()
+    out.to_csv(buf, index=False)
+    return buf.getvalue()
+
+
+def ejes_csv(league: str, season: str, team: str) -> str:
+    """Todas las secuencias de ataque del equipo (para el gráfico de Ejes)."""
+    df = _df(league, season)
+    df = df[df["equipo"].astype(str) == team].sort_values(["fecha", "matchId", "min_inicio"])
+    return _to_csv(df)
+
+
+def recursos_csv(league: str, season: str, team: str, lado: str = "of",
+                 recurso: str = "todos", bloques: str | None = None) -> str:
+    """Secuencias del recurso/bloque elegidos. lado 'of' = ataques del equipo;
+    'def' = lo que concede (ataques del rival contra el equipo)."""
+    df = _df(league, season)
+    key = "equipo" if lado != "def" else "rival"
+    df = df[df[key].astype(str) == team]
+    sel = [b.strip() for b in (bloques or "").split(",") if b.strip() in ("bajo", "medio", "alto")]
+    if sel:
+        df = df[df["bloque"].isin(sel)]
+    col = f"rec_{recurso}"
+    if col in df.columns:
+        df = df[df[col] == 1]
+    return _to_csv(df.sort_values(["fecha", "matchId", "min_inicio"]))

src/racing_reports/web/app.py

@@ -27,6 +27,7 @@ try:  # feature en desarrollo (archivos pueden no estar en el deploy)
 except Exception:  # noqa: BLE001
     api_goalkicks_router = None
 from racing_reports.api.routes_lowblock import router as api_lowblock_router
+from racing_reports.api.routes_plays import router as api_plays_router
 from racing_reports.config import DEFAULT_SETTINGS
 from racing_reports.datastore import DataStore
 from racing_reports.match_index import MatchIndex
@@ -57,6 +58,7 @@ app.include_router(api_ejes_router)
 if api_goalkicks_router is not None:
     app.include_router(api_goalkicks_router)
 app.include_router(api_lowblock_router)
+app.include_router(api_plays_router)
 
 # Estado en memoria (single container en HF Space). Re-export para retrocompat.
 Job = jobs_mod.Job

src/racing_reports/web/templates/home.html

@@ -673,6 +673,17 @@
           <svg id="ejsvg" width="100%" height="440" viewBox="0 0 980 440"></svg>
           <div id="ejtip" style="position:absolute;display:none;pointer-events:none;background:#1f2937;border:1px solid #4b5563;border-radius:8px;padding:6px 10px;font-size:12px;max-width:230px;z-index:10"></div>
         </div>
+        <div class="flex flex-wrap items-end gap-2 mt-3 pt-3 border-t border-ink-600">
+          <div>
+            <label class="block text-xs text-gray-400 mb-1">Descargar jugadas del equipo</label>
+            <select x-model="plEjTeam" class="bg-ink-800 border border-ink-600 rounded-lg px-3 py-2 text-sm">
+              <template x-for="t in ((ejData&&ejData.teams)||[]).map(x=>x.equipo).sort()" :key="'plej'+t"><option :value="t" x-text="t"></option></template>
+            </select>
+          </div>
+          <button @click="plDownload('/api/plays/ejes?league='+encodeURIComponent(ejLeague)+'&season='+encodeURIComponent(ejSeason)+'&team='+encodeURIComponent(plEjTeam))"
+                  class="bg-racing-500 hover:bg-racing-600 text-racing-900 font-semibold px-4 py-2 rounded-lg text-sm">↓ Descargar jugadas (CSV)</button>
+          <span class="text-xs text-gray-500" x-text="plMsg"></span>
+        </div>
       </section>
 
       <!-- ---- Recursos bloque bajo ---- -->
@@ -812,6 +823,18 @@
             </div>
             <button @click="lbtRun()" class="bg-racing-500 hover:bg-racing-600 text-racing-900 font-semibold px-4 py-2 rounded-lg text-sm">Generar tablas</button>
           </div>
+          <div class="flex flex-wrap items-end gap-2 mb-3">
+            <span class="text-xs text-gray-400 self-center">Descargar jugadas:</span>
+            <select x-model="plLado" class="bg-ink-800 border border-ink-600 rounded-lg px-2 py-1.5 text-sm">
+              <option value="of">Ofensivo</option><option value="def">Defensivo (concede)</option>
+            </select>
+            <select x-model="plRecurso" class="bg-ink-800 border border-ink-600 rounded-lg px-2 py-1.5 text-sm">
+              <template x-for="(lbl,k) in lbRecursos" :key="'plr'+k"><option :value="k" x-text="lbl"></option></template>
+            </select>
+            <button @click="plDownload('/api/plays/recursos?league='+encodeURIComponent(lbtLeague)+'&season='+encodeURIComponent(lbtSeason)+'&team='+encodeURIComponent(lbtEquipo)+'&lado='+plLado+'&recurso='+plRecurso+'&bloques='+encodeURIComponent(lbBloqSel.join(',')))"
+                    class="bg-ink-600 hover:bg-ink-500 text-gray-100 font-semibold px-3 py-1.5 rounded-lg text-sm border border-ink-500">↓ CSV</button>
+            <span class="text-xs text-gray-500" x-text="plMsg"></span>
+          </div>
           <p class="text-xs text-red-300" x-show="lbtError" x-text="lbtError"></p>
           <p class="text-xs text-gray-500 mb-2" x-show="lbtResult">Peligro/jugada = pvAdded medio por intento (‰): un valor negativo significa que en promedio esos intentos PIERDEN valor de posesión (el costo de los fallos supera lo que generan los aciertos). Evento clave = nº de ataques en los que ese recurso fue la acción que MÁS peligro agregó. Entre paréntesis: diferencia vs la media de esa liga-temporada (métricas por jugada ponderadas por intentos; conteos con media simple). En la tabla defensiva los colores se invierten: conceder más que la liga es rojo. 'Todos los recursos' = unión de los recursos de construcción (sin tiro de fuera del área): cada acción cuenta una sola vez aunque cumpla varios recursos, y los goles/tiros son de jugadas con al menos un recurso — por eso NO coincide con la suma de las filas (que doble-cuentan jugadas con recursos combinados). Rompe-líneas no muestra % éxito (el proveedor solo marca los completados). El tiro desde fuera del área no muestra pv ni evento clave: el tiro REALIZA el peligro en vez de agregarlo (el gol tiene pvAdded nulo y el errado negativo) — usar % éxito (= % gol), xG y goles.</p>
           <template x-for="lado in ['of','def']" :key="lado">
@@ -1185,6 +1208,8 @@
       ejAll: [], ejAllKeys: [], ejPool: [], ejPoolLigaIn:'', ejPoolTeamIn:'', ejEscala:'liga',
       ejBub: '',
       mlLeagues: [], ejPartidos: {},
+      // Descargar jugadas (CSV)
+      plEjTeam:'Racing de Santander', plLado:'of', plRecurso:'todos', plMsg:'',
       // Variables (scatter libre)
       vsLoaded:false, vsLeagueList:[], vsSeasons:{}, vsLeague:'__all__', vsSeason:'__all__',
       vsColLabel:{}, vsTypeCols:{}, vsTypeList:[], vsNeg:{},
@@ -1517,6 +1542,18 @@
           await this.$nextTick(); this.lbDraw();
         } catch(e){ this.lbError = 'Error: '+e; }
       },
+      async plDownload(url){
+        this.plMsg='Generando…';
+        try{
+          const r=await fetch(url);
+          if(!r.ok){ const d=await r.json().catch(()=>({detail:r.statusText})); this.plMsg='No disponible: '+(d.detail||r.statusText); return; }
+          const blob=await r.blob();
+          const cd=r.headers.get('Content-Disposition')||'';
+          const fn=(cd.match(/filename="?([^"]+)"?/)||[])[1]||'jugadas.csv';
+          const a=document.createElement('a'); a.href=URL.createObjectURL(blob); a.download=fn; document.body.appendChild(a); a.click(); a.remove(); URL.revokeObjectURL(a.href);
+          this.plMsg='';
+        }catch(e){ this.plMsg='Error: '+e; }
+      },
       _catLeagues(name){ return this.catMap[name] || null; },  // array de ligas si es categoría, si no null
       _addPoolLigas(inp, avail, pool){
         const cats=this._catLeagues(inp);