Skip to content

Firefly III: a personal finances manager

12.0 KB
Raw Blame
<?php

/**
 * BudgetLimitController.php
 * Copyright (c) 2019 [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\Http\Controllers\Budget;

use Carbon\Carbon;
use FireflyIII\Exceptions\FireflyException;
use FireflyIII\Http\Controllers\Controller;
use FireflyIII\Models\Budget;
use FireflyIII\Models\BudgetLimit;
use FireflyIII\Models\TransactionCurrency;
use FireflyIII\Repositories\Budget\BudgetLimitRepositoryInterface;
use FireflyIII\Repositories\Budget\BudgetRepositoryInterface;
use FireflyIII\Repositories\Budget\OperationsRepositoryInterface;
use FireflyIII\Repositories\Currency\CurrencyRepositoryInterface;
use FireflyIII\Support\Facades\Amount;
use FireflyIII\Support\Facades\Preferences;
use FireflyIII\Support\Facades\Steam;
use FireflyIII\Support\Http\Controllers\DateCalculation;
use Illuminate\Contracts\View\Factory;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Collection;
use Illuminate\Support\Facades\Log;
use Illuminate\View\View;
use Spatie\Period\Boundaries;
use Spatie\Period\Period;
use Spatie\Period\Precision;

/**
 * Class BudgetLimitController
 */
final class BudgetLimitController extends Controller
{
    use DateCalculation;

    private BudgetLimitRepositoryInterface $blRepository;
    private CurrencyRepositoryInterface $currencyRepos;
    private OperationsRepositoryInterface $opsRepository;
    private BudgetRepositoryInterface $repository;

    /**
     * AmountController constructor.
     */
    public function __construct()
    {
        parent::__construct();
        $this->middleware(function ($request, $next) {
            app('view')->share('title', (string) trans('firefly.budgets'));
            app('view')->share('mainTitleIcon', 'bi-pie-chart');
            $this->repository    = app(BudgetRepositoryInterface::class);
            $this->opsRepository = app(OperationsRepositoryInterface::class);
            $this->blRepository  = app(BudgetLimitRepositoryInterface::class);
            $this->currencyRepos = app(CurrencyRepositoryInterface::class);

            return $next($request);
        });
    }

    /**
     * @return Factory|View
     */
    public function create(Budget $budget, Carbon $start, Carbon $end): Factory|\Illuminate\Contracts\View\View
    {
        $collection   = $this->currencyRepos->get();
        $budgetLimits = $this->blRepository->getBudgetLimits($budget, $start, $end);

        // remove already budgeted currencies with the same date range
        $currencies   = $collection->filter(static function (TransactionCurrency $currency) use ($budgetLimits, $start, $end): bool {
            /** @var BudgetLimit $limit */
            foreach ($budgetLimits as $limit) {
                if ($limit->transaction_currency_id === $currency->id && $limit->start_date->isSameDay($start) && $limit->end_date->isSameDay($end)) {
                    return false;
                }
            }

            return true;
        });

        return view('budgets.budget-limits.create', ['start' => $start, 'end' => $end, 'currencies' => $currencies, 'budget' => $budget]);
    }

    public function delete(BudgetLimit $budgetLimit): RedirectResponse
    {
        $this->blRepository->destroyBudgetLimit($budgetLimit);
        session()->flash('success', trans('firefly.deleted_bl'));

        return redirect(route('budgets.index'));
    }

    /**
     * @return Factory|View
     */
    public function edit(BudgetLimit $budgetLimit): Factory|\Illuminate\Contracts\View\View
    {
        $notes = $this->blRepository->getNoteText($budgetLimit);

        return view('budgets.budget-limits.edit', ['budgetLimit' => $budgetLimit, 'notes' => $notes]);
    }

    /**
     * @return Factory|View
     */
    public function show(BudgetLimit $budgetLimit): Factory|\Illuminate\Contracts\View\View
    {
        $notes = $this->blRepository->getNoteText($budgetLimit);

        return view('budgets.budget-limits.show', ['budgetLimit' => $budgetLimit, 'notes' => $notes]);
    }

    /**
     * TODO why redirect AND json response?
     *
     * @throws FireflyException
     */
    public function store(Request $request): JsonResponse|RedirectResponse
    {
        Log::debug('Going to store new budget-limit.');
        // first search for existing one and update it if necessary.
        $currency = $this->currencyRepos->find((int) $request->input('transaction_currency_id'));
        $budget   = $this->repository->find((int) $request->input('budget_id'));
        if (!$currency instanceof TransactionCurrency || !$budget instanceof Budget) {
            throw new FireflyException('No valid currency or budget.');
        }
        $start    = Carbon::createFromFormat('Y-m-d', $request->input('start'));
        $end      = Carbon::createFromFormat('Y-m-d', $request->input('end'));

        if (!$start instanceof Carbon || !$end instanceof Carbon) {
            return response()->json();
        }

        $amount   = (string) $request->input('amount');
        $start->startOfDay();
        $end->startOfDay();

        if ('' === $amount) {
            return response()->json();
        }

        Log::debug(sprintf('Start: %s, end: %s', $start->format('Y-m-d'), $end->format('Y-m-d')));

        $limit    = $this->blRepository->find($budget, $currency, $start, $end);

        // sanity check on amount:
        if (0 === bccomp($amount, '0')) {
            if ($limit instanceof BudgetLimit) {
                $this->blRepository->destroyBudgetLimit($limit);
            }

            // return empty array:
            return response()->json([]);
        }
        if ((int) $amount > 2_147_483_647) { // intentional cast to integer
            $amount = '2147483647';
        }
        if (-1 === bccomp($amount, '0')) {
            $amount = bcmul($amount, '-1');
        }

        if ($limit instanceof BudgetLimit) {
            $this->blRepository->update($limit, ['amount' => $amount]);
        }
        if (!$limit instanceof BudgetLimit) {
            $limit = $this->blRepository->store([
                'budget_id'   => $request->input('budget_id'),
                'currency_id' => (int) $request->input('transaction_currency_id'),
                'start_date'  => $start,
                'end_date'    => $end,
                'amount'      => $amount,
            ]);
        }
        // parse notes, if any.
        $notes    = (string) $request->input('notes');
        $this->blRepository->setNoteText($limit, $notes);

        if ($request->expectsJson()) {
            $array                           = $limit->toArray();
            // add some extra metadata:
            $spentArr                        = $this->opsRepository->sumExpenses(
                $limit->start_date,
                $limit->end_date,
                null,
                new Collection()->push($budget),
                $currency
            );
            $array['spent']                  = $spentArr[$currency->id]['sum'] ?? '0';
            $array['left_formatted']         = Amount::formatAnything($limit->transactionCurrency, bcadd($array['spent'], (string) $array['amount']));
            $array['amount_formatted']       = Amount::formatAnything($limit->transactionCurrency, $limit['amount']);
            $array['days_left']              = (string) $this->activeDaysLeft($start, $end);
            // left per day:
            $array['left_per_day']           = 0 === bccomp('0', $array['days_left'])
                ? bcadd((string) $array['spent'], (string) $array['amount'])
                : bcdiv(bcadd((string) $array['spent'], (string) $array['amount']), $array['days_left']);

            // left per day formatted.
            $array['left_per_day_formatted'] = Amount::formatAnything($limit->transactionCurrency, $array['left_per_day']);

            // notes:
            $array['notes']                  = $this->blRepository->getNoteText($limit);

            return response()->json($array);
        }

        return redirect(route('budgets.index'));
    }

    public function update(Request $request, BudgetLimit $budgetLimit): JsonResponse|RedirectResponse
    {
        $amount                          = (string) $request->input('amount');
        if ('' === $amount) {
            $amount = '0';
        }
        if ((int) $amount > 2_147_483_647) { // 268 million, intentional integer
            $amount = '2147483647';
        }
        // sanity check on amount:
        if (0 === bccomp($amount, '0')) {
            $budgetId = $budgetLimit->budget_id;
            $currency = $budgetLimit->transactionCurrency;
            $this->blRepository->destroyBudgetLimit($budgetLimit);
            $array    = [
                'budget_id'               => $budgetId,
                'left_formatted'          => Amount::formatAnything($currency, '0'),
                'left_per_day_formatted'  => Amount::formatAnything($currency, '0'),
                'transaction_currency_id' => $currency->id,
            ];

            return response()->json($array);
        }

        if (-1 === bccomp($amount, '0')) {
            $amount = bcmul($amount, '-1');
        }
        $update                          = ['amount' => $amount];
        if ($request->has('notes')) {
            $notes           = (string) $request->input('notes');
            if (strlen($notes) > 32_768) {
                $notes = substr($notes, 0, 32_768);
            }
            $update['notes'] = $notes;
        }
        $limit                           = $this->blRepository->update($budgetLimit, $update);
        Preferences::mark();
        $array                           = $limit->toArray();

        $spentArr                        = $this->opsRepository->sumExpenses(
            $limit->start_date,
            $limit->end_date,
            null,
            new Collection()->push($budgetLimit->budget),
            $budgetLimit->transactionCurrency
        );
        $daysLeft                        = $this->activeDaysLeft($limit->start_date, $limit->end_date);

        $limitPeriod                     = Period::make($limit->start_date, $limit->end_date, precision: Precision::DAY(), boundaries: Boundaries::EXCLUDE_NONE());
        $inPast                          = $limitPeriod->startsBefore(now()) && $limitPeriod->endsBefore(now());

        // create aray.
        $array['spent']                  = $spentArr[$budgetLimit->transactionCurrency->id]['sum'] ?? '0';
        $array['left_formatted']         = Amount::formatAnything($limit->transactionCurrency, bcadd($array['spent'], (string) $array['amount']));
        $array['amount_formatted']       = Amount::formatAnything($limit->transactionCurrency, $limit['amount']);
        $array['days_left']              = (string) $daysLeft;
        $array['in_past']                = $inPast;
        $array['left_per_day']           = 0 === $daysLeft
            ? bcadd((string) $array['spent'], (string) $array['amount'])
            : bcdiv(bcadd((string) $array['spent'], (string) $array['amount']), $array['days_left']);

        // left per day formatted.
        $array['amount']                 = Steam::bcround($limit['amount'], $limit->transactionCurrency->decimal_places);
        $array['left_per_day_formatted'] = Amount::formatAnything($limit->transactionCurrency, $array['left_per_day']);
        if ('true' === $request->input('redirect')) {
            return redirect(route('budgets.index'));
        }

        return response()->json($array);
    }
}