Skip to content

Firefly III: a personal finances manager

6.9 KB
Raw Blame
<?php

/*
 * AvailableBudgetCalculator.php
 * Copyright (c) 2026 [email protected]
 *
 * This file is part of Firefly III (https://github.com/firefly-iii).
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero 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 Affero General Public License for more details.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */

declare(strict_types=1);

namespace FireflyIII\Support\Models;

use Carbon\Carbon;
use FireflyIII\Models\TransactionCurrency;
use FireflyIII\Repositories\Budget\AvailableBudgetRepositoryInterface;
use FireflyIII\Repositories\Budget\BudgetLimitRepositoryInterface;
use FireflyIII\Support\Facades\Navigation;
use FireflyIII\Support\Facades\Preferences;
use FireflyIII\User;
use Illuminate\Support\Facades\Log;
use Spatie\Period\Boundaries;
use Spatie\Period\Period;
use Spatie\Period\Precision;

class AvailableBudgetCalculator
{
    private User $user;
    private bool $create = true;
    private Carbon $start;
    private Carbon $end;
    private string $viewRange;
    private TransactionCurrency $currency;

    private AvailableBudgetRepositoryInterface $abRepository;
    private BudgetLimitRepositoryInterface $blRepository;

    public function __construct()
    {
        Log::debug('Created new AvailableBudgetCalculator');
    }

    public function recalculateByRange(): void
    {
        Log::debug(sprintf('Now in recalculateByRange(%s, %s)', $this->start->format('Y-m-d'), $this->start->format('Y-m-d')));
        // based on the view range of the user (month week quarter etc) the budget limit could
        // either overlap multiple available budget periods or be contained in a single one.
        // all have to be created or updated.
        $start       = Navigation::startOfPeriod($this->start, $this->viewRange);
        $end         = Navigation::startOfPeriod($this->end, $this->viewRange);
        $end         = Navigation::endOfPeriod($end, $this->viewRange);

        if ($end < $start) {
            [$start, $end] = [$end, $start];
        }
        Log::debug(sprintf('Corrected start to %s and end to %s.', $start->format('Y-m-d'), $end->format('Y-m-d')));

        // limit period in total is:
        $limitPeriod = Period::make($start, $end, precision: Precision::DAY(), boundaries: Boundaries::EXCLUDE_NONE());
        Log::debug(sprintf('Limit period is from %s to %s', $start->format('Y-m-d'), $end->format('Y-m-d')));

        // from the start until the end of the budget limit, need to loop!
        $count       = 0;
        $max         = 14_600; // 40 years in days.
        $current     = clone $start;
        while ($current <= $end) {
            if ($count > $max) {
                Log::error(sprintf('Count %d is greater than max %d, stop.', $count, $max));

                return;
            }
            ++$count;
            $this->refreshAvailableBudget($current);
            $current = Navigation::addPeriod($current, $this->viewRange);
        }
    }

    public function setCreate(bool $create): void
    {
        $this->create = $create;
    }

    public function setCurrency(TransactionCurrency $currency): void
    {
        $this->currency = $currency;
    }

    public function setEnd(Carbon $end): void
    {
        $this->end = $end;
    }

    public function setStart(Carbon $start): void
    {
        $this->start = $start;
    }

    public function setUser(User $user): void
    {
        $this->user         = $user;
        $this->abRepository = app(AvailableBudgetRepositoryInterface::class);
        $this->blRepository = app(BudgetLimitRepositoryInterface::class);
        $this->abRepository->setUser($this->user);
        $this->blRepository->setUser($this->user);

        $viewRange          = Preferences::getForUser($this->user, 'viewRange', '1M')->data;
        $viewRange          = !is_string($viewRange) ? '1M' : $viewRange;
        $this->viewRange    = $this->correctViewRange($viewRange);
        $this->abRepository->cleanup();
    }

    private function correctViewRange(string $viewRange): string
    {
        $week    = ['last7']; // 'last7'
        if (in_array($viewRange, $week, true)) {
            Log::debug(sprintf('Overrule %s to 1W', $viewRange));

            return '1W';
        }
        $month   = ['MTD', 'custom', 'last30'];
        if (in_array($viewRange, $month, true)) {
            Log::debug(sprintf('Overrule %s to 1M', $viewRange));

            return '1M';
        }
        $quarter = ['QTD', 'last90'];
        if (in_array($viewRange, $quarter, true)) {
            Log::debug(sprintf('Overrule %s to 3M', $viewRange));

            return '3M';
        }
        $year    = ['YTD', 'last365'];
        if (in_array($viewRange, $year, true)) {
            Log::debug(sprintf('Overrule %s to 1Y', $viewRange));

            return '1Y';
        }

        return $viewRange;
    }

    private function refreshAvailableBudget(Carbon $start): void
    {
        $end              = Navigation::endOfPeriod($start, $this->viewRange);
        Log::debug(sprintf('refreshAvailableBudget(%s), end is %s', $start->format('Y-m-d'), $end->format('Y-m-d')));

        if ($end->lt($start)) {
            Log::error(sprintf('%s is less than %s, stop.', $start->format('Y-m-d'), $end->format('Y-m-d')));

            return;
        }

        $availableBudget  = $this->abRepository->find($this->currency, $start, $end);
        $availableBudgets = $this->abRepository->findInRange($this->currency, $start, $end);

        foreach ($availableBudgets as $item) {
            Log::debug(sprintf(
                'findInRange found available budget #%d (%s - %s), will update it.',
                $item->id,
                $item->start_date->format('Y-m-d'),
                $item->end_date->format('Y-m-d')
            ));
            $this->abRepository->recalculateAmount($item);
        }
        if (!$this->create) {
            Log::debug('Can stop here. have not been asked to create an available budget.');

            return;
        }
        if (null === $availableBudget) {
            Log::debug(sprintf('Will create new available budget for period %s to %s', $start->format('Y-m-d'), $end->format('Y-m-d')));
            $availableBudget = $this->abRepository->store([
                'start'       => $start,
                'end'         => $end,
                'currency_id' => $this->currency->id,
                'amount'      => '1',
            ]);
            $this->abRepository->recalculateAmount($availableBudget);
        }
    }
}