2016-01-13 18:34:56 +01:00
|
|
|
<?php
|
|
|
|
/**
|
|
|
|
* RuleRepositoryInterface.php
|
2017-10-21 08:40:00 +02:00
|
|
|
* Copyright (c) 2017 thegrumpydictator@gmail.com
|
2016-01-13 18:34:56 +01:00
|
|
|
*
|
2017-10-21 08:40:00 +02:00
|
|
|
* This file is part of Firefly III.
|
2016-10-05 06:52:15 +02:00
|
|
|
*
|
2017-10-21 08:40:00 +02:00
|
|
|
* 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
|
2017-12-17 14:44:05 +01:00
|
|
|
* along with Firefly III. If not, see <http://www.gnu.org/licenses/>.
|
2016-01-13 18:34:56 +01:00
|
|
|
*/
|
2017-04-09 07:44:22 +02:00
|
|
|
declare(strict_types=1);
|
2016-05-20 12:41:23 +02:00
|
|
|
|
2016-01-13 18:34:56 +01:00
|
|
|
namespace FireflyIII\Repositories\Rule;
|
|
|
|
|
2016-01-14 09:38:48 +01:00
|
|
|
use FireflyIII\Models\Rule;
|
2016-01-14 21:34:17 +01:00
|
|
|
use FireflyIII\Models\RuleAction;
|
2016-01-13 18:34:56 +01:00
|
|
|
use FireflyIII\Models\RuleGroup;
|
2016-01-14 21:34:17 +01:00
|
|
|
use FireflyIII\Models\RuleTrigger;
|
2017-01-30 16:40:49 +01:00
|
|
|
use FireflyIII\User;
|
2016-01-13 18:34:56 +01:00
|
|
|
|
|
|
|
/**
|
2017-11-15 12:25:49 +01:00
|
|
|
* Interface RuleRepositoryInterface.
|
2016-01-13 18:34:56 +01:00
|
|
|
*/
|
|
|
|
interface RuleRepositoryInterface
|
|
|
|
{
|
2016-01-24 16:50:55 +01:00
|
|
|
/**
|
|
|
|
* @return int
|
|
|
|
*/
|
2016-04-06 09:27:45 +02:00
|
|
|
public function count(): int;
|
2016-01-24 16:50:55 +01:00
|
|
|
|
2016-01-13 18:34:56 +01:00
|
|
|
/**
|
2016-01-15 11:27:27 +01:00
|
|
|
* @param Rule $rule
|
2016-01-13 21:44:26 +01:00
|
|
|
*
|
2016-01-14 21:34:17 +01:00
|
|
|
* @return bool
|
2016-01-13 21:44:26 +01:00
|
|
|
*/
|
2016-04-06 09:27:45 +02:00
|
|
|
public function destroy(Rule $rule): bool;
|
2016-01-13 21:44:26 +01:00
|
|
|
|
2017-09-03 15:57:13 +02:00
|
|
|
/**
|
|
|
|
* @param int $ruleId
|
|
|
|
*
|
|
|
|
* @return Rule
|
|
|
|
*/
|
|
|
|
public function find(int $ruleId): Rule;
|
|
|
|
|
2016-01-24 16:50:55 +01:00
|
|
|
/**
|
|
|
|
* @return RuleGroup
|
|
|
|
*/
|
2016-04-06 09:27:45 +02:00
|
|
|
public function getFirstRuleGroup(): RuleGroup;
|
2016-01-24 16:50:55 +01:00
|
|
|
|
2016-01-14 21:34:17 +01:00
|
|
|
/**
|
2016-01-15 11:27:27 +01:00
|
|
|
* @param RuleGroup $ruleGroup
|
2016-01-14 21:34:17 +01:00
|
|
|
*
|
2016-01-15 11:27:27 +01:00
|
|
|
* @return int
|
2016-01-14 21:34:17 +01:00
|
|
|
*/
|
2016-04-06 09:27:45 +02:00
|
|
|
public function getHighestOrderInRuleGroup(RuleGroup $ruleGroup): int;
|
2016-01-14 21:34:17 +01:00
|
|
|
|
2016-02-17 17:27:41 +01:00
|
|
|
/**
|
|
|
|
* @param Rule $rule
|
|
|
|
*
|
|
|
|
* @return string
|
|
|
|
*/
|
|
|
|
public function getPrimaryTrigger(Rule $rule): string;
|
|
|
|
|
2016-01-14 11:27:15 +01:00
|
|
|
/**
|
2016-01-20 15:23:36 +01:00
|
|
|
* @param Rule $rule
|
2016-01-15 13:13:33 +01:00
|
|
|
*
|
2016-01-14 11:27:15 +01:00
|
|
|
* @return bool
|
|
|
|
*/
|
2016-04-06 09:27:45 +02:00
|
|
|
public function moveDown(Rule $rule): bool;
|
2016-01-14 11:27:15 +01:00
|
|
|
|
2016-01-13 21:44:26 +01:00
|
|
|
/**
|
2016-01-20 15:23:36 +01:00
|
|
|
* @param Rule $rule
|
2016-01-15 13:13:33 +01:00
|
|
|
*
|
2016-01-14 09:38:48 +01:00
|
|
|
* @return bool
|
|
|
|
*/
|
2016-04-06 09:27:45 +02:00
|
|
|
public function moveUp(Rule $rule): bool;
|
2016-01-14 09:38:48 +01:00
|
|
|
|
|
|
|
/**
|
2016-01-20 15:23:36 +01:00
|
|
|
* @param Rule $rule
|
|
|
|
* @param array $ids
|
2016-01-15 13:13:33 +01:00
|
|
|
*
|
2016-01-14 09:38:48 +01:00
|
|
|
* @return bool
|
|
|
|
*/
|
2016-04-06 09:27:45 +02:00
|
|
|
public function reorderRuleActions(Rule $rule, array $ids): bool;
|
2016-01-14 09:38:48 +01:00
|
|
|
|
2016-01-15 09:25:32 +01:00
|
|
|
/**
|
|
|
|
* @param Rule $rule
|
2016-01-20 15:23:36 +01:00
|
|
|
* @param array $ids
|
2016-01-15 13:13:33 +01:00
|
|
|
*
|
2016-01-20 15:23:36 +01:00
|
|
|
* @return bool
|
2016-01-15 09:25:32 +01:00
|
|
|
*/
|
2016-04-06 09:27:45 +02:00
|
|
|
public function reorderRuleTriggers(Rule $rule, array $ids): bool;
|
2016-01-15 09:25:32 +01:00
|
|
|
|
2016-01-14 09:38:48 +01:00
|
|
|
/**
|
2016-01-20 15:23:36 +01:00
|
|
|
* @param RuleGroup $ruleGroup
|
2016-01-15 13:13:33 +01:00
|
|
|
*
|
2016-01-14 09:38:48 +01:00
|
|
|
* @return bool
|
|
|
|
*/
|
2016-04-06 09:27:45 +02:00
|
|
|
public function resetRulesInGroupOrder(RuleGroup $ruleGroup): bool;
|
2016-01-14 09:38:48 +01:00
|
|
|
|
2017-01-30 16:46:30 +01:00
|
|
|
/**
|
|
|
|
* @param User $user
|
|
|
|
*/
|
|
|
|
public function setUser(User $user);
|
|
|
|
|
2016-01-14 21:34:17 +01:00
|
|
|
/**
|
|
|
|
* @param array $data
|
|
|
|
*
|
|
|
|
* @return Rule
|
|
|
|
*/
|
2016-04-06 09:27:45 +02:00
|
|
|
public function store(array $data): Rule;
|
2016-01-14 21:34:17 +01:00
|
|
|
|
|
|
|
/**
|
2016-01-24 16:50:55 +01:00
|
|
|
* @param Rule $rule
|
2016-01-22 07:35:28 +01:00
|
|
|
* @param array $values
|
2016-01-14 21:34:17 +01:00
|
|
|
*
|
2016-01-20 15:23:36 +01:00
|
|
|
* @return RuleAction
|
2016-01-14 21:34:17 +01:00
|
|
|
*/
|
2016-04-06 09:27:45 +02:00
|
|
|
public function storeAction(Rule $rule, array $values): RuleAction;
|
2016-01-14 21:34:17 +01:00
|
|
|
|
|
|
|
/**
|
2016-01-24 16:50:55 +01:00
|
|
|
* @param Rule $rule
|
2016-01-22 07:35:28 +01:00
|
|
|
* @param array $values
|
2016-01-14 21:34:17 +01:00
|
|
|
*
|
2016-01-20 15:23:36 +01:00
|
|
|
* @return RuleTrigger
|
2016-01-14 21:34:17 +01:00
|
|
|
*/
|
2016-04-06 09:27:45 +02:00
|
|
|
public function storeTrigger(Rule $rule, array $values): RuleTrigger;
|
2016-01-20 15:23:36 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @param Rule $rule
|
|
|
|
* @param array $data
|
|
|
|
*
|
|
|
|
* @return Rule
|
|
|
|
*/
|
2016-04-06 09:27:45 +02:00
|
|
|
public function update(Rule $rule, array $data): Rule;
|
2016-01-22 07:35:28 +01:00
|
|
|
}
|