| 
									
										
										
										
											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
										 |  |  |  * UpdatedGroupEventHandler.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; | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2025-01-03 09:05:19 +01:00
										 |  |  | use FireflyIII\Enums\TransactionTypeEnum; | 
					
						
							| 
									
										
										
										
											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\UpdatedTransactionGroup; | 
					
						
							| 
									
										
										
										
											2020-12-04 20:19:52 +01:00
										 |  |  | use FireflyIII\Generator\Webhook\MessageGeneratorInterface; | 
					
						
							| 
									
										
										
										
											2020-07-01 05:51:15 +02:00
										 |  |  | use FireflyIII\Models\Account; | 
					
						
							|  |  |  | use FireflyIII\Models\Transaction; | 
					
						
							| 
									
										
										
										
											2019-06-21 19:06:50 +02:00
										 |  |  | use FireflyIII\Models\TransactionJournal; | 
					
						
							| 
									
										
										
										
											2021-02-12 20:15:23 +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-03 06:54:42 +01:00
										 |  |  | use Illuminate\Support\Collection; | 
					
						
							| 
									
										
										
										
											2016-10-22 09:31:27 +02:00
										 |  |  | 
 | 
					
						
							|  |  |  | /** | 
					
						
							| 
									
										
										
										
											2019-03-30 11:03:39 +01:00
										 |  |  |  * Class UpdatedGroupEventHandler | 
					
						
							| 
									
										
										
										
											2016-10-22 09:31:27 +02:00
										 |  |  |  */ | 
					
						
							| 
									
										
										
										
											2019-03-30 11:03:39 +01:00
										 |  |  | class UpdatedGroupEventHandler | 
					
						
							| 
									
										
										
										
											2016-10-22 09:31:27 +02:00
										 |  |  | { | 
					
						
							| 
									
										
										
										
											2025-02-06 05:55:46 +01:00
										 |  |  |     public function runAllHandlers(UpdatedTransactionGroup $event): void { | 
					
						
							|  |  |  |         $this->unifyAccounts($event); | 
					
						
							|  |  |  |         $this->processRules($event); | 
					
						
							|  |  |  |         $this->recalculateCredit($event); | 
					
						
							|  |  |  |         $this->triggerWebhooks($event); | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |     } | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2016-10-22 09:31:27 +02:00
										 |  |  |     /** | 
					
						
							|  |  |  |      * This method will check all the rules when a journal is updated. | 
					
						
							|  |  |  |      */ | 
					
						
							| 
									
										
										
										
											2025-02-06 05:55:46 +01:00
										 |  |  |     private function processRules(UpdatedTransactionGroup $updatedGroupEvent): void | 
					
						
							| 
									
										
										
										
											2016-10-22 09:31:27 +02:00
										 |  |  |     { | 
					
						
							| 
									
										
										
										
											2020-03-06 09:41:27 +01:00
										 |  |  |         if (false === $updatedGroupEvent->applyRules) { | 
					
						
							| 
									
										
										
										
											2023-10-29 06:31:27 +01:00
										 |  |  |             app('log')->info(sprintf('Will not run rules on group #%d', $updatedGroupEvent->transactionGroup->id)); | 
					
						
							| 
									
										
										
										
											2020-03-06 09:41:27 +01:00
										 |  |  | 
 | 
					
						
							|  |  |  |             return; | 
					
						
							|  |  |  |         } | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-01-01 14:43:56 +01:00
										 |  |  |         $journals            = $updatedGroupEvent->transactionGroup->transactionJournals; | 
					
						
							|  |  |  |         $array               = []; | 
					
						
							| 
									
										
										
										
											2023-12-20 19:35:52 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-06-21 19:06:50 +02:00
										 |  |  |         /** @var TransactionJournal $journal */ | 
					
						
							| 
									
										
										
										
											2019-03-30 11:03:39 +01:00
										 |  |  |         foreach ($journals as $journal) { | 
					
						
							| 
									
										
										
										
											2020-08-24 07:03:17 +02:00
										 |  |  |             $array[] = $journal->id; | 
					
						
							| 
									
										
										
										
											2016-10-22 09:31:27 +02:00
										 |  |  |         } | 
					
						
							| 
									
										
										
										
											2024-01-01 14:43:56 +01:00
										 |  |  |         $journalIds          = implode(',', $array); | 
					
						
							| 
									
										
										
										
											2023-10-29 06:33:43 +01:00
										 |  |  |         app('log')->debug(sprintf('Add local operator for journal(s): %s', $journalIds)); | 
					
						
							| 
									
										
										
										
											2020-08-24 07:03:17 +02:00
										 |  |  | 
 | 
					
						
							|  |  |  |         // collect rules:
 | 
					
						
							| 
									
										
										
										
											2021-02-12 20:15:23 +01:00
										 |  |  |         $ruleGroupRepository = app(RuleGroupRepositoryInterface::class); | 
					
						
							|  |  |  |         $ruleGroupRepository->setUser($updatedGroupEvent->transactionGroup->user); | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-01-01 14:43:56 +01:00
										 |  |  |         $groups              = $ruleGroupRepository->getRuleGroupsWithRules('update-journal'); | 
					
						
							| 
									
										
										
										
											2020-08-24 07:03:17 +02:00
										 |  |  | 
 | 
					
						
							|  |  |  |         // file rule engine.
 | 
					
						
							| 
									
										
										
										
											2024-01-01 14:43:56 +01:00
										 |  |  |         $newRuleEngine       = app(RuleEngineInterface::class); | 
					
						
							| 
									
										
										
										
											2020-08-24 07:03:17 +02:00
										 |  |  |         $newRuleEngine->setUser($updatedGroupEvent->transactionGroup->user); | 
					
						
							|  |  |  |         $newRuleEngine->addOperator(['type' => 'journal_id', 'value' => $journalIds]); | 
					
						
							| 
									
										
										
										
											2021-02-12 20:15:23 +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(UpdatedTransactionGroup $event): void | 
					
						
							| 
									
										
										
										
											2021-09-18 10:26:12 +02:00
										 |  |  |     { | 
					
						
							| 
									
										
										
										
											2024-01-01 14:43:56 +01: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-02-06 05:55:46 +01:00
										 |  |  |     private function triggerWebhooks(UpdatedTransactionGroup $updatedGroupEvent): void | 
					
						
							| 
									
										
										
										
											2020-12-03 06:54:42 +01:00
										 |  |  |     { | 
					
						
							| 
									
										
										
										
											2023-10-29 06:33:43 +01:00
										 |  |  |         app('log')->debug(__METHOD__); | 
					
						
							| 
									
										
										
										
											2024-01-01 14:43:56 +01:00
										 |  |  |         $group  = $updatedGroupEvent->transactionGroup; | 
					
						
							| 
									
										
										
										
											2021-05-02 14:53:13 +02:00
										 |  |  |         if (false === $updatedGroupEvent->fireWebhooks) { | 
					
						
							| 
									
										
										
										
											2023-10-29 06:31:27 +01:00
										 |  |  |             app('log')->info(sprintf('Will not fire webhooks for transaction group #%d', $group->id)); | 
					
						
							| 
									
										
										
										
											2021-05-02 14:53:13 +02:00
										 |  |  | 
 | 
					
						
							|  |  |  |             return; | 
					
						
							|  |  |  |         } | 
					
						
							| 
									
										
										
										
											2024-01-01 14:43:56 +01: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-03 06:54:42 +01:00
										 |  |  |         $engine->setUser($user); | 
					
						
							| 
									
										
										
										
											2020-12-05 07:01:26 +01:00
										 |  |  |         $engine->setObjects(new Collection([$group])); | 
					
						
							| 
									
										
										
										
											2022-09-17 16:54:13 +02:00
										 |  |  |         $engine->setTrigger(WebhookTrigger::UPDATE_TRANSACTION->value); | 
					
						
							| 
									
										
										
										
											2020-12-03 06:54:42 +01:00
										 |  |  |         $engine->generateMessages(); | 
					
						
							| 
									
										
										
										
											2020-12-05 07:01:26 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-10-30 14:24:19 +01:00
										 |  |  |         event(new RequestedSendWebhookMessages()); | 
					
						
							| 
									
										
										
										
											2020-12-03 06:54:42 +01:00
										 |  |  |     } | 
					
						
							| 
									
										
										
										
											2021-03-21 09:15:40 +01:00
										 |  |  | 
 | 
					
						
							|  |  |  |     /** | 
					
						
							|  |  |  |      * This method will make sure all source / destination accounts are the same. | 
					
						
							|  |  |  |      */ | 
					
						
							| 
									
										
										
										
											2025-02-08 06:57:26 +01:00
										 |  |  |     public function unifyAccounts(UpdatedTransactionGroup $updatedGroupEvent): void | 
					
						
							| 
									
										
										
										
											2021-03-21 09:15:40 +01:00
										 |  |  |     { | 
					
						
							| 
									
										
										
										
											2024-01-01 14:43:56 +01:00
										 |  |  |         $group         = $updatedGroupEvent->transactionGroup; | 
					
						
							| 
									
										
										
										
											2021-03-21 09:15:40 +01:00
										 |  |  |         if (1 === $group->transactionJournals->count()) { | 
					
						
							|  |  |  |             return; | 
					
						
							|  |  |  |         } | 
					
						
							| 
									
										
										
										
											2023-12-20 19:35:52 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2021-03-21 09:15:40 +01:00
										 |  |  |         // first journal:
 | 
					
						
							| 
									
										
										
										
											2023-12-20 19:35:52 +01:00
										 |  |  |         /** @var null|TransactionJournal $first */ | 
					
						
							| 
									
										
										
										
											2024-01-01 14:43:56 +01:00
										 |  |  |         $first         = $group->transactionJournals() | 
					
						
							| 
									
										
										
										
											2023-12-20 19:35:52 +01:00
										 |  |  |             ->orderBy('transaction_journals.date', 'DESC') | 
					
						
							|  |  |  |             ->orderBy('transaction_journals.order', 'ASC') | 
					
						
							|  |  |  |             ->orderBy('transaction_journals.id', 'DESC') | 
					
						
							|  |  |  |             ->orderBy('transaction_journals.description', 'DESC') | 
					
						
							|  |  |  |             ->first() | 
					
						
							|  |  |  |         ; | 
					
						
							| 
									
										
										
										
											2022-01-24 07:24:01 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-03-29 14:58:06 +02:00
										 |  |  |         if (null === $first) { | 
					
						
							| 
									
										
										
										
											2022-10-30 14:44:49 +01:00
										 |  |  |             app('log')->warning(sprintf('Group #%d has no transaction journals.', $group->id)); | 
					
						
							| 
									
										
										
										
											2023-12-20 19:35:52 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-01-24 07:24:01 +01:00
										 |  |  |             return; | 
					
						
							|  |  |  |         } | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-01-01 14:43:56 +01:00
										 |  |  |         $all           = $group->transactionJournals()->get()->pluck('id')->toArray(); | 
					
						
							| 
									
										
										
										
											2023-12-20 19:35:52 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2021-03-21 09:15:40 +01:00
										 |  |  |         /** @var Account $sourceAccount */ | 
					
						
							|  |  |  |         $sourceAccount = $first->transactions()->where('amount', '<', '0')->first()->account; | 
					
						
							| 
									
										
										
										
											2023-12-20 19:35:52 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2021-03-21 09:15:40 +01:00
										 |  |  |         /** @var Account $destAccount */ | 
					
						
							| 
									
										
										
										
											2024-01-01 14:43:56 +01:00
										 |  |  |         $destAccount   = $first->transactions()->where('amount', '>', '0')->first()->account; | 
					
						
							| 
									
										
										
										
											2021-03-21 09:15:40 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-01-01 14:43:56 +01:00
										 |  |  |         $type          = $first->transactionType->type; | 
					
						
							| 
									
										
										
										
											2025-01-03 09:05:56 +01:00
										 |  |  |         if (TransactionTypeEnum::TRANSFER->value === $type || TransactionTypeEnum::WITHDRAWAL->value === $type) { | 
					
						
							| 
									
										
										
										
											2021-03-21 09:15:40 +01:00
										 |  |  |             // set all source transactions to source account:
 | 
					
						
							|  |  |  |             Transaction::whereIn('transaction_journal_id', $all) | 
					
						
							| 
									
										
										
										
											2023-12-20 19:35:52 +01:00
										 |  |  |                 ->where('amount', '<', 0)->update(['account_id' => $sourceAccount->id]) | 
					
						
							|  |  |  |             ; | 
					
						
							| 
									
										
										
										
											2021-03-21 09:15:40 +01:00
										 |  |  |         } | 
					
						
							| 
									
										
										
										
											2025-01-03 09:09:15 +01:00
										 |  |  |         if (TransactionTypeEnum::TRANSFER->value === $type || TransactionTypeEnum::DEPOSIT->value === $type) { | 
					
						
							| 
									
										
										
										
											2021-03-21 09:15:40 +01:00
										 |  |  |             // set all destination transactions to destination account:
 | 
					
						
							|  |  |  |             Transaction::whereIn('transaction_journal_id', $all) | 
					
						
							| 
									
										
										
										
											2023-12-20 19:35:52 +01:00
										 |  |  |                 ->where('amount', '>', 0)->update(['account_id' => $destAccount->id]) | 
					
						
							|  |  |  |             ; | 
					
						
							| 
									
										
										
										
											2021-03-21 09:15:40 +01:00
										 |  |  |         } | 
					
						
							|  |  |  |     } | 
					
						
							| 
									
										
										
										
											2016-10-23 12:42:44 +02:00
										 |  |  | } |