jjhenao2025 Period Comparison Patterns
Objetivo
Estandarizar comparaciones entre dos periodos para evitar errores de interpretacion, calculo y presentacion.
Entradas minimas
- Periodo actual:
desde_actual,hasta_actual - Periodo comparativo:
desde_comp,hasta_comp - Filtros opcionales: empresa, unidad, centro de costo, segmento, capa, etc.
Salida recomendada por fila
categoriaometricamonto_actualmonto_comparativovariacion_abs=monto_actual - monto_comparativovariacion_pct=(variacion_abs / monto_comparativo) * 100(si comparativo != 0)
Si el comparativo es 0:
variacion_pct = null- Mostrar
N/Aen UI (no inventar 0%).
Regla de calculo
- Validar que ambos rangos sean validos (
desde <= hasta). - Calcular ambos periodos con el mismo set de filtros.
- Normalizar tipos numericos antes de operar (float/decimal).
- Calcular variaciones con formula unica del skill.
- Devolver payload plano y estable para frontend.
Semantica sugerida
- El signo de variacion no implica por si solo bueno/malo.
- Favorable/desfavorable depende del tipo de metrica; delegar esa decision a una capa de semantica.
Checklist rapido
- Ambos periodos usan los mismos filtros
- Manejo de base 0 definido
- Variacion abs y pct calculadas una sola vez
- Payload estable y documentado
- Etiquetas de periodo legibles para UI/export