h+ SrSSKrSSKJrJrJrJr S\RS\\ \44Sjr S S\RS\RS \ S\\ \\ 44S jjr g) u Módulo para realizar cálculos y agregaciones sobre los datos de ventas. Contiene funciones para KPIs, análisis de tendencias y otras métricas de negocio. N)DictAnyTupleOptionaldfreturncUR(aSSSSSS.$[USR55nUSR5n[ U5nUR S5SR5nUR(d[UR 55OSnUSR5nUSUS-R5nUS:aXv- OSnUUUUUS.$)u Calcula un conjunto de KPIs principales a partir de un DataFrame de ventas. Args: df (pd.DataFrame): DataFrame filtrado para el análisis. Returns: Dict[str, Any]: Un diccionario con los KPIs calculados. r) ingreso_total total_folios total_itemsticket_promedio pct_descuentoingresofolioimporte_total_productodescuento_porcentaje)emptyfloatsumnuniquelengroupbymean) rr r r ingresos_por_folior bruto_total desc_totalrs bC:\Users\julio\OneDrive\Documentos\Trabajo\Ideas Frescas\Proyectos\Cabanna\modules\calculations.pycalculate_main_kpisr s xx !A"S  "Y-++-.Mg;&&(Lb'KG,Y7;;=>P>V>Ve.3356\_O-.224K-.4J1KKPPRJ2=/Z-sM'$"*&   df_current df_historicalfreqcH^UR(agSU4SjjnU"U5nUR(ag[UR55nU"U5n[U5[U5:aUS4$URR 5[ R"SS9- nURSUR[U55nUR(aUS4$[UR55n U S:aXY- U - OSn XZ4$![[4a US4s$f=f)u Calcula el ingreso promedio para un período y su variación vs. el período anterior. Args: df_current (pd.DataFrame): Datos del período actual seleccionado. df_historical (pd.DataFrame): Datos históricos completos de la sucursal. freq (str): Frecuencia de agrupación ('M' para mes, 'W' para semana, 'D' para día). Returns: Tuple[float, Optional[float]]: Una tupla con el ingreso promedio actual y el delta porcentual vs. el período previo. )r Nc>UR[R"X55RT5UR 5$)N) set_indexpd to_datetimeresampler)rdate_col value_colr#s rgroup_by_period0calculate_trend_metrics..group_by_periodEs6||BNN2<89BB4HSWWYYr N)daysr) fecha_ticketr) rrrrindexminr' Timedeltaloctail IndexErrorKeyError) r!r"r#r,s_curravg_currs_histend_prev_period prev_periodsavg_prevdeltas ` rcalculate_trend_metricsr?0s "ZZ (F ||V[[]#H] +F 6{S[ $  ,,**,r||/CCzz"2?388VE ~\&&()H081 X H ,$E ?  !~s4AD D! D!)M) __doc__pandasr'typingrrrr DataFramestrrrr?r rrGsy --#BLL#T#s(^#P1 1<<1 1 5(5/ !" 1r