Edit file

File name : Invoice.php

Content :

<?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\Entity;

use App\Export\Annotation as Exporter;
use App\Invoice\InvoiceModel;
use Doctrine\Common\Collections\ArrayCollection;
use Doctrine\Common\Collections\Collection;
use Doctrine\ORM\Mapping as ORM;
use JMS\Serializer\Annotation as Serializer;
use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
use Symfony\Component\Validator\Constraints as Assert;

/**
 * @ORM\Table(name="kimai2_invoices",
 *      uniqueConstraints={
 *          @ORM\UniqueConstraint(columns={"invoice_number"}),
 *          @ORM\UniqueConstraint(columns={"invoice_filename"})
 *      }
 * )
 * @ORM\Entity(repositoryClass="App\Repository\InvoiceRepository")
 * @UniqueEntity("invoiceNumber")
 * @UniqueEntity("invoiceFilename")
 *
 * @Exporter\Order({"id", "createdAt", "invoiceNumber", "status", "customer", "subtotal", "total", "tax", "currency", "vat", "dueDays", "dueDate", "paymentDate", "user", "invoiceFilename", "customerNumber", "comment"})
 * @Exporter\Expose("customer", label="label.customer", exp="object.getCustomer() === null ? null : object.getCustomer().getName()")
 * @Exporter\Expose("customerNumber", label="label.number", exp="object.getCustomer() === null ? null : object.getCustomer().getNumber()")
 * @Exporter\Expose("dueDate", label="invoice.due_days", type="datetime", exp="object.getDueDate() === null ? null : object.getDueDate()")
 * @Exporter\Expose("user", label="label.username", type="string", exp="object.getUser() === null ? null : object.getUser().getDisplayName()")
 * @Exporter\Expose("paymentDate", label="invoice.payment_date", type="date", exp="object.getPaymentDate() === null ? null : object.getPaymentDate()")
 */
class Invoice implements EntityWithMetaFields
{
    public const STATUS_PENDING = 'pending';
    public const STATUS_PAID = 'paid';
    public const STATUS_CANCELED = 'canceled';
    public const STATUS_NEW = 'new';

/**
     * @var int|null
     *
     * @Exporter\Expose(label="label.id", type="integer")
     *
     * @ORM\Column(name="id", type="integer")
     * @ORM\Id
     * @ORM\GeneratedValue(strategy="IDENTITY")
     */
    private $id;
    /**
     * @var string
     *
     * @Exporter\Expose(label="invoice.number", type="string")
     *
     * @ORM\Column(name="invoice_number", type="string", length=50, nullable=false)
     * @Assert\NotNull()
     */
    private $invoiceNumber;
    /**
     * @var string|null
     *
     * @Serializer\Expose()
     * @Serializer\Groups({"Customer_Entity"})
     *
     * @Exporter\Expose(label="label.comment")
     *
     * @ORM\Column(name="comment", type="text", nullable=true)
     */
    private $comment;
    /**
     * @var Customer
     *
     * @ORM\ManyToOne(targetEntity="App\Entity\Customer")
     * @ORM\JoinColumn(onDelete="CASCADE", nullable=false)
     * @Assert\NotNull()
     */
    private $customer;
    /**
     * @var User
     *
     * @ORM\ManyToOne(targetEntity="App\Entity\User")
     * @ORM\JoinColumn(onDelete="CASCADE", nullable=false)
     * @Assert\NotNull()
     */
    private $user;
    /**
     * @var \DateTime
     *
     * @Exporter\Expose(label="label.date", type="datetime")
     *
     * @ORM\Column(name="created_at", type="datetime", nullable=false)
     * @Assert\NotNull()
     */
    private $createdAt;
    /**
     * @var string
     *
     * @ORM\Column(name="timezone", type="string", length=64, nullable=false)
     */
    private $timezone;
    /**
     * @var float
     *
     * @Exporter\Expose(label="label.total_rate", type="float")
     *
     * @ORM\Column(name="total", type="float", nullable=false)
     * @Assert\NotNull()
     */
    private $total = 0.00;
    /**
     * @var float
     *
     * @Exporter\Expose(label="invoice.tax", type="float")
     *
     * @ORM\Column(name="tax", type="float", nullable=false)
     * @Assert\NotNull()
     */
    private $tax = 0.00;
    /**
     * @var string
     *
     * @Exporter\Expose(label="label.currency", type="string")
     *
     * @ORM\Column(name="currency", type="string", length=3, nullable=false)
     * @Assert\NotNull()
     * @Assert\Length(max=3)
     */
    private $currency;
    /**
     * @var int
     *
     * @Exporter\Expose(label="label.due_days", type="integer")
     *
     * @ORM\Column(name="due_days", type="integer", length=3, nullable=false)
     * @Assert\NotNull()
     * @Assert\Range(min = 0, max = 999)
     */
    private $dueDays = 30;
    /**
     * @var float
     *
     * @Exporter\Expose(label="label.tax_rate", type="float")
     *
     * @ORM\Column(name="vat", type="float", nullable=false)
     * @Assert\NotNull()
     * @Assert\Range(min = 0.0, max = 99.99)
     */
    private $vat = 0.00;
    /**
     * @var string
     *
     * @Exporter\Expose(label="label.status", type="string")
     *
     * @ORM\Column(name="status", type="string", length=20, nullable=false)
     * @Assert\NotNull()
     */
    private $status = self::STATUS_NEW;
    /**
     * @var string
     *
     * @Exporter\Expose(label="file", type="string")
     *
     * @ORM\Column(name="invoice_filename", type="string", length=150, nullable=false)
     * @Assert\NotNull()
     * @Assert\Length(min=1, max=150, allowEmptyString=false)
     */
    private $invoiceFilename;
    /**
     * @var bool
     */
    private $localized = false;
    /**
     * @var \DateTime|null
     *
     * @ORM\Column(name="payment_date", type="date", nullable=true)
     */
    private $paymentDate;
    /**
     * Meta fields
     *
     * All visible meta (custom) fields registered with this invoice
     *
     * @var InvoiceMeta[]|Collection
     *
     * @Serializer\Expose()
     * @Serializer\Groups({"Invoice"})
     * @Serializer\Type(name="array<App\Entity\InvoiceMeta>")
     * @Serializer\SerializedName("metaFields")
     * @Serializer\Accessor(getter="getVisibleMetaFields")
     *
     * @ORM\OneToMany(targetEntity="App\Entity\InvoiceMeta", mappedBy="invoice", cascade={"persist"})
     */
    private $meta;

public function __construct()
    {
        $this->meta = new ArrayCollection();
    }

public function getId(): ?int
    {
        return $this->id;
    }

public function getCustomer(): ?Customer
    {
        return $this->customer;
    }

public function getUser(): ?User
    {
        return $this->user;
    }

public function getInvoiceNumber(): ?string
    {
        return $this->invoiceNumber;
    }

public function getTotal(): float
    {
        return $this->total;
    }

public function getCreatedAt(): ?\DateTime
    {
        if (!$this->localized) {
            if (null !== $this->createdAt && null !== $this->timezone) {
                $this->createdAt->setTimeZone(new \DateTimeZone($this->timezone));
            }

$this->localized = true;
        }

return $this->createdAt;
    }

public function getDueDate(): ?\DateTime
    {
        if (null === $this->getCreatedAt()) {
            return null;
        }

$dueDate = clone $this->getCreatedAt();
        $dueDate->modify('+ ' . $this->dueDays . 'days');

return $dueDate;
    }

public function isOverdue(): bool
    {
        if (null === $this->getDueDate()) {
            return false;
        }

return $this->getDueDate()->getTimestamp() < (new \DateTime('now', new \DateTimeZone($this->timezone)))->getTimestamp();
    }

public function setFilename(string $filename): Invoice
    {
        $this->invoiceFilename = $filename;

return $this;
    }

public function setModel(InvoiceModel $model): Invoice
    {
        $this->customer = $model->getCustomer();
        $this->user = $model->getUser();
        $this->total = $model->getCalculator()->getTotal();
        $this->tax = $model->getCalculator()->getTax();
        $this->invoiceNumber = $model->getInvoiceNumber();
        $this->currency = $model->getCurrency();

$createdAt = $model->getInvoiceDate();
        $this->createdAt = $createdAt;
        $this->timezone = $createdAt->getTimezone()->getName();

$template = $model->getTemplate();
        $this->dueDays = $template->getDueDays();
        $this->vat = $template->getVat();

return $this;
    }

public function isNew(): bool
    {
        return $this->status === self::STATUS_NEW;
    }

public function setIsNew(): Invoice
    {
        $this->setPaymentDate(null);
        $this->status = self::STATUS_NEW;

return $this;
    }

public function isPending(): bool
    {
        return $this->status === self::STATUS_PENDING;
    }

public function setIsPending(): Invoice
    {
        $this->setPaymentDate(null);
        $this->status = self::STATUS_PENDING;

return $this;
    }

public function isPaid(): bool
    {
        return $this->status === self::STATUS_PAID;
    }

public function setIsPaid(): Invoice
    {
        $this->status = self::STATUS_PAID;

return $this;
    }

public function isCanceled(): bool
    {
        return $this->status === self::STATUS_CANCELED;
    }

public function getStatus(): string
    {
        return $this->status;
    }

public function setStatus(string $status): void
    {
        if (!\in_array($status, [self::STATUS_NEW, self::STATUS_PENDING, self::STATUS_PAID, self::STATUS_CANCELED])) {
            throw new \InvalidArgumentException('Unknown invoice status');
        }

$this->status = $status;
    }

public function setIsCanceled(): void
    {
        $this->status = self::STATUS_CANCELED;
    }

public function getDueDays(): int
    {
        return $this->dueDays;
    }

public function getVat(): float
    {
        return $this->vat;
    }

public function getTax(): float
    {
        return $this->tax;
    }

public function getCurrency(): ?string
    {
        return $this->currency;
    }

public function getInvoiceFilename(): ?string
    {
        return $this->invoiceFilename;
    }

/**
     * @Exporter\Expose(label="invoice.subtotal", type="float", name="subtotal")
     * @return float|null
     */
    public function getSubtotal(): ?float
    {
        return $this->total - $this->tax;
    }

public function getPaymentDate(): ?\DateTime
    {
        return $this->paymentDate;
    }

public function setPaymentDate(?\DateTime $paymentDate): Invoice
    {
        $this->paymentDate = $paymentDate;

return $this;
    }

public function setComment(?string $comment): void
    {
        $this->comment = $comment;
    }

public function getComment(): ?string
    {
        return $this->comment;
    }

/**
     * @return Collection|MetaTableTypeInterface[]
     */
    public function getMetaFields(): Collection
    {
        return $this->meta;
    }

/**
     * @return MetaTableTypeInterface[]
     */
    public function getVisibleMetaFields(): array
    {
        $all = [];
        foreach ($this->meta as $meta) {
            if ($meta->isVisible()) {
                $all[] = $meta;
            }
        }

return $all;
    }

public function getMetaField(string $name): ?MetaTableTypeInterface
    {
        foreach ($this->meta as $field) {
            if (strtolower($field->getName()) === strtolower($name)) {
                return $field;
            }
        }

return null;
    }

/**
     * @param string $name
     * @return bool|int|string|null
     */
    public function getMetaFieldValue(string $name)
    {
        $field = $this->getMetaField($name);
        if ($field === null) {
            return null;
        }

return $field->getValue();
    }

public function setMetaField(MetaTableTypeInterface $meta): EntityWithMetaFields
    {
        if (null === ($current = $this->getMetaField($meta->getName()))) {
            $meta->setEntity($this);
            $this->meta->add($meta);

return $this;
        }

$current->merge($meta);

return $this;
    }

public function __clone()
    {
        if ($this->id) {
            $this->id = null;
        }

$currentMeta = $this->meta;
        $this->meta = new ArrayCollection();
        /** @var InvoiceMeta $meta */
        foreach ($currentMeta as $meta) {
            $newMeta = clone $meta;
            $newMeta->setEntity($this);
            $this->setMetaField($newMeta);
        }
    }
}

TERMOREK-IT SHELL 403

Edit file