feat: bootstrap JOBcard CRM foundation

2026-09-01 18:54:47 +02:00
commit 480494c5ed
31 changed files with 1300 additions and 0 deletions
@@ -0,0 +1,39 @@
+<?php
+declare(strict_types=1);
+
+final class SlaReport
+{
+    /** @param list<array<string, mixed>> $agreements
+     *  @return list<array<string, mixed>>
+     */
+    public function rows(array $agreements): array
+    {
+        $rows = [];
+        foreach ($agreements as $agreement) {
+            $allocated = max(0.0, (float)($agreement['allocated_hours'] ?? 0));
+            $used = 0.0;
+            foreach ((array)($agreement['hours'] ?? []) as $hours) {
+                $used += max(0.0, (float)$hours);
+            }
+            $used = round($used, 2);
+            $remaining = round(max(0.0, $allocated - $used), 2);
+            $percentage = $allocated > 0
+                ? round(($used / $allocated) * 100, 2)
+                : ($used > 0 ? 100.0 : 0.0);
+            $status = $used > $allocated
+                ? 'exceeded'
+                : ($percentage >= 90 ? 'critical' : ($percentage >= 75 ? 'warning' : 'within_limit'));
+            $rows[] = [
+                'client_id' => (int)($agreement['client_id'] ?? 0),
+                'client_name' => (string)($agreement['client_name'] ?? ''),
+                'allocated_hours' => $allocated,
+                'used_hours' => $used,
+                'remaining_hours' => $remaining,
+                'usage_percentage' => $percentage,
+                'status' => $status,
+            ];
+        }
+        usort($rows, static fn (array $a, array $b): int => strcmp($a['client_name'], $b['client_name']) ?: $a['client_id'] <=> $b['client_id']);
+        return $rows;
+    }
+}