73 lines
3.2 KiB
Markdown
73 lines
3.2 KiB
Markdown
# TASK-028-real-a2s-target-onboarding
|
|
|
|
## Goal
|
|
Dar de alta el primer target A2S real verificado del proyecto, correspondiente a Comunidad Hispana #01, integrandolo en la configuracion del backend de forma clara, mantenible y documentada.
|
|
|
|
## Context
|
|
El backend ya dispone de cliente A2S, registro configurable de targets y colector integrado con persistencia. Ademas, ya se ha identificado un target real consultable por A2S:
|
|
- Comunidad Hispana #01
|
|
- Host/IP: 152.114.195.174
|
|
- Query Port: 7778
|
|
- Game Port: 7777
|
|
|
|
El objetivo de esta task es incorporar ese target real a la configuracion del proyecto sin asumir otros servidores aun no verificados.
|
|
|
|
## Steps
|
|
1. Revisar la configuracion actual de targets A2S del backend.
|
|
2. Anadir el target real verificado de Comunidad Hispana #01 usando:
|
|
- nombre amigable claro
|
|
- host/IP: `152.114.195.174`
|
|
- query port: `7778`
|
|
- etiqueta o contexto de fuente coherente con el proyecto
|
|
3. Asegurar que la configuracion no dependa de valores hardcodeados dispersos fuera del registro o capa configurada.
|
|
4. Mantener separada la nocion de query port y game port para evitar confusiones.
|
|
5. Reflejar en la documentacion del backend como esta registrado este primer target real.
|
|
6. Dejar claro en documentacion que Comunidad Hispana #02 no debe anadirse aun sin confirmar su query port real.
|
|
7. Mantener el cambio pequeno y estrictamente centrado en onboarding de target.
|
|
|
|
## Files to Read First
|
|
- AGENTS.md
|
|
- ai/repo-context.md
|
|
- ai/architecture-index.md
|
|
- backend/README.md
|
|
- backend/app/config.py
|
|
- backend/app/server_targets.py
|
|
- backend/app/collector.py
|
|
- backend/app/a2s_client.py
|
|
|
|
## Expected Files to Modify
|
|
- backend/README.md
|
|
- backend/app/config.py
|
|
- backend/app/server_targets.py
|
|
- opcionalmente backend/app/collector.py si necesita alineacion menor para consumir el target de forma limpia
|
|
|
|
## Constraints
|
|
- No tocar frontend.
|
|
- No introducir nuevos targets no verificados.
|
|
- No asumir datos de Comunidad Hispana #02.
|
|
- No anadir scraping.
|
|
- No hacer cambios destructivos.
|
|
- Mantener la configuracion simple y clara.
|
|
|
|
## Validation
|
|
- El backend contiene el target real de Comunidad Hispana #01 correctamente registrado.
|
|
- El query port configurado es `7778`.
|
|
- La documentacion deja claro como esta definido este target.
|
|
- No se han introducido targets inciertos o ambiguos.
|
|
|
|
## Change Budget
|
|
- Preferir menos de 4 archivos modificados.
|
|
- Preferir menos de 140 lineas cambiadas.
|
|
|
|
## Outcome
|
|
- `backend/app/server_targets.py` registra por defecto solo `Comunidad Hispana #01` con `host` real, `query_port` verificado y `game_port` separado como dato opcional de referencia.
|
|
- `backend/app/config.py` centraliza el `source_name` por defecto para evitar valores dispersos en el registro A2S.
|
|
- `backend/README.md` documenta el target real incorporado y deja explicito que Comunidad Hispana #02 no debe anadirse hasta confirmar su `query_port`.
|
|
|
|
## Validation Result
|
|
- Ejecutado desde `backend/`: `python -` importando `load_a2s_targets()`.
|
|
- Resultado: el registro carga `Comunidad Hispana #01` con `host=152.114.195.174`, `query_port=7778`, `game_port=7777` y `source_name=community-hispana-a2s`.
|
|
|
|
## Decision Notes
|
|
- Se mantiene `game_port` fuera de la logica de consulta A2S y solo como metadato opcional del target para evitar confundirlo con `query_port`.
|