rgonsal/comunidadhll
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add historical UI and backend API slice

Browse Source
This commit is contained in:
devRaGonSa
2026-03-20 22:39:17 +01:00
parent f346084c5f
commit 502d11d8b3
19 changed files with 1862 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

72
ai/tasks/done/TASK-034-historical-refresh-automation-and-ops.md Normal file
View File

@@ -0,0 +1,72 @@
# TASK-034-historical-refresh-automation-and-ops
## Goal
Automatizar y documentar el refresco periódico del histórico CRCON para ambos servidores de la comunidad, dejando el sistema preparado para mantenerse actualizado sin intervención manual constante.
## Context
Ya existe ingesta bootstrap, refresco incremental y validación de calidad histórica. El siguiente paso técnico es estabilizar la operativa del histórico con un flujo repetible y documentado que permita mantener actualizados los datos históricos de forma consistente.
## Steps
1. Revisar la ingesta histórica actual y el refresco incremental ya implementado.
2. Diseñar la estrategia operativa de refresco histórico:
- frecuencia recomendada
- modo de ejecución local
- modo de ejecución automatizada
- control de errores y reintentos básicos
3. Implementar un mecanismo razonable para lanzar el refresco histórico periódicamente o dejarlo listo para ello.
4. Registrar metadatos mínimos de operación:
- último refresco ejecutado
- resultado
- errores básicos si ocurren
5. Documentar claramente cómo ejecutar y mantener esta capa histórica.
6. No crear todavía dashboards de operaciones complejos.
7. No romper el flujo actual de live status.
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
- docs/historical-domain-model.md
- docs/historical-data-quality-notes.md
## Expected Files to Modify
- backend/README.md
- backend/app/config.py
- backend/app/historical_ingestion.py
- opcionalmente nuevos módulos/entrypoints si mejoran la automatización, por ejemplo:
- backend/app/historical_jobs.py
- backend/app/historical_runner.py
- opcionalmente documentación técnica adicional
## Constraints
- No crear UI histórica en esta task.
- No romper la ingesta actual.
- No introducir complejidad operativa excesiva.
- No hacer cambios destructivos.
- Mantener el trabajo centrado en automatización y operativa del histórico.
## Validation
- Existe una estrategia clara y ejecutable de refresco periódico histórico.
- La documentación explica cómo ejecutar el refresco.
- La capa histórica queda operativamente más estable.
- Los cambios quedan committeados y se hace push al remoto si el entorno lo permite.
## Change Budget
- Preferir menos de 5 archivos modificados o creados.
- Preferir menos de 220 líneas cambiadas.
## Outcome
- Se añadió `backend/app/historical_runner.py` para ejecutar refresh incremental periódico.
- Se incorporaron variables de configuración para intervalo, reintentos y espera entre reintentos.
- La operativa queda documentada en `backend/README.md`.
- El registro operativo sigue apoyándose en `historical_ingestion_runs` para dejar último refresh, resultado y errores básicos.
## Validation Notes
- `python -m compileall app`
- validación estática del runner y de los getters de configuración
- no se ejecutó refresh real contra red externa por las restricciones del entorno actual