update README

This commit is contained in:
2025-10-26 22:00:41 +01:00
parent 4a9b01582b
commit e8b2c772f3

View File

@@ -1,6 +1,7 @@
# Blackjack Game Design Document
## 1. Flowchart (Spielablauf)
```mermaid
flowchart TD
A([Start]) --> B[Deck erstellen und mischen]
@@ -29,6 +30,7 @@ flowchart TD
```
## 2. UML-Klassendiagramm
```mermaid
classDiagram
class Card {
@@ -86,6 +88,7 @@ classDiagram
## 3. Implementierungs-Roadmap mit Tests
### Phase 1: Grundstruktur
- **Ziel:** Klassen anlegen, ohne Logik.
- Dateien: `card.py`, `deck.py`, `hand.py`, `player.py`, `dealer.py`, `game.py`, `main.py`.
- Methoden-Signaturen definieren.
@@ -95,10 +98,12 @@ classDiagram
---
### Phase 2: Card
- `__init__`: Speichert Rang, Farbe, Wert.
- `__str__`: Gibt z.B. "K♠" zurück.
**Test:**
```python
card = Card("A", "")
print(card) # Erwartet: A♠
@@ -107,43 +112,51 @@ print(card) # Erwartet: A♠
---
### Phase 3: Deck
- `__init__`: Erzeugt 52 Karten.
- `shuffle()`: Mischt die Karten.
- `deal_card()`: Gibt eine Karte zurück und entfernt sie.
**Test:**
- Prüfe, ob `len(deck.cards) == 52` nach Erstellung.
- Nach `deal_card()`: Länge = 51.
---
### Phase 4: Hand
- `add_card(card)`: Fügt Karte hinzu.
- `calculate_value()`: Summiert Werte.
- `adjust_for_ace()`: Reduziert Ass von 11 auf 1, wenn nötig.
**Test:**
- Hand mit Ass + 9 → Wert = 20.
- Hand mit Ass + 9 + 5 → Wert = 15.
---
### Phase 5: Player & Dealer
- `Player.hit(deck)`: Karte ziehen.
- `Dealer.play(deck)`: Zieht bis Wert ≥ 17.
**Test:**
- Spieler zieht Karte → Handgröße +1.
- Dealer zieht automatisch bis ≥ 17.
---
### Phase 6: Game
- `play_round()`: Ablauf wie im Flowchart.
- `compare_hands()`: Gewinner bestimmen.
- `show_cards()`: Karten anzeigen.
**Test:**
- Simuliere eine Runde:
- Spieler steht sofort.
- Dealer spielt.
@@ -152,17 +165,20 @@ print(card) # Erwartet: A♠
---
### Phase 7: Erweiterungen
- Chips & Einsätze.
- Mehrere Spieler.
- Features wie Split, Double Down.
**Test:**
- Chips reduzieren sich nach Einsatz.
- Gewinn/Verlust korrekt berechnet.
---
### Teststrategie
- **Unit-Tests** für jede Klasse (z.B. mit `pytest`).
- **Integrationstest**: Komplette Runde simulieren.
- **Edge Cases**:
@@ -170,7 +186,6 @@ print(card) # Erwartet: A♠
- Spieler oder Dealer hat Blackjack.
- Beide haben denselben Wert.
### Projektstruktur für OOP-Blackjack
```plaintext