added last seen

app/Services/CustomerPresenceService.php

@@ -0,0 +1,41 @@
+<?php
+
+namespace App\Services;
+
+use App\Models\Customer;
+use Illuminate\Support\Facades\Cache;
+
+/**
+ * Presence از اتصال SSE قیمت: تا وقتی استریم مشتری باز است last_seen_at لمس می‌شود.
+ * ادمین با آستانهٔ زمانی (مثلاً ۲ دقیقه) آنلاین بودن را می‌فهمد.
+ */
+class CustomerPresenceService
+{
+    public const TOUCH_THROTTLE_SECONDS = 30;
+
+    /** آستانهٔ آنلاین بودن در کلاینت ادمین هم باید هم‌تراز باشد (~۲ دقیقه). */
+    public const ONLINE_THRESHOLD_SECONDS = 120;
+
+    public function touch(int $customerId, bool $force = false): void
+    {
+        if ($customerId <= 0) {
+            return;
+        }
+
+        $key = 'customer_sse_presence:'.$customerId;
+        if (! $force && Cache::has($key)) {
+            return;
+        }
+
+        Cache::put($key, 1, self::TOUCH_THROTTLE_SECONDS);
+
+        try {
+            Customer::query()
+                ->where('id', $customerId)
+                ->update(['last_seen_at' => now()]);
+        } catch (\Throwable $e) {
+            // استریم قیمت نباید به‌خاطر presence بمیرد
+            report($e);
+        }
+    }
+}