comunidadhll/ai/tasks/done/TASK-028-real-a2s-target-onboarding.md

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.