70 lines
2.5 KiB
Markdown
70 lines
2.5 KiB
Markdown
# 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.
|