support custom fields for invoices (#3077)

src/Entity/InvoiceMeta.php

@@ -0,0 +1,59 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * 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\Entity;
+
+use Doctrine\ORM\Mapping as ORM;
+use JMS\Serializer\Annotation as Serializer;
+use Symfony\Component\Validator\Constraints as Assert;
+
+/**
+ * @ORM\Entity()
+ * @ORM\Table(name="kimai2_invoices_meta",
+ *      uniqueConstraints={
+ *          @ORM\UniqueConstraint(columns={"invoice_id", "name"})
+ *      }
+ * )
+ * @Serializer\ExclusionPolicy("all")
+ */
+class InvoiceMeta implements MetaTableTypeInterface
+{
+    use MetaTableTypeTrait;
+
+    /**
+     * @var Invoice
+     *
+     * @ORM\ManyToOne(targetEntity="App\Entity\Invoice", inversedBy="meta")
+     * @ORM\JoinColumn(onDelete="CASCADE", nullable=false)
+     * @Assert\NotNull()
+     */
+    private $invoice;
+
+    public function setEntity(EntityWithMetaFields $entity): MetaTableTypeInterface
+    {
+        if (!($entity instanceof Invoice)) {
+            throw new \InvalidArgumentException(
+                sprintf('Expected instanceof Invoice, received "%s"', \get_class($entity))
+            );
+        }
+        $this->invoice = $entity;
+
+        return $this;
+    }
+
+    /**
+     * @return Invoice|null
+     */
+    public function getEntity(): ?EntityWithMetaFields
+    {
+        return $this->invoice;
+    }
+}