Complete historical coverage and UI review tasks

docs/historical-coverage-report.md

@@ -0,0 +1,89 @@
+# Historical Coverage Report
+
+## Validation Date
+
+- 2026-03-20
+
+## Scope
+
+Estado real de la cobertura historica persistida localmente en
+`backend/data/hll_vietnam_dev.sqlite3` tras ejecutar el bootstrap CRCON con el
+flujo reforzado de `backend/app/historical_ingestion.py`.
+
+## Commands Used
+
+Desde `backend/`:
+
+```powershell
+python -m app.historical_ingestion bootstrap --max-pages 3 --detail-workers 16
+```
+
+Verificacion puntual previa de idempotencia sobre la primera pagina ya
+importada:
+
+```powershell
+python -m app.historical_ingestion bootstrap --max-pages 1 --detail-workers 8
+```
+
+Esa reejecucion devolvio `matches_inserted: 0` y solo `matches_updated` para
+los matches ya persistidos, confirmando el comportamiento idempotente en el
+tramo reimportado.
+
+## Source Depth Discovered
+
+La propia API CRCON reporto en pagina 1:
+
+- `comunidad-hispana-01`: `23029` matches historicos disponibles
+- `comunidad-hispana-02`: `18221` matches historicos disponibles
+
+Esto confirma que la fuente publica tiene un archivo mucho mas profundo que la
+semana movil usada por la UI y que un bootstrap completo real es una operacion
+larga incluso con paralelismo.
+
+## Persisted Coverage After Bootstrap Validation
+
+### comunidad-hispana-01
+
+- matches importados: `150`
+- jugadores unicos: `3986`
+- filas de estadisticas por jugador: `12650`
+- primera partida persistida: `2026-03-04T22:11:18Z`
+- ultima partida persistida: `2026-03-20T21:41:18Z`
+- rango cubierto: `15.98` dias
+
+### comunidad-hispana-02
+
+- matches importados: `150`
+- jugadores unicos: `4468`
+- filas de estadisticas por jugador: `12665`
+- primera partida persistida: `2026-03-01T16:59:10Z`
+- ultima partida persistida: `2026-03-20T21:14:21Z`
+- rango cubierto: `19.18` dias
+
+## Interpretation
+
+- La base persistida ya supera claramente la ventana semanal en ambos
+  servidores, por lo que la UI historica ya puede distinguir entre "ranking de
+  ultimos 7 dias" y "cobertura total importada" sin fingir que ambos conceptos
+  son lo mismo.
+- El historico local sigue siendo parcial respecto al total reportado por la
+  fuente. Lo importado hoy es suficiente para seguir con semantica y revisiones
+  de UI, pero no representa aun el archivo completo disponible en CRCON.
+
+## Source Limits Observed
+
+- Bajo replays repetidos del mismo bootstrap, la fuente CRCON devolvio errores
+  `502 Bad Gateway` intermitentes en `get_public_info` y `get_map_scoreboard`.
+- Con `--detail-workers 16` la carga validada fue estable para `3` paginas por
+  servidor. Con concurrencia mas alta se observaron payloads no validos con mas
+  frecuencia.
+
+## Operational Conclusion
+
+- El bootstrap ya es reanudable mediante `--start-page`.
+- La estrategia operativa razonable para completar todo el archivo es ejecutar
+  varias sesiones consecutivas, registrando la ultima pagina completada y
+  continuando desde ahi si el origen falla o si la sesion debe cortarse.
+- Mientras no se complete todo el archivo, cualquier UI o API debe mostrar la
+  cobertura importada como cobertura real disponible y no como historico total
+  del servidor.