Merge pull request #28 from Zoedayz/JamesBranch

James branch

Author: Zoedayz

.claude/worktrees/zealous-curran

@@ -0,0 +1 @@
+Subproject commit e6982a57eba077af5065b606bd6c000206a9b558

docs/readme-uml.md

@@ -0,0 +1,87 @@
+# GroupCasino UML (README-Aligned)
+
+```mermaid
+classDiagram
+direction LR
+
+class MainApplication {
+  +main(args String[]) void
+}
+
+class Casino {
+  -console IOConsole
+  +run() void
+  -getArcadeDashboardInput() String
+  -getGameSelectionInput() String
+  -play(gameObject Object, playerObject Object) void
+}
+
+class CasinoAccountManager {
+  +getAccount(accountName String, accountPassword String) CasinoAccount
+  +createAccount(accountName String, accountPassword String) CasinoAccount
+  +registerAccount(casinoAccount CasinoAccount) void
+}
+
+class CasinoAccount {
+  -username String
+  -password String
+  -balance double
+  +depositToBalance(amount double) void
+  +withdrawBalance(amount double) void
+  +getUsername() String
+  +getPassword() String
+  +getBalance() double
+}
+
+class GameInterface {
+  <<interface>>
+  +add(player PlayerInterface) void
+  +remove(player PlayerInterface) void
+  +run() void
+}
+
+class PlayerInterface {
+  <<interface>>
+  +getArcadeAccount() CasinoAccount
+  +play() SomeReturnType
+}
+
+class SlotsGame
+class NumberGuessGame
+class BlackjackGame
+
+class SlotsPlayer
+class NumberGuessPlayer
+class BlackjackPlayer
+
+class Deck
+class Card
+class BlackjackHand
+
+MainApplication --> Casino : starts
+Casino --> CasinoAccountManager : uses
+Casino --> GameInterface : runs selected game
+CasinoAccountManager --> CasinoAccount : creates/gets
+
+GameInterface <|.. SlotsGame
+GameInterface <|.. NumberGuessGame
+GameInterface <|.. BlackjackGame
+
+PlayerInterface <|.. SlotsPlayer
+PlayerInterface <|.. NumberGuessPlayer
+PlayerInterface <|.. BlackjackPlayer
+
+SlotsGame o--> SlotsPlayer : add/remove players
+NumberGuessGame o--> NumberGuessPlayer : add/remove players
+BlackjackGame o--> BlackjackPlayer : add/remove players
+
+SlotsPlayer --> CasinoAccount : has account
+NumberGuessPlayer --> CasinoAccount : has account
+BlackjackPlayer --> CasinoAccount : has account
+
+BlackjackGame --> Deck : uses
+BlackjackGame --> BlackjackHand : dealer hand
+BlackjackPlayer --> BlackjackHand : player hand
+Deck o--> Card : contains
+BlackjackHand o--> Card : contains
+```

src/main/java/com/github/zipcodewilmington/Casino.java

@@ -4,6 +4,10 @@
 import com.github.zipcodewilmington.casino.CasinoAccountManager;
 import com.github.zipcodewilmington.casino.GameInterface;
 import com.github.zipcodewilmington.casino.PlayerInterface;
+import com.github.zipcodewilmington.casino.games.blackjack.BlackjackGame;
+import com.github.zipcodewilmington.casino.games.blackjack.BlackjackPlayer;
+import com.github.zipcodewilmington.casino.games.craps.CrapsGame;
+import com.github.zipcodewilmington.casino.games.craps.CrapsPlayer;
 import com.github.zipcodewilmington.casino.games.numberguess.NumberGuessGame;
 import com.github.zipcodewilmington.casino.games.numberguess.NumberGuessPlayer;
 import com.github.zipcodewilmington.casino.games.slots.SlotsGame;
@@ -34,8 +38,17 @@ public void run() {
                         play(new SlotsGame(), new SlotsPlayer());
                     } else if (gameSelectionInput.equals("NUMBERGUESS")) {
                         play(new NumberGuessGame(), new NumberGuessPlayer());
+                    } else if (gameSelectionInput.equals("BLACKJACK")) {
+                        play(new BlackjackGame(), new BlackjackPlayer(casinoAccount));
+                    } else if (gameSelectionInput.equals("CRAPS")) {
+                        play(new CrapsGame(), new CrapsPlayer(casinoAccount));
+                    // ── Teammates: uncomment your game below when ready ──────────
+                    // } else if (gameSelectionInput.equals("ROULETTE")) {
+                    //     play(new RouletteGame(), new RoulettePlayer(casinoAccount));
+                    // } else if (gameSelectionInput.equals("HANGMAN")) {
+                    //     play(new HangmanGame(), new HangmanPlayer(casinoAccount));
+                    // ─────────────────────────────────────────────────────────────
                     } else {
-                        // TODO - implement better exception handling
                         String errorMessage = "[ %s ] is an invalid game selection";
                         throw new RuntimeException(String.format(errorMessage, gameSelectionInput));
                     }
@@ -66,13 +79,11 @@ private String getGameSelectionInput() {
         return console.getStringInput(new StringBuilder()
                 .append("Welcome to the Game Selection Dashboard!")
                 .append("\nFrom here, you can select any of the following options:")
-                .append("\n\t[ SLOTS ], [ NUMBERGUESS ]")
+            .append("\n\t[ SLOTS ], [ NUMBERGUESS ], [ BLACKJACK ], [ CRAPS ]")
                 .toString());
     }
 
-    private void play(Object gameObject, Object playerObject) {
-        GameInterface game = (GameInterface)gameObject;
-        PlayerInterface player = (PlayerInterface)playerObject;
+    private void play(GameInterface game, PlayerInterface player) {
         game.add(player);
         game.run();
     }

src/main/java/com/github/zipcodewilmington/casino/CasinoAccount.java

@@ -1,9 +1,80 @@
 package com.github.zipcodewilmington.casino;
 
+import java.util.ArrayList;
+import java.util.List;
+
 /**
  * Created by leon on 7/21/2020.
  * `ArcadeAccount` is registered for each user of the `Arcade`.
  * The `ArcadeAccount` is used to log into the system to select a `Game` to play.
  */
 public class CasinoAccount {
+    private String username;
+    private String password;
+    private double balance;
+    private final List<CasinoAccount> accounts = new ArrayList<>();
+
+    public CasinoAccount(String username, String password) {
+        this.username = username;
+        this.password = password;
+        this.balance = 0.0;
+    }
+
+    public void displayBalance() {
+        System.out.printf("Current balance: $%.2f%n", balance);
+    }
+
+    public void depositToBalance(double amount) {
+        if (amount <= 0) {
+            System.out.println("Deposit amount must be greater than zero.");
+            return;
+        }
+        balance += amount;
+        System.out.printf("Deposited $%.2f. New balance: $%.2f%n", amount, balance);
+    }
+
+    public void withdrawBalance(double amount) {
+        if (amount <= 0) {
+            System.out.println("Withdrawal amount must be greater than zero.");
+            return;
+        }
+        if (amount > balance) {
+            System.out.println("Insufficient funds.");
+            return;
+        }
+        balance -= amount;
+        System.out.printf("Withdrew $%.2f. New balance: $%.2f%n", amount, balance);
+    }
+
+    public String getUsername() { return username; }
+    public String getPassword() { return password; }
+    public double getBalance()  { return balance;  }
+
+    public CasinoAccount createAccount(String accountName, String accountPassword) {
+        System.out.printf("Creating account for [ %s ]...%n", accountName);
+        CasinoAccount newAccount = new CasinoAccount(accountName, accountPassword);
+        System.out.printf("Account created for [ %s ].%n", accountName);
+        return newAccount;
+    }
+
+    public void registerAccount(CasinoAccount casinoAccount) {
+        System.out.printf("Registering account [ %s ]...%n", 
+            casinoAccount.getUsername());
+            accounts.add(casinoAccount);
+        System.out.printf("Account [ %s ] registered successfully.%n", 
+        casinoAccount.getUsername());
+    }
+
+    public CasinoAccount getAccount(String accountName, String accountPassword) {
+        System.out.printf("Looking up account for [ %s ]...%n", accountName);
+        for (CasinoAccount account : accounts) {
+            if (account.getUsername().equals(accountName) &&
+                account.getPassword().equals(accountPassword)) {
+                System.out.printf("Account found for [ %s ].%n", accountName);
+                return account;
+                }
+            }
+            System.out.printf("No account found for [ %s ].%n", accountName);
+        return null;
+    }
 }

src/main/java/com/github/zipcodewilmington/casino/GameInterface.java

@@ -1,23 +1,46 @@
-package com.github.zipcodewilmington.casino;
-
-/**
- * Created by leon on 7/21/2020.
- */
-public interface GameInterface extends Runnable {
-    /**
-     * adds a player to the game
-     * @param player the player to be removed from the game
-     */
-    void add(PlayerInterface player);
-
-    /**
-     * removes a player from the game
-     * @param player the player to be removed from the game
-     */
-    void remove(PlayerInterface player);
-
-    /**
-     * specifies how the game will run
-     */
-    void run();
-}
+package com.github.zipcodewilmington.casino;
+
+/**
+ * Contract for all games in the Casino.
+ * Methods marked `default` are optional overrides — implement them in your game class as needed.
+ */
+public interface GameInterface extends Runnable {
+
+    // ── Required (must implement) ─────────────────────────────────────
+
+    /** Add a player to the game. */
+    void add(PlayerInterface player);
+
+    /** Remove a player from the game. */
+    void remove(PlayerInterface player);
+
+    /** Main game loop — drives a full session. */
+    void run();
+
+    // ── Optional hooks (override in your game class as needed) ────────
+
+    /** Load or reset any game state before a session starts. */
+    default void fetch() {}
+
+    /** Called at the start of each round. */
+    default void start() {}
+
+    /** Called at the end of each round. */
+    default void end() {}
+
+    /** Register or initialise any sub-games or game variants. */
+    default void loadGames() {}
+
+    /**
+     * Factory method — create and return a player for this game.
+     * Override to return your concrete player type (e.g. new BlackjackPlayer(account)).
+     */
+    default PlayerInterface createPlayer(CasinoAccount account) {
+        return null;
+    }
+
+    /** Remove and clean up a player — delegates to remove() by default. */
+    default void deletePlayer(PlayerInterface player) {
+        remove(player);
+    }
+}

src/main/java/com/github/zipcodewilmington/casino/PlayerInterface.java

@@ -1,21 +1,36 @@
-package com.github.zipcodewilmington.casino;
-
-/**
- * Created by leon on 7/21/2020.
- * All players of a game should abide by `PlayerInterface`.
- * All players must have reference to the `ArcadeAccount` used to log into the `Arcade` system.
- * All players are capable of `play`ing a game.
- */
-public interface PlayerInterface {
-    /**
-     * @return the `ArcadeAccount` used to log into the `Arcade` system to play this game
-     */
-    CasinoAccount getArcadeAccount();
-
-    /**
-     * Defines how a specific implementation of `PlayerInterface` plays their respective game.
-     * @param <SomeReturnType> specify any return type you would like here
-     * @return whatever return value you would like
-     */
-    <SomeReturnType> SomeReturnType play();
-}
+package com.github.zipcodewilmington.casino;
+
+/**
+ * Contract for all players in the Casino.
+ * All players must hold a CasinoAccount reference and know how to play their game.
+ * Methods marked `default` are provided for free — override them if you need custom behaviour.
+ */
+public interface PlayerInterface {
+
+    // ── Required (must implement) ─────────────────────────────────────
+
+    /** @return the CasinoAccount used to log into the Casino system. */
+    CasinoAccount getArcadeAccount();
+
+    /**
+     * Defines how this player plays their game.
+     * @param <SomeReturnType> any return type you need
+     */
+    <SomeReturnType> SomeReturnType play();
+
+    // ── Provided for free (override if needed) ────────────────────────
+
+    /**
+     * Alias for getArcadeAccount() — matches the UML name.
+     * Override if your player stores the account under a different field.
+     */
+    default CasinoAccount fetchCasinoAccount() {
+        return getArcadeAccount();
+    }
+
+    /** @return the player's current balance, or 0.0 if no account is set. */
+    default double getBalance() {
+        CasinoAccount account = getArcadeAccount();
+        return account != null ? account.getBalance() : 0.0;
+    }
+}