hotfix: Singler player now plays fine

Reviewed-on: https://gitea.fernandovideira.com/SyntaxSquad/DADProject/pulls/99
Reviewed-by: KZix <[email protected]>
Reviewed-by: Edd <[email protected]>
Reviewed-by: FernandoJVideira <[email protected]>

api/app/Http/Controllers/AuthController.php

@@ -58,12 +58,20 @@ class AuthController extends Controller
             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,9 +4,7 @@ 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
 {
@@ -19,15 +17,13 @@ class GameController extends Controller
         $user = Auth::user();
         $query = Game::query()->with(["winner", "player1", "player2"]);
 
-        // Filter games based on user type
+        // Se não for Admin, mostra apenas os jogos do utilizador
         if ($user->type !== 'A') {
-            // Players can only see games they participate in
             $query->where(function ($q) use ($user) {
                 $q->where('player1_user_id', $user->id)
                   ->orWhere('player2_user_id', $user->id);
             });
         }
-        // Admins see all games (no filter needed)
 
         if ($request->has("type") && in_array($request->type, ["3", "9"])) {
             $query->where("type", $request->type);
@@ -47,19 +43,76 @@ class GameController extends Controller
 
         if ($request->has("sort_direction") && in_array($request->sort_direction, ["asc", "desc"])) {
             $query->orderBy("began_at", $request->sort_direction);
-        }else{
+        } else {
             $query->orderBy("began_at", "desc");
         }
 
         return response()->json($query->paginate(15));
     }
 
+    // --- MÉTODOS ADICIONADOS ---
+
+    // Host a new multiplayer Game
+    public function host(Request $request)
+    {
+        $request->validate([
+            'type' => 'required|in:3,9'
+        ]);
+
+        $user = $request->user();
+
+        // Check for active game
+        $activeGame = Game::where(function ($q) use ($user) {
+             $q->where("player1_user_id", $user->id)
+               ->orWhere("player2_user_id", $user->id);
+        })
+        ->whereIn("status", ["Pending", "Playing"])
+        ->exists();
+
+        if ($activeGame) {
+             return response()->json(["message" => "You already have an active game."], 400);
+        }
+
+        $game = Game::create([
+            'type' => $request->type,
+            'status' => 'Pending',
+            'player1_user_id' => $user->id,
+            'player2_user_id' => self::GHOST_ID, // Ghost ID = 1 (Waiting for player)
+            'began_at' => now(),
+            'player1_points' => 0,
+            'player2_points' => 0,
+        ]);
+
+        return response()->json($game, 201);
+    }
+
+    // List open games (Available to join)
+    public function open(Request $request)
+    {
+        $type = $request->query('type', '9');
+        $GHOST_ID = 1;
+
+        $games = Game::where('status', 'Pending')
+            ->where('player2_user_id', $GHOST_ID) // Games waiting for P2
+            ->where('type', $type)
+            ->with('player1')
+            ->orderBy('began_at', 'asc')
+            ->paginate(10);
+
+        return response()->json($games);
+    }
+    // ---------------------------
+
     public function store(Request $request)
     {
         $this->authorize('create', Game::class);
 
         $validated = $request->validate([
             "type" => "required|in:3,9",
+            "player2_user_id" => "nullable|integer|exists:users,id",
+            "match_id" => "nullable|integer|exists:matches,id",
+            "status" => "nullable|in:Pending,Playing",
+            "began_at" => "nullable|date"
         ]);
 
         $user = Auth::user();
@@ -75,51 +128,65 @@ class GameController extends Controller
              return response()->json(["message" => "You already have an active game."], 400);
         }
 
+        $player2Id = $request->input('player2_user_id', self::GHOST_ID);
+
+        $initialStatus = $request->input('status', 'Pending');
+
+        // If specific player 2 is provided, auto-start game
+        if ($player2Id !== self::GHOST_ID && !$request->has('status')) {
+            $initialStatus = 'Playing';
+        }
+
         $game = Game::create([
             "type" => $validated["type"],
-            "status" => "Pending",
+            "status" => $initialStatus,
             "player1_user_id" => $user->id,
-            "player2_user_id" => self::GHOST_ID, 
-            "winner_user_id" => self::GHOST_ID,
-            "loser_user_id" => self::GHOST_ID,
-            "began_at" => now(),
+            "player2_user_id" => $player2Id,
+            "winner_user_id" => null,
+            "loser_user_id" => null,
+            "match_id" => $request->input('match_id', null),
+            "began_at" => $request->input('began_at', now()),
             "player1_points" => 0,
             "player2_points" => 0,
             "custom" => null,
         ]);
 
         return response()->json([
-            "message" => "Multiplayer game room created",
+            "message" => "Game created",
             "game" => $game,
         ], 201);
     }
 
-    public function join(Game $game)
+    public function join(Request $request, Game $game)
     {
-        $this->authorize('join', $game);
-        
-        $user = Auth::user();
-
-        if ($game->player1_user_id == $user->id) {
-            return response()->json([
-                "message" => "You are the host. Waiting for opponent...",
-                "game" => $game
-            ], 200);
+        // Prevent joining if already full or started
+        if ($game->status !== 'Pending' || $game->player2_user_id !== self::GHOST_ID) {
+            return response()->json(['message' => 'Game is not available'], 400);
         }
 
-        if ($game->player2_user_id !== self::GHOST_ID) {
-            return response()->json(["message" => "Game is full"], 400);
+        // Prevent joining your own game
+        if ($game->player1_user_id === $request->user()->id) {
+            return response()->json(['message' => 'Cannot join your own game'], 400);
+        }
+
+        // Check if joining user has another active game
+        $activeGame = Game::where(function ($q) use ($request) {
+             $q->where("player1_user_id", $request->user()->id)
+               ->orWhere("player2_user_id", $request->user()->id);
+        })
+        ->whereIn("status", ["Pending", "Playing"])
+        ->exists();
+
+        if ($activeGame) {
+             return response()->json(["message" => "You already have an active game."], 400);
         }
 
         $game->update([
-            "status" => "Playing",
-            "player2_user_id" => $user->id,
+            'player2_user_id' => $request->user()->id,
+            'status' => 'Playing',
         ]);
 
-        return response()->json([
-            "message" => "Joined successfully!",
-            "game" => $game,
-        ], 200);
+        return response()->json($game);
     }
 
     public function show(Game $game)
@@ -177,4 +244,19 @@ class GameController extends Controller
             'game' => $game->fresh(),
         ]);
     }
+
+    public function destroy(Game $game)
+    {
+        // Ensure only the host can delete, and ONLY if it's still Pending
+        if ($game->player1_user_id !== auth()->id()) {
+            return response()->json(['message' => 'Unauthorized'], 403);
+        }
+
+        if ($game->status !== 'Pending') {
+            return response()->json(['message' => 'Cannot delete a game in progress'], 400);
+        }
+
+        $game->delete();
+        return response()->noContent();
+    }
 }

api/app/Http/Controllers/MatchController.php

@@ -3,26 +3,36 @@
 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
 {
     public function index(Request $request)
     {
-        $query = MatchGame::query()->with(['winner', 'player1', 'player2']);
+        $query = MatchGame::query()->with(["winner", "player1", "player2"]);
 
-        if ($request->has('type')) {
-            $query->where('type', $request->type);
+        if ($request->has("type")) {
+            $query->where("type", $request->type);
         }
 
-        if ($request->has('status')) {
-            $query->where('status', $request->status);
+        if ($request->has("status")) {
+            $query->where("status", $request->status);
         }
 
-        $query->orderBy('began_at', 'desc');
+        if ($request->has("pot") && in_array($request->pot, ["asc", "desc"])) {
+            $query->orderBy("stake", $request->pot);
+        } elseif (
+            $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));
     }
@@ -30,105 +40,334 @@ class MatchController extends Controller
     public function store(StoreMatchRequest $request)
     {
         $validated = $request->validated();
-        $user = Auth::user();
+        $user = $request->user();
+        $stake = $validated['stake'];
 
-        $activeMatch = MatchGame::where(function ($q) use ($user) {
-            $q->where('player1_user_id', $user->id)
-              ->orWhere('player2_user_id', $user->id);
-        })->whereIn('status', ['Pending', 'Playing'])->exists();
-
-        $activeGame = Game::where(function ($q) use ($user) {
-            $q->where('player1_user_id', $user->id)
-              ->orWhere('player2_user_id', $user->id);
-        })->whereIn('status', ['Pending', 'Playing'])->exists();
-
-        if ($activeMatch || $activeGame) {
-            return response()->json(['message' => 'You already have an active game or match.'], 400);
+        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();
+
+        if ($activeMatch) {
+            return response()->json(['message' => 'You already have an active match.'], 400);
+        }
+
+        return DB::transaction(function () use ($validated, $user, $stake) {
+            $GHOST_ID = 1;
+
+            $user->decrement("coins_balance", $stake);
+
+            $stakeType = CoinTransactionType::firstOrCreate(
+                ["name" => "Match stake"],
+                ["type" => "D"], // Debit
+            );
+
             $match = MatchGame::create([
-            'type' => $validated['type'],
-            'status' => 'Pending',
-            'player1_user_id' => $user->id,
-            'player2_user_id' => $user->id,
-            'winner_user_id' => $user->id,
-            'loser_user_id' => $user->id,
-            'stake' => $validated['stake'],
-            'began_at' => now(),
-            'player1_marks' => 0,
-            'player2_marks' => 0,
-            'player1_points' => 0,
-            'player2_points' => 0,
-            'custom' => null
+                "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,
             ]);
 
-        return response()->json([
-            'message' => 'Match created successfully',
-            'match' => $match
-        ], 201);
+            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)
     {
-        $match->load(['player1', 'player2', 'winner']);
+        $match->load(["player1", "player2", "winner"]);
         return response()->json($match);
     }
 
     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 ($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);
-        })->whereIn('status', ['Pending', 'Playing'])->exists();
+            $q->where("player1_user_id", $user->id)->orWhere(
+                "player2_user_id",
+                $user->id,
+            );
+        })
+            ->whereIn("status", ["Pending", "Playing"])
+            ->exists();
 
         if ($activeMatch) {
-             return response()->json(['message' => 'You are already in another active match.'], 400);
+            return response()->json(
+                ["message" => "You are already in another active match."],
+                400,
+            );
         }
 
+        return DB::transaction(function () use ($match, $user) {
+            $user->decrement("coins_balance", $match->stake);
+
+            $stakeType = CoinTransactionType::firstOrCreate(
+                ["name" => "Match stake"],
+                ["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
+                "status" => "Playing",
+                "player2_user_id" => $user->id,
             ]);
 
             return response()->json([
-            'message' => 'Joined match successfully!',
-            'match' => $match
+                "message" => "Joined match successfully!",
+                "match" => $match,
+                "balance" => $user->coins_balance,
             ]);
+        });
     }
 
     public function update(Request $request, MatchGame $match)
     {
-        if ($match->status == 'Ended') {
-            return response()->json(['message' => 'Match already ended'], 400);
+        if ($match->status == "Ended") {
+            return response()->json(["message" => "Match already ended"], 400);
         }
 
         $data = $request->validate([
-            'status' => 'in:Playing,Ended,Interrupted',
-            'winner_user_id' => 'exists:users,id',
-            'loser_user_id' => 'exists:users,id',
-            'player1_marks' => 'integer',
-            'player2_marks' => 'integer',
-            'player1_points' => 'integer',
-            'player2_points' => 'integer',
-            'total_time' => 'numeric'
+            "status" => "in:Playing,Ended,Interrupted",
+            "winner_user_id" => "exists:users,id",
+            "loser_user_id" => "exists:users,id",
+            "player1_marks" => "integer",
+            "player2_marks" => "integer",
+            "player1_points" => "integer",
+            "player2_points" => "integer",
+            "total_time" => "numeric",
         ]);
 
+        return DB::transaction(function () use ($match, $data) {
             if (isset($data['status']) && $data['status'] === 'Ended') {
                 $data['ended_at'] = now();
             }
 
             $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);
+        });
+    }
+
+    public function host(Request $request)
+    {
+        $request->validate([
+            "type" => "required|in:3,9",
+            "stake" => "required|integer|min:0",
+        ]);
+
+        $user = $request->user();
+        $stake = $request->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();
+
+        if ($activeMatch) {
+            return response()->json(
+                ["message" => "You already have an active match."],
+                400,
+            );
+        }
+
+        return DB::transaction(function () use ($request, $user, $stake) {
+            $GHOST_ID = 1;
+
+            $user->decrement("coins_balance", $stake);
+
+            $stakeType = CoinTransactionType::firstOrCreate(
+                ["name" => "Match stake"],
+                ["type" => "D"], // Debit
+            );
+
+            $match = MatchGame::create([
+                'type' => $request->type,
+                'status' => 'Pending',
+                'player1_user_id' => $user->id,
+                'player2_user_id' => $GHOST_ID,
+                'winner_user_id' => null,
+                'loser_user_id' => null,
+                '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($match, 201);
+        });
+    }
+
+    public function open(Request $request)
+    {
+        $query = MatchGame::where('status', 'Pending')
+            ->where(function($q) {
+                $q->whereNull('player2_user_id')
+                  ->orWhere('player2_user_id', 1); // 1 = Ghost ID
+            });
+
+        if ($request->has('type')) {
+            $query->where('type', $request->type);
+        }
+
+        $matches = $query->with('player1:id,nickname')
+            ->orderBy('began_at', 'desc')
+            ->paginate(10);
+
+        return response()->json($matches);
+    }
+
+    // --- FIX: Safely Delete Match by removing dependencies first ---
+    public function destroy(MatchGame $match)
+    {
+        $user = request()->user();
+
+        if ($match->player1_user_id !== $user->id) {
+            return response()->json(['message' => 'Unauthorized'], 403);
+        }
+
+        if ($match->status !== 'Pending') {
+            return response()->json(['message' => 'Cannot cancel a match that has already started'], 400);
+        }
+
+        return DB::transaction(function () use ($match, $user) {
+            // 1. Delete associated Games first (The FK constraint cause)
+            DB::table('games')->where('match_id', $match->id)->delete();
+
+            // 2. Unlink existing Coin Transactions (Set match_id to NULL)
+            CoinTransaction::where('match_id', $match->id)->update(['match_id' => null]);
+
+            // 3. Process Refund
+            if ($match->stake > 0) {
+                 $user->increment('coins_balance', $match->stake);
+
+                 $refundType = CoinTransactionType::firstOrCreate(
+                     ['name' => 'Refund'],
+                     ['type' => 'C']
+                 );
+
+                 // Create Refund Transaction with NO LINK to the deleted match
+                 CoinTransaction::create([
+                     'user_id' => $user->id,
+                     'match_id' => null, // IMPORTANT: Must be null
+                     'coin_transaction_type_id' => $refundType->id,
+                     'transaction_datetime' => now(),
+                     'coins' => $match->stake,
+                     'custom' => "Refund for Match #{$match->id}"
+                 ]);
+            }
+
+            // 4. Finally delete the match
+            $match->delete();
+
+            return response()->json([
+                'message' => 'Match canceled and refunded',
+                'balance' => $user->coins_balance
+            ]);
+        });
     }
 }

api/app/Http/Controllers/ProfileController.php

@@ -82,7 +82,7 @@ class ProfileController extends Controller
         ]);
     }
 
-    public function updateAvatar(Request $request)
+    public function uploadAvatar(Request $request)
     {
         $request->validate([
             "avatar" => "required|image|mimes:jpeg,png,jpg,gif|max:2048",

api/app/Http/Controllers/StatisticsController.php

@@ -7,6 +7,7 @@ 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
 {
@@ -28,16 +29,23 @@ class StatisticsController extends Controller
     {
         $type = $request->query('type');
 
-        $query = User::where('type', 'P')
+        $leaderboard = User::where('type', 'P')
             ->withCount(['wonGames' => function ($query) use ($type) {
                 if ($type) {
                     $query->where('type', $type);
                 }
             }])
             ->orderBy('won_games_count', 'desc')
-            ->take(10);
+            ->paginate(10);
 
-        $leaderboard = $query->get(['id', 'nickname', 'photo_avatar_filename']);
+        $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);
     }
@@ -73,4 +81,56 @@ class StatisticsController extends Controller
             '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

@@ -4,6 +4,7 @@ namespace App\Http\Controllers;
 
 use App\Models\Game;
 use App\Models\User;
+use App\Models\MatchGame;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Auth;
 use Illuminate\Support\Facades\Hash;
@@ -17,20 +18,23 @@ class UserController extends Controller
      */
     public function index(Request $request)
     {
-        $this->authorize('viewAny', User::class);
+        $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("type")) {
+            $query->where("type", $request->type);
         }
 
-        if ($request->has('search')) {
+        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.'%')
-                    ->orWhere('email', 'like', '%'.$request->search.'%')
-                    ->orWhere('nickname', 'like', '%'.$request->search.'%');
+                $q->where("name", "like", "%" . $request->search . "%")
+                    ->orWhere("email", "like", "%" . $request->search . "%")
+                    ->orWhere("nickname", "like", "%" . $request->search . "%");
             });
         }
 
@@ -43,17 +47,16 @@ class UserController extends Controller
      */
     public function store(Request $request)
     {
-        $this->authorize('create', User::class);
+        $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',
+            "name" => "required|string|max:255",
+            "email" => "required|email|unique:users,email",
+            "password" => "required|string|min:3",
+            "type" => "required|in:A,U",
         ]);
 
-        $validated['password'] = Hash::make($validated['password']);
+        $validated["password"] = Hash::make($validated["password"]);
 
         $user = User::create($validated);
 
@@ -79,15 +82,15 @@ class UserController extends Controller
         $currentUser = Auth::user();
 
         // Admins and owners get full profile, others get limited view
-        if ($currentUser->type === 'A' || $currentUser->id === $user->id) {
+        if ($currentUser->type === "A" || $currentUser->id === $user->id) {
             return response()->json($user);
         } else {
             return response()->json([
-                'id' => $user->id,
-                'name' => $user->name,
-                'nickname' => $user->nickname,
-                'photo_avatar_filename' => $user->photo_avatar_filename,
-                'type' => $user->type,
+                "id" => $user->id,
+                "name" => $user->name,
+                "nickname" => $user->nickname,
+                "photo_avatar_filename" => $user->photo_avatar_filename,
+                "type" => $user->type,
             ]);
         }
     }
@@ -98,22 +101,22 @@ class UserController extends Controller
      */
     public function update(Request $request, User $user)
     {
-        $this->authorize('update', $user);
+        $this->authorize("update", $user);
 
         $validated = $request->validate([
-            'name' => 'sometimes|string|max:255',
-            'nickname' => [
-                'sometimes',
-                'string',
-                'max:20',
-                Rule::unique('users')->ignore($user->id),
+            "name" => "sometimes|string|max:255",
+            "nickname" => [
+                "sometimes",
+                "string",
+                "max:20",
+                Rule::unique("users")->ignore($user->id),
             ],
-            'email' => [
-                'sometimes',
-                'email',
-                Rule::unique('users')->ignore($user->id),
+            "email" => [
+                "sometimes",
+                "email",
+                Rule::unique("users")->ignore($user->id),
             ],
-            'password' => 'sometimes|string|min:3',
+            "password" => "sometimes|string|min:3",
         ]);
 
         // Lógica de Upload de Foto (Exemplo Básico)
@@ -127,57 +130,195 @@ 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)
     {
-        $this->authorize('delete', $user);
+        $this->authorize("delete", $user);
 
         // Check if user has transactions or games - if so, soft delete
         $hasTransactions = $user->transactions()->exists();
         $hasGames = Game::where(function ($q) use ($user) {
-            $q->where('player1_user_id', $user->id)
-                ->orWhere('player2_user_id', $user->id);
+            $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)';
+            $message =
+                "User account deactivated (soft-deleted due to transaction/game history)";
         } else {
             $user->forceDelete(); // Hard delete
-            $message = 'User permanently deleted';
+            $message = "User permanently deleted";
         }
 
-        return response()->json(['message' => $message]);
+        return response()->json(["message" => $message]);
+    }
+
+    /**
+     * GET /api/users/{user}/games
+     * Histórico de Partidas Individuais (Cartas)
+     */
+    public function getGames(Request $request, User $user)
+    {
+        $this->authorize("view", $user);
+
+        // Define a query base para GAMES
+        $query = \App\Models\Game::query()
+            ->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);
+        }
+
+        if ($request->has("status")) {
+            $query->where("status", $request->status);
+        }
+
+        // Date filtering
+        if ($request->has("date_from")) {
+            $query->whereDate("began_at", ">=", $request->date_from);
+        }
+
+        if ($request->has("date_to")) {
+            $query->whereDate("began_at", "<=", $request->date_to);
+        }
+
+        // Flexible sorting
+        $sortColumn = $request->get("sort_by", "began_at");
+        $sortDirection = $request->get("sort_direction", "desc");
+
+        // Whitelist sortable columns for security
+        $allowedColumns = [
+            "began_at",
+            "ended_at",
+            "total_time",
+            "total_points",
+        ];
+        if (in_array($sortColumn, $allowedColumns)) {
+            $query->orderBy($sortColumn, $sortDirection);
+        } else {
+            $query->orderBy("began_at", $sortDirection);
+        }
+
+        $games = $query->paginate(10);
+
+        $games->getCollection()->transform(function ($game) use ($user) {
+            if ($game->winner_user_id == $user->id) {
+                $game->outcome = "win";
+            } elseif ($game->is_draw) {
+                $game->outcome = "draw";
+            } else {
+                $game->outcome = "loss";
+            }
+            return $game;
+        });
+
+        return response()->json($games);
     }
 
     /**
      * GET /api/users/{user}/matches
-     * Histórico de Jogos Multiplayer do Utilizador
+     * Histórico de Matches (Apostas / Marcas)
      */
     public function getMatches(Request $request, User $user)
     {
-        $this->authorize('view', $user);
+        $this->authorize("view", $user);
 
-        $matches = Game::query()
+        $query = MatchGame::query()
             ->where(function ($q) use ($user) {
-                $q->where('player1_user_id', $user->id)->orWhere(
-                    'player2_user_id',
+                $q->where("player1_user_id", $user->id)->orWhere(
+                    "player2_user_id",
                     $user->id,
                 );
             })
-            ->with(['winner', 'player1', 'player2'])
-            ->orderBy('began_at', 'desc')
-            ->paginate(10);
+            ->with(["winner", "player1", "player2"]);
+
+        if ($request->has("type")) {
+            $query->where("type", $request->type);
+        }
+
+        if ($request->has("status")) {
+            $query->where("status", $request->status);
+        }
+
+        // Date filtering
+        if ($request->has("date_from")) {
+            $query->whereDate("began_at", ">=", $request->date_from);
+        }
+
+        if ($request->has("date_to")) {
+            $query->whereDate("began_at", "<=", $request->date_to);
+        }
+
+        // Flexible sorting
+        $sortColumn = $request->get("sort_by", "began_at");
+        $sortDirection = $request->get("sort_direction", "desc");
+
+        // Whitelist sortable columns for security
+        $allowedColumns = ["began_at", "ended_at", "stake", "total_time"];
+        if (in_array($sortColumn, $allowedColumns)) {
+            $query->orderBy($sortColumn, $sortDirection);
+        } else {
+            $query->orderBy("began_at", $sortDirection);
+        }
+
+        $matches = $query->paginate(10);
+
+        $matches->getCollection()->transform(function ($match) use ($user) {
+            if ($match->winner_user_id == $user->id) {
+                $match->outcome = "win";
+            } elseif (
+                $match->winner_user_id &&
+                $match->winner_user_id != $user->id
+            ) {
+                $match->outcome = "loss";
+            } else {
+                $match->outcome = "interrupted"; // Matches geralmente não empatam (alguém chega a 4 marcas)
+            }
+            return $match;
+        });
 
         return response()->json($matches);
     }
 
     public function block(User $user)
     {
-        $this->authorize('block', $user);
+        $this->authorize("block", $user);
 
         $user->blocked = true;
         $user->save();
@@ -185,16 +326,57 @@ class UserController extends Controller
         // Revoke all active tokens for immediate effect
         $user->tokens()->delete();
 
-        return response()->json(['message' => 'User blocked successfully']);
+        return response()->json(["message" => "User blocked successfully"]);
     }
 
     public function unblock(User $user)
     {
-        $this->authorize('unblock', $user);
+        $this->authorize("unblock", $user);
 
         $user->blocked = false;
         $user->save();
 
-        return response()->json(['message' => 'User unblocked successfully']);
+        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;
+
+class CoinTransactionType extends Model
+{
+    use HasFactory;
+
+    // FIX: Disable auto-timestamps because the table doesn't have updated_at/created_at columns
+    public $timestamps = false;
+
+    protected $fillable = [
+        'name',
+        'type',
+        'description' // Include description if your table has it
+    ];
+}

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;
 
 
@@ -30,11 +29,22 @@ class Game extends Model
         'match_id'
     ];
 
+    protected $casts = [
+        'began_at' => 'datetime',
+        'ended_at' => 'datetime',
+        'is_draw' => 'boolean',
+    ];
+
     public function winner()
     {
         return $this->belongsTo(User::class, "winner_user_id");
     }
 
+    public function loser()
+    {
+        return $this->belongsTo(User::class, "loser_user_id");
+    }
+
     public function player1()
     {
         return $this->belongsTo(User::class, 'player1_user_id');

api/app/Models/User.php

@@ -58,4 +58,9 @@ class User extends Authenticatable
     {
         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

@@ -20,7 +20,7 @@ class GamePolicy
      */
     public function view(User $user, Game $game): bool
     {
-        if ($user->type === 'A') {
+        if ($user->type === "A") {
             return true;
         }
 
@@ -31,6 +31,10 @@ class GamePolicy
             return true;
         }
 
+        if ($game->status === "Pending") {
+            return true;
+        }
+
         return false;
     }
 
@@ -39,7 +43,7 @@ class GamePolicy
      */
     public function create(User $user): bool
     {
-        if ($user->type === 'A') {
+        if ($user->type === "A") {
             return false;
         }
 
@@ -48,28 +52,32 @@ class GamePolicy
 
     public function join(User $user, Game $game): bool
     {
-        if ($user->type === 'A') {
+        if ($user->type === "A") {
             return false;
         }
 
         if (
-            $game->status !== 'waiting' ||
+            $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') {
+        if ($user->type === "A") {
             return false;
         }
 
         if (
-            $game->status !== 'ongoing' ||
+            $game->status !== "Playing" ||
             ($game->player1_user_id !== $user->id &&
                 $game->player2_user_id !== $user->id)
         ) {
@@ -78,34 +86,32 @@ class GamePolicy
 
         return true;
     }
-
     /**
      * Determine whether the user can update the model.
      */
     public function update(User $user, Game $game): bool
     {
-        if ($user->type === 'A') {
+        if ($user->type === "A") {
             return false;
         }
 
-        if (
-            $game->status !== 'ongoing' ||
-            ($game->player1_user_id !== $user->id &&
-                $game->player2_user_id !== $user->id)
-        ) {
+        if (!in_array($game->status, ['Playing', 'Pending'])) {
+            return false;
+        }
+
+        if ($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';
+        return $user->type === "A";
     }
 
     /**

api/routes/api.php

@@ -4,8 +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\UserController;
 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 () {
@@ -19,10 +21,12 @@ Route::prefix('v1')->group(function () {
     // 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', [
@@ -30,41 +34,46 @@ Route::prefix('v1')->group(function () {
                 'updatePassword',
             ]);
             Route::post('/avatar', [ProfileController::class, 'uploadAvatar']);
+            Route::get('/transactions', [UserController::class, 'getMyTransactions']);
         });
 
         // User Resources
         Route::prefix('/users')->group(function () {
             Route::get('/{user}', [UserController::class, 'show']);
-            Route::get('/{user}/matches', [
-                UserController::class,
-                'getMatches',
-            ]);
+            Route::get('/{user}/transactions', [UserController::class, 'getTransactions']);
+            Route::get('/{user}/games', [UserController::class, 'getGames']);
+            Route::get('/{user}/matches', [UserController::class, 'getMatches']);
         });
 
-        // Game Resources
         Route::prefix('games')->group(function () {
-            Route::apiResource('/', GameController::class)->parameters([
-                '' => 'game',
-            ]);
-            Route::post('/{game}/join', [GameController::class, 'join']);
+            Route::post('host', [GameController::class, 'host']);
+            Route::get('open', [GameController::class, 'open']);
+            Route::get('/', [GameController::class, 'index']);
+            Route::get('/{game}', [GameController::class, 'show']);
+            Route::post('/', [GameController::class, 'store']);
+            Route::put('/{game}', [GameController::class, 'update']);
+            Route::delete('/{game}', [GameController::class, 'destroy']);
             Route::post('/{game}/resign', [GameController::class, 'resign']);
+            Route::post('/{game}/join', [GameController::class, 'join']);
         });
 
-        // Match Resources
         Route::prefix('matches')->group(function () {
-            Route::apiResource('/', MatchController::class)->parameters([
-                '' => 'match',
-            ]);
-            Route::post('/{match}/join', [
-                MatchController::class,
-                'join',
-            ]);
+            Route::post('host', [MatchController::class, 'host']);
+            Route::get('open', [MatchController::class, 'open']);
+            Route::post('/{match}/join', [MatchController::class, 'join']);
+            Route::post('/{match}/start', [MatchController::class, 'start']); // Changed to /start to be explicit
+            Route::delete('/{match}', [MatchController::class, 'destroy']);
+            Route::apiResource('/', MatchController::class)->parameters(['' => 'match']);
         });
 
         // Admin Routes
         Route::middleware('user.type:A')
             ->prefix('admin')
             ->group(function () {
+                Route::get('/statistics', [StatisticsController::class, 'getAdminStats']);
+                Route::get('/transactions', [TransactionController::class, 'index']);
+                Route::get('/games', [GameController::class, 'index']);
+                Route::get('/matches', [MatchController::class, 'index']);
                 Route::prefix('users')->group(function () {
                     Route::get('/', [UserController::class, 'index']);
                     Route::post('/', [UserController::class, 'store']);

api/sample-requests.http

@@ -1,19 +1,84 @@
 ### Get All Students (Login)
 # @name login
-POST http://localhost:8000/api/login
+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
+### Capture the token & id
 @token = {{login.response.body.token}}
+@id = {{login.response.body.user.id}}
 
 ### Get All matches
-GET http://localhost:8000/api/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/package.json

@@ -16,7 +16,7 @@
   "dependencies": {
     "@tailwindcss/vite": "^4.1.17",
     "@tanstack/vue-table": "^8.21.3",
-    "@vueuse/core": "^14.0.0",
+    "@vueuse/core": "^14.1.0",
     "axios": "^1.13.2",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
@@ -24,7 +24,7 @@
     "lucide-react": "^0.562.0",
     "lucide-vue-next": "^0.554.0",
     "pinia": "^3.0.3",
-    "reka-ui": "^2.6.0",
+    "reka-ui": "^2.7.0",
     "socket.io-client": "^4.8.1",
     "tailwind-merge": "^3.4.0",
     "tailwindcss": "^4.1.17",

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; ({{ authStore.currentUser?.name }})
+      <span class="text-xs" v-if="authStore.currentUser">&nbsp;&nbsp;&nbsp; ({{ authStore.currentUser?.name }})
       </span>
     </div>
     <NavBar @logout="logout" :userLoggedIn="authStore.isLoggedIn" />
@@ -29,8 +28,7 @@ import { useSocketStore } from './stores/socket'
 const authStore = useAuthStore()
 const socketStore = useSocketStore()
 
-const year = new Date().getFullYear()
-const pageTitle = ref(`DAD ${year}/${String(year + 1).slice(-2)}`)
+const pageTitle = ref(`DAD 2025/26`)
 
 const logout = () => {
   toast.promise(authStore.logout(), {
@@ -44,7 +42,8 @@ const logout = () => {
 
 onMounted(async () => {
   await authStore.restoreSession()
-  socketStore.handleConnection()
+  // REMOVED - The WebSocket for multiplayer is handled separately in the WebSocketStore
+  // socketStore.handleConnection()
 })
 </script>
 

frontend/src/components/game/GameBoard.vue

@@ -7,6 +7,8 @@
         :player-score="playerScore"
         :opponent-score="opponentScore"
         :current-turn="currentTurn"
+        :player-name="playerName"
+        :opponent-name="opponentName"
         :round-number="1"
       />
     </div>
@@ -62,16 +64,20 @@ const props = defineProps({
   // REMOVIDO: playableCardIndices (já não precisamos dele)
   playerScore: { type: Number, default: 0 },
   opponentScore: { type: Number, default: 0 },
+  playerName: { type: String, default: 'You' },
+  opponentName: { type: String, default: 'Bot' },
   currentTurn: {
     type: String,
     default: 'player',
     validator: (value) => ['player', 'opponent'].includes(value),
   },
+  isMyTurn: { type: Boolean, default: false },
 })
 
 const emit = defineEmits(['play-card'])
 
 const handleCardClick = (payload) => {
+  if (!props.isMyTurn) return
   emit('play-card', payload.card)
 }
 </script>

frontend/src/components/game/PlayerHand.vue

@@ -51,6 +51,10 @@ const props = defineProps({
     default: 3,
     validator: (value) => [3, 9].includes(value),
   },
+  isDisabled: {
+    type: Boolean,
+    default: false,
+  },
 })
 
 const emit = defineEmits(['card-clicked'])

frontend/src/components/game/ScoreDisplay.vue

@@ -33,7 +33,8 @@
           turnChanged && 'animate-pulse',
         ]"
       >
-        {{ currentTurn === 'player' ? 'Your Turn' : "Bot's Turn" }}
+        <!-- You can replace the above line with the following if you want to show names instead -->
+        {{ currentTurn === 'player' ? playerName + "'s Turn" : opponentName + "'s Turn" }}
       </div>
       <span v-if="roundNumber" class="text-gray-500 text-[10px] font-medium">
         Round {{ roundNumber }}

frontend/src/components/layout/NavBar.vue

@@ -2,33 +2,29 @@
   <div>
     <NavigationMenu>
       <NavigationMenuList class="justify-around gap-20">
-                <NavigationMenuItem>
-                    <NavigationMenuTrigger>Testing</NavigationMenuTrigger>
-                    <NavigationMenuContent>
-                        <li>
-                            <NavigationMenuLink as-child>
-                                <RouterLink to="/testing/laravel">Laravel</RouterLink>
-                            </NavigationMenuLink>
-                            <NavigationMenuLink as-child>
-                                <RouterLink to="/testing/websockets">Web Sockets</RouterLink>
-                            </NavigationMenuLink>
-                        </li>
-                    </NavigationMenuContent>
-                </NavigationMenuItem>
-
         <NavigationMenuItem v-if="!userLoggedIn">
           <NavigationMenuLink>
             <RouterLink to="/login">Login</RouterLink>
           </NavigationMenuLink>
         </NavigationMenuItem>
 
-                <NavigationMenuItem v-else>
-                    <NavigationMenuLink>
-                        <a href="/home" @click.prevent="logoutClickHandler" class="cursor-pointer">Logout</a>
+        <NavigationMenuItem v-else class="flex flex-row gap-4">
+          <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>
@@ -45,7 +41,9 @@ import {
   NavigationMenuList,
   NavigationMenuTrigger,
 } from '@/components/ui/navigation-menu'
-import router from '@/router';
+import router from '@/router'
+import { watch } from 'vue'
+import { useUserStore } from '@/stores/user'
 
 const emits = defineEmits(['logout'])
 const { userLoggedIn } = defineProps(['userLoggedIn'])
@@ -55,7 +53,7 @@ const biscaStore = useBiscaStore()
 const logoutClickHandler = () => {
   if (biscaStore.isGameRunning) {
     const confirmLogout = window.confirm(
-            '⚠️ Jogo em Progresso!\n\nSe fizeres Logout agora, perderás o jogo atual e serás considerado PERDEDOR.\n\nQueres mesmo sair?'
+      'If you leave now this game will count as "FORFEIT". Are you sure you want to logout?',
     )
     if (!confirmLogout) return
 
@@ -67,7 +65,18 @@ const logoutClickHandler = () => {
   }
 
   emits('logout')
-
-    router.push({ name: 'home' }) 
+  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/label/Label.vue

@@ -0,0 +1,29 @@
+<script setup>
+import { reactiveOmit } from "@vueuse/core";
+import { Label } from "reka-ui";
+import { cn } from "@/lib/utils";
+
+const props = defineProps({
+  for: { type: String, required: false },
+  asChild: { type: Boolean, required: false },
+  as: { type: null, required: false },
+  class: { type: null, required: false },
+});
+
+const delegatedProps = reactiveOmit(props, "class");
+</script>
+
+<template>
+  <Label
+    data-slot="label"
+    v-bind="delegatedProps"
+    :class="
+      cn(
+        'flex items-center gap-2 text-sm leading-none font-medium select-none group-data-[disabled=true]:pointer-events-none group-data-[disabled=true]:opacity-50 peer-disabled:cursor-not-allowed peer-disabled:opacity-50',
+        props.class,
+      )
+    "
+  >
+    <slot />
+  </Label>
+</template>

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

@@ -0,0 +1 @@
+export { default as Label } from "./Label.vue";

frontend/src/components/ui/switch/Switch.vue

@@ -0,0 +1,49 @@
+<script setup>
+import { reactiveOmit } from "@vueuse/core";
+import { SwitchRoot, SwitchThumb, useForwardPropsEmits } from "reka-ui";
+import { cn } from "@/lib/utils";
+
+const props = defineProps({
+  defaultValue: { type: Boolean, required: false },
+  modelValue: { type: [Boolean, null], required: false },
+  disabled: { type: Boolean, required: false },
+  id: { type: String, required: false },
+  value: { type: String, required: false },
+  asChild: { type: Boolean, required: false },
+  as: { type: null, required: false },
+  name: { type: String, required: false },
+  required: { type: Boolean, required: false },
+  class: { type: null, required: false },
+});
+
+const emits = defineEmits(["update:modelValue"]);
+
+const delegatedProps = reactiveOmit(props, "class");
+
+const forwarded = useForwardPropsEmits(delegatedProps, emits);
+</script>
+
+<template>
+  <SwitchRoot
+    v-slot="slotProps"
+    data-slot="switch"
+    v-bind="forwarded"
+    :class="
+      cn(
+        'peer data-[state=checked]:bg-primary data-[state=unchecked]:bg-input focus-visible:border-ring focus-visible:ring-ring/50 dark:data-[state=unchecked]:bg-input/80 inline-flex h-[1.15rem] w-8 shrink-0 items-center rounded-full border border-transparent shadow-xs transition-all outline-none focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50',
+        props.class,
+      )
+    "
+  >
+    <SwitchThumb
+      data-slot="switch-thumb"
+      :class="
+        cn(
+          'bg-background dark:data-[state=unchecked]:bg-foreground dark:data-[state=checked]:bg-primary-foreground pointer-events-none block size-4 rounded-full ring-0 transition-transform data-[state=checked]:translate-x-[calc(100%-2px)] data-[state=unchecked]:translate-x-0',
+        )
+      "
+    >
+      <slot name="thumb" v-bind="slotProps" />
+    </SwitchThumb>
+  </SwitchRoot>
+</template>

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

@@ -0,0 +1 @@
+export { default as Switch } from "./Switch.vue";

frontend/src/pages/TestAllAnimations.vue

@@ -1,342 +0,0 @@
-<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

@@ -1,252 +0,0 @@
-<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

@@ -1,275 +0,0 @@
-<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

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

frontend/src/pages/game/MultiplayerGamePage.vue

@@ -0,0 +1,387 @@
+<template>
+  <div class="relative min-h-screen overflow-hidden bg-green-900">
+    <div v-if="shouldShowBoard && !gameOver" 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="!wsStore.connected && hasConnectedOnce"
+      class="absolute top-4 left-4 z-50 flex items-center gap-2 bg-gray-800 px-4 py-2 rounded-lg border border-gray-700 shadow-xl">
+      <div class="w-3 h-3 rounded-full bg-red-500 animate-pulse"></div>
+      <span class="text-white text-sm">Reconnecting...</span>
+    </div>
+
+    <div v-if="shouldShowBoard && !gameOver && isMyTurn" class="absolute top-4 left-1/2 -translate-x-1/2 z-50">
+      <div class="bg-gray-800 px-6 py-3 rounded-lg border-2 shadow-xl transition-colors duration-300"
+        :class="timeLeft <= 5 ? 'border-red-500 bg-red-900/20' : 'border-gray-700'">
+        <div class="flex items-center gap-3">
+          <svg class="w-6 h-6" :class="timeLeft <= 5 ? 'text-red-500 animate-bounce' : 'text-white'" viewBox="0 0 24 24"
+            fill="none" stroke="currentColor">
+            <circle cx="12" cy="12" r="10" stroke-width="2" />
+            <polyline points="12 6 12 12 16 14" stroke-width="2" />
+          </svg>
+          <span :class="['text-3xl font-mono font-bold', timeLeft <= 5 ? 'text-red-500' : 'text-white']">
+            {{ timeLeft }}
+          </span>
+        </div>
+      </div>
+    </div>
+
+    <div v-if="shouldShowBoard">
+      <GameBoard :trump-card="trumpCard" :cards-remaining="deckCount + (trumpCard ? 1 : 0)" :player-hand="visibleHand"
+        :opponent-hand="opponentHand" :player-score="playerScore" :opponent-score="opponentScore"
+        :player-name="myDisplayName" :opponent-name="opponentDisplayName" :current-turn="currentTurnLabel"
+        :current-trick="displayedTrick" :is-my-turn="isMyTurn" @play-card="handlePlayCard" />
+    </div>
+
+    <div v-else-if="!gameOver" class="flex h-screen items-center justify-center bg-green-900 text-white">
+      <div class="text-center p-8 bg-green-800/50 rounded-2xl border border-green-700 shadow-2xl backdrop-blur-sm">
+        <div class="relative mx-auto mb-6 h-16 w-16">
+          <div class="absolute inset-0 rounded-full border-4 border-green-600"></div>
+          <div
+            class="absolute inset-0 rounded-full border-4 border-t-white border-r-transparent border-b-transparent border-l-transparent animate-spin">
+          </div>
+        </div>
+
+        <h2 class="text-2xl font-bold mb-2">
+          Waiting for Opponent...
+        </h2>
+
+        <p class="text-green-100 mb-8 max-w-sm">
+          Share the game code or wait for a player to join your lobby.
+        </p>
+        <div class="bg-black/20 p-3 rounded mb-6 font-mono text-sm border border-white/10 text-green-100">
+          Match ID: <span class="font-bold text-white">{{ matchState.id }}</span>
+        </div>
+        <button @click="handleCloseModal"
+          class="px-6 py-3 bg-red-600 hover:bg-red-700 text-white rounded-lg font-semibold transition-all shadow-lg hover:shadow-red-500/20">
+          Cancel & Return Home
+        </button>
+      </div>
+    </div>
+
+    <GameOver :is-visible="gameOver" :winner="winnerResult" :player-score="playerScore" :opponent-score="opponentScore"
+      :player-name="myDisplayName" :opponent-name="opponentDisplayName" :stats="{ playerTricks: 0, opponentTricks: 0 }"
+      :is-logging-out="false" @play-again="handleCloseModal" @close="handleCloseModal" />
+  </div>
+</template>
+
+<script setup>
+import { ref, computed, onMounted, onUnmounted, watch, inject } from 'vue'
+import { useRoute, useRouter, onBeforeRouteLeave } from 'vue-router'
+import { useSocketStore } from '@/stores/socket'
+import { useAuthStore } from '@/stores/auth'
+import { toast } from 'vue-sonner'
+import axios from 'axios'
+import GameBoard from '@/components/game/GameBoard.vue'
+import GameOver from '@/components/game/GameOver.vue'
+
+const route = useRoute()
+const router = useRouter()
+const wsStore = useSocketStore()
+const authStore = useAuthStore()
+const API_BASE_URL = inject('apiBaseURL')
+
+const gameId = ref(route.params.id)
+const visibleHand = ref([])
+const gameOver = ref(false)
+const isDealing = ref(false)
+const hasInitialDealHappened = ref(false)
+const winnerResult = ref('draw')
+const timeLeft = ref(20)
+const timerInterval = ref(null)
+const hasConnectedOnce = ref(false)
+
+// --- STATE ---
+const matchState = computed(() => wsStore.gameState || { id: gameId.value })
+
+const gameMetadata = ref({
+  p1_id: null,
+  p1_name: 'Player 1',
+  p2_id: null,
+  p2_name: 'Opponent'
+})
+
+const displayedTrick = ref({ playerCard: null, opponentCard: null })
+const trickClearTimer = ref(null)
+
+// --- COMPUTED ---
+
+const myUserId = computed(() => authStore.currentUser?.id)
+
+const shouldShowBoard = computed(() => {
+  const s = wsStore.gameState;
+  if (s && s.player2 && s.player2.id > 1) {
+    return true;
+  }
+  return false;
+})
+
+const amIHost = computed(() => {
+  if (gameMetadata.value.p1_id) {
+    return String(gameMetadata.value.p1_id) === String(myUserId.value)
+  }
+  const p1Id = wsStore.gameState?.player1_user_id || wsStore.gameState?.player1?.id
+  return String(p1Id) === String(myUserId.value)
+})
+
+const myDisplayName = computed(() => amIHost.value ? gameMetadata.value.p1_name : gameMetadata.value.p2_name)
+const opponentDisplayName = computed(() => amIHost.value ? gameMetadata.value.p2_name : gameMetadata.value.p1_name)
+
+const mappedTrick = computed(() => {
+  const table = wsStore.gameState?.table
+  if (!table) return { playerCard: null, opponentCard: null }
+  if (amIHost.value) {
+    return { playerCard: table.playerCard, opponentCard: table.opponentCard }
+  } else {
+    return { playerCard: table.opponentCard, opponentCard: table.playerCard }
+  }
+})
+
+const currentTurnLabel = computed(() => {
+  const turnId = wsStore.gameState?.currentTurn
+  if (!turnId) return 'player'
+  return String(turnId) === String(myUserId.value) ? 'player' : 'opponent'
+})
+
+const trumpCard = computed(() => wsStore.gameState?.trumpCard || null)
+const deckCount = computed(() => wsStore.gameState?.deckCount || 0)
+const playerScore = computed(() => wsStore.gameState?.points || 0)
+const opponentScore = computed(() => wsStore.gameState?.opponent?.points || 0)
+const serverHand = computed(() => wsStore.gameState?.hand || [])
+const isMyTurn = computed(() => String(wsStore.gameState?.currentTurn) === String(myUserId.value))
+const opponentHand = computed(() => {
+  const count = wsStore.gameState?.opponent?.cardCount || 0
+  return Array.from({ length: count }, (_, i) => ({ id: `opp-${i}`, suit: 'back', rank: 0 }))
+})
+
+// --- WATCHERS ---
+
+watch(() => wsStore.connected, (isConnected) => {
+  if (isConnected) {
+    hasConnectedOnce.value = true
+    wsStore.joinGame(gameId.value)
+  }
+}, { immediate: true })
+
+watch(() => wsStore.gameState, async (newState, oldState) => {
+  const oldP2 = oldState?.player2?.id;
+  const newP2 = newState?.player2?.id;
+  if (newP2 && newP2 > 1 && newP2 !== oldP2) {
+    await fetchGameMetadata();
+  }
+}, { deep: true })
+
+watch(mappedTrick, (newVal) => {
+  if (newVal.playerCard || newVal.opponentCard) {
+    if (trickClearTimer.value) clearTimeout(trickClearTimer.value)
+    displayedTrick.value = { ...newVal }
+  } else {
+    const currentlyShowing = displayedTrick.value.playerCard || displayedTrick.value.opponentCard
+    if (currentlyShowing) {
+      trickClearTimer.value = setTimeout(() => {
+        displayedTrick.value = { playerCard: null, opponentCard: null }
+      }, 1500)
+    } else {
+      displayedTrick.value = { playerCard: null, opponentCard: null }
+    }
+  }
+}, { deep: true })
+
+// --- FIX: TIMER GHOSTING ---
+const startTimer = () => {
+  if (timerInterval.value) clearInterval(timerInterval.value)
+
+  if (!shouldShowBoard.value && wsStore.gameState?.status !== 'playing') {
+    timeLeft.value = 20;
+    return;
+  }
+
+  // FORCE RESET to avoid showing old time for 1 frame
+  timeLeft.value = 20;
+
+  const startAt = wsStore.gameState?.turnStartedAt ? new Date(wsStore.gameState.turnStartedAt).getTime() : Date.now()
+
+  // Define update function
+  const update = () => {
+    const now = Date.now()
+    const elapsed = Math.floor((now - startAt) / 1000)
+    timeLeft.value = Math.max(0, 20 - elapsed)
+    if (timeLeft.value <= 0) clearInterval(timerInterval.value)
+  }
+
+  // EXECUTE IMMEDIATELY
+  update();
+
+  // Then set interval
+  timerInterval.value = setInterval(update, 1000)
+}
+
+watch(() => wsStore.gameState?.currentTurn, (newTurn) => {
+  if (newTurn) startTimer()
+}, { immediate: true })
+
+const animateDeal = async (cards) => {
+  if (isDealing.value) return
+  isDealing.value = true
+  visibleHand.value = []
+  for (const card of cards) {
+    visibleHand.value.push(card)
+    await new Promise(r => setTimeout(r, 150))
+  }
+  isDealing.value = false
+}
+
+watch(serverHand, (newHand) => {
+  if (visibleHand.value.length === 0 && newHand.length > 0 && !hasInitialDealHappened.value) {
+    animateDeal(newHand)
+    hasInitialDealHappened.value = true
+  } else if (!isDealing.value) {
+    visibleHand.value = [...newHand]
+  }
+}, { deep: true })
+
+// --- METHODS ---
+
+const fetchGameMetadata = async () => {
+  try {
+    const response = await axios.get(`${API_BASE_URL}/games/${gameId.value}`)
+    const game = response.data.data || response.data
+    gameMetadata.value = {
+      p1_id: game.player1_user_id,
+      p1_name: game.player1?.nickname || 'Host',
+      p2_id: game.player2_user_id,
+      p2_name: game.player2?.nickname || 'Opponent'
+    }
+  } catch (e) {
+    console.error("Failed to load metadata", e)
+  }
+}
+
+const handlePlayCard = (card) => {
+  if (!isMyTurn.value || gameOver.value) return
+  visibleHand.value = visibleHand.value.filter(c => c.id !== card.id)
+  wsStore.playCard(gameId.value, card.id)
+}
+
+const handleBeforeUnload = (event) => {
+  if (shouldShowBoard.value && !gameOver.value) {
+    event.preventDefault();
+    event.returnValue = '';
+  }
+};
+
+// --- FIX: SURRENDER LOGIC ---
+const handleSurrender = () => {
+  if (confirm('Are you sure you want to surrender? You will lose.')) {
+    wsStore.surrender(gameId.value)
+  }
+}
+
+const handleCloseModal = async () => {
+  // 1. If game is still in Lobby (Pending) and I am the Host, DELETE it.
+  if (!shouldShowBoard.value && amIHost.value && !gameOver.value) {
+    try {
+      // This calls Route::delete('/{game}', ...) in your api.php
+      await axios.delete(`${API_BASE_URL}/games/${gameId.value}`);
+      console.log("Lobby cancelled and deleted.");
+    } catch (e) {
+      console.error("Failed to delete pending game:", e);
+    }
+  }
+
+  // 2. Notify server of voluntary exit (to skip the 10s reconnect timer)
+  if (wsStore.socket) {
+    wsStore.socket.emit('notify_disconnect');
+  }
+
+  // 3. Disconnect and go home
+  wsStore.disconnect();
+  router.push({ name: 'home' });
+}
+
+// --- LIFECYCLE ---
+
+onBeforeRouteLeave(async (to, from, next) => {
+  // CASE A: Game is Pending (Waiting Room)
+  if (!shouldShowBoard.value && !gameOver.value) {
+    if (amIHost.value) {
+      // Ask for confirmation to close the lobby
+      const confirmClose = window.confirm("This will cancel the lobby. Are you sure?");
+      if (confirmClose) {
+        try {
+          // Delete the game from DB so it doesn't get stuck as "Pending"
+          await axios.delete(`${API_BASE_URL}/games/${gameId.value}`);
+        } catch (e) { console.error(e) }
+
+        if (wsStore.socket) wsStore.socket.emit('notify_disconnect');
+        wsStore.disconnect();
+        next();
+      } else {
+        next(false); // Stay on page
+      }
+      return;
+    } else {
+      // If I am NOT host (just a guest waiting), just leave
+      if (wsStore.socket) wsStore.socket.emit('notify_disconnect');
+      wsStore.disconnect();
+      next();
+      return;
+    }
+  }
+
+  // CASE B: Game is Over (Standard exit)
+  if (gameOver.value) {
+    next();
+    return;
+  }
+
+  // CASE C: Game is Active/Playing (The Surrender Logic we built before)
+  const answer = window.confirm(
+    "If you leave, you will be register has 'losing' or 'surrendered', Are you sure you want to leave?"
+  );
+
+  if (answer) {
+    // ... (Your existing surrender logic) ...
+    try { await wsStore.surrender(gameId.value); } catch (e) { }
+
+    if (wsStore.socket) {
+      wsStore.socket.emit('notify_disconnect', () => {
+        wsStore.disconnect();
+        next();
+      });
+      setTimeout(() => { if (wsStore.connected) { wsStore.disconnect(); next(); } }, 500);
+      return;
+    }
+    wsStore.disconnect();
+    next();
+  } else {
+    next(false);
+  }
+});
+
+onMounted(async () => {
+  await fetchGameMetadata()
+  wsStore.connect()
+
+  wsStore.onTrickEnd((result) => {
+    const winnerName = result.winnerId == authStore.currentUser?.id ? "You" : "Opponent"
+    toast.success(`${winnerName} won the trick!`, { position: 'top-center', duration: 1500 })
+  })
+
+  wsStore.onGameOver((result) => {
+    gameOver.value = true
+    if (result.isDraw) winnerResult.value = 'draw'
+    else winnerResult.value = result.winnerId == authStore.currentUser?.id ? 'player' : 'opponent'
+  })
+})
+
+onUnmounted(() => {
+  window.removeEventListener('beforeunload', handleBeforeUnload)
+
+  if (timerInterval.value) clearInterval(timerInterval.value)
+  wsStore.disconnect()
+})
+</script>

frontend/src/pages/game/MultiplayerMatchPage.vue

@@ -0,0 +1,362 @@
+<script setup>
+import { ref, onMounted, computed, inject, onUnmounted, watch } from 'vue'
+import { useRoute, useRouter, onBeforeRouteLeave } from 'vue-router'
+import { useAuthStore } from '@/stores/auth'
+import { useSocketStore } from '@/stores/socket'
+import { Coins, Trophy, Frown } from 'lucide-vue-next'
+import { Button } from '@/components/ui/button'
+import GameBoard from '@/components/game/GameBoard.vue'
+import axios from 'axios'
+import { toast } from 'vue-sonner'
+
+const API_BASE_URL = inject('apiBaseURL')
+const route = useRoute()
+const router = useRouter()
+const authStore = useAuthStore()
+const wsStore = useSocketStore()
+
+// --- FIX: Flag to prevent double cancellation ---
+const isCancelling = ref(false)
+
+const matchState = ref({
+  id: route.params.id,
+  wager: 0,
+  myMarks: 0,
+  oppMarks: 0,
+  currentGameId: null,
+  player1: null,
+  player2: null,
+  status: 'Pending'
+})
+
+const timeLeft = ref(20)
+const timerInterval = ref(null)
+const showSurrenderModal = ref(false)
+const showTrickResult = ref(false)
+const lastTrickWinner = ref(null)
+const showRoundModal = ref(false)
+const roundData = ref({ winnerId: null, marksAdded: 0, myPoints: 0, oppPoints: 0, reason: '' })
+
+const myUserId = computed(() => authStore.currentUser?.id)
+const amIHost = computed(() => matchState.value.player1?.id === myUserId.value)
+const isPending = computed(() => !matchState.value.player2 || matchState.value.player2.id <= 1)
+const matchOver = computed(() => matchState.value.myMarks >= 4 || matchState.value.oppMarks >= 4)
+const iWonMatch = computed(() => matchState.value.myMarks > matchState.value.oppMarks)
+const isMyTurn = computed(() => String(wsStore.gameState?.currentTurn) === String(myUserId.value))
+const currentTurnLabel = computed(() => isMyTurn.value ? 'player' : 'opponent')
+
+const myDisplayName = computed(() => amIHost.value ? matchState.value.player1?.nickname : matchState.value.player2?.nickname)
+const opponentDisplayName = computed(() => amIHost.value ? matchState.value.player2?.nickname : matchState.value.player1?.nickname)
+
+const opponentHand = computed(() => {
+  const count = wsStore.gameState?.opponent?.cardCount || 0
+  return Array.from({ length: count }, (_, i) => ({ id: `opp-${i}`, suit: 'back', rank: 0 }))
+})
+
+// Timer
+watch(() => wsStore.gameState?.currentTurn, () => { startTimer() }, { deep: true })
+const startTimer = () => {
+    if (timerInterval.value) clearInterval(timerInterval.value);
+    timeLeft.value = 20;
+    if(!wsStore.gameState) return;
+    timerInterval.value = setInterval(() => {
+        if(timeLeft.value > 0) timeLeft.value--;
+        else clearInterval(timerInterval.value);
+    }, 1000);
+}
+
+const handlePlayCard = (card) => {
+  if (wsStore.socket) wsStore.socket.emit('game:play-card', { matchId: matchState.value.id, cardId: card.id })
+}
+
+const openSurrenderModal = () => { showSurrenderModal.value = true }
+const confirmSurrenderRound = () => {
+   showSurrenderModal.value = false;
+   if (wsStore.socket) wsStore.socket.emit('game:surrender', { matchId: matchState.value.id });
+}
+const confirmSurrenderMatch = () => {
+   showSurrenderModal.value = false;
+   if (wsStore.socket) wsStore.socket.emit('match:surrender', { matchId: matchState.value.id });
+}
+const closeRoundModal = () => { showRoundModal.value = false; }
+
+const updateLocalState = (data) => {
+  if (!data) return
+  if (data.player1) matchState.value.player1 = data.player1
+  if (data.player2) matchState.value.player2 = data.player2
+  if (data.stake) matchState.value.wager = data.stake
+  matchState.value.status = data.status
+
+  if (data.marks) {
+    const myId = authStore.currentUser?.id;
+    const oppId = amIHost.value ? matchState.value.player2?.id : matchState.value.player1?.id;
+    matchState.value.myMarks = data.marks[myId] || 0;
+    matchState.value.oppMarks = data.marks[oppId] || 0;
+  }
+
+  if (data.game) {
+    matchState.value.currentGameId = data.game.id;
+    wsStore.gameState = data.game;
+  } else if (data.status === 'Playing') {
+    matchState.value.currentGameId = null;
+    wsStore.gameState = null;
+  }
+}
+
+// --- FIX: Cancel Match with Flag ---
+const cancelMatch = async () => {
+  if (isCancelling.value) return;
+  isCancelling.value = true;
+
+  try {
+    await axios.delete(`${API_BASE_URL}/matches/${matchState.value.id}`)
+    router.push({ name: 'home' })
+  } catch (e) {
+    // Ignore 404s if we just deleted it
+    if (e.response && e.response.status === 404) {
+       router.push({ name: 'home' })
+    } else {
+       isCancelling.value = false; // Reset if legitimate error
+       alert(e.message)
+    }
+  }
+}
+const leaveMatch = () => router.push({ name: 'home' })
+
+const handleBeforeUnload = (e) => {
+  if (matchState.value.status === 'Playing' && !matchOver.value) {
+    const msg = "If you leave now, you will lose the match and your wager.";
+    e.returnValue = msg;
+    return msg;
+  }
+}
+
+// --- FIX: Router Guard checks Flag ---
+onBeforeRouteLeave((to, from, next) => {
+  // If we already clicked cancel, just let it go
+  if (isCancelling.value) {
+    return next();
+  }
+
+  if (matchState.value.status === 'Playing' && !matchOver.value) {
+    if (confirm("⚠️ WARNING: Leaving now triggers an automatic match surrender (Loss).\n\nAre you sure?")) {
+      if(wsStore.socket) wsStore.socket.emit('match:surrender', { matchId: matchState.value.id });
+      next();
+    } else {
+      next(false);
+    }
+  } else if (isPending.value && amIHost.value) {
+     if(confirm("Cancel this lobby?")) {
+        // Mark as cancelling so we don't trigger double requests if cancelMatch is weird
+        isCancelling.value = true;
+        cancelMatch().then(() => next());
+     } else {
+        next(false);
+     }
+  } else {
+    next();
+  }
+})
+
+onMounted(async () => {
+  window.addEventListener('beforeunload', handleBeforeUnload)
+  try {
+    const res = await axios.get(`${API_BASE_URL}/matches/${matchState.value.id}`)
+    const d = res.data.data || res.data
+    matchState.value.player1 = d.player1
+    matchState.value.player2 = d.player2
+    matchState.value.wager = d.stake
+  } catch (e) { }
+
+  wsStore.connect()
+  if (wsStore.socket) {
+    wsStore.socket.emit('match:enter', { matchId: matchState.value.id })
+    wsStore.socket.on('match:update', updateLocalState)
+    wsStore.socket.on('match:new-round', (data) => {
+      updateLocalState(data);
+      toast.info("New round started!");
+    })
+    wsStore.socket.on('match:ended', updateLocalState)
+    wsStore.socket.on('game:update', (state) => { wsStore.gameState = state })
+    wsStore.socket.on('game:trick-end', (result) => {
+        lastTrickWinner.value = result.winnerId;
+        showTrickResult.value = true;
+        setTimeout(() => { showTrickResult.value = false }, 2000);
+    });
+    wsStore.socket.on('match:round-ended', (data) => {
+        const myPoints = data.winnerId == myUserId.value ? (data.winnerId == matchState.value.player1.id ? data.p1Points : data.p2Points) : (data.winnerId == matchState.value.player1.id ? data.p2Points : data.p1Points);
+        const oppPoints = data.winnerId != myUserId.value ? (data.winnerId == matchState.value.player1.id ? data.p1Points : data.p2Points) : (data.winnerId == matchState.value.player1.id ? data.p2Points : data.p1Points);
+
+        roundData.value = {
+            winnerId: data.winnerId,
+            marksAdded: data.marksAdded,
+            myPoints: myPoints,
+            oppPoints: oppPoints,
+            reason: data.reason
+        };
+        showRoundModal.value = true;
+    });
+  }
+})
+
+onUnmounted(() => {
+  window.removeEventListener('beforeunload', handleBeforeUnload)
+  if (wsStore.socket) {
+    wsStore.socket.off('match:update')
+    wsStore.socket.off('match:new-round')
+    wsStore.socket.off('game:trick-end')
+    wsStore.socket.off('match:round-ended')
+  }
+  wsStore.disconnect()
+})
+</script>
+
+<template>
+  <div class="relative min-h-screen bg-green-900 text-white overflow-hidden">
+    <div class="fixed top-0 left-0 right-0 z-40 bg-green-950/90 backdrop-blur border-b border-green-800 p-2 shadow-xl">
+      <div class="max-w-4xl mx-auto flex items-center justify-between">
+        <div class="flex flex-col items-start">
+          <div class="flex items-center gap-2">
+            <span class="font-bold text-lg text-white drop-shadow-md">{{ myDisplayName }}</span>
+            <span v-if="matchState.wager > 0" class="flex items-center text-xs text-yellow-300 bg-yellow-900/50 px-2 rounded border border-yellow-700/50">
+              <Coins class="w-3 h-3 mr-1" /> {{ matchState.wager }}
+            </span>
+          </div>
+          <div class="flex gap-1 mt-1">
+            <div v-for="i in 4" :key="i" class="w-3 h-3 rounded-full border border-green-400 bg-green-900"
+              :class="{ '!bg-green-400 shadow-[0_0_10px_rgba(74,222,128,0.5)]': matchState.myMarks >= i }"></div>
+          </div>
+        </div>
+        <div class="flex flex-col items-center">
+          <span class="text-[10px] uppercase tracking-widest text-green-400 font-bold">Match #{{ matchState.id }}</span>
+          <span class="text-2xl font-black font-mono text-white drop-shadow-md">{{ matchState.myMarks }} - {{ matchState.oppMarks }}</span>
+        </div>
+        <div class="flex flex-col items-end">
+          <span class="font-bold text-lg text-white drop-shadow-md">{{ opponentDisplayName }}</span>
+          <div class="flex gap-1 mt-1">
+            <div v-for="i in 4" :key="i" class="w-3 h-3 rounded-full border border-red-400 bg-green-900"
+              :class="{ '!bg-red-500 shadow-[0_0_10px_rgba(239,68,68,0.5)]': matchState.oppMarks >= i }"></div>
+          </div>
+        </div>
+      </div>
+    </div>
+
+    <div v-if="wsStore.gameState && !matchOver" class="absolute top-24 right-4 z-50">
+      <button @click="openSurrenderModal" 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 hover:scale-105 flex items-center gap-2 text-sm cursor-pointer">
+        <span>🏳️</span> Surrender
+      </button>
+    </div>
+
+    <div v-if="wsStore.gameState && !matchOver && isMyTurn" class="absolute top-24 left-1/2 -translate-x-1/2 z-50">
+      <div class="bg-gray-800 px-6 py-2 rounded-lg border-2 shadow-xl transition-colors duration-300" :class="timeLeft <= 5 ? 'border-red-500 bg-red-900/20' : 'border-gray-700'">
+        <div class="flex items-center gap-3">
+           <svg class="w-5 h-5" :class="timeLeft <= 5 ? 'text-red-500 animate-bounce' : 'text-white'" viewBox="0 0 24 24" fill="none" stroke="currentColor">
+            <circle cx="12" cy="12" r="10" stroke-width="2" />
+            <polyline points="12 6 12 12 16 14" stroke-width="2" />
+          </svg>
+          <span :class="['text-2xl font-mono font-bold', timeLeft <= 5 ? 'text-red-500' : 'text-white']">{{ timeLeft }}</span>
+        </div>
+      </div>
+    </div>
+
+    <div class="pt-20 h-screen">
+      <GameBoard
+        v-if="wsStore.gameState && !matchOver"
+        :game-id="matchState.currentGameId"
+        @play-card="handlePlayCard"
+        :trump-card="wsStore.gameState?.trumpCard"
+        :cards-remaining="wsStore.gameState?.deckCount"
+        :player-hand="wsStore.gameState?.hand"
+        :opponent-hand="opponentHand"
+        :player-score="wsStore.gameState?.points"
+        :opponent-score="wsStore.gameState?.opponent?.points"
+        :current-turn="currentTurnLabel"
+        :current-trick="wsStore.gameState?.table"
+        :is-my-turn="isMyTurn"
+        :player-name="myDisplayName"
+        :opponent-name="opponentDisplayName"
+      />
+      <div v-else-if="isPending" class="flex h-full items-center justify-center flex-col gap-6">
+        <div class="text-center p-8 bg-green-800/60 rounded-2xl border border-green-600 shadow-2xl backdrop-blur-md max-w-sm w-full mx-4">
+          <div class="relative mx-auto mb-6 h-16 w-16">
+             <div class="absolute inset-0 rounded-full border-4 border-green-700/50"></div>
+             <div class="absolute inset-0 rounded-full border-4 border-t-white border-r-transparent border-b-transparent border-l-transparent animate-spin"></div>
+          </div>
+          <h2 class="text-2xl font-bold mb-2 text-white">Waiting for Opponent</h2>
+          <button v-if="amIHost" @click="cancelMatch" class="bg-red-600 hover:bg-red-700 text-white py-2 px-4 rounded shadow mt-4">Cancel Match</button>
+        </div>
+      </div>
+      <div v-else-if="!matchOver && !wsStore.gameState" class="flex h-full items-center justify-center flex-col gap-4">
+        <div class="text-3xl font-bold animate-pulse text-white drop-shadow">Preparing next round...</div>
+      </div>
+      <div v-if="matchOver" class="absolute inset-0 z-50 flex items-center justify-center bg-black/80 backdrop-blur-md">
+        <div class="text-center space-y-6 p-8 bg-green-900 border-2 border-green-500 rounded-2xl shadow-2xl max-w-md w-full">
+          <Trophy v-if="iWonMatch" class="w-24 h-24 text-yellow-400 mx-auto animate-bounce" />
+          <Frown v-else class="w-24 h-24 text-green-300 mx-auto opacity-75" />
+          <h1 class="text-5xl font-black uppercase mb-2" :class="iWonMatch ? 'text-yellow-400' : 'text-gray-300'">{{ iWonMatch ? 'Victory!' : 'Defeat' }}</h1>
+          <p class="text-green-100 text-lg">Marks: <span class="font-bold">{{ matchState.myMarks }} - {{ matchState.oppMarks }}</span></p>
+          <Button @click="leaveMatch" class="w-full py-6 text-lg bg-purple-600 hover:bg-purple-700">Return to Lobby</Button>
+        </div>
+      </div>
+    </div>
+
+    <div v-if="showRoundModal" class="fixed inset-0 z-[100] flex items-center justify-center bg-black/80 backdrop-blur-md">
+      <div class="bg-gray-800 p-8 rounded-2xl border-2 border-yellow-500/50 shadow-2xl max-w-md w-full text-center relative overflow-hidden">
+         <div class="absolute top-0 left-0 w-full h-2 bg-gradient-to-r from-transparent via-yellow-500 to-transparent"></div>
+         <h2 class="text-3xl font-black text-white mb-2 uppercase">Round Over</h2>
+         <p class="text-gray-400 mb-6 uppercase text-xs tracking-widest">{{ roundData.reason === 'surrender' ? 'Opponent Surrendered' : 'Points Limit Reached' }}</p>
+
+         <div class="flex justify-between items-center bg-black/30 p-4 rounded-lg mb-6">
+            <div class="text-left">
+                <p class="text-xs text-gray-500 uppercase">You</p>
+                <p class="text-2xl font-bold text-white">{{ roundData.myPoints }} pts</p>
+            </div>
+            <div class="text-xl font-bold text-yellow-500">VS</div>
+            <div class="text-right">
+                <p class="text-xs text-gray-500 uppercase">Opponent</p>
+                <p class="text-2xl font-bold text-white">{{ roundData.oppPoints }} pts</p>
+            </div>
+         </div>
+
+         <div class="mb-8">
+            <p class="text-lg text-white" v-if="roundData.winnerId == myUserId">
+                You won <span class="text-yellow-400 font-bold">+{{ roundData.marksAdded }} marks</span>!
+            </p>
+            <p class="text-lg text-white" v-else>
+                Opponent won <span class="text-red-400 font-bold">+{{ roundData.marksAdded }} marks</span>.
+            </p>
+         </div>
+
+         <button @click="closeRoundModal" class="w-full py-4 bg-emerald-600 hover:bg-emerald-500 text-white font-bold rounded-xl shadow-lg transition-transform hover:scale-105">
+            Ready for Next Round
+         </button>
+      </div>
+    </div>
+
+    <div v-if="showSurrenderModal" class="fixed inset-0 z-[100] flex items-center justify-center bg-black/70 backdrop-blur-sm">
+      <div class="bg-gray-800 p-6 rounded-lg border border-gray-600 shadow-2xl max-w-sm w-full text-center">
+        <h3 class="text-xl font-bold text-white mb-6">Surrender Options</h3>
+        <div class="space-y-3">
+          <button @click="confirmSurrenderRound" class="w-full px-4 py-3 bg-gray-700 hover:bg-gray-600 rounded text-white font-bold border border-gray-500 flex justify-between items-center group">
+            <span>Surrender Round</span>
+            <span class="text-xs bg-black/40 px-2 py-1 rounded text-gray-300 group-hover:bg-red-500 group-hover:text-white">-2 Marks</span>
+          </button>
+          <button @click="confirmSurrenderMatch" class="w-full px-4 py-3 bg-red-900/50 hover:bg-red-600 rounded text-red-200 hover:text-white font-bold border border-red-800 flex justify-between items-center group">
+            <span>Surrender Match</span>
+            <span class="text-xs bg-black/40 px-2 py-1 rounded text-red-300 group-hover:bg-red-800 group-hover:text-white">Defeat</span>
+          </button>
+        </div>
+        <button @click="showSurrenderModal = false" class="mt-6 text-gray-400 hover:text-white text-sm underline">Cancel</button>
+      </div>
+    </div>
+
+    <Transition enter-active-class="transition-all duration-300 ease-out" enter-from-class="opacity-0 scale-50" enter-to-class="opacity-100 scale-100" leave-active-class="transition-all duration-200 ease-in" leave-from-class="opacity-100 scale-100" leave-to-class="opacity-0 scale-75">
+      <div v-if="showTrickResult" class="fixed top-1/3 left-1/2 -translate-x-1/2 z-[70] pointer-events-none">
+        <div class="bg-black/70 backdrop-blur-md px-8 py-4 rounded-2xl border border-white/10 shadow-2xl text-center">
+           <p class="text-sm uppercase tracking-widest text-gray-300 font-bold mb-1">Trick Winner</p>
+           <h2 class="text-3xl font-black" :class="lastTrickWinner === myUserId ? 'text-green-400' : 'text-red-400'">{{ lastTrickWinner === myUserId ? 'YOU' : 'OPPONENT' }}</h2>
+        </div>
+      </div>
+    </Transition>
+  </div>
+</template>

frontend/src/pages/game/SinglePlayerGamePage.vue

@@ -1,47 +1,33 @@
 <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"
-      >
+      <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"
-      />
+      <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="'player'" :is-my-turn="true" :current-trick="store.table"
+        :player-name="'You'" :opponent-name="'CPU'" @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"
+
+    <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"
-    />
+      :is-logging-out="store.isLoggingOut" @play-again="handlePlayAgain" @close="handleCloseModal" />
   </div>
 </template>
 
 <script setup>
-import { onMounted, onUnmounted, onBeforeMount } from 'vue'
+import { onMounted, onUnmounted, onBeforeMount, watch } from 'vue'
 import { useRouter, onBeforeRouteLeave } from 'vue-router'
 import { toast } from 'vue-sonner' // Import Toast for feedback
 import { useBiscaStore } from '@/stores/bisca'
@@ -60,6 +46,11 @@ const store = useBiscaStore()
 const router = useRouter()
 const authStore = useAuthStore()
 
+// DEBUG: Watch the store state
+watch(() => store.playerHand, (newHand) => {
+  console.log('Player hand updated:', newHand)
+}, { deep: true })
+
 onBeforeMount(() => {
   store.isGameOver = false
 })
@@ -67,6 +58,15 @@ onBeforeMount(() => {
 onMounted(() => {
   store.startGame(props.gameType)
   window.addEventListener('beforeunload', handleBrowserUnload)
+
+  // DEBUG: Log initial state
+  setTimeout(() => {
+    console.log('Game state after init:', {
+      playerHand: store.playerHand,
+      currentTurn: store.currentTurn,
+      isGameRunning: store.isGameRunning
+    })
+  }, 500)
 })
 
 onUnmounted(() => {

frontend/src/pages/home/HomePage.vue

@@ -1,6 +1,11 @@
 <script setup>
-import { ref, onMounted, nextTick } from 'vue'
+import { User, Trophy, Coins } from 'lucide-vue-next'
+import { ref, onMounted, nextTick, inject, computed } from 'vue'
 import { Button } from '@/components/ui/button'
+import { Input } from '@/components/ui/input'
+import { Label } from '@/components/ui/label'
+import { Switch } from '@/components/ui/switch'
+import { watch } from 'vue';
 import {
   Card,
   CardContent,
@@ -10,233 +15,462 @@ import {
 } from '@/components/ui/card'
 import { useAPIStore } from '@/stores/api'
 import { useRouter } from 'vue-router'
+import { useAuthStore } from '@/stores/auth'
+import { useUserStore } from '@/stores/user'
+import axios from 'axios'
+import { toast } from 'vue-sonner'
 
+const API_BASE_URL = inject('apiBaseURL')
 const apiStore = useAPIStore()
 const router = useRouter()
 const openGames = ref([])
 const selectedMode = ref('9')
-const observerTarget = ref(null);
-const observer = ref(null);
-const isLoading = ref(false);
-const pageCounter = ref(1);
+const gObserverTarget = ref(null);
+const gObserver = ref(null);
+const gLoading = ref(false);
+const gPage = ref(1);
+const openMatches = ref([])
+const mObserverTarget = ref(null);
+const mObserver = ref(null);
+const mLoading = ref(false);
+const mPage = 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 isLoggedIn = useAuthStore().isLoggedIn
+const isBestOfThree = ref(false)
+const wagerAmount = ref(0)
+const authStore = useAuthStore()
+const userStore = useUserStore()
+const userLoggedIn = computed(() => authStore.isLoggedIn)
+const userCoins = ref(0)
+const hostLoading = ref(false)
+const gHasMore = ref(true);
+const mHasMore = ref(true);
 
-const setupObserver = () => {
-    if (observer.value) observer.value.disconnect();
+const setupMatchesObserver = () => {
+  if (mObserver.value) mObserver.value.disconnect();
 
-    observer.value = new IntersectionObserver((entries) => {
-        if (entries[0].isIntersecting && !isLoading.value && openGames.value.length > 0) {
+  mObserver.value = new IntersectionObserver((entries) => {
+    if (entries[0].isIntersecting && !mLoading.value && openMatches.value.length > 0) {
+      getPendingMatches();
+    }
+  }, { threshold: 0.1 });
+
+  if (mObserverTarget.value) {
+    mObserver.value.observe(mObserverTarget.value);
+  }
+}
+
+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 (observerTarget.value) {
-        observer.value.observe(observerTarget.value);
+  if (gObserverTarget.value) {
+    gObserver.value.observe(gObserverTarget.value);
   }
 }
 
 const getPendingGames = async (mode = selectedMode.value) => {
-    if (isLoading.value) return;
-    isLoading.value = true;
+  if (gLoading.value || !gHasMore.value) return;
+  gLoading.value = true;
 
-
-    apiStore.gameQueryParameters.page = pageCounter.value++;
-    apiStore.gameQueryParameters.filters.sort_direction = "asc"
-    apiStore.gameQueryParameters.filters.type = mode
-    apiStore.gameQueryParameters.filters.status = 'Pending'
   try {
-        const response = await apiStore.getGames();
+    const response = await axios.get(`${API_BASE_URL}/games/open`, {
+      params: { type: mode, page: gPage.value }
+    });
     const newGames = response.data.data;
+    if (newGames.length === 0) {
+      gHasMore.value = false;
+    } else {
       openGames.value = [...openGames.value, ...newGames];
+      gPage.value++;
+    }
   } finally {
-        isLoading.value = false;
+    gLoading.value = false;
+  }
+}
+
+const getPendingMatches = async (mode = selectedMode.value) => {
+  if (mLoading.value || !mHasMore.value) return;
+  mLoading.value = true;
+
+  try {
+    const response = await axios.get(`${API_BASE_URL}/matches/open`, {
+      params: { type: mode, page: mPage.value }
+    });
+    const newMatches = response.data.data;
+    if (newMatches.length === 0) {
+      mHasMore.value = false;
+    } else {
+      openMatches.value = [...openMatches.value, ...newMatches];
+      mPage.value++;
+    }
+  } finally {
+    mLoading.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;
-    pageCounter.value = 1;
-    await getPendingGames();
-    setupObserver();
+  openGames.value = [];
+  openMatches.value = [];
+  gPage.value = 1;
+  mPage.value = 1;
+  gHasMore.value = true;
+  mHasMore.value = true;
+  await Promise.all([getPendingGames(), getPendingMatches()]);
+  setupGamesObserver();
+  setupMatchesObserver();
 }
 
 const startSingle = () => {
   router.push({ name: 'bisca' + selectedMode.value });
 }
 
-const JoinGameModal = (game) => {
-    selectedGame.value = game
-    isReady.value = false
-    showJoinModal.value = true
+// --- FIX: Correct Wager Logic ---
+const joinMatch = async (match) => {
+  // Use 'stake' because that's what the API returns
+  const cost = match.stake || match.wager || 0;
+
+  if (cost > userCoins.value) {
+    toast.error(`Insufficient funds! You need ${cost} coins.`);
+    return;
+  }
+
+  if (!confirm(`Join match for ${cost} coins?`)) {
+    return;
+  }
+
+  try {
+    await axios.post(`${API_BASE_URL}/matches/${match.id}/join`)
+    router.push({
+      name: 'multiplayer-match',
+      params: { id: match.id },
+      query: { type: selectedMode.value }
+    })
+  } catch (error) {
+    toast.error(error.response?.data?.message || 'Failed to join match');
+  }
 }
 
-const hostGameModal = () => {
-    showHostModal.value = true
+const hostGame = async () => {
+  if (isBestOfThree.value) {
+    if (wagerAmount.value <= 0) {
+      toast.error("Stake must be at least 1 coin.");
+      return;
+    }
+    if (wagerAmount.value > userCoins.value) {
+      toast.error("Insufficient coins!");
+      return;
+    }
+  }
+
+  hostLoading.value = true;
+  const endpoint = isBestOfThree.value ? '/matches/host' : '/games/host'
+  const payload = isBestOfThree.value
+    ? { type: parseInt(selectedMode.value), stake: parseInt(wagerAmount.value) }
+    : { type: parseInt(selectedMode.value) }
+
+  try {
+    const response = await axios.post(`${API_BASE_URL}${endpoint}`, payload)
+    const resultId = response.data.match?.id || response.data.id || response.data.data?.id;
+
+    if (!resultId) throw new Error("Missing ID");
+
+    showHostModal.value = false;
+    router.push({
+      name: isBestOfThree.value ? 'multiplayer-match' : 'multiplayer-game',
+      params: { id: resultId },
+      query: { type: selectedMode.value }
+    })
+  } catch (error) {
+    if (error.response?.data?.message) {
+      toast.error(error.response.data.message);
+    } else {
+      toast.error('Failed to host game');
+    }
+  } finally {
+    hostLoading.value = false;
+  }
 }
 
-const toggleReady = () => {
-    isReady.value = !isReady.value
+const joinGame = async (game) => {
+  try {
+    await axios.post(`${API_BASE_URL}/games/${game.id}/join`)
+    router.push({
+      name: 'multiplayer-game',
+      params: { id: game.id },
+      query: { type: selectedMode.value }
+    })
+  } catch (error) {
+    toast.error(error.response?.data?.message || 'Failed to join game');
+  }
 }
 
+const openHostModal = (forMatch) => {
+  isBestOfThree.value = forMatch;
+  showHostModal.value = true;
+  wagerAmount.value = 0;
+}
+
+watch(() => userLoggedIn, async (isLoggedIn) => {
+  if (isLoggedIn) {
+    await userStore.fetchCoins()
+    userCoins.value = userStore.coins
+  } else {
+    userStore.coins = 0
+  }
+}, { immediate: true })
+
 onMounted(async () => {
-    await getPendingGames();
+  await fetchPublicStats();
+  if (isLoggedIn) {
+    await Promise.all([getPendingGames(), getPendingMatches()]);
     await nextTick();
-    setupObserver();
+    setupGamesObserver();
+    setupMatchesObserver();
+  }
 })
 </script>
 
 <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 pb-10 px-4">
 
-        <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'
-                        }">
+            :class="{ 'w-2/3 z-10 text-purple-600 bg-purple-500/10': selectedMode === '9', 'w-1/3 z-0 text-muted-foreground/40': 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'
-                        }">
+            :class="{ 'w-2/3 z-10 text-purple-600 bg-purple-500/10': selectedMode === '3', 'w-1/3 z-0 text-muted-foreground/40': 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>
+            <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">
+              <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">
+
+        <Card class="w-full max-w-2xl flex flex-col">
           <CardHeader>
-                        <CardTitle class="text-3xl font-bold text-center">
-                            MultiPlayer
-                        </CardTitle>
-                        <CardDescription class="text-center">
-                            Go one on one with another player!
-                        </CardDescription>
+            <CardTitle class="text-3xl font-bold text-center">Multi Player</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>
+          <CardContent class="flex-1 flex flex-col space-y-6">
+
+            <div class="flex flex-col flex-1">
+              <div class="flex justify-between items-end mb-2">
+                <label class="text-sm font-bold uppercase tracking-wider text-muted-foreground">Open Matches (Best of 3)</label>
+                <Button v-if="isLoggedIn" @click="openHostModal(true)" size="sm" variant="outline" class="border-purple-500 text-purple-500 hover:bg-purple-500 hover:text-white font-bold">
+                  Host
+                </Button>
+              </div>
               <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 v-if="openMatches.length === 0" class="p-6 text-center text-sm text-muted-foreground">
+                  No open matches.
                 </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 v-for="(match, index) in openMatches" :key="match.id" @click="joinMatch(match)"
+                    class="flex items-center justify-between p-3 mb-2 border border-transparent rounded-lg cursor-pointer 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">
+                      <div class="flex h-8 w-8 items-center justify-center rounded-full text-xs font-bold bg-red-100 text-red-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 class="font-medium text-sm flex items-center gap-2">
+                          Match #{{ match.id }}
+                          <span class="flex items-center text-xs bg-yellow-100 text-yellow-700 px-2 py-0.5 rounded-full">
+                            <Coins class="w-3 h-3 mr-1" /> {{ match.stake || match.wager }}
+                          </span>
+                        </div>
+                        <div class="text-[10px] text-muted-foreground">Host: {{ match.player1?.nickname || 'Unknown' }}</div>
+                      </div>
+                    </div>
+                  </div>
+                  <div ref="mObserverTarget" class="h-10 flex items-center justify-center">
+                    <span v-if="mLoading" class="text-xs text-purple-500 animate-pulse">Loading...</span>
+                  </div>
                 </div>
               </div>
             </div>
 
-                                <div ref="observerTarget" class="h-10 flex items-center justify-center">
-                                    <span v-if="isLoading" class="text-xs text-purple-500 animate-pulse">Loading
-                                        more...</span>
-                                </div>
-                            </div>
-                        </div>
-                        <div class="flex justify-center">
-                            <Button @click="hostGameModal()" size="lg" variant="secondary"
-                                class="hover:bg-purple-500 hover:text-slate-200">
-                                Host Game
+            <div class="flex flex-col flex-1">
+              <div class="flex justify-between items-end mb-2">
+                <label class="text-sm font-medium uppercase tracking-wider text-muted-foreground">Open Games (Single)</label>
+                <Button v-if="isLoggedIn" @click="openHostModal(false)" size="sm" variant="outline" class="border-purple-500 text-purple-500 hover:bg-purple-500 hover:text-white font-bold">
+                  Host
                 </Button>
               </div>
+              <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.
+                </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="joinGame(game)"
+                    class="flex items-center justify-between p-3 mb-2 border border-transparent rounded-lg cursor-pointer 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">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...</span>
+                  </div>
+                </div>
+              </div>
+            </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">
+
+    <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">
+        <CardHeader><CardTitle class="text-center">{{ isBestOfThree ? 'Host Match (Best of 3)' : 'Host Game' }}</CardTitle></CardHeader>
+        <CardContent class="flex flex-col gap-6 py-4">
+          <div v-if="isBestOfThree" class="space-y-2">
+            <Label>Wager (Coins)</Label>
             <div class="relative">
-                        <div
-                            class="h-16 w-16 animate-spin rounded-full border-4 border-purple-500 border-t-transparent">
+              <Coins class="absolute left-3 top-2.5 h-4 w-4 text-yellow-500" />
+              <Input v-model="wagerAmount" type="number" min="0" class="pl-9" />
             </div>
+            <p class="text-xs text-muted-foreground text-right">Balance: {{ userCoins }}</p>
           </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' }}
+          <div class="flex gap-2">
+            <Button variant="outline" class="flex-1" @click="showHostModal = false" :disabled="hostLoading">Cancel</Button>
+            <Button class="flex-1 bg-purple-600 hover:bg-purple-700" @click="hostGame" :disabled="hostLoading">
+              {{ hostLoading ? 'Creating...' : 'Create' }}
             </Button>
           </div>
         </CardContent>
       </Card>
     </div>
+
     </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>

frontend/src/pages/purchase/CoinPurchasePage.vue

@@ -0,0 +1,139 @@
+<template>
+    <div class="flex min-h-screen items-center justify-center px-4 py-12 sm:px-6 lg:px-8">
+        <div class="w-full max-w-md space-y-8">
+            <div>
+                <h2 class="mt-6 text-center text-3xl font-bold tracking-tight text-gray-900">Buy Coins</h2>
+                <p class="mt-2 text-center text-sm text-gray-600">€1.00 = 10 Coins</p>
+            </div>
+
+            <form class="mt-8 space-y-4" @submit.prevent="handleSubmit">
+                <div>
+                    <label class="block text-sm font-medium text-gray-700 mb-1">Amount (Euros)</label>
+                    <Input v-model.number="formData.euros" type="number" min="1" max="100" placeholder="Ex: 10"
+                        required />
+                    <p class="mt-1 text-xs text-blue-600 font-medium">
+                        You will receive: {{ formData.euros * 10 }} coins
+                    </p>
+                </div>
+
+                <div>
+                    <label class="block text-sm font-medium text-gray-700 mb-1">Payment Method</label>
+                    <select v-model="formData.payment_type"
+                        class="flex h-10 w-full rounded-md border border-input bg-background px-3 py-2 text-sm ring-offset-background focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2">
+                        <option value="MBWAY">MB WAY</option>
+                        <option value="MB">Multibanco (MB)</option>
+                        <option value="VISA">VISA</option>
+                        <option value="PAYPAL">PayPal</option>
+                    </select>
+                </div>
+
+                <div>
+                    <label class="block text-sm font-medium text-gray-700 mb-1">
+                        {{ referenceLabel }}
+                    </label>
+                    <Input v-model="formData.payment_reference" type="text" :placeholder="referencePlaceholder"
+                        required />
+                    <p v-if="errors.payment_reference" class="mt-1 text-xs text-red-500">
+                        {{ errors.payment_reference }}
+                    </p>
+                </div>
+
+                <div class="pt-4">
+                    <Button type="submit" class="w-full">
+                        Confirm Purchase (€{{ formData.euros }})
+                    </Button>
+                </div>
+            </form>
+        </div>
+    </div>
+</template>
+
+<script setup>
+import { ref, computed } from 'vue'
+import { Input } from '@/components/ui/input'
+import { Button } from '@/components/ui/button'
+import { usePurchaseStore } from '@/stores/purchase'
+import { useRouter } from 'vue-router'
+import { toast } from 'vue-sonner'
+import { useUserStore } from '@/stores/user'
+
+const purchaseStore = usePurchaseStore()
+const router = useRouter()
+
+const formData = ref({
+    euros: 1,
+    payment_type: 'MBWAY',
+    payment_reference: ''
+})
+
+const errors = ref({})
+
+const referenceLabel = computed(() => {
+    const labels = {
+        MBWAY: 'Phone Number',
+        MB: 'Entity-Reference',
+        VISA: 'Card Number',
+        PAYPAL: 'PayPal Email'
+    }
+    return labels[formData.value.payment_type]
+})
+
+const referencePlaceholder = computed(() => {
+    const placeholders = {
+        MBWAY: '912345678',
+        MB: '12345-123456789',
+        VISA: '1234 5678 9012 3456',
+        PAYPAL: '[email protected]'
+    }
+    return placeholders[formData.value.payment_type]
+})
+
+const validateForm = () => {
+    errors.value = {}
+    const type = formData.value.payment_type
+    const refValue = formData.value.payment_reference
+
+    const patterns = {
+        MBWAY: /^9[0-9]{8}$/,
+        MB: /^[0-9]{5}-[0-9]{9}$/,
+        VISA: /^4[0-9]{15}$/,
+        PAYPAL: /^[^\s@]+@[^\s@]+\.[^\s@]+$/
+    }
+
+    if (!patterns[type].test(refValue)) {
+        errors.value.payment_reference = `Invalid format for ${type}`
+        return false
+    }
+
+    if (formData.value.euros < 1 || formData.value.euros > 100) {
+        toast.error("Amount must be between 1 and 100")
+        return false
+    }
+
+    return true
+}
+
+const userStore = useUserStore()
+
+const handleSubmit = async () => {
+    if (!validateForm()) return
+
+    const promise = purchaseStore.purchase(formData.value)
+
+    toast.promise(promise, {
+        loading: 'Processing transaction...',
+        success: (res) => {
+            userStore.fetchCoins()
+            router.push('/')
+            return `Purchase successful! New balance: ${res.data.balance} coins`
+        },
+        error: (error) => {
+            if (error.response?.status === 422) {
+                errors.value = error.response.data.errors
+                return "Please check the highlighted fields"
+            }
+            return error.response?.data?.message || "Transaction failed"
+        }
+    })
+}
+</script>

frontend/src/pages/register/RegisterPage.vue

@@ -0,0 +1,151 @@
+<template>
+    <div class="flex min-h-screen items-center justify-center px-4 py-12 sm:px-6 lg:px-8">
+        <div class="w-full max-w-md space-y-8">
+            <div>
+                <h2 class="mt-6 text-center text-3xl font-bold tracking-tight text-gray-900">Sign up</h2>
+                <p class="mt-2 text-center text-sm text-gray-600">Enter your data to create your account</p>
+            </div>
+
+            <form class="mt-8 space-y-4" @submit.prevent="handleSubmit">
+                <div class="flex flex-col items-center justify-center space-y-2">
+                    <label for="avatar-upload"
+                        class="group relative flex h-24 w-24 cursor-pointer items-center justify-center overflow-hidden rounded-full border-2 border-dashed border-gray-300 bg-gray-50 transition hover:border-blue-400 hover:bg-gray-100">
+                        <img v-if="imagePreview" :src="imagePreview" class="h-full w-full object-cover" />
+
+                        <div v-else class="flex flex-col items-center text-gray-400">
+                            <svg xmlns="http://www.w3.org/2000/svg" class="h-8 w-8" fill="none" viewBox="0 0 24 24"
+                                stroke="currentColor">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
+                                    d="M12 4v16m8-8H4" />
+                            </svg>
+                            <span class="text-[10px] font-medium">UPLOAD</span>
+                        </div>
+
+                        <div
+                            class="absolute inset-0 flex items-center justify-center bg-black/20 opacity-0 transition group-hover:opacity-100">
+                            <span class="text-xs font-semibold text-white">Change</span>
+                        </div>
+                    </label>
+
+                    <input id="avatar-upload" type="file" class="hidden" accept="image/*" @change="handleFileChange" />
+                    <p class="text-xs text-gray-500">Optional</p>
+                </div>
+
+                <div>
+                    <label class="block text-sm font-medium text-gray-700 mb-1">Full Name</label>
+                    <Input v-model="formData.name" type="text" placeholder="John Doe" required />
+                </div>
+
+                <div>
+                    <label class="block text-sm font-medium text-gray-700 mb-1">Nickname</label>
+                    <Input v-model="formData.nickname" type="text" placeholder="johny123" required />
+                </div>
+
+                <div>
+                    <label class="block text-sm font-medium text-gray-700 mb-1">Email address</label>
+                    <Input v-model="formData.email" type="email" placeholder="[email protected]" />
+                    <p v-if="errors.email" class="mt-1 text-xs text-red-500">{{ errors.email }}</p>
+                </div>
+
+                <div>
+                    <label class="block text-sm font-medium text-gray-700 mb-1">Password</label>
+                    <Input v-model="formData.password" type="password" placeholder="••••••••" />
+                    <p v-if="errors.password" class="mt-1 text-xs text-red-500">{{ errors.password }}</p>
+                </div>
+
+                <div>
+                    <label class="block text-sm font-medium text-gray-700 mb-1">Confirm Password</label>
+                    <Input v-model="formData.confirmPassword" type="password" placeholder="••••••••" />
+                    <p v-if="errors.confirmPassword" class="mt-1 text-xs text-red-500">{{ errors.confirmPassword }}</p>
+                </div>
+
+                <div class="pt-4">
+                    <Button type="submit" class="w-full">Create Account</Button>
+                </div>
+            </form>
+        </div>
+    </div>
+</template>
+
+<script setup>
+import { ref } from 'vue'
+import { Input } from '@/components/ui/input'
+import { Button } from '@/components/ui/button'
+import { useRegisterStore } from '@/stores/register'
+import { useRouter } from 'vue-router'
+import { toast } from 'vue-sonner'
+
+const registerStore = useRegisterStore()
+const router = useRouter()
+
+const formData = ref({
+    email: '',
+    nickname: '',
+    name: '',
+    password: '',
+    confirmPassword: '',
+    photo: ''
+})
+
+const imagePreview = ref(null)
+const errors = ref({})
+
+const handleFileChange = (event) => {
+    const file = event.target.files[0]
+    if (file) {
+        formData.value.photo = file
+
+        imagePreview.value = URL.createObjectURL(file)
+    }
+    console.log(formData, file)
+}
+
+const validateForm = () => {
+    errors.value = {} // Reset errors
+    let isValid = true
+
+    if (!formData.value.email.match(/^(([^<>()[\]\\.,;:\s@\"]+(\.[^<>()[\]\\.,;:\s@\"]+)*)|(\".+\"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/)) {
+        errors.value.email = "Please enter a valid email"
+        isValid = false
+    }
+
+    if (!formData.value.password || formData.value.password.length < 3) {
+        errors.value.password = "Password must be at least 3 characters"
+        isValid = false
+    }
+
+    if (formData.value.password !== formData.value.confirmPassword) {
+        errors.value.confirmPassword = "Passwords do not match"
+        isValid = false
+    }
+
+    return isValid
+}
+
+const handleSubmit = async () => {
+    if (!validateForm()) {
+        toast.error("Please fix the errors in the form")
+        return
+    }
+
+    const data = new FormData()
+    data.append('email', formData.value.email)
+    data.append('nickname', formData.value.nickname)
+    data.append('name', formData.value.name)
+    data.append('password', formData.value.password)
+
+    if (formData.value.photo) {
+        data.append('photo_avatar_filename', formData.value.photo)
+    }
+
+    const promise = registerStore.register(data)
+    toast.promise(promise, {
+        loading: 'Creating your account...',
+        success: (res) => {
+            router.push('/login')
+            return `Registration Successful - ${res.data.user.name}`
+        },
+        error: (error) => error.response?.data?.message || "Registration failed"
+    })
+}
+</script>

frontend/src/router/index.js

@@ -1,15 +1,14 @@
 import HomePage from '@/pages/home/HomePage.vue'
 import LoginPage from '@/pages/login/LoginPage.vue'
-import LaravelPage from '@/pages/testing/LaravelPage.vue'
-import WebsocketsPage from '@/pages/testing/WebsocketsPage.vue'
-import TestAnimations from '@/pages/TestAnimations.vue'
-import TestDealing from '@/pages/TestDealing.vue'
-import TestAllAnimations from '@/pages/TestAllAnimations.vue'
-import TestGameBoard from '@/pages/TestGameBoard.vue'
 import UserPage from '@/pages/user/UserPage.vue'
-import SinglePlayerGamePage from '@/pages/game/SinglePlayerGamePage.vue'
 import { createRouter, createWebHistory } from 'vue-router'
-import { toast } from 'vue-sonner'
+import SinglePlayerGamePage from '@/pages/game/SinglePlayerGamePage.vue'
+import MultiplayerGamePage from '@/pages/game/MultiplayerGamePage.vue'
+import MultiplayerMatchPage from '@/pages/game/MultiplayerMatchPage.vue'
+import RegisterPage from '@/pages/register/RegisterPage.vue'
+import CoinsPurchasePage from '@/pages/purchase/CoinPurchasePage.vue'
+import { useAuthStore } from '@/stores/auth'
+import AdminPage from '@/pages/admin/AdminPage.vue'
 
 const router = createRouter({
   history: createWebHistory(import.meta.env.BASE_URL),
@@ -18,18 +17,24 @@ const router = createRouter({
       path: '/',
       name: 'home',
       component: HomePage,
+      meta: { requiresAdmin: false },
     },
     {
       path: '/login',
       name: 'login',
       component: LoginPage,
     },
+    {
+      path: '/register',
+      name: 'register',
+      component: RegisterPage,
+    },
     {
       path: '/game/3',
       name: 'bisca3',
       component: SinglePlayerGamePage,
       props: { gameType: 3 },
-      meta: { requiresAuth: true },
+      meta: { requiresAuth: true, requiresAdmin: false },
     },
     {
       path: '/game/9',
@@ -39,57 +44,39 @@ const router = createRouter({
       meta: { requiresAuth: true },
     },
     {
-      path: '/game/3',
-      name: 'bisca3',
-      component: SinglePlayerGamePage,
-      props: { gameType: 3 },
+      path: '/game/multiplayer/:id',
+      name: 'multiplayer-game',
+      component: MultiplayerGamePage,
       meta: { requiresAuth: true },
     },
     {
-      path: '/game/9',
-      name: 'bisca9',
-      component: SinglePlayerGamePage,
-      props: { gameType: 9 },
-      meta: { requiresAuth: true },
+      path: '/match/:id',
+      name: 'multiplayer-match',
+      component: MultiplayerMatchPage,
+      meta: { requiresAuth: true }
     },
     {
       path: '/user',
       component: UserPage,
+      meta: { requiresAuth: true },
     },
     {
-      path: '/testing',
-      children: [
-        {
-          path: 'laravel',
-          component: LaravelPage,
+      path: '/coins-purchase',
+      component: CoinsPurchasePage,
+      meta: { requiresAuth: true },
     },
     {
-          path: 'websockets',
-          component: WebsocketsPage,
-        },
-        {
-          path: 'animations',
-          component: TestAnimations,
-        },
-        {
-          path: 'dealing',
-          component: TestDealing,
-        },
-        {
-          path: 'all-animations',
-          component: TestAllAnimations,
-        },
-        {
-          path: 'gameboard',
-          component: TestGameBoard,
-        },
-      ],
+      path: '/admin',
+      name: 'admin',
+      component: AdminPage,
+      meta: { requiresAuth: true, requiresAdmin: true },
     },
   ],
 })
 
 router.beforeEach((to, from, next) => {
   const requiresAuth = to.matched.some((record) => record.meta.requiresAuth)
+  const requiresAdmin = to.matched.some((record) => record.meta.requiresAdmin)
 
   if (requiresAuth) {
     const token = localStorage.getItem('token')
@@ -98,6 +85,10 @@ router.beforeEach((to, from, next) => {
       return next({ name: 'login' })
     }
   }
+
+  if (useAuthStore().isAdmin && to.name === 'home') return next({ name: 'admin' })
+  if (requiresAdmin && !useAuthStore().isAdmin) return next({ name: 'home' })
+
   next()
 })
 

frontend/src/stores/api.js

@@ -53,12 +53,10 @@ export const useAPIStore = defineStore('api', () => {
     delete axios.defaults.headers.common['Authorization']
   }
 
-  // Users
   const getAuthUser = () => {
     return axios.get(`${API_BASE_URL}/users/me`)
   }
 
-  //Games
   const getGames = (resetPagination = false) => {
     if (resetPagination) {
       gameQueryParameters.value.page = 1
@@ -78,11 +76,143 @@ export const useAPIStore = defineStore('api', () => {
     return axios.get(`${API_BASE_URL}/games?${queryParams}`)
   }
 
+  // --- ADICIONADO: Função que faltava ---
+  const getCurrentUserGames = (params = {}) => {
+    const queryParams = new URLSearchParams({
+      page: params.page || 1,
+      ...(params.type && { type: params.type }),
+      ...(params.outcome && { outcome: params.outcome }),
+      ...(params.status && { status: params.status }),
+      ...(params.date_from && { date_from: params.date_from }),
+      ...(params.date_to && { date_to: params.date_to }),
+      sort_by: params.sort_by || 'began_at',
+      sort_direction: params.sort_direction || 'desc',
+    }).toString()
+
+    return axios.get(`${API_BASE_URL}/users/${authStore.currentUserID}/games?${queryParams}`)
+  }
+  // --------------------------------------
+
+  const getCurrentUserMatches = (params = {}) => {
+    const queryParams = new URLSearchParams({
+      page: params.page || 1,
+      ...(params.type && { type: params.type }),
+      ...(params.outcome && { outcome: params.outcome }),
+      ...(params.status && { status: params.status }),
+      ...(params.date_from && { date_from: params.date_from }),
+      ...(params.date_to && { date_to: params.date_to }),
+      sort_by: params.sort_by || 'began_at',
+      sort_direction: params.sort_direction || 'desc',
+    }).toString()
+
+    return axios.get(`${API_BASE_URL}/users/${authStore.currentUserID}/matches?${queryParams}`)
+  }
+
+  const getCurrentUserTransactions = (params = {}) => {
+    const queryParams = new URLSearchParams({
+      page: params.page || 1,
+      ...(params.type && { type: params.type }),
+      ...(params.blocked && { blocked: params.blocked }),
+    }).toString()
+
+    return axios.get(`${API_BASE_URL}/users/${authStore.currentUserID}/transactions?${queryParams}`)
+  }
+
+  const getLeaderboard = (params = {}) => {
+    const queryParams = new URLSearchParams({
+      page: params.page || 1,
+    }).toString()
+
+    return axios.get(`${API_BASE_URL}/leaderboard?${queryParams}`)
+  }
+
+  const getCurrentUserStats = () => {
+    return axios.get(`${API_BASE_URL}/statistics/me`)
+  }
+
+  const getPublicStats = () => {
+    return axios.get(`${API_BASE_URL}/statistics/public`)
+  }
+
+  const getAdminStats = () => {
+    return axios.get(`${API_BASE_URL}/admin/statistics`)
+  }
+
+  const getAdminUsers = (params) => {
+    const queryParams = new URLSearchParams({
+      page: params.page || 1,
+      ...(params.type && { type: params.type }),
+      ...(params.blocked && { blocked: params.blocked }),
+    }).toString()
+    return axios.get(`${API_BASE_URL}/admin/users?${queryParams}`)
+  }
+
+  const blockUser = (user) => {
+    return axios.post(`${API_BASE_URL}/admin/users/${user.id}/block`)
+  }
+
+  const unblockUser = (user) => {
+    return axios.post(`${API_BASE_URL}/admin/users/${user.id}/unblock`)
+  }
+
+  const deleteUser = (user) => {
+    return axios.delete(`${API_BASE_URL}/admin/users/${user.id}`)
+  }
+
+  const getAdminTransactions = (params) => {
+    const queryParams = new URLSearchParams({
+      page: params.page || 1,
+      ...(params.sort_datetime == 'asc' && { sort_datetime: 'asc' }),
+      ...(params.sort_coins && { sort_coins: params.sort_coins }),
+    }).toString()
+    return axios.get(`${API_BASE_URL}/admin/transactions?${queryParams}`)
+  }
+
+  const getAdminGames = (params) => {
+    const queryParams = new URLSearchParams({
+      page: params.page || 1,
+      ...(params.sort_direction == 'asc' && { sort_direction: 'asc' }),
+      ...(params.type && { type: params.type }),
+    }).toString()
+
+    return axios.get(`${API_BASE_URL}/games?${queryParams}`)
+  }
+
+  const getAdminMatches = (params = {}) => {
+    const queryParams = new URLSearchParams({
+      page: params.page || 1,
+      ...(params.sort_direction == 'asc' && { sort_direction: 'asc' }),
+      ...(params.type && { type: params.type }),
+      ...(params.pot && { pot: params.pot }),
+    }).toString()
+
+    return axios.get(`${API_BASE_URL}/matches?${queryParams}`)
+  }
+
+  const postAdmin = async (credentials) => {
+    return axios.post(`${API_BASE_URL}/admin/users`, credentials)
+  }
+
   return {
     postLogin,
     postLogout,
     getAuthUser,
     getGames,
+    getCurrentUserGames,
+    getCurrentUserMatches,
+    getCurrentUserTransactions,
+    getCurrentUserStats,
+    getLeaderboard,
+    getPublicStats,
+    getAdminStats,
+    getAdminUsers,
+    blockUser,
+    unblockUser,
+    deleteUser,
+    getAdminTransactions,
+    getAdminGames,
+    getAdminMatches,
+    postAdmin,
     gameQueryParameters,
   }
 })

frontend/src/stores/auth.js

@@ -4,11 +4,9 @@ import { useAPIStore } from './api'
 
 export const useAuthStore = defineStore('auth', () => {
 
-  const DEFAULT_TIMEOUT = 5 * 60 * 1000
+  const DEFAULT_TIMEOUT = 30 * 60 * 1000
   const REMEMBER_ME_TIMEOUT = 365 * 24 * 60 * 60 * 1000
 
-
-
   const currentUser = ref(undefined)
   const token = ref(localStorage.getItem('token') || null)
   const tokenExpiry = ref(localStorage.getItem('tokenExpiry') ? parseInt(localStorage.getItem('tokenExpiry')) : null)
@@ -22,6 +20,10 @@ export const useAuthStore = defineStore('auth', () => {
     return currentUser.value?.id
   })
 
+  const isAdmin = computed(() => {
+    return currentUser.value?.type === 'A'
+  })
+
   const isTokenAlmostExpired = () => {
     if (!tokenExpiry.value) return false;
     return Date.now() > (tokenExpiry.value - 60 * 1000);
@@ -54,10 +56,14 @@ export const useAuthStore = defineStore('auth', () => {
   const login = async (credentials) => {
     const apiStore = useAPIStore()
     const loginResp = await apiStore.postLogin(credentials)
-    const userResp = await apiStore.getAuthUser()
+    return await setLocalStorageUser(apiStore, loginResp, true)
+  }
 
-    const jwtToken = loginResp.data.token
-    setToken(jwtToken, credentials.rememberMe)
+  const setLocalStorageUser = async (api, response, rememberMe) => {
+    const userResp = await api.getAuthUser()
+
+    const jwtToken = response.data.token
+    setToken(jwtToken, rememberMe)
     currentUser.value = userResp.data
 
     localStorage.setItem('currentUser', JSON.stringify(userResp.data))
@@ -72,15 +78,8 @@ export const useAuthStore = defineStore('auth', () => {
     localStorage.removeItem('currentUser')
   }
 
-  const checkTokenExpiry = () => {
-    if (isTokenAlmostExpired()) {
-      logout()
-      return false
-    }
-    return true
-  }
-
   const restoreSession = async () => {
+    const apiStore = useAPIStore()
     const storedToken = localStorage.getItem('token')
     const storedUser = localStorage.getItem('currentUser')
     const storedTokenExpiry = localStorage.getItem('tokenExpiry')
@@ -102,7 +101,6 @@ export const useAuthStore = defineStore('auth', () => {
       try {
         currentUser.value = JSON.parse(storedUser)
       } catch (e) {
-        // If stored user data is corrupted, fetch fresh data from API
         try {
           const userResp = await apiStore.getAuthUser()
           currentUser.value = userResp.data
@@ -118,19 +116,24 @@ export const useAuthStore = defineStore('auth', () => {
     return true
   }
 
+  const updateCurrentUserCoins = (coins) => {
+    if (!currentUser.value) return;
+    currentUser.value.coins_balance = coins
+  }
+
   return {
     currentUser,
     isLoggedIn,
     currentUserID,
+    isAdmin,
     token,
     rememberMe,
-    setToken,
     getToken,
     login,
     logout,
     resetTokenExpiry,
     isTokenAlmostExpired,
-    checkTokenExpiry,
     restoreSession,
+    updateCurrentUserCoins,
   }
 })

frontend/src/stores/purchase.js

@@ -0,0 +1,16 @@
+import axios from 'axios'
+import { defineStore } from 'pinia'
+import { inject } from 'vue'
+
+export const usePurchaseStore = defineStore('purchase', () => {
+
+    const API_BASE_URL = inject('apiBaseURL')
+
+    const purchase = async (data) => {
+        return await axios.post(`${API_BASE_URL}/coin-purchases`, data)
+    }
+
+    return {
+        purchase,
+    }
+})

frontend/src/stores/register.js

@@ -0,0 +1,16 @@
+import axios from 'axios'
+import { defineStore } from 'pinia'
+import { inject } from 'vue'
+
+export const useRegisterStore = defineStore('register', () => {
+
+    const API_BASE_URL = inject('apiBaseURL')
+
+    const register = async (data) => {
+        return await axios.post(`${API_BASE_URL}/register`, data)
+    }
+
+    return {
+        register,
+    }
+})

frontend/src/stores/socket.js

@@ -1,24 +1,129 @@
 import { defineStore } from 'pinia'
-import { inject } from 'vue'
+import { ref } from 'vue'
+import { io } from 'socket.io-client'
+import { useAuthStore } from './auth'
 
-export const useSocketStore = defineStore('socket', () => {
-  const socket = inject('socket')
+export const useSocketStore = defineStore('websocket', () => {
+  const authStore = useAuthStore()
 
-  const handleConnection = () => {
-    try {
-      socket.on('connect', () => {
-        console.log(`[Socket] Connected -- ${socket.id}`)
+  const socket = ref(null)
+  const connected = ref(false)
+  const gameState = ref(null)
+  const lastError = ref(null)
+  const currentGameId = ref(null)
+
+  const WS_URL = 'http://localhost:3000'
+
+  const connect = () => {
+    if (socket.value?.connected) return
+
+    const token = authStore.getToken()
+    if (!token) {
+      console.error('No token available for WebSocket connection')
+      return
+    }
+
+    socket.value = io(WS_URL, {
+      auth: { token: `Bearer ${token}` },
+      reconnection: true,
+      reconnectionAttempts: 5,
+      reconnectionDelay: 1000
     })
-      socket.on('disconnect', () => {
-        console.log(`[Socket] Disconnected -- ${socket.id}`)
+
+    socket.value.on('connect', () => {
+      if (currentGameId.value) {
+        console.log("Reconnected to socket. Rejoining game...");
+        socket.emit("join-game", { gameId: currentGameId.value });
+      }
+
+      connected.value = true
+      console.log('[WebSocket] Connected:', socket.value.id)
     })
-    } catch (error) {
-      console.error('[Socket] Connection error:', error)
+
+    socket.value.on('disconnect', (reason) => {
+      connected.value = false
+      console.log('[WebSocket] Disconnected:', reason)
+    })
+
+    socket.value.on('connect_error', (error) => {
+      console.error('[WebSocket] Connection error:', error.message)
+      lastError.value = error.message
+    })
+
+    socket.value.on('heartbeat', () => {
+      socket.value.emit('heartbeat_ack')
+    })
+
+    socket.value.on('game-state', (state) => {
+      gameState.value = state
+    })
+
+    socket.value.on('game-error', (data) => {
+      lastError.value = data.message
+      console.error('[Game] Error:', data.message)
+    })
+
+    socket.value.on('error', (data) => {
+      lastError.value = data.message
+      console.error('[Socket] Error:', data.message)
+    })
+  }
+
+  const disconnect = () => {
+    if (socket.value) {
+      socket.value.disconnect()
+      socket.value = null
+      connected.value = false
+      gameState.value = null
+      lastError.value = null
+      currentGameId.value = null
+    }
+  }
+
+  const joinGame = (gameId) => {
+    currentGameId.value = gameId
+    if (!socket.value?.connected) return
+    console.log('[Game] Joining game:', gameId)
+    socket.value.emit('join-game', { gameId })
+  }
+
+  const playCard = (gameId, cardId) => {
+    if (!socket.value?.connected) return
+    socket.value.emit('play-card', { gameId, cardId })
+  }
+
+  const surrender = (gameId) => {
+    if (!socket.value?.connected) return
+    console.log('[Game] Surrendering:', gameId)
+    socket.value.emit('surrender', { gameId })
+  }
+
+  const onTrickEnd = (callback) => {
+    if (socket.value) {
+      socket.value.off('trick-end')
+      socket.value.on('trick-end', callback)
+    }
+  }
+
+  const onGameOver = (callback) => {
+    if (socket.value) {
+      socket.value.off('game-over')
+      socket.value.on('game-over', callback)
     }
   }
 
   return {
-    handleConnection,
+    socket,
+    connected,
+    gameState,
+    lastError,
+    currentGameId,
+    connect,
+    disconnect,
+    joinGame,
+    playCard,
+    surrender, // Exported
+    onTrickEnd,
+    onGameOver
   }
-
 })

frontend/src/stores/user.js

@@ -1,58 +1,26 @@
 import { defineStore } from 'pinia'
 import axios from 'axios'
+import { inject, ref } from 'vue'
 import { useAuthStore } from './auth'
 
-export const useUserStore = defineStore('user', {
-  state: () => ({
-    user: null,
-    loading: false,
-    error: null
-  }),
-
-  getters: {
-    currentUser: (state) => state.user
-  },
-
-  actions: {
-    async fetchUserProfile() {
-      const authStore = useAuthStore()
-      const token = authStore.getToken()
-
-      if (!token) {
-        this.error = 'No authentication token found'
-        throw new Error('No authentication token found')
-      }
-
-      this.loading = true
-      this.error = null
+export const useUserStore = defineStore('user', () => {
+  const API_BASE_URL = inject('apiBaseURL')
+  const coins = ref(0)
 
+  const fetchCoins = async () => {
     try {
-        const response = await axios.get('/api/users/me', {
-          headers: {
-            Authorization: `Bearer ${token}`,
-            Accept: 'application/json'
-          }
-        })
-
-        this.user = response.data
-        return response.data
+      const response = await axios.get(`${API_BASE_URL}/users/me/coins`)
+      coins.value = response.data?.coins || 0
+      useAuthStore().updateCurrentUserCoins(coins.value)
+      return response
     } catch (error) {
-        this.error = error.response?.data?.message || 'Failed to fetch user profile'
-
-        if (error.response?.status === 401) {
-          authStore.logout()
-        }
-
+      console.error('Error fetching coins', error)
       throw error
-      } finally {
-        this.loading = false
     }
-    },
+  }
 
-    clearUser() {
-      this.user = null
-      this.error = null
-      this.loading = false
-    }
+  return {
+    coins,
+    fetchCoins,
   }
 })

package-lock.json

@@ -0,0 +1,6 @@
+{
+  "name": "DADProject",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {}
+}

websockets/classes/BiscaGame.js

@@ -1,11 +1,16 @@
 class BiscaGame {
-  constructor(id, type, player1, player2) {
+  constructor(id, type, player1, player2, dbId = null, onGameEnd = null) {
     this.id = id;
+    this.dbId = dbId;
     this.type = type;
+    this.onGameEnd = onGameEnd;
 
     this.deck = [];
     this.trumpCard = null;
     this.trumpSuit = null;
+    this.timer = null;
+    this.turnDeadline = null;
+    this.timeoutCallback = null;
 
     this.table = {
       playerCard: null,
@@ -43,13 +48,56 @@ class BiscaGame {
 
     this.dealInitialCards();
 
-    const playerIds = Object.keys(this.players);
-    this.currentTurn = playerIds.find((id) => id != 1) || playerIds[0];
+    // --- FIX: Ensure currentTurn uses the original ID type (Number) ---
+    // Object.keys returns strings ("1"), which breaks strict checks against user.id (1)
+    const playerKeys = Object.keys(this.players);
+    const startKey = playerKeys.find((key) => key != 1) || playerKeys[0];
+    this.currentTurn = this.players[startKey].id; 
 
     this.startTime = Date.now();
     this.status = "playing";
   }
 
+  startTurnTimer(callback) {
+    if (this.timer) clearTimeout(this.timer);
+
+    this.timeoutCallback = callback;
+    const DURATION_MS = 20000;
+    this.turnDeadline = Date.now() + DURATION_MS;
+
+    console.log(`[Game ${this.id}] Timer started for User ${this.currentTurn}`);
+
+    this.timer = setTimeout(() => {
+      this.handleTimeout();
+    }, DURATION_MS);
+  }
+
+  stopTimer() {
+    if (this.timer) clearTimeout(this.timer);
+    this.timer = null;
+    this.turnDeadline = null;
+  }
+
+  handleTimeout() {
+    console.log(
+      `[Game ${this.id}] Timeout! Auto-playing for ${this.currentTurn}`
+    );
+
+    const lowestCard = this.getLowestCard(this.currentTurn);
+
+    if (lowestCard && this.timeoutCallback) {
+      this.timeoutCallback(this.currentTurn, lowestCard.id);
+    }
+  }
+
+  getLowestCard(userId) {
+    const hand = this.players[userId].hand;
+    if (!hand || hand.length === 0) return null;
+
+    const sortedHand = [...hand].sort((a, b) => a.strength - b.strength);
+    return sortedHand[0];
+  }
+
   createDeck() {
     const suits = ["c", "e", "o", "p"];
     const ranks = [1, 2, 3, 4, 5, 6, 7, 11, 12, 13];
@@ -105,6 +153,8 @@ class BiscaGame {
       }
     }
 
+    this.stopTimer();
+
     player.hand.splice(cardIndex, 1);
 
     if (!this.table.playerCard) {
@@ -142,7 +192,8 @@ class BiscaGame {
     this.players[winnerId].tricks += 1;
     this.currentTurn = winnerId;
 
-    if (this.type == 3) {
+    // --- FIX: Always draw if deck has cards (Removed type check) ---
+    if (this.deck.length > 0 || this.trumpCard) {
       this.drawCard(winnerId);
       this.drawCard(this.getOpponentId(winnerId));
     }
@@ -152,6 +203,7 @@ class BiscaGame {
 
     if (this.players[winnerId].hand.length === 0) {
       this.status = "finished";
+      this.stopTimer();
 
       const pIds = Object.keys(this.players);
       const p1Obj = this.players[pIds[0]];
@@ -173,7 +225,7 @@ class BiscaGame {
         ? p2Obj.id
         : p1Obj.id;
 
-      return {
+      const result = {
         action: "game_ended",
         trickResult,
         winnerId: finalWinner,
@@ -185,6 +237,11 @@ class BiscaGame {
         player2_points: p2Obj.points,
         totalTime: totalTime,
       };
+      
+      if (this.onGameEnd) {
+        this.onGameEnd(result);
+      }
+      return result;
     }
 
     return { action: "trick_resolved", trickResult };
@@ -194,6 +251,7 @@ class BiscaGame {
     const oppId = this.getOpponentId(userId);
     return {
       id: this.id,
+      dbId: this.dbId,
       trumpCard: this.trumpCard,
       trumpSuit: this.trumpSuit,
       deckCount: this.deck.length + (this.trumpCard ? 1 : 0),
@@ -205,6 +263,7 @@ class BiscaGame {
         points: this.players[oppId].points,
         cardCount: this.players[oppId].hand.length,
       },
+      turnDeadline: this.turnDeadline,
     };
   }
 
@@ -232,4 +291,4 @@ class BiscaGame {
   }
 }
 
-module.exports = BiscaGame;
+export default BiscaGame;

websockets/classes/BiscaMatch.js

@@ -0,0 +1,239 @@
+import BiscaGame from "../classes/BiscaGame.js";
+import axios from "axios";
+
+const API_URL = "http://localhost:8000/api/v1";
+
+class BiscaMatch {
+  // FIX: Added autoPlayCallback parameter
+  constructor(apiData, emitStateCallback, token, autoPlayCallback) {
+    this.id = apiData.id;
+    this.emitStateCallback = emitStateCallback;
+    this.autoPlayCallback = autoPlayCallback; 
+    this.token = token;
+    this.stake = apiData.stake;
+    this.type = apiData.type;
+    this.status = apiData.status;
+
+    this.player1Id = apiData.player1_user_id;
+    this.player2Id = apiData.player2_user_id;
+    this.player1 = apiData.player1;
+    this.player2 = apiData.player2;
+
+    this.marks = {
+      [this.player1Id]: apiData.player1_marks || 0,
+      [this.player2Id]: apiData.player2_marks || 0,
+    };
+
+    this.points = {
+      [this.player1Id]: apiData.player1_points || 0,
+      [this.player2Id]: apiData.player2_points || 0,
+    };
+
+    this.currentGame = null;
+    this.GHOST_ID = 1;
+
+    if (this.status === "Playing" && this.player2Id !== this.GHOST_ID) {
+      this.startNewGame();
+    }
+  }
+
+  async joinPlayer(userId, user) {
+    if (this.player2Id !== this.GHOST_ID) return false;
+    if (userId === this.player1Id) return false;
+
+    this.player2Id = userId;
+    this.player2 = user;
+    this.marks[userId] = 0;
+    this.points[userId] = 0;
+    this.status = "Playing";
+
+    await this.startNewGame();
+    return true;
+  }
+
+  getAuthHeaders() {
+    return {
+      headers: { 
+          Authorization: this.token,
+          "Content-Type": "application/json",
+          "Accept": "application/json"
+      },
+    };
+  }
+
+  async startNewGame() {
+    console.log(`[Match ${this.id}] Starting new round...`);
+    let newGameDbId = null;
+    try {
+      const payload = {
+        type: this.type,
+        player1_user_id: this.player1Id,
+        player2_user_id: this.player2Id,
+        match_id: this.id,
+        status: "Playing",
+        began_at: new Date().toISOString(),
+      };
+      
+      const res = await axios.post(`${API_URL}/games`, payload, this.getAuthHeaders());
+      const gameData = res.data.game || res.data.data || res.data;
+      newGameDbId = gameData.id;
+
+      const p1Name = this.player1?.nickname || `User ${this.player1Id}`;
+      const p2Name = this.player2?.nickname || `User ${this.player2Id}`;
+
+      this.currentGame = new BiscaGame(
+        this.id,
+        this.type,
+        { id: this.player1Id, name: p1Name },
+        { id: this.player2Id, name: p2Name },
+        newGameDbId,
+        (result) => { this.handleGameEnd(result); }
+      );
+
+      this.currentGame.init();
+      
+      // FIX: Start Timer & Connect Callback
+      this.currentGame.startTurnTimer((uid, cid) => {
+          if (this.autoPlayCallback) this.autoPlayCallback(uid, cid);
+      });
+
+      if (this.emitStateCallback) {
+        this.emitStateCallback("match:new-round-start", null); 
+      }
+    } catch (e) {
+      console.error(`❌ Start Game Error: ${e.message}`);
+    }
+  }
+
+  // --- FIX: Close DB Game row on surrender ---
+  async abortCurrentGame(loserId) {
+      if (this.currentGame && this.currentGame.dbId) {
+          console.log(`[Match ${this.id}] Aborting Game #${this.currentGame.dbId}`);
+          try {
+              // Determine winner for the DB record based on who DIDN'T lose
+              const winnerId = loserId == this.player1Id ? this.player2Id : this.player1Id;
+              
+              const payload = {
+                  status: "Ended",
+                  winner_user_id: winnerId,
+                  loser_user_id: loserId,
+                  is_draw: false,
+                  ended_at: new Date().toISOString(),
+              };
+              await axios.put(`${API_URL}/games/${this.currentGame.dbId}`, payload, this.getAuthHeaders());
+          } catch(e) { console.error("Error aborting game:", e.message); }
+      }
+  }
+
+  async handleGameEnd(result) {
+    console.log(`[Match ${this.id}] Round ended. Winner: ${result.winnerId}`);
+
+    if (this.points[result.player1_id] !== undefined) this.points[result.player1_id] += result.player1_points;
+    if (this.points[result.player2_id] !== undefined) this.points[result.player2_id] += result.player2_points;
+
+    if (this.currentGame && this.currentGame.dbId) {
+        try {
+            const payload = {
+                status: "Ended",
+                winner_user_id: result.winnerId,
+                loser_user_id: result.loserId,
+                is_draw: result.isDraw,
+                player1_points: result.player1_points,
+                player2_points: result.player2_points,
+                ended_at: new Date().toISOString(),
+            };
+            await axios.put(`${API_URL}/games/${this.currentGame.dbId}`, payload, this.getAuthHeaders());
+        } catch (e) { console.error("DB Game Update Error:", e.message); }
+    }
+
+    let marksToAdd = 0;
+    let roundWinnerId = result.winnerId;
+
+    if (roundWinnerId) {
+      const winningScore = roundWinnerId == result.player1_id ? result.player1_points : result.player2_points;
+      if (winningScore === 120) marksToAdd = 4;
+      else if (winningScore > 90) marksToAdd = 2;
+      else if (winningScore >= 60) marksToAdd = 1;
+      
+      if (this.marks[roundWinnerId] !== undefined) this.marks[roundWinnerId] += marksToAdd;
+    }
+
+    if (this.emitStateCallback) {
+        this.emitStateCallback("match:round-ended", {
+            winnerId: roundWinnerId,
+            marksAdded: marksToAdd,
+            p1Points: result.player1_points,
+            p2Points: result.player2_points,
+            p1Marks: this.marks[this.player1Id],
+            p2Marks: this.marks[this.player2Id],
+            reason: result.reason || 'points'
+        });
+    }
+
+    if (this.marks[this.player1Id] >= 4 || this.marks[this.player2Id] >= 4) {
+      await this.finishMatch();
+      if (this.emitStateCallback) this.emitStateCallback("match:ended-signal", null);
+    } else {
+      setTimeout(() => {
+          this.startNewGame();
+      }, 1000);
+    }
+  }
+
+  async finishMatch() {
+    this.status = "Ended";
+    const winnerId = this.marks[this.player1Id] >= 4 ? this.player1Id : this.player2Id;
+    const loserId = winnerId == this.player1Id ? this.player2Id : this.player1Id;
+
+    const payload = {
+      status: "Ended",
+      winner_user_id: winnerId,
+      loser_user_id: loserId,
+      player1_marks: this.marks[this.player1Id],
+      player2_marks: this.marks[this.player2Id],
+      player1_points: this.points[this.player1Id],
+      player2_points: this.points[this.player2Id],
+    };
+
+    try {
+      await axios.put(`${API_URL}/matches/${this.id}`, payload, this.getAuthHeaders());
+      console.log(`[Match ${this.id}] Match Closed in DB.`);
+    } catch (e) {
+      console.error(`Match Close Error: ${e.message}`);
+    }
+  }
+
+  playCard(userId, cardId) {
+    if (!this.currentGame || this.status !== "Playing") return;
+    
+    const result = this.currentGame.playCard(userId, cardId);
+    
+    // FIX: Restart timer if game continues
+    if (result && (result.action === 'next_turn' || result.action === 'trick_resolved')) {
+         this.currentGame.startTurnTimer((uid, cid) => {
+             if (this.autoPlayCallback) this.autoPlayCallback(uid, cid);
+         });
+    }
+    
+    return result;
+  }
+
+  getGameState(userId) {
+    if (!this.currentGame) return null;
+    if (this.currentGame.players[userId]) return this.currentGame.getStateForPlayer(userId);
+    return null;
+  }
+
+  getPublicState() {
+    return {
+      matchId: this.id,
+      status: this.status,
+      marks: this.marks,
+      points: this.points,
+      player1: this.player1,
+      player2: this.player2
+    };
+  }
+}
+
+export default BiscaMatch;

websockets/events/connection.js

@@ -1,4 +1,4 @@
-import { addUser, removeUser } from "../state/connection";
+import { addUser, removeUser } from "../state/connection.js";
 
 const HEARTBEAT_INTERVAL = 30000; // 30 seconds
 const HEARTBEAT_TIMEOUT = 10000; // 10 seconds
@@ -27,20 +27,17 @@ export const handleConnectionEvents = (io, socket) => {
   socket.on("join", (user) => {
     addUser(socket, user);
     console.log(`[Connection] User ${user.name} has joined the server`);
-    console.log(`[Connection] ${getUserCount()} users online`);
   });
 
   socket.on("leave", () => {
     const user = removeUser(socket.id);
     if (user) {
       console.log(`[Connection] User ${user.name} has left the server`);
-      console.log(`[Connection] ${getUserCount()} users online`);
     }
   });
 
   socket.on("disconnect", () => {
     console.log("Connection Lost:", socket.id);
     removeUser(socket.id);
-    console.log(`[Connection] ${getUserCount()} users online`);
   });
 };

websockets/events/game.js

@@ -4,6 +4,71 @@ import { getUser } from "../state/connection.js";
 
 const API_URL = "http://localhost:8000/api/v1";
 
+// --- HELPER: Card Strength for Auto-Play ---
+const getStrength = (rank) => {
+    const strengthMap = { 1: 10, 7: 9, 13: 8, 11: 7, 12: 6, 6: 5, 5: 4, 4: 3, 3: 2, 2: 1 };
+    return strengthMap[rank] || 0;
+};
+
+// --- HELPER: Draw Card Logic ---
+const drawCard = (game, playerId) => {
+    const player = game.players[playerId];
+    if (!player) return;
+
+    if (game.deck && game.deck.length > 0) {
+        const card = game.deck.pop();
+        player.hand.push(card);
+    } else if (game.trumpCard) {
+        player.hand.push(game.trumpCard);
+        game.trumpCard = null;
+    }
+};
+
+// --- HELPER: Sanitize Data ---
+const sanitizeState = (state, game) => {
+    if (!state) return null;
+    const p1 = game.player1 || state.player1 || {};
+    const p2 = game.player2 || state.player2 || {};
+
+    return {
+        id: state.id,
+        status: state.status || game.status,
+        player1: { id: p1.id, name: p1.name },
+        player2: { id: p2.id, name: p2.name },
+        players: state.players, 
+        hand: state.hand,
+        points: state.points,
+        opponent: {
+            id: state.opponent?.id,
+            name: state.opponent?.name,
+            points: state.opponent?.points,
+            cardCount: state.opponent?.cardCount
+        },
+        table: state.table,
+        trumpCard: state.trumpCard,
+        deckCount: game.deck ? game.deck.length : (state.deckCount || 0),
+        currentTurn: state.currentTurn,
+        turnStartedAt: state.turnStartedAt
+    };
+};
+
+const broadcastState = (io, gameId, game) => {
+    const roomName = `game_${gameId}`;
+    const socketsInRoom = io.sockets.adapter.rooms.get(roomName);
+    
+    if (socketsInRoom) {
+      for (const socketId of socketsInRoom) {
+        const s = io.sockets.sockets.get(socketId);
+        const u = getUser(socketId);
+        if (u && game.players[u.id]) {
+          const rawState = game.getStateForPlayer(u.id);
+          const cleanState = sanitizeState(rawState, game);
+          s.emit("game-state", cleanState);
+        }
+      }
+    }
+}
+
 async function saveGameResult(gameId, result, token) {
   try {
     const payload = {
@@ -13,21 +78,109 @@ async function saveGameResult(gameId, result, token) {
       player1_points: result.player1_points,
       player2_points: result.player2_points,
     };
-
     if (!result.isDraw && result.winnerId) {
       payload.winner_user_id = result.winnerId;
       payload.loser_user_id = result.loserId;
     }
-
     await axios.put(`${API_URL}/games/${gameId}`, payload, {
       headers: { Authorization: token },
     });
-    console.log(`[DB] Game ${gameId} saved.`);
   } catch (error) {
     console.error(`[DB Error] Game ${gameId}:`, error.message);
   }
 }
 
+// --- SHARED END GAME LOGIC ---
+const performGameEnd = (io, game, gameId, winnerId, loserId, reason) => {
+    const result = {
+        action: "game_ended",
+        winnerId: parseInt(winnerId),
+        loserId: parseInt(loserId),
+        totalTime: game.startTime ? Math.floor((Date.now() - game.startTime) / 1000) : 0,
+        isDraw: false,
+        player1_points: game.players[Object.keys(game.players)[0]]?.points || 0,
+        player2_points: game.players[Object.keys(game.players)[1]]?.points || 0,
+        reason: reason
+    };
+
+    game.status = "ended";
+    if (game.timer) clearInterval(game.timer);
+
+    io.to(`game_${gameId}`).emit("game-over", {
+        winnerId: result.winnerId,
+        isDraw: result.isDraw,
+        p1Points: result.player1_points,
+        p2Points: result.player2_points,
+        message: reason === "surrender" ? "Opponent Surrendered!" : "Game Over"
+    });
+
+    const anyId = Object.keys(game.players)[0];
+    const token = game.players[anyId]?.token;
+    if (token) saveGameResult(gameId, result, token);
+}
+
+const handleTimeout = (io, gameId, userId) => {
+  const game = getGame(gameId);
+  if (!game || game.status === 'ended') return;
+
+  console.log(`[Timeout] User ${userId} auto-playing lowest card.`);
+  
+  const player = game.players[userId];
+  if (!player || !player.hand || player.hand.length === 0) return;
+
+  const trumpSuit = game.trumpCard?.suit || '';
+  
+  const sortedHand = [...player.hand].sort((a, b) => {
+      const strengthA = getStrength(a.rank) + (a.suit === trumpSuit ? 100 : 0);
+      const strengthB = getStrength(b.rank) + (b.suit === trumpSuit ? 100 : 0);
+      return strengthA - strengthB;
+  });
+
+  const cardToPlay = sortedHand[0];
+  if (cardToPlay) {
+      handleGameMove(io, gameId, userId, cardToPlay.id);
+  }
+};
+
+const handleGameMove = (io, gameId, userId, cardId) => {
+  const game = getGame(gameId);
+  if (!game) return;
+
+  const result = game.playCard(userId, cardId);
+  const roomName = `game_${gameId}`;
+  
+  broadcastState(io, gameId, game);
+
+  if (result.action === "trick_resolved") {
+    io.to(roomName).emit("trick-end", result.trickResult);
+    
+    setTimeout(() => {
+        if (game.status !== "ended") {
+            const canDraw = (game.deck && game.deck.length > 0) || game.trumpCard !== null;
+
+            if (canDraw) {
+                const winnerId = result.trickResult.winnerId;
+                const loserId = Object.keys(game.players).find(id => String(id) !== String(winnerId));
+
+                if (winnerId) drawCard(game, winnerId);
+                if (loserId) drawCard(game, loserId);
+            }
+            broadcastState(io, gameId, game);
+        }
+    }, 1500); 
+  }
+
+  if (result.action === "game_ended") {
+      performGameEnd(io, game, gameId, result.winnerId, result.loserId, "points");
+  }
+
+  if (result.action === "next_turn" || result.action === "trick_resolved") {
+    game.startTurnTimer((timeoutUserId) => {
+      handleTimeout(io, gameId, timeoutUserId);
+    });
+  }
+};
+
 export default (io, socket) => {
   socket.on("join-game", async ({ gameId }) => {
     const user = getUser(socket.id);
@@ -37,110 +190,93 @@ export default (io, socket) => {
     }
 
     let game = getGame(gameId);
+    let gameData = null;
 
-    if (!game) {
     try {
         const token = socket.handshake.auth.token;
         const response = await axios.get(`${API_URL}/games/${gameId}`, {
           headers: { Authorization: token },
         });
+        gameData = response.data.data || response.data;
+    } catch (e) { console.error("DB Sync Failed"); }
 
-        const gameData = response.data.data || response.data;
-
-        if (gameData.status === "Ended") {
-          socket.emit("error", { message: "Game already finished." });
-          return;
-        }
-
-        if (
-          gameData.player1_user_id != user.id &&
-          gameData.player2_user_id != user.id &&
-          gameData.player2_user_id !== 1
-        ) {
-          socket.emit("error", { message: "You are not in this game." });
-          return;
-        }
-
-        const p1Name = gameData.player1?.name || "Player 1";
-        const p2Name = gameData.player2?.name || "Player 2";
+    if (!game && gameData) {
+        const p1Name = gameData.player1?.nickname || "Player 1";
+        const p2Name = gameData.player2?.nickname || "Player 2";
         const type = gameData.type == "9" ? 9 : 3;
-
         game = createGame(
           gameId,
           type,
           { id: gameData.player1_user_id, name: p1Name },
           { id: gameData.player2_user_id, name: p2Name }
         );
-      } catch (error) {
-        socket.emit("error", { message: "Failed to join game." });
+        game.status = gameData.status === 'Playing' ? 'playing' : 'pending';
+    }
+
+    if (!game) {
+        socket.emit("error", { message: "Game not found." });
         return;
     }
+
+    const myId = user.id;
+    const ghostKey = Object.keys(game.players).find(key => key == 1);
+    const amIDbPlayer2 = gameData && gameData.player2_user_id == myId;
+
+    if (!game.players[myId] && (ghostKey || amIDbPlayer2)) {
+        let ghostHand = []; 
+        let ghostPoints = 0; 
+        let ghostTricks = 0;
+        if (ghostKey && game.players[ghostKey]) {
+            ghostHand = game.players[ghostKey].hand || [];
+            ghostPoints = game.players[ghostKey].points || 0;
+            ghostTricks = game.players[ghostKey].tricks || 0;
+            delete game.players[ghostKey];
         }
 
-    const GHOST_ID = 1;
-
-    if (game && game.players) {
-      if (!game.players[user.id]) {
-        if (game.players[GHOST_ID]) {
-          delete game.players[GHOST_ID];
-          game.players[user.id] = {
-            id: user.id,
-            name: user.name,
-            hand: [],
-            points: 0,
-            tricks: 0,
+        game.players[myId] = {
+            id: myId,
+            name: user.nickname,
+            hand: ghostHand,
+            points: ghostPoints,
+            tricks: ghostTricks,
+            token: socket.handshake.auth.token,
         };
-        }
+        game.player2 = { id: myId, name: user.nickname };
+        game.status = 'playing';
+        if(!game.timer) {
+            game.startTurnTimer((timeoutUserId) => handleTimeout(io, gameId, timeoutUserId));
         }
     }
 
     socket.join(`game_${gameId}`);
+    socket.activeGameId = gameId;
 
-    if (game && game.players[user.id]) {
-      socket.emit("game-state", game.getStateForPlayer(user.id));
-      console.log(`--> Estado enviado para User ${user.id}`);
-    } else {
-      socket.emit("error", { message: "Error joining game state." });
+    if (game.players[myId]) {
+        game.players[myId].token = socket.handshake.auth.token;
+        
+        const rawState = game.getStateForPlayer(myId);
+        const cleanState = sanitizeState(rawState, game);
+        
+        socket.emit("game-state", cleanState);
+        broadcastState(io, gameId, game);
     }
   });
 
   socket.on("play-card", ({ gameId, cardId }) => {
+    const user = getUser(socket.id);
+    if (user) handleGameMove(io, gameId, user.id, cardId);
+  });
+
+  // --- NEW: SURRENDER HANDLER ---
+  socket.on("surrender", ({ gameId }) => {
       const user = getUser(socket.id);
       const game = getGame(gameId);
       
-    if (!game || !user) return;
+      if (!game || !user || !game.players[user.id]) return;
 
-    const result = game.playCard(user.id, cardId);
+      console.log(`[Game] User ${user.nickname} surrendered.`);
       
-    if (result.error) {
-      socket.emit("game-error", { message: result.error });
-      return;
-    }
-
-    const roomName = `game_${gameId}`;
-    const socketsInRoom = io.sockets.adapter.rooms.get(roomName);
-    if (socketsInRoom) {
-      for (const socketId of socketsInRoom) {
-        const s = io.sockets.sockets.get(socketId);
-        const u = getUser(socketId);
-        if (u && game.players[u.id]) {
-          s.emit("game-state", game.getStateForPlayer(u.id));
-        }
-      }
-    }
-
-    if (result.action === "trick_resolved") {
-      io.to(roomName).emit("trick-end", result.trickResult);
-    }
-
-    if (result.action === "game_ended") {
-      io.to(roomName).emit("game-over", {
-        winnerId: result.winnerId,
-        isDraw: result.isDraw,
-        p1Points: result.player1_points,
-        p2Points: result.player2_points,
-      });
-      saveGameResult(gameId, result, socket.handshake.auth.token);
-    }
+      const winnerId = Object.keys(game.players).find(id => String(id) !== String(user.id));
+      performGameEnd(io, game, gameId, winnerId, user.id, "surrender");
   });
 };

websockets/events/match.js

@@ -0,0 +1,158 @@
+import { getMatch, addMatch } from "../state/match.js";
+import BiscaMatch from "../classes/BiscaMatch.js";
+import axios from "axios";
+
+const API_URL = "http://localhost:8000/api/v1";
+
+export default (io, socket) => {
+    
+    const broadcastMatchUpdate = (matchId, match) => {
+        const roomName = `match_${matchId}`;
+        const room = io.sockets.adapter.rooms.get(roomName);
+        if (room) {
+            for (const socketId of room) {
+                const clientSocket = io.sockets.sockets.get(socketId);
+                if (!clientSocket || !clientSocket.user) continue;
+                const userId = clientSocket.user.id;
+                const publicState = match.getPublicState();
+                const gameState = match.getGameState(userId);
+                clientSocket.emit("match:update", { ...publicState, game: gameState });
+            }
+        }
+    };
+
+    const createMatchEmitter = (matchId) => (eventName, payload) => {
+        const match = getMatch(matchId);
+        if (!match) return;
+
+        if (eventName === 'match:new-round-start' || eventName === 'match:ended-signal') {
+            broadcastMatchUpdate(matchId, match);
+        } else if (eventName === 'match:round-ended') {
+            io.to(`match_${matchId}`).emit('match:round-ended', payload);
+        } else {
+            io.to(`match_${matchId}`).emit(eventName, payload);
+        }
+    };
+
+    // --- FIX: Timer Callback ---
+    const handleAutoPlay = (matchId) => (userId, cardId) => {
+        const match = getMatch(matchId);
+        if (!match || match.status !== "Playing") return;
+
+        console.log(`[Match ${matchId}] Auto-playing for User ${userId}`);
+        const result = match.playCard(userId, cardId);
+
+        if (result && result.action === "trick_resolved") {
+             io.to(`match_${matchId}`).emit("game:trick-end", result.trickResult);
+             setTimeout(() => { broadcastMatchUpdate(matchId, match); }, 1500);
+        } else {
+            broadcastMatchUpdate(matchId, match);
+        }
+    };
+
+    socket.on("match:enter", async (data) => {
+        const { matchId } = data;
+        if (!socket.user || !socket.user.id) return socket.emit("error", { message: "Auth failed" });
+        const userId = socket.user.id;
+        socket.activeMatchId = matchId; 
+
+        const room = `match_${matchId}`;
+        let match = getMatch(matchId);
+
+        if (!match) {
+            try {
+                const res = await axios.get(`${API_URL}/matches/${matchId}`, {
+                    headers: { Authorization: socket.token || socket.handshake.auth.token },
+                });
+                const matchData = res.data.data || res.data;
+                
+                // Pass handleAutoPlay to constructor
+                match = new BiscaMatch(
+                    matchData, 
+                    createMatchEmitter(matchId), 
+                    socket.token,
+                    handleAutoPlay(matchId) 
+                );
+                addMatch(match);
+            } catch (e) {
+                return socket.emit("error", "Match not found");
+            }
+        }
+        match.emitStateCallback = createMatchEmitter(matchId);
+        if (userId !== match.player1Id && match.player2Id === 1) await match.joinPlayer(userId, socket.user);
+
+        socket.join(room);
+        const publicState = match.getPublicState();
+        const gameState = match.getGameState(userId);
+        socket.emit("match:update", { ...publicState, game: gameState });
+        if (match.status === 'Playing') broadcastMatchUpdate(matchId, match);
+    });
+
+    socket.on("game:play-card", (data) => {
+        const { matchId, cardId } = data;
+        const match = getMatch(matchId);
+        if (!match || match.status !== "Playing") return;
+        const result = match.playCard(socket.user.id, cardId);
+        if (result && result.error) return socket.emit("error", { message: result.error });
+        if (result && result.action === "trick_resolved") {
+             io.to(`match_${matchId}`).emit("game:trick-end", result.trickResult);
+             setTimeout(() => { broadcastMatchUpdate(matchId, match); }, 1500);
+        } else {
+            broadcastMatchUpdate(matchId, match);
+        }
+    });
+
+    socket.on("game:surrender", async ({ matchId }) => {
+        const match = getMatch(matchId);
+        if(!match || match.status !== "Playing") return;
+        const userId = socket.user.id;
+        console.log(`[Match ${matchId}] User ${userId} surrendered ROUND.`);
+        const opponentId = match.player1Id == userId ? match.player2Id : match.player1Id;
+        const result = {
+            winnerId: opponentId,
+            loserId: userId,
+            isDraw: false,
+            player1_id: match.player1Id,
+            player2_id: match.player2Id,
+            player1_points: match.player1Id == opponentId ? 91 : 0,
+            player2_points: match.player2Id == opponentId ? 91 : 0,
+            reason: 'surrender'
+        };
+        await match.handleGameEnd(result);
+    });
+
+    socket.on("match:surrender", async ({ matchId }) => {
+        const match = getMatch(matchId);
+        if(!match || match.status !== "Playing") return;
+        const userId = socket.user.id;
+        
+        // FIX: Abort current game to remove ghost
+        await match.abortCurrentGame(userId);
+
+        console.log(`[Match ${matchId}] User ${userId} surrendered MATCH.`);
+        const opponentId = match.player1Id == userId ? match.player2Id : match.player1Id;
+        match.marks[opponentId] = 4; 
+        await match.finishMatch();
+        broadcastMatchUpdate(matchId, match);
+    });
+
+    socket.on("disconnect", async () => {
+        if (socket.activeMatchId) {
+            const match = getMatch(socket.activeMatchId);
+            if (match && match.status === 'Playing') {
+                const userId = socket.user?.id;
+                if (userId === match.player1Id || userId === match.player2Id) {
+                    console.log(`[Match ${match.id}] Player ${userId} disconnected.`);
+                    
+                    // FIX: Abort current game
+                    await match.abortCurrentGame(userId);
+
+                    const opponentId = match.player1Id == userId ? match.player2Id : match.player1Id;
+                    match.marks[opponentId] = 4;
+                    await match.finishMatch();
+                    broadcastMatchUpdate(match.id, match);
+                }
+            }
+        }
+    });
+};

websockets/package.json

@@ -2,6 +2,7 @@
   "name": "websockets",
   "version": "1.0.0",
   "main": "index.js",
+  "type": "module",
   "scripts": {
     "dev": "nodemon index.js",
     "start": "bun index.js "

websockets/server.js

@@ -3,6 +3,7 @@ import axios from "axios";
 import { handleConnectionEvents } from "./events/connection.js";
 import { addUser, removeUser } from "./state/connection.js";
 import gameEvents from "./events/game.js";
+import matchEvents from "./events/match.js";
 
 export const server = {
     io: null,
@@ -10,6 +11,11 @@ export const server = {
 
 const API_URL = "http://localhost:8000/api/v1";
 
+const disconnectTimers = new Map();
+const RECONNECT_GRACE_PERIOD = 1 * 60 * 1000; // 1 minutes
+
+const userId = (socket) => socket.user && socket.user.id;
+
 export const serverStart = (port) => {
     server.io = new Server(port, {
         cors: {
@@ -18,15 +24,22 @@ export const serverStart = (port) => {
     });
 
     server.io.use(async (socket, next) => {
-    const token = socket.handshake.auth.token;
+        let token = socket.handshake.auth.token;
 
         if (!token) {
             return next(new Error("Authentication error: No token provided"));
         }
 
+        if (!token.startsWith("Bearer ")) {
+            token = "Bearer " + token;
+        }
+
         try {
             const response = await axios.get(`${API_URL}/users/me`, {
-        headers: { Authorization: token },
+                headers: {
+                    Authorization: token,
+                    Accept: "application/json"
+                },
             });
 
             const user = response.data.data || response.data;
@@ -35,6 +48,16 @@ export const serverStart = (port) => {
                 return next(new Error("Authentication error: User data not found"));
             }
 
+            socket.user = user;
+            socket.token = token;
+            socket.handshake.auth.token = token;
+
+            if (disconnectTimers.has(user.id)) {
+                console.log(`[Connection] User ${user.id} reconnected! Cancelling surrender timer.`);
+                clearTimeout(disconnectTimers.get(user.id));
+                disconnectTimers.delete(user.id);
+            }
+
             addUser(socket.id, user);
 
             next();
@@ -53,15 +76,67 @@ export const serverStart = (port) => {
     });
 
     server.io.on("connection", (socket) => {
-    console.log("New connection:", socket.id);
-
         gameEvents(server.io, socket);
+        matchEvents(server.io, socket);
 
         handleConnectionEvents(server.io, socket);
 
+        socket.on("notify_disconnect", () => {
+            socket.isVoluntaryDisconnect = true;
+        });
+
         socket.on("disconnect", () => {
+            // Remove from active socket list
             removeUser(socket.id);
-      console.log("Disconnected:", socket.id);
+
+            if (socket.isVoluntaryDisconnect) {
+                console.log(`[Disconnect] User ${userId} disconnected voluntarily. No surrender needed.`);
+                return;
+            }
+
+            if (userId)  {
+                console.log(`[Disconnect] User ${userId} disconnected. Waiting ${RECONNECT_GRACE_PERIOD / 1000}s...`);
+
+                // -----------------------------------------------------------
+                // 2. START SURRENDER TIMER
+                // -----------------------------------------------------------
+                const timer = setTimeout(async () => {
+                    console.log(`[Timeout] User ${userId} did not return. Forcing surrender.`);
+
+                    // A. Find the Game ID this user is playing (You need a way to look this up)
+                    // Ideally, your 'socket' object or a global map knows which gameID the user is in.
+                    // For this example, let's assume you stored `socket.activeGameId` when they joined.
+                    const gameId = socket.activeGameId;
+
+                    if (gameId) {
+                        try {
+                            // B. Call Laravel API to resign on their behalf
+                            // We use the token we saved during the handshake
+                            await axios.post(`${API_URL}/games/${gameId}/resign`, {}, {
+                                headers: {
+                                    Authorization: socket.handshake.auth.token,
+                                    Accept: "application/json"
+                                }
+                            });
+
+                            // C. Notify the room (The API likely triggers a Pusher/Socket event, 
+                            // but we can also emit locally if needed)
+                            server.io.to(gameId).emit("game_over", {
+                                winner: "opponent",
+                                reason: "disconnect"
+                            });
+
+                            console.log(`[Timeout] Successfully resigned game ${gameId} for user ${userId}`);
+                        } catch (err) {
+                            console.error(`[Timeout] Failed to resign game for user ${userId}:`, err.message);
+                        }
+                    }
+
+                    disconnectTimers.delete(userId);
+                }, RECONNECT_GRACE_PERIOD);
+
+                disconnectTimers.set(userId, timer);
+            }
         });
     });
 };

websockets/state/game.js

@@ -1,8 +1,15 @@
-const BiscaGame = require("../classes/BiscaGame");
+import BiscaGame from "../classes/BiscaGame.js";
 
 const activeGames = new Map();
 
-const createGame = (id, type, player1, player2) => {
+export const createGame = (id, type, player1, player2) => {
+  const existingGame = activeGames.get(id);
+  if (existingGame) {
+    console.log(
+      `[Game State] Game ${id} already exists, returning existing instance`
+    );
+    return existingGame;
+  }
   const game = new BiscaGame(id, type, player1, player2);
 
   game.init();
@@ -13,17 +20,16 @@ const createGame = (id, type, player1, player2) => {
   return game;
 };
 
-const getGame = (id) => {
+export const getGame = (id) => {
   return activeGames.get(id);
 };
 
-const removeGame = (id) => {
+export const removeGame = (id) => {
+  const game = activeGames.get(id);
+  if (game) {
+    game.stopTimer();
     activeGames.delete(id);
     console.log(`[Game State] Game removed: ${id}`);
+  }
 };
 
-module.exports = {
-  createGame,
-  getGame,
-  removeGame,
-};

websockets/state/match.js

@@ -0,0 +1,16 @@
+const matches = new Map();
+
+export const addMatch = (match) => {
+  matches.set(parseInt(match.id), match);
+  return match;
+};
+
+export const getMatch = (id) => {
+  return matches.get(parseInt(id));
+};
+
+export const removeMatch = (id) => {
+  matches.delete(parseInt(id));
+};
+
+export { matches };