. */ declare(strict_types=1); namespace FireflyIII\TransactionRules; use FireflyIII\Helpers\Collector\TransactionCollectorInterface; use FireflyIII\Models\Rule; use FireflyIII\Models\RuleTrigger; use FireflyIII\Models\Transaction; use FireflyIII\Models\TransactionType; use Illuminate\Support\Collection; use Log; /** * Class TransactionMatcher is used to find a list of * transaction matching a set of triggers. */ class TransactionMatcher { /** @var string */ private $exactAmount; /** @var int Limit of matcher */ private $limit = 10; /** @var string */ private $maxAmount; /** @var string */ private $minAmount; /** @var int Maximum number of transaction to search in (for performance reasons) * */ private $range = 200; /** @var Rule The rule to apply */ private $rule; /** @var bool */ private $strict; /** @var array Types that can be matched using this matcher */ private $transactionTypes = [TransactionType::DEPOSIT, TransactionType::WITHDRAWAL, TransactionType::TRANSFER]; /** @var array List of triggers to match */ private $triggers = []; public function __construct() { $this->strict = false; } /** * This method will search the user's transaction journal (with an upper limit of $range) for * transaction journals matching the given rule. This is accomplished by trying to fire these * triggers onto each transaction journal until enough matches are found ($limit). * * @return Collection * @throws \FireflyIII\Exceptions\FireflyException */ public function findTransactionsByRule(): Collection { if (0 === \count($this->rule->ruleTriggers)) { return new Collection; } // Variables used within the loop /** @var Processor $processor */ $processor = app(Processor::class); $processor->make($this->rule, false); $result = $this->runProcessor($processor); // If the list of matchingTransactions is larger than the maximum number of results // (e.g. if a large percentage of the transactions match), truncate the list $result = $result->slice(0, $this->limit); return $result; } /** * This method will search the user's transaction journal (with an upper limit of $range) for * transaction journals matching the given $triggers. This is accomplished by trying to fire these * triggers onto each transaction journal until enough matches are found ($limit). * * @return Collection * @throws \FireflyIII\Exceptions\FireflyException */ public function findTransactionsByTriggers(): Collection { if (0 === \count($this->triggers)) { return new Collection; } // Variables used within the loop /** @var Processor $processor */ $processor = app(Processor::class); $processor->makeFromStringArray($this->triggers); $processor->setStrict($this->strict); $result = $this->runProcessor($processor); // If the list of matchingTransactions is larger than the maximum number of results // (e.g. if a large percentage of the transactions match), truncate the list $result = $result->slice(0, $this->limit); return $result; } /** * Return limit * * @return int */ public function getLimit(): int { return $this->limit; } /** * Set limit * * @param int $limit * * @return TransactionMatcher */ public function setLimit(int $limit): TransactionMatcher { $this->limit = $limit; return $this; } /** * Get range * * @return int */ public function getRange(): int { return $this->range; } /** * Set range * * @param int $range * * @return TransactionMatcher */ public function setRange(int $range): TransactionMatcher { $this->range = $range; return $this; } /** * Get triggers * * @return array */ public function getTriggers(): array { return $this->triggers; } /** * Set triggers * * @param array $triggers * * @return TransactionMatcher */ public function setTriggers(array $triggers): TransactionMatcher { $this->triggers = $triggers; return $this; } /** * @return bool */ public function isStrict(): bool { return $this->strict; } /** * @param bool $strict */ public function setStrict(bool $strict): void { $this->strict = $strict; } /** * Set rule * * @param Rule $rule */ public function setRule(Rule $rule): void { $this->rule = $rule; } /** * */ private function readTriggers(): void { $valid = ['amount_less', 'amount_more', 'amount_exactly']; if (null !== $this->rule) { $allTriggers = $this->rule->ruleTriggers()->whereIn('trigger_type', $valid)->get(); /** @var RuleTrigger $trigger */ foreach ($allTriggers as $trigger) { if ('amount_less' === $trigger->trigger_type) { $this->maxAmount = $trigger->trigger_value; Log::debug(sprintf('Set max amount to be %s', $trigger->trigger_value)); } if ('amount_more' === $trigger->trigger_type) { $this->minAmount = $trigger->trigger_value; Log::debug(sprintf('Set min amount to be %s', $trigger->trigger_value)); } if ('amount_exactly' === $trigger->trigger_type) { $this->exactAmount = $trigger->trigger_value; Log::debug(sprintf('Set exact amount to be %s', $trigger->trigger_value)); } } } } /** * Run the processor. * * @param Processor $processor * * @return Collection */ private function runProcessor(Processor $processor): Collection { // since we have a rule in $this->rule, we can add some of the triggers // to the Journal Collector. // Firefly III will then have to search through less transactions. $this->readTriggers(); // Start a loop to fetch batches of transactions. The loop will finish if: // - all transactions have been fetched from the database // - the maximum number of transactions to return has been found // - the maximum number of transactions to search in have been searched $pageSize = min($this->range / 2, $this->limit * 2); $processed = 0; $page = 1; $result = new Collection(); do { // Fetch a batch of transactions from the database /** @var TransactionCollectorInterface $collector */ $collector = app(TransactionCollectorInterface::class); $collector->setUser(auth()->user()); $collector->setAllAssetAccounts()->setLimit($pageSize)->setPage($page)->setTypes($this->transactionTypes); if (null !== $this->maxAmount) { Log::debug(sprintf('Amount must be less than %s', $this->maxAmount)); $collector->amountLess($this->maxAmount); } if (null !== $this->minAmount) { Log::debug(sprintf('Amount must be more than %s', $this->minAmount)); $collector->amountMore($this->minAmount); } if (null !== $this->exactAmount) { Log::debug(sprintf('Amount must be exactly %s', $this->exactAmount)); $collector->amountIs($this->exactAmount); } $set = $collector->getPaginatedTransactions(); Log::debug(sprintf('Found %d journals to check. ', $set->count())); // Filter transactions that match the given triggers. $filtered = $set->filter( function (Transaction $transaction) use ($processor) { Log::debug(sprintf('Test these triggers on journal #%d (transaction #%d)', $transaction->transaction_journal_id, $transaction->id)); return $processor->handleTransaction($transaction); } ); Log::debug(sprintf('Found %d journals that match.', $filtered->count())); // merge: /** @var Collection $result */ $result = $result->merge($filtered); Log::debug(sprintf('Total count is now %d', $result->count())); // Update counters ++$page; $processed += \count($set); Log::debug(sprintf('Page is now %d, processed is %d', $page, $processed)); // Check for conditions to finish the loop $reachedEndOfList = $set->count() < 1; $foundEnough = $result->count() >= $this->limit; $searchedEnough = ($processed >= $this->range); Log::debug(sprintf('reachedEndOfList: %s', var_export($reachedEndOfList, true))); Log::debug(sprintf('foundEnough: %s', var_export($foundEnough, true))); Log::debug(sprintf('searchedEnough: %s', var_export($searchedEnough, true))); } while (!$reachedEndOfList && !$foundEnough && !$searchedEnough); return $result; } }