/* Real-time Online/Offline Charging System (OerS) for Telecom & ISP environments Copyright (C) ITsysCOM GmbH This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see */ package engine import ( "fmt" "sort" "time" "github.com/ericlagergren/decimal" "github.com/cgrates/cgrates/utils" "github.com/cgrates/cron" ) // RateProfile represents the configuration of a Rate profile type RateProfile struct { Tenant string ID string FilterIDs []string ActivationInterval *utils.ActivationInterval Weight float64 RoundingDecimals int RoundingMethod string MinCost float64 MaxCost float64 MaxCostStrategy string Rates map[string]*Rate minCost *decimal.Big maxCost *decimal.Big } func (rp *RateProfile) TenantID() string { return utils.ConcatenatedKey(rp.Tenant, rp.ID) } func (rp *RateProfile) Compile() (err error) { rp.minCost = new(decimal.Big).SetFloat64(rp.MinCost) rp.maxCost = new(decimal.Big).SetFloat64(rp.MaxCost) for _, rtP := range rp.Rates { rtP.uID = utils.ConcatenatedKey(rp.Tenant, rp.ID, rtP.ID) if err = rtP.Compile(); err != nil { return } } return } // Rate defines rate related information used within a RateProfile type Rate struct { ID string // RateID FilterIDs []string // RateFilterIDs ActivationTimes string // ActivationTimes is a cron formatted time interval Weight float64 // RateWeight will decide the winner per interval start Blocker bool // RateBlocker will make this rate recurrent, deactivating further intervals IntervalRates []*IntervalRate sched cron.Schedule // compiled version of activation times as cron.Schedule interface uID string } // UID returns system wide unique identifier func (rt *Rate) UID() string { return rt.uID } type IntervalRate struct { IntervalStart time.Duration // Starting point when the Rate kicks in FixedFee float64 RecurrentFee float64 Unit time.Duration // RateUnit Increment time.Duration // RateIncrement decFixedFee *decimal.Big // cached version of the FixedFee converted to Decimal for operations decRecFee *decimal.Big // cached version of the RecurrentFee converted to Decimal for operations decUnit *decimal.Big // cached version of the Unit converted to Decimal for operations decIcrm *decimal.Big // cached version of the Increment converted to Decimal for operations } func (rt *Rate) Compile() (err error) { aTime := rt.ActivationTimes if aTime == utils.EmptyString { aTime = "* * * * *" } if rt.sched, err = cron.ParseStandard(aTime); err != nil { return } for _, iRt := range rt.IntervalRates { iRt.decFixedFee = new(decimal.Big).SetFloat64(iRt.FixedFee) iRt.decRecFee = new(decimal.Big).SetFloat64(iRt.RecurrentFee) iRt.decUnit = new(decimal.Big).SetUint64(uint64(iRt.Unit)) iRt.decIcrm = new(decimal.Big).SetUint64(uint64(iRt.Increment)) } return } // RunTimes returns the set of activation and deactivation times for this rate on the interval between >=sTime and , sTime: <%+v>, eTime: <%+v>", rt, sTime, eTime)) return nil, utils.ErrMaxIterationsReached } // DecimalRecurrentFee exports the decRecFee variable func (rIt *IntervalRate) DecimalRecurrentFee() *decimal.Big { return rIt.decRecFee } // DecimalFixedFee exports the decFixedFee variable func (rIt *IntervalRate) DecimalFixedFee() *decimal.Big { return rIt.decFixedFee } // DecimalUnit exports the decUnit variable func (rIt *IntervalRate) DecimalUnit() *decimal.Big { return rIt.decUnit } // DecimalIncrement exports the decUnit variable func (rIt *IntervalRate) DecimalIncrement() *decimal.Big { return rIt.decIcrm } // RateProfileWithOpts is used in replicatorV1 for dispatcher type RateProfileWithOpts struct { *RateProfile Opts map[string]interface{} } // RateSInterval is used by RateS to integrate Rate info for one charging interval type RateSInterval struct { UsageStart time.Duration Increments []*RateSIncrement CompressFactor int64 cost *decimal.Big // unexported total interval cost } type RateSIncrement struct { UsageStart time.Duration Rate *Rate IntervalRateIndex int CompressFactor int64 Usage time.Duration cost *decimal.Big // unexported total increment cost } // RateProfileCost is the cost returned by RateS at cost queries type RateProfileCost struct { ID string // RateProfileID Cost float64 RoundingDecimals int RoundingMethod string MinCost float64 MaxCost float64 MaxCostStrategy string RateSIntervals []*RateSInterval Altered []string } // CorrectCost should be called in final phase of cost calculation // in order to apply further correction like Min/MaxCost or rounding func (rPc *RateProfileCost) CorrectCost(rndDec *int, rndMtd string) { if rndDec != nil { rPc.RoundingDecimals = *rndDec if rndMtd != utils.EmptyString { rPc.RoundingMethod = rndMtd } } if rPc.MinCost != 0 && rPc.Cost < rPc.MinCost { rPc.Cost = rPc.MinCost rPc.Altered = append(rPc.Altered, utils.MinCost) } if rPc.MaxCost != 0 && rPc.Cost > rPc.MaxCost { rPc.Cost = rPc.MaxCost rPc.Altered = append(rPc.Altered, utils.MaxCost) } if rPc.RoundingDecimals != 0 { rPc.Cost = utils.Round(rPc.Cost, rPc.RoundingDecimals, rPc.RoundingMethod) rPc.Altered = append(rPc.Altered, utils.RoundingDecimals) } } // Sort will sort the IntervalRates from each Rate based on IntervalStart func (rpp *RateProfile) Sort() { for _, rate := range rpp.Rates { sort.Slice(rate.IntervalRates, func(i, j int) bool { return rate.IntervalRates[i].IntervalStart < rate.IntervalRates[j].IntervalStart }) } } // CompressEquals compares two RateSIntervals for Compress function func (rIv *RateSInterval) CompressEquals(rIv2 *RateSInterval) (eq bool) { if len(rIv.Increments) != len(rIv2.Increments) { return } for i, rIcr := range rIv.Increments { if !rIcr.CompressEquals(rIv2.Increments[i]) { return } } return true } func (rIv *RateSInterval) Cost() *decimal.Big { if rIv.cost == nil { rIv.cost = new(decimal.Big) for _, incrm := range rIv.Increments { rIv.cost = utils.AddBig(rIv.cost, incrm.Cost()) } } return rIv.cost } // CompressEquals compares two RateSIncrement for Compress function func (rIcr *RateSIncrement) CompressEquals(rIcr2 *RateSIncrement) (eq bool) { if rIcr.Rate.UID() != rIcr2.Rate.UID() { return } if rIcr.IntervalRateIndex != rIcr2.IntervalRateIndex { return } if rIcr.Usage != rIcr2.Usage { return } return true } // Cost computes the Cost on RateSIncrement func (rIcr *RateSIncrement) Cost() *decimal.Big { if rIcr.cost == nil { icrRt := rIcr.Rate.IntervalRates[rIcr.IntervalRateIndex] if rIcr.Usage == utils.InvalidDuration { // FixedFee rIcr.cost = icrRt.DecimalFixedFee() } else { rIcr.cost = icrRt.DecimalRecurrentFee() if icrRt.Unit != icrRt.Increment { rIcr.cost = utils.DivideBig( utils.MultiplyBig(rIcr.cost, icrRt.DecimalIncrement()), icrRt.DecimalUnit()) } if rIcr.CompressFactor != 1 { rIcr.cost = utils.MultiplyBig( rIcr.cost, new(decimal.Big).SetUint64(uint64(rIcr.CompressFactor))) } } } return rIcr.cost } // CostForIntervals sums the costs for all intervals func CostForIntervals(rtIvls []*RateSInterval) (cost *decimal.Big) { cost = new(decimal.Big) for _, rtIvl := range rtIvls { cost = utils.AddBig(cost, rtIvl.Cost()) } return } // CompressIntervals will compress intervals which equal func CompressIntervals(rtIvls []*RateSInterval) { }