mirror of
				https://github.com/firefly-iii/firefly-iii.git
				synced 2025-10-31 18:54:58 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			483 lines
		
	
	
		
			19 KiB
		
	
	
	
		
			PHP
		
	
	
	
	
	
			
		
		
	
	
			483 lines
		
	
	
		
			19 KiB
		
	
	
	
		
			PHP
		
	
	
	
	
	
| <?php
 | |
| /**
 | |
|  * CategoryController.php
 | |
|  * Copyright (c) 2017 thegrumpydictator@gmail.com
 | |
|  *
 | |
|  * This file is part of Firefly III.
 | |
|  *
 | |
|  * Firefly III 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.
 | |
|  *
 | |
|  * Firefly III 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 Firefly III. If not, see <http://www.gnu.org/licenses/>.
 | |
|  */
 | |
| declare(strict_types=1);
 | |
| 
 | |
| namespace FireflyIII\Http\Controllers;
 | |
| 
 | |
| use Carbon\Carbon;
 | |
| use FireflyIII\Helpers\Collector\JournalCollectorInterface;
 | |
| use FireflyIII\Helpers\Filter\InternalTransferFilter;
 | |
| use FireflyIII\Http\Requests\CategoryFormRequest;
 | |
| use FireflyIII\Models\AccountType;
 | |
| use FireflyIII\Models\Category;
 | |
| use FireflyIII\Models\TransactionType;
 | |
| use FireflyIII\Repositories\Account\AccountRepositoryInterface;
 | |
| use FireflyIII\Repositories\Category\CategoryRepositoryInterface;
 | |
| use FireflyIII\Repositories\Journal\JournalRepositoryInterface;
 | |
| use FireflyIII\Support\CacheProperties;
 | |
| use Illuminate\Http\Request;
 | |
| use Illuminate\Pagination\LengthAwarePaginator;
 | |
| use Illuminate\Support\Collection;
 | |
| use Log;
 | |
| use Preferences;
 | |
| use Steam;
 | |
| use View;
 | |
| 
 | |
| /**
 | |
|  * Class CategoryController.
 | |
|  */
 | |
| class CategoryController extends Controller
 | |
| {
 | |
|     /**
 | |
|      *
 | |
|      */
 | |
|     public function __construct()
 | |
|     {
 | |
|         parent::__construct();
 | |
| 
 | |
|         $this->middleware(
 | |
|             function ($request, $next) {
 | |
|                 app('view')->share('title', trans('firefly.categories'));
 | |
|                 app('view')->share('mainTitleIcon', 'fa-bar-chart');
 | |
| 
 | |
|                 return $next($request);
 | |
|             }
 | |
|         );
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @param Request $request
 | |
|      *
 | |
|      * @return View
 | |
|      */
 | |
|     public function create(Request $request)
 | |
|     {
 | |
|         if (true !== session('categories.create.fromStore')) {
 | |
|             $this->rememberPreviousUri('categories.create.uri');
 | |
|         }
 | |
|         $request->session()->forget('categories.create.fromStore');
 | |
|         $subTitle = trans('firefly.create_new_category');
 | |
| 
 | |
|         return view('categories.create', compact('subTitle'));
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @param Category $category
 | |
|      *
 | |
|      * @return View
 | |
|      */
 | |
|     public function delete(Category $category)
 | |
|     {
 | |
|         $subTitle = trans('firefly.delete_category', ['name' => $category->name]);
 | |
| 
 | |
|         // put previous url in session
 | |
|         $this->rememberPreviousUri('categories.delete.uri');
 | |
| 
 | |
|         return view('categories.delete', compact('category', 'subTitle'));
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @param Request                     $request
 | |
|      * @param CategoryRepositoryInterface $repository
 | |
|      * @param Category                    $category
 | |
|      *
 | |
|      * @return \Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
 | |
|      */
 | |
|     public function destroy(Request $request, CategoryRepositoryInterface $repository, Category $category)
 | |
|     {
 | |
|         $name = $category->name;
 | |
|         $repository->destroy($category);
 | |
| 
 | |
|         $request->session()->flash('success', strval(trans('firefly.deleted_category', ['name' => $name])));
 | |
|         Preferences::mark();
 | |
| 
 | |
|         return redirect($this->getPreviousUri('categories.delete.uri'));
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @param Request  $request
 | |
|      * @param Category $category
 | |
|      *
 | |
|      * @return View
 | |
|      */
 | |
|     public function edit(Request $request, Category $category)
 | |
|     {
 | |
|         $subTitle = trans('firefly.edit_category', ['name' => $category->name]);
 | |
| 
 | |
|         // put previous url in session if not redirect from store (not "return_to_edit").
 | |
|         if (true !== session('categories.edit.fromUpdate')) {
 | |
|             $this->rememberPreviousUri('categories.edit.uri');
 | |
|         }
 | |
|         $request->session()->forget('categories.edit.fromUpdate');
 | |
| 
 | |
|         return view('categories.edit', compact('category', 'subTitle'));
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @param CategoryRepositoryInterface $repository
 | |
|      *
 | |
|      * @return View
 | |
|      */
 | |
|     public function index(Request $request, CategoryRepositoryInterface $repository)
 | |
|     {
 | |
|         $page       = 0 === intval($request->get('page')) ? 1 : intval($request->get('page'));
 | |
|         $pageSize   = intval(Preferences::get('listPageSize', 50)->data);
 | |
|         $collection = $repository->getCategories();
 | |
|         $total      = $collection->count();
 | |
|         $collection = $collection->slice(($page - 1) * $pageSize, $pageSize);
 | |
| 
 | |
|         $collection->each(
 | |
|             function (Category $category) use ($repository) {
 | |
|                 $category->lastActivity = $repository->lastUseDate($category, new Collection);
 | |
|             }
 | |
|         );
 | |
| 
 | |
|         // paginate categories
 | |
|         $categories = new LengthAwarePaginator($collection, $total, $pageSize, $page);
 | |
|         $categories->setPath(route('categories.index'));
 | |
| 
 | |
|         return view('categories.index', compact('categories'));
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @param Request                    $request
 | |
|      * @param JournalRepositoryInterface $repository
 | |
|      * @param string                     $moment
 | |
|      *
 | |
|      * @return View
 | |
|      */
 | |
|     public function noCategory(Request $request, JournalRepositoryInterface $repository, string $moment = '')
 | |
|     {
 | |
|         // default values:
 | |
|         $range    = Preferences::get('viewRange', '1M')->data;
 | |
|         $start    = null;
 | |
|         $end      = null;
 | |
|         $periods  = new Collection;
 | |
|         $page     = intval($request->get('page'));
 | |
|         $pageSize = intval(Preferences::get('listPageSize', 50)->data);
 | |
| 
 | |
|         // prep for "all" view.
 | |
|         if ('all' === $moment) {
 | |
|             $subTitle = trans('firefly.all_journals_without_category');
 | |
|             $first    = $repository->first();
 | |
|             $start    = $first->date ?? new Carbon;
 | |
|             $end      = new Carbon;
 | |
|         }
 | |
| 
 | |
|         // prep for "specific date" view.
 | |
|         if (strlen($moment) > 0 && 'all' !== $moment) {
 | |
|             $start    = new Carbon($moment);
 | |
|             $end      = app('navigation')->endOfPeriod($start, $range);
 | |
|             $subTitle = trans(
 | |
|                 'firefly.without_category_between',
 | |
|                 ['start' => $start->formatLocalized($this->monthAndDayFormat), 'end' => $end->formatLocalized($this->monthAndDayFormat)]
 | |
|             );
 | |
|             $periods  = $this->getNoCategoryPeriodOverview();
 | |
|         }
 | |
| 
 | |
|         // prep for current period
 | |
|         if (0 === strlen($moment)) {
 | |
|             $start    = clone session('start', app('navigation')->startOfPeriod(new Carbon, $range));
 | |
|             $end      = clone session('end', app('navigation')->endOfPeriod(new Carbon, $range));
 | |
|             $periods  = $this->getNoCategoryPeriodOverview();
 | |
|             $subTitle = trans(
 | |
|                 'firefly.without_category_between',
 | |
|                 ['start' => $start->formatLocalized($this->monthAndDayFormat), 'end' => $end->formatLocalized($this->monthAndDayFormat)]
 | |
|             );
 | |
|         }
 | |
| 
 | |
|         /** @var JournalCollectorInterface $collector */
 | |
|         $collector = app(JournalCollectorInterface::class);
 | |
|         $collector->setAllAssetAccounts()->setRange($start, $end)->setLimit($pageSize)->setPage($page)->withoutCategory()->withOpposingAccount()
 | |
|                   ->setTypes([TransactionType::WITHDRAWAL, TransactionType::DEPOSIT, TransactionType::TRANSFER]);
 | |
|         $collector->removeFilter(InternalTransferFilter::class);
 | |
|         $transactions = $collector->getPaginatedJournals();
 | |
|         $transactions->setPath(route('categories.no-category'));
 | |
| 
 | |
|         return view('categories.no-category', compact('transactions', 'subTitle', 'moment', 'periods', 'start', 'end'));
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @param Request                     $request
 | |
|      * @param CategoryRepositoryInterface $repository
 | |
|      * @param Category                    $category
 | |
|      * @param string                      $moment
 | |
|      *
 | |
|      * @return View
 | |
|      */
 | |
|     public function show(Request $request, CategoryRepositoryInterface $repository, Category $category, string $moment = '')
 | |
|     {
 | |
|         // default values:
 | |
|         $subTitle     = $category->name;
 | |
|         $subTitleIcon = 'fa-bar-chart';
 | |
|         $page         = intval($request->get('page'));
 | |
|         $pageSize     = intval(Preferences::get('listPageSize', 50)->data);
 | |
|         $range        = Preferences::get('viewRange', '1M')->data;
 | |
|         $start        = null;
 | |
|         $end          = null;
 | |
|         $periods      = new Collection;
 | |
|         $path         = route('categories.show', [$category->id]);
 | |
| 
 | |
|         // prep for "all" view.
 | |
|         if ('all' === $moment) {
 | |
|             $subTitle = trans('firefly.all_journals_for_category', ['name' => $category->name]);
 | |
|             $first    = $repository->firstUseDate($category);
 | |
|             /** @var Carbon $start */
 | |
|             $start = null === $first ? new Carbon : $first;
 | |
|             $end   = new Carbon;
 | |
|             $path  = route('categories.show', [$category->id, 'all']);
 | |
|         }
 | |
| 
 | |
|         // prep for "specific date" view.
 | |
|         if (strlen($moment) > 0 && 'all' !== $moment) {
 | |
|             $start    = new Carbon($moment);
 | |
|             $end      = app('navigation')->endOfPeriod($start, $range);
 | |
|             $subTitle = trans(
 | |
|                 'firefly.journals_in_period_for_category',
 | |
|                 ['name'  => $category->name,
 | |
|                  'start' => $start->formatLocalized($this->monthAndDayFormat), 'end' => $end->formatLocalized($this->monthAndDayFormat),]
 | |
|             );
 | |
|             $periods  = $this->getPeriodOverview($category);
 | |
|             $path     = route('categories.show', [$category->id, $moment]);
 | |
|         }
 | |
| 
 | |
|         // prep for current period
 | |
|         if (0 === strlen($moment)) {
 | |
|             /** @var Carbon $start */
 | |
|             $start = clone session('start', app('navigation')->startOfPeriod(new Carbon, $range));
 | |
|             /** @var Carbon $end */
 | |
|             $end      = clone session('end', app('navigation')->endOfPeriod(new Carbon, $range));
 | |
|             $periods  = $this->getPeriodOverview($category);
 | |
|             $subTitle = trans(
 | |
|                 'firefly.journals_in_period_for_category',
 | |
|                 ['name' => $category->name, 'start' => $start->formatLocalized($this->monthAndDayFormat),
 | |
|                  'end'  => $end->formatLocalized($this->monthAndDayFormat),]
 | |
|             );
 | |
|         }
 | |
| 
 | |
|         /** @var JournalCollectorInterface $collector */
 | |
|         $collector = app(JournalCollectorInterface::class);
 | |
|         $collector->setAllAssetAccounts()->setRange($start, $end)->setLimit($pageSize)->setPage($page)->withOpposingAccount()
 | |
|                   ->setCategory($category)->withBudgetInformation()->withCategoryInformation();
 | |
|         $collector->removeFilter(InternalTransferFilter::class);
 | |
|         $transactions = $collector->getPaginatedJournals();
 | |
|         $transactions->setPath($path);
 | |
| 
 | |
|         return view('categories.show', compact('category', 'moment', 'transactions', 'periods', 'subTitle', 'subTitleIcon', 'start', 'end'));
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @param CategoryFormRequest         $request
 | |
|      * @param CategoryRepositoryInterface $repository
 | |
|      *
 | |
|      * @return $this|\Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
 | |
|      */
 | |
|     public function store(CategoryFormRequest $request, CategoryRepositoryInterface $repository)
 | |
|     {
 | |
|         $data     = $request->getCategoryData();
 | |
|         $category = $repository->store($data);
 | |
| 
 | |
|         $request->session()->flash('success', strval(trans('firefly.stored_category', ['name' => $category->name])));
 | |
|         Preferences::mark();
 | |
| 
 | |
|         if (1 === intval($request->get('create_another'))) {
 | |
|             // @codeCoverageIgnoreStart
 | |
|             $request->session()->put('categories.create.fromStore', true);
 | |
| 
 | |
|             return redirect(route('categories.create'))->withInput();
 | |
|             // @codeCoverageIgnoreEnd
 | |
|         }
 | |
| 
 | |
|         return redirect(route('categories.index'));
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @param CategoryFormRequest         $request
 | |
|      * @param CategoryRepositoryInterface $repository
 | |
|      * @param Category                    $category
 | |
|      *
 | |
|      * @return \Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
 | |
|      */
 | |
|     public function update(CategoryFormRequest $request, CategoryRepositoryInterface $repository, Category $category)
 | |
|     {
 | |
|         $data = $request->getCategoryData();
 | |
|         $repository->update($category, $data);
 | |
| 
 | |
|         $request->session()->flash('success', strval(trans('firefly.updated_category', ['name' => $category->name])));
 | |
|         Preferences::mark();
 | |
| 
 | |
|         if (1 === intval($request->get('return_to_edit'))) {
 | |
|             // @codeCoverageIgnoreStart
 | |
|             $request->session()->put('categories.edit.fromUpdate', true);
 | |
| 
 | |
|             return redirect(route('categories.edit', [$category->id]));
 | |
|             // @codeCoverageIgnoreEnd
 | |
|         }
 | |
| 
 | |
|         return redirect($this->getPreviousUri('categories.edit.uri'));
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @return Collection
 | |
|      */
 | |
|     private function getNoCategoryPeriodOverview(): Collection
 | |
|     {
 | |
|         $repository = app(JournalRepositoryInterface::class);
 | |
|         $first      = $repository->first();
 | |
|         $start      = $first->date ?? new Carbon;
 | |
|         $range      = Preferences::get('viewRange', '1M')->data;
 | |
|         $start      = app('navigation')->startOfPeriod($start, $range);
 | |
|         $end        = app('navigation')->endOfX(new Carbon, $range, null);
 | |
|         $entries    = new Collection;
 | |
| 
 | |
|         // properties for cache
 | |
|         $cache = new CacheProperties;
 | |
|         $cache->addProperty($start);
 | |
|         $cache->addProperty($end);
 | |
|         $cache->addProperty('no-budget-period-entries');
 | |
| 
 | |
|         if ($cache->has()) {
 | |
|             return $cache->get(); // @codeCoverageIgnore
 | |
|         }
 | |
| 
 | |
|         Log::debug(sprintf('Going to get period expenses and incomes between %s and %s.', $start->format('Y-m-d'), $end->format('Y-m-d')));
 | |
|         while ($end >= $start) {
 | |
|             Log::debug('Loop!');
 | |
|             $end        = app('navigation')->startOfPeriod($end, $range);
 | |
|             $currentEnd = app('navigation')->endOfPeriod($end, $range);
 | |
| 
 | |
|             // count journals without category in this period:
 | |
|             /** @var JournalCollectorInterface $collector */
 | |
|             $collector = app(JournalCollectorInterface::class);
 | |
|             $collector->setAllAssetAccounts()->setRange($end, $currentEnd)->withoutCategory()
 | |
|                       ->withOpposingAccount()->setTypes([TransactionType::WITHDRAWAL, TransactionType::DEPOSIT, TransactionType::TRANSFER]);
 | |
|             $collector->removeFilter(InternalTransferFilter::class);
 | |
|             $count = $collector->getJournals()->count();
 | |
| 
 | |
|             // amount transferred
 | |
|             /** @var JournalCollectorInterface $collector */
 | |
|             $collector = app(JournalCollectorInterface::class);
 | |
|             $collector->setAllAssetAccounts()->setRange($end, $currentEnd)->withoutCategory()
 | |
|                       ->withOpposingAccount()->setTypes([TransactionType::TRANSFER]);
 | |
|             $collector->removeFilter(InternalTransferFilter::class);
 | |
|             $transferred = Steam::positive($collector->getJournals()->sum('transaction_amount'));
 | |
| 
 | |
|             // amount spent
 | |
|             /** @var JournalCollectorInterface $collector */
 | |
|             $collector = app(JournalCollectorInterface::class);
 | |
|             $collector->setAllAssetAccounts()->setRange($end, $currentEnd)->withoutCategory()->withOpposingAccount()->setTypes([TransactionType::WITHDRAWAL]);
 | |
|             $spent = $collector->getJournals()->sum('transaction_amount');
 | |
| 
 | |
|             // amount earned
 | |
|             /** @var JournalCollectorInterface $collector */
 | |
|             $collector = app(JournalCollectorInterface::class);
 | |
|             $collector->setAllAssetAccounts()->setRange($end, $currentEnd)->withoutCategory()->withOpposingAccount()->setTypes([TransactionType::DEPOSIT]);
 | |
|             $earned = $collector->getJournals()->sum('transaction_amount');
 | |
| 
 | |
|             $dateStr  = $end->format('Y-m-d');
 | |
|             $dateName = app('navigation')->periodShow($end, $range);
 | |
|             $entries->push(
 | |
|                 [
 | |
|                     'string'      => $dateStr,
 | |
|                     'name'        => $dateName,
 | |
|                     'count'       => $count,
 | |
|                     'spent'       => $spent,
 | |
|                     'earned'      => $earned,
 | |
|                     'transferred' => $transferred,
 | |
|                     'date'        => clone $end,
 | |
|                 ]
 | |
|             );
 | |
|             $end = app('navigation')->subtractPeriod($end, $range, 1);
 | |
|         }
 | |
|         Log::debug('End of loops');
 | |
|         $cache->store($entries);
 | |
| 
 | |
|         return $entries;
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * @param Category $category
 | |
|      *
 | |
|      * @return Collection
 | |
|      */
 | |
|     private function getPeriodOverview(Category $category): Collection
 | |
|     {
 | |
|         /** @var CategoryRepositoryInterface $repository */
 | |
|         $repository = app(CategoryRepositoryInterface::class);
 | |
|         /** @var AccountRepositoryInterface $accountRepository */
 | |
|         $accountRepository = app(AccountRepositoryInterface::class);
 | |
|         $accounts          = $accountRepository->getAccountsByType([AccountType::DEFAULT, AccountType::ASSET]);
 | |
|         $first             = $repository->firstUseDate($category);
 | |
|         if (null === $first) {
 | |
|             $first = new Carbon; // @codeCoverageIgnore
 | |
|         }
 | |
|         $range   = Preferences::get('viewRange', '1M')->data;
 | |
|         $first   = app('navigation')->startOfPeriod($first, $range);
 | |
|         $end     = app('navigation')->endOfX(new Carbon, $range, null);
 | |
|         $entries = new Collection;
 | |
|         $count   = 0;
 | |
| 
 | |
|         // properties for entries with their amounts.
 | |
|         $cache = new CacheProperties();
 | |
|         $cache->addProperty($first);
 | |
|         $cache->addProperty($end);
 | |
|         $cache->addProperty('categories.entries');
 | |
|         $cache->addProperty($category->id);
 | |
| 
 | |
|         if ($cache->has()) {
 | |
|             return $cache->get(); // @codeCoverageIgnore
 | |
|         }
 | |
|         while ($end >= $first && $count < 90) {
 | |
|             $end        = app('navigation')->startOfPeriod($end, $range);
 | |
|             $currentEnd = app('navigation')->endOfPeriod($end, $range);
 | |
|             $spent      = $repository->spentInPeriod(new Collection([$category]), $accounts, $end, $currentEnd);
 | |
|             $earned     = $repository->earnedInPeriod(new Collection([$category]), $accounts, $end, $currentEnd);
 | |
|             $dateStr    = $end->format('Y-m-d');
 | |
|             $dateName   = app('navigation')->periodShow($end, $range);
 | |
| 
 | |
|             // amount transferred
 | |
|             /** @var JournalCollectorInterface $collector */
 | |
|             $collector = app(JournalCollectorInterface::class);
 | |
|             $collector->setAllAssetAccounts()->setRange($end, $currentEnd)->setCategory($category)
 | |
|                       ->withOpposingAccount()->setTypes([TransactionType::TRANSFER]);
 | |
|             $collector->removeFilter(InternalTransferFilter::class);
 | |
|             $transferred = Steam::positive($collector->getJournals()->sum('transaction_amount'));
 | |
| 
 | |
|             $entries->push(
 | |
|                 [
 | |
|                     'string'      => $dateStr,
 | |
|                     'name'        => $dateName,
 | |
|                     'spent'       => $spent,
 | |
|                     'earned'      => $earned,
 | |
|                     'sum'         => bcadd($earned, $spent),
 | |
|                     'transferred' => $transferred,
 | |
|                     'date'        => clone $end,
 | |
|                 ]
 | |
|             );
 | |
|             $end = app('navigation')->subtractPeriod($end, $range, 1);
 | |
|             ++$count;
 | |
|         }
 | |
|         $cache->store($entries);
 | |
| 
 | |
|         return $entries;
 | |
|     }
 | |
| }
 |