Admin platform, with users, transactions, games and admin creation

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

.gitignore

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

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,12 +54,24 @@ 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);
+        }
+
+        $avatarFilename = null;
+
+        if ($request->hasFile('photo_avatar_filename')) {
+            $file = $request->file('photo_avatar_filename');
+            $path = $file->store('photos_avatars', 'public');
+            $avatarFilename = basename($path);
+        }
+
         $user = User::create([
             'email' => $request->email,
             'nickname' => $request->nickname,
             'name' => $request->name,
             'password' => bcrypt($request->password),
-            'photo_avatar_filename' => $request->photo,
+            'photo_avatar_filename' => $avatarFilename,
             'type' => 'P',
             'blocked' => false,
             'coins_balance' => 10,

api/app/Http/Controllers/CoinPurchaseController.php

@@ -0,0 +1,76 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+use App\Models\CoinPurchase;
+use App\Models\CoinTransaction;
+use App\Models\CoinTransactionType;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\DB;
+
+class CoinPurchaseController extends Controller
+{
+    public function store(Request $request)
+    {
+        $validated = $request->validate([
+            'euros' => 'required|numeric|min:1|max:100',
+            'payment_type' => 'required|in:MBWAY,MB,VISA,PAYPAL',
+            'payment_reference' => [
+                'required',
+                function ($attribute, $value, $fail) use ($request) {
+                    $type = $request->payment_type;
+                    $regex = null;
+
+                    switch ($type) {
+                        case 'MBWAY': $regex = '/^9[0-9]{8}$/'; break;
+                        case 'MB':    $regex = '/^[0-9]{5}-[0-9]{9}$/'; break;
+                        case 'VISA':  $regex = '/^4[0-9]{15}$/'; break;
+                        case 'PAYPAL':
+                            if (!filter_var($value, FILTER_VALIDATE_EMAIL)) {
+                                $fail("Invalid PayPal email.");
+                            }
+                            return;
+                    }
+
+                    if ($regex && !preg_match($regex, $value)) {
+                        $fail("Invalid format for $type.");
+                    }
+                },
+            ],
+        ]);
+
+        $user = $request->user();
+        $coinsAmount = $validated['euros'] * 10; 
+
+        return DB::transaction(function () use ($user, $validated, $coinsAmount) {
+            
+            $type = CoinTransactionType::firstOrCreate(['name' => 'Coin purchase'], ['type' => 'C']);
+
+            $transaction = CoinTransaction::create([
+                'user_id' => $user->id,
+                'coin_transaction_type_id' => $type->id,
+                'transaction_datetime' => now(),
+                'coins' => $coinsAmount,
+            ]);
+
+            $purchase = CoinPurchase::create([
+                'purchase_datetime' => now(),
+                'user_id' => $user->id,
+                'coin_transaction_id' => $transaction->id,
+                'euros' => $validated['euros'],
+                'payment_type' => $validated['payment_type'],
+                'payment_reference' => $validated['payment_reference'],
+            ]);
+
+            $user->increment('coins_balance', $coinsAmount);
+
+            return response()->json([
+                'message' => 'Purchase successful',
+                'balance' => $user->coins_balance,
+                'transaction_id' => $transaction->id,
+                'purchase' => $purchase,
+            ], 201);
+        });
+    }
+}

api/app/Http/Controllers/GameController.php

@@ -4,16 +4,26 @@ namespace App\Http\Controllers;
 
 use App\Models\Game;
 use Illuminate\Http\Request;
-use App\Http\Requests\StoreGameRequest;
 use Illuminate\Support\Facades\Auth;
-use App\Models\MatchGame;
 
 class GameController extends Controller
 {
+    const GHOST_ID = 1;
+
     public function index(Request $request)
     {
+        $this->authorize('viewAny', Game::class);
+        
+        $user = Auth::user();
         $query = Game::query()->with(["winner", "player1", "player2"]);
         
+        if ($user->type !== 'A') {
+            $query->where(function ($q) use ($user) {
+                $q->where('player1_user_id', $user->id)
+                  ->orWhere('player2_user_id', $user->id);
+            });
+        }
+
         if ($request->has("type") && in_array($request->type, ["3", "9"])) {
             $query->where("type", $request->type);
         }
@@ -30,100 +40,70 @@ class GameController extends Controller
             $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",
         ]);
 
         $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(
+            $q->where("player1_user_id", $user->id)
-                "player2_user_id",
+              ->orWhere("player2_user_id", $user->id);
-                $user->id,
-            );
         })
-            ->whereIn("status", ["Pending", "Playing"])
+        ->whereIn("status", ["Pending", "Playing"])
-            ->exists();
+        ->exists();
 
-        if ($activeMatch || $activeGame) {
+        if ($activeGame) {
-            return response()->json(
+            return response()->json(["message" => "You already have an active game."], 400);
-                ["message" => "You already have an active game or match."],
-                400,
-            );
         }
 
         $game = Game::create([
             "type" => $validated["type"],
             "status" => "Pending",
             "player1_user_id" => $user->id,
-            "player2_user_id" => null,
+            "player2_user_id" => self::GHOST_ID, 
-            "winner_user_id" => null,
+            "winner_user_id" => self::GHOST_ID,
-            "loser_user_id" => null,
+            "loser_user_id" => self::GHOST_ID,
             "began_at" => now(),
             "player1_points" => 0,
             "player2_points" => 0,
             "custom" => null,
         ]);
 
-        return response()->json(
+        return response()->json([
-            [
+            "message" => "Multiplayer game room created",
-                "message" => "Multiplayer game room created",
+            "game" => $game,
-                "game" => $game,
+        ], 201);
-            ],
-            201,
-        );
     }
 
     public function join(Game $game)
     {
+        $this->authorize('join', $game);
+        
         $user = Auth::user();
 
         if ($game->player1_user_id == $user->id) {
-            return response()->json(
+            return response()->json([
-                [
+                "message" => "You are the host. Waiting for opponent...",
-                    "message" => "Waiting for opponent...",
+                "game" => $game
-                    "game" => $game,
+            ], 200);
-                ],
-                200,
-            );
         }
 
-        if ($game->status !== "Pending") {
+        if ($game->player2_user_id !== self::GHOST_ID) {
-            return response()->json(
+            return response()->json(["message" => "Game is full"], 400);
-                ["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,
-            );
         }
 
         $game->update([
@@ -131,23 +111,24 @@ class GameController extends Controller
             "player2_user_id" => $user->id,
         ]);
 
-        return response()->json(
+        return response()->json([
-            [
+            "message" => "Joined successfully!",
-                "message" => "Joined successfully! Game starts now.",
+            "game" => $game,
-                "game" => $game,
+        ], 200);
-            ],
-            200,
-        );
     }
 
     public function show(Game $game)
     {
+        $this->authorize('view', $game);
+        
         $game->load(["player1", "player2", "winner"]);
         return response()->json($game);
     }
 
     public function update(Request $request, Game $game)
     {
+        $this->authorize('update', $game);
+        
         if ($game->status == "Ended") {
             return response()->json(["message" => "Game already ended"], 400);
         }
@@ -170,4 +151,25 @@ class GameController extends Controller
 
         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/MatchController.php

@@ -4,9 +4,12 @@ namespace App\Http\Controllers;
 
 use App\Models\MatchGame;
 use App\Models\Game;
+use App\Models\CoinTransaction;
+use App\Models\CoinTransactionType;
 use Illuminate\Http\Request;
 use App\Http\Requests\StoreMatchRequest;
 use Illuminate\Support\Facades\Auth;
+use Illuminate\Support\Facades\DB;
 
 class MatchController extends Controller
 {    
@@ -30,42 +33,59 @@ class MatchController extends Controller
     public function store(StoreMatchRequest $request)
     {        
         $validated = $request->validated();
-        $user = Auth::user();
+        $user = $request->user(); 
+        $stake = $validated['stake'];
+
+        if ($user->coins_balance < $stake) {
+            return response()->json(['message' => 'Insufficient coin balance'], 400);
+        }
 
         $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) {
+        if ($activeMatch) { 
-            $q->where('player1_user_id', $user->id)
+            return response()->json(['message' => 'You already have an active match.'], 400);
-              ->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);
         }
 
-        $match = MatchGame::create([
+        return DB::transaction(function () use ($validated, $user, $stake) {
-            'type' => $validated['type'],
+            $GHOST_ID = 1;
-            'status' => 'Pending',
-            'player1_user_id' => $user->id,
-            'player2_user_id' => $user->id,
-            'winner_user_id' => $user->id,
-            'loser_user_id' => $user->id,
-            'stake' => $validated['stake'],
-            'began_at' => now(),
-            'player1_marks' => 0,
-            'player2_marks' => 0,
-            'player1_points' => 0,
-            'player2_points' => 0,
-            'custom' => null
-        ]);
 
-        return response()->json([
+            $user->decrement('coins_balance', $stake);
-            'message' => 'Match created successfully',
+
-            'match' => $match
+            $stakeType = CoinTransactionType::firstOrCreate(
-        ], 201);
+                ['name' => 'Match stake'],
+                ['type' => 'D'] // Debit
+            );
+
+            $match = MatchGame::create([
+                'type' => $validated['type'],
+                'status' => 'Pending',
+                'player1_user_id' => $user->id,
+                'player2_user_id' => $GHOST_ID, 
+                'winner_user_id' => $GHOST_ID,
+                'loser_user_id' => $GHOST_ID,
+                'stake' => $stake,
+                'began_at' => now(),
+                'player1_marks' => 0, 'player2_marks' => 0,
+                'player1_points' => 0, 'player2_points' => 0,
+            ]);
+
+            CoinTransaction::create([
+                'user_id' => $user->id,
+                'match_id' => $match->id,
+                'coin_transaction_type_id' => $stakeType->id,
+                'transaction_datetime' => now(),
+                'coins' => -$stake,
+            ]);
+
+            return response()->json([
+                'message' => 'Match created successfully',
+                'match' => $match,
+                'balance' => $user->coins_balance
+            ], 201);
+        });
     }
 
     public function show(MatchGame $match)
@@ -76,16 +96,19 @@ class MatchController extends Controller
 
     public function join(MatchGame $match)
     {
-        $user = Auth::user();
+        $user = request()->user();
 
         if ($match->player1_user_id == $user->id) {
-            return response()->json(['message' => 'Waiting for opponent...', 'match' => $match]);
+            return response()->json(['message' => 'You cannot join your own match'], 400);
         }
-
         if ($match->status !== 'Pending') {
             return response()->json(['message' => 'Match is full or started'], 400);
         }
 
+        if ($user->coins_balance < $match->stake) {
+            return response()->json(['message' => 'Insufficient coin balance to join this match'], 400);
+        }
+
         $activeMatch = MatchGame::where(function ($q) use ($user) {
             $q->where('player1_user_id', $user->id)
               ->orWhere('player2_user_id', $user->id);
@@ -95,15 +118,33 @@ class MatchController extends Controller
              return response()->json(['message' => 'You are already in another active match.'], 400);
         }
 
-        $match->update([
+        return DB::transaction(function () use ($match, $user) {
-            'status' => 'Playing',
+            $user->decrement('coins_balance', $match->stake);
-            'player2_user_id' => $user->id
-        ]);
 
-        return response()->json([
+            $stakeType = CoinTransactionType::firstOrCreate(
-            'message' => 'Joined match successfully!',
+                ['name' => 'Match stake'],
-            'match' => $match
+                ['type' => 'D']
-        ]);
+            );
+
+            CoinTransaction::create([
+                'user_id' => $user->id,
+                'match_id' => $match->id,
+                'coin_transaction_type_id' => $stakeType->id,
+                'transaction_datetime' => now(),
+                'coins' => -$match->stake, 
+            ]);
+
+            $match->update([
+                'status' => 'Playing',
+                'player2_user_id' => $user->id
+            ]);
+
+            return response()->json([
+                'message' => 'Joined match successfully!',
+                'match' => $match,
+                'balance' => $user->coins_balance
+            ]);
+        });
     }
 
     public function update(Request $request, MatchGame $match)
@@ -123,12 +164,36 @@ class MatchController extends Controller
             'total_time' => 'numeric'
         ]);
 
-        if (isset($data['status']) && $data['status'] === 'Ended') {
+        return DB::transaction(function () use ($match, $data) {
-            $data['ended_at'] = now();
-        }
             
-        $match->update($data);
+            if (isset($data['status']) && $data['status'] === 'Ended') {
+                $data['ended_at'] = now();
+            }
 
-        return response()->json($match);
+            $match->update($data);
+
+            if ($match->status === 'Ended' && $match->stake > 0 && $match->winner_user_id) {
+                
+                $payoutType = CoinTransactionType::firstOrCreate(
+                    ['name' => 'Match payout'],
+                    ['type' => 'C'] // Credit
+                );
+
+                $totalPrize = $match->stake * 2;
+
+                CoinTransaction::create([
+                    'user_id' => $match->winner_user_id,
+                    'match_id' => $match->id,
+                    'coin_transaction_type_id' => $payoutType->id,
+                    'transaction_datetime' => now(),
+                    'coins' => $totalPrize,
+                ]);
+
+
+                $match->winner->increment('coins_balance', $totalPrize);
+            }
+
+            return response()->json($match);
+        });
     }
 }

api/app/Http/Controllers/ProfileController.php

@@ -3,6 +3,12 @@
 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
 {
@@ -52,7 +58,7 @@ class ProfileController extends Controller
 
         $user = $request->user();
 
-        if (!\Hash::check($request->current_password, $user->password)) {
+        if (!Hash::check($request->current_password, $user->password)) {
             return response()->json(
                 [
                     "message" => "Current password is incorrect",
@@ -61,7 +67,7 @@ class ProfileController extends Controller
             );
         }
 
-        $user->password = \Hash::make($request->new_password);
+        $user->password = Hash::make($request->new_password);
         $user->save();
 
         return response()->json([
@@ -69,6 +75,13 @@ class ProfileController extends Controller
         ]);
     }
 
+    public function getCoins(Request $request)
+    {
+        return response()->json([
+            'coins' => $request->user()->coins_balance
+        ]);
+    }
+
     public function updateAvatar(Request $request)
     {
         $request->validate([
@@ -78,7 +91,7 @@ class ProfileController extends Controller
         $user = $request->user();
 
         if ($user->photo_avatar_filename) {
-            \Storage::disk("public")->delete(
+            Storage::disk("public")->delete(
                 "photos_avatars/" . $user->photo_avatar_filename,
             );
         }
@@ -87,7 +100,7 @@ class ProfileController extends Controller
         $filename =
             str_pad($user->id, 5, "0", STR_PAD_LEFT) .
             "_" .
-            \Str::random(10) .
+            Str::random(10) .
             "." .
             $file->extension();
         $file->storeAs("photos_avatars", $filename, "public");

api/app/Http/Controllers/StatisticsController.php

@@ -0,0 +1,136 @@
+<?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;
+use App\Models\CoinTransaction;
+
+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');
+
+        $leaderboard = User::where('type', 'P')
+            ->withCount(['wonGames' => function ($query) use ($type) {
+                if ($type) {
+                    $query->where('type', $type);
+                }
+            }])
+            ->orderBy('won_games_count', 'desc')
+            ->paginate(10);
+
+        $leaderboard->through(function ($user) {
+            return [
+                'id' => $user->id,
+                'nickname' => $user->nickname,
+                'photo_avatar_filename' => $user->photo_avatar_filename,
+                'won_games_count' => $user->won_games_count,
+            ];
+        });
+
+        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
+        ]);
+    }
+
+    public function getAdminStats()
+    {
+        $totalPlayers = User::where('type', 'P')->count();
+        $totalGames = Game::count();
+        $totalBlockedUsers = User::where('blocked', true)->count();
+        
+        $gamesByType = Game::select('type', DB::raw('count(*) as total'))
+            ->groupBy('type')
+            ->get();
+
+
+        $gamesPerMonth = Game::select(
+                DB::raw("strftime('%Y-%m', began_at) as month"), 
+                DB::raw('count(*) as total')
+            )
+            ->whereNotNull('began_at')
+            ->groupBy('month')
+            ->orderBy('month', 'desc')
+            ->limit(12)
+            ->get();
+
+        $totalCoinsPurchased = \App\Models\CoinTransaction::whereHas('type', function($q) {
+                $q->where('name', 'Coin purchase');
+            })
+            ->sum('coins');
+
+        $purchasesPerMonth = \App\Models\CoinTransaction::join('coin_transaction_types', 'coin_transactions.coin_transaction_type_id', '=', 'coin_transaction_types.id')
+            ->where('coin_transaction_types.name', 'Coin purchase')
+            ->select(
+                DB::raw("strftime('%Y-%m', coin_transactions.transaction_datetime) as month"), 
+                DB::raw('SUM(coin_transactions.coins) as total_coins')
+            )
+            ->groupBy('month')
+            ->orderBy('month', 'desc')
+            ->limit(12)
+            ->get();
+
+        return response()->json([
+            'global_counters' => [
+                'total_players' => $totalPlayers,
+                'total_games' => $totalGames,
+                'blocked_users' => $totalBlockedUsers,
+                'total_coins_purchased' => (int) $totalCoinsPurchased,
+            ],
+            'charts' => [
+                'games_by_type' => $gamesByType,
+                'games_per_month' => $gamesPerMonth,
+                'purchases_per_month' => $purchasesPerMonth,
+            ]
+        ]);
+    }
+}

api/app/Http/Controllers/TransactionController.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\CoinTransaction;
+use Illuminate\Http\Request;
+
+class TransactionController extends Controller
+{
+    
+    public function index(Request $request)
+    {
+
+        $this->authorize('viewAny', CoinTransaction::class);
+
+        $query = CoinTransaction::with('user:id,nickname,email', 'type:id,name');
+        
+        if ($request->has('sort_coins')) {
+            $direction = $request->get('sort_coins') === 'asc' ? 'asc' : 'desc';
+            $query->orderBy('coins', $direction);
+        } 
+        
+        $dateDirection = $request->get('sort_datetime') === 'asc' ? 'asc' : 'desc';
+        $query->orderBy('transaction_datetime', $dateDirection);
+
+       
+        $transactions = $query->paginate(15);
+
+        return response()->json($transactions);
+    }
+}

api/app/Http/Controllers/UserController.php

@@ -17,13 +17,18 @@ class UserController extends Controller
      */
     public function index(Request $request)
     {
+        $this->authorize('viewAny', User::class);
+
         $query = User::query();
 
-        // Filtros úteis para o Backoffice
         if ($request->has('type')) {
             $query->where('type', $request->type);
         }
 
+        if ($request->has('blocked')) {
+            $query->where('blocked', $request->type);
+        }
+
         if ($request->has('search')) {
             $query->where(function ($q) use ($request) {
                 $q->where('name', 'like', '%'.$request->search.'%')
@@ -41,9 +46,10 @@ class UserController extends Controller
      */
     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',
@@ -73,7 +79,11 @@ 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,
@@ -82,8 +92,6 @@ class UserController extends Controller
                 'type' => $user->type,
             ]);
         }
-
-        return response()->json($user);
     }
 
     /**
@@ -92,11 +100,7 @@ class UserController extends Controller
      */
     public function update(Request $request, User $user)
     {
-        $currentUser = Auth::user();
+        $this->authorize('update', $user);
-
-        if ($currentUser->id !== $user->id && $currentUser->type !== 'A') {
-            return response()->json(['message' => 'Unauthorized'], 403);
-        }
         
         $validated = $request->validate([
             'name' => 'sometimes|string|max:255',
@@ -112,16 +116,8 @@ class UserController extends Controller
                 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');
@@ -133,30 +129,52 @@ class UserController extends Controller
         return response()->json($user);
     }
 
+
+    public function updatePassword(Request $request, User $user)
+    {
+        $this->authorize('update', $user);
+
+        $validated = $request->validate([
+            'current_password' => 'required|string',
+            'new_password' => 'required|string|min:3|confirmed',
+        ]);
+
+        // Verificar se a password atual está correta
+        if (!Hash::check($validated['current_password'], $user->password)) {
+            return response()->json(['message' => 'Current password is incorrect'], 403);
+        }
+
+        // Atualizar para a nova password
+        $user->password = Hash::make($validated['new_password']);
+        $user->save();
+
+        return response()->json(['message' => 'Password updated successfully']);
+    }
+
     /**
      * DELETE /api/users/{user}
      * Apagar conta (Soft Delete)
      */
     public function destroy(User $user)
     {
-        $currentUser = Auth::user();
+        $this->authorize('delete', $user);
 
-        if ($currentUser->id !== $user->id && $currentUser->type !== 'A') {
+        // Check if user has transactions or games - if so, soft delete
-            return response()->json(['message' => 'Unauthorized'], 403);
+        $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') {
+        return response()->json(['message' => $message]);
-            if ($user->type === 'A') {
-                return response()->json(
-                    ['message' => 'Admins cannot delete their own account'],
-                    403,
-                );
-            }
-        }
-
-        $user->delete();
-
-        return response()->json(['message' => 'User deleted successfully']);
     }
 
     /**
@@ -165,23 +183,124 @@ class UserController extends Controller
      */
     public function getMatches(Request $request, User $user)
     {
-        $currentUser = Auth::user();
+        $this->authorize('view', $user);
 
-        if ($currentUser->id !== $user->id && $currentUser->type !== 'A') {
+        $outcomeSql = "CASE 
-            return response()->json(['message' => 'Unauthorized'], 403);
+            WHEN is_draw = 1 THEN 'DRAW'
+            WHEN winner_user_id = {$user->id} THEN 'WIN'
+            ELSE 'LOSS'
+        END";
+
+        $query = Game::query()
+        ->select('*')
+        ->selectRaw("($outcomeSql) as outcome_text")
+        ->where(function ($q) use ($user) {
+            $q->where('player1_user_id', $user->id)
+              ->orWhere('player2_user_id', $user->id);
+        })
+        ->with(['winner', 'player1', 'player2']);
+
+        if ($request->has('type')) {
+            $query->where('type', $request->type); 
         }
 
-        $matches = Game::query()
+        if ($request->has('status')) {
-            ->where(function ($q) use ($user) {
+            $query->where('status', $request->status);
-                $q->where('player1_user_id', $user->id)->orWhere(
+        }
-                    'player2_user_id',
+
-                    $user->id,
+        if ($request->filled('outcome')) {
-                );
+        switch ($request->outcome) {
-            })
+            case 'win':
-            ->with(['winner', 'player1', 'player2'])
+                $query->where('winner_user_id', $user->id)
-            ->orderBy('began_at', 'desc')
+                      ->where('is_draw', 0);
-            ->paginate(10);
+                break;
+            case 'loss':
+            case 'forfeit': // Forfeit treated as loss for now
+                $query->where('loser_user_id', $user->id)
+                      ->where('is_draw', 0);
+                break;
+            case 'draw':
+                $query->where('is_draw', 1);
+                break;
+        }
+    }
+
+        if ($request->has('date_from')) {
+            $query->whereDate('began_at', '>=', $request->date_from);
+        }
+
+        if ($request->has('date_to')) {
+            $query->whereDate('ended_at', '<=', $request->date_to);
+        }
+
+        $order = $request->get('sort_by', 'began_at');
+        $direction = $request->get('sort_direction', 'desc');
+
+        if ($order === 'outcome') {
+            $query->orderBy('outcome_text', $direction);
+        } else {
+            $query->orderBy($order, $direction);
+        }
+
+        $matches = $query->orderBy($order, $direction)
+                              ->paginate(10);
 
         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']);
+    }
+
+    public function getTransactions(Request $request, User $user)
+    {
+        if ($request->user()->id !== $user->id && $request->user()->type !== 'A') {
+            return response()->json(['message' => 'Forbidden'], 403);
+        }
+
+        $query = $user->transactions()->with('type');
+
+        if ($request->has('type')) {
+            $query->whereHas('type', function ($q) use ($request) {
+                $q->where('type', $request->type);
+            });
+        }
+
+        if ($request->has('date_from')) {
+            $query->whereDate('transaction_datetime', '>=', $request->date_from);
+        }
+
+        if ($request->has('date_to')) {
+            $query->whereDate('transaction_datetime', '<=', $request->date_to);
+        }
+
+        $transactions = $query->orderBy('transaction_datetime', 'desc')
+                              ->paginate(10);
+
+        return response()->json($transactions);
+    }
+
+    public function getMyTransactions(Request $request)
+    {
+        return $this->getTransactions($request, $request->user());
+    }
 }

api/app/Http/Requests/RegisterRequest.php

@@ -26,7 +26,7 @@ class RegisterRequest extends FormRequest
             'nickname' => 'required|string|max:255',
             'name' => 'required|string|max:255',
             'password' => 'required|string|min:3',
-            'photo' => 'nullable|string',
+            'photo' => 'nullable|image|mimes:jpeg,png,jpg,gif|max:2048',
         ];
     }
 }

api/app/Models/CoinPurchase.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+
+class CoinPurchase extends Model
+{
+    use HasFactory;
+    
+    protected $table = 'coin_purchases';
+    public $timestamps = false;
+
+    protected $fillable = [
+        'purchase_datetime',
+        'user_id',
+        'coin_transaction_id',
+        'euros',
+        'payment_type',
+        'payment_reference',
+        'custom'
+    ];
+
+    protected $casts = [
+        'purchase_datetime' => 'datetime',
+        'custom' => 'array',
+    ];
+
+    public function transaction()
+    {
+        return $this->belongsTo(CoinTransaction::class, 'coin_transaction_id');
+    }
+}

api/app/Models/CoinTransaction.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+
+class CoinTransaction extends Model
+{
+    use HasFactory;
+
+    protected $table = 'coin_transactions';
+    
+    public $timestamps = false; 
+
+    protected $fillable = [
+        'transaction_datetime',
+        'user_id',
+        'match_id',
+        'game_id',
+        'coin_transaction_type_id',
+        'coins',
+        'custom'
+    ];
+
+    protected $casts = [
+        'transaction_datetime' => 'datetime',
+        'custom' => 'array',
+    ];
+
+    public function type()
+    {
+        return $this->belongsTo(CoinTransactionType::class, 'coin_transaction_type_id');
+    }
+
+    public function user()
+    {
+        return $this->belongsTo(User::class);
+    }
+}

api/app/Models/CoinTransactionType.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class CoinTransactionType extends Model
+{
+    use HasFactory, SoftDeletes;
+
+    protected $table = 'coin_transaction_types';
+
+    protected $fillable = ['name', 'type', 'custom'];
+
+    protected $casts = [
+        'custom' => 'array',
+    ];
+}

api/app/Models/Game.php

@@ -3,7 +3,6 @@
 namespace App\Models;
 
 use Illuminate\Database\Eloquent\Model;
-use App\Http\Requests\StoreGameRequest;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 
 

api/app/Models/User.php

@@ -48,4 +48,19 @@ class User extends Authenticatable
         '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);
+    }
+
+    public function transactions()
+    {
+        return $this->hasMany(CoinTransaction::class);
+    }
 }

api/app/Policies/CoinTransactionPolicy.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace App\Policies;
+
+use App\Models\CoinTransaction;
+use App\Models\User;
+use Illuminate\Auth\Access\Response;
+
+class CoinTransactionPolicy
+{
+    /**
+     * Determine whether the user can view any models.
+     */
+    public function viewAny(User $user): bool
+    {
+        return $user->type === 'A' ? true : false;
+    }
+}

api/app/Policies/GamePolicy.php

@@ -0,0 +1,134 @@
+<?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;
+        }
+
+        if ($game->status === "Pending") {
+            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 !== "Pending" ||
+            $game->player1_user_id === $user->id
+        ) {
+            return false;
+        }
+
+        if ($game->player2_user_id !== null && $game->player2_user_id !== 1) {
+            return false;
+        }
+
+        return true;
+    }
+
+    public function resign(User $user, Game $game): bool
+    {
+        if ($user->type === "A") {
+            return false;
+        }
+
+        if (
+            $game->status !== "Playing" ||
+            ($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 !== "Playing" ||
+            ($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/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

@@ -4,7 +4,10 @@ use App\Http\Controllers\AuthController;
 use App\Http\Controllers\GameController;
 use App\Http\Controllers\MatchController;
 use App\Http\Controllers\ProfileController;
+use App\Http\Controllers\StatisticsController;
 use App\Http\Controllers\UserController;
+use App\Http\Controllers\CoinPurchaseController;
+use App\Http\Controllers\TransactionController;
 use Illuminate\Support\Facades\Route;
 
 Route::prefix('v1')->group(function () {
@@ -12,19 +15,26 @@ Route::prefix('v1')->group(function () {
     Route::post('/login', [AuthController::class, 'login']);
     Route::post('/register', [AuthController::class, 'register']);
 
+    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::post('/coin-purchases', [CoinPurchaseController::class, 'store']);
+        Route::get('/statistics/me', [StatisticsController::class, 'getPersonalStats']);
         Route::prefix('users/me')->group(function () {
             Route::get('/', [ProfileController::class, 'show']);
             Route::put('/', [ProfileController::class, 'update']);
+            Route::patch('/password', [ProfileController::class, 'updatePassword']);
             Route::delete('/', [ProfileController::class, 'destroy']);
+            Route::get('/coins', [ProfileController::class, 'getCoins']);
             Route::put('/password', [
                 ProfileController::class,
                 'updatePassword',
             ]);
             Route::post('/avatar', [ProfileController::class, 'uploadAvatar']);
+            Route::get('/transactions', [UserController::class, 'getMyTransactions']);
         });
 
         // User Resources
@@ -34,6 +44,7 @@ Route::prefix('v1')->group(function () {
                 UserController::class,
                 'getMatches',
             ]);
+            Route::get('/{user}/transactions', [UserController::class, 'getTransactions']);
         });
 
         // Game Resources
@@ -60,6 +71,8 @@ Route::prefix('v1')->group(function () {
         Route::middleware('user.type:A')
             ->prefix('admin')
             ->group(function () {
+                Route::get('/statistics', [StatisticsController::class, 'getAdminStats']);
+                Route::get('/transactions', [TransactionController::class, 'index']);
                 Route::prefix('users')->group(function () {
                     Route::get('/', [UserController::class, 'index']);
                     Route::post('/', [UserController::class, 'store']);

api/sample-requests.http

@@ -1,9 +1,84 @@
-### Get All Students
+### Get All Students (Login)
-POST http://localhost:8000/api/login
+# @name login
-content-Type: application/json
+POST http://localhost:8000/api/v1/login
+Content-Type: application/json
 Accept: application/json
 
 {
-    "email": "p[email protected]",
+    "email": "a1@mail.pt",
     "password": "123"
 }
+
+### Capture the token & id
+@token = {{login.response.body.token}}
+@id = {{login.response.body.user.id}}
+
+### Get All matches
+GET http://localhost:8000/api/v1/games
+Content-Type: application/json
+Accept: application/json
+Authorization: Bearer {{token}}
+
+### Get me user
+GET http://localhost:8000/api/v1/users/me
+Content-Type: application/json
+Accept: application/json
+Authorization: Bearer {{token}}
+
+### Get me coins
+GET http://localhost:8000/api/v1/users/me/coins
+Content-Type: application/json
+Accept: application/json
+Authorization: Bearer {{token}}
+
+### Get me matches
+GET http://localhost:8000/api/v1/users/{{id}}/matches
+Content-Type: application/json
+Accept: application/json
+Authorization: Bearer {{token}}
+
+### Get me transactions
+GET http://localhost:8000/api/v1/users/{{id}}/transactions?type=C
+Content-Type: application/json
+Accept: application/json
+Authorization: Bearer {{token}}
+
+### post coin-purchases
+POST http://localhost:8000/api/v1/coin-purchases
+Content-Type: application/json
+Accept: application/json
+Authorization: Bearer {{token}}
+
+{
+    "euros": 1,
+    "payment_type": "MBWAY",
+    "payment_reference": "912345678"
+}
+
+### Get leaderboard
+GET http://localhost:8000/api/v1/leaderboard
+Content-Type: application/json
+Accept: application/json
+
+### Get me stats
+GET http://localhost:8000/api/v1/statistics/me
+Content-Type: application/json
+Accept: application/json
+Authorization: Bearer {{token}}
+
+### Get public stats
+GET http://localhost:8000/api/v1/statistics/public
+Content-Type: application/json
+Accept: application/json
+
+### Get admin stats
+GET http://localhost:8000/api/v1/admin/statistics
+Content-Type: application/json
+Accept: application/json
+Authorization: Bearer {{token}}
+
+### Get admin stats
+GET http://localhost:8000/api/v1/admin/users
+Content-Type: application/json
+Accept: application/json
+Authorization: Bearer {{token}}

bruno_collection/Auth/Login.bru

@@ -12,7 +12,7 @@ post {
 
 body:json {
   {
-    "email":"a1@mail.pt",
+    "email":"p[email protected]",
     "password":"123"
   }
 }

bruno_collection/Auth/Patch Password.bru

@@ -0,0 +1,23 @@
+meta {
+  name: Patch Password
+  type: http
+  seq: 3
+}
+
+patch {
+  url: {{api_url}}/users/me
+  body: json
+  auth: none
+}
+
+headers {
+  Accept: application/json
+  Authorization: Bearer {{token}}
+}
+
+body:json {
+  {
+    "current_password":"123",
+    "new_password": "456"
+  }
+}

bruno_collection/Games/Create Game.bru

@@ -0,0 +1,15 @@
+meta {
+  name: Create Game
+  type: http
+  seq: 3
+}
+
+post {
+  url: {{api_url}}/games
+  body: none
+  auth: inherit
+}
+
+settings {
+  encodeUrl: true
+}

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",
+    "lib": "@/lib"
-    "composables": "@/composables"
   },
-  "registries": {}
+  "iconLibrary": "lucide"
 }

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,7 @@
   <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;
+      <span class="text-xs" v-if="authStore.currentUser">&nbsp;&nbsp;&nbsp; ({{ authStore.currentUser?.name }})
-        ({{ authStore.currentUser?.name }})
       </span>
     </div>
     <NavBar @logout="logout" :userLoggedIn="authStore.isLoggedIn" />
@@ -17,26 +16,21 @@
 </template>
 
 <script setup>
-import { RouterLink, RouterView } from 'vue-router';
+import { RouterLink, RouterView } from 'vue-router'
-import { toast } from 'vue-sonner';
+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 NavBar from './components/layout/NavBar.vue'
-import { useAuthStore } from './stores/auth';
+import { useAuthStore } from './stores/auth'
-import { useSocketStore } from './stores/socket';
+import { useSocketStore } from './stores/socket'
 
 const authStore = useAuthStore()
 const socketStore = useSocketStore()
 
-
+const pageTitle = ref(`DAD 2025/26`)
-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: () => {
@@ -44,15 +38,12 @@ const logout = () => {
     },
     error: (data) => `[API] Error - ${data?.response?.data?.message}`,
   })
-
 }
 
 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,18 +15,30 @@
                         </li>
                     </NavigationMenuContent>
                 </NavigationMenuItem>
+
                 <NavigationMenuItem v-if="!userLoggedIn">
                     <NavigationMenuLink>
                         <RouterLink to="/login">Login</RouterLink>
                     </NavigationMenuLink>
                 </NavigationMenuItem>
-                <NavigationMenuItem v-else>
+
-                    <NavigationMenuLink>
+                <NavigationMenuItem v-else class="flex flex-row gap-4">
-                        <a @click.prevent="logoutClickHandler">Logout</a>
+                    <NavigationMenuLink v-if="userStore.coins > 0" href="/coins-purchase"
+                        class="flex flex-row items-center gap-1">
+                        <div class="flex items-center justify-center w-5 h-5 bg-purple-400 rounded-full shadow-sm">
+                            <span class="text-[10px] font-bold text-purple-900">$</span>
+                        </div>
+
+                        <span class="text-sm font-medium tabular-nums">
+                            {{ userStore.coins }} <span class="text-muted-foreground text-xs">Coins</span>
+                        </span>
                     </NavigationMenuLink>
                     <NavigationMenuLink>
                         <RouterLink to="/user">Profile</RouterLink>
                     </NavigationMenuLink>
+                    <NavigationMenuLink>
+                        <a href="/home" @click.prevent="logoutClickHandler" class="cursor-pointer">Logout</a>
+                    </NavigationMenuLink>
                 </NavigationMenuItem>
             </NavigationMenuList>
         </NavigationMenu>
@@ -34,6 +46,7 @@
 </template>
 
 <script setup>
+import { useBiscaStore } from '@/stores/bisca'
 import {
     NavigationMenu,
     NavigationMenuContent,
@@ -43,13 +56,40 @@ import {
     NavigationMenuTrigger,
 } from '@/components/ui/navigation-menu'
 import router from '@/router';
+import { watch } from 'vue';
+import { useUserStore } from '@/stores/user';
 
 
 const emits = defineEmits(['logout'])
 const { userLoggedIn } = defineProps(['userLoggedIn'])
 
+const biscaStore = useBiscaStore()
+
 const logoutClickHandler = () => {
+    if (biscaStore.isGameRunning) {
+        const confirmLogout = window.confirm(
+            'If you leave now this game will count as "FORFEIT". Are you sure you want to logout?'
+        )
+        if (!confirmLogout) return
+
+        biscaStore.isLoggingOut = true
+
+        biscaStore.quitGame()
+
+        return
+    }
+
     emits('logout')
     router.push('/login')
 }
+
+const userStore = useUserStore()
+
+watch(() => userLoggedIn, async (isLoggedIn) => {
+    if (isLoggedIn) {
+        await userStore.fetchCoins()
+    } else {
+        userStore.coins = 0
+    }
+}, { immediate: true })
 </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

@@ -15,7 +15,7 @@ const app = createApp(App)
 
 //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)

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/admin/AdminPage.vue

@@ -0,0 +1,752 @@
+<template>
+    <div class="min-h-screen p-4 md:p-8 flex flex-col items-center font-sans text-black">
+
+        <div class="max-w-7xl w-full mb-8">
+            <div class="flex flex-col md:flex-row md:justify-between md:items-end gap-6 mb-8">
+                <div>
+                    <h1 class="text-4xl font-black uppercase tracking-tighter">Admin Panel</h1>
+                    <p class="text-gray-500 text-xs mt-1 uppercase tracking-[0.2em] font-bold">Platform Oversight</p>
+                </div>
+                <button @click="showCreateModal = true"
+                    class="px-6 py-3 bg-black text-white text-xs font-bold uppercase tracking-widest hover:bg-gray-800 transition-all active:scale-95 border border-black">
+                    + Create Admin
+                </button>
+            </div>
+
+            <div class="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-4 gap-4">
+                <div class="bg-white border border-gray-300 p-6 shadow-sm">
+                    <span class="text-[10px] font-bold uppercase tracking-widest text-gray-400 block mb-1">Total
+                        Players</span>
+                    <span class="text-3xl font-black">{{ stats.global_counters?.total_players ?? 'Loading' }}</span>
+                </div>
+
+                <div class="bg-white border border-gray-300 p-6 shadow-sm">
+                    <span class="text-[10px] font-bold uppercase tracking-widest text-gray-400 block mb-1">Active
+                        Games</span>
+                    <span class="text-3xl font-black">{{ stats.global_counters?.active_games ?? 'Loading' }}</span>
+                </div>
+
+                <div @click="openChart('games')"
+                    class="bg-white border border-gray-300 p-6 shadow-sm cursor-pointer hover:border-black transition-colors group">
+                    <div class="flex justify-between items-start">
+                        <span class="text-[10px] font-bold uppercase tracking-widest text-gray-400 mb-1">Total
+                            Games</span>
+                        <svg class="w-4 h-4 text-gray-300 group-hover:text-black" fill="none" stroke="currentColor"
+                            viewBox="0 0 24 24">
+                            <path d="M7 12l5 5L22 7"></path>
+                        </svg>
+                    </div>
+                    <span class="text-3xl font-black">{{ stats.global_counters?.total_games ?? 'Loading' }}</span>
+                    <span
+                        class="block text-[10px] mt-2 underline opacity-0 group-hover:opacity-100 transition-opacity">View
+                        Volume Chart</span>
+                </div>
+
+                <div @click="openChart('revenue')"
+                    class="bg-black text-white p-6 shadow-lg cursor-pointer hover:bg-gray-900 transition-colors group">
+                    <div class="flex justify-between items-start">
+                        <span class="text-[10px] font-bold uppercase tracking-widest opacity-60 mb-1">Estimated
+                            Revenue</span>
+                        <svg class="w-4 h-4 opacity-40 group-hover:opacity-100" fill="none" stroke="currentColor"
+                            viewBox="0 0 24 24">
+                            <path
+                                d="M12 8c-1.657 0-3 .895-3 2s1.343 2 3 2 3 .895 3 2-1.343 2-3 2m0-8c1.11 0 2.08.402 2.599 1M12 8V7m0 1v8m0 0v1m0-1c-1.11 0-2.08-.402-2.599-1M21 12a9 9 0 11-18 0 9 9 0 0118 0z">
+                            </path>
+                        </svg>
+                    </div>
+                    <span class="text-3xl font-black">€ {{ (stats.global_counters?.total_coins_purchased /
+                        10).toLocaleString() ?? 'Loading' }}</span>
+                    <span
+                        class="block text-[10px] mt-2 underline opacity-60 group-hover:opacity-100 transition-opacity">View
+                        Purchase History</span>
+                </div>
+            </div>
+        </div>
+
+        <div v-if="activeChart"
+            class="fixed inset-0 bg-black/80 backdrop-blur-md z-[60] flex items-center justify-center p-4"
+            @click.self="activeChart = null">
+            <div class="bg-white border border-gray-300 w-full max-w-5xl overflow-hidden shadow-2xl">
+
+                <div class="p-6 border-b border-gray-300 flex justify-between items-center bg-white">
+                    <div>
+                        <h3 class="text-2xl font-black uppercase tracking-tighter">
+                            {{ activeChart === 'games' ? 'Games Volume' : 'Purchases History' }}
+                        </h3>
+                        <p class="text-[10px] font-bold text-gray-400 uppercase tracking-[0.2em]">Last 12 Months
+                            Activity</p>
+                    </div>
+                    <button @click="activeChart = null"
+                        class="w-12 h-12 flex items-center justify-center border border-black hover:bg-black hover:text-white transition-all group">
+                        <span class="text-xl group-hover:rotate-90 transition-transform">✕</span>
+                    </button>
+                </div>
+
+                <div class="p-12 min-h-[400px] flex flex-col justify-end">
+
+                    <div v-if="chartData.length > 0" class="flex items-end gap-3 h-64 w-full">
+                        <div v-for="(data, index) in chartData" :key="data.month"
+                            class="flex-1 flex flex-col items-center group relative h-full justify-end">
+
+                            <div
+                                class="absolute -top-12 bg-black text-white text-[10px] py-2 px-3 opacity-0 group-hover:opacity-100 transition-opacity pointer-events-none z-10 font-bold">
+                                {{ data.total || data.total_coins }}
+                                <div class="absolute -bottom-1 left-1/2 -translate-x-1/2 w-2 h-2 bg-black rotate-45">
+                                </div>
+                            </div>
+
+                            <div class="w-full bg-black hover:bg-gray-700 transition-all ease-out" :style="{
+                                height: showBars ? `${calculateHeight(data.total || data.total_coins)}%` : '0%',
+                                transitionDelay: `${index * 50}ms`,
+                                transitionDuration: '800ms'
+                            }"></div>
+
+                            <div class="h-8 flex items-center">
+                                <span class="text-[9px] font-black uppercase text-gray-400">
+                                    {{ formatMonth(data.month) }}
+                                </span>
+                            </div>
+                        </div>
+                    </div>
+
+                    <div v-else
+                        class="h-64 flex flex-col items-center justify-center text-gray-400 border-2 border-dashed border-gray-100">
+                        <p class="text-xs font-bold uppercase tracking-widest">No data available for this period</p>
+                    </div>
+                </div>
+
+                <div class="bg-gray-50 p-8 border-t border-gray-300 flex justify-between items-center">
+                    <div class="flex gap-12">
+                        <div v-if="activeChart === 'games'" v-for="gt in stats.charts.games_by_type" :key="gt.type">
+                            <span class="text-[10px] font-bold uppercase text-gray-400 block tracking-widest">Bisca {{
+                                gt.type }}</span>
+                            <span class="text-2xl font-black">{{ gt.total.toLocaleString() }}</span>
+                        </div>
+                        <div v-if="activeChart === 'revenue'">
+                            <span class="text-[10px] font-bold uppercase text-gray-400 block tracking-widest">Total
+                                Period Volume</span>
+                            <span class="text-2xl font-black">{{
+                                stats.global_counters.total_coins_purchased.toLocaleString() }} Coins</span>
+                        </div>
+                    </div>
+                    <div class="text-[10px] font-bold text-gray-400 uppercase italic">
+                        * Admin Full-Access View
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <div class="bg-white border border-gray-300 shadow-2xl max-w-7xl w-full overflow-hidden">
+            <div class="flex border-b border-gray-300 bg-gray-50 overflow-x-auto scrollbar-hide">
+                <button v-for="tab in tabs" :key="tab.id" @click="activeTab = tab.id" :class="[
+                    'flex-1 min-w-[150px] p-5 text-xs font-bold uppercase tracking-widest transition-all outline-none',
+                    activeTab === tab.id
+                        ? 'bg-white border-b-2 border-black text-black'
+                        : 'text-gray-400 hover:text-black hover:bg-gray-100 border-b-2 border-transparent'
+                ]">
+                    {{ tab.name }}
+                </button>
+            </div>
+
+            <div class="min-h-[400px]">
+                <div v-if="activeTab === 'users'" class="animate-in fade-in slide-in-from-bottom-2 duration-300">
+                    <div class="overflow-x-auto">
+                        <div id="table-scroll-container"
+                            class="overflow-y-auto h-[500px] scrollbar-thin scrollbar-thumb-black">
+                            <table class="w-full text-left border-collapse sticky-header">
+                                <thead class="bg-gray-50 border-b border-gray-300">
+                                    <tr>
+                                        <th
+                                            class="p-4 text-[10px] font-bold uppercase tracking-widest text-gray-500 cursor-pointer hover:text-black transition-colors">
+                                            Name</th>
+                                        <th
+                                            class="p-4 text-[10px] font-bold uppercase tracking-widest text-gray-500 cursor-pointer hover:text-black transition-colors">
+                                            Coins</th>
+                                        <th @click="handleSort('type')"
+                                            class="p-4 text-[10px] font-bold uppercase tracking-widest text-gray-500 cursor-pointer hover:text-black transition-colors">
+                                            Role
+                                            <span class="ml-1">
+                                                <template v-if="filters.type === 'A'"> (Admins)</template>
+                                                <template v-else-if="filters.type === 'P'"> (Players)</template>
+                                                <template v-else> ↕</template>
+                                            </span>
+                                        </th>
+
+                                        <th @click="handleSort('blocked')"
+                                            class="p-4 text-[10px] font-bold uppercase tracking-widest text-gray-500 cursor-pointer hover:text-black transition-colors">
+                                            Status
+                                            <span class="ml-1">
+                                                <template v-if="filters.blocked === true"> (Blocked)</template>
+                                                <template v-else-if="filters.blocked === false"> (Active)</template>
+                                                <template v-else> ↕</template>
+                                            </span>
+                                        </th>
+                                        <th></th>
+                                    </tr>
+                                </thead>
+                                <tbody class="divide-y divide-gray-100">
+                                    <template v-if="filteredUsers.length > 0">
+                                        <tr v-for="user in filteredUsers" :key="user.id"
+                                            class="hover:bg-gray-50/80 transition-colors">
+                                            <td class="p-4">
+                                                <div class="flex items-center gap-3">
+                                                    <div
+                                                        class="w-10 h-10 bg-black text-white flex items-center justify-center font-bold text-sm border-2 border-black">
+                                                        {{ user.name.charAt(0) }}
+                                                    </div>
+                                                    <div>
+                                                        <div class="text-sm font-bold">{{ user.name }}</div>
+                                                        <div v-if="user.nickname"
+                                                            class="text-xs text-gray-500 font-mono">@{{ user.nickname
+                                                            }}</div>
+                                                        <div class="text-xs text-gray-500 font-mono">{{ user.email }}
+                                                        </div>
+                                                    </div>
+                                                </div>
+                                            </td>
+                                            <td class="p-4">
+                                                <div v-if="user.coins_balance" class="flex items-center gap-2">
+                                                    <div
+                                                        class="flex items-center justify-center w-5 h-5 bg-purple-400 rounded-full shadow-sm">
+                                                        <span class="text-[10px] font-bold text-purple-900">$</span>
+                                                    </div>
+                                                    <span class="text-[10px] uppercase font-bold tracking-tight">{{
+                                                        user.coins_balance }}</span>
+                                                </div>
+                                            </td>
+                                            <td class="p-4">
+                                                <span :class="[
+                                                    'px-2 py-1 text-[10px] font-bold border',
+                                                    user.type === 'A' ? 'bg-black text-white border-black' : 'bg-white text-gray-600 border-gray-300'
+                                                ]">
+                                                    {{ user.type === 'A' ? 'ADMIN' : 'PLAYER' }}
+                                                </span>
+                                            </td>
+                                            <td class="p-4">
+                                                <div class="flex items-center gap-2">
+                                                    <div
+                                                        :class="['w-2 h-2 rounded-full', user.blocked ? 'bg-red-600' : 'bg-green-500']">
+                                                    </div>
+                                                    <span class="text-[10px] uppercase font-bold tracking-tight">{{
+                                                        user.blocked
+                                                            ? 'Blocked' : 'Active' }}</span>
+                                                </div>
+                                            </td>
+                                            <td class="p-4 text-right">
+                                                <div v-if="user.type != 'A'" class="space-x-2 flex justify-end">
+                                                    <button @click="toggleBlock(user)"
+                                                        class="text-[10px] font-bold uppercase tracking-tighter border-2 border-black px-3 py-1 hover:bg-black hover:text-white transition-all">{{
+                                                            user.blocked ? 'Unblock' : 'Block' }}</button>
+                                                    <button @click=" confirmDelete(user)"
+                                                        class="text-[10px] font-bold uppercase tracking-tighter bg-red-600 text-white border-2 border-red-600 px-3 py-1 hover:bg-red-700 transition-all">Remove</button>
+                                                </div>
+                                            </td>
+                                        </tr>
+                                    </template>
+                                    <tr v-else-if="!isLoading">
+                                        <td colspan="3"
+                                            class="p-12 text-center text-gray-400 uppercase text-xs font-bold tracking-widest">
+                                            No users found
+                                        </td>
+                                    </tr>
+                                    <tr ref="loadMoreTrigger">
+                                        <td colspan="4" class="p-4 text-center">
+                                            <span v-if="isLoading"
+                                                class="text-[10px] font-bold uppercase animate-pulse">Loading
+                                                more...</span>
+                                        </td>
+                                    </tr>
+                                </tbody>
+                            </table>
+                        </div>
+                    </div>
+                </div>
+                <div v-else-if="activeTab === 'transactions'"
+                    class="animate-in fade-in slide-in-from-bottom-2 duration-300">
+                    <div class="overflow-x-auto">
+                        <div id="table-scroll-container"
+                            class="overflow-y-auto h-[500px] scrollbar-thin scrollbar-thumb-black">
+                            <table class="w-full text-left border-collapse sticky-header">
+                                <thead class="bg-gray-50 border-b border-gray-300">
+                                    <tr>
+                                        <th @click="handleSort('datetime')"
+                                            class="p-4 text-[10px] font-bold uppercase tracking-widest text-gray-500 cursor-pointer hover:text-black transition-colors">
+                                            Date Time
+                                            <span>{{ filters.sort_datetime === 'desc' ? ' ↓' : ' ↑' }}</span>
+                                        </th>
+                                        <th class="p-4 text-[10px] font-bold uppercase tracking-widest text-gray-500">
+                                            User
+                                        </th>
+                                        <th class="p-4 text-[10px] font-bold uppercase tracking-widest text-gray-500">
+                                            Transaction type
+                                        </th>
+                                        <th @click="handleSort('coins')"
+                                            class="p-4 text-[10px] font-bold uppercase tracking-widest text-gray-500 cursor-pointer hover:text-black transition-colors">
+                                            Coins
+                                            <span v-if="filters.sort_coins">
+                                                {{ filters.sort_coins === 'desc' ? ' ↓' : '↑' }}</span>
+                                            <span v-else> ↕</span>
+                                        </th>
+                                    </tr>
+                                </thead>
+                                <tbody class="divide-y divide-gray-100">
+                                    <template v-if="transactions.length > 0">
+                                        <tr v-for="tx in transactions" :key="tx.id"
+                                            class="hover:bg-gray-50/80 transition-colors">
+                                            <td class="p-4 text-xs font-mono text-gray-600">
+                                                {{ new Date(tx.transaction_datetime).toLocaleDateString() }} •
+                                                {{ new Date(tx.transaction_datetime).toLocaleTimeString([], {
+                                                    hour:
+                                                        '2-digit', minute: '2-digit'
+                                                }) }}
+                                            </td>
+                                            <td class="p-4">
+                                                <div class="text-sm font-bold">{{ tx.user?.nickname || 'Guest' }}</div>
+                                                <div class="text-[10px] text-gray-500 font-mono">{{ tx.user?.email }}
+                                                </div>
+                                            </td>
+                                            <td class="p-4">
+                                                <div class="flex items-center gap-4">
+                                                    <div
+                                                        class="px-2 py-1 bg-gray-100 border border-gray-300 text-[9px] font-black uppercase tracking-tighter text-gray-500 min-w-[80px] text-center">
+                                                        {{ tx.type?.name || 'Manual' }}
+                                                    </div>
+                                                </div>
+                                            </td>
+                                            <td class="p-4">
+                                                <div class="inline-flex items-center gap-2">
+                                                    <span :class="[
+                                                        'text-sm font-black tracking-tighter',
+                                                        tx.coins >= 0 ? 'text-green-400' : 'text-red-400'
+                                                    ]">
+                                                        {{ tx.coins > 0 ? '+' : '' }}{{ tx.coins.toLocaleString() }}
+                                                    </span>
+
+                                                    <span
+                                                        class="text-[10px] font-bold text-gray-400 uppercase tracking-widest">Coins</span>
+                                                </div>
+                                            </td>
+                                        </tr>
+                                    </template>
+                                    <tr v-else-if="!isLoading">
+                                        <td colspan="3"
+                                            class="w-1 p-12 text-center text-gray-400 uppercase text-xs font-bold tracking-widest">
+                                            No transactions found
+                                        </td>
+                                    </tr>
+                                    <tr ref="loadMoreTrigger">
+                                        <td colspan="4" class="p-4 text-center">
+                                            <span v-if="isLoading"
+                                                class="text-[10px] font-bold uppercase animate-pulse">Loading
+                                                more...</span>
+                                        </td>
+                                    </tr>
+                                </tbody>
+                            </table>
+                        </div>
+                    </div>
+                </div>
+
+                <div v-else-if="activeTab === 'games'" class="animate-in fade-in slide-in-from-bottom-2 duration-300">
+                    <div class="overflow-x-auto">
+                        <div id="table-scroll-container"
+                            class="overflow-y-auto h-[500px] scrollbar-thin scrollbar-thumb-black">
+                            <table class="w-full text-left border-collapse sticky-header">
+                                <thead class="bg-gray-50 border-b border-gray-300">
+                                    <tr>
+                                        <th @click="handleSort('date')"
+                                            class="p-4 text-[10px] font-bold uppercase tracking-widest text-gray-500 cursor-pointer hover:text-black transition-colors">
+                                            Timeline
+                                            <span>{{ filters.game_sort_date === 'desc' ? ' ↓' : ' ↑' }}</span>
+                                        </th>
+                                        <th class="p-4 text-[10px] font-bold uppercase tracking-widest text-gray-500">
+                                            Player 1</th>
+                                        <th class="p-4 text-[10px] font-bold uppercase tracking-widest text-gray-500">
+                                            Player 2</th>
+                                        <th class="p-4 text-[10px] font-bold uppercase tracking-widest text-gray-500">
+                                            Result</th>
+                                        <th @click="handleSort('type')"
+                                            class="p-4 text-[10px] font-bold uppercase tracking-widest text-gray-500 cursor-pointer hover:text-black transition-colors">
+                                            Variant
+                                            <span v-if="filters.game_filter_type"> (Bisca {{ filters.game_filter_type
+                                            }})</span>
+                                            <span v-else> ↕</span>
+                                        </th>
+                                    </tr>
+                                </thead>
+                                <tbody class="divide-y divide-gray-100">
+                                    <template v-if="games.length > 0">
+                                        <tr v-for="game in games" :key="game.id"
+                                            class="hover:bg-gray-50/80 transition-colors">
+                                            <td class="p-4">
+                                                <div class="text-[10px] font-mono text-black font-bold">
+                                                    {{ new Date(game.began_at).toLocaleDateString() }}</div>
+                                                <div class="text-[10px] font-mono text-gray-400 italic">
+                                                    {{ new Date(game.began_at).toLocaleTimeString([], {
+                                                        hour: '2-digit',
+                                                        minute: '2-digit'
+                                                    }) }} •
+                                                    {{ new Date(game.ended_at).toLocaleTimeString([], {
+                                                        hour: '2-digit',
+                                                        minute: '2-digit'
+                                                    }) }}
+                                                </div>
+                                            </td>
+
+                                            <td class="p-4">
+                                                <div class="text-sm font-bold text-black">{{ game.player1?.nickname }}
+                                                </div>
+                                                <div
+                                                    class="text-[10px] font-black text-gray-400 uppercase tracking-tighter">
+                                                    {{ game.player1_points }} Points
+                                                </div>
+                                            </td>
+
+                                            <td class="p-4">
+                                                <div class="text-sm font-bold text-black">{{ game.player2?.nickname }}
+                                                </div>
+                                                <div
+                                                    class="text-[10px] font-black text-gray-400 uppercase tracking-tighter">
+                                                    {{ game.player2_points }} Points
+                                                </div>
+                                            </td>
+
+                                            <td class="p-4">
+                                                <div v-if="game.is_draw" class="text-xs font-bold text-gray-400">— Draw
+                                                    —</div>
+                                                <div v-else class="flex flex-col">
+                                                    <span
+                                                        class="text-[9px] font-bold uppercase text-gray-400 tracking-widest mb-0.5">Winner</span>
+                                                    <span
+                                                        class="text-xs font-black bg-black text-white px-2 py-0.5 w-fit uppercase tracking-tighter">
+                                                        {{ game.winner_user_id === game.player1_user_id ?
+                                                            game.player1?.nickname : game.player2?.nickname }}
+                                                    </span>
+                                                </div>
+                                            </td>
+
+                                            <td class="p-4">
+                                                <div
+                                                    class="px-2 py-1 bg-gray-100 border border-gray-300 text-[10px] font-black text-center w-20">
+                                                    BISCA {{ game.type }}
+                                                </div>
+                                            </td>
+                                        </tr>
+                                        <tr ref="loadMoreTrigger">
+                                            <td colspan="5" class="p-8 text-center border-none">
+                                                <div v-if="isLoading" class="flex flex-col items-center gap-2">
+                                                    <div
+                                                        class="w-5 h-5 border-2 border-black border-t-transparent rounded-full animate-spin">
+                                                    </div>
+                                                    <span
+                                                        class="text-[10px] font-black uppercase tracking-[0.2em]">Retrieving
+                                                        match data...</span>
+                                                </div>
+                                            </td>
+                                        </tr>
+                                    </template>
+                                    <tr v-else-if="!isLoading">
+                                        <td colspan="5"
+                                            class="p-12 text-center text-gray-400 uppercase text-xs font-bold tracking-widest border-none">
+                                            No match history found
+                                        </td>
+                                    </tr>
+                                </tbody>
+                            </table>
+                        </div>
+                    </div>
+                </div>
+
+                <div v-else class="p-12 text-center animate-in fade-in duration-500">
+                    <svg class="w-12 h-12 mx-auto mb-4 text-gray-300" fill="none" stroke="currentColor"
+                        viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="1"
+                            d="M9 17v-2m3 2v-4m3 4v-6m2 10H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z" />
+                    </svg>
+                    <h2 class="text-sm font-bold uppercase tracking-widest text-gray-400">Detailed logs for {{ activeTab
+                    }} pending API</h2>
+                </div>
+            </div>
+        </div>
+
+        <div v-if="showCreateModal"
+            class="fixed inset-0 bg-black/60 backdrop-blur-sm z-50 flex items-center justify-center p-4">
+            <div class="bg-white border border-gray-300 w-full max-w-md shadow-2xl animate-in zoom-in-95 duration-200">
+                <div class="p-6 border-b border-gray-300 bg-black text-white">
+                    <h3 class="text-xl font-black uppercase tracking-tighter">New Admin</h3>
+                </div>
+                <form @submit.prevent="handleSubmitAdmin" class="p-6 space-y-4">
+                    <div>
+                        <label class="block text-[10px] font-bold uppercase text-gray-500 mb-1">Full Name</label>
+                        <input v-model="adminForm.name" type="text" required
+                            class="w-full border border-gray-300 p-3 text-sm focus:border-black outline-none transition-colors" />
+                    </div>
+                    <div>
+                        <label class="block text-[10px] font-bold uppercase text-gray-500 mb-1">Email Address</label>
+                        <input v-model="adminForm.email" type="email" required
+                            class="w-full border border-gray-300 p-3 text-sm focus:border-black outline-none transition-colors" />
+                    </div>
+                    <div class="flex gap-3 pt-4">
+                        <button type="button" @click="showCreateModal = false"
+                            class="flex-1 px-4 py-3 border border-gray-300 font-bold uppercase text-xs hover:bg-gray-50 transition-all">Cancel</button>
+                        <button type="submit"
+                            class="flex-1 px-4 py-3 bg-black text-white font-bold uppercase text-xs hover:bg-gray-800 transition-all">Create
+                            Account</button>
+                    </div>
+                </form>
+            </div>
+        </div>
+    </div>
+</template>
+
+<script setup>
+import { ref, reactive, computed, onMounted, watch, nextTick } from 'vue'
+import { useAPIStore } from '@/stores/api'
+import { useAuthStore } from '@/stores/auth'
+import { toast } from 'vue-sonner'
+
+const activeTab = ref('users')
+const showCreateModal = ref(false)
+const activeChart = ref(null)
+const showBars = ref(false)
+const stats = ref({})
+const users = ref([])
+const transactions = ref([])
+const games = ref([])
+const isLoading = ref(false)
+const loadMoreTrigger = ref(null)
+
+const apiStore = useAPIStore()
+
+const pagination = reactive({
+    users: { page: 1, lastPage: 1 },
+    transactions: { page: 1, lastPage: 1 },
+    games: { page: 1, lastPage: 1 }
+})
+
+const filters = reactive({
+    type: null,
+    blocked: null,
+    sort_datetime: 'desc',
+    sort_coins: null,
+    game_sort_direction: 'desc',
+    game_type: null
+})
+
+watch(activeTab, async () => {
+    resetPagination();
+    await fetchData();
+    await nextTick();
+    setupObserver();
+});
+
+const tabs = [
+    { id: 'users', name: 'User Management' },
+    { id: 'transactions', name: 'Transactions' },
+    { id: 'games', name: 'Games History' }
+]
+
+const chartData = computed(() => {
+    if (!stats.value) return []
+    if (activeChart.value === 'games') return [...stats.value.charts.games_per_month].reverse()
+    if (activeChart.value === 'revenue') return [...stats.value.charts.purchases_per_month].reverse()
+    return []
+})
+
+const openChart = (type) => {
+    activeChart.value = type
+    showBars.value = false
+
+    setTimeout(() => {
+        showBars.value = true
+    }, 50);
+}
+
+const calculateHeight = (value) => {
+    const max = Math.max(...chartData.value.map(d => d.total || d.total_coins))
+    return (value / max) * 100
+}
+
+const formatMonth = (monthStr) => {
+    const [_, month] = monthStr.split('-')
+    const months = ['JAN', 'FEB', 'MAR', 'APR', 'MAY', 'JUN', 'JUL', 'AUG', 'SEP', 'OCT', 'NOV', 'DEC']
+    return months[parseInt(month) - 1]
+}
+
+const adminForm = reactive({ name: '', nickname: '', email: '' })
+
+const toggleBlock = (user) => {
+    user.blocked == false ? apiStore.blockUser(user) : apiStore.unblockUser(user)
+    user.blocked = !user.blocked
+}
+
+const confirmDelete = (user) => {
+    if (confirm(`Remove ${user.name}? This action follows platform rules for ${user.type === 'P' ? 'soft-deletion' : 'permanent removal'}.`)) {
+        apiStore.deleteUser(user)
+        users.value = users.value.filter(u => u.id !== user.id)
+    }
+}
+
+const handleSubmitAdmin = () => {
+    adminForm.type = 'A'
+    adminForm.password = '123'
+    adminForm.blocked = false
+
+    const promise = apiStore.postAdmin(adminForm)
+    toast.promise(promise, {
+        loading: 'Calling API',
+        success: () => {
+            return `Admin created with success`
+        },
+        error: (error) =>
+            error.response?.data?.message
+    })
+
+    showCreateModal.value = false
+    adminForm.name = ''; adminForm.email = '';
+}
+
+const resetPagination = () => {
+    pagination[activeTab.value].page = 1
+    if (activeTab.value === 'users') users.value = []
+    if (activeTab.value === 'transactions') transactions.value = []
+    if (activeTab.value === 'games') games.value = []
+}
+
+const filteredUsers = computed(() => {
+    return users.value.filter(user => user.id !== useAuthStore().currentUserID);
+});
+
+const fetchData = async () => {
+    if (isLoading.value) return
+    const currentTab = activeTab.value
+    if (pagination[currentTab].page > pagination[currentTab].lastPage && pagination[currentTab].page !== 1) return
+
+    isLoading.value = true
+    try {
+        let response
+        if (currentTab === 'users') {
+            const params = { page: pagination[currentTab].page, type: filters.type, blocked: filters.blocked };
+            response = await apiStore.getAdminUsers(params);
+            users.value.push(...response.data.data);
+        }
+        else if (currentTab === 'transactions') {
+            const params = {
+                page: pagination[currentTab].page,
+                sort_datetime: filters.sort_datetime,
+                sort_coins: filters.sort_coins
+            };
+            response = await apiStore.getAdminTransactions(params);
+            transactions.value.push(...response.data.data);
+        }
+        else if (currentTab === 'games') {
+            const params = {
+                page: pagination[currentTab].page,
+                sort_direction: filters.game_sort_direction,
+                type: filters.game_type
+            };
+            response = await apiStore.getAdminGames(params);
+            games.value.push(...response.data.data);
+        }
+
+
+        pagination[currentTab].lastPage = response.data.last_page
+        pagination[currentTab].page++
+    } catch (error) {
+        console.error("Fetch failed", error)
+    } finally {
+        isLoading.value = false
+    }
+}
+
+const handleSort = async (column) => {
+    if (activeTab.value === 'users') {
+        if (column === 'type') {
+            filters.type = filters.type === null ? 'A' : (filters.type === 'A' ? 'P' : null);
+        } else if (column === 'blocked') {
+            filters.blocked = filters.blocked === null ? true : (filters.blocked === true ? false : null);
+        }
+    }
+
+    else if (activeTab.value === 'transactions') {
+        if (column === 'datetime') {
+            filters.sort_datetime = filters.sort_datetime === 'desc' ? 'asc' : 'desc';
+        } else if (column === 'coins') {
+            if (filters.sort_coins === null) filters.sort_coins = 'desc';
+            else if (filters.sort_coins === 'desc') filters.sort_coins = 'asc';
+            else filters.sort_coins = null;
+        }
+    }
+
+    else if (activeTab.value === 'games') {
+        if (column === 'date') {
+            filters.game_sort_direction = filters.game_sort_direction === 'desc' ? 'asc' : 'desc';
+        } else if (column === 'type') {
+            if (filters.game_type === null) filters.game_type = '9';
+            else if (filters.game_type === '9') filters.game_type = '3';
+            else filters.game_type = null;
+        }
+    }
+
+    resetPagination();
+    await fetchData();
+    await nextTick();
+    setupObserver();
+};
+
+const setupObserver = () => {
+    if (window.adminTableObserver) window.adminTableObserver.disconnect();
+
+    const container = document.querySelector('#table-scroll-container');
+
+    const observer = new IntersectionObserver((entries) => {
+        const currentTab = activeTab.value;
+        const hasMore = pagination[currentTab].page <= pagination[currentTab].lastPage;
+
+        if (entries[0].isIntersecting && !isLoading.value && hasMore) {
+            fetchData();
+        }
+    }, {
+        root: container,
+        threshold: 0.1,
+        rootMargin: '100px'
+    });
+
+    if (loadMoreTrigger.value) {
+        observer.observe(loadMoreTrigger.value);
+        window.adminTableObserver = observer;
+    }
+};
+
+onMounted(async () => {
+    const statsResponse = await apiStore.getAdminStats()
+    const globalResponse = await apiStore.getPublicStats()
+    stats.value = statsResponse.data
+    stats.value.global_counters.active_games = globalResponse.data.active_games
+
+    await fetchData()
+    await nextTick()
+    setupObserver()
+})
+</script>
+
+<style scoped>
+.sticky-header thead th {
+    position: sticky;
+    top: 0;
+    background-color: #f9fafb;
+    box-shadow: inset 0 -1px 0 #d1d5db;
+}
+
+#table-scroll-container::-webkit-scrollbar {
+    width: 6px;
+}
+
+#table-scroll-container::-webkit-scrollbar-thumb {
+    background-color: black;
+}
+
+#table-scroll-container::-webkit-scrollbar-track {
+    background-color: #f3f4f6;
+}
+</style>

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,457 @@
-<template>
-    <div>
-
-    </div>
-</template>
-
 <script setup>
+import { User, Trophy } from 'lucide-vue-next'
+import { ref, onMounted, nextTick, inject } 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'
+import { useAuthStore } from '@/stores/auth'
 
+const API_BASE_URL = inject('apiBaseURL')
+const apiStore = useAPIStore()
+const router = useRouter()
+const openGames = ref([])
+const selectedMode = ref('9')
+const gObserverTarget = ref(null);
+const gObserver = ref(null);
+const gLoading = ref(false);
+const gPage = ref(1);
+const showHostModal = ref(false)
+const showJoinModal = ref(false)
+const selectedGame = ref(null)
+const isReady = ref(false)
+const showLeaderboardModal = ref(false)
+const showStatsModal = ref(false)
+const userStats = ref(null)
+const statsLoading = ref(false)
+const leaderboardEntries = ref([])
+const lbLoading = ref(false)
+const lbPage = ref(1)
+const lbObserverTarget = ref(null)
+const lbObserver = ref(null)
+const lbMorePages = ref(true)
+const publicStats = ref(null)
+
+const setupGamesObserver = () => {
+    if (gObserver.value) gObserver.value.disconnect();
+
+    gObserver.value = new IntersectionObserver((entries) => {
+        if (entries[0].isIntersecting && !gLoading.value && openGames.value.length > 0) {
+            getPendingGames();
+        }
+    }, { threshold: 0.1 });
+
+    if (gObserverTarget.value) {
+        gObserver.value.observe(gObserverTarget.value);
+    }
+}
+
+const getPendingGames = async (mode = selectedMode.value) => {
+    if (gLoading.value) return;
+    gLoading.value = true;
+
+    apiStore.gameQueryParameters.page = gPage.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 {
+        gLoading.value = false;
+    }
+}
+
+const fetchPublicStats = async () => {
+    try {
+        const response = await apiStore.getPublicStats()
+        publicStats.value = response.data
+    } catch (error) {
+        console.error("Failed to fetch public stats", error)
+    }
+}
+
+const openStats = async () => {
+    showStatsModal.value = true
+    statsLoading.value = true
+    try {
+        const response = await apiStore.getCurrentUserStats()
+        userStats.value = response.data
+    } catch (error) {
+        console.error("Failed to fetch stats", error)
+    } finally {
+        statsLoading.value = false
+    }
+}
+
+const getAvatarUrl = (filename) => {
+    return filename
+        ? `${API_BASE_URL.replace('/api/v1', '').replace('v1/')}/storage/photos_avatars/${filename}`
+        : `${API_BASE_URL.replace('/api/v1', '').replace('v1/')}/storage/photos_avatars/anonymous.png`;
+}
+
+const fetchLeaderboard = async () => {
+    if (lbLoading.value || !lbMorePages.value) return;
+    lbLoading.value = true;
+    try {
+        const response = await apiStore.getLeaderboard({ page: lbPage.value });
+        const newEntries = response.data.data;
+
+        if (newEntries.length < 10) {
+            lbMorePages.value = false;
+        }
+
+        leaderboardEntries.value = [...leaderboardEntries.value, ...newEntries];
+        lbPage.value++;
+    } finally {
+        lbLoading.value = false;
+    }
+}
+
+const openLeaderboard = async () => {
+    leaderboardEntries.value = [];
+    lbPage.value = 1;
+    showLeaderboardModal.value = true;
+    await nextTick();
+    setupLeaderboardObserver();
+    await fetchLeaderboard();
+}
+
+const setupLeaderboardObserver = () => {
+    if (lbObserver.value) lbObserver.value.disconnect();
+    lbObserver.value = new IntersectionObserver((entries) => {
+        if (entries[0].isIntersecting && !lbLoading.value && leaderboardEntries.value.length > 0) {
+            fetchLeaderboard();
+        }
+    }, { threshold: 0.1 });
+
+    if (lbObserverTarget.value) {
+        lbObserver.value.observe(lbObserverTarget.value);
+    }
+}
+
+const clickMode = async (mode) => {
+    if (selectedMode.value === mode) return;
+    openGames.value = [];
+    selectedMode.value = mode;
+    gPage.value = 1;
+    await getPendingGames();
+    setupGamesObserver();
+}
+
+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 fetchPublicStats();
+    await getPendingGames();
+    await nextTick();
+    setupGamesObserver();
+})
 </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">
+
+            <Card v-if="publicStats" class="w-full max-w-2xl border-[#a855f7] bg-[#f8f0ff] shadow-sm">
+                <CardContent class="p-4">
+                    <div class="flex justify-around items-center">
+                        <div class="text-center">
+                            <p class="text-xs uppercase font-bold opacity-70">Players</p>
+                            <p class="text-xl font-black">{{ publicStats.total_players }}</p>
+                        </div>
+                        <div class="h-8 w-[1px] bg-[#a855f7]/20"></div>
+                        <div class="text-center">
+                            <p class="text-xs uppercase font-bold opacity-70">Total Games</p>
+                            <p class="text-xl font-black">{{ publicStats.total_games }}</p>
+                        </div>
+                        <div class="h-8 w-[1px] bg-[#a855f7]/20"></div>
+                        <div class="text-center">
+                            <p class="text-xs uppercase font-bold opacity-70">Active</p>
+                            <p class="text-xl font-black">{{ publicStats.active_games }}</p>
+                        </div>
+                    </div>
+                </CardContent>
+            </Card>
+
+            <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="gObserverTarget" class="h-10 flex items-center justify-center">
+                                    <span v-if="gLoading" 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 v-if="showStatsModal"
+            class="fixed inset-0 z-[60] flex items-center justify-center bg-black/60 backdrop-blur-sm p-4">
+            <Card class="w-full max-w-sm max-h-2/3 border-purple-500 shadow-2xl">
+                <CardHeader class="border-b bg-muted/20">
+                    <div class="flex justify-between items-center">
+                        <CardTitle class="flex items-center gap-2">
+                            <User class="text-yellow-500" /> My Statistics
+                        </CardTitle>
+                        <Button variant="ghost" size="sm" @click="showStatsModal = false">X</Button>
+                    </div>
+                </CardHeader>
+
+                <CardContent class="py-6">
+                    <div v-if="statsLoading" class="flex flex-col items-center py-10 gap-4">
+                        <div class="h-8 w-8 animate-spin rounded-full border-4 border-purple-500 border-t-transparent">
+                        </div>
+                        <p class="text-sm text-muted-foreground">Calculating your glory...</p>
+                    </div>
+
+                    <div v-else-if="userStats" class="space-y-6">
+                        <div class="text-center">
+                            <h3 class="text-2xl font-bold text-purple-600">{{ userStats.nickname }}</h3>
+                            <p class="text-sm text-muted-foreground">Performance Overview</p>
+                        </div>
+
+                        <div class="grid grid-cols-2 gap-4">
+                            <div
+                                class="rounded-lg bg-muted/50 p-4 text-center border border-transparent hover:border-purple-500/30 transition-all">
+                                <p class="text-xs uppercase text-muted-foreground font-semibold">Total Games</p>
+                                <p class="text-2xl font-bold">{{ userStats.total_games }}</p>
+                            </div>
+                            <div class="rounded-lg bg-purple-500/10 p-4 text-center border border-purple-500/20">
+                                <p class="text-xs uppercase text-purple-600 font-semibold">Win Rate</p>
+                                <p class="text-2xl font-bold text-purple-600">{{ userStats.win_rate }}</p>
+                            </div>
+                            <div class="rounded-lg bg-green-500/10 p-4 text-center border border-green-500/20">
+                                <p class="text-xs uppercase text-green-600 font-semibold">Wins</p>
+                                <p class="text-2xl font-bold text-green-600">{{ userStats.total_wins }}</p>
+                            </div>
+                            <div class="rounded-lg bg-red-500/10 p-4 text-center border border-red-500/20">
+                                <p class="text-xs uppercase text-red-600 font-semibold">Losses</p>
+                                <p class="text-2xl font-bold text-red-600">{{ userStats.total_losses }}</p>
+                            </div>
+                        </div>
+
+                        <div class="space-y-2">
+                            <div class="flex justify-between text-xs font-medium">
+                                <span>Win/Loss Ratio</span>
+                                <span>{{ userStats.total_wins }}W - {{ userStats.total_losses }}L</span>
+                            </div>
+                            <div class="h-2 w-full bg-red-500/20 rounded-full overflow-hidden flex">
+                                <div class="bg-green-500 h-full" :style="{ width: userStats.win_rate }"></div>
+                            </div>
+                        </div>
+                    </div>
+                </CardContent>
+            </Card>
+        </div>
+
+        <div v-if="showLeaderboardModal"
+            class="fixed inset-0 z-[60] flex items-center justify-center bg-black/60 backdrop-blur-sm p-4">
+            <Card class="w-full max-w-lg max-h-1/2 h-[80vh] flex flex-col border-purple-500 shadow-2xl">
+                <CardHeader class="border-b">
+                    <div class="flex justify-between items-center">
+                        <CardTitle class="flex items-center gap-2">
+                            <Trophy class="text-purple-500" /> Leaderboard
+                        </CardTitle>
+                        <Button variant="ghost" size="sm" @click="showLeaderboardModal = false">X</Button>
+                    </div>
+                </CardHeader>
+
+                <CardContent class="flex-1 overflow-y-auto custom-scrollbar p-0">
+                    <div v-for="(user, index) in leaderboardEntries" :key="user.id"
+                        class="flex items-center justify-between p-4 border-b last:border-0 hover:bg-muted/30 transition-colors">
+
+                        <div class="flex items-center gap-4">
+                            <span class="font-bold text-muted-foreground w-6 text-center"
+                                :class="{ 'text-yellow-500': index === 0, 'text-slate-400': index === 1, 'text-orange-400': index === 2 }">
+                                #{{ index + 1 }}
+                            </span>
+                            <img :src="getAvatarUrl(user.photo_avatar_filename)"
+                                class="h-10 w-10 rounded-full border border-purple-200 object-cover" alt="Avatar" />
+                            <div>
+                                <p class="font-semibold text-sm">{{ user.nickname }}</p>
+                                <p class="text-[10px] text-muted-foreground uppercase tracking-wider">Player</p>
+                            </div>
+                        </div>
+
+                        <div class="text-right">
+                            <p class="text-lg font-bold text-purple-600">{{ user.won_games_count }}</p>
+                            <p class="text-[10px] text-muted-foreground uppercase">Wins</p>
+                        </div>
+                    </div>
+
+                    <div ref="lbObserverTarget" class="h-20 flex items-center justify-center">
+                        <span v-if="lbLoading" class="text-purple-500 animate-bounce">Loading rankings...</span>
+                    </div>
+                </CardContent>
+            </Card>
+        </div>
+    </div>
+
+    <div class="fixed right-4 top-1/2 -translate-y-1/2 flex flex-col gap-4 z-40">
+        <Button @click="openLeaderboard" variant="outline" size="icon"
+            class="h-12 w-12 rounded-full shadow-lg border-purple-500 bg-card hover:bg-purple-500 hover:text-white transition-all">
+            <Trophy class="h-6 w-6" />
+        </Button>
+        <Button v-if="useAuthStore().isLoggedIn" @click="openStats" variant="outline" size="icon"
+            class="h-12 w-12 rounded-full shadow-lg border-purple-500 bg-card hover:bg-purple-500 hover:text-white transition-all">
+            <User class="h-6 w-6" />
+        </Button>
+    </div>
+</template>

frontend/src/pages/login/LoginPage.vue

@@ -44,7 +44,7 @@
 
                 <div class="text-center text-sm">
                     <span class="text-gray-600">Don't have an account? </span>
-                    <a href="#" class="font-medium text-blue-600 hover:text-blue-500">
+                    <a href="/register" class="font-medium text-blue-600 hover:text-blue-500">
                         Sign up
                     </a>
                 </div>