Process historical snapshot tasks 047-051

ai/tasks/done/TASK-048-add-server-03-historical-source-and-ingestion.md

@@ -0,0 +1,79 @@
+# TASK-048-add-server-03-historical-source-and-ingestion
+
+## Goal
+Añadir el tercer servidor histórico de la comunidad (`https://scoreboard.comunidadhll.es:3443/`) a la capa histórica del proyecto, dejándolo preparado para ingesta, snapshots y consumo posterior por la UI propia.
+
+## Context
+Ahora mismo el proyecto trabaja con dos servidores históricos de comunidad, pero existe un tercer servidor real:
+- `https://scoreboard.comunidadhll.es:3443/`
+
+El sistema debe poder tratarlo como una tercera fuente histórica formal, no como un caso manual o externo, manteniendo la misma arquitectura de ingestión, persistencia y snapshots propia del proyecto.
+
+## Steps
+1. Revisar cómo están definidos hoy los servidores históricos actuales.
+2. Añadir la configuración y el mapeo del tercer servidor con una identidad estable, por ejemplo:
+   - `comunidad-hispana-03`
+3. Asegurar que la capa de ingestión histórica puede consultar la fuente CRCON JSON del puerto `3443`.
+4. Preparar la persistencia histórica para ese servidor:
+   - matches
+   - players
+   - stats por match
+   - checkpoints/backfill
+5. Integrar el tercer servidor en la capa de snapshots:
+   - resumen
+   - rankings semanales
+   - partidas recientes
+6. Ajustar documentación y configuración operativa para reflejar que ya existen tres servidores históricos.
+7. No exponer todavía UI nueva si no es imprescindible en esta task.
+8. 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/config.py
+- backend/app/historical_ingestion.py
+- backend/app/historical_storage.py
+- backend/app/historical_snapshot_storage.py
+- backend/app/historical_snapshots.py
+- backend/app/payloads.py
+- backend/app/routes.py
+- docs/historical-crcon-source-discovery.md
+- docs/historical-domain-model.md
+
+## Expected Files to Modify
+- backend/app/config.py
+- backend/app/historical_ingestion.py
+- backend/app/historical_storage.py
+- backend/app/historical_snapshot_storage.py
+- backend/app/historical_snapshots.py
+- backend/app/payloads.py
+- backend/app/routes.py
+- backend/README.md
+- opcionalmente documentación técnica adicional
+
+## Constraints
+- No usar A2S para el histórico del servidor #03.
+- No crear páginas externas o dependientes de la comunidad.
+- No romper los servidores #01 y #02.
+- No hacer cambios destructivos.
+- Mantener el trabajo centrado en registrar correctamente el servidor #03 en la plataforma histórica.
+
+## Validation
+- El servidor #03 queda definido con identidad estable en backend.
+- La ingesta histórica puede trabajar con su fuente.
+- La capa de snapshots queda preparada para ese servidor.
+- La documentación backend refleja el nuevo servidor.
+- Los cambios quedan committeados y se hace push si el entorno lo permite.
+
+## Change Budget
+- Preferir menos de 7 archivos modificados o creados.
+- Preferir menos de 260 líneas cambiadas.
+
+## Outcome
+- Se añadió `comunidad-hispana-03` como tercera fuente histórica estable en el seed declarativo de `historical_servers`, con `scoreboard_base_url` `https://scoreboard.comunidadhll.es:3443` y `server_number` `3`.
+- La validación local de `list_historical_servers()` confirma que el backend ya registra `3` servidores históricos.
+- La validación local de `build_historical_server_snapshots(server_key='comunidad-hispana-03')` devuelve el lote esperado de `6` snapshots, dejando preparada la capa para ingesta, persistencia y consumo posterior aunque la UI aún no se haya ampliado en esta task.
+- Se actualizó la documentación backend y de dominio para reflejar la nueva fuente histórica.