helper for handling billable fields (#1900)

src/Repository/Query/BillableInterface.php

@@ -0,0 +1,48 @@
+<?php
+
+/*
+ * This file is part of the Kimai time-tracking app.
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace App\Repository\Query;
+
+interface BillableInterface
+{
+    /**
+     * Returns the internal value (null = ignore billable, true = is billable, false = is not billable).
+     *
+     * @return bool|null
+     */
+    public function getBillable(): ?bool;
+
+    /**
+     * Returns true if the billable flag should be used and should match true.
+     *
+     * @return bool
+     */
+    public function isBillable(): bool;
+
+    /**
+     * Returns true if the billable flag should be used and should match false.
+     *
+     * @return bool
+     */
+    public function isNotBillable(): bool;
+
+    /**
+     * Returns true if the billable flag should NOT be used.
+     *
+     * @return bool
+     */
+    public function isIgnoreBillable(): bool;
+
+    /**
+     * Pas null if you want to ignore the billable flag.
+     *
+     * @param bool|null $isBillable
+     */
+    public function setBillable(?bool $isBillable): void;
+}