chore: add rcon full data roadmap tasks

This commit is contained in:
devRaGonSa
2026-05-19 14:10:31 +02:00
parent a5231ab584
commit 9f14ce0220
13 changed files with 1031 additions and 0 deletions

View File

@@ -0,0 +1,86 @@
---
id: TASK-132
title: Document RCON-first historical architecture
status: pending
type: documentation
team: PM
supporting_teams:
- Backend Senior
- Arquitecto Python
roadmap_item: rcon-full-data
priority: medium
---
# TASK-132 - Document RCON-first historical architecture
## Goal
Document the new RCON-first historical architecture and update AI context so future tasks preserve the intended data-source policy.
## Background
HLL Vietnam is building a historical/live data platform for Comunidad Hispana servers with RCON as the primary source. AdminLog ingestion, parsing, event storage, materialized matches/player stats and optional public-scoreboard enrichment should be documented clearly for future workers.
## Constraints
- Documentation-only task.
- Do not change product behavior.
- Do not modify backend/frontend/Docker code.
- Do not reactivate Elo/MMR.
- Do not reintroduce Comunidad Hispana #03.
- Do not store secrets, runtime DB files or `backend/runtime`.
- Public scoreboard must be described only as optional enrichment/link source or fallback.
## Allowed Changes
- `README.md` or backend README/docs as appropriate
- `docs/decisions.md`
- `ai/repo-context.md`
- `ai/architecture-index.md`
- this task file when moving it through the workflow
## Implementation Requirements
- Work from a dedicated branch for this task.
- Read first:
- `AGENTS.md`
- `ai/architecture-index.md`
- `ai/repo-context.md`
- `ai/orchestrator/pm.md`
- `ai/orchestrator/backend-senior.md`
- `README.md`
- `backend/README.md`
- `docs/decisions.md`
- Document:
- RCON session capture
- AdminLog ingestion
- AdminLog parser
- event storage
- materialized matches/player stats
- public scoreboard only as optional enrichment/link source or fallback
- Elo/MMR paused
- Comunidad Hispana #03 disabled
- Include manual commands:
- `docker compose exec backend python -m app.rcon_admin_log_ingestion --minutes 1440`
- `docker compose exec backend python -m app.rcon_historical_worker capture`
- Keep wording repository-specific and avoid generic platform-template replacement.
## Validation Commands
- `powershell -ExecutionPolicy Bypass -File scripts/run-integration-tests.ps1`
## Manual Verification Steps
- Review docs for no secrets or credentials.
- Confirm docs consistently preserve RCON-first policy.
- Confirm Elo/MMR remains documented as paused.
- Confirm Comunidad Hispana #03 remains documented as disabled from defaults.
- Confirm `git diff --name-only` matches the allowed scope.
## Git Requirements
- Create a dedicated branch for this task, for example `codex/task-132-rcon-architecture-docs`.
- Run relevant validation before committing.
- Stage only intended files.
- Commit the completed implementation.
- Push the branch to origin.