Merge branch 'develop' into feature/api-stats

Reviewed-on: https://gitea.fernandovideira.com/SyntaxSquad/DADProject/pulls/78
Reviewed-by: Afonso Clerigo Mendes de Sousa <[email protected]>
Reviewed-by: Edd <[email protected]>
Reviewed-by: KZix <[email protected]>

.gitignore

@@ -80,6 +80,7 @@ frontend/.env.*.local
 # Websockets: NodeJs (in websockets)
 # -------------------------
 /websockets/node_modules/
+/websockets/.env
 # -------------------------
 # Other useful ignores
 # -------------------------
@@ -99,3 +100,9 @@ Desktop.ini
 
 # If you have any local secrets or files not to track, add them here:
 # /path/to/some/file
+
+/frontend/package-lock.json
+/websockets/package-lock.json
+/api/package-lock.json
+
+.vscode

.vscode/settings.json

@@ -1,3 +0,0 @@
-{
-    "postman.settings.dotenv-detection-notification-visibility": false
-}

api/.gitignore

@@ -22,3 +22,5 @@
 Homestead.json
 Homestead.yaml
 Thumbs.db
+
+composer.lock

api/app/Http/Controllers/AuthController.php

@@ -2,11 +2,11 @@
 
 namespace App\Http\Controllers;
 
+use App\Http\Requests\RegisterRequest;
+use App\Models\User;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Auth;
 use Illuminate\Validation\ValidationException;
-use App\Models\User;
-use App\Http\Requests\RegisterRequest;
 
 class AuthController extends Controller
 {
@@ -24,6 +24,13 @@ class AuthController extends Controller
         }
 
         $user = Auth::user();
+
+        if ($user->blocked) {
+            Auth::logout();
+
+            return response()->json(['message' => 'Your account is blocked. Please contact support.'], 403);
+        }
+
         $token = $user->createToken('auth-token')->plainTextToken;
 
         return response()->json([
@@ -47,6 +54,10 @@ class AuthController extends Controller
             return response()->json(['message' => 'Email already registered'], 409);
         }
         
+        if (User::where('nickname', $request->nickname)->exists()) {
+            return response()->json(['message' => 'Nickname already registered'], 409);
+        }
+
         $user = User::create([
             'email' => $request->email,
             'nickname' => $request->nickname,

api/app/Http/Controllers/Controller.php

@@ -2,7 +2,10 @@
 
 namespace App\Http\Controllers;
 
-abstract class Controller
+use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
+use Illuminate\Routing\Controller as BaseController;
+
+abstract class Controller extends BaseController
 {
-    //
+    use AuthorizesRequests;
 }

api/app/Http/Controllers/GameController.php

@@ -10,129 +10,171 @@ use App\Models\MatchGame;
 
 class GameController extends Controller
 {
+    const GHOST_ID = 1;
+
     public function index(Request $request)
     {
-        $query = Game::query()->with(['winner', 'player1', 'player2']);
+        $this->authorize('viewAny', Game::class);
         
-        if ($request->has('type') && in_array($request->type, ['3', '9'])) {
-            $query->where('type', $request->type);
+        $user = Auth::user();
+        $query = Game::query()->with(["winner", "player1", "player2"]);
+        
+        // Filter games based on user type
+        if ($user->type !== 'A') {
+            // Players can only see games they participate in
+            $query->where(function ($q) use ($user) {
+                $q->where('player1_user_id', $user->id)
+                  ->orWhere('player2_user_id', $user->id);
+            });
+        }
+        // Admins see all games (no filter needed)
+
+        if ($request->has("type") && in_array($request->type, ["3", "9"])) {
+            $query->where("type", $request->type);
         }
 
-        if ($request->has('status') && in_array($request->status, ['Pending', 'Playing', 'Ended', 'Interrupted'])) {
-            $query->where('status', $request->status);
+        if (
+            $request->has("status") &&
+            in_array($request->status, [
+                "Pending",
+                "Playing",
+                "Ended",
+                "Interrupted",
+            ])
+        ) {
+            $query->where("status", $request->status);
         }
 
-        $query->orderBy('began_at', 'desc');
+         if ($request->has("sort_direction") && in_array($request->sort_direction, ["asc", "desc"])) {
+            $query->orderBy("began_at", $request->sort_direction);
+        }else{
+            $query->orderBy("began_at", "desc");
+        }
 
         return response()->json($query->paginate(15));
     }
 
     public function store(Request $request)
     {
+        $this->authorize('create', Game::class);
+        
         $validated = $request->validate([
-            'type' => 'required|in:3,9',
+            "type" => "required|in:3,9",
         ]);
 
         $user = Auth::user();
 
-        $activeMatch = MatchGame::where(function ($q) use ($user) {
-            $q->where('player1_user_id', $user->id)
-              ->orWhere('player2_user_id', $user->id);
-        })->whereIn('status', ['Pending', 'Playing'])->exists();
-
         $activeGame = Game::where(function ($q) use ($user) {
-            $q->where('player1_user_id', $user->id)
-              ->orWhere('player2_user_id', $user->id);
-        })->whereIn('status', ['Pending', 'Playing'])->exists();
+            $q->where("player1_user_id", $user->id)
+              ->orWhere("player2_user_id", $user->id);
+        })
+        ->whereIn("status", ["Pending", "Playing"])
+        ->exists();
 
-        if ($activeMatch || $activeGame) {
-            return response()->json(['message' => 'You already have an active game or match.'], 400);
+        if ($activeGame) {
+            return response()->json(["message" => "You already have an active game."], 400);
         }
 
         $game = Game::create([
-            'type' => $validated['type'],
-            'status' => 'Pending',
-            'player1_user_id' => $user->id,
-            'player2_user_id' => $user->id, 
-            'winner_user_id' => $user->id,  
-            'loser_user_id' => $user->id,   
-            'began_at' => now(),
-            'player1_points' => 0,
-            'player2_points' => 0,
-            'custom' => null
+            "type" => $validated["type"],
+            "status" => "Pending",
+            "player1_user_id" => $user->id,
+            "player2_user_id" => self::GHOST_ID, 
+            "winner_user_id" => self::GHOST_ID,
+            "loser_user_id" => self::GHOST_ID,
+            "began_at" => now(),
+            "player1_points" => 0,
+            "player2_points" => 0,
+            "custom" => null,
         ]);
 
         return response()->json([
-            'message' => 'Multiplayer game room created',
-            'game' => $game
+            "message" => "Multiplayer game room created",
+            "game" => $game,
         ], 201);
     }
 
     public function join(Game $game)
     {
+        $this->authorize('join', $game);
+        
         $user = Auth::user();
 
         if ($game->player1_user_id == $user->id) {
             return response()->json([
-                'message' => 'Waiting for opponent...',
-                'game' => $game
+                "message" => "You are the host. Waiting for opponent...",
+                "game" => $game
             ], 200);
         }
 
-        if ($game->status !== 'Pending') {
-            return response()->json(['message' => 'Game is full or already started'], 400);
-        }
-
-        $activeGame = Game::where(function ($query) use ($user) {
-            $query->where('player1_user_id', $user->id)
-                  ->orWhere('player2_user_id', $user->id);
-        })
-        ->whereIn('status', ['Pending', 'Playing'])
-        ->exists();
-
-        if ($activeGame) {
-            return response()->json(['message' => 'You are already in another active game.'], 400);
+        if ($game->player2_user_id !== self::GHOST_ID) {
+            return response()->json(["message" => "Game is full"], 400);
         }
 
         $game->update([
-            'status' => 'Playing',
-            'player2_user_id' => $user->id,
+            "status" => "Playing",
+            "player2_user_id" => $user->id,
         ]);
 
         return response()->json([
-            'message' => 'Joined successfully! Game starts now.',
-            'game' => $game
+            "message" => "Joined successfully!",
+            "game" => $game,
         ], 200);
     }
 
     public function show(Game $game)
     {
-        $game->load(['player1', 'player2', 'winner']);
+        $this->authorize('view', $game);
+        
+        $game->load(["player1", "player2", "winner"]);
         return response()->json($game);
     }
 
     public function update(Request $request, Game $game)
     {
-        if ($game->status == 'Ended') {
-            return response()->json(['message' => 'Game already ended'], 400);
+        $this->authorize('update', $game);
+        
+        if ($game->status == "Ended") {
+            return response()->json(["message" => "Game already ended"], 400);
         }
 
         $data = $request->validate([
-            'status' => 'in:Playing,Ended,Interrupted',
-            'winner_user_id' => 'exists:users,id', 
-            'loser_user_id' => 'exists:users,id',
-            'player1_points' => 'integer',
-            'player2_points' => 'integer',
-            'is_draw' => 'boolean',
-            'total_time' => 'numeric'
+            "status" => "in:Playing,Ended,Interrupted",
+            "winner_user_id" => "exists:users,id",
+            "loser_user_id" => "exists:users,id",
+            "player1_points" => "integer",
+            "player2_points" => "integer",
+            "is_draw" => "boolean",
+            "total_time" => "numeric",
         ]);
 
-        if (isset($data['status']) && $data['status'] === 'Ended') {
-            $data['ended_at'] = now();
+        if (isset($data["status"]) && $data["status"] === "Ended") {
+            $data["ended_at"] = now();
         }
 
         $game->update($data);
 
         return response()->json($game);
     }
+
+    public function resign(Game $game)
+    {
+        $this->authorize('resign', $game);
+        
+        $user = Auth::user();
+        
+        $game->update([
+            'status' => 'Ended',
+            'winner_user_id' => $game->player1_user_id === $user->id 
+                ? $game->player2_user_id 
+                : $game->player1_user_id,
+            'loser_user_id' => $user->id,
+            'ended_at' => now(),
+        ]);
+
+        return response()->json([
+            'message' => 'You have resigned from the game',
+            'game' => $game->fresh(),
+        ]);
+    }
 }

api/app/Http/Controllers/ProfileController.php

@@ -0,0 +1,113 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use Illuminate\Http\Request;
+use App\Models\User;
+use Illuminate\Support\Facades\Auth;
+use Illuminate\Support\Facades\Hash;
+use Illuminate\Support\Facades\Storage;
+use Illuminate\Support\Str;
+
+
+class ProfileController extends Controller
+{
+    public function show(Request $request)
+    {
+        $user = $request->user();
+
+        return response()->json($user);
+    }
+
+    public function update(Request $request)
+    {
+        $request->validate([
+            "name" => "required|string|max:255",
+            "nickname" =>
+                "required|string|max:255|unique:users,nickname," .
+                $request->user()->id,
+        ]);
+
+        $user = $request->user();
+        $user->name = $request->name;
+        $user->nickname = $request->nickname;
+        $user->save();
+
+        return response()->json($user);
+    }
+
+    public function destroy(User $user)
+    {
+        $currentUser = Auth::user();
+
+        if ($currentUser->id !== $user->id && $currentUser->type !== "A") {
+            return response()->json(["message" => "Unauthorized"], 403);
+        }
+
+        $user->delete();
+
+        return response()->json(["message" => "User deleted successfully"]);
+    }
+
+    public function updatePassword(Request $request)
+    {
+        $request->validate([
+            "current_password" => "required",
+            "new_password" => "required|min:8|confirmed",
+        ]);
+
+        $user = $request->user();
+
+        if (!Hash::check($request->current_password, $user->password)) {
+            return response()->json(
+                [
+                    "message" => "Current password is incorrect",
+                ],
+                422,
+            );
+        }
+
+        $user->password = Hash::make($request->new_password);
+        $user->save();
+
+        return response()->json([
+            "message" => "Password changed successfully",
+        ]);
+    }
+
+    public function getCoins(Request $request)
+    {
+        return response()->json([
+            'coins' => $request->user()->coins_balance
+        ]);
+    }
+
+    public function updateAvatar(Request $request)
+    {
+        $request->validate([
+            "avatar" => "required|image|mimes:jpeg,png,jpg,gif|max:2048",
+        ]);
+
+        $user = $request->user();
+
+        if ($user->photo_avatar_filename) {
+            Storage::disk("public")->delete(
+                "photos_avatars/" . $user->photo_avatar_filename,
+            );
+        }
+
+        $file = $request->file("avatar");
+        $filename =
+            str_pad($user->id, 5, "0", STR_PAD_LEFT) .
+            "_" .
+            Str::random(10) .
+            "." .
+            $file->extension();
+        $file->storeAs("photos_avatars", $filename, "public");
+
+        $user->photo_avatar_filename = $filename;
+        $user->save();
+
+        return response()->json($user);
+    }
+}

api/app/Http/Controllers/StatisticsController.php

@@ -0,0 +1,76 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+use App\Models\Game;
+use App\Models\User;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\DB;
+
+class StatisticsController extends Controller
+{
+    public function getPublicStats()
+    {
+        $totalPlayers = User::where('type', 'P')->count();
+
+        $totalGames = Game::where('status', 'Ended')->count();
+        $activeGames = Game::where('status', 'Playing')->count();
+
+        return response()->json([
+            'total_players' => $totalPlayers,
+            'total_games' => $totalGames,
+            'active_games' => $activeGames,
+        ]);
+    }
+
+    public function getLeaderboard(Request $request)
+    {
+        $type = $request->query('type');
+
+        $query = User::where('type', 'P')
+            ->withCount(['wonGames' => function ($query) use ($type) {
+                if ($type) {
+                    $query->where('type', $type);
+                }
+            }])
+            ->orderBy('won_games_count', 'desc')
+            ->take(10);
+
+        $leaderboard = $query->get(['id', 'nickname', 'photo_avatar_filename']);
+
+        return response()->json($leaderboard);
+    }
+
+    public function getPersonalStats(Request $request)
+    {
+        $user = $request->user();
+
+        $totalGames = Game::where('status', 'Ended')
+            ->where(function ($q) use ($user) {
+                $q->where('player1_user_id', $user->id)
+                  ->orWhere('player2_user_id', $user->id);
+            })
+            ->count();
+
+        $totalWins = Game::where('status', 'Ended')
+            ->where('winner_user_id', $user->id)
+            ->count();
+
+        $totalLosses = $totalGames - $totalWins; // Simplest math
+
+        $winRate = 0;
+        if ($totalGames > 0) {
+            $winRate = round(($totalWins / $totalGames) * 100, 1);
+        }
+
+        return response()->json([
+            'nickname' => $user->nickname,
+            'total_games' => $totalGames,
+            'total_wins' => $totalWins,
+            'total_losses' => $totalLosses,
+            'win_rate' => $winRate . '%',
+            'current_balance' => $user->coins_balance, // Extra info
+        ]);
+    }
+}

api/app/Http/Controllers/UserController.php

@@ -2,8 +2,8 @@
 
 namespace App\Http\Controllers;
 
-use App\Models\User;
 use App\Models\Game;
+use App\Models\User;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Auth;
 use Illuminate\Support\Facades\Hash;
@@ -17,9 +17,7 @@ class UserController extends Controller
      */
     public function index(Request $request)
     {
-        if ($request->user()->type !== 'A') {
-            return response()->json(['message' => 'Unauthorized'], 403);
-        }
+        $this->authorize('viewAny', User::class);
 
         $query = User::query();
 
@@ -27,15 +25,41 @@ class UserController extends Controller
         if ($request->has('type')) {
             $query->where('type', $request->type);
         }
+
         if ($request->has('search')) {
-            $query->where('name', 'like', '%' . $request->search . '%')
+            $query->where(function ($q) use ($request) {
+                $q->where('name', 'like', '%'.$request->search.'%')
                     ->orWhere('email', 'like', '%'.$request->search.'%')
                     ->orWhere('nickname', 'like', '%'.$request->search.'%');
+            });
         }
 
         return response()->json($query->paginate(15));
     }
 
+    /**
+     * POST /api/users
+     * Registar um novo utilizador (Admin only)
+     */
+    public function store(Request $request)
+    {
+        $this->authorize('create', User::class);
+
+        $validated = $request->validate([
+            'name' => 'required|string|max:255',
+            'nickname' => 'required|string|max:20|unique:users,nickname',
+            'email' => 'required|email|unique:users,email',
+            'password' => 'required|string|min:3',
+            'type' => 'required|in:A,U',
+        ]);
+
+        $validated['password'] = Hash::make($validated['password']);
+
+        $user = User::create($validated);
+
+        return response()->json($user, 201);
+    }
+
     /**
      * GET /api/users/me
      * Retorna o perfil do utilizador autenticado atual.
@@ -53,17 +77,19 @@ class UserController extends Controller
     public function show(User $user)
     {
         $currentUser = Auth::user();
-        if ($currentUser->id !== $user->id && $currentUser->type !== 'A') {
+
+        // Admins and owners get full profile, others get limited view
+        if ($currentUser->type === 'A' || $currentUser->id === $user->id) {
+            return response()->json($user);
+        } else {
             return response()->json([
                 'id' => $user->id,
                 'name' => $user->name,
                 'nickname' => $user->nickname,
                 'photo_avatar_filename' => $user->photo_avatar_filename,
-                'type' => $user->type
+                'type' => $user->type,
             ]);
         }
-
-        return response()->json($user);
     }
 
     /**
@@ -72,24 +98,24 @@ class UserController extends Controller
      */
     public function update(Request $request, User $user)
     {
-        $currentUser = Auth::user();
-
-        if ($currentUser->id !== $user->id && $currentUser->type !== 'A') {
-            return response()->json(['message' => 'Unauthorized'], 403);
-        }
+        $this->authorize('update', $user);
         
         $validated = $request->validate([
             'name' => 'sometimes|string|max:255',
-            'nickname' => ['sometimes', 'string', 'max:20', Rule::unique('users')->ignore($user->id)],
-            'email' => ['sometimes', 'email', Rule::unique('users')->ignore($user->id)],
+            'nickname' => [
+                'sometimes',
+                'string',
+                'max:20',
+                Rule::unique('users')->ignore($user->id),
+            ],
+            'email' => [
+                'sometimes',
+                'email',
+                Rule::unique('users')->ignore($user->id),
+            ],
             'password' => 'sometimes|string|min:3',
-            'blocked' => 'sometimes|boolean',
         ]);
 
-        if (isset($validated['blocked']) && $currentUser->type !== 'A') {
-            return response()->json(['message' => 'Only admins can block users'], 403);
-        }
-
         // Lógica de Upload de Foto (Exemplo Básico)
         // if ($request->hasFile('photo_avatar')) {
         //     $path = $request->file('photo_avatar')->store('avatars', 'public');
@@ -107,21 +133,24 @@ class UserController extends Controller
      */
     public function destroy(User $user)
     {
-        $currentUser = Auth::user();
+        $this->authorize('delete', $user);
 
-        if ($currentUser->id !== $user->id && $currentUser->type !== 'A') {
-            return response()->json(['message' => 'Unauthorized'], 403);
+        // Check if user has transactions or games - if so, soft delete
+        $hasTransactions = $user->transactions()->exists();
+        $hasGames = Game::where(function ($q) use ($user) {
+            $q->where('player1_user_id', $user->id)
+                ->orWhere('player2_user_id', $user->id);
+        })->exists();
+
+        if ($hasTransactions || $hasGames) {
+            $user->delete(); // Soft delete
+            $message = 'User account deactivated (soft-deleted due to transaction/game history)';
+        } else {
+            $user->forceDelete(); // Hard delete
+            $message = 'User permanently deleted';
         }
 
-        if ($currentUser->id === $user->id && $currentUser->type === 'A') {
-             if ($user->type === 'A') {
-                return response()->json(['message' => 'Admins cannot delete their own account'], 403);
-             }
-        }
-
-        $user->delete();
-
-        return response()->json(['message' => 'User deleted successfully']);
+        return response()->json(['message' => $message]);
     }
 
     /**
@@ -130,16 +159,14 @@ class UserController extends Controller
      */
     public function getMatches(Request $request, User $user)
     {
-        $currentUser = Auth::user();
-
-        if ($currentUser->id !== $user->id && $currentUser->type !== 'A') {
-            return response()->json(['message' => 'Unauthorized'], 403);
-        }
+        $this->authorize('view', $user);
 
         $matches = Game::query()
             ->where(function ($q) use ($user) {
-                $q->where('player1_user_id', $user->id)
-                  ->orWhere('player2_user_id', $user->id);
+                $q->where('player1_user_id', $user->id)->orWhere(
+                    'player2_user_id',
+                    $user->id,
+                );
             })
             ->with(['winner', 'player1', 'player2'])
             ->orderBy('began_at', 'desc')
@@ -147,4 +174,27 @@ class UserController extends Controller
 
         return response()->json($matches);
     }
+
+    public function block(User $user)
+    {
+        $this->authorize('block', $user);
+
+        $user->blocked = true;
+        $user->save();
+
+        // Revoke all active tokens for immediate effect
+        $user->tokens()->delete();
+
+        return response()->json(['message' => 'User blocked successfully']);
+    }
+
+    public function unblock(User $user)
+    {
+        $this->authorize('unblock', $user);
+
+        $user->blocked = false;
+        $user->save();
+
+        return response()->json(['message' => 'User unblocked successfully']);
+    }
 }

api/app/Http/Middleware/CheckUserType.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace App\Http\Middleware;
+
+use Closure;
+use Illuminate\Http\Request;
+use Symfony\Component\HttpFoundation\Response;
+
+class CheckUserType
+{
+    /**
+     * Handle an incoming request.
+     *
+     * @param  \Closure(\Illuminate\Http\Request): (\Symfony\Component\HttpFoundation\Response)  $next
+     */
+    public function handle(
+        Request $request,
+        Closure $next,
+        string $type,
+    ): Response {
+        $user = $request->user();
+
+        if (!$user || $user->type !== $type) {
+            return response()->json(
+                ["message" => "Unauthorized. User type {$type} required."],
+                403,
+            );
+        }
+
+        return $next($request);
+    }
+}

api/app/Models/User.php

@@ -2,7 +2,6 @@
 
 namespace App\Models;
 
-// use Illuminate\Contracts\Auth\MustVerifyEmail;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\SoftDeletes;
 use Illuminate\Foundation\Auth\User as Authenticatable;
@@ -11,30 +10,27 @@ use Laravel\Sanctum\HasApiTokens;
 
 class User extends Authenticatable
 {
-    /** @use HasFactory<\Database\Factories\UserFactory> */
-    use HasFactory, Notifiable, HasApiTokens, SoftDeletes;
+    use HasApiTokens, HasFactory, Notifiable, SoftDeletes;
 
     /**
      * The attributes that are mass assignable.
      *
-     * @var list<string>
+     * @var array<int, string>
      */
     protected $fillable = [
         'name',
         'email',
         'password',
         'nickname',
-        'photo_avatar_filename',
         'type',
-        'blocked',
+        'photo_avatar_filename',
         'coins_balance',
-        'custom',
     ];
 
     /**
      * The attributes that should be hidden for serialization.
      *
-     * @var list<string>
+     * @var array<int, string>
      */
     protected $hidden = [
         'password',
@@ -42,16 +38,24 @@ class User extends Authenticatable
     ];
 
     /**
-     * Get the attributes that should be cast.
+     * The attributes that should be cast.
      *
-     * @return array<string, string>
+     * @var array<string, string>
      */
-    protected function casts(): array
-    {
-        return [
+    protected $casts = [
         'email_verified_at' => 'datetime',
         'password' => 'hashed',
         'blocked' => 'boolean',
+        'deleted_at' => 'datetime',
     ];
+
+    public function wonGames()
+    {
+        return $this->hasMany(Game::class, 'winner_user_id');
+    }
+
+    public function games()
+    {
+        return $this->hasMany(Game::class, 'player1_user_id')->orWhere('player2_user_id', $this->id);
     }
 }

api/app/Policies/GamePolicy.php

@@ -0,0 +1,126 @@
+<?php
+
+namespace App\Policies;
+
+use App\Models\Game;
+use App\Models\User;
+
+class GamePolicy
+{
+    /**
+     * Determine whether the user can view any models.
+     */
+    public function viewAny(User $user): bool
+    {
+        return true;
+    }
+
+    /**2
+     * Determine whether the user can view the model.
+     */
+    public function view(User $user, Game $game): bool
+    {
+        if ($user->type === 'A') {
+            return true;
+        }
+
+        if (
+            $game->player1_user_id === $user->id ||
+            $game->player2_user_id === $user->id
+        ) {
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * Determine whether the user can create models.
+     */
+    public function create(User $user): bool
+    {
+        if ($user->type === 'A') {
+            return false;
+        }
+
+        return true;
+    }
+
+    public function join(User $user, Game $game): bool
+    {
+        if ($user->type === 'A') {
+            return false;
+        }
+
+        if (
+            $game->status !== 'waiting' ||
+            $game->player1_user_id === $user->id
+        ) {
+            return false;
+        }
+
+        return true;
+    }
+
+    public function resign(User $user, Game $game): bool
+    {
+        if ($user->type === 'A') {
+            return false;
+        }
+
+        if (
+            $game->status !== 'ongoing' ||
+            ($game->player1_user_id !== $user->id &&
+                $game->player2_user_id !== $user->id)
+        ) {
+            return false;
+        }
+
+        return true;
+    }
+
+    /**
+     * Determine whether the user can update the model.
+     */
+    public function update(User $user, Game $game): bool
+    {
+        if ($user->type === 'A') {
+            return false;
+        }
+
+        if (
+            $game->status !== 'ongoing' ||
+            ($game->player1_user_id !== $user->id &&
+                $game->player2_user_id !== $user->id)
+        ) {
+            return false;
+        }
+
+        return true;
+    }
+
+    /**
+     * Determine whether the user can delete the model.
+     */
+    public function delete(User $user, Game $game): bool
+    {
+        // Only admins can delete games
+        return $user->type === 'A';
+    }
+
+    /**
+     * Determine whether the user can restore the model.
+     */
+    public function restore(User $user, Game $game): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can permanently delete the model.
+     */
+    public function forceDelete(User $user, Game $game): bool
+    {
+        return false;
+    }
+}

api/app/Policies/UserPolicy.php

@@ -0,0 +1,74 @@
+<?php
+
+namespace App\Policies;
+
+use App\Models\User;
+
+class UserPolicy
+{
+    /**
+     * Determine whether the user can view any models.
+     */
+    public function viewAny(User $user): bool
+    {
+        return $user->type === 'A';
+    }
+
+    /**
+     * Determine whether the user can view the model.
+     */
+    public function view(User $user, User $model): bool
+    {
+        return $user->id === $model->id || $user->type === 'A';
+    }
+
+    /**
+     * Determine whether the user can create models.
+     */
+    public function create(User $user): bool
+    {
+        return $user->type === 'A';
+    }
+
+    /**
+     * Determine whether the user can update the model.
+     */
+    public function update(User $user, User $model): bool
+    {
+        return $user->id === $model->id;
+    }
+
+    /**
+     * Determine whether the user can delete the model.
+     */
+    public function delete(User $user, User $model): bool
+    {
+        return ($user->type === 'A' && $user->id !== $model->id) || ($user->type === 'P' && $user->id === $model->id);
+    }
+
+    public function block(User $user, User $model): bool
+    {
+        return $user->type === 'A' && $user->id !== $model->id && $model->type === 'P';
+    }
+
+    public function unblock(User $user, User $model): bool
+    {
+        return $user->type === 'A' && $user->id !== $model->id && $model->type === 'P';
+    }
+
+    /**
+     * Determine whether the user can restore the model.
+     */
+    public function restore(User $user, User $model): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can permanently delete the model.
+     */
+    public function forceDelete(User $user, User $model): bool
+    {
+        return false;
+    }
+}

api/bootstrap/app.php

@@ -6,14 +6,17 @@ use Illuminate\Foundation\Configuration\Middleware;
 
 return Application::configure(basePath: dirname(__DIR__))
     ->withRouting(
-        web: __DIR__.'/../routes/web.php',
-        api: __DIR__.'/../routes/api.php',
-        commands: __DIR__.'/../routes/console.php',
-        health: '/up',
+        web: __DIR__ . "/../routes/web.php",
+        api: __DIR__ . "/../routes/api.php",
+        commands: __DIR__ . "/../routes/console.php",
+        health: "/up",
     )
     ->withMiddleware(function (Middleware $middleware): void {
-        //
+        $middleware->alias([
+            "user.type" => App\Http\Middleware\CheckUserType::class,
+        ]);
     })
     ->withExceptions(function (Exceptions $exceptions): void {
         //
-    })->create();
+    })
+    ->create();

api/bootstrap/cache/services.php

@@ -102,12 +102,15 @@
     'Illuminate\\Queue\\Console\\ForgetFailedCommand' => 'Illuminate\\Foundation\\Providers\\ConsoleSupportServiceProvider',
     'Illuminate\\Queue\\Console\\ListenCommand' => 'Illuminate\\Foundation\\Providers\\ConsoleSupportServiceProvider',
     'Illuminate\\Queue\\Console\\MonitorCommand' => 'Illuminate\\Foundation\\Providers\\ConsoleSupportServiceProvider',
+    'Illuminate\\Queue\\Console\\PauseCommand' => 'Illuminate\\Foundation\\Providers\\ConsoleSupportServiceProvider',
     'Illuminate\\Queue\\Console\\PruneBatchesCommand' => 'Illuminate\\Foundation\\Providers\\ConsoleSupportServiceProvider',
     'Illuminate\\Queue\\Console\\PruneFailedJobsCommand' => 'Illuminate\\Foundation\\Providers\\ConsoleSupportServiceProvider',
     'Illuminate\\Queue\\Console\\RestartCommand' => 'Illuminate\\Foundation\\Providers\\ConsoleSupportServiceProvider',
+    'Illuminate\\Queue\\Console\\ResumeCommand' => 'Illuminate\\Foundation\\Providers\\ConsoleSupportServiceProvider',
     'Illuminate\\Queue\\Console\\RetryCommand' => 'Illuminate\\Foundation\\Providers\\ConsoleSupportServiceProvider',
     'Illuminate\\Queue\\Console\\RetryBatchCommand' => 'Illuminate\\Foundation\\Providers\\ConsoleSupportServiceProvider',
     'Illuminate\\Queue\\Console\\WorkCommand' => 'Illuminate\\Foundation\\Providers\\ConsoleSupportServiceProvider',
+    'Illuminate\\Foundation\\Console\\ReloadCommand' => 'Illuminate\\Foundation\\Providers\\ConsoleSupportServiceProvider',
     'Illuminate\\Foundation\\Console\\RouteCacheCommand' => 'Illuminate\\Foundation\\Providers\\ConsoleSupportServiceProvider',
     'Illuminate\\Foundation\\Console\\RouteClearCommand' => 'Illuminate\\Foundation\\Providers\\ConsoleSupportServiceProvider',
     'Illuminate\\Foundation\\Console\\RouteListCommand' => 'Illuminate\\Foundation\\Providers\\ConsoleSupportServiceProvider',

api/routes/api.php

@@ -2,37 +2,86 @@
 
 use App\Http\Controllers\AuthController;
 use App\Http\Controllers\GameController;
-use App\Http\Controllers\UserController;
 use App\Http\Controllers\MatchController;
-use Illuminate\Http\Request;
+use App\Http\Controllers\ProfileController;
+use App\Http\Controllers\UserController;
+use App\Http\Controllers\StatisticsController;
 use Illuminate\Support\Facades\Route;
 
-
-# Authentication Routes
+Route::prefix('v1')->group(function () {
+    // Public Routes
     Route::post('/login', [AuthController::class, 'login']);
-
-Route::middleware('auth:sanctum')->group(function () {
-    Route::get('/users/me', function (Request $request) {
-        return $request->user();
-    });
-    Route::post('logout', [AuthController::class, 'logout']);
-});
-
     Route::post('/register', [AuthController::class, 'register']);
 
-# Game Routes - Protected
-Route::middleware('auth:sanctum')->group(function () {
-    Route::apiResource('games', GameController::class);
-    Route::post('games', [GameController::class, 'store']);
-    Route::post('/games/{game}/resign', [GameController::class, 'resign']);
-    Route::get('/users/{user}/matches', [UserController::class, 'getMatches']);
-    Route::post('games/{game}/join', [GameController::class, 'join']);
+    Route::get('/statistics/public', [StatisticsController::class, 'getPublicStats']);
+    Route::get('/leaderboard', [StatisticsController::class, 'getLeaderboard']);
+
+    // Authenticated Routes
+    Route::middleware(['auth:sanctum', 'throttle:60,1'])->group(function () {
+        Route::post('/logout', [AuthController::class, 'logout']);
+        Route::get('/statistics/me', [StatisticsController::class, 'getPersonalStats']);
+        Route::prefix('users/me')->group(function () {
+            Route::get('/', [ProfileController::class, 'show']);
+            Route::put('/', [ProfileController::class, 'update']);
+            Route::delete('/', [ProfileController::class, 'destroy']);
+            Route::get('/coins', [ProfileController::class, 'getCoins']);
+            Route::put('/password', [
+                ProfileController::class,
+                'updatePassword',
+            ]);
+            Route::post('/avatar', [ProfileController::class, 'uploadAvatar']);
         });
 
-Route::middleware('auth:sanctum')->group(function () {
-    Route::get('matches', [MatchController::class, 'index']);
-    Route::post('matches', [MatchController::class, 'store']);
-    Route::get('matches/{match}', [MatchController::class, 'show']);
-    Route::post('matches/{match}/join', [MatchController::class, 'join']);
-    Route::put('matches/{match}', [MatchController::class, 'update']);
+        // User Resources
+        Route::prefix('/users')->group(function () {
+            Route::get('/{user}', [UserController::class, 'show']);
+            Route::get('/{user}/matches', [
+                UserController::class,
+                'getMatches',
+            ]);
+        });
+
+        // Game Resources
+        Route::prefix('games')->group(function () {
+            Route::apiResource('/', GameController::class)->parameters([
+                '' => 'game',
+            ]);
+            Route::post('/{game}/join', [GameController::class, 'join']);
+            Route::post('/{game}/resign', [GameController::class, 'resign']);
+        });
+
+        // Match Resources
+        Route::prefix('matches')->group(function () {
+            Route::apiResource('/', MatchController::class)->parameters([
+                '' => 'match',
+            ]);
+            Route::post('/{match}/join', [
+                MatchController::class,
+                'join',
+            ]);
+        });
+
+        // Admin Routes
+        Route::middleware('user.type:A')
+            ->prefix('admin')
+            ->group(function () {
+                Route::prefix('users')->group(function () {
+                    Route::get('/', [UserController::class, 'index']);
+                    Route::post('/', [UserController::class, 'store']);
+                    Route::put('/{user}', [UserController::class, 'update']);
+                    Route::delete('/{user}', [
+                        UserController::class,
+                        'destroy',
+                    ]);
+                    Route::post('/{user}/block', [
+                        UserController::class,
+                        'block',
+                    ]);
+                    Route::post('/{user}/unblock', [
+                        UserController::class,
+                        'unblock',
+                    ]);
+                });
+            });
+    });
 });

api/sample-requests.http

@@ -0,0 +1,19 @@
+### Get All Students (Login)
+# @name login
+POST http://localhost:8000/api/login
+Content-Type: application/json
+Accept: application/json
+
+{
+    "email": "[email protected]",
+    "password": "123"
+}
+
+### Capture the token
+@token = {{login.response.body.token}}
+
+### Get All matches
+GET http://localhost:8000/api/matches
+Content-Type: application/json
+Accept: application/json
+Authorization: Bearer {{token}}

bruno_collection/Admin/Get Users.bru

@@ -0,0 +1,20 @@
+meta {
+  name: Get Users
+  type: http
+  seq: 1
+}
+
+get {
+  url: {{api_url}}/admin/users/
+  body: none
+  auth: inherit
+}
+
+headers {
+  Authorization: Bearer {{token}}
+}
+
+settings {
+  encodeUrl: true
+  timeout: 0
+}

bruno_collection/Admin/folder.bru

@@ -0,0 +1,8 @@
+meta {
+  name: Admin
+  seq: 4
+}
+
+auth {
+  mode: inherit
+}

bruno_collection/Auth/Login.bru

@@ -5,7 +5,7 @@ meta {
 }
 
 post {
-  url: {{api_url}}/auth/login
+  url: {{api_url}}/login
   body: json
   auth: none
 }

bruno_collection/Games/Get Games.bru

@@ -5,7 +5,7 @@ meta {
 }
 
 get {
-  url: {{api_url}}/games
+  url: {{api_url}}/games/1
   body: none
   auth: none
 }

bruno_collection/environments/Local Development.bru

@@ -1,5 +1,5 @@
 vars {
-  base_url: http://localhost:8085
-  api_url: http://localhost:8085/api
+  base_url: http://localhost:8000
+  api_url: http://localhost:8000/api/v1
   token: 
 }

deployment/kubernetes-vue.yml

@@ -17,7 +17,7 @@ spec:
       priorityClassName: low-priority
       containers:
         - name: web
-          image: registry-172.22.21.115.sslip.io/dad-group-x/web:v1.0.0
+          image: registry-172.22.21.115.sslip.io/dad-group-46/web:v1.0.1
           resources:
             requests:
               memory: "64Mi"

frontend/.env.example

@@ -1,2 +1,2 @@
 VITE_API_DOMAIN=localhost:8000
-VITE_WS_CONNECTION=ws://localhost:3000
+VITE_WS_CONNECTION=ws://localhost:3001

frontend/components.json

@@ -9,13 +9,12 @@
     "cssVariables": true,
     "prefix": ""
   },
-  "iconLibrary": "lucide",
   "aliases": {
     "components": "@/components",
+    "composables": "@/composables",
     "utils": "@/lib/utils",
     "ui": "@/components/ui",
-    "lib": "@/lib",
-    "composables": "@/composables"
+    "lib": "@/lib"
   },
-  "registries": {}
+  "iconLibrary": "lucide"
 }

frontend/index.html

@@ -5,7 +5,7 @@
     <link rel="icon" href="/favicon.ico" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <link rel="stylesheet" href="/src/index.css" />
-    <title>Vite App</title>
+    <title>Bisca</title>
   </head>
   <body>
     <div id="app"></div>

frontend/package.json

@@ -21,6 +21,7 @@
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "date-fns": "^4.1.0",
+    "lucide-react": "^0.562.0",
     "lucide-vue-next": "^0.554.0",
     "pinia": "^3.0.3",
     "reka-ui": "^2.6.0",

frontend/src/App.vue

@@ -3,8 +3,8 @@
   <nav class="max-w-full p-5 flex flex-row justify-between align-middle">
     <div class="align-middle text-xl">
       <RouterLink to="/"> {{ pageTitle }} </RouterLink>
-      <span class="text-xs" v-if="authStore.currentUser">&nbsp;&nbsp;&nbsp;
-        ({{ authStore.currentUser?.name }})
+      <span class="text-xs" v-if="authStore.currentUser"
+        >&nbsp;&nbsp;&nbsp; ({{ authStore.currentUser?.name }})
       </span>
     </div>
     <NavBar @logout="logout" :userLoggedIn="authStore.isLoggedIn" />
@@ -17,41 +17,35 @@
 </template>
 
 <script setup>
-import { RouterLink, RouterView } from 'vue-router';
-import { toast } from 'vue-sonner';
+import { RouterLink, RouterView } from 'vue-router'
+import { toast } from 'vue-sonner'
 import 'vue-sonner/style.css'
-import { ref, onMounted } from 'vue';
+import { ref, onMounted } from 'vue'
 import { Toaster } from '@/components/ui/sonner'
-import NavBar from './components/layout/NavBar.vue';
-import { useAuthStore } from './stores/auth';
-import { useSocketStore } from './stores/socket';
+import NavBar from './components/layout/NavBar.vue'
+import { useAuthStore } from './stores/auth'
+import { useSocketStore } from './stores/socket'
 
 const authStore = useAuthStore()
 const socketStore = useSocketStore()
 
-
 const year = new Date().getFullYear()
 const pageTitle = ref(`DAD ${year}/${String(year + 1).slice(-2)}`)
 
-
-
 const logout = () => {
-
   toast.promise(authStore.logout(), {
     loading: 'Calling API',
     success: () => {
       return 'Logout Sucessfull '
     },
-    error: (data) => `[API] Error saving game - ${data?.response?.data?.message}`,
+    error: (data) => `[API] Error - ${data?.response?.data?.message}`,
   })
-
 }
 
-onMounted(() => {
+onMounted(async () => {
+  await authStore.restoreSession()
   socketStore.handleConnection()
 })
-
-
 </script>
 
-<style></style>`
+<style></style>

frontend/src/components/game/DeckArea.vue

@@ -0,0 +1,114 @@
+<template>
+  <div class="relative flex items-center justify-center w-64 h-48">
+    <div
+      v-if="trumpCard"
+      class="absolute rotate-90 origin-center transition-all duration-700"
+      :class="[trumpReveal && 'scale-110']"
+    >
+      <div
+        class="ring-2 ring-amber-400/60 ring-offset-2 rounded-lg transition-all duration-700"
+        :class="[
+          trumpReveal &&
+            'ring-4 ring-amber-400 shadow-[0_0_30px_rgba(251,191,36,0.8)] animate-pulse',
+        ]"
+      >
+        <GameCard :suit="trumpCard.suit" :rank="trumpCard.rank" />
+      </div>
+      <div
+        v-if="trumpReveal"
+        class="absolute -bottom-8 left-1/2 -translate-x-1/2 bg-amber-500/90 text-white text-[10px] font-bold px-3 py-1 rounded-full whitespace-nowrap animate-pulse"
+      >
+        TRUMP
+      </div>
+    </div>
+
+    <div
+      v-if="!isEmpty && cardsRemaining > 0"
+      class="absolute -translate-x-8 -translate-y-4 transition-all duration-300"
+      :class="[cardsRemaining === 0 && 'opacity-0 scale-95', deckPulse && 'scale-105']"
+    >
+      <div class="relative">
+        <div
+          class="absolute inset-0 bg-gray-800 rounded-lg opacity-20 translate-x-1 translate-y-1"
+        ></div>
+        <div
+          class="absolute inset-0 bg-gray-800 rounded-lg opacity-15 translate-x-2 translate-y-2"
+        ></div>
+        <div
+          class="absolute inset-0 bg-gray-800 rounded-lg opacity-10 translate-x-3 translate-y-3"
+        ></div>
+
+        <div class="relative">
+          <GameCard suit="c" :rank="1" :face-down="true" />
+
+          <div
+            class="absolute -top-2 -right-2 bg-blue-600 text-white text-xs font-bold rounded-full w-8 h-8 flex items-center justify-center shadow-lg border-2 border-white transition-all duration-300"
+          >
+            <Transition
+              enter-active-class="transition-all duration-200"
+              enter-from-class="scale-150 opacity-0"
+              enter-to-class="scale-100 opacity-100"
+              leave-active-class="transition-all duration-200"
+              leave-from-class="scale-100 opacity-100"
+              leave-to-class="scale-50 opacity-0"
+              mode="out-in"
+            >
+              <span :key="cardsRemaining">{{ cardsRemaining }}</span>
+            </Transition>
+          </div>
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup>
+import { ref, watch } from 'vue'
+import GameCard from './GameCard.vue'
+
+const props = defineProps({
+  trumpCard: {
+    type: Object,
+    default: null,
+  },
+  cardsRemaining: {
+    type: Number,
+    required: true,
+  },
+  isEmpty: {
+    type: Boolean,
+    required: true,
+  },
+  revealTrump: {
+    type: Boolean,
+    default: false,
+  },
+})
+
+const deckPulse = ref(false)
+const trumpReveal = ref(false)
+
+// Pulse animation when cards remaining changes
+watch(
+  () => props.cardsRemaining,
+  () => {
+    deckPulse.value = true
+    setTimeout(() => {
+      deckPulse.value = false
+    }, 300)
+  },
+)
+
+// Trump reveal animation
+watch(
+  () => props.revealTrump,
+  (newValue) => {
+    if (newValue) {
+      trumpReveal.value = true
+      setTimeout(() => {
+        trumpReveal.value = false
+      }, 3000) // Show for 3 seconds
+    }
+  },
+)
+</script>

frontend/src/components/game/FlyingCard.vue

@@ -0,0 +1,76 @@
+<template>
+  <Teleport to="body">
+    <div
+      v-if="isVisible"
+      class="fixed pointer-events-none z-[9999]"
+      :style="{
+        left: currentPosition.x + 'px',
+        top: currentPosition.y + 'px',
+        transition: isAnimating ? `all ${duration}ms ease-out` : 'none',
+      }"
+    >
+      <GameCard :suit="card.suit" :rank="card.rank" :face-down="faceDown" />
+    </div>
+  </Teleport>
+</template>
+
+<script setup>
+import { ref, onMounted, watch } from 'vue'
+import GameCard from './GameCard.vue'
+
+const props = defineProps({
+  card: {
+    type: Object,
+    required: true,
+  },
+  startPosition: {
+    type: Object,
+    required: true,
+    validator: (value) => 'x' in value && 'y' in value,
+  },
+  endPosition: {
+    type: Object,
+    required: true,
+    validator: (value) => 'x' in value && 'y' in value,
+  },
+  duration: {
+    type: Number,
+    default: 500,
+  },
+  faceDown: {
+    type: Boolean,
+    default: true,
+  },
+  delay: {
+    type: Number,
+    default: 0,
+  },
+})
+
+const emit = defineEmits(['complete'])
+
+const isVisible = ref(false)
+const isAnimating = ref(false)
+const currentPosition = ref({ x: 0, y: 0 })
+
+onMounted(() => {
+  // Start at the deck position
+  currentPosition.value = { ...props.startPosition }
+  isVisible.value = true
+
+  // Wait for delay, then start animation
+  setTimeout(() => {
+    // Force a reflow to ensure starting position is set
+    requestAnimationFrame(() => {
+      isAnimating.value = true
+      currentPosition.value = { ...props.endPosition }
+
+      // After animation completes, emit event and hide
+      setTimeout(() => {
+        emit('complete')
+        isVisible.value = false
+      }, props.duration)
+    })
+  }, props.delay)
+})
+</script>

frontend/src/components/game/GameBoard.vue

@@ -0,0 +1,77 @@
+<template>
+  <div
+    class="min-h-screen bg-linear-to-br from-green-700 via-green-800 to-green-900 grid grid-rows-[auto_auto_1fr_auto] grid-cols-[1fr_3fr_1fr] gap-6 p-8"
+  >
+    <div class="col-start-1 col-end-4 row-start-1 flex justify-start items-start">
+      <ScoreDisplay
+        :player-score="playerScore"
+        :opponent-score="opponentScore"
+        :current-turn="currentTurn"
+        :round-number="1"
+      />
+    </div>
+
+    <div class="col-start-2 col-end-3 row-start-2 flex justify-center">
+      <PlayerHand
+        :cards="opponentHand"
+        :face-down="true"
+        :max-cards="maxCards"
+      />
+    </div>
+
+    <div class="col-start-2 col-end-3 row-start-3 flex items-center justify-center">
+      <PlayArea
+        :player-card="currentTrick.playerCard"
+        :opponent-card="currentTrick.opponentCard"
+        :winner="currentTrick.winner"
+      />
+    </div>
+
+    <div class="col-start-3 col-end-4 row-start-3 flex items-center justify-center">
+      <DeckArea :trump-card="trumpCard" :cards-remaining="cardsRemaining" :is-empty="deckIsEmpty" />
+    </div>
+
+    <div class="col-start-2 col-end-3 row-start-4 flex justify-center">
+      <PlayerHand
+        :cards="playerHand"
+        :face-down="false"
+        :max-cards="maxCards"
+        @card-clicked="handleCardClick"
+      />
+    </div>
+  </div>
+</template>
+
+<script setup>
+import PlayerHand from './PlayerHand.vue'
+import PlayArea from './PlayArea.vue'
+import DeckArea from './DeckArea.vue'
+import ScoreDisplay from './ScoreDisplay.vue'
+
+const props = defineProps({
+  playerHand: { type: Array, default: () => [] },
+  opponentHand: { type: Array, default: () => [] },
+  currentTrick: {
+    type: Object,
+    default: () => ({ playerCard: null, opponentCard: null, winner: null }),
+  },
+  trumpCard: { type: Object, required: true },
+  cardsRemaining: { type: Number, default: 0 },
+  deckIsEmpty: { type: Boolean, default: false },
+  maxCards: { type: Number, default: 3 },
+  // REMOVIDO: playableCardIndices (já não precisamos dele)
+  playerScore: { type: Number, default: 0 },
+  opponentScore: { type: Number, default: 0 },
+  currentTurn: {
+    type: String,
+    default: 'player',
+    validator: (value) => ['player', 'opponent'].includes(value),
+  },
+})
+
+const emit = defineEmits(['play-card'])
+
+const handleCardClick = (payload) => {
+  emit('play-card', payload.card)
+}
+</script>

frontend/src/components/game/GameCard.vue

@@ -0,0 +1,39 @@
+<template>
+  <div
+    class="relative w-32 aspect-[2.5/3.5] cursor-pointer transition-all duration-300 ease-in-out hover:scale-105 hover:-translate-y-2 hover:shadow-2xl"
+  >
+    <img
+      :src="cardImage"
+      :alt="faceDown ? 'Card back' : `${suit} ${rank}`"
+      class="w-full h-full object-cover rounded-lg shadow-lg select-none"
+      draggable="false"
+    />
+  </div>
+</template>
+
+<script setup>
+import { computed } from 'vue'
+
+const props = defineProps({
+  suit: {
+    type: String,
+    required: true,
+  },
+  rank: {
+    type: Number,
+    required: true,
+  },
+  faceDown: {
+    type: Boolean,
+    default: false,
+  },
+})
+
+const cardImage = computed(() => {
+  if (props.faceDown) {
+    return '/cards/semFace.png'
+  } else {
+    return `/cards/${props.suit}${props.rank}.png`
+  }
+})
+</script>

frontend/src/components/game/GameOver.vue

@@ -0,0 +1,308 @@
+<template>
+  <Teleport to="body">
+    <Transition
+      enter-active-class="transition-all duration-500 ease-out"
+      enter-from-class="opacity-0"
+      enter-to-class="opacity-100"
+      leave-active-class="transition-all duration-300 ease-in"
+      leave-from-class="opacity-100"
+      leave-to-class="opacity-0"
+    >
+      <div
+        v-if="isVisible"
+        class="fixed inset-0 bg-black/70 backdrop-blur-sm z-[9998] flex items-center justify-center p-4"
+        @click.self="handleClose"
+      >
+        <Transition
+          enter-active-class="transition-all duration-500 ease-out delay-100"
+          enter-from-class="opacity-0 scale-75 -translate-y-10"
+          enter-to-class="opacity-100 scale-100 translate-y-0"
+          leave-active-class="transition-all duration-300 ease-in"
+          leave-from-class="opacity-100 scale-100"
+          leave-to-class="opacity-0 scale-90"
+        >
+          <div
+            v-if="isVisible"
+            class="bg-gradient-to-br from-gray-900 via-gray-800 to-gray-900 rounded-2xl shadow-2xl border-2 max-w-md w-full p-8 relative overflow-hidden"
+            :class="[
+              winner === 'player'
+                ? 'border-emerald-500/50'
+                : winner === 'opponent'
+                  ? 'border-rose-500/50'
+                  : 'border-gray-600/50',
+            ]"
+          >
+            <!-- Confetti Effect (if player wins) -->
+            <div
+              v-if="winner === 'player' && showConfetti"
+              class="absolute inset-0 pointer-events-none"
+            >
+              <div
+                v-for="i in 30"
+                :key="i"
+                class="absolute w-2 h-2 animate-confetti"
+                :style="{
+                  left: Math.random() * 100 + '%',
+                  top: '-10px',
+                  backgroundColor: ['#fbbf24', '#34d399', '#60a5fa', '#f472b6', '#a78bfa'][
+                    Math.floor(Math.random() * 5)
+                  ],
+                  animationDelay: Math.random() * 2 + 's',
+                  animationDuration: 3 + Math.random() * 2 + 's',
+                }"
+              ></div>
+            </div>
+
+            <!-- Winner Icon/Badge -->
+            <div class="flex justify-center mb-6">
+              <div
+                class="relative"
+                :class="[winner === 'player' ? 'animate-bounce' : 'animate-pulse']"
+              >
+                <div
+                  v-if="winner === 'player'"
+                  class="w-24 h-24 rounded-full bg-gradient-to-br from-emerald-400 to-emerald-600 flex items-center justify-center shadow-lg shadow-emerald-500/50"
+                >
+                  <span class="text-5xl">🏆</span>
+                </div>
+                <div
+                  v-else-if="winner === 'opponent'"
+                  class="w-24 h-24 rounded-full bg-gradient-to-br from-rose-400 to-rose-600 flex items-center justify-center shadow-lg shadow-rose-500/50"
+                >
+                  <span class="text-5xl">😔</span>
+                </div>
+                <div
+                  v-else
+                  class="w-24 h-24 rounded-full bg-gradient-to-br from-gray-400 to-gray-600 flex items-center justify-center shadow-lg"
+                >
+                  <span class="text-5xl">🤝</span>
+                </div>
+              </div>
+            </div>
+
+            <!-- Title -->
+            <h2
+              class="text-4xl font-black text-center mb-2 bg-clip-text text-transparent bg-gradient-to-r"
+              :class="[
+                winner === 'player'
+                  ? 'from-emerald-300 to-emerald-500'
+                  : winner === 'opponent'
+                    ? 'from-rose-300 to-rose-500'
+                    : 'from-gray-300 to-gray-500',
+              ]"
+            >
+              {{ title }}
+            </h2>
+
+            <!-- Subtitle -->
+            <p class="text-center text-gray-400 mb-8">{{ subtitle }}</p>
+
+            <!-- Scores -->
+            <div class="bg-black/30 rounded-xl p-6 mb-8 space-y-4">
+              <div class="flex items-center justify-between">
+                <span class="text-gray-300 font-medium">{{ playerName }}</span>
+                <span
+                  class="text-3xl font-black tabular-nums transition-all duration-500"
+                  :class="[
+                    playerScore > opponentScore
+                      ? 'text-emerald-400 drop-shadow-[0_0_12px_rgba(52,211,153,0.6)]'
+                      : 'text-white',
+                  ]"
+                >
+                  {{ displayPlayerScore }}
+                </span>
+              </div>
+              <div class="h-px bg-gray-700"></div>
+              <div class="flex items-center justify-between">
+                <span class="text-gray-300 font-medium">{{ opponentName }}</span>
+                <span
+                  class="text-3xl font-black tabular-nums transition-all duration-500"
+                  :class="[
+                    opponentScore > playerScore
+                      ? 'text-rose-400 drop-shadow-[0_0_12px_rgba(251,113,133,0.6)]'
+                      : 'text-white',
+                  ]"
+                >
+                  {{ displayOpponentScore }}
+                </span>
+              </div>
+            </div>
+
+            <!-- Stats (optional) -->
+            <div v-if="stats" class="grid grid-cols-2 gap-4 mb-8">
+              <div class="bg-black/20 rounded-lg p-3 text-center">
+                <p class="text-gray-400 text-xs mb-1">Your Tricks</p>
+                <p class="text-2xl font-bold text-white">{{ stats.playerTricks }}</p>
+              </div>
+              <div class="bg-black/20 rounded-lg p-3 text-center">
+                <p class="text-gray-400 text-xs mb-1">Opponent Tricks</p>
+                <p class="text-2xl font-bold text-white">{{ stats.opponentTricks }}</p>
+              </div>
+            </div>
+
+            <!-- Actions -->
+            <div class="flex gap-3">
+              <button
+                v-if="!isLoggingOut"
+                @click="$emit('play-again')"
+                class="flex-1 bg-gradient-to-r from-emerald-500 to-emerald-600 hover:from-emerald-600 hover:to-emerald-700 text-white font-bold py-3 px-6 rounded-lg transition-all shadow-lg"
+              >
+                Play Again
+              </button>
+              <button
+                v-if="!hideClose"
+                @click="handleClose"
+                class="flex-1 font-bold py-3 px-6 rounded-lg transition-all"
+                :class="[
+                  isLoggingOut
+                    ? 'bg-red-600 hover:bg-red-700 text-white w-full'
+                    : 'bg-gray-700 hover:bg-gray-600 text-white',
+                ]"
+              >
+                {{ isLoggingOut ? 'Confirm Logout' : 'Close' }}
+              </button>
+            </div>
+          </div>
+        </Transition>
+      </div>
+    </Transition>
+  </Teleport>
+</template>
+
+<script setup>
+import { ref, computed, watch, onMounted } from 'vue'
+
+const props = defineProps({
+  isVisible: {
+    type: Boolean,
+    required: true,
+  },
+  winner: {
+    type: String,
+    required: true,
+    validator: (value) => ['player', 'opponent', 'draw'].includes(value),
+  },
+  playerScore: {
+    type: Number,
+    required: true,
+  },
+  opponentScore: {
+    type: Number,
+    required: true,
+  },
+  playerName: {
+    type: String,
+    default: 'You',
+  },
+  opponentName: {
+    type: String,
+    default: 'Bot',
+  },
+  stats: {
+    type: Object,
+    default: null,
+  },
+  hideClose: {
+    type: Boolean,
+    default: false,
+  },
+  isLoggingOut: {
+    type: Boolean,
+    default: false,
+  },
+})
+
+const emit = defineEmits(['close', 'play-again'])
+
+const showConfetti = ref(false)
+const displayPlayerScore = ref(0)
+const displayOpponentScore = ref(0)
+
+// Computed title based on winner
+const title = computed(() => {
+  if (props.winner === 'player') return 'Victory!'
+  if (props.winner === 'opponent') return 'Defeat'
+  return 'Draw!'
+})
+
+// Computed subtitle
+const subtitle = computed(() => {
+  if (props.winner === 'player') return 'Congratulations! You won the game!'
+  if (props.winner === 'opponent') return 'Better luck next time!'
+  return 'The game ended in a draw'
+})
+
+// Animate score count-up
+const animateScore = (fromValue, toValue, callback) => {
+  const duration = 1000
+  const steps = 30
+  const stepDuration = duration / steps
+  const increment = (toValue - fromValue) / steps
+
+  let current = fromValue
+  let step = 0
+
+  const interval = setInterval(() => {
+    step++
+    current += increment
+
+    if (step >= steps) {
+      current = toValue
+      clearInterval(interval)
+    }
+
+    callback(Math.round(current))
+  }, stepDuration)
+}
+
+// Watch for visibility and trigger animations
+watch(
+  () => props.isVisible,
+  (newValue) => {
+    if (newValue) {
+      // Start confetti if player wins
+      if (props.winner === 'player') {
+        setTimeout(() => {
+          showConfetti.value = true
+        }, 300)
+      }
+
+      // Animate scores counting up
+      setTimeout(() => {
+        animateScore(0, props.playerScore, (value) => {
+          displayPlayerScore.value = value
+        })
+        animateScore(0, props.opponentScore, (value) => {
+          displayOpponentScore.value = value
+        })
+      }, 400)
+    } else {
+      showConfetti.value = false
+      displayPlayerScore.value = 0
+      displayOpponentScore.value = 0
+    }
+  },
+  { immediate: true },
+)
+
+const handleClose = () => {
+  emit('close')
+}
+</script>
+
+<style scoped>
+@keyframes confetti {
+  0% {
+    transform: translateY(0) rotate(0deg);
+    opacity: 1;
+  }
+  100% {
+    transform: translateY(100vh) rotate(720deg);
+    opacity: 0;
+  }
+}
+
+.animate-confetti {
+  animation: confetti linear forwards;
+}
+</style>

frontend/src/components/game/PlayArea.vue

@@ -0,0 +1,100 @@
+<template>
+  <div class="flex items-center justify-center h-64 relative">
+    <div class="relative w-96 h-full flex items-center justify-center">
+      <!-- Opponent Card Slot -->
+      <div
+        class="absolute top-4"
+        :class="[
+          winner === 'opponent' && 'ring-4 ring-green-400 ring-offset-4 rounded-lg animate-pulse',
+        ]"
+        :style="{ zIndex: opponentCard ? (firstPlayer === 'opponent' ? 1 : 2) : 0 }"
+      >
+        <div
+          v-if="!opponentCard"
+          class="w-32 aspect-[2.5/3.5] border-4 border-dashed border-gray-400/40 rounded-lg bg-gray-100/20 flex items-center justify-center"
+        >
+          <span class="text-gray-400 text-xs font-medium">Opponent</span>
+        </div>
+        <Transition
+          enter-active-class="transition-all duration-500 ease-out"
+          enter-from-class="opacity-0 -translate-y-[200px] scale-75"
+          enter-to-class="opacity-100 translate-y-0 scale-100 rotate-6"
+          leave-active-class="transition-all duration-500 ease-in"
+          :leave-from-class="`opacity-100 translate-y-0 scale-100 rotate-6`"
+          :leave-to-class="
+            winner === 'opponent'
+              ? 'opacity-0 -translate-y-[200px] translate-x-[300px] scale-50 rotate-0'
+              : 'opacity-0 translate-y-[200px] translate-x-[300px] scale-50 rotate-0'
+          "
+          mode="out-in"
+        >
+          <div
+            v-if="opponentCard"
+            :key="`${opponentCard.suit}-${opponentCard.rank}`"
+            class="rotate-6"
+          >
+            <GameCard :suit="opponentCard.suit" :rank="opponentCard.rank" />
+          </div>
+        </Transition>
+      </div>
+
+      <!-- Player Card Slot -->
+      <div
+        class="absolute bottom-4"
+        :class="[
+          winner === 'player' && 'ring-4 ring-green-400 ring-offset-4 rounded-lg animate-pulse',
+        ]"
+        :style="{ zIndex: playerCard ? (firstPlayer === 'player' ? 1 : 2) : 0 }"
+      >
+        <div
+          v-if="!playerCard"
+          class="w-32 aspect-[2.5/3.5] border-4 border-dashed border-gray-400/40 rounded-lg bg-gray-100/20 flex items-center justify-center"
+        >
+          <span class="text-gray-400 text-xs font-medium">You</span>
+        </div>
+        <Transition
+          enter-active-class="transition-all duration-500 ease-out"
+          enter-from-class="opacity-0 translate-y-[200px] scale-75"
+          enter-to-class="opacity-100 translate-y-0 scale-100 -rotate-6"
+          leave-active-class="transition-all duration-500 ease-in"
+          :leave-from-class="`opacity-100 translate-y-0 scale-100 -rotate-6`"
+          :leave-to-class="
+            winner === 'opponent'
+              ? 'opacity-0 -translate-y-[200px] translate-x-[300px] scale-50 rotate-0'
+              : 'opacity-0 translate-y-[200px] translate-x-[300px] scale-50 rotate-0'
+          "
+          mode="out-in"
+        >
+          <div v-if="playerCard" :key="`${playerCard.suit}-${playerCard.rank}`" class="-rotate-6">
+            <GameCard :suit="playerCard.suit" :rank="playerCard.rank" />
+          </div>
+        </Transition>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup>
+import GameCard from './GameCard.vue'
+
+const props = defineProps({
+  playerCard: {
+    type: Object,
+    default: null,
+  },
+  opponentCard: {
+    type: Object,
+    default: null,
+  },
+  winner: {
+    type: String,
+    default: null,
+    validator: (value) => [null, 'player', 'opponent'].includes(value),
+  },
+  firstPlayer: {
+    type: String,
+    default: null,
+    validator: (value) => [null, 'player', 'opponent'].includes(value),
+  },
+})
+</script>

frontend/src/components/game/PlayerHand.vue

@@ -0,0 +1,108 @@
+<template>
+  <div class="flex justify-center items-end relative h-40">
+    <TransitionGroup
+      enter-active-class="transition-all duration-500 ease-out"
+      enter-from-class="opacity-0 -translate-y-8 scale-75"
+      enter-to-class="opacity-100 translate-y-0 scale-100"
+    >
+      <div
+        v-for="(card, index) in cards"
+        :key="`${card.suit}-${card.rank}-${index}`"
+        class="absolute transition-all duration-300 ease-out"
+        :style="getCardStyle(index)"
+        @mouseenter="hoveredIndex = index"
+        @mouseleave="hoveredIndex = null"
+        @click="handleCardClick(card, index)"
+      >
+        <div
+          :class="[
+            'transition-all duration-300 rounded-lg',
+            isValid(card)
+              ? 'cursor-pointer hover:shadow-xl ring-2 ring-transparent hover:ring-yellow-400/50'
+              : 'cursor-not-allowed opacity-60 grayscale brightness-75',
+            hoveredIndex === index && isValid(card) && 'scale-110 -translate-y-4 z-50',
+          ]"
+        >
+          <GameCard :suit="card.suit" :rank="card.rank" :face-down="faceDown" />
+        </div>
+      </div>
+    </TransitionGroup>
+  </div>
+</template>
+
+<script setup>
+import { ref, computed } from 'vue'
+import GameCard from './GameCard.vue'
+import { toast } from 'vue-sonner'
+import { useBiscaStore } from '@/stores/bisca'
+
+const props = defineProps({
+  cards: {
+    type: Array,
+    required: true,
+    default: () => [],
+  },
+  faceDown: {
+    type: Boolean,
+    default: false,
+  },
+  maxCards: {
+    type: Number,
+    default: 3,
+    validator: (value) => [3, 9].includes(value),
+  },
+})
+
+const emit = defineEmits(['card-clicked'])
+const store = useBiscaStore()
+
+const hoveredIndex = ref(null)
+
+const isValid = (card) => {
+  if (props.faceDown) return false
+  return store.canPlayCard(card)
+}
+
+const handleCardClick = (card, index) => {
+  if (props.faceDown) return
+
+  if (store.canPlayCard(card)) {
+    emit('card-clicked', { card, index })
+  } else {
+    toast.warning('Jogada Inválida', {
+      description: 'Tens de assistir ao naipe jogado!',
+      duration: 2000,
+    })
+  }
+}
+
+
+const overlapPercentage = computed(() => {
+  return props.maxCards === 3 ? 0.7 : 0.85
+})
+
+const cardWidth = 128 
+const getCardStyle = (index) => {
+  const totalCards = props.cards.length
+  const overlapOffset = cardWidth * (1 - overlapPercentage.value)
+  const totalWidth = cardWidth + (totalCards - 1) * overlapOffset
+  const startOffset = -totalWidth / 2 + cardWidth / 2
+
+  let left = startOffset + index * overlapOffset
+
+  if (hoveredIndex.value !== null && hoveredIndex.value !== index) {
+    if (isValid(props.cards[hoveredIndex.value])) {
+        if (index < hoveredIndex.value) {
+          left -= 10
+        } else if (index > hoveredIndex.value) {
+          left += 10
+        }
+    }
+  }
+
+  return {
+    left: `calc(50% + ${left}px)`,
+    zIndex: hoveredIndex.value === index ? 50 : index + 1,
+  }
+}
+</script>

frontend/src/components/game/ScoreDisplay.vue

@@ -0,0 +1,176 @@
+<template>
+  <div
+    class="inline-flex bg-gray-900/80 backdrop-blur-sm border border-gray-700/50 shadow-xl rounded-md px-4 py-1.5 items-center gap-4"
+  >
+    <!-- Opponent Score (Left) -->
+    <div class="flex items-center gap-2">
+      <div class="flex flex-col items-start">
+        <span class="text-gray-400 text-[10px] uppercase tracking-wide mb-0.5">{{
+          opponentName
+        }}</span>
+        <span
+          class="text-2xl font-black tabular-nums transition-all duration-300"
+          :class="[
+            opponentScore > playerScore
+              ? 'text-amber-400 drop-shadow-[0_0_12px_rgba(251,191,36,0.6)]'
+              : 'text-white',
+            scoreChanged === 'opponent' && 'scale-110',
+          ]"
+        >
+          {{ displayOpponentScore }}
+        </span>
+      </div>
+    </div>
+
+    <!-- Center Turn Indicator -->
+    <div class="flex flex-col items-center gap-1">
+      <div
+        class="px-3 py-0.5 rounded-full text-[9px] font-bold uppercase tracking-wider transition-all duration-300"
+        :class="[
+          currentTurn === 'player'
+            ? 'bg-emerald-500/20 text-emerald-400 border border-emerald-500/40 shadow-[0_0_10px_rgba(52,211,153,0.4)]'
+            : 'bg-rose-500/20 text-rose-400 border border-rose-500/40 shadow-[0_0_10px_rgba(251,113,133,0.4)]',
+          turnChanged && 'animate-pulse',
+        ]"
+      >
+        {{ currentTurn === 'player' ? 'Your Turn' : "Bot's Turn" }}
+      </div>
+      <span v-if="roundNumber" class="text-gray-500 text-[10px] font-medium">
+        Round {{ roundNumber }}
+      </span>
+    </div>
+
+    <!-- Player Score (Right) -->
+    <div class="flex items-center gap-2">
+      <div class="flex flex-col items-end">
+        <span class="text-gray-400 text-[10px] uppercase tracking-wide mb-0.5">{{
+          playerName
+        }}</span>
+        <span
+          class="text-2xl font-black tabular-nums transition-all duration-300"
+          :class="[
+            playerScore > opponentScore
+              ? 'text-amber-400 drop-shadow-[0_0_12px_rgba(251,191,36,0.6)]'
+              : 'text-white',
+            scoreChanged === 'player' && 'scale-110',
+          ]"
+        >
+          {{ displayPlayerScore }}
+        </span>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup>
+import { ref, watch, computed } from 'vue'
+
+const props = defineProps({
+  playerScore: {
+    type: Number,
+    required: true,
+  },
+  opponentScore: {
+    type: Number,
+    required: true,
+  },
+  playerName: {
+    type: String,
+    default: 'You',
+  },
+  opponentName: {
+    type: String,
+    default: 'Bot',
+  },
+  currentTurn: {
+    type: String,
+    default: 'player',
+    validator: (value) => ['player', 'opponent'].includes(value),
+  },
+  roundNumber: {
+    type: Number,
+    default: null,
+  },
+})
+
+const scoreChanged = ref(null)
+const turnChanged = ref(false)
+const displayPlayerScore = ref(props.playerScore)
+const displayOpponentScore = ref(props.opponentScore)
+
+// Animate score count-up
+const animateScore = (fromValue, toValue, callback) => {
+  const duration = 500 // Total animation duration in ms
+  const steps = 20 // Number of increments
+  const stepDuration = duration / steps
+  const increment = (toValue - fromValue) / steps
+
+  let current = fromValue
+  let step = 0
+
+  const interval = setInterval(() => {
+    step++
+    current += increment
+
+    if (step >= steps) {
+      current = toValue
+      clearInterval(interval)
+    }
+
+    callback(Math.round(current))
+  }, stepDuration)
+}
+
+// Watch for player score changes and trigger count-up animation
+watch(
+  () => props.playerScore,
+  (newScore, oldScore) => {
+    scoreChanged.value = 'player'
+
+    if (oldScore !== undefined && newScore !== oldScore) {
+      animateScore(oldScore, newScore, (value) => {
+        displayPlayerScore.value = value
+      })
+    } else {
+      displayPlayerScore.value = newScore
+    }
+
+    setTimeout(() => {
+      scoreChanged.value = null
+    }, 300)
+  },
+  { immediate: true },
+)
+
+// Watch for opponent score changes and trigger count-up animation
+watch(
+  () => props.opponentScore,
+  (newScore, oldScore) => {
+    scoreChanged.value = 'opponent'
+
+    if (oldScore !== undefined && newScore !== oldScore) {
+      animateScore(oldScore, newScore, (value) => {
+        displayOpponentScore.value = value
+      })
+    } else {
+      displayOpponentScore.value = newScore
+    }
+
+    setTimeout(() => {
+      scoreChanged.value = null
+    }, 300)
+  },
+  { immediate: true },
+)
+
+// Watch for turn changes and trigger pulse animation
+watch(
+  () => props.currentTurn,
+  () => {
+    turnChanged.value = true
+    setTimeout(() => {
+      turnChanged.value = false
+    }, 1000)
+  },
+)
+</script>

frontend/src/components/layout/NavBar.vue

@@ -15,14 +15,19 @@
                         </li>
                     </NavigationMenuContent>
                 </NavigationMenuItem>
+
                 <NavigationMenuItem v-if="!userLoggedIn">
                     <NavigationMenuLink>
                         <RouterLink to="/login">Login</RouterLink>
                     </NavigationMenuLink>
                 </NavigationMenuItem>
+
                 <NavigationMenuItem v-else>
                     <NavigationMenuLink>
-                        <a @click.prevent="logoutClickHandler">Logout</a>
+                        <a href="/home" @click.prevent="logoutClickHandler" class="cursor-pointer">Logout</a>
+                    </NavigationMenuLink>
+                    <NavigationMenuLink>
+                        <RouterLink to="/user">Profile</RouterLink>
                     </NavigationMenuLink>
                 </NavigationMenuItem>
             </NavigationMenuList>
@@ -31,6 +36,7 @@
 </template>
 
 <script setup>
+import { useBiscaStore } from '@/stores/bisca'
 import {
     NavigationMenu,
     NavigationMenuContent,
@@ -39,12 +45,29 @@ import {
     NavigationMenuList,
     NavigationMenuTrigger,
 } from '@/components/ui/navigation-menu'
-
+import router from '@/router';
 
 const emits = defineEmits(['logout'])
 const { userLoggedIn } = defineProps(['userLoggedIn'])
 
+const biscaStore = useBiscaStore()
+
 const logoutClickHandler = () => {
+    if (biscaStore.isGameRunning) {
+        const confirmLogout = window.confirm(
+            '⚠️ Jogo em Progresso!\n\nSe fizeres Logout agora, perderás o jogo atual e serás considerado PERDEDOR.\n\nQueres mesmo sair?'
+        )
+        if (!confirmLogout) return
+
+        biscaStore.isLoggingOut = true
+
+        biscaStore.quitGame()
+
+        return
+    }
+
     emits('logout')
+
+    router.push({ name: 'home' }) 
 }
 </script>

frontend/src/components/ui/card/Card.vue

@@ -0,0 +1,21 @@
+<script setup>
+import { cn } from "@/lib/utils";
+
+const props = defineProps({
+  class: { type: null, required: false },
+});
+</script>
+
+<template>
+  <div
+    data-slot="card"
+    :class="
+      cn(
+        'bg-card text-card-foreground flex flex-col gap-6 rounded-xl border py-6 shadow-sm',
+        props.class,
+      )
+    "
+  >
+    <slot />
+  </div>
+</template>

frontend/src/components/ui/card/CardAction.vue

@@ -0,0 +1,21 @@
+<script setup>
+import { cn } from "@/lib/utils";
+
+const props = defineProps({
+  class: { type: null, required: false },
+});
+</script>
+
+<template>
+  <div
+    data-slot="card-action"
+    :class="
+      cn(
+        'col-start-2 row-span-2 row-start-1 self-start justify-self-end',
+        props.class,
+      )
+    "
+  >
+    <slot />
+  </div>
+</template>

frontend/src/components/ui/card/CardContent.vue

@@ -0,0 +1,13 @@
+<script setup>
+import { cn } from "@/lib/utils";
+
+const props = defineProps({
+  class: { type: null, required: false },
+});
+</script>
+
+<template>
+  <div data-slot="card-content" :class="cn('px-6', props.class)">
+    <slot />
+  </div>
+</template>

frontend/src/components/ui/card/CardDescription.vue

@@ -0,0 +1,16 @@
+<script setup>
+import { cn } from "@/lib/utils";
+
+const props = defineProps({
+  class: { type: null, required: false },
+});
+</script>
+
+<template>
+  <p
+    data-slot="card-description"
+    :class="cn('text-muted-foreground text-sm', props.class)"
+  >
+    <slot />
+  </p>
+</template>

frontend/src/components/ui/card/CardFooter.vue

@@ -0,0 +1,16 @@
+<script setup>
+import { cn } from "@/lib/utils";
+
+const props = defineProps({
+  class: { type: null, required: false },
+});
+</script>
+
+<template>
+  <div
+    data-slot="card-footer"
+    :class="cn('flex items-center px-6 [.border-t]:pt-6', props.class)"
+  >
+    <slot />
+  </div>
+</template>

frontend/src/components/ui/card/CardHeader.vue

@@ -0,0 +1,21 @@
+<script setup>
+import { cn } from "@/lib/utils";
+
+const props = defineProps({
+  class: { type: null, required: false },
+});
+</script>
+
+<template>
+  <div
+    data-slot="card-header"
+    :class="
+      cn(
+        '@container/card-header grid auto-rows-min grid-rows-[auto_auto] items-start gap-1.5 px-6 has-data-[slot=card-action]:grid-cols-[1fr_auto] [.border-b]:pb-6',
+        props.class,
+      )
+    "
+  >
+    <slot />
+  </div>
+</template>

frontend/src/components/ui/card/CardTitle.vue

@@ -0,0 +1,16 @@
+<script setup>
+import { cn } from "@/lib/utils";
+
+const props = defineProps({
+  class: { type: null, required: false },
+});
+</script>
+
+<template>
+  <h3
+    data-slot="card-title"
+    :class="cn('leading-none font-semibold', props.class)"
+  >
+    <slot />
+  </h3>
+</template>

frontend/src/components/ui/card/index.js

@@ -0,0 +1,7 @@
+export { default as Card } from "./Card.vue";
+export { default as CardAction } from "./CardAction.vue";
+export { default as CardContent } from "./CardContent.vue";
+export { default as CardDescription } from "./CardDescription.vue";
+export { default as CardFooter } from "./CardFooter.vue";
+export { default as CardHeader } from "./CardHeader.vue";
+export { default as CardTitle } from "./CardTitle.vue";

frontend/src/index.css

@@ -39,6 +39,9 @@
   --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
   --color-sidebar-border: var(--sidebar-border);
   --color-sidebar-ring: var(--sidebar-ring);
+  --radius-2xl: calc(var(--radius) + 8px);
+  --radius-3xl: calc(var(--radius) + 12px);
+  --radius-4xl: calc(var(--radius) + 16px);
 }
 
 :root {

frontend/src/lib/utils.js

@@ -1,5 +1,5 @@
 import { clsx } from "clsx";
-import { twMerge } from "tailwind-merge";
+import { twMerge } from "tailwind-merge"
 
 export function cn(...inputs) {
   return twMerge(clsx(inputs));

frontend/src/main.js

@@ -13,11 +13,12 @@ console.log('[main.js] ws connection', wsConnection)
 
 const app = createApp(App)
 
-app.provide('socket', io(wsConnection))
+//app.provide('socket', io(wsConnection))
 app.provide('serverBaseURL', `http://${apiDomain}`)
-app.provide('apiBaseURL', `http://${apiDomain}/api`)
+app.provide('apiBaseURL', `http://${apiDomain}/api/v1`)
 
 app.use(createPinia())
 app.use(router)
 
 app.mount('#app')
+

frontend/src/pages/TestAllAnimations.vue

@@ -0,0 +1,342 @@
+<template>
+  <div class="min-h-screen bg-gradient-to-br from-green-700 via-green-800 to-green-900 p-8">
+    <div class="max-w-6xl mx-auto">
+      <!-- Title -->
+      <h1 class="text-white text-3xl font-bold mb-8 text-center">
+        All Animations Test Page
+      </h1>
+
+      <!-- Control Panel -->
+      <div class="bg-gray-900/80 rounded-lg p-6 mb-8">
+        <h2 class="text-white text-xl font-semibold mb-4">Controls</h2>
+
+        <!-- Score Animation Tests -->
+        <div class="mb-6">
+          <h3 class="text-emerald-400 font-semibold mb-3">Score Count-Up Animation</h3>
+          <div class="flex flex-wrap gap-3">
+            <button
+              @click="increasePlayerScore"
+              class="px-4 py-2 bg-green-600 hover:bg-green-700 text-white rounded-lg font-medium transition-colors"
+            >
+              +10 Player Score
+            </button>
+            <button
+              @click="increaseOpponentScore"
+              class="px-4 py-2 bg-red-600 hover:bg-red-700 text-white rounded-lg font-medium transition-colors"
+            >
+              +10 Opponent Score
+            </button>
+            <button
+              @click="resetScores"
+              class="px-4 py-2 bg-gray-600 hover:bg-gray-700 text-white rounded-lg font-medium transition-colors"
+            >
+              Reset Scores
+            </button>
+          </div>
+        </div>
+
+        <!-- Turn Transition Tests -->
+        <div class="mb-6">
+          <h3 class="text-blue-400 font-semibold mb-3">Turn Transition Animation</h3>
+          <div class="flex flex-wrap gap-3">
+            <button
+              @click="toggleTurn"
+              class="px-4 py-2 bg-blue-600 hover:bg-blue-700 text-white rounded-lg font-medium transition-colors"
+            >
+              Switch Turn
+            </button>
+            <button
+              @click="currentTurn = 'player'"
+              class="px-4 py-2 bg-emerald-600 hover:bg-emerald-700 text-white rounded-lg font-medium transition-colors"
+            >
+              Your Turn
+            </button>
+            <button
+              @click="currentTurn = 'opponent'"
+              class="px-4 py-2 bg-rose-600 hover:bg-rose-700 text-white rounded-lg font-medium transition-colors"
+            >
+              Bot's Turn
+            </button>
+          </div>
+        </div>
+
+        <!-- Trump Reveal Tests -->
+        <div class="mb-6">
+          <h3 class="text-amber-400 font-semibold mb-3">Trump Reveal Animation</h3>
+          <div class="flex flex-wrap gap-3">
+            <button
+              @click="triggerTrumpReveal"
+              class="px-4 py-2 bg-amber-600 hover:bg-amber-700 text-white rounded-lg font-medium transition-colors"
+            >
+              Reveal Trump
+            </button>
+          </div>
+        </div>
+
+        <!-- Game Over Tests -->
+        <div class="mb-6">
+          <h3 class="text-purple-400 font-semibold mb-3">Game Over Screen</h3>
+          <div class="flex flex-wrap gap-3">
+            <button
+              @click="showGameOverPlayerWin"
+              class="px-4 py-2 bg-emerald-600 hover:bg-emerald-700 text-white rounded-lg font-medium transition-colors"
+            >
+              Player Wins
+            </button>
+            <button
+              @click="showGameOverOpponentWin"
+              class="px-4 py-2 bg-rose-600 hover:bg-rose-700 text-white rounded-lg font-medium transition-colors"
+            >
+              Opponent Wins
+            </button>
+            <button
+              @click="showGameOverDraw"
+              class="px-4 py-2 bg-gray-600 hover:bg-gray-700 text-white rounded-lg font-medium transition-colors"
+            >
+              Draw
+            </button>
+          </div>
+        </div>
+
+        <!-- Full Sequence -->
+        <div>
+          <h3 class="text-pink-400 font-semibold mb-3">Complete Sequence</h3>
+          <div class="flex flex-wrap gap-3">
+            <button
+              @click="runFullSequence"
+              :disabled="isRunningSequence"
+              class="px-4 py-2 bg-pink-600 hover:bg-pink-700 disabled:bg-gray-600 disabled:cursor-not-allowed text-white rounded-lg font-medium transition-colors"
+            >
+              Run Full Animation Sequence
+            </button>
+          </div>
+        </div>
+      </div>
+
+      <!-- Game Board Preview -->
+      <div class="grid grid-rows-[auto_1fr] gap-8">
+        <!-- Score Display -->
+        <div class="flex justify-center">
+          <ScoreDisplay
+            :player-score="playerScore"
+            :opponent-score="opponentScore"
+            :current-turn="currentTurn"
+            :round-number="1"
+          />
+        </div>
+
+        <!-- Deck Area (with trump) -->
+        <div class="flex justify-center">
+          <div class="bg-gray-800/30 rounded-lg p-6">
+            <h3 class="text-white text-sm font-semibold mb-4 text-center">Trump Card</h3>
+            <DeckArea
+              :trump-card="trumpCard"
+              :cards-remaining="cardsRemaining"
+              :is-empty="false"
+              :reveal-trump="revealTrump"
+            />
+          </div>
+        </div>
+      </div>
+
+      <!-- Instructions -->
+      <div class="bg-gray-900/80 rounded-lg p-6 mt-8 text-gray-300">
+        <h3 class="text-white font-semibold mb-2">Instructions:</h3>
+        <ul class="list-disc list-inside space-y-1 text-sm">
+          <li>
+            <strong>Score Count-Up:</strong> Click "+10" buttons to see scores animate smoothly
+            from old to new value
+          </li>
+          <li>
+            <strong>Turn Transition:</strong> Switch turns to see the indicator pulse and glow with
+            color change
+          </li>
+          <li>
+            <strong>Trump Reveal:</strong> Triggers a 3-second pulse/glow animation on the trump
+            card with label
+          </li>
+          <li>
+            <strong>Game Over:</strong> Shows victory/defeat modal with score count-up and confetti
+            (on win)
+          </li>
+          <li>
+            <strong>Full Sequence:</strong> Runs all animations in order: trump reveal → turn
+            changes → score updates → game over
+          </li>
+        </ul>
+      </div>
+    </div>
+
+    <!-- Game Over Modal -->
+    <GameOver
+      :is-visible="gameOverVisible"
+      :winner="gameOverWinner"
+      :player-score="playerScore"
+      :opponent-score="opponentScore"
+      :stats="gameOverStats"
+      @close="gameOverVisible = false"
+      @play-again="handlePlayAgain"
+    />
+  </div>
+</template>
+
+<script setup>
+import { ref } from 'vue'
+import ScoreDisplay from '@/components/game/ScoreDisplay.vue'
+import DeckArea from '@/components/game/DeckArea.vue'
+import GameOver from '@/components/game/GameOver.vue'
+
+// Game state
+const playerScore = ref(23)
+const opponentScore = ref(15)
+const currentTurn = ref('player')
+const cardsRemaining = ref(30)
+const revealTrump = ref(false)
+const isRunningSequence = ref(false)
+
+// Trump card
+const trumpCard = ref({ suit: 'o', rank: 7 })
+
+// Game Over state
+const gameOverVisible = ref(false)
+const gameOverWinner = ref('player')
+const gameOverStats = ref({
+  playerTricks: 8,
+  opponentTricks: 6,
+})
+
+// Score manipulation
+const increasePlayerScore = () => {
+  playerScore.value += 10
+}
+
+const increaseOpponentScore = () => {
+  opponentScore.value += 10
+}
+
+const resetScores = () => {
+  playerScore.value = 0
+  opponentScore.value = 0
+}
+
+// Turn control
+const toggleTurn = () => {
+  currentTurn.value = currentTurn.value === 'player' ? 'opponent' : 'player'
+}
+
+// Trump reveal
+const triggerTrumpReveal = () => {
+  revealTrump.value = true
+  setTimeout(() => {
+    revealTrump.value = false
+  }, 100)
+}
+
+// Game Over screens
+const showGameOverPlayerWin = () => {
+  playerScore.value = 67
+  opponentScore.value = 53
+  gameOverWinner.value = 'player'
+  gameOverStats.value = {
+    playerTricks: 11,
+    opponentTricks: 9,
+  }
+  gameOverVisible.value = true
+}
+
+const showGameOverOpponentWin = () => {
+  playerScore.value = 45
+  opponentScore.value = 75
+  gameOverWinner.value = 'opponent'
+  gameOverStats.value = {
+    playerTricks: 7,
+    opponentTricks: 13,
+  }
+  gameOverVisible.value = true
+}
+
+const showGameOverDraw = () => {
+  playerScore.value = 60
+  opponentScore.value = 60
+  gameOverWinner.value = 'draw'
+  gameOverStats.value = {
+    playerTricks: 10,
+    opponentTricks: 10,
+  }
+  gameOverVisible.value = true
+}
+
+const handlePlayAgain = () => {
+  gameOverVisible.value = false
+  resetScores()
+  currentTurn.value = 'player'
+  cardsRemaining.value = 40
+}
+
+// Full animation sequence
+const runFullSequence = async () => {
+  if (isRunningSequence.value) return
+  isRunningSequence.value = true
+
+  // Reset everything
+  resetScores()
+  currentTurn.value = 'player'
+  gameOverVisible.value = false
+  await new Promise((resolve) => setTimeout(resolve, 500))
+
+  // 1. Trump Reveal
+  console.log('1. Trump Reveal')
+  triggerTrumpReveal()
+  await new Promise((resolve) => setTimeout(resolve, 3500))
+
+  // 2. First turn
+  console.log('2. Player turn')
+  currentTurn.value = 'player'
+  await new Promise((resolve) => setTimeout(resolve, 1500))
+
+  // 3. Player scores
+  console.log('3. Player scores')
+  playerScore.value = 11
+  await new Promise((resolve) => setTimeout(resolve, 2000))
+
+  // 4. Switch turn
+  console.log('4. Switch to opponent turn')
+  currentTurn.value = 'opponent'
+  await new Promise((resolve) => setTimeout(resolve, 1500))
+
+  // 5. Opponent scores
+  console.log('5. Opponent scores')
+  opponentScore.value = 10
+  await new Promise((resolve) => setTimeout(resolve, 2000))
+
+  // 6. Back to player
+  console.log('6. Back to player')
+  currentTurn.value = 'player'
+  await new Promise((resolve) => setTimeout(resolve, 1000))
+
+  // 7. More scoring
+  console.log('7. More scoring')
+  playerScore.value = 23
+  await new Promise((resolve) => setTimeout(resolve, 1500))
+  opponentScore.value = 19
+  await new Promise((resolve) => setTimeout(resolve, 1500))
+  playerScore.value = 34
+  await new Promise((resolve) => setTimeout(resolve, 1500))
+
+  // 8. Final scores and game over
+  console.log('8. Game over')
+  playerScore.value = 67
+  opponentScore.value = 53
+  await new Promise((resolve) => setTimeout(resolve, 2000))
+
+  // Show game over
+  gameOverWinner.value = 'player'
+  gameOverStats.value = {
+    playerTricks: 11,
+    opponentTricks: 9,
+  }
+  gameOverVisible.value = true
+
+  isRunningSequence.value = false
+}
+</script>

frontend/src/pages/TestAnimations.vue

@@ -0,0 +1,252 @@
+<template>
+  <div class="min-h-screen bg-gradient-to-br from-green-700 via-green-800 to-green-900 p-8">
+    <div class="max-w-4xl mx-auto">
+      <!-- Title -->
+      <h1 class="text-white text-3xl font-bold mb-8 text-center">Animation Test Page</h1>
+
+      <!-- Control Panel -->
+      <div class="bg-gray-900/80 rounded-lg p-6 mb-8">
+        <h2 class="text-white text-xl font-semibold mb-4">Controls</h2>
+        <div class="flex flex-wrap gap-3">
+          <button
+            @click="playPlayerCard"
+            class="px-4 py-2 bg-green-600 hover:bg-green-700 text-white rounded-lg font-medium transition-colors"
+          >
+            Play Player Card
+          </button>
+          <button
+            @click="playOpponentCard"
+            class="px-4 py-2 bg-red-600 hover:bg-red-700 text-white rounded-lg font-medium transition-colors"
+          >
+            Play Opponent Card
+          </button>
+          <button
+            @click="playBothCards"
+            class="px-4 py-2 bg-blue-600 hover:bg-blue-700 text-white rounded-lg font-medium transition-colors"
+          >
+            Play Both Cards
+          </button>
+          <button
+            @click="clearCards"
+            class="px-4 py-2 bg-gray-600 hover:bg-gray-700 text-white rounded-lg font-medium transition-colors"
+          >
+            Clear Cards
+          </button>
+          <button
+            @click="setPlayerWinner"
+            class="px-4 py-2 bg-emerald-600 hover:bg-emerald-700 text-white rounded-lg font-medium transition-colors"
+          >
+            Player Wins
+          </button>
+          <button
+            @click="setOpponentWinner"
+            class="px-4 py-2 bg-rose-600 hover:bg-rose-700 text-white rounded-lg font-medium transition-colors"
+          >
+            Opponent Wins
+          </button>
+          <button
+            @click="fullSequence"
+            class="px-4 py-2 bg-purple-600 hover:bg-purple-700 text-white rounded-lg font-medium transition-colors"
+          >
+            Full Trick Sequence
+          </button>
+          <button
+            @click="collectTrickPlayerWins"
+            :disabled="!playerCard || !opponentCard"
+            class="px-4 py-2 bg-cyan-600 hover:bg-cyan-700 disabled:bg-gray-600 disabled:cursor-not-allowed text-white rounded-lg font-medium transition-colors"
+          >
+            Collect Trick (Player Wins)
+          </button>
+          <button
+            @click="collectTrickOpponentWins"
+            :disabled="!playerCard || !opponentCard"
+            class="px-4 py-2 bg-orange-600 hover:bg-orange-700 disabled:bg-gray-600 disabled:cursor-not-allowed text-white rounded-lg font-medium transition-colors"
+          >
+            Collect Trick (Opponent Wins)
+          </button>
+        </div>
+
+        <!-- Current State Display -->
+        <div class="mt-4 text-gray-300 text-sm">
+          <p>
+            <strong>Player Card:</strong>
+            {{ playerCard ? `${playerCard.suit}${playerCard.rank}` : 'None' }}
+          </p>
+          <p>
+            <strong>Opponent Card:</strong>
+            {{ opponentCard ? `${opponentCard.suit}${opponentCard.rank}` : 'None' }}
+          </p>
+          <p><strong>Winner:</strong> {{ winner || 'None' }}</p>
+          <p><strong>First Player:</strong> {{ firstPlayer || 'None' }}</p>
+        </div>
+      </div>
+
+      <!-- PlayArea Component -->
+      <div class="bg-gray-800/50 rounded-lg p-8">
+        <h2 class="text-white text-xl font-semibold mb-4 text-center">Play Area</h2>
+        <PlayArea
+          :player-card="playerCard"
+          :opponent-card="opponentCard"
+          :winner="winner"
+          :first-player="firstPlayer"
+        />
+      </div>
+
+      <!-- Instructions -->
+      <div class="bg-gray-900/80 rounded-lg p-6 mt-8 text-gray-300">
+        <h3 class="text-white font-semibold mb-2">Instructions:</h3>
+        <ul class="list-disc list-inside space-y-1 text-sm">
+          <li><strong>Play Player Card:</strong> Animates a card from bottom (player's hand)</li>
+          <li><strong>Play Opponent Card:</strong> Animates a card from top (opponent's hand)</li>
+          <li><strong>Play Both Cards:</strong> Both cards animate in simultaneously</li>
+          <li><strong>Clear Cards:</strong> Triggers exit animations (cards slide out)</li>
+          <li>
+            <strong>Winner Buttons:</strong> Add glowing ring effect to winning card (play cards
+            first)
+          </li>
+          <li>
+            <strong>Full Trick Sequence:</strong> Plays both cards → shows winner → clears (2 second
+            delay)
+          </li>
+          <li>
+            <strong>Collect Trick (Player Wins):</strong> Sets player as winner, waits 1.5s, then
+            cards slide DOWN toward player area
+          </li>
+          <li>
+            <strong>Collect Trick (Opponent Wins):</strong> Sets opponent as winner, waits 1.5s,
+            then cards slide UP toward opponent area
+          </li>
+        </ul>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup>
+import { ref } from 'vue'
+import PlayArea from '@/components/game/PlayArea.vue'
+
+// Reactive state
+const playerCard = ref(null)
+const opponentCard = ref(null)
+const winner = ref(null)
+const firstPlayer = ref(null)
+
+// Sample cards to test with
+const sampleCards = [
+  { suit: 'c', rank: 1 },
+  { suit: 'c', rank: 7 },
+  { suit: 'c', rank: 13 },
+  { suit: 'e', rank: 11 },
+  { suit: 'e', rank: 12 },
+  { suit: 'o', rank: 2 },
+  { suit: 'o', rank: 3 },
+  { suit: 'p', rank: 4 },
+  { suit: 'p', rank: 7 },
+]
+
+// Get random card
+const getRandomCard = () => {
+  return sampleCards[Math.floor(Math.random() * sampleCards.length)]
+}
+
+// Control functions
+const playPlayerCard = () => {
+  if (!playerCard.value && !opponentCard.value) {
+    firstPlayer.value = 'player'
+  }
+  playerCard.value = getRandomCard()
+  winner.value = null
+}
+
+const playOpponentCard = () => {
+  if (!playerCard.value && !opponentCard.value) {
+    firstPlayer.value = 'opponent'
+  }
+  opponentCard.value = getRandomCard()
+  winner.value = null
+}
+
+const playBothCards = () => {
+  firstPlayer.value = 'player' // Player plays first in this scenario
+  playerCard.value = getRandomCard()
+  opponentCard.value = getRandomCard()
+  winner.value = null
+}
+
+const clearCards = () => {
+  playerCard.value = null
+  opponentCard.value = null
+  winner.value = null
+  firstPlayer.value = null
+}
+
+const setPlayerWinner = () => {
+  if (playerCard.value) {
+    winner.value = 'player'
+  }
+}
+
+const setOpponentWinner = () => {
+  if (opponentCard.value) {
+    winner.value = 'opponent'
+  }
+}
+
+const fullSequence = async () => {
+  // Clear first
+  clearCards()
+  await new Promise((resolve) => setTimeout(resolve, 500))
+
+  // Play both cards
+  playBothCards()
+  await new Promise((resolve) => setTimeout(resolve, 1000))
+
+  // Show winner (randomly)
+  winner.value = Math.random() > 0.5 ? 'player' : 'opponent'
+  await new Promise((resolve) => setTimeout(resolve, 2000))
+
+  // Clear cards
+  clearCards()
+}
+
+// Collect trick with player winning
+const collectTrickPlayerWins = async () => {
+  if (!playerCard.value || !opponentCard.value) return
+
+  // Set player as winner
+  winner.value = 'player'
+
+  // Wait 1.5 seconds to show winner glow
+  await new Promise((resolve) => setTimeout(resolve, 1500))
+
+  // Clear cards (triggers exit animation toward player)
+  playerCard.value = null
+  opponentCard.value = null
+
+  // Reset after animation completes
+  await new Promise((resolve) => setTimeout(resolve, 600))
+  winner.value = null
+  firstPlayer.value = null
+}
+
+// Collect trick with opponent winning
+const collectTrickOpponentWins = async () => {
+  if (!playerCard.value || !opponentCard.value) return
+
+  // Set opponent as winner
+  winner.value = 'opponent'
+
+  // Wait 1.5 seconds to show winner glow
+  await new Promise((resolve) => setTimeout(resolve, 1500))
+
+  // Clear cards (triggers exit animation toward opponent)
+  playerCard.value = null
+  opponentCard.value = null
+
+  // Reset after animation completes
+  await new Promise((resolve) => setTimeout(resolve, 600))
+  winner.value = null
+  firstPlayer.value = null
+}
+</script>

frontend/src/pages/TestDealing.vue

@@ -0,0 +1,275 @@
+<template>
+  <div class="min-h-screen bg-gradient-to-br from-green-700 via-green-800 to-green-900 p-8">
+    <div class="max-w-6xl mx-auto">
+      <!-- Title -->
+      <h1 class="text-white text-3xl font-bold mb-8 text-center">Card Dealing Test Page</h1>
+
+      <!-- Control Panel -->
+      <div class="bg-gray-900/80 rounded-lg p-6 mb-8">
+        <h2 class="text-white text-xl font-semibold mb-4">Controls</h2>
+        <div class="flex flex-wrap gap-3 mb-4">
+          <button
+            @click="startDealing"
+            :disabled="isDealing"
+            class="px-4 py-2 bg-green-600 hover:bg-green-700 disabled:bg-gray-600 disabled:cursor-not-allowed text-white rounded-lg font-medium transition-colors"
+          >
+            Start Dealing
+          </button>
+          <button
+            @click="dealSingleCard"
+            :disabled="isDealing || cardsRemaining === 0"
+            class="px-4 py-2 bg-blue-600 hover:bg-blue-700 disabled:bg-gray-600 disabled:cursor-not-allowed text-white rounded-lg font-medium transition-colors"
+          >
+            Deal One Card
+          </button>
+          <button
+            @click="reset"
+            class="px-4 py-2 bg-red-600 hover:bg-red-700 text-white rounded-lg font-medium transition-colors"
+          >
+            Reset
+          </button>
+        </div>
+
+        <!-- Current State Display -->
+        <div class="grid grid-cols-3 gap-4 text-gray-300 text-sm">
+          <div>
+            <p><strong>Player Hand:</strong> {{ playerHand.length }} cards</p>
+            <p><strong>Opponent Hand:</strong> {{ opponentHand.length }} cards</p>
+          </div>
+          <div>
+            <p><strong>Cards Remaining:</strong> {{ cardsRemaining }}</p>
+            <p><strong>Dealing:</strong> {{ isDealing ? 'Yes' : 'No' }}</p>
+          </div>
+          <div>
+            <p><strong>Next Recipient:</strong> {{ nextRecipient }}</p>
+          </div>
+        </div>
+      </div>
+
+      <!-- Game Board Layout -->
+      <div class="grid grid-rows-[auto_1fr_auto] gap-8">
+        <!-- Opponent Hand (Top) -->
+        <div class="flex justify-center">
+          <div class="bg-gray-800/30 rounded-lg p-4">
+            <h3 class="text-white text-sm font-semibold mb-2 text-center">Opponent Hand</h3>
+            <PlayerHand
+              ref="opponentHandRef"
+              :cards="opponentHand"
+              :face-down="true"
+              :max-cards="3"
+              :playable-cards="[]"
+            />
+          </div>
+        </div>
+
+        <!-- Center Area (Deck) -->
+        <div class="flex items-center justify-center">
+          <div class="bg-gray-800/30 rounded-lg p-6">
+            <h3 class="text-white text-sm font-semibold mb-4 text-center">Deck</h3>
+            <DeckArea
+              ref="deckRef"
+              :trump-card="trumpCard"
+              :cards-remaining="cardsRemaining"
+              :is-empty="cardsRemaining === 0"
+            />
+          </div>
+        </div>
+
+        <!-- Player Hand (Bottom) -->
+        <div class="flex justify-center">
+          <div class="bg-gray-800/30 rounded-lg p-4">
+            <h3 class="text-white text-sm font-semibold mb-2 text-center">Your Hand</h3>
+            <PlayerHand
+              ref="playerHandRef"
+              :cards="playerHand"
+              :face-down="false"
+              :max-cards="3"
+              :playable-cards="[]"
+            />
+          </div>
+        </div>
+      </div>
+
+      <!-- Instructions -->
+      <div class="bg-gray-900/80 rounded-lg p-6 mt-8 text-gray-300">
+        <h3 class="text-white font-semibold mb-2">Instructions:</h3>
+        <ul class="list-disc list-inside space-y-1 text-sm">
+          <li><strong>Start Dealing:</strong> Automatically deals 6 cards (3 to each player) with 200ms delay</li>
+          <li><strong>Deal One Card:</strong> Manually deal a single card to the next recipient</li>
+          <li><strong>Reset:</strong> Clear all hands and reset the deck to 40 cards</li>
+          <li>Watch the FlyingCard animation as cards move from deck to hands</li>
+          <li>Notice the deck counter decreasing and the pulse effect</li>
+          <li>Cards appear in hands with a fade-in animation</li>
+        </ul>
+      </div>
+    </div>
+
+    <!-- Flying Cards Container -->
+    <FlyingCard
+      v-for="flyingCard in flyingCards"
+      :key="flyingCard.id"
+      :card="flyingCard.card"
+      :start-position="flyingCard.startPosition"
+      :end-position="flyingCard.endPosition"
+      :duration="500"
+      :face-down="flyingCard.faceDown"
+      :delay="flyingCard.delay"
+      @complete="onFlyingCardComplete(flyingCard)"
+    />
+  </div>
+</template>
+
+<script setup>
+import { ref, computed, nextTick } from 'vue'
+import PlayerHand from '@/components/game/PlayerHand.vue'
+import DeckArea from '@/components/game/DeckArea.vue'
+import FlyingCard from '@/components/game/FlyingCard.vue'
+
+// Refs for components
+const playerHandRef = ref(null)
+const opponentHandRef = ref(null)
+const deckRef = ref(null)
+
+// Game state
+const playerHand = ref([])
+const opponentHand = ref([])
+const cardsRemaining = ref(40)
+const isDealing = ref(false)
+const flyingCards = ref([])
+let flyingCardIdCounter = 0
+
+// Trump card (fixed for testing)
+const trumpCard = ref({ suit: 'o', rank: 7 })
+
+// Sample deck
+const sampleCards = [
+  { suit: 'c', rank: 1 },
+  { suit: 'c', rank: 2 },
+  { suit: 'c', rank: 3 },
+  { suit: 'c', rank: 4 },
+  { suit: 'c', rank: 5 },
+  { suit: 'c', rank: 6 },
+  { suit: 'c', rank: 7 },
+  { suit: 'c', rank: 11 },
+  { suit: 'c', rank: 12 },
+  { suit: 'c', rank: 13 },
+  { suit: 'e', rank: 1 },
+  { suit: 'e', rank: 2 },
+  { suit: 'e', rank: 3 },
+  { suit: 'e', rank: 4 },
+  { suit: 'e', rank: 5 },
+  { suit: 'e', rank: 6 },
+  { suit: 'e', rank: 7 },
+  { suit: 'e', rank: 11 },
+  { suit: 'e', rank: 12 },
+  { suit: 'e', rank: 13 },
+  { suit: 'o', rank: 1 },
+  { suit: 'o', rank: 2 },
+  { suit: 'o', rank: 3 },
+  { suit: 'o', rank: 4 },
+  { suit: 'o', rank: 5 },
+  { suit: 'o', rank: 6 },
+  { suit: 'p', rank: 1 },
+  { suit: 'p', rank: 2 },
+  { suit: 'p', rank: 3 },
+  { suit: 'p', rank: 4 },
+  { suit: 'p', rank: 5 },
+  { suit: 'p', rank: 6 },
+  { suit: 'p', rank: 7 },
+  { suit: 'p', rank: 11 },
+  { suit: 'p', rank: 12 },
+  { suit: 'p', rank: 13 },
+]
+
+// Computed
+const nextRecipient = computed(() => {
+  const totalDealt = playerHand.value.length + opponentHand.value.length
+  return totalDealt % 2 === 0 ? 'Player' : 'Opponent'
+})
+
+// Get random card
+const getRandomCard = () => {
+  return sampleCards[Math.floor(Math.random() * sampleCards.length)]
+}
+
+// Get position of an element
+const getElementPosition = (el) => {
+  if (!el) return { x: 0, y: 0 }
+  const rect = el.$el?.getBoundingClientRect() || el.getBoundingClientRect()
+  return {
+    x: rect.left + rect.width / 2 - 64, // Center, minus half card width
+    y: rect.top + rect.height / 2 - 89, // Center, minus half card height
+  }
+}
+
+// Deal a single card
+const dealSingleCard = async () => {
+  if (cardsRemaining.value === 0) return
+
+  await nextTick()
+
+  // Determine recipient
+  const totalDealt = playerHand.value.length + opponentHand.value.length
+  const isPlayer = totalDealt % 2 === 0
+
+  // Get positions
+  const startPos = getElementPosition(deckRef.value)
+  const endPos = getElementPosition(isPlayer ? playerHandRef.value : opponentHandRef.value)
+
+  // Create flying card
+  const card = getRandomCard()
+  const flyingCard = {
+    id: flyingCardIdCounter++,
+    card,
+    startPosition: startPos,
+    endPosition: endPos,
+    faceDown: !isPlayer, // Face down for opponent
+    delay: 0,
+    recipient: isPlayer ? 'player' : 'opponent',
+  }
+
+  flyingCards.value.push(flyingCard)
+  cardsRemaining.value--
+}
+
+// Flying card animation complete
+const onFlyingCardComplete = (flyingCard) => {
+  // Add card to appropriate hand
+  if (flyingCard.recipient === 'player') {
+    playerHand.value.push(flyingCard.card)
+  } else {
+    opponentHand.value.push(flyingCard.card)
+  }
+
+  // Remove flying card
+  flyingCards.value = flyingCards.value.filter((fc) => fc.id !== flyingCard.id)
+}
+
+// Start automatic dealing sequence
+const startDealing = async () => {
+  if (isDealing.value) return
+
+  isDealing.value = true
+
+  // Deal 6 cards (3 to each player)
+  for (let i = 0; i < 6; i++) {
+    if (cardsRemaining.value === 0) break
+
+    await dealSingleCard()
+
+    // Wait 200ms before next card
+    await new Promise((resolve) => setTimeout(resolve, 700))
+  }
+
+  isDealing.value = false
+}
+
+// Reset everything
+const reset = () => {
+  playerHand.value = []
+  opponentHand.value = []
+  cardsRemaining.value = 40
+  flyingCards.value = []
+  isDealing.value = false
+}
+</script>

frontend/src/pages/TestGameBoard.vue

@@ -0,0 +1,444 @@
+<template>
+  <div class="min-h-screen bg-gradient-to-br from-green-700 via-green-800 to-green-900">
+    <!-- Control Panel (Floating) -->
+    <div class="fixed top-4 left-4 bg-gray-900/95 rounded-lg p-4 max-w-xs z-50 shadow-2xl">
+      <h3 class="text-white font-bold mb-3 text-sm">Test Controls</h3>
+      <div class="space-y-2">
+        <button
+          @click="dealInitialCards"
+          :disabled="isDealing"
+          class="w-full px-3 py-2 bg-blue-600 hover:bg-blue-700 disabled:bg-gray-600 text-white rounded text-xs font-medium transition-colors"
+        >
+          Deal Cards
+        </button>
+        <button
+          @click="playRandomCards"
+          :disabled="playerHand.length === 0"
+          class="w-full px-3 py-2 bg-green-600 hover:bg-green-700 disabled:bg-gray-600 text-white rounded text-xs font-medium transition-colors"
+        >
+          Play Both Cards
+        </button>
+        <button
+          @click="collectTrick"
+          :disabled="!currentTrick.playerCard || !currentTrick.opponentCard"
+          class="w-full px-3 py-2 bg-purple-600 hover:bg-purple-700 disabled:bg-gray-600 text-white rounded text-xs font-medium transition-colors"
+        >
+          Collect Trick
+        </button>
+        <button
+          @click="revealTrump = !revealTrump"
+          class="w-full px-3 py-2 bg-amber-600 hover:bg-amber-700 text-white rounded text-xs font-medium transition-colors"
+        >
+          {{ revealTrump ? 'Hide' : 'Reveal' }} Trump
+        </button>
+        <button
+          @click="showGameOver"
+          class="w-full px-3 py-2 bg-rose-600 hover:bg-rose-700 text-white rounded text-xs font-medium transition-colors"
+        >
+          Show Game Over
+        </button>
+        <button
+          @click="resetGame"
+          class="w-full px-3 py-2 bg-gray-600 hover:bg-gray-700 text-white rounded text-xs font-medium transition-colors"
+        >
+          Reset Game
+        </button>
+        <div class="pt-2 border-t border-gray-700 mt-2 text-gray-400 text-xs">
+          <p><strong>Turn:</strong> {{ currentTurn === 'player' ? 'You' : 'Bot' }}</p>
+          <p><strong>Deck:</strong> {{ cardsRemaining }} cards</p>
+        </div>
+      </div>
+    </div>
+
+    <!-- Main Game Board -->
+    <div
+      class="grid grid-rows-[auto_auto_1fr_auto] grid-cols-[1fr_3fr_1fr] gap-6 p-8 min-h-screen"
+    >
+      <!-- Score Display (Top Left) -->
+      <div class="col-start-1 col-end-4 row-start-1 flex justify-start items-start">
+        <ScoreDisplay
+          :player-score="playerScore"
+          :opponent-score="opponentScore"
+          :current-turn="currentTurn"
+          :round-number="1"
+        />
+      </div>
+
+      <!-- Opponent Hand -->
+      <div class="col-start-2 col-end-3 row-start-2 flex justify-center">
+        <PlayerHand
+          ref="opponentHandRef"
+          :cards="opponentHand"
+          :face-down="true"
+          :max-cards="3"
+          :playable-cards="[]"
+        />
+      </div>
+
+      <!-- Play Area -->
+      <div class="col-start-2 col-end-3 row-start-3 flex items-center justify-center">
+        <PlayArea
+          :player-card="currentTrick.playerCard"
+          :opponent-card="currentTrick.opponentCard"
+          :winner="currentTrick.winner"
+          :first-player="currentTrick.firstPlayer"
+        />
+      </div>
+
+      <!-- Deck Area -->
+      <div class="col-start-3 col-end-4 row-start-3 flex items-center justify-center">
+        <DeckArea
+          ref="deckRef"
+          :trump-card="trumpCard"
+          :cards-remaining="cardsRemaining"
+          :is-empty="cardsRemaining === 0"
+          :reveal-trump="revealTrump"
+        />
+      </div>
+
+      <!-- Player Hand -->
+      <div class="col-start-2 col-end-3 row-start-4 flex justify-center">
+        <PlayerHand
+          ref="playerHandRef"
+          :cards="playerHand"
+          :face-down="false"
+          :max-cards="3"
+          :playable-cards="playableCards"
+          @card-clicked="handleCardClick"
+        />
+      </div>
+    </div>
+
+    <!-- Flying Cards Container -->
+    <FlyingCard
+      v-for="flyingCard in flyingCards"
+      :key="flyingCard.id"
+      :card="flyingCard.card"
+      :start-position="flyingCard.startPosition"
+      :end-position="flyingCard.endPosition"
+      :duration="500"
+      :face-down="flyingCard.faceDown"
+      :delay="flyingCard.delay"
+      @complete="onFlyingCardComplete(flyingCard)"
+    />
+
+    <!-- Game Over Modal -->
+    <GameOver
+      :is-visible="gameOverVisible"
+      :winner="gameOverWinner"
+      :player-score="playerScore"
+      :opponent-score="opponentScore"
+      :stats="gameOverStats"
+      @close="gameOverVisible = false"
+      @play-again="resetGame"
+    />
+  </div>
+</template>
+
+<script setup>
+import { ref, computed, nextTick } from 'vue'
+import GameBoard from '@/components/game/GameBoard.vue'
+import ScoreDisplay from '@/components/game/ScoreDisplay.vue'
+import PlayerHand from '@/components/game/PlayerHand.vue'
+import PlayArea from '@/components/game/PlayArea.vue'
+import DeckArea from '@/components/game/DeckArea.vue'
+import FlyingCard from '@/components/game/FlyingCard.vue'
+import GameOver from '@/components/game/GameOver.vue'
+
+// Component refs
+const playerHandRef = ref(null)
+const opponentHandRef = ref(null)
+const deckRef = ref(null)
+
+// Game state
+const playerHand = ref([])
+const opponentHand = ref([])
+const playerScore = ref(0)
+const opponentScore = ref(0)
+const currentTurn = ref('player')
+const cardsRemaining = ref(40)
+const isDealing = ref(false)
+const revealTrump = ref(false)
+
+// Trump card
+const trumpCard = ref({ suit: 'o', rank: 7 })
+
+// Current trick
+const currentTrick = ref({
+  playerCard: null,
+  opponentCard: null,
+  winner: null,
+  firstPlayer: null,
+})
+
+// Flying cards for dealing animation
+const flyingCards = ref([])
+let flyingCardIdCounter = 0
+
+// Game Over
+const gameOverVisible = ref(false)
+const gameOverWinner = ref('player')
+const gameOverStats = ref({
+  playerTricks: 0,
+  opponentTricks: 0,
+})
+
+// Sample deck
+const sampleCards = [
+  { suit: 'c', rank: 1 },
+  { suit: 'c', rank: 2 },
+  { suit: 'c', rank: 3 },
+  { suit: 'c', rank: 4 },
+  { suit: 'c', rank: 5 },
+  { suit: 'c', rank: 6 },
+  { suit: 'c', rank: 7 },
+  { suit: 'c', rank: 11 },
+  { suit: 'c', rank: 12 },
+  { suit: 'c', rank: 13 },
+  { suit: 'e', rank: 1 },
+  { suit: 'e', rank: 2 },
+  { suit: 'e', rank: 3 },
+  { suit: 'e', rank: 4 },
+  { suit: 'e', rank: 5 },
+  { suit: 'e', rank: 6 },
+  { suit: 'e', rank: 7 },
+  { suit: 'e', rank: 11 },
+  { suit: 'e', rank: 12 },
+  { suit: 'e', rank: 13 },
+  { suit: 'o', rank: 1 },
+  { suit: 'o', rank: 2 },
+  { suit: 'o', rank: 3 },
+  { suit: 'o', rank: 4 },
+  { suit: 'o', rank: 5 },
+  { suit: 'o', rank: 6 },
+  { suit: 'p', rank: 1 },
+  { suit: 'p', rank: 2 },
+  { suit: 'p', rank: 3 },
+  { suit: 'p', rank: 4 },
+  { suit: 'p', rank: 5 },
+  { suit: 'p', rank: 6 },
+  { suit: 'p', rank: 7 },
+  { suit: 'p', rank: 11 },
+  { suit: 'p', rank: 12 },
+  { suit: 'p', rank: 13 },
+]
+
+// Playable cards (all cards in hand for testing)
+const playableCards = computed(() => {
+  return playerHand.value.map((_, index) => index)
+})
+
+// Get random card
+const getRandomCard = () => {
+  return sampleCards[Math.floor(Math.random() * sampleCards.length)]
+}
+
+// Get element position
+const getElementPosition = (el) => {
+  if (!el) return { x: 0, y: 0 }
+  const rect = el.$el?.getBoundingClientRect() || el.getBoundingClientRect()
+  return {
+    x: rect.left + rect.width / 2 - 64,
+    y: rect.top + rect.height / 2 - 89,
+  }
+}
+
+// Deal a single card
+const dealSingleCard = async (isPlayer) => {
+  if (cardsRemaining.value === 0) return
+
+  await nextTick()
+
+  const startPos = getElementPosition(deckRef.value)
+  const endPos = getElementPosition(isPlayer ? playerHandRef.value : opponentHandRef.value)
+
+  const card = getRandomCard()
+  const flyingCard = {
+    id: flyingCardIdCounter++,
+    card,
+    startPosition: startPos,
+    endPosition: endPos,
+    faceDown: !isPlayer,
+    delay: 0,
+    recipient: isPlayer ? 'player' : 'opponent',
+  }
+
+  flyingCards.value.push(flyingCard)
+  cardsRemaining.value--
+}
+
+// Flying card complete
+const onFlyingCardComplete = (flyingCard) => {
+  if (flyingCard.recipient === 'player') {
+    playerHand.value.push(flyingCard.card)
+  } else {
+    opponentHand.value.push(flyingCard.card)
+  }
+  flyingCards.value = flyingCards.value.filter((fc) => fc.id !== flyingCard.id)
+}
+
+// Deal initial cards
+const dealInitialCards = async () => {
+  if (isDealing.value) return
+  isDealing.value = true
+
+  // Reveal trump at start
+  revealTrump.value = true
+  await new Promise((resolve) => setTimeout(resolve, 1000))
+  revealTrump.value = false
+
+  // Deal 6 cards (3 to each player)
+  for (let i = 0; i < 6; i++) {
+    if (cardsRemaining.value === 0) break
+    const isPlayer = i % 2 === 0
+    await dealSingleCard(isPlayer)
+    await new Promise((resolve) => setTimeout(resolve, 700))
+  }
+
+  isDealing.value = false
+}
+
+// Handle card click from player hand
+const handleCardClick = ({ card, index }) => {
+  if (currentTurn.value !== 'player') return
+  if (currentTrick.value.playerCard) return
+
+  // Set first player if no cards played yet
+  if (!currentTrick.value.opponentCard) {
+    currentTrick.value.firstPlayer = 'player'
+  }
+
+  // Play the card
+  currentTrick.value.playerCard = card
+  playerHand.value.splice(index, 1)
+
+  // Switch turn
+  currentTurn.value = 'opponent'
+
+  // Auto-play opponent card after delay
+  setTimeout(() => {
+    if (opponentHand.value.length > 0 && !currentTrick.value.opponentCard) {
+      playOpponentCard()
+    }
+  }, 1000)
+}
+
+// Play opponent card
+const playOpponentCard = () => {
+  if (opponentHand.value.length === 0) return
+
+  // Set first player if no cards played yet
+  if (!currentTrick.value.playerCard) {
+    currentTrick.value.firstPlayer = 'opponent'
+  }
+
+  // Play random card
+  const randomIndex = Math.floor(Math.random() * opponentHand.value.length)
+  const card = opponentHand.value[randomIndex]
+  currentTrick.value.opponentCard = card
+  opponentHand.value.splice(randomIndex, 1)
+
+  // Switch turn
+  currentTurn.value = 'player'
+}
+
+// Play random cards from both players
+const playRandomCards = () => {
+  if (playerHand.value.length === 0) return
+
+  // Player plays first
+  currentTrick.value.firstPlayer = 'player'
+  const playerCard = playerHand.value[0]
+  currentTrick.value.playerCard = playerCard
+  playerHand.value.shift()
+
+  // Opponent plays after delay
+  setTimeout(() => {
+    if (opponentHand.value.length > 0) {
+      const opponentCard = opponentHand.value[0]
+      currentTrick.value.opponentCard = opponentCard
+      opponentHand.value.shift()
+    }
+  }, 600)
+}
+
+// Collect trick
+const collectTrick = async () => {
+  if (!currentTrick.value.playerCard || !currentTrick.value.opponentCard) return
+
+  // Randomly determine winner
+  const winner = Math.random() > 0.5 ? 'player' : 'opponent'
+  currentTrick.value.winner = winner
+
+  // Wait to show winner glow
+  await new Promise((resolve) => setTimeout(resolve, 1500))
+
+  // Update score (random points)
+  const points = Math.floor(Math.random() * 15) + 5
+  if (winner === 'player') {
+    playerScore.value += points
+    gameOverStats.value.playerTricks++
+  } else {
+    opponentScore.value += points
+    gameOverStats.value.opponentTricks++
+  }
+
+  // Clear cards (triggers collection animation)
+  currentTrick.value.playerCard = null
+  currentTrick.value.opponentCard = null
+
+  // Reset after animation
+  await new Promise((resolve) => setTimeout(resolve, 600))
+  currentTrick.value.winner = null
+  currentTrick.value.firstPlayer = null
+
+  // Deal new cards if deck has cards
+  if (cardsRemaining.value >= 2 && playerHand.value.length < 3) {
+    await new Promise((resolve) => setTimeout(resolve, 500))
+    await dealSingleCard(winner === 'player')
+    await new Promise((resolve) => setTimeout(resolve, 700))
+    await dealSingleCard(winner === 'opponent')
+  }
+
+  // Switch turn to winner
+  currentTurn.value = winner
+}
+
+// Show game over
+const showGameOver = () => {
+  // Make player win for demo
+  if (playerScore.value <= opponentScore.value) {
+    playerScore.value = opponentScore.value + 10
+  }
+  gameOverWinner.value =
+    playerScore.value > opponentScore.value
+      ? 'player'
+      : opponentScore.value > playerScore.value
+        ? 'opponent'
+        : 'draw'
+  gameOverVisible.value = true
+}
+
+// Reset game
+const resetGame = () => {
+  playerHand.value = []
+  opponentHand.value = []
+  playerScore.value = 0
+  opponentScore.value = 0
+  currentTurn.value = 'player'
+  cardsRemaining.value = 40
+  currentTrick.value = {
+    playerCard: null,
+    opponentCard: null,
+    winner: null,
+    firstPlayer: null,
+  }
+  flyingCards.value = []
+  gameOverVisible.value = false
+  gameOverStats.value = {
+    playerTricks: 0,
+    opponentTricks: 0,
+  }
+  revealTrump.value = false
+}
+</script>

frontend/src/pages/game/SinglePlayerGamePage.vue

@@ -0,0 +1,142 @@
+<template>
+  <div class="relative min-h-screen overflow-hidden">
+    <div v-if="store.isGameRunning" class="absolute top-4 right-4 z-50">
+      <button
+        @click="handleSurrender"
+        class="bg-red-600 hover:bg-red-700 text-white font-bold py-2 px-4 rounded-lg shadow-lg border-2 border-red-800 transition-all transform hover:scale-105 flex items-center gap-2"
+      >
+        <span>🏳️</span> Surrender
+      </button>
+    </div>
+
+    <div v-if="store.isGameRunning">
+      <GameBoard
+        :trump-card="store.trumpCard"
+        :cards-remaining="store.deck.length + (store.trumpCard ? 1 : 0)"
+        :player-hand="store.playerHand"
+        :opponent-hand="store.opponentHand"
+        :player-score="store.playerScore"
+        :opponent-score="store.opponentScore"
+        :current-turn="store.currentTurn"
+        :current-trick="store.table"
+        @play-card="handlePlayCard"
+      />
+    </div>
+
+    <div v-else class="flex h-screen items-center justify-center bg-green-900 text-white">
+      <div class="animate-pulse text-xl">Preparing game...</div>
+    </div>
+
+    <GameOver
+      :is-visible="store.isGameOver"
+      :winner="store.winner || 'draw'"
+      :player-score="store.playerScore"
+      :opponent-score="store.opponentScore"
+      :stats="{ playerTricks: store.playerTricks, opponentTricks: store.opponentTricks }"
+      :is-logging-out="store.isLoggingOut"
+      @play-again="handlePlayAgain"
+      @close="handleCloseModal"
+    />
+  </div>
+</template>
+
+<script setup>
+import { onMounted, onUnmounted, onBeforeMount } from 'vue'
+import { useRouter, onBeforeRouteLeave } from 'vue-router'
+import { toast } from 'vue-sonner' // Import Toast for feedback
+import { useBiscaStore } from '@/stores/bisca'
+import { useAuthStore } from '@/stores/auth'
+import GameBoard from '@/components/game/GameBoard.vue'
+import GameOver from '@/components/game/GameOver.vue'
+
+const props = defineProps({
+  gameType: {
+    type: Number,
+    default: 3,
+  },
+})
+
+const store = useBiscaStore()
+const router = useRouter()
+const authStore = useAuthStore()
+
+onBeforeMount(() => {
+  store.isGameOver = false
+})
+
+onMounted(() => {
+  store.startGame(props.gameType)
+  window.addEventListener('beforeunload', handleBrowserUnload)
+})
+
+onUnmounted(() => {
+  window.removeEventListener('beforeunload', handleBrowserUnload)
+
+  store.isGameOver = false
+  store.isGameRunning = false
+  store.isLoggingOut = false
+})
+
+const handlePlayCard = (card) => {
+  store.playerPlayCard(card)
+}
+
+const handlePlayAgain = () => {
+  store.startGame(props.gameType)
+}
+
+const handleSurrender = () => {
+  const confirmSurrender = window.confirm(
+    'Are you sure you want to surrender? Your opponent will be awarded the win.',
+  )
+
+  if (!confirmSurrender) return
+
+  store.quitGame()
+
+  toast.error('Game Surrendered', {
+    description: 'You forfeited the match.',
+  })
+
+  router.push({ name: 'home' })
+}
+
+const handleCloseModal = () => {
+  if (store.isLoggingOut) {
+    localStorage.removeItem('token')
+    authStore.logout()
+    store.$reset()
+    router.push({ name: 'login' })
+    return
+  }
+
+  store.isGameRunning = false
+  store.isGameOver = false
+  router.push({ name: 'home' })
+}
+
+const handleBrowserUnload = (event) => {
+  if (store.isGameRunning) {
+    event.preventDefault()
+    event.returnValue = ''
+  }
+}
+
+onBeforeRouteLeave((to, from, next) => {
+  if (!store.isGameRunning) {
+    next()
+    return
+  }
+
+  const confirmExit = window.confirm(
+    '⚠️ Game in Progress!\n\nIf you leave now, the game will be cancelled and recorded as a LOSS.\n\nAre you sure you want to leave?',
+  )
+
+  if (confirmExit) {
+    store.quitGame()
+    next()
+  } else {
+    next(false)
+  }
+})
+</script>

frontend/src/pages/home/HomePage.vue

@@ -1,11 +1,242 @@
-<template>
-    <div>
-
-    </div>
-</template>
-
 <script setup>
+import { ref, onMounted, nextTick } from 'vue'
+import { Button } from '@/components/ui/button'
+import {
+    Card,
+    CardContent,
+    CardDescription,
+    CardHeader,
+    CardTitle
+} from '@/components/ui/card'
+import { useAPIStore } from '@/stores/api'
+import { useRouter } from 'vue-router'
 
+const apiStore = useAPIStore()
+const router = useRouter()
+const openGames = ref([])
+const selectedMode = ref('9')
+const observerTarget = ref(null);
+const observer = ref(null);
+const isLoading = ref(false);
+const pageCounter = ref(1);
+const showHostModal = ref(false)
+const showJoinModal = ref(false)
+const selectedGame = ref(null)
+const isReady = ref(false)
+
+const setupObserver = () => {
+    if (observer.value) observer.value.disconnect();
+
+    observer.value = new IntersectionObserver((entries) => {
+        if (entries[0].isIntersecting && !isLoading.value && openGames.value.length > 0) {
+            getPendingGames();
+        }
+    }, { threshold: 0.1 });
+
+    if (observerTarget.value) {
+        observer.value.observe(observerTarget.value);
+    }
+}
+
+const getPendingGames = async (mode = selectedMode.value) => {
+    if (isLoading.value) return;
+    isLoading.value = true;
+
+
+    apiStore.gameQueryParameters.page = pageCounter.value++;
+    apiStore.gameQueryParameters.filters.sort_direction = "asc"
+    apiStore.gameQueryParameters.filters.type = mode
+    apiStore.gameQueryParameters.filters.status = 'Pending'
+    try {
+        const response = await apiStore.getGames();
+        const newGames = response.data.data;
+        openGames.value = [...openGames.value, ...newGames];
+    } finally {
+        isLoading.value = false;
+    }
+}
+
+const clickMode = async (mode) => {
+    if (selectedMode.value === mode) return;
+    openGames.value = [];
+    selectedMode.value = mode;
+    pageCounter.value = 1;
+    await getPendingGames();
+    setupObserver();
+}
+
+const startSingle = () => {
+    router.push({ name: 'bisca' + selectedMode.value });
+}
+
+const JoinGameModal = (game) => {
+    selectedGame.value = game
+    isReady.value = false
+    showJoinModal.value = true
+}
+
+const hostGameModal = () => {
+    showHostModal.value = true
+}
+
+const toggleReady = () => {
+    isReady.value = !isReady.value
+}
+
+onMounted(async () => {
+    await getPendingGames();
+    await nextTick();
+    setupObserver();
+})
 </script>
 
-<style scoped></style>`
+<template>
+    <div class="min-h-screen bg-cover bg-center transition-all duration-700">
+
+        <div class="flex flex-col justify-center items-center gap-5 pt-10 px-4">
+
+            <div class="relative w-full max-w-md bg-card rounded-lg border shadow-sm overflow-hidden">
+                <div class="relative h-14 flex items-center">
+
+                    <button @click="clickMode('9')"
+                        class="h-full flex items-center justify-center font-semibold transition-all duration-500 ease-in-out border-r last:border-r-0"
+                        :class="{
+                            'w-2/3 z-10 text-purple-600 dark:text-purple-400 bg-purple-500/10': selectedMode === '9',
+                            'w-1/3 z-0 text-muted-foreground/40 bg-transparent': selectedMode !== '9'
+                        }">
+                        <span>Bisca de 9</span>
+                    </button>
+
+                    <button @click="clickMode('3')"
+                        class="h-full flex items-center justify-center font-semibold transition-all duration-500 ease-in-out"
+                        :class="{
+                            'w-2/3 z-10 text-purple-600 dark:text-purple-400 bg-purple-500/10': selectedMode === '3',
+                            'w-1/3 z-0 text-muted-foreground/40 bg-transparent': selectedMode !== '3'
+                        }">
+                        <span>Bisca de 3</span>
+                    </button>
+
+                </div>
+            </div>
+
+            <div class="flex flex-col items-center gap-5 w-[100vw]">
+                <Card class="w-full max-w-2xl">
+                    <CardHeader>
+                        <CardTitle class="text-3xl font-bold text-center">
+                            Single Player
+                        </CardTitle>
+                        <CardDescription class="text-center">
+                            Go against one of our bots!
+                        </CardDescription>
+                    </CardHeader>
+                    <CardContent class="space-y-6">
+                        <div class="flex justify-center">
+                            <Button @click="startSingle()" size="lg" variant="secondary"
+                                class="hover:bg-purple-500 hover:text-slate-200">
+                                Start Game
+                            </Button>
+                        </div>
+                    </CardContent>
+                </Card>
+                <Card class="w-full max-w-2xl">
+                    <CardHeader>
+                        <CardTitle class="text-3xl font-bold text-center">
+                            MultiPlayer
+                        </CardTitle>
+                        <CardDescription class="text-center">
+                            Go one on one with another player!
+                        </CardDescription>
+                    </CardHeader>
+                    <CardContent class="space-y-6">
+                        <label class="text-sm font-medium">Open games (oldest first)</label>
+                        <div class="rounded-lg border bg-card text-card-foreground shadow-sm">
+                            <div v-if="openGames.length === 0" class="p-6 text-center text-sm text-muted-foreground">
+                                No open games yet. Try hosting one!
+                            </div>
+                            <div v-else class="max-h-[350px] overflow-y-auto custom-scrollbar p-1">
+
+                                <div v-for="(game, index) in openGames" :key="game.id" @click="JoinGameModal(game)"
+                                    class="flex items-center justify-between p-3 mb-2 border border-transparent rounded-lg transition-all hover:bg-muted/50 hover:border-purple-500">
+
+                                    <div class="flex items-center gap-3">
+                                        <div
+                                            class="flex h-8 w-8 items-center justify-center rounded-full text-xs font-bold bg-green-100 text-green-700">
+                                            {{ index + 1 }}
+                                        </div>
+                                        <div>
+                                            <div class="font-medium text-sm">Started: {{ game.began_at }}</div>
+                                            <div class="text-xs text-muted-foreground">host: {{
+                                                game.player1?.nickname || 'Anonymous' }}</div>
+                                        </div>
+                                    </div>
+                                </div>
+
+                                <div ref="observerTarget" class="h-10 flex items-center justify-center">
+                                    <span v-if="isLoading" class="text-xs text-purple-500 animate-pulse">Loading
+                                        more...</span>
+                                </div>
+                            </div>
+                        </div>
+                        <div class="flex justify-center">
+                            <Button @click="hostGameModal()" size="lg" variant="secondary"
+                                class="hover:bg-purple-500 hover:text-slate-200">
+                                Host Game
+                            </Button>
+                        </div>
+                    </CardContent>
+                </Card>
+            </div>
+        </div>
+        <div v-if="showHostModal"
+            class="fixed inset-0 z-50 flex items-center justify-center bg-black/50 backdrop-blur-sm">
+            <Card class="w-full max-w-sm border-purple-500 shadow-2xl">
+                <CardHeader>
+                    <CardTitle class="text-center">Hosting Game</CardTitle>
+                </CardHeader>
+                <CardContent class="flex flex-col items-center gap-6 py-10">
+                    <div class="relative">
+                        <div
+                            class="h-16 w-16 animate-spin rounded-full border-4 border-purple-500 border-t-transparent">
+                        </div>
+                    </div>
+                    <p class="animate-pulse text-lg font-medium text-muted-foreground">Waiting for opponents...</p>
+                    <Button variant="outline" @click="showHostModal = false">Cancel Hosting</Button>
+                </CardContent>
+            </Card>
+        </div>
+        <div v-if="showJoinModal"
+            class="fixed inset-0 z-50 flex items-center justify-center bg-black/50 backdrop-blur-sm">
+            <Card class="w-full max-w-md border-purple-500 shadow-2xl">
+                <CardHeader>
+                    <CardTitle>Join Game</CardTitle>
+                    <CardDescription v-if="selectedGame">
+                        Hosted by {{ selectedGame.player1?.nickname || 'Anonymous' }}
+                    </CardDescription>
+                </CardHeader>
+
+                <CardContent class="space-y-4">
+                    <div class="rounded-lg bg-muted p-4 text-sm">
+                        <p><strong>Game Type:</strong> Bisca de {{ selectedMode }}</p>
+                        <p><strong>Started at:</strong> {{ selectedGame?.began_at }}</p>
+                    </div>
+
+                    <div v-if="isReady"
+                        class="flex items-center justify-center rounded-md bg-green-500/10 p-3 text-green-600 dark:text-green-400">
+                        <span class="animate-pulse font-semibold">Waiting for the host to start...</span>
+                    </div>
+
+                    <div class="flex gap-3 pt-4">
+                        <Button variant="destructive" class="flex-1" @click="showJoinModal = false">
+                            Leave
+                        </Button>
+
+                        <Button class="flex-1 transition-all duration-300" :variant="isReady ? 'outline' : 'default'"
+                            :class="!isReady ? 'bg-purple-600 hover:bg-purple-700' : ''" @click="toggleReady">
+                            {{ isReady ? 'Cancel Ready' : 'Ready up' }}
+                        </Button>
+                    </div>
+                </CardContent>
+            </Card>
+        </div>
+    </div>
+</template>

frontend/src/pages/login/LoginPage.vue

@@ -1,5 +1,5 @@
 <template>
-    <div class="flex min-h-screen items-center justify-center bg-gray-50 px-4 py-12 sm:px-6 lg:px-8">
+    <div class="flex min-h-screen items-center justify-center px-4 py-12 sm:px-6 lg:px-8">
         <div class="w-full max-w-md space-y-8">
             <div>
                 <h2 class="mt-6 text-center text-3xl font-bold tracking-tight text-gray-900">
@@ -27,6 +27,14 @@
                         <Input id="password" v-model="formData.password" type="password" autocomplete="current-password"
                             required placeholder="••••••••" />
                     </div>
+
+                    <div class="flex items-center pb-2">
+                        <input id="remember-me" type="checkbox" v-model="formData.rememberMe"
+                            class="h-4 w-4 text-blue-600 focus:ring-blue-500 border-gray-300 rounded ml-1" />
+                        <label for="remember-me" class="ml-2 block text-sm text-gray-900">
+                            Remember me
+                        </label>
+                    </div>
                 </div>
 
 
@@ -59,21 +67,21 @@ const router = useRouter()
 
 const formData = ref({
     email: 'pa@mail.pt',
-    password: '123'
+    password: '123',
+    rememberMe: false
 })
 
 
 const handleSubmit = async () => {
-
-    toast.promise(authStore.login(formData.value), {
+    const promise = authStore.login(formData.value)
+    toast.promise(promise, {
         loading: 'Calling API',
-        success: (data) => {
-            return `Login Sucessfull - ${data?.name}`
-        },
-        error: (data) => `[API] Error saving game - ${data?.response?.data?.message}`,
-    })
-
-
+        success: (user) => {
             router.push('/')
+            return `Login Successful - ${user.name}`
+        },
+        error: (error) =>
+            error.response?.data?.message
+    })
 }
 </script>

frontend/src/pages/user/UserPage.css

@@ -0,0 +1,19 @@
+/* UserPage.css - Custom styles that can't be done with Tailwind */
+
+.spinner {
+  width: 40px;
+  height: 40px;
+  border: 3px solid #f0f0f0;
+  border-top: 3px solid #000;
+  border-radius: 50%;
+  animation: spin 1s linear infinite;
+}
+
+@keyframes spin {
+  0% {
+    transform: rotate(0deg);
+  }
+  100% {
+    transform: rotate(360deg);
+  }
+}