comunidadhll/ai/tasks/done/TASK-055-fix-all-servers-historical-aggregate.md

TASK-055-fix-all-servers-historical-aggregate

Goal

Corregir el agregado histórico all-servers / Totales / Todos para que resumen, tops semanales y partidas recientes reflejen realmente la suma o agregación de los servidores con histórico disponible, en vez de devolver snapshots vacíos.

Context

La situación actual del histórico es esta:

• comunidad-hispana-01 muestra datos correctos
• comunidad-hispana-02 muestra datos correctos
• Totales / Todos aparece vacío
• comunidad-hispana-03 todavía no debe considerarse error, porque no se ha ejecutado bootstrap para ese servidor

Esto indica un fallo específico en la generación o persistencia del agregado lógico all-servers, no un problema general de la capa histórica.

Steps

1. Revisar la implementación actual del agregado lógico all-servers en:
   • snapshots
   • payloads
   • rutas
   • generación/prewarm
2. Verificar cómo se construyen actualmente:
   • resumen global
   • weekly leaderboards globales
   • recent matches globales
3. Corregir la lógica para que all-servers agregue correctamente los servidores con histórico disponible.
4. Asegurar que el agregado:
   • incluya comunidad-hispana-01
   • incluya comunidad-hispana-02
   • no dependa de que comunidad-hispana-03 ya tenga histórico
   • no colapse a vacío si uno de los servidores no tiene datos aún
5. Verificar que los snapshots globales se generen con datos reales y no se sobrescriban con vacíos.
6. Regenerar los snapshots necesarios de all-servers.
7. Validar que en la UI:
   • Totales / Todos deje de mostrar 0 partidas / 0 jugadores
   • los tops globales ya tengan datos
   • recent matches globales ya tengan contenido si existe histórico en #01 y #02
8. Documentar brevemente la semántica final del agregado global.
9. No tratar todavía #03 como parte obligatoria del agregado si no hay bootstrap para ese servidor.
10. Al completar la implementación:
    • dejar el repositorio consistente
    • hacer commit
    • hacer push al remoto si el entorno lo permite

Files to Read First

• AGENTS.md
• backend/README.md
• backend/app/historical_storage.py
• backend/app/historical_snapshots.py
• backend/app/historical_snapshot_storage.py
• backend/app/payloads.py
• backend/app/routes.py
• frontend/assets/js/historico.js
• frontend/historico.html

Expected Files to Modify

• backend/app/historical_storage.py
• backend/app/historical_snapshots.py
• backend/app/historical_snapshot_storage.py
• backend/app/payloads.py
• backend/app/routes.py
• backend/README.md
• opcionalmente frontend/assets/js/historico.js si hace falta ajustar cómo se interpreta el agregado global

Constraints

• No romper #01 ni #02.
• No exigir histórico de #03 para que all-servers funcione.
• No crear páginas nuevas.
• No hacer cambios destructivos.
• Mantener el trabajo centrado en arreglar el agregado global.

Validation

• Totales / Todos deja de estar vacío.
• El resumen global tiene partidas, jugadores y mapas si #01 y #02 tienen histórico.
• Los tops globales funcionan.
• Las partidas recientes globales funcionan.
• Los cambios quedan committeados y se hace push al remoto si el entorno lo permite.

Change Budget

• Preferir menos de 6 archivos modificados o creados.
• Preferir menos de 240 líneas cambiadas.