From 325f2e44f632776af4be464303a75e72b31b3b05 Mon Sep 17 00:00:00 2001
From: Janis <janis.e.20@gmx.de>
Date: Sat, 1 Nov 2025 21:35:08 +0100
Subject: [PATCH 1/2] feat(ui): add main menu navbar and join game
 functionality

---
 bruno/KnockOutWhist/Game/Get Game.bru         |   2 +-
 bruno/KnockOutWhist/Game/Start Game.bru       |   2 +-
 knockoutwhist                                 |   2 +-
 .../app/controllers/MainMenuController.scala  |  18 +++++-
 .../app/controllers/UserController.scala      |   2 +-
 .../app/logic/game/GameLobby.scala            |   3 +
 .../app/views/ingame/ingame.scala.html        |   2 +-
 .../app/views/mainmenu/navbar.scala.html      |  56 ++++++++++++++++++
 .../app/views/mainmenu/rules.scala.html       |   2 +-
 knockoutwhistweb/conf/routes                  |   5 +-
 knockoutwhistweb/public/images/profile.png    | Bin 0 -> 37198 bytes
 11 files changed, 84 insertions(+), 10 deletions(-)
 create mode 100644 knockoutwhistweb/app/views/mainmenu/navbar.scala.html
 create mode 100644 knockoutwhistweb/public/images/profile.png

diff --git a/bruno/KnockOutWhist/Game/Get Game.bru b/bruno/KnockOutWhist/Game/Get Game.bru
index 6b6d6af..8bc5076 100644
--- a/bruno/KnockOutWhist/Game/Get Game.bru	
+++ b/bruno/KnockOutWhist/Game/Get Game.bru	
@@ -11,7 +11,7 @@ get {
 }
 
 params:path {
-  id: uZDNZA
+  id: BZvtJ3
 }
 
 settings {
diff --git a/bruno/KnockOutWhist/Game/Start Game.bru b/bruno/KnockOutWhist/Game/Start Game.bru
index cc231bf..fa798f6 100644
--- a/bruno/KnockOutWhist/Game/Start Game.bru	
+++ b/bruno/KnockOutWhist/Game/Start Game.bru	
@@ -11,7 +11,7 @@ post {
 }
 
 params:path {
-  id: uZDNZA
+  id: nR1o3n
 }
 
 settings {
diff --git a/knockoutwhist b/knockoutwhist
index e0e45c4..b9a7b0a 160000
--- a/knockoutwhist
+++ b/knockoutwhist
@@ -1 +1 @@
-Subproject commit e0e45c4b431fff6740e38a59906f5e217fcd801f
+Subproject commit b9a7b0a2af7cef7225bf1a0388ebf58171a173f2
diff --git a/knockoutwhistweb/app/controllers/MainMenuController.scala b/knockoutwhistweb/app/controllers/MainMenuController.scala
index a7a1637..7032b52 100644
--- a/knockoutwhistweb/app/controllers/MainMenuController.scala
+++ b/knockoutwhistweb/app/controllers/MainMenuController.scala
@@ -21,7 +21,7 @@ class MainMenuController @Inject()(
 
   // Pass the request-handling function directly to authAction (no nested Action)
   def mainMenu(): Action[AnyContent] = authAction { implicit request: AuthenticatedRequest[AnyContent] =>
-    Ok("Main Menu for user: " + request.user.name)
+    Ok(views.html.mainmenu.navbar(Some(request.user)))
   }
 
   def index(): Action[AnyContent] = authAction { implicit request: AuthenticatedRequest[AnyContent] =>
@@ -36,6 +36,22 @@ class MainMenuController @Inject()(
     )
     Redirect(routes.IngameController.game(gameLobby.id))
   }
+  
+  def joinGame(): Action[AnyContent] = authAction { implicit request: AuthenticatedRequest[AnyContent] =>
+    val postData = request.body.asFormUrlEncoded
+    if (postData.isDefined) {
+      val gameId = postData.get.get("gameId").flatMap(_.headOption).getOrElse("")
+      val game = podManager.getGame(gameId)
+      game match {
+        case Some(g) =>
+          Redirect(routes.IngameController.joinGame(gameId))
+        case None =>
+          NotFound("Game not found")
+      }
+    } else {
+      BadRequest("Invalid form submission")
+    }
+  }
 
   def rules(): Action[AnyContent] = {
     Action { implicit request =>
diff --git a/knockoutwhistweb/app/controllers/UserController.scala b/knockoutwhistweb/app/controllers/UserController.scala
index 361826f..d3e5ebf 100644
--- a/knockoutwhistweb/app/controllers/UserController.scala
+++ b/knockoutwhistweb/app/controllers/UserController.scala
@@ -64,7 +64,7 @@ class UserController @Inject()(
     if (sessionCookie.isDefined) {
       sessionManager.invalidateSession(sessionCookie.get.value)
     }
-    NoContent.discardingCookies(DiscardingCookie("sessionId"))
+    Redirect(routes.UserController.login()).discardingCookies(DiscardingCookie("sessionId"))
   }
 
 }
\ No newline at end of file
diff --git a/knockoutwhistweb/app/logic/game/GameLobby.scala b/knockoutwhistweb/app/logic/game/GameLobby.scala
index 7dadf4a..6ee102d 100644
--- a/knockoutwhistweb/app/logic/game/GameLobby.scala
+++ b/knockoutwhistweb/app/logic/game/GameLobby.scala
@@ -70,6 +70,9 @@ class GameLobby private(
     if (!sessionOpt.get.host) {
       throw new NotHostException("Only the host can start the game!")
     }
+    if (logic.getCurrentState != Lobby) {
+      throw new IllegalStateException("The game has already started!")
+    }
     val playerNamesList = ListBuffer[AbstractPlayer]()
     users.values.foreach { player =>
       playerNamesList += PlayerFactory.createPlayer(player.name, player.id, HUMAN)
diff --git a/knockoutwhistweb/app/views/ingame/ingame.scala.html b/knockoutwhistweb/app/views/ingame/ingame.scala.html
index cb24ac0..f587dbc 100644
--- a/knockoutwhistweb/app/views/ingame/ingame.scala.html
+++ b/knockoutwhistweb/app/views/ingame/ingame.scala.html
@@ -17,7 +17,7 @@
             @if(logic.getCurrentTrick.get.firstCard.isDefined) {
                 @util.WebUIUtils.cardtoImage(logic.getCurrentTrick.get.firstCard.get)
             } else {
-                @views.html.render.card.apply("../../../public/images/cards/1B.png")("Blank Card")
+                @views.html.render.card.apply("images/cards/1B.png")("Blank Card")
             }
         </div>
     </div>
diff --git a/knockoutwhistweb/app/views/mainmenu/navbar.scala.html b/knockoutwhistweb/app/views/mainmenu/navbar.scala.html
new file mode 100644
index 0000000..a5f9cc4
--- /dev/null
+++ b/knockoutwhistweb/app/views/mainmenu/navbar.scala.html
@@ -0,0 +1,56 @@
+@(user: Option[model.users.User])
+@main("Knockout Whist - Main Menu") {
+    <nav class="navbar navbar-expand-lg bg-body-tertiary">
+        <div class="container-fluid">
+            <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navBar" aria-controls="navBar" aria-expanded="false" aria-label="Toggle navigation">
+                <span class="navbar-toggler-icon"></span>
+            </button>
+            <div class="collapse navbar-collapse" id="navBar">
+                <a class="navbar-brand" href="@routes.MainMenuController.mainMenu()">KnockOutWhist</a>
+                <div class="navbar-nav me-auto mb-2 mb-lg-0">
+                    <ul class="navbar-nav mb-2 mb-lg-0">
+                        @if(user.isDefined) {
+                            <li class="nav-item">
+                                <a class="nav-link active" aria-current="page" href="#">Create Game</a>
+                            </li>
+                            <li class="nav-item">
+                                <a class="nav-link disabled" aria-disabled="true">Lobbies</a>
+                            </li>
+                        }
+                        <li class="nav-item">
+                            <a class="nav-link active" href="@routes.MainMenuController.rules()">Rules</a>
+                        </li>
+                    </ul>
+                    <form class="navbar-nav me-auto mb-2 mb-lg-0" method="post" action="@routes.MainMenuController.joinGame()">
+                        <input class="form-control me-2" type="text" placeholder="Enter GameCode" name="gameId" aria-label="Join Game"/>
+                        <button class="btn btn-outline-success" type="submit">Join</button>
+                    </form>
+                </div>
+
+                @* Right side: profile dropdown if logged in, otherwise Login / Sign Up buttons *@
+                @if(user.isDefined) {
+                    <ul class="navbar-nav ms-auto mb-2 mb-lg-0">
+                        <li class="nav-item dropdown">
+                            <a class="nav-link dropdown-toggle d-flex align-items-center" href="#" id="profileDropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false">
+                                <img src="@routes.Assets.versioned("images/profile.png")" alt="Profile" class="rounded-circle" width="30" height="30" />
+                                <span class="ms-2">@user.get.name</span>
+                            </a>
+                            <ul class="dropdown-menu dropdown-menu-end" aria-labelledby="profileDropdown">
+                                <li><a class="dropdown-item disabled" href="#" tabindex="-1" aria-disabled="true">Stats</a></li>
+                                <li><a class="dropdown-item disabled" href="#" tabindex="-1" aria-disabled="true">Settings</a></li>
+                                <li><hr class="dropdown-divider"></li>
+                                <li><a class="dropdown-item" href="@routes.UserController.logout()">Logout</a></li>
+                            </ul>
+                        </li>
+                    </ul>
+                } else {
+                    <div class="d-flex ms-auto">
+                        <a class="btn btn-outline-primary me-2" href="@routes.UserController.login()">Login</a>
+                        <a class="btn btn-primary" href="@routes.UserController.login()">Sign Up</a>
+                    </div>
+                }
+
+            </div>
+        </div>
+    </nav>
+}
diff --git a/knockoutwhistweb/app/views/mainmenu/rules.scala.html b/knockoutwhistweb/app/views/mainmenu/rules.scala.html
index a6a1b90..08a968d 100644
--- a/knockoutwhistweb/app/views/mainmenu/rules.scala.html
+++ b/knockoutwhistweb/app/views/mainmenu/rules.scala.html
@@ -1,7 +1,7 @@
 @()
 
 @main("Rules") {
-<div id="rules">
+<div id="rules" class="game-field game-field-background">
     <table>
         <caption>Rules Overview and Equipment</caption>
         <thead>
diff --git a/knockoutwhistweb/conf/routes b/knockoutwhistweb/conf/routes
index c122c96..f1867c7 100644
--- a/knockoutwhistweb/conf/routes
+++ b/knockoutwhistweb/conf/routes
@@ -13,6 +13,7 @@ GET     /mainmenu                   controllers.MainMenuController.mainMenu()
 GET     /rules                      controllers.MainMenuController.rules()
 
 POST    /createGame                 controllers.MainMenuController.createGame()
+POST    /joinGame                   controllers.MainMenuController.joinGame()
 
 # User authentication routes
 GET     /login                      controllers.UserController.login()
@@ -22,9 +23,7 @@ GET     /logout                     controllers.UserController.logout()
 
 # In-game routes
 GET    /game/:id                    controllers.IngameController.game(id: String)
-POST   /game/:id/join               controllers.IngameController.joinGame(id: String)
-
+GET    /game/:id/join               controllers.IngameController.joinGame(id: String)
 POST   /game/:id/start              controllers.IngameController.startGame(id: String)
 
-
 POST   /game/:id/playCard           controllers.IngameController.playCard(id: String)
\ No newline at end of file
diff --git a/knockoutwhistweb/public/images/profile.png b/knockoutwhistweb/public/images/profile.png
new file mode 100644
index 0000000000000000000000000000000000000000..941c0dce378c752ba3e21fdad32784563422f65f
GIT binary patch
literal 37198
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
TE8WjVf`9aNj1CoR*@pceCRFI5

literal 0
HcmV?d00001

-- 
2.52.0


From 8eec1fd38f38f655e2053394910f27cd6501974a Mon Sep 17 00:00:00 2001
From: Janis <janis.e.20@gmx.de>
Date: Sun, 2 Nov 2025 16:50:51 +0100
Subject: [PATCH 2/2] feat(ui): enhance user session management with
 interaction reset and locking

---
 .../app/controllers/IngameController.scala    | 23 +++++++++++++++----
 .../app/logic/game/GameLobby.scala            |  4 ++++
 .../app/model/sessions/UserSession.scala      |  4 ++++
 3 files changed, 27 insertions(+), 4 deletions(-)

diff --git a/knockoutwhistweb/app/controllers/IngameController.scala b/knockoutwhistweb/app/controllers/IngameController.scala
index ef588a8..8569b30 100644
--- a/knockoutwhistweb/app/controllers/IngameController.scala
+++ b/knockoutwhistweb/app/controllers/IngameController.scala
@@ -111,7 +111,10 @@ class IngameController @Inject()(
         cardIdOpt match {
           case Some(cardId) =>
             val result = Try {
-              g.playCard(g.getUserSession(request.user.id), cardId.toInt)
+              val session = g.getUserSession(request.user.id)
+              session.lock.lock()
+              g.playCard(session, cardId.toInt)
+              session.lock.unlock()
             }
             if (result.isSuccess) {
               NoContent
@@ -146,9 +149,15 @@ class IngameController @Inject()(
         val result = Try {
           cardIdOpt match {
             case Some(cardId) if cardId == "skip" =>
-              g.playDogCard(g.getUserSession(request.user.id), -1)
+              val session = g.getUserSession(request.user.id)
+              session.lock.lock()
+              g.playDogCard(session, -1)
+              session.lock.unlock()
             case Some(cardId) =>
-              g.playDogCard(g.getUserSession(request.user.id), cardId.toInt)
+              val session = g.getUserSession(request.user.id)
+              session.lock.lock()
+              g.playDogCard(session, cardId.toInt)
+              session.lock.unlock()
             case None =>
               throw new IllegalArgumentException("cardId parameter is missing")
           }
@@ -184,7 +193,10 @@ class IngameController @Inject()(
         trumpOpt match {
           case Some(trump) =>
             val result = Try {
-              g.selectTrump(g.getUserSession(request.user.id), trump.toInt)
+              val session = g.getUserSession(request.user.id)
+              session.lock.lock()
+              g.selectTrump(session, trump.toInt)
+              session.lock.unlock()
             }
             if (result.isSuccess) {
               NoContent
@@ -216,7 +228,10 @@ class IngameController @Inject()(
         tieOpt match {
           case Some(tie) =>
             val result = Try {
+              val session = g.getUserSession(request.user.id)
+              session.lock.lock()
               g.selectTie(g.getUserSession(request.user.id), tie.toInt)
+              session.lock.unlock()
             }
             if (result.isSuccess) {
               NoContent
diff --git a/knockoutwhistweb/app/logic/game/GameLobby.scala b/knockoutwhistweb/app/logic/game/GameLobby.scala
index 6ee102d..a43e41a 100644
--- a/knockoutwhistweb/app/logic/game/GameLobby.scala
+++ b/knockoutwhistweb/app/logic/game/GameLobby.scala
@@ -111,6 +111,7 @@ class GameLobby private(
     if (!PlayerUtil.canPlayCard(card, getRound, getTrick, player)) {
       throw new CantPlayCardException("You can't play this card!")
     }
+    userSession.resetCanInteract()
     logic.playerInputLogic.receivedCard(card)
   }
 
@@ -132,6 +133,7 @@ class GameLobby private(
     }
     val hand = getHand(player)
     val card = hand.cards(cardIndex)
+    userSession.resetCanInteract()
     logic.playerInputLogic.receivedDog(Some(card))
   }
 
@@ -144,6 +146,7 @@ class GameLobby private(
     val player = getPlayerInteractable(userSession, InteractionType.TrumpSuit)
     val trumpSuits = Suit.values.toList
     val selectedTrump = trumpSuits(trumpIndex)
+    userSession.resetCanInteract()
     logic.playerInputLogic.receivedTrumpSuit(selectedTrump)
   }
 
@@ -154,6 +157,7 @@ class GameLobby private(
    */
   def selectTie(userSession: UserSession, tieNumber: Int): Unit = {
     val player = getPlayerInteractable(userSession, InteractionType.TieChoice)
+    userSession.resetCanInteract()
     logic.playerTieLogic.receivedTieBreakerCard(tieNumber)
   }
 
diff --git a/knockoutwhistweb/app/model/sessions/UserSession.scala b/knockoutwhistweb/app/model/sessions/UserSession.scala
index df45464..148ed50 100644
--- a/knockoutwhistweb/app/model/sessions/UserSession.scala
+++ b/knockoutwhistweb/app/model/sessions/UserSession.scala
@@ -28,4 +28,8 @@ class UserSession(user: User, val host: Boolean) extends PlayerSession {
 
   override def name: String = user.name
   
+  def resetCanInteract(): Unit = {
+    canInteract = None
+  }
+  
 }
-- 
2.52.0