| 
									
										
										
										
											2016-10-22 09:31:27 +02:00
										 |  |  | <?php | 
					
						
							| 
									
										
										
										
											2022-12-29 19:41:57 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2016-10-22 09:31:27 +02:00
										 |  |  | /** | 
					
						
							| 
									
										
										
										
											2019-03-30 11:03:39 +01:00
										 |  |  |  * StoredGroupEventHandler.php | 
					
						
							| 
									
										
										
										
											2020-01-28 08:45:38 +01:00
										 |  |  |  * Copyright (c) 2019 james@firefly-iii.org | 
					
						
							| 
									
										
										
										
											2016-10-22 09:31:27 +02:00
										 |  |  |  * | 
					
						
							| 
									
										
										
										
											2019-10-02 06:37:26 +02:00
										 |  |  |  * This file is part of Firefly III (https://github.com/firefly-iii). | 
					
						
							| 
									
										
										
										
											2016-10-22 09:31:27 +02:00
										 |  |  |  * | 
					
						
							| 
									
										
										
										
											2019-10-02 06:37:26 +02:00
										 |  |  |  * 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. | 
					
						
							| 
									
										
										
										
											2017-10-21 08:40:00 +02:00
										 |  |  |  * | 
					
						
							| 
									
										
										
										
											2019-10-02 06:37:26 +02:00
										 |  |  |  * This program is distributed in the hope that it will be useful, | 
					
						
							| 
									
										
										
										
											2017-10-21 08:40:00 +02:00
										 |  |  |  * but WITHOUT ANY WARRANTY; without even the implied warranty of | 
					
						
							|  |  |  |  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the | 
					
						
							| 
									
										
										
										
											2019-10-02 06:37:26 +02:00
										 |  |  |  * GNU Affero General Public License for more details. | 
					
						
							| 
									
										
										
										
											2017-10-21 08:40:00 +02:00
										 |  |  |  * | 
					
						
							| 
									
										
										
										
											2019-10-02 06:37:26 +02:00
										 |  |  |  * 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/>. | 
					
						
							| 
									
										
										
										
											2016-10-22 09:31:27 +02:00
										 |  |  |  */ | 
					
						
							| 
									
										
										
										
											2017-04-09 07:44:22 +02:00
										 |  |  | declare(strict_types=1); | 
					
						
							| 
									
										
										
										
											2016-10-22 09:31:27 +02:00
										 |  |  | 
 | 
					
						
							|  |  |  | namespace FireflyIII\Handlers\Events; | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-09-17 16:54:13 +02:00
										 |  |  | use FireflyIII\Enums\WebhookTrigger; | 
					
						
							| 
									
										
										
										
											2020-12-05 07:01:26 +01:00
										 |  |  | use FireflyIII\Events\RequestedSendWebhookMessages; | 
					
						
							| 
									
										
										
										
											2019-03-30 11:03:39 +01:00
										 |  |  | use FireflyIII\Events\StoredTransactionGroup; | 
					
						
							| 
									
										
										
										
											2020-12-04 20:19:52 +01:00
										 |  |  | use FireflyIII\Generator\Webhook\MessageGeneratorInterface; | 
					
						
							| 
									
										
										
										
											2019-06-21 19:06:50 +02:00
										 |  |  | use FireflyIII\Models\TransactionJournal; | 
					
						
							| 
									
										
										
										
											2025-09-26 19:38:26 +02:00
										 |  |  | use FireflyIII\Repositories\PeriodStatistic\PeriodStatisticRepositoryInterface; | 
					
						
							| 
									
										
										
										
											2020-12-18 19:16:56 +01:00
										 |  |  | use FireflyIII\Repositories\RuleGroup\RuleGroupRepositoryInterface; | 
					
						
							| 
									
										
										
										
											2021-04-10 07:59:41 +02:00
										 |  |  | use FireflyIII\Services\Internal\Support\CreditRecalculateService; | 
					
						
							| 
									
										
										
										
											2020-08-24 07:03:17 +02:00
										 |  |  | use FireflyIII\TransactionRules\Engine\RuleEngineInterface; | 
					
						
							| 
									
										
										
										
											2020-12-02 06:54:13 +01:00
										 |  |  | use Illuminate\Support\Collection; | 
					
						
							| 
									
										
										
										
											2025-08-17 07:40:19 +02:00
										 |  |  | use Illuminate\Support\Facades\Log; | 
					
						
							| 
									
										
										
										
											2016-10-22 09:31:27 +02:00
										 |  |  | 
 | 
					
						
							|  |  |  | /** | 
					
						
							| 
									
										
										
										
											2019-03-30 11:03:39 +01:00
										 |  |  |  * Class StoredGroupEventHandler | 
					
						
							| 
									
										
										
										
											2025-09-26 19:38:26 +02:00
										 |  |  |  * | 
					
						
							|  |  |  |  * TODO migrate to observer? | 
					
						
							| 
									
										
										
										
											2016-10-22 09:31:27 +02:00
										 |  |  |  */ | 
					
						
							| 
									
										
										
										
											2019-03-30 11:03:39 +01:00
										 |  |  | class StoredGroupEventHandler | 
					
						
							| 
									
										
										
										
											2016-10-22 09:31:27 +02:00
										 |  |  | { | 
					
						
							| 
									
										
										
										
											2025-02-06 05:55:46 +01:00
										 |  |  |     public function runAllHandlers(StoredTransactionGroup $event): void | 
					
						
							|  |  |  |     { | 
					
						
							|  |  |  |         $this->processRules($event); | 
					
						
							|  |  |  |         $this->recalculateCredit($event); | 
					
						
							|  |  |  |         $this->triggerWebhooks($event); | 
					
						
							| 
									
										
										
										
											2025-09-26 19:38:26 +02:00
										 |  |  |         $this->removePeriodStatistics($event); | 
					
						
							| 
									
										
										
										
											2025-02-06 05:55:46 +01:00
										 |  |  |     } | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2016-10-22 09:31:27 +02:00
										 |  |  |     /** | 
					
						
							|  |  |  |      * This method grabs all the users rules and processes them. | 
					
						
							|  |  |  |      */ | 
					
						
							| 
									
										
										
										
											2025-02-06 05:55:46 +01:00
										 |  |  |     private function processRules(StoredTransactionGroup $storedGroupEvent): void | 
					
						
							| 
									
										
										
										
											2016-10-22 09:31:27 +02:00
										 |  |  |     { | 
					
						
							| 
									
										
										
										
											2020-03-06 09:41:27 +01:00
										 |  |  |         if (false === $storedGroupEvent->applyRules) { | 
					
						
							| 
									
										
										
										
											2025-08-17 07:40:19 +02:00
										 |  |  |             Log::info(sprintf('Will not run rules on group #%d', $storedGroupEvent->transactionGroup->id)); | 
					
						
							| 
									
										
										
										
											2020-03-06 09:41:27 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-06-21 19:06:50 +02:00
										 |  |  |             return; | 
					
						
							| 
									
										
										
										
											2019-06-07 17:57:46 +02:00
										 |  |  |         } | 
					
						
							| 
									
										
										
										
											2025-08-17 07:40:19 +02:00
										 |  |  |         Log::debug('Now in StoredGroupEventHandler::processRules()'); | 
					
						
							| 
									
										
										
										
											2016-10-22 09:31:27 +02:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2025-10-03 06:04:16 +02:00
										 |  |  |         $journals            = $storedGroupEvent->transactionGroup->transactionJournals; | 
					
						
							|  |  |  |         $array               = []; | 
					
						
							| 
									
										
										
										
											2023-12-20 19:35:52 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-06-21 19:06:50 +02:00
										 |  |  |         /** @var TransactionJournal $journal */ | 
					
						
							|  |  |  |         foreach ($journals as $journal) { | 
					
						
							| 
									
										
										
										
											2020-08-24 07:03:17 +02:00
										 |  |  |             $array[] = $journal->id; | 
					
						
							| 
									
										
										
										
											2016-10-22 09:31:27 +02:00
										 |  |  |         } | 
					
						
							| 
									
										
										
										
											2025-10-03 06:04:16 +02:00
										 |  |  |         $journalIds          = implode(',', $array); | 
					
						
							| 
									
										
										
										
											2025-08-17 07:40:19 +02:00
										 |  |  |         Log::debug(sprintf('Add local operator for journal(s): %s', $journalIds)); | 
					
						
							| 
									
										
										
										
											2020-08-24 07:03:17 +02:00
										 |  |  | 
 | 
					
						
							|  |  |  |         // collect rules:
 | 
					
						
							| 
									
										
										
										
											2020-12-18 19:16:56 +01:00
										 |  |  |         $ruleGroupRepository = app(RuleGroupRepositoryInterface::class); | 
					
						
							|  |  |  |         $ruleGroupRepository->setUser($storedGroupEvent->transactionGroup->user); | 
					
						
							| 
									
										
										
										
											2020-08-24 07:03:17 +02:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2020-12-18 19:16:56 +01:00
										 |  |  |         // add the groups to the rule engine.
 | 
					
						
							|  |  |  |         // it should run the rules in the group and cancel the group if necessary.
 | 
					
						
							| 
									
										
										
										
											2025-10-03 06:04:16 +02:00
										 |  |  |         $groups              = $ruleGroupRepository->getRuleGroupsWithRules('store-journal'); | 
					
						
							| 
									
										
										
										
											2020-12-18 19:16:56 +01:00
										 |  |  | 
 | 
					
						
							|  |  |  |         // create and fire rule engine.
 | 
					
						
							| 
									
										
										
										
											2025-10-03 06:04:16 +02:00
										 |  |  |         $newRuleEngine       = app(RuleEngineInterface::class); | 
					
						
							| 
									
										
										
										
											2020-08-24 07:03:17 +02:00
										 |  |  |         $newRuleEngine->setUser($storedGroupEvent->transactionGroup->user); | 
					
						
							|  |  |  |         $newRuleEngine->addOperator(['type' => 'journal_id', 'value' => $journalIds]); | 
					
						
							| 
									
										
										
										
											2020-12-18 19:16:56 +01:00
										 |  |  |         $newRuleEngine->setRuleGroups($groups); | 
					
						
							| 
									
										
										
										
											2020-08-24 07:03:17 +02:00
										 |  |  |         $newRuleEngine->fire(); | 
					
						
							| 
									
										
										
										
											2016-10-22 09:31:27 +02:00
										 |  |  |     } | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2025-02-06 05:55:46 +01:00
										 |  |  |     private function recalculateCredit(StoredTransactionGroup $event): void | 
					
						
							| 
									
										
										
										
											2021-09-18 10:26:12 +02:00
										 |  |  |     { | 
					
						
							| 
									
										
										
										
											2025-10-03 06:04:16 +02:00
										 |  |  |         $group  = $event->transactionGroup; | 
					
						
							| 
									
										
										
										
											2023-12-20 19:35:52 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2021-09-18 10:26:12 +02:00
										 |  |  |         /** @var CreditRecalculateService $object */ | 
					
						
							|  |  |  |         $object = app(CreditRecalculateService::class); | 
					
						
							|  |  |  |         $object->setGroup($group); | 
					
						
							|  |  |  |         $object->recalculate(); | 
					
						
							|  |  |  |     } | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2025-09-26 19:38:26 +02:00
										 |  |  |     private function removePeriodStatistics(StoredTransactionGroup $event): void | 
					
						
							|  |  |  |     { | 
					
						
							|  |  |  |         /** @var PeriodStatisticRepositoryInterface $repository */ | 
					
						
							|  |  |  |         $repository = app(PeriodStatisticRepositoryInterface::class); | 
					
						
							| 
									
										
										
										
											2025-09-26 19:43:39 +02:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2025-09-26 19:38:26 +02:00
										 |  |  |         /** @var TransactionJournal $journal */ | 
					
						
							|  |  |  |         foreach ($event->transactionGroup->transactionJournals as $journal) { | 
					
						
							| 
									
										
										
										
											2025-10-03 06:04:16 +02:00
										 |  |  |             $source     = $journal->transactions()->where('amount', '<', '0')->first(); | 
					
						
							|  |  |  |             $dest       = $journal->transactions()->where('amount', '>', '0')->first(); | 
					
						
							| 
									
										
										
										
											2025-09-26 19:38:26 +02:00
										 |  |  |             $repository->deleteStatisticsForModel($source->account, $journal->date); | 
					
						
							|  |  |  |             $repository->deleteStatisticsForModel($dest->account, $journal->date); | 
					
						
							| 
									
										
										
										
											2025-10-03 05:53:50 +02:00
										 |  |  |             $categories = $journal->categories; | 
					
						
							|  |  |  |             $tags       = $journal->tags; | 
					
						
							|  |  |  |             $budgets    = $journal->budgets; | 
					
						
							|  |  |  |             foreach ($categories as $category) { | 
					
						
							| 
									
										
										
										
											2025-09-27 06:01:14 +02:00
										 |  |  |                 $repository->deleteStatisticsForModel($category, $journal->date); | 
					
						
							|  |  |  |             } | 
					
						
							| 
									
										
										
										
											2025-10-03 05:53:50 +02:00
										 |  |  |             foreach ($tags as $tag) { | 
					
						
							| 
									
										
										
										
											2025-09-27 06:01:14 +02:00
										 |  |  |                 $repository->deleteStatisticsForModel($tag, $journal->date); | 
					
						
							|  |  |  |             } | 
					
						
							| 
									
										
										
										
											2025-10-03 05:53:50 +02:00
										 |  |  |             foreach ($budgets as $budget) { | 
					
						
							|  |  |  |                 $repository->deleteStatisticsForModel($budget, $journal->date); | 
					
						
							|  |  |  |             } | 
					
						
							|  |  |  |             if (0 === $categories->count()) { | 
					
						
							|  |  |  |                 $repository->deleteStatisticsForPrefix($journal->userGroup, 'no_category', $journal->date); | 
					
						
							|  |  |  |             } | 
					
						
							|  |  |  |             if (0 === $budgets->count()) { | 
					
						
							|  |  |  |                 $repository->deleteStatisticsForPrefix($journal->userGroup, 'no_budget', $journal->date); | 
					
						
							|  |  |  |             } | 
					
						
							| 
									
										
										
										
											2025-09-26 19:38:26 +02:00
										 |  |  |         } | 
					
						
							|  |  |  |     } | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2020-12-02 06:54:13 +01:00
										 |  |  |     /** | 
					
						
							|  |  |  |      * This method processes all webhooks that respond to the "stored transaction group" trigger (100) | 
					
						
							|  |  |  |      */ | 
					
						
							| 
									
										
										
										
											2025-02-06 05:55:46 +01:00
										 |  |  |     private function triggerWebhooks(StoredTransactionGroup $storedGroupEvent): void | 
					
						
							| 
									
										
										
										
											2020-12-02 06:54:13 +01:00
										 |  |  |     { | 
					
						
							| 
									
										
										
										
											2025-08-17 07:40:19 +02:00
										 |  |  |         Log::debug(__METHOD__); | 
					
						
							| 
									
										
										
										
											2025-10-03 06:04:16 +02:00
										 |  |  |         $group  = $storedGroupEvent->transactionGroup; | 
					
						
							| 
									
										
										
										
											2021-05-02 14:53:13 +02:00
										 |  |  |         if (false === $storedGroupEvent->fireWebhooks) { | 
					
						
							| 
									
										
										
										
											2025-08-17 07:40:19 +02:00
										 |  |  |             Log::info(sprintf('Will not fire webhooks for transaction group #%d', $group->id)); | 
					
						
							| 
									
										
										
										
											2021-05-02 14:53:13 +02:00
										 |  |  | 
 | 
					
						
							|  |  |  |             return; | 
					
						
							|  |  |  |         } | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2025-10-03 06:04:16 +02:00
										 |  |  |         $user   = $group->user; | 
					
						
							| 
									
										
										
										
											2023-12-20 19:35:52 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2020-12-04 20:19:52 +01:00
										 |  |  |         /** @var MessageGeneratorInterface $engine */ | 
					
						
							|  |  |  |         $engine = app(MessageGeneratorInterface::class); | 
					
						
							| 
									
										
										
										
											2020-12-02 06:54:13 +01:00
										 |  |  |         $engine->setUser($user); | 
					
						
							| 
									
										
										
										
											2020-12-05 06:47:16 +01:00
										 |  |  | 
 | 
					
						
							|  |  |  |         // tell the generator which trigger it should look for
 | 
					
						
							| 
									
										
										
										
											2025-08-17 07:40:19 +02:00
										 |  |  |         $engine->setTrigger(WebhookTrigger::STORE_TRANSACTION); | 
					
						
							| 
									
										
										
										
											2020-12-05 06:47:16 +01:00
										 |  |  |         // tell the generator which objects to process
 | 
					
						
							| 
									
										
										
										
											2025-09-10 16:07:19 +02:00
										 |  |  |         $engine->setObjects(new Collection()->push($group)); | 
					
						
							| 
									
										
										
										
											2020-12-05 06:47:16 +01:00
										 |  |  |         // tell the generator to generate the messages
 | 
					
						
							| 
									
										
										
										
											2020-12-02 19:30:09 +01:00
										 |  |  |         $engine->generateMessages(); | 
					
						
							| 
									
										
										
										
											2020-12-05 07:01:26 +01:00
										 |  |  | 
 | 
					
						
							|  |  |  |         // trigger event to send them:
 | 
					
						
							| 
									
										
										
										
											2025-08-21 20:31:32 +02:00
										 |  |  |         Log::debug(sprintf('send event RequestedSendWebhookMessages from %s', __METHOD__)); | 
					
						
							| 
									
										
										
										
											2022-10-30 14:24:19 +01:00
										 |  |  |         event(new RequestedSendWebhookMessages()); | 
					
						
							| 
									
										
										
										
											2020-12-02 06:54:13 +01:00
										 |  |  |     } | 
					
						
							| 
									
										
										
										
											2016-10-23 12:42:44 +02:00
										 |  |  | } |