debugging

docs/game_flowchart.md

@@ -1,32 +1,37 @@
+# Game flowchart
+
 ```mermaid
 flowchart TD
-  A[Start: play_round()] --> B[Deck mischen und Karten austeilen];
+  A[Start: play_round()] --> B[Shuffle deck and deal cards]
-  B --> C[Spieler erhält 2 Karten, Dealer erhält 1 offen, 1 verdeckt];
+  B --> C[Player gets 2 cards, Dealer gets 1 face-up, 1 face-down]
-  C --> D{Dealer offen Ass oder 10-Wert?};
+  C --> D{Dealer's face-up card is Ace or 10-value?}
-  D -- Ja --> E{Dealer hat Blackjack?};
+  D -- Yes --> E{Does Dealer have Blackjack?}
-  E -- Ja --> F[Dealer deckt verdeckte Karte auf];
+  E -- Yes --> F[Dealer reveals face-down card]
-  F --> G{Spieler hat auch Blackjack?};
+  F --> G{Does Player also have Blackjack?}
-  G -- Ja --> P[PUSH (Unentschieden)];
+  G -- Yes --> P[PUSH (Tie)]
-  G -- Nein --> L[Spieler verliert];
+  G -- No --> L[Player loses]
-  D -- Nein oder E -- Nein --> H[Spielerzug-Loop];
+  D -- No --> H[Player turn loop]
-  H --> I{Spieler Hit oder Stand?};
+  E -- No --> H
-  I -- Hit --> J[Spieler zieht Karte];
+  H --> I{Player chooses Hit or Stand?}
-  J --> K{Spieler BUST (> 21)?};
+  I -- Hit --> J[Player draws a card]
-  K -- Ja --> L;
+  J --> K{Player BUST (> 21)?}
-  K -- Nein --> H;
+  K -- Yes --> L[Player loses]
-  I -- Stand --> M[Spielerzug beendet];
+  K -- No --> H
-  M --> N[Dealer deckt verdeckte Karte auf];
+  I -- Stand --> M[Player turn ends]
-  N --> O{Dealer Handwert < 17?};
+  M --> N[Dealer reveals face-down card]
-  O -- Ja --> P1[Dealer zieht Karte];
+  N --> O{Dealer hand value < 17?}
-  P1 --> O;
+  O -- Yes --> P1[Dealer draws a card]
-  O -- Nein --> Q{Dealer BUST (> 21)?};
+  P1 --> O
-  Q -- Ja --> W1[Spieler gewinnt 1:1];
+  O -- No --> Q{Dealer BUST (> 21)?}
-  Q -- Nein --> R[Vergleich: compare_hands(Player vs Dealer)];
+  Q -- Yes --> W1[Player wins 1:1]
-  R --> S{Spielerwert > Dealerwert?};
+  Q -- No --> R[Compare hands: Player vs Dealer]
-  S -- Ja --> W2[Spieler gewinnt (1:1 oder 3:2)];
+  R --> S{Player value > Dealer value?}
-  S -- Nein --> T{Spielerwert = Dealerwert?};
+  S -- Yes --> W2[Player wins (1:1 or 3:2)]
-  T -- Ja --> P;
+  S -- No --> T{Player value = Dealer value?}
-  T -- Nein --> L;
+  T -- Yes --> P[PUSH (Tie)]
-  
+  T -- No --> L[Player loses]
-  L & P & W1 & W2 --> Z[Ende: Chips aktualisieren, neue Runde?]
+  L --> Z[End: Update chips, new round?]
+  P --> Z
+  W1 --> Z
+  W2 --> Z
 ```