added API for handling work contract times (#4016)

src/Entity/User.php

@@ -1133,4 +1133,114 @@ class User implements UserInterface, EquatableInterface, ThemeUserInterface, Pas
     {
         return new TotpConfiguration($this->totpSecret, TotpConfiguration::ALGORITHM_SHA1, 30, 6);
     }
+
+    public function getWorkHoursMonday(): int
+    {
+        return (int) $this->getPreferenceValue(UserPreference::WORK_HOURS_MONDAY, 0);
+    }
+
+    public function getWorkHoursTuesday(): int
+    {
+        return (int) $this->getPreferenceValue(UserPreference::WORK_HOURS_TUESDAY, 0);
+    }
+
+    public function getWorkHoursWednesday(): int
+    {
+        return (int) $this->getPreferenceValue(UserPreference::WORK_HOURS_WEDNESDAY, 0);
+    }
+
+    public function getWorkHoursThursday(): int
+    {
+        return (int) $this->getPreferenceValue(UserPreference::WORK_HOURS_THURSDAY, 0);
+    }
+
+    public function getWorkHoursFriday(): int
+    {
+        return (int) $this->getPreferenceValue(UserPreference::WORK_HOURS_FRIDAY, 0);
+    }
+
+    public function getWorkHoursSaturday(): int
+    {
+        return (int) $this->getPreferenceValue(UserPreference::WORK_HOURS_SATURDAY, 0);
+    }
+
+    public function getWorkHoursSunday(): int
+    {
+        return (int) $this->getPreferenceValue(UserPreference::WORK_HOURS_SUNDAY, 0);
+    }
+
+    public function getHolidaysPerYear(): int
+    {
+        return (int) $this->getPreferenceValue(UserPreference::HOLIDAYS_PER_YEAR, 0);
+    }
+
+    public function setWorkHoursMonday(int $seconds): void
+    {
+        $this->setPreferenceValue(UserPreference::WORK_HOURS_MONDAY, $seconds);
+    }
+
+    public function setWorkHoursTuesday(int $seconds): void
+    {
+        $this->setPreferenceValue(UserPreference::WORK_HOURS_TUESDAY, $seconds);
+    }
+
+    public function setWorkHoursWednesday(int $seconds): void
+    {
+        $this->setPreferenceValue(UserPreference::WORK_HOURS_WEDNESDAY, $seconds);
+    }
+
+    public function setWorkHoursThursday(int $seconds): void
+    {
+        $this->setPreferenceValue(UserPreference::WORK_HOURS_THURSDAY, $seconds);
+    }
+
+    public function setWorkHoursFriday(int $seconds): void
+    {
+        $this->setPreferenceValue(UserPreference::WORK_HOURS_FRIDAY, $seconds);
+    }
+
+    public function setWorkHoursSaturday(int $seconds): void
+    {
+        $this->setPreferenceValue(UserPreference::WORK_HOURS_SATURDAY, $seconds);
+    }
+
+    public function setWorkHoursSunday(int $seconds): void
+    {
+        $this->setPreferenceValue(UserPreference::WORK_HOURS_SUNDAY, $seconds);
+    }
+
+    public function setHolidaysPerYear(int $holidays): void
+    {
+        $this->setPreferenceValue(UserPreference::HOLIDAYS_PER_YEAR, $holidays);
+    }
+
+    public function hasContractSettings(): bool
+    {
+        return $this->hasWorkHourConfiguration() || $this->getHolidaysPerYear() !== 0;
+    }
+
+    public function hasWorkHourConfiguration(): bool
+    {
+        return $this->getWorkHoursMonday() !== 0 ||
+            $this->getWorkHoursTuesday() !== 0 ||
+            $this->getWorkHoursWednesday() !== 0 ||
+            $this->getWorkHoursThursday() !== 0 ||
+            $this->getWorkHoursFriday() !== 0 ||
+            $this->getWorkHoursSaturday() !== 0 ||
+            $this->getWorkHoursSunday() !== 0;
+    }
+
+    public function getWorkHoursForDay(\DateTimeInterface $dateTime): int
+    {
+        return match ($dateTime->format('N')) {
+            '1' => $this->getWorkHoursMonday(),
+            '2' => $this->getWorkHoursTuesday(),
+            '3' => $this->getWorkHoursWednesday(),
+            '4' => $this->getWorkHoursThursday(),
+            '5' => $this->getWorkHoursFriday(),
+            '6' => $this->getWorkHoursSaturday(),
+            '7' => $this->getWorkHoursSunday(),
+            default => throw new \Exception('Unknown day: ' . $dateTime->format('Y-m-d'))
+        };
+    }
 }

src/Entity/UserPreference.php

@@ -31,6 +31,14 @@ class UserPreference
     public const LOCALE = 'language';
     public const TIMEZONE = 'timezone';
     public const FIRST_WEEKDAY = 'first_weekday';
+    public const WORK_HOURS_MONDAY = 'work_monday';
+    public const WORK_HOURS_TUESDAY = 'work_tuesday';
+    public const WORK_HOURS_WEDNESDAY = 'work_wednesday';
+    public const WORK_HOURS_THURSDAY = 'work_thursday';
+    public const WORK_HOURS_FRIDAY = 'work_friday';
+    public const WORK_HOURS_SATURDAY = 'work_saturday';
+    public const WORK_HOURS_SUNDAY = 'work_sunday';
+    public const HOLIDAYS_PER_YEAR = 'holidays';
 
     #[ORM\Id]
     #[ORM\GeneratedValue]

src/Entity/WorkingTime.php

@@ -0,0 +1,113 @@
+<?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\Repository\WorkingTimeRepository;
+use Doctrine\ORM\Mapping as ORM;
+use JMS\Serializer\Annotation as Serializer;
+use Symfony\Component\Validator\Constraints as Assert;
+
+#[ORM\Table(name: 'kimai2_working_times')]
+#[ORM\UniqueConstraint(columns: ['user_id', 'date'])]
+#[ORM\Entity(repositoryClass: WorkingTimeRepository::class)]
+#[ORM\ChangeTrackingPolicy('DEFERRED_EXPLICIT')]
+#[Serializer\ExclusionPolicy('all')]
+class WorkingTime
+{
+    #[ORM\Id]
+    #[ORM\GeneratedValue]
+    #[ORM\Column(name: 'id', type: 'integer')]
+    private ?int $id = null;
+    #[ORM\ManyToOne(targetEntity: 'App\Entity\User')]
+    #[ORM\JoinColumn(nullable: false, onDelete: 'CASCADE')]
+    #[Assert\NotNull]
+    private ?User $user = null;
+    #[ORM\Column(name: 'date', type: 'date', nullable: false)]
+    #[Assert\NotNull]
+    private \DateTimeInterface $date;
+    #[ORM\Column(name: 'expected', type: 'integer', nullable: false)]
+    #[Assert\NotNull]
+    private int $expectedTime = 0;
+    #[ORM\Column(name: 'actual', type: 'integer', nullable: false)]
+    #[Assert\NotNull]
+    private int $actualTime = 0;
+    #[ORM\ManyToOne(targetEntity: 'App\Entity\User')]
+    #[ORM\JoinColumn(name: 'approved_by', nullable: true, onDelete: 'SET NULL')]
+    private ?User $approvedBy = null;
+    #[ORM\Column(name: 'approved_at', type: 'datetime', nullable: true)]
+    #[Assert\NotNull]
+    private ?\DateTimeInterface $approvedAt = null;
+
+    public function __construct(User $user, \DateTimeInterface $date)
+    {
+        $this->user = $user;
+        $this->date = $date;
+    }
+
+    public function getId(): ?int
+    {
+        return $this->id;
+    }
+
+    public function getUser(): ?User
+    {
+        return $this->user;
+    }
+
+    public function getDate(): \DateTimeInterface
+    {
+        return $this->date;
+    }
+
+    public function getExpectedTime(): int
+    {
+        return $this->expectedTime;
+    }
+
+    public function setExpectedTime(int $expectedTime): void
+    {
+        $this->expectedTime = $expectedTime;
+    }
+
+    public function getActualTime(): int
+    {
+        return $this->actualTime;
+    }
+
+    public function setActualTime(int $actualTime): void
+    {
+        $this->actualTime = $actualTime;
+    }
+
+    public function getApprovedBy(): ?User
+    {
+        return $this->approvedBy;
+    }
+
+    public function setApprovedBy(?User $approvedBy): void
+    {
+        $this->approvedBy = $approvedBy;
+    }
+
+    public function getApprovedAt(): ?\DateTimeInterface
+    {
+        return $this->approvedAt;
+    }
+
+    public function setApprovedAt(?\DateTimeInterface $approvedAt): void
+    {
+        $this->approvedAt = $approvedAt;
+    }
+
+    public function isApproved(): bool
+    {
+        return $this->approvedAt !== null;
+    }
+}