feat:(LAR-89) add tracking for user

app/Http/Middleware/TrackLastActivity.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Middleware;
+
+use Carbon\Carbon;
+use Closure;
+use Illuminate\Http\Request;
+use Symfony\Component\HttpFoundation\Response;
+
+final class TrackLastActivity
+{
+    public function handle(Request $request, Closure $next): Response
+    {
+        if ($user = $request->user()) {
+            $lastActive = $user->last_active_at;
+
+            if (! $lastActive || $lastActive->diffInMinutes(Carbon::now()) >= 3) {
+                $user->update([
+                    'last_active_at' => now(),
+                ]);
+            }
+        }
+
+        return $next($request);
+    }
+}

app/Models/User.php

@@ -54,6 +54,7 @@
  * @property Carbon | null $banned_at
  * @property Carbon $created_at
  * @property Carbon $updated_at
+ * @property Carbon | null $last_active_at
  * @property Collection | Activity[] $activities
  * @property Collection | Article[] $articles
  * @property Collection | Thread[] $threads
@@ -96,20 +97,23 @@ final class User extends Authenticatable implements FilamentUser, HasAvatar, Has
         'banned_at',
         'banned_reason',
         'opt_in',
+        'last_active_at',
     ];
 
     protected $hidden = [
         'password',
         'remember_token',
         'two_factor_recovery_codes',
         'two_factor_secret',
+        'last_active_at',
     ];
 
     protected $casts = [
         'email_verified_at' => 'datetime',
         'last_login_at' => 'datetime',
         'banned_at' => 'datetime',
         'settings' => 'array',
+        'last_active_at' => 'datetime',
     ];
 
     public function hasProvider(string $provider): bool

bootstrap/app.php

@@ -20,6 +20,7 @@
         ]);
         $middleware->web(append: [
             LocaleMiddleware::class,
+            \App\Http\Middleware\TrackLastActivity::class,
         ]);
     })
     ->withExceptions(function (Exceptions $exceptions): void {

database/migrations/2024_12_19_234550_add_last_active_at_to_users_table.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::table('users', static function (Blueprint $table): void {
+            $table->timestamp('last_active_at')->nullable()->after('last_login_ip');
+        });
+    }
+};

tests/Feature/UserActivitiesTest.php

@@ -5,6 +5,7 @@
 use App\Models\Activity;
 use App\Models\Article;
 use Carbon\Carbon;
+use Illuminate\Support\Facades\Route;
 
 it('records activity when an article is created', function (): void {
     $user = $this->login();
@@ -39,3 +40,12 @@
         Carbon::now()->subWeek()->format('Y-m-d')
     ));
 });
+
+it('does not update the last activity for unauthenticated users', function (): void {
+    Route::middleware(\App\Http\Middleware\TrackLastActivity::class)
+        ->get('/activity-user', fn () => 'ok');
+
+    $this->get('/activity-user')->assertOk();
+
+    $this->assertDatabaseMissing('users', ['last_active_at' => now()]);
+});