game planning
This commit is contained in:
beo3000
parent
e2fe8b723a
commit
d2ee1c5193
|
|
@ -828,8 +828,420 @@ Policy: `@attribute [Authorize(Policy = "ClubViewer|ClubEditor|ClubAdmin")]`
|
|||
|
||||
---
|
||||
|
||||
## Zusammenfassung
|
||||
## Zusammenfassung Phase 1
|
||||
|
||||
**23 feine Phasen** → **~75 Dateien** → **MVP Phase 1 komplett**
|
||||
**23 feine Phasen** → **~75 Dateien** → **MVP Phase 1 komplett** ✓
|
||||
|
||||
Bereit für Implementierung Phase A1
|
||||
---
|
||||
|
||||
---
|
||||
|
||||
# IMPLEMENTIERUNGSPLAN - Phase 2: Detaillierte Spielverwaltung
|
||||
|
||||
## Übersicht
|
||||
|
||||
Integration des Game-Management-Systems aus KoogleApp in Koogle.Web mit Clean Architecture.
|
||||
Spiele laufen im Speicher auf der DayDetails-Seite ohne Browser-Reload.
|
||||
|
||||
## Geklärte Anforderungen
|
||||
|
||||
| Aspekt | Entscheidung |
|
||||
|--------|--------------|
|
||||
| Spiel-Ende | Auto-Ende + manuelle "Beenden" Option |
|
||||
| Strafen-Schnellwahl | Nur im Details-Tab, nicht in Eingabe/Tafel |
|
||||
| Multi-Game | Sequentiell - mehrere Spiele pro Tag, Liste sichtbar |
|
||||
| Persistenz | JSON in `Game.GameData` nach Spielende speichern |
|
||||
| Scheiss-Spiel Ende | Erster mit 0 Punkten **gewinnt**, andere bekommen Strafen nach Restpunkten |
|
||||
| Strafen-Berechnung | Fixbetrag pro Restpunkt (z.B. 0.10€ × 30 Punkte = 3.00€) |
|
||||
|
||||
## Design-Entscheidungen
|
||||
|
||||
| Entscheidung | Lösung |
|
||||
|--------------|--------|
|
||||
| State-Speicherung | Separater `GameState` (nicht in DayState) |
|
||||
| View-Wechsel | ViewMode-Enum + MudTabs (kein URL-Routing) |
|
||||
| Spieltyp-System | IGameDefinition in Domain, Registry in Application |
|
||||
| Pin-Komponenten | Port aus KoogleApp mit neuem Namespace |
|
||||
| Persistenz | In-Memory während Spiel → DB (Game.GameData) bei Ende |
|
||||
|
||||
## Existierende Entity
|
||||
|
||||
```csharp
|
||||
// Koogle.Domain/Entities/Game.cs - bereits vorhanden
|
||||
public class Game : BaseEntity
|
||||
{
|
||||
public string GameData { get; set; } = "{}"; // JSON für Spielergebnis
|
||||
public Guid DayId { get; set; }
|
||||
public Day Day { get; set; }
|
||||
public ICollection<GamePerson> GamePersons { get; set; }
|
||||
public Guid ClubId { get; set; }
|
||||
public Club Club { get; set; }
|
||||
}
|
||||
// → GameType Property hinzufügen (string oder Enum)
|
||||
```
|
||||
|
||||
## Architektur
|
||||
|
||||
```
|
||||
Domain: GameType Enum, IGameDefinition Interface
|
||||
Application: Games/ mit GameProgress, IGameLogicService, Training/, Shit/
|
||||
Web: Store/GameState/, Components/Game/
|
||||
```
|
||||
|
||||
## Umsetzungsreihenfolge Phase 2
|
||||
|
||||
| ☐ | Phase | Bereich | Beschreibung | Dateien |
|
||||
|---|-------|---------|--------------|---------|
|
||||
| ☐ | H1 | Foundation | GameState Fluxor | 5 |
|
||||
| ☐ | H2 | Components | Pin Input Components | 5 |
|
||||
| ☐ | H3 | Framework | Game Definition Framework | 5 |
|
||||
| ☐ | H4 | Games | Training Game | 5 |
|
||||
| ☐ | H5 | Games | Scheiss-Spiel | 5 |
|
||||
| ☐ | H6 | UI | Game Setup Dialog | 4 |
|
||||
| ☐ | H7 | Integration | DayDetails Integration | 3 |
|
||||
| ☐ | H8 | Features | Undo/Redo | 3 |
|
||||
| ☐ | H9 | Features | Session Persistence | 2 |
|
||||
| ☐ | H10 | Testing | Game Tests | 3 |
|
||||
|
||||
**Geschätzte Dateien: ~42 neue/modifizierte**
|
||||
|
||||
---
|
||||
|
||||
## Detaillierte Phasen
|
||||
|
||||
### **Phase H1: GameState Foundation**
|
||||
|
||||
**Dateien:**
|
||||
1. `src/Koogle.Web/Store/GameState/GameState.cs`
|
||||
2. `src/Koogle.Web/Store/GameState/GameActions.cs`
|
||||
3. `src/Koogle.Web/Store/GameState/GameReducers.cs`
|
||||
4. `src/Koogle.Web/Store/GameState/GameEffects.cs`
|
||||
5. `src/Koogle.Domain/Enums/GameType.cs`
|
||||
|
||||
**State-Struktur:**
|
||||
```csharp
|
||||
[FeatureState]
|
||||
public record GameState
|
||||
{
|
||||
public bool IsGameActive { get; init; }
|
||||
public string? GameTypeName { get; init; } // "Training", "Shit"
|
||||
public Guid? DayId { get; init; }
|
||||
public Guid? ActiveGameId { get; init; }
|
||||
public ThrowPanelState ThrowPanel { get; init; }
|
||||
public ParticipantsState Participants { get; init; }
|
||||
public object? GameModel { get; init; } // JSON-serializable game-specific data
|
||||
public UndoRedoState UndoRedo { get; init; }
|
||||
public IReadOnlyList<GameSummaryDto> CompletedGames { get; init; }
|
||||
public bool IsLoading { get; init; }
|
||||
public string? Error { get; init; }
|
||||
}
|
||||
|
||||
public record ThrowPanelState(
|
||||
bool IsStarted,
|
||||
PinStatus Pin1, PinStatus Pin2, PinStatus Pin3,
|
||||
PinStatus Pin4, PinStatus Pin5, PinStatus Pin6,
|
||||
PinStatus Pin7, PinStatus Pin8, PinStatus Pin9,
|
||||
int ThrowsPerRound,
|
||||
int ThrowCounterPerRound,
|
||||
ThrowMode ThrowMode,
|
||||
int TotalThrowCounter,
|
||||
bool BellValue
|
||||
);
|
||||
|
||||
public record ParticipantsState(
|
||||
Guid[] PlayerIds,
|
||||
int CurrentPlayerIndex,
|
||||
ParticipantsMode Mode
|
||||
);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### **Phase H2: Pin Input Components**
|
||||
|
||||
**Dateien (Port aus KoogleApp):**
|
||||
1. `src/Koogle.Web/Components/Game/Pin.razor`
|
||||
2. `src/Koogle.Web/Components/Game/PinPanel.razor`
|
||||
3. `src/Koogle.Web/Components/Game/NumberPanel.razor`
|
||||
4. `src/Koogle.Web/Components/Game/ThrowPanel.razor`
|
||||
5. `src/Koogle.Web/Components/Game/GameInputPanel.razor`
|
||||
|
||||
**Pin-Layout (9 Kegel):**
|
||||
```
|
||||
①
|
||||
② ③
|
||||
④ ⑤ ⑥
|
||||
⑦ ⑧
|
||||
⑨
|
||||
```
|
||||
|
||||
**Features:**
|
||||
- Pin.razor: Einzelner Kegel, klickbar, Status (Standing/Fallen/Disabled)
|
||||
- PinPanel.razor: 9-Pin-Layout, Touch-optimiert
|
||||
- NumberPanel.razor: Schnelleingabe 1-9, Wurf-Button, Glocke
|
||||
- ThrowPanel.razor: Wurf-Bestätigung, Rinnen links/rechts
|
||||
- GameInputPanel.razor: Orchestriert alles, zeigt aktuellen Spieler
|
||||
|
||||
---
|
||||
|
||||
### **Phase H3: Game Definition Framework**
|
||||
|
||||
**Dateien:**
|
||||
1. `src/Koogle.Domain/Interfaces/IGameDefinition.cs`
|
||||
2. `src/Koogle.Application/Games/GameProgress.cs`
|
||||
3. `src/Koogle.Application/Games/IGameLogicService.cs`
|
||||
4. `src/Koogle.Application/Games/GameDefinitionRegistry.cs`
|
||||
5. `src/Koogle.Application/DependencyInjection.cs` (erweitern)
|
||||
|
||||
**IGameDefinition:**
|
||||
```csharp
|
||||
public interface IGameDefinition
|
||||
{
|
||||
string Name { get; } // "Training"
|
||||
string DisplayName { get; } // "Kegel-Training"
|
||||
Type SetupComponentType { get; }
|
||||
Type BoardComponentType { get; }
|
||||
Type GameLogicServiceType { get; }
|
||||
Type GameModelType { get; }
|
||||
}
|
||||
```
|
||||
|
||||
**GameProgress (Port):**
|
||||
- BeforeThrowState, AfterThrowState
|
||||
- PinCount(), IsCircle() Extension Methods
|
||||
- NextRound(), EndOfGame() Helpers
|
||||
|
||||
---
|
||||
|
||||
### **Phase H4: Training Game**
|
||||
|
||||
**Dateien:**
|
||||
1. `src/Koogle.Application/Games/Training/TrainingGameDefinition.cs`
|
||||
2. `src/Koogle.Application/Games/Training/TrainingGameModel.cs`
|
||||
3. `src/Koogle.Application/Games/Training/TrainingGameLogicService.cs`
|
||||
4. `src/Koogle.Web/Components/Game/Training/TrainingSetup.razor`
|
||||
5. `src/Koogle.Web/Components/Game/Training/TrainingBoard.razor`
|
||||
|
||||
**TrainingGameModel:**
|
||||
```csharp
|
||||
public record TrainingGameModel
|
||||
{
|
||||
public Dictionary<Guid, PlayerStats> PlayerStatistics { get; init; }
|
||||
}
|
||||
|
||||
public record PlayerStats
|
||||
{
|
||||
public int ThrowCount { get; set; }
|
||||
public int PinCount { get; set; }
|
||||
public int CircleCount { get; set; } // Kränze (8+1)
|
||||
public int StrikeCount { get; set; } // Alle 9
|
||||
}
|
||||
```
|
||||
|
||||
**TrainingSetup.razor:**
|
||||
- ThrowMode: Reposition (in die Vollen) / Decrease (Abräumen)
|
||||
- ThrowsPerRound: 1-5
|
||||
- ParticipantsMode: GameLogic (Rotation) / FreeToChoose
|
||||
|
||||
**TrainingBoard.razor (Tafel):**
|
||||
| Spieler | Würfe | Kegel | Kränze | ⌀ |
|
||||
|---------|-------|-------|--------|---|
|
||||
| Max | 24 | 156 | 3 | 6.5 |
|
||||
|
||||
---
|
||||
|
||||
### **Phase H5: Scheiss-Spiel**
|
||||
|
||||
**Dateien:**
|
||||
1. `src/Koogle.Application/Games/Shit/ShitGameDefinition.cs`
|
||||
2. `src/Koogle.Application/Games/Shit/ShitGameModel.cs`
|
||||
3. `src/Koogle.Application/Games/Shit/ShitGameLogicService.cs`
|
||||
4. `src/Koogle.Web/Components/Game/Shit/ShitSetup.razor`
|
||||
5. `src/Koogle.Web/Components/Game/Shit/ShitBoard.razor`
|
||||
|
||||
**ShitGameModel:**
|
||||
```csharp
|
||||
public record ShitGameModel
|
||||
{
|
||||
public int ShitNumber { get; init; } // 1-9 (Scheiss-Zahl)
|
||||
public int StartNumber { get; init; } // 10-1000 (Startzahl)
|
||||
public decimal PricePerPoint { get; init; } // 0.01-1.00 (€ pro Restpunkt)
|
||||
public Dictionary<Guid, int> PlayerPoints { get; init; }
|
||||
public int CollectedPoints { get; set; }
|
||||
public Guid? WinnerId { get; set; }
|
||||
}
|
||||
```
|
||||
|
||||
**Spiellogik:**
|
||||
1. Spieler wirft
|
||||
2. Wenn Scheiss-Zahl oder Rinne → gesammelte Punkte werden vom Konto abgezogen, nächster Spieler
|
||||
3. Sonst → Punkte werden gesammelt (addiert)
|
||||
4. Erster mit 0 Punkten → **GEWINNER**
|
||||
5. Spiel endet, alle anderen bekommen Strafe: `Restpunkte × PricePerPoint`
|
||||
|
||||
**ShitSetup.razor:**
|
||||
- Scheiss-Zahl (1-9, Default: 5)
|
||||
- Start-Zahl (10-1000, Default: 50)
|
||||
- **Betrag pro Punkt** (0.01€ - 1.00€, Default: 0.10€)
|
||||
|
||||
**ShitBoard.razor (Tafel):**
|
||||
| Spieler | Punkte | Status |
|
||||
|---------|--------|--------|
|
||||
| Max | 23 | 🎯 |
|
||||
| Anna | 0 | 🏆 GEWINNER |
|
||||
|
||||
---
|
||||
|
||||
### **Phase H6: Game Setup Dialog**
|
||||
|
||||
**Dateien:**
|
||||
1. `src/Koogle.Web/Components/Game/GameSetupDialog.razor`
|
||||
2. `src/Koogle.Web/Components/Game/GameTypeSelector.razor`
|
||||
3. `src/Koogle.Web/Components/Game/ParticipantSelector.razor`
|
||||
4. `src/Koogle.Web/Components/Game/CommonSetupOptions.razor`
|
||||
|
||||
**Flow:**
|
||||
1. Dialog öffnen
|
||||
2. Spieltyp auswählen (Training, Scheiss-Spiel)
|
||||
3. DynamicComponent rendert spieltyp-spezifisches Setup
|
||||
4. Teilnehmer aus Day-Participants auswählen
|
||||
5. "Spiel starten" → `StartGameAction` dispatch
|
||||
|
||||
---
|
||||
|
||||
### **Phase H7: DayDetails Integration**
|
||||
|
||||
**Dateien ändern:**
|
||||
1. `src/Koogle.Web/Components/Pages/Days/DayDetails.razor`
|
||||
2. `src/Koogle.Web/Components/Game/GameBoardPanel.razor`
|
||||
3. `src/Koogle.Web/Components/Game/CompletedGamesList.razor`
|
||||
|
||||
**DayDetails Erweiterung:**
|
||||
```razor
|
||||
@code {
|
||||
private int _activeTabIndex = 0;
|
||||
}
|
||||
|
||||
<MudTabs @bind-ActivePanelIndex="_activeTabIndex">
|
||||
<MudTabPanel Text="Details" Icon="@Icons.Material.Filled.Info">
|
||||
<!-- Bestehend: Participants + Expenses + Quick-Assign -->
|
||||
</MudTabPanel>
|
||||
|
||||
<MudTabPanel Text="Eingabe" Icon="@Icons.Material.Filled.SportsScore"
|
||||
Disabled="@(!GameState.Value.IsGameActive)">
|
||||
<GameInputPanel />
|
||||
</MudTabPanel>
|
||||
|
||||
<MudTabPanel Text="Tafel" Icon="@Icons.Material.Filled.TableChart"
|
||||
Disabled="@(!GameState.Value.IsGameActive)">
|
||||
<GameBoardPanel />
|
||||
</MudTabPanel>
|
||||
</MudTabs>
|
||||
|
||||
<!-- Spiel starten Button (nur wenn Day.Status == Started und kein aktives Spiel) -->
|
||||
@if (SelectedDay?.Status == DayStatus.Started && !GameState.Value.IsGameActive)
|
||||
{
|
||||
<MudButton OnClick="OpenGameSetupDialog" Color="Color.Primary">
|
||||
Neues Spiel starten
|
||||
</MudButton>
|
||||
}
|
||||
|
||||
<!-- Liste abgeschlossener Spiele -->
|
||||
<CompletedGamesList DayId="DayId" />
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### **Phase H8: Undo/Redo**
|
||||
|
||||
**Dateien:**
|
||||
1. `src/Koogle.Web/Store/GameState/UndoRedoState.cs`
|
||||
2. `src/Koogle.Web/Store/GameState/UndoRedoActions.cs`
|
||||
3. `src/Koogle.Web/Components/Game/UndoRedoButtons.razor`
|
||||
|
||||
**Logic:**
|
||||
- Jeder Wurf erstellt Snapshot
|
||||
- Stack für Undo (max 20 Einträge)
|
||||
- "Letzten Wurf rückgängig" Button
|
||||
|
||||
---
|
||||
|
||||
### **Phase H9: Session Persistence**
|
||||
|
||||
**Dateien:**
|
||||
1. `src/Koogle.Web/wwwroot/js/gameSession.js`
|
||||
2. `src/Koogle.Web/Store/GameState/GameEffects.cs` (erweitern)
|
||||
|
||||
**Mechanismus:**
|
||||
- Bei State-Änderung: SessionStorage speichern
|
||||
- Bei Page-Load: SessionStorage prüfen
|
||||
- Wenn Session für aktuellen DayId existiert: Restore anbieten
|
||||
|
||||
---
|
||||
|
||||
### **Phase H10: Testing**
|
||||
|
||||
**Dateien:**
|
||||
1. `test/Koogle.Tests/Application/Games/TrainingGameLogicServiceTests.cs`
|
||||
2. `test/Koogle.Tests/Application/Games/ShitGameLogicServiceTests.cs`
|
||||
3. `test/Koogle.Tests/Web/GameStateReducersTests.cs`
|
||||
|
||||
**Test-Cases:**
|
||||
- Pin-Count Berechnung
|
||||
- Kranz-Erkennung (8 äußere + Mitte steht)
|
||||
- Scheiss-Spiel: Gewinner bei 0
|
||||
- Scheiss-Spiel: Strafen-Berechnung
|
||||
- Reducer: State-Transformationen
|
||||
|
||||
---
|
||||
|
||||
## Scheiss-Spiel Spielende-Logik
|
||||
|
||||
```
|
||||
1. Spieler erreicht 0 Punkte → GEWINNER (WinnerId setzen)
|
||||
2. Spiel endet automatisch (IsGameActive = false)
|
||||
3. Für jeden Verlierer:
|
||||
- Strafe = Restpunkte × Betrag_pro_Punkt
|
||||
- PersonExpense erstellen (ExpenseType: GamePenalty)
|
||||
4. Game.GameData speichern (JSON mit Ergebnis)
|
||||
5. CompletedGames-Liste aktualisieren
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Kritische Dateien (KoogleApp → Koogle.Web Port)
|
||||
|
||||
| Quelle (KoogleApp) | Ziel (Koogle.Web) |
|
||||
|--------------------|-------------------|
|
||||
| `src/KoogleApp/Games/GameProgress.cs` | `src/Koogle.Application/Games/GameProgress.cs` |
|
||||
| `src/KoogleApp/Store/Game/ThrowPanel/State.cs` | In `GameState.cs` integriert |
|
||||
| `src/KoogleApp/Games/Training/GameTrainingService.cs` | `src/Koogle.Application/Games/Training/TrainingGameLogicService.cs` |
|
||||
| `src/KoogleApp/Components/Controls/PinPanel.razor` | `src/Koogle.Web/Components/Game/PinPanel.razor` |
|
||||
| `src/KoogleApp/Components/Controls/NumberPanel.razor` | `src/Koogle.Web/Components/Game/NumberPanel.razor` |
|
||||
|
||||
---
|
||||
|
||||
## Migration
|
||||
|
||||
```bash
|
||||
# GameType Property zu Game Entity hinzufügen
|
||||
dotnet ef migrations add AddGameType --project src/Koogle.Infrastructure --startup-project src/Koogle.Web --context AppDbContext --output-dir Data/Migrations
|
||||
|
||||
dotnet ef database update -p src/Koogle.Infrastructure -s src/Koogle.Web --context AppDbContext
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Berechtigungen Phase 2
|
||||
|
||||
- **Spiel starten/beenden**: ClubEditor+
|
||||
- **Würfe eingeben**: ClubEditor+
|
||||
- **Tafel ansehen**: ClubViewer+
|
||||
|
||||
---
|
||||
|
||||
## Zusammenfassung Phase 2
|
||||
|
||||
**10 Phasen (H1-H10)** → **~42 Dateien** → **Detaillierte Spielverwaltung**
|
||||
|
||||
Bereit für Implementierung Phase H1
|
||||
|
|
|
|||
Loading…
Reference in New Issue