first commit

2025-10-29 11:42:25 +01:00
commit 703f50a09d
4595 changed files with 385164 additions and 0 deletions
--- a/common/Database/Metrics/MetricDateRange.php
+++ b/common/Database/Metrics/MetricDateRange.php
@@ -0,0 +1,102 @@
+<?php
+
+namespace Common\Database\Metrics;
+
+use Carbon\CarbonImmutable;
+use Carbon\CarbonInterval;
+use Carbon\CarbonPeriod;
+
+class MetricDateRange
+{
+    const YEAR = 'year';
+    const MONTH = 'month';
+    const WEEK = 'week';
+    const DAY = 'day';
+    const HOUR = 'hour';
+    const MINUTE = 'minute';
+
+    public CarbonImmutable $start;
+    public CarbonImmutable $end;
+    public string $timezone;
+    public string $granularity;
+    public CarbonPeriod $period;
+
+    public function __construct(
+        string $start = null,
+        string $end = null,
+        string $timezone = null,
+        string $granularity = null,
+    ) {
+        $this->start = $start
+            ? CarbonImmutable::parse($start)->timezone($timezone)
+            : CarbonImmutable::today()->startOfWeek();
+        $this->end = $end
+            ? CarbonImmutable::parse($end)->timezone($timezone)
+            : CarbonImmutable::today()->endOfWeek();
+
+        $this->timezone = $timezone ?: config('app.timezone');
+        $this->setGranularity($granularity);
+
+        $this->period = CarbonPeriod::create(
+            $this->start,
+            $this->end,
+        );
+        $this->period->setDateInterval(
+            CarbonInterval::make(1, $this->granularity),
+        );
+    }
+
+    public function getPreviousPeriod(): self
+    {
+        return new self(
+            $this->start->sub($this->end->diffAsCarbonInterval($this->start)),
+            $this->start->subSecond(),
+        );
+    }
+
+    public function getCacheKey(): string
+    {
+        return sprintf(
+            '%s-%s-%s',
+            $this->start->timestamp,
+            $this->end->timestamp,
+            $this->timezone,
+        );
+    }
+
+    protected function setGranularity(string $granularity = null): void {
+        // set unit specified by user
+        if ($granularity) {
+            $this->granularity = $granularity;
+            // set the smallest supported unit based on start and end date
+        } else {
+            if ($this->start->diffInYears($this->end) >= 3) {
+                $this->granularity = self::YEAR;
+            } elseif ($this->start->diffInMonths($this->end) >= 4) {
+                $this->granularity = self::MONTH;
+            } elseif ($this->start->diffInDays($this->end) > 14) {
+                $this->granularity = self::WEEK;
+            } elseif ($this->start->diffInDays($this->end) > 1) {
+                $this->granularity = self::DAY;
+            } elseif ($this->start->diffInHours($this->end) > 1) {
+                $this->granularity = self::HOUR;
+            } else {
+                $this->granularity = self::MINUTE;
+            }
+        }
+    }
+
+    /**
+     * Return format by which metric values should be grouped based on granularity.
+     */
+    public function getGroupingFormat(): string {
+        return match ($this->granularity) {
+            $this::YEAR => 'Y',
+            $this::MONTH => 'Y-m',
+            $this::WEEK => 'o-W',
+            $this::DAY => 'Y-m-d',
+            $this::HOUR => 'Y-m-d H:00',
+            $this::MINUTE => 'Y-m-d H:i:00',
+        };
+    }
+}