comunidadhll/ai/tasks/done/TASK-082-monthly-mvp-v2-scoring-design-adjustment.md

TASK-082-monthly-mvp-v2-scoring-design-adjustment

Goal

Diseñar o ajustar de forma precisa la fórmula del MVP mensual V2 incorporando las nuevas métricas derivadas de eventos de jugador ya disponibles.

Context

La V1 del MVP mensual ya existe y se apoya en métricas persistidas básicas. Con la nueva capa V2 de eventos y agregados, ya se pueden plantear señales más ricas como:

• kills por arma
• teamkills derivados
• duelos y rivalidades
• most_killed / death_by
• posible ponderación por tipo de kill si la señal es suficientemente fiable

Antes de implementar el backend del MVP V2, hace falta cerrar la fórmula concreta y sus pesos.

Steps

1. Revisar el diseño de scoring V1 y la nueva disponibilidad de métricas V2.
2. Decidir qué métricas avanzadas entran realmente en la V2.
3. Diseñar una fórmula concreta para el MVP mensual V2, incluyendo:
   • pesos
   • elegibilidad
   • penalizaciones
   • tratamiento de muestras pequeñas
   • desempates
4. Decidir si:
   • las kills deben ponderarse por arma/tipo
   • cómo influye teamkill
   • cómo influye duelo/rivalidad
   • qué parte de la V1 se mantiene
5. Mantener la fórmula defendible y explicable, evitando complejidad artificial si la señal aún no es robusta.
6. Dejar clara la compatibilidad o convivencia entre:
   • MVP V1
   • MVP V2
7. No implementar todavía la UI.
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
• docs/monthly-mvp-ranking-scoring-design.md
• docs/player-event-pipeline-v2-design.md
• docs/monthly-player-ranking-data-audit.md
• backend/README.md
• backend/app/player_event_aggregates.py
• cualquier snapshot/API V2 disponible tras la task previa

Expected Files to Modify

• docs/monthly-mvp-v2-scoring-design.md
• opcionalmente docs/decisions.md
• opcionalmente ai/architecture-index.md

Constraints

• No implementar todavía el cálculo backend del MVP V2.
• No tocar producto visible.
• No depender de métricas no confirmadas.
• No hacer cambios destructivos.
• Mantener el trabajo centrado en diseño de scoring V2.

Validation

• Existe un documento claro con la fórmula V2 propuesta.
• Quedan definidos pesos, elegibilidad, penalizaciones y desempates.
• Queda claro qué señales entran realmente en V2.
• Los cambios quedan committeados y se hace push si el entorno lo permite.

Change Budget

• Preferir menos de 4 archivos modificados o creados.
• Preferir menos de 220 líneas cambiadas.