Добавил базовые датасеты и агрегации для конструктора отчетов

2026-06-22 17:00:58 +09:00
parent 71bd4b9d1a
commit 5bad7599cf
16 changed files with 1453 additions and 0 deletions
--- a/app/Services/Analytics/Dimension.php
+++ b/app/Services/Analytics/Dimension.php
@@ -0,0 +1,56 @@
+<?php
+
+namespace App\Services\Analytics;
+
+use Closure;
+
+/**
+ * Измерение (группировка) отчёта: по чему группируем строки таблицы.
+ * Несёт SQL-выражение для SELECT/GROUP BY и опциональные join + резолвер подписей.
+ */
+readonly class Dimension
+{
+    /**
+     * @param  'string'|'date'  $type
+     * @param  string  $select  raw SQL-выражение, дающее сырое значение измерения
+     * @param  ?string  $groupBy  выражение для GROUP BY (по умолчанию = $select)
+     * @param  ?Closure  $applyJoin  fn(\Illuminate\Database\Query\Builder $q): void — добавить нужный JOIN
+     * @param  ?Closure  $labels  fn(array $rawValues): array<int|string,string> — карта «сырое значение => подпись»
+     */
+    public function __construct(
+        public string $key,
+        public string $label,
+        public string $type,
+        public string $select,
+        public ?string $groupBy = null,
+        public ?Closure $applyJoin = null,
+        public ?Closure $labels = null,
+    ) {}
+
+    public function groupByExpr(): string
+    {
+        return $this->groupBy ?? $this->select;
+    }
+
+    /**
+     * Подпись сырого значения для вывода в таблице.
+     *
+     * @param  array<int|string,string>|null  $labelMap
+     */
+    public function display(mixed $raw, ?array $labelMap = null): string
+    {
+        if ($raw === null || $raw === '') {
+            return '—';
+        }
+
+        if ($labelMap !== null && array_key_exists($raw, $labelMap)) {
+            return $labelMap[$raw];
+        }
+
+        if ($this->type === 'date') {
+            return \Illuminate\Support\Carbon::parse((string) $raw)->format('d.m.Y');
+        }
+
+        return (string) $raw;
+    }
+}