comunidadhll/ai/tasks/done/TASK-018-current-hll-data-ingestion-plan.md

TASK-018-current-hll-data-ingestion-plan

Goal

Definir la estrategia técnica de ingesta de datos para Hell Let Loose actual, usándolo como banco de pruebas del proyecto HLL Vietnam, con foco en servidores, snapshots e históricos básicos sin implementar todavía la ingesta real completa.

Context

La landing ya muestra servidores actuales de HLL como contenido provisional y el backend ya dispone de una base API placeholder. El siguiente paso lógico es fijar cómo se obtendrán y normalizarán datos reales o semirrealistas de HLL actual para validar la arquitectura que más adelante podrá reutilizarse con HLL Vietnam.

Steps

1. Revisar la documentación actual del proyecto relacionada con servidores, backend y evolución de datos.
2. Definir qué tipos de datos se quieren ingerir inicialmente desde HLL actual. Incluir al menos:
   • listado de servidores
   • estado online/offline
   • jugadores actuales
   • capacidad máxima
   • mapa actual si está disponible
   • timestamp de captura
3. Definir el concepto de snapshot de servidor y cómo se usará para construir histórico.
4. Documentar las posibles fuentes técnicas de ingesta para HLL actual, distinguiendo entre:
   • datos controlados/mock
   • fuente externa pública
   • consulta directa de servidor o capa intermedia
5. Documentar riesgos y límites:
   • disponibilidad de terceros
   • cambios de formato
   • rate limits
   • latencia
   • CORS
   • fiabilidad de datos
   • dependencia de scraping o APIs no oficiales
6. Proponer la arquitectura de ingesta por fases:
   • fase 1: payload controlado y estructura estable
   • fase 2: colector de snapshots con fuente real o casi real
   • fase 3: explotación histórica y estadísticas básicas
7. Dejar claro qué no se implementará todavía.
8. Actualizar la documentación técnica del repositorio para servir de base a las siguientes tasks de base de datos y colector.

Files to Read First

• README.md
• AGENTS.md
• docs/project-overview.md
• docs/roadmap.md
• docs/decisions.md
• docs/discord-and-server-data-plan.md
• docs/current-hll-servers-source-plan.md
• docs/frontend-backend-contract.md
• ai/repo-context.md
• ai/architecture-index.md
• backend/README.md

Expected Files to Modify

• docs/roadmap.md
• docs/decisions.md
• ai/architecture-index.md
• opcionalmente un nuevo documento técnico si encaja mejor, por ejemplo:
  • docs/current-hll-data-ingestion-plan.md

Constraints

• No implementar todavía ingesta real.
• No modificar comportamiento visible del frontend.
• No añadir base de datos funcional en esta task.
• No añadir dependencias nuevas.
• No hacer cambios destructivos.
• Mantener el resultado centrado en planificación técnica reutilizable para futuro HLL Vietnam.

Validation

• Existe una estrategia documentada de ingesta para HLL actual como banco de pruebas.
• Quedan definidos snapshots, fuentes posibles, riesgos y fases.
• La documentación deja claro cómo se conectará este trabajo con almacenamiento e históricos.
• La base sirve para una siguiente task de esquema de base de datos.

Change Budget

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