RCON model

ai/tasks/done/TASK-090-rcon-historical-provider-minimal-read-model.md

@@ -0,0 +1,65 @@
+# TASK-090-rcon-historical-provider-minimal-read-model
+
+## Goal
+Construir una primera capa de lectura historica minima sobre la persistencia prospectiva RCON, sin intentar aun paridad completa con todos los rankings competitivos del historico actual.
+
+## Context
+Esta task depende de la task anterior.
+
+Una vez exista captura prospectiva RCON, hace falta una primera capa de lectura util que permita comprobar cobertura real y exponer algo operativo sin mentir sobre la profundidad disponible.
+
+La prioridad aqui no es clonar toda la salida de `public-scoreboard`, sino exponer:
+- cobertura
+- actividad reciente
+- estado del historico RCON disponible
+- una base compatible para evolucion posterior
+
+## Steps
+1. Implementar una primera version funcional de `RconHistoricalDataSource` basada en datos persistidos, no en consultas RCON on-demand dentro del request path.
+2. Definir un read model minimo util para:
+   - resumen/cobertura por servidor
+   - actividad o sesiones recientes
+   - metadata de disponibilidad y frescura
+3. Exponer un camino de seleccion seguro por `HLL_BACKEND_HISTORICAL_DATA_SOURCE=rcon` sin romper el modo `public-scoreboard`.
+4. Mantener la degradacion controlada cuando falten metricas:
+   - devolver payload coherente
+   - documentar que contratos quedan soportados y cuales no todavia
+5. Actualizar README y runbook para aclarar:
+   - que endpoints funcionan con la lectura RCON minima
+   - que endpoints siguen dependiendo de `public-scoreboard`
+6. No intentar aun:
+   - weekly/monthly leaderboards completos
+   - MVP V1/V2 completos
+   - equivalencia total con `historico.html`
+
+## Files to Read First
+- `docs/rcon-historical-ingestion-design.md`
+- `backend/README.md`
+- `backend/app/data_sources.py`
+- `backend/app/payloads.py`
+- `backend/app/routes.py`
+- los archivos creados en la task anterior para captura prospectiva RCON
+
+## Expected Files to Modify
+- `backend/app/data_sources.py`
+- `backend/app/payloads.py`
+- `backend/app/routes.py`
+- uno o varios archivos nuevos bajo `backend/app/` para read model RCON historico
+- `backend/README.md`
+
+## Constraints
+- No sustituir aun el historico actual completo.
+- No tocar frontend.
+- No exponer contratos falsos o semicompletos como si fueran paridad total.
+- La lectura HTTP debe seguir siendo fast-path de solo lectura sobre persistencia local.
+- Si un endpoint no queda soportado por la capa minima, debe quedar documentado y degradar de forma clara.
+
+## Validation
+- `HLL_BACKEND_HISTORICAL_DATA_SOURCE=rcon` deja una lectura historica minima operativa y documentada.
+- El backend no rompe el modo `public-scoreboard`.
+- La documentacion deja claro el alcance real de esta primera capa de lectura.
+- El repositorio queda consistente.
+
+## Change Budget
+- Preferir menos de 7 archivos modificados o creados.
+- Preferir menos de 320 lineas cambiadas.