blackjack/docs/game_flowchart.md

# Game flowchart

```mermaid
flowchart TD
  A[Start] --> B[Shuffle and deal cards]
  B --> C[Player gets 2 cards, Dealer gets 1 face-up, 1 face-down]
  C --> D{Dealer shows Ace or 10?}
  D -- Yes --> E{Dealer has Blackjack?}
  E -- Yes --> F[Dealer reveals face-down card]
  F --> G{Player also has Blackjack?}
  G -- Yes --> P[Tie]
  G -- No --> L[Player loses]
  D -- No --> H[Player turn]
  E -- No --> H
  H --> I{Hit or Stand?}
  I -- Hit --> J[Player draws card]
  J --> K{Player busts (>21)?}
  K -- Yes --> L
  K -- No --> H
  I -- Stand --> M[Player ends turn]
  M --> N[Dealer reveals face-down card]
  N --> O{Dealer hand < 17?}
  O -- Yes --> P1[Dealer draws card]
  P1 --> O
  O -- No --> Q{Dealer busts (>21)?}
  Q -- Yes --> W1[Player wins 1:1]
  Q -- No --> R[Compare hands]
  R --> S{Player > Dealer?}
  S -- Yes --> W2[Player wins 1:1 or 3:2]
  S -- No --> T{Player = Dealer?}
  T -- Yes --> P
  T -- No --> L
  L --> Z[End]
  P --> Z
  W1 --> Z
  W2 --> Z
```