Add: complete javadoc on model and network

src/main/java/it/polimi/ingsw/gc14/Model/Game.java

@@ -471,7 +471,6 @@ public class Game implements Serializable {
      * @param player the player performing the draw.
      * @param cardIndex the index of the upper tribe card to draw.
      * @return {@code true} if the draw succeeds, {@code false} otherwise.
-     * TODO
      */
     public boolean DrawUpperTribeCardByIndex(Player player,int cardIndex) {
         if( cardIndex<0 || cardIndex >=board.upperListTribe.size())
@@ -801,7 +800,14 @@ public class Game implements Serializable {
             }
         }
     }
-    //TODO
+    /**
+     * Transitions the game to the optional card phase or directly to the next round.
+     *
+     * <p>Builds a queue of non-disconnected players who own Building 12 (optional card effect).
+     * If such players exist, the first one is set as the current player for their optional action.
+     * Otherwise, if the round counter is below 10, the next round begins and the game stage
+     * is set to {@link GameStages#SLOT_CHOICE}; if round 10 has been completed, the game ends.
+     */
     private synchronized void transitionToOptionalOrNextRound() {
         currentState.GameStageUpdate(GameStages.OPT_CARD_E);