Die Modelle für die Ansichten wurden definiert, einschließlich der Tests.

.gitignore

@@ -104,7 +104,5 @@ Temporary Items
 /api/codeception.yml
 /api/vendor/
 /api/tests/_*
-/api/tests/acceptance
-/api/tests/functional
 /api/tests/*.suite.yml
 /api/html/swagger/

api/composer.json

@@ -18,7 +18,9 @@
     "require": {
         "slim/slim": "^4.7.1",
         "vlucas/phpdotenv": "^4.2",
-        "slim/psr7": "^1.3"
+        "slim/psr7": "^1.3",
+        "jetbrains/phpstorm-attributes": "^1.0.0",
+        "myclabs/php-enum": "^1.8.0"
     },
     "require-dev": {
         "phpstan/phpstan": "^0.12.80",

api/phpstan.neon

@@ -0,0 +1,5 @@
+parameters:
+	level: 6
+	paths:
+		- src
+		- tests/unit

api/src/Models/ModelInterface.php

@@ -0,0 +1,11 @@
+<?php
+
+
+namespace TorstenHettstedt\TimekeepingApi\Models;
+
+
+use JsonSerializable;
+
+interface ModelInterface extends JsonSerializable
+{
+}

api/src/Models/PeriodDesignationEnum.php

@@ -0,0 +1,23 @@
+<?php /** @noinspection PhpUnusedPrivateFieldInspection */
+
+
+namespace TorstenHettstedt\TimekeepingApi\Models;
+
+use MyCLabs\Enum\Enum;
+
+/**
+ * Enum-Klasse für die unterstützten Periode-Definitionen.
+ * Der Wert der Periode ist ein Format-String für {@link https://secure.php.net/manual/en/datetime.format.php}.
+ *
+ * @extends Enum<string>
+ *
+ * @method static PeriodDesignationEnum WEEKLY()
+ * @method static PeriodDesignationEnum MONTHLY()
+ * @method static PeriodDesignationEnum YEARLY()
+ */
+class PeriodDesignationEnum extends Enum
+{
+    private const WEEKLY = 'Y#W';
+    private const MONTHLY = 'Y-m';
+    private const YEARLY = 'Y';
+}

api/src/Models/WorkingHours.php

@@ -0,0 +1,65 @@
+<?php
+
+
+namespace TorstenHettstedt\TimekeepingApi\Models;
+
+
+use DateInterval;
+use DateTime;
+use JetBrains\PhpStorm\ArrayShape;
+
+class WorkingHours implements ModelInterface
+{
+    protected ?DateTime $workingDay = null;
+    protected ?DateInterval $workingTime = null;
+
+    /**
+     * @return DateTime|null
+     */
+    public function getWorkingDay(): ?DateTime
+    {
+        return $this->workingDay;
+    }
+
+    /**
+     * @param DateTime $workingDay
+     *
+     * @return WorkingHours
+     */
+    public function setWorkingDay(DateTime $workingDay): WorkingHours
+    {
+        $this->workingDay = $workingDay;
+        return $this;
+    }
+
+    /**
+     * @return DateInterval|null
+     */
+    public function getWorkingTime(): ?DateInterval
+    {
+        return $this->workingTime;
+    }
+
+    /**
+     * @param DateInterval $workingTime
+     *
+     * @return WorkingHours
+     */
+    public function setWorkingTime(DateInterval $workingTime): WorkingHours
+    {
+        $this->workingTime = $workingTime;
+        return $this;
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    #[ArrayShape(['workingDay' => "string", 'workingTime' => "string"])]
+    public function jsonSerialize(): array
+    {
+        return [
+            'workingDay' => $this->getWorkingDay()->format('Y-m-d'),
+            'workingTime' => $this->getWorkingTime()->format('%H:%I:%S')
+        ];
+    }
+}

api/src/Models/WorkingHoursView.php

@@ -0,0 +1,102 @@
+<?php
+
+
+namespace TorstenHettstedt\TimekeepingApi\Models;
+
+
+use DateInterval;
+use DateTimeInterface;
+use JetBrains\PhpStorm\ArrayShape;
+
+class WorkingHoursView implements ModelInterface
+{
+    protected DateTimeInterface $period;
+    protected PeriodDesignationEnum $periodDesignation;
+    protected int $workingDays;
+    protected DateInterval $totalHours;
+    protected DateInterval $overtime;
+
+    /**
+     * WorkingHoursView constructor.
+     *
+     * @param DateTimeInterface     $period
+     * @param PeriodDesignationEnum $periodDesignation
+     * @param int                   $workingDays
+     * @param DateInterval          $totalHours
+     * @param DateInterval          $overtime
+     */
+    public function __construct(
+        DateTimeInterface $period,
+        PeriodDesignationEnum $periodDesignation,
+        int $workingDays,
+        DateInterval $totalHours,
+        DateInterval $overtime
+    ) {
+        $this->period = $period;
+        $this->periodDesignation = $periodDesignation;
+        $this->workingDays = $workingDays;
+        $this->totalHours = $totalHours;
+        $this->overtime = $overtime;
+    }
+
+    /**
+     * @return DateTimeInterface
+     */
+    public function getPeriod(): DateTimeInterface
+    {
+        return $this->period;
+    }
+
+    /**
+     * @return PeriodDesignationEnum
+     */
+    public function getPeriodDesignation(): PeriodDesignationEnum
+    {
+        return $this->periodDesignation;
+    }
+
+    /**
+     * @return int
+     */
+    public function getWorkingDays(): int
+    {
+        return $this->workingDays;
+    }
+
+    /**
+     * @return DateInterval
+     */
+    public function getTotalHours(): DateInterval
+    {
+        return $this->totalHours;
+    }
+
+    /**
+     * @return DateInterval
+     */
+    public function getOvertime(): DateInterval
+    {
+        return $this->overtime;
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * @return array<string, mixed>
+     */
+    #[ArrayShape(['period'            => "string",
+                  'periodDesignation' => "string",
+                  'totalHours'        => "string",
+                  'workingDays'       => "int",
+                  'overtime'          => "string"
+    ])] public function jsonSerialize(): array
+    {
+        return [
+            'period'            => $this->getPeriod()->format($this->getPeriodDesignation()->getValue()),
+            'periodDesignation' => strtolower($this->getPeriodDesignation()->getKey()),
+            'workingDays'       => $this->getWorkingDays(),
+            'totalHours'        => $this->getTotalHours()->format('%H:%I:%S'),
+            'overtime'          => $this->getOvertime()->format('%H:%I:%S')
+        ];
+    }
+}

api/tests/unit/Models/WorkingHoursTest.php

@@ -0,0 +1,76 @@
+<?php
+
+namespace TorstenHettstedt\TimekeepingApi\Tests\Unit\Models;
+
+use Codeception\Test\Unit;
+use DateInterval;
+use DateTime;
+use Error;
+use TorstenHettstedt\TimekeepingApi\Models\WorkingHours;
+
+class WorkingHoursTest extends Unit
+{
+
+    public function testWorkingHoursWithoutContent(): void
+    {
+        $obj = new WorkingHours();
+        $this->assertNull($obj->getWorkingDay());
+        $this->assertNull($obj->getWorkingTime());
+
+        $this->expectException(Error::class);
+        $obj->jsonSerialize();
+    }
+
+    /**
+     * @return array[]
+     */
+    public function workingHoursProvider(): array
+    {
+        return [
+            [
+                new DateTime('2020-11-30'),
+                new DateInterval("PT8H"),
+                [
+                    'workingDay'  => '2020-11-30',
+                    'workingTime' => '08:00:00',
+                ],
+            ],
+            [
+                new DateTime('2021-05-03'),
+                new DateInterval("PT7H45M"),
+                [
+                    'workingDay'  => '2021-05-03',
+                    'workingTime' => '07:45:00',
+                ],
+            ],
+        ];
+    }
+
+    /**
+     * @param DateTime              $date
+     * @param DateInterval          $interval
+     * @param array<string, string> $should_json
+     *
+     * @dataProvider workingHoursProvider
+     */
+    public function testWorkingHoursWithContent(DateTime $date, DateInterval $interval, array $should_json): void
+    {
+
+        $obj = new WorkingHours();
+        $obj
+            ->setWorkingDay($date)
+            ->setWorkingTime($interval);
+
+        $this->assertNotNull($obj->getWorkingDay());
+        $this->assertInstanceOf(DateTime::class, $obj->getWorkingDay());
+        $this->assertEquals($date, $obj->getWorkingDay());
+
+        $this->assertNotNull($obj->getWorkingTime());
+        $this->assertInstanceOf(DateInterval::class, $obj->getWorkingTime());
+        $this->assertEquals($interval, $obj->getWorkingTime());
+
+        $json = $obj->jsonSerialize();
+        $this->assertIsArray($json);
+        $this->assertEquals($should_json, $json);
+    }
+}

api/tests/unit/Models/WorkingHoursViewTest.php

@@ -0,0 +1,113 @@
+<?php
+
+namespace TorstenHettstedt\TimekeepingApi\Tests\Unit\Models;
+
+use Codeception\Test\Unit;
+use DateInterval;
+use DateTime;
+use DateTimeInterface;
+use TorstenHettstedt\TimekeepingApi\Models\PeriodDesignationEnum;
+use TorstenHettstedt\TimekeepingApi\Models\WorkingHoursView;
+
+class WorkingHoursViewTest extends Unit
+{
+
+    /**
+     * @return array[]
+     */
+    public function workingHoursProvider(): array
+    {
+        return [
+            [
+                new DateTime('2020-11-30'),
+                PeriodDesignationEnum::WEEKLY(),
+                15,
+                new DateInterval("PT32H22M"),
+                new DateInterval("PT22M"),
+                [
+                    'period'            => '2020#49',
+                    'periodDesignation' => 'weekly',
+                    'workingDays'       => 15,
+                    'totalHours'        => '32:22:00',
+                    'overtime'          => '00:22:00'
+                ],
+            ],
+            [
+                new DateTime('2020-11-30'),
+                PeriodDesignationEnum::MONTHLY(),
+                15,
+                new DateInterval("PT32H22M"),
+                new DateInterval("PT22M"),
+                [
+                    'period'            => '2020-11',
+                    'periodDesignation' => 'monthly',
+                    'workingDays'       => 15,
+                    'totalHours'        => '32:22:00',
+                    'overtime'          => '00:22:00'
+                ],
+            ],
+            [
+                new DateTime('2020-11-30'),
+                PeriodDesignationEnum::YEARLY(),
+                15,
+                new DateInterval("PT32H22M"),
+                new DateInterval("PT22M"),
+                [
+                    'period'            => '2020',
+                    'periodDesignation' => 'yearly',
+                    'workingDays'       => 15,
+                    'totalHours'        => '32:22:00',
+                    'overtime'          => '00:22:00'
+                ],
+            ],
+        ];
+    }
+
+    /**
+     * @param DateTimeInterface          $period
+     * @param PeriodDesignationEnum      $periodDesignation
+     * @param int                        $workingDays
+     * @param DateInterval               $totalHours
+     * @param DateInterval               $overtime
+     * @param array<string, string>      $should_json
+     *
+     * @dataProvider workingHoursProvider
+     */
+    public function testWorkingHoursViewWithContent(
+        DateTimeInterface $period,
+        PeriodDesignationEnum $periodDesignation,
+        int $workingDays,
+        DateInterval $totalHours,
+        DateInterval $overtime,
+        array $should_json
+    ): void
+    {
+
+        $obj = new WorkingHoursView($period, $periodDesignation, $workingDays, $totalHours, $overtime);
+
+        $this->assertNotNull($obj->getPeriod());
+        $this->assertInstanceOf(DateTimeInterface::class, $obj->getPeriod());
+        $this->assertEquals($period, $obj->getPeriod());
+
+        $this->assertNotNull($obj->getPeriodDesignation());
+        $this->assertInstanceOf(PeriodDesignationEnum::class, $obj->getPeriodDesignation());
+        $this->assertEquals($periodDesignation, $obj->getPeriodDesignation());
+
+        $this->assertNotNull($obj->getWorkingDays());
+        $this->assertIsInt($obj->getWorkingDays());
+        $this->assertEquals($workingDays, $obj->getWorkingDays());
+
+        $this->assertNotNull($obj->getTotalHours());
+        $this->assertInstanceOf(DateInterval::class, $obj->getTotalHours());
+        $this->assertEquals($totalHours, $obj->getTotalHours());
+
+        $this->assertNotNull($obj->getOvertime());
+        $this->assertInstanceOf(DateInterval::class, $obj->getOvertime());
+        $this->assertEquals($overtime, $obj->getOvertime());
+
+
+        $json = $obj->jsonSerialize();
+        $this->assertIsArray($json);
+        $this->assertEquals($should_json, $json);
+    }
+}