1248 lines
37 KiB
Markdown
1248 lines
37 KiB
Markdown
# Koogle App - Analyse & Vorschlag für Bereiche und Pages
|
||
|
||
## Zweck der Anwendung (abgeleitet aus Datenmodell)
|
||
|
||
**Koogle** ist eine Vereinsverwaltung für Kegelvereine mit Schwerpunkt auf:
|
||
|
||
### Kernfunktionen
|
||
1. **Vereinsverwaltung**: Multi-Mandanten-System, jeder Verein = eigener Scope
|
||
2. **Mitglieder & Gäste**: Verwaltung von Personen mit Status (Member/Guest)
|
||
3. **Spieltagsorganisation**: Planung und Durchführung von Kegeltagen (Days)
|
||
- Status-Workflow: New → Started → Closed (oder Postponed)
|
||
- Zuordnung von Teilnehmern pro Spieltag
|
||
4. **Spielverwaltung**: Mehrere Games pro Day möglich
|
||
- JSON-basierte Spielstände (GameData)
|
||
- Teilnehmerzuordnung pro Game
|
||
5. **Kostenmanagement**:
|
||
- Vordefinierte Kosten/Strafen (Expenses) pro Verein
|
||
- Automatische Trigger (z.B. Pudel, Pumpe, Aus, Kranz, etc.)
|
||
- Variable/Fixe Preise, Inverse Kosten (alle außer einem zahlen)
|
||
- One-Click Kosten für schnelle Erfassung
|
||
6. **Abrechnung**:
|
||
- Pro Person, pro Tag, pro Spiel
|
||
- Berechnungsmethoden: None, Average, Maximum (für fehlende Personen)
|
||
- Status: Open/Done für PersonExpenses
|
||
7. **Benutzer & Berechtigungen**:
|
||
- ASP.NET Identity mit Custom UserProfile
|
||
- Rollen pro Verein: Viewer, Editor, Admin
|
||
- SuperAdmin für vereinsübergreifende Verwaltung
|
||
- Multi-Club Zugehörigkeit möglich
|
||
|
||
---
|
||
|
||
## gerenelle Implementierungshinweise
|
||
- Der IMPLEMENTATION_PLAN ist in Deutscher Sprache formuliert.
|
||
- Die Anwendung wird in deutscher Sprache implementiert. Alle Klassen, Methoden, Interfaces und sonstigen Artikefakte werden dennoch in englischer Sprache benannt. Auch die XMLDOC Kommentare sind Englisch zu formulieren.
|
||
- Der Anwender wird vom Programm in lockerem Ton und in der Du-Form angesprochen.
|
||
|
||
## Bestehende Implementierung
|
||
|
||
### Vollständig implementiert
|
||
- ✅ Authentication/Authorization Framework
|
||
- ✅ Login mit Vereinsauswahl
|
||
- ✅ Fluxor State Management (AuthState)
|
||
- ✅ Rollenbasierte Berechtigungen
|
||
- ✅ MudBlazor UI Framework
|
||
- ✅ Dual DbContext (Domain + Identity)
|
||
- ✅ Clean Architecture Struktur
|
||
- ✅ Seeders (SuperAdmin, Roles)
|
||
|
||
### Teilweise implementiert
|
||
- ⚠️ DayService (vorhanden, aber auskommentiert)
|
||
- ⚠️ Navigation (Skelett vorhanden, kaum Menüpunkte)
|
||
|
||
### Nicht implementiert
|
||
- ❌ UI für Clubs, Days, Games, Persons, Expenses
|
||
- ❌ Services für Person, Game, Expense
|
||
- ❌ DTOs für die meisten Domain Entities
|
||
- ❌ Fluxor States für Domain-Daten
|
||
- ❌ Reporting/Export-Funktionalität
|
||
|
||
---
|
||
|
||
## Vorgeschlagene Bereiche & Pages
|
||
|
||
### 1. DASHBOARD-BEREICH (Startseite)
|
||
**Route:** `/` oder `/dashboard`
|
||
|
||
**Zweck:** Übersicht über aktuelle Aktivitäten im ausgewählten Verein
|
||
|
||
**Pages:**
|
||
- **Dashboard.razor**:
|
||
- Nächste geplante Spieltage
|
||
- Aktuelle offene Kosten
|
||
- Quick-Actions (neuer Spieltag, neue Person)
|
||
- Statistiken (Anzahl Mitglieder, Gäste, offene Abrechnungen)
|
||
|
||
---
|
||
|
||
### 2. SPIELTAG-BEREICH (Day Management)
|
||
**Route:** `/days`
|
||
|
||
**Pages:**
|
||
- **DayList.razor** (`/days`):
|
||
- Tabelle: PostDate, Status, Teilnehmeranzahl
|
||
- Filter: Jahr, Monat, Status
|
||
- Actions: Neu, Bearbeiten, Löschen, Schließen
|
||
|
||
- **DayDetail.razor** (`/days/{id}`):
|
||
- Spieltag-Info (Datum, Status)
|
||
- Teilnehmerliste mit Anwesenheit
|
||
- Games des Tages
|
||
- PersonExpenses des Tages (Übersicht)
|
||
- Actions: Teilnehmer hinzufügen, Spiel hinzufügen, Status ändern
|
||
|
||
- **DayCreate.razor** (`/days/new`):
|
||
- Formular: Datum, Vorauswahl Teilnehmer aus Mitgliedern
|
||
|
||
- **DayEdit.razor** (`/days/{id}/edit`):
|
||
- Datum ändern, Teilnehmer hinzufügen/entfernen
|
||
|
||
---
|
||
|
||
### 3. SPIEL-BEREICH (Game Management)
|
||
**Route:** `/days/{dayId}/games`
|
||
|
||
**Pages:**
|
||
- **GameList.razor** (`/days/{dayId}/games`):
|
||
- Liste der Spiele eines Spieltags
|
||
- Actions: Neues Spiel, Bearbeiten, Löschen
|
||
|
||
- **GameDetail.razor** (`/days/{dayId}/games/{gameId}`):
|
||
- GameData anzeigen/bearbeiten (JSON-Editor oder strukturierte Eingabe)
|
||
- Teilnehmer des Spiels
|
||
- Kosten des Spiels (PersonExpenses mit GameId)
|
||
- Trigger-Events erfassen (z.B. "Pudel" → Expense zuweisen)
|
||
|
||
- **GameCreate.razor** (`/days/{dayId}/games/new`):
|
||
- Teilnehmer auswählen (aus DayPersons)
|
||
- Optionale GameData-Initialisierung
|
||
|
||
---
|
||
|
||
### 4. KOSTEN-BEREICH (Expense Management)
|
||
**Route:** `/expenses`
|
||
|
||
**Pages:**
|
||
- **ExpenseList.razor** (`/expenses`):
|
||
- Vordefinierte Expenses des Vereins
|
||
- Spalten: Name, Preis, Typ, IsOneClick, IsInverse, IsVariable
|
||
- Actions: Neu, Bearbeiten, Löschen
|
||
|
||
- **ExpenseCreate.razor** (`/expenses/new`):
|
||
- Formular für neue Expense-Vorlage
|
||
- Trigger-Zuordnung optional
|
||
|
||
- **PersonExpenseList.razor** (`/expenses/assigned`):
|
||
- Alle zugewiesenen Kosten (PersonExpenses)
|
||
- Filter: Person, Tag, Status (Open/Done), Datum
|
||
- Bulk-Actions: Als bezahlt markieren, Löschen
|
||
|
||
- **ExpenseTriggerConfig.razor** (`/expenses/triggers`):
|
||
- Trigger-Typen anzeigen
|
||
- Zuordnung Trigger → Expense
|
||
|
||
---
|
||
|
||
### 5. PERSONEN-BEREICH (Person Management)
|
||
**Route:** `/people`
|
||
|
||
**Pages:**
|
||
- **PersonList.razor** (`/people`):
|
||
- Tabelle: Name, Status (Member/Guest), Actions
|
||
- Filter: Status
|
||
- Actions: Neu, Bearbeiten, Löschen
|
||
|
||
- **PersonCreate.razor** (`/people/new`):
|
||
- Name, Status
|
||
|
||
- **PersonDetail.razor** (`/people/{id}`):
|
||
- Personen-Info
|
||
- Teilnahme-Historie (DayPersons)
|
||
- Kosten-Historie (PersonExpenses)
|
||
- Statistiken (Gesamtkosten, Anzahl Teilnahmen)
|
||
|
||
---
|
||
|
||
### 6. AUSWERTUNGEN-BEREICH (Reports/Evaluations)
|
||
**Route:** `/reports`
|
||
|
||
**Pages:**
|
||
- **ReportOverview.razor** (`/reports`):
|
||
- Auswahl: Pro Person, Pro Tag, Pro Spiel
|
||
|
||
- **PersonReport.razor** (`/reports/person/{id}`):
|
||
- Alle Kosten einer Person
|
||
- Summen pro Tag, pro Spiel
|
||
- Zeitraum-Filter
|
||
|
||
- **DayReport.razor** (`/reports/day/{id}`):
|
||
- Alle Kosten eines Spieltags
|
||
- Aufschlüsselung pro Person
|
||
- Export-Option (PDF, CSV)
|
||
|
||
- **PeriodReport.razor** (`/reports/period`):
|
||
- Zeitraum wählen (von-bis)
|
||
- Aggregierte Statistiken
|
||
- Top-Spieler, teuerste Tage, etc.
|
||
|
||
---
|
||
|
||
### 7. STAMMDATEN-BEREICH (Master Data - Vereins-spezifisch)
|
||
**Route:** `/masterdata`
|
||
|
||
**Pages:**
|
||
- **ClubSettings.razor** (`/masterdata/club`):
|
||
- Vereins-Name
|
||
- ExpenseCalculation-Methode
|
||
- Weitere Einstellungen
|
||
|
||
- **ExpenseTemplates.razor** (`/masterdata/expenses`):
|
||
- Siehe Expense-Bereich (evtl. Duplikat)
|
||
|
||
- **TriggerConfig.razor** (`/masterdata/triggers`):
|
||
- Siehe ExpenseTriggerConfig
|
||
|
||
---
|
||
|
||
### 8. ADMIN-BEREICH (SuperAdmin - Vereinsübergreifend)
|
||
**Route:** `/admin`
|
||
|
||
**Pages:**
|
||
- **ClubList.razor** (`/admin/clubs`):
|
||
- Alle Vereine (SuperAdmin only)
|
||
- Actions: Neu, Bearbeiten, Löschen
|
||
|
||
- **ClubCreate.razor** (`/admin/clubs/new`):
|
||
- Name, ExpenseCalculation
|
||
|
||
- **UserManagement.razor** (`/admin/users`):
|
||
- Alle UserProfiles
|
||
- Vereinszuordnung (UserProfileClub)
|
||
- Rollen-Zuordnung pro Verein
|
||
|
||
- **SystemSettings.razor** (`/admin/system`):
|
||
- Globale Einstellungen
|
||
|
||
---
|
||
|
||
### 9. PROFIL-BEREICH (User Profile)
|
||
**Route:** `/profile`
|
||
|
||
**Pages:**
|
||
- **UserProfile.razor** (`/profile`):
|
||
- DisplayName, Locale, TimeZone ändern
|
||
- Passwort ändern
|
||
- Standard-Verein festlegen (UserProfileClub.IsDefault)
|
||
- Vereins-Mitgliedschaften anzeigen
|
||
|
||
---
|
||
|
||
## Vorgeschlagene Navigation-Struktur
|
||
|
||
```
|
||
NavMenu.razor:
|
||
├── 🏠 Dashboard (/)
|
||
├── 📅 Spieltage (/days)
|
||
├── 👥 Personen (/people)
|
||
├── 💰 Kosten
|
||
│ ├── Vorlagen (/expenses)
|
||
│ ├── Zugewiesen (/expenses/assigned)
|
||
│ └── Trigger (/expenses/triggers)
|
||
├── 📊 Auswertungen (/reports)
|
||
│ ├── Pro Person
|
||
│ ├── Pro Tag
|
||
│ └── Zeitraum
|
||
├── ⚙️ Stammdaten (IsClubEditor+)
|
||
│ ├── Verein (/masterdata/club)
|
||
│ └── Kosten-Vorlagen
|
||
├── 🔧 Admin (IsSuperAdmin)
|
||
│ ├── Vereine (/admin/clubs)
|
||
│ ├── Benutzer (/admin/users)
|
||
│ └── System (/admin/system)
|
||
└── 👤 Profil (/profile)
|
||
```
|
||
|
||
---
|
||
|
||
## Prioritäts-Vorschlag (Phasen) - basierend auf User-Feedback
|
||
|
||
### Phase 1: MVP - Basis-Verwaltung (DIESE PLANUNG)
|
||
**Scope:** User/Account-Mgmt, Club, Personen (Teilnehmer), Tage, Strafen
|
||
|
||
1. **User/Account-Verwaltung**
|
||
- User-Registrierung (self-service oder Admin)
|
||
- Passwort zurücksetzen
|
||
- User-zu-Club Zuordnung (UserProfileClub)
|
||
- Rollen pro Club zuweisen (UserProfileClubRoleAssignment)
|
||
- User-Profil (DisplayName, Locale, TimeZone)
|
||
|
||
2. **Club-Verwaltung** (SuperAdmin)
|
||
- Liste, Create, Edit, Delete
|
||
- ExpenseCalculation-Methode
|
||
|
||
3. **Person-Verwaltung** (Club-Teilnehmer: Members + Guests)
|
||
- Liste, Create, Edit, Delete
|
||
- Status (Member/Guest)
|
||
- **KEINE Login** - reine Stammdaten für Kegelclub
|
||
|
||
4. **Day-Verwaltung**
|
||
- Liste, Create, Edit, Delete
|
||
- Datum, Status (New, Started, Closed, Postponed)
|
||
- Teilnehmer zuordnen (DayPerson)
|
||
|
||
5. **PersonExpense - Strafen manuell erfassen**
|
||
- Pro Teilnehmer pro Tag Strafen hinzufügen
|
||
- Expense-Vorlagen (Name, Preis)
|
||
- Status: Open/Done
|
||
|
||
6. **Dashboard**
|
||
- Übersicht: Nächste Tage, offene Kosten
|
||
- Quick-Actions
|
||
|
||
7. **Einfache Auswertung**
|
||
- Pro Tag: Wer schuldet was
|
||
- Pro Person: Summe offener Kosten
|
||
|
||
### Phase 2: Detaillierte Spielverwaltung (SEPARATE PLANUNG SPÄTER)
|
||
**NICHT in dieser Planung:**
|
||
- Wurf-für-Wurf Eingabe
|
||
- Undo-Funktion
|
||
- Plugin-System für verschiedene Kegelspiele
|
||
- GameData strukturiert (JSON für jetzt)
|
||
- Automatische Trigger (Pudel, Pumpe, etc.)
|
||
- Expense-Trigger-Engine
|
||
|
||
### Phase 3: Advanced Features (SPÄTER)
|
||
- Export (PDF, CSV)
|
||
- Benutzer-Rollen verwalten
|
||
- Erweiterte Reports
|
||
|
||
---
|
||
|
||
---
|
||
|
||
# IMPLEMENTIERUNGSPLAN - Phase 1 MVP
|
||
|
||
## Umsetzungsreihenfolge - Übersicht
|
||
|
||
| ✓ | Phase | Bereich | Beschreibung | Dateien |
|
||
|---|-------|---------|--------------|---------|
|
||
| ✓ | A1 | Foundation | Repository Interfaces | 5 Interface-Dateien |
|
||
| ✓ | A2 | Foundation | Repository Implementations | 5 Repository-Dateien |
|
||
| ✓ | A3 | Foundation | DTOs | 5 DTO-Dateien |
|
||
| ✓ | A4 | Foundation | Service Interfaces | 5 Service-Interface-Dateien |
|
||
| ✓ | A5 | Foundation | Service Implementations | 5 Service-Dateien |
|
||
| ✓ | A6 | Foundation | AutoMapper Profiles | 5 Mapping-Dateien |
|
||
| ✓ | A7 | Foundation | DI Registration | 2 DI-Dateien ändern |
|
||
| ✓ | B1 | User/Account | UserService erweitern | 1 Service, 1 Interface, 1 DTO |
|
||
| ✓ | B2 | User/Account | Register Page | 1 Razor |
|
||
| ✓ | B3 | User/Account | Password Reset Pages | 2 Razor |
|
||
| ✓ | B4 | User/Account | Profile Page | 1 Razor |
|
||
| ✓ | B5 | User/Account | Admin Users Page | 1 Razor |
|
||
| ✓ | C1 | Clubs | ClubState Fluxor | 4 State-Dateien |
|
||
| ✓ | C2 | Clubs | Club Pages - ERSTES TESTBARES MVP | 1 Razor |
|
||
| ✓ | D1 | Personen | PersonState Fluxor | 4 State-Dateien |
|
||
| ✓ | D2 | Personen | Person Pages | 1 Razor |
|
||
| ✓ | D3 | Expenses | ExpenseState Fluxor | 4 State-Dateien |
|
||
| ✓ | D4 | Expenses | Expense Pages | 1 Razor |
|
||
| ✓ | E1 | Days | DayState Fluxor | 4 State-Dateien |
|
||
| ✓ | E2 | Days | Days List Page | 1 Razor |
|
||
| ✓ | E3 | Days | Day Details Page | 1 Razor |
|
||
| ✓ | E4 | Days | PersonExpense Management | Components in DayDetails |
|
||
| ✓ | F1 | Dashboard | Dashboard Page | 1 Razor |
|
||
| ✓ | F2 | Dashboard | Evaluation Components | 2 Shared Components |
|
||
| ✓ | F3 | Navigation | NavMenu finalisieren | 1 Razor ändern |
|
||
| ✓ | G1 | Erweiterte Reg. | MembershipStatus + UserProfileClub | 2 Dateien + Migration |
|
||
| ✓ | G2 | Erweiterte Reg. | ClubInvitation Entity | 1 Entity + Migration |
|
||
| ✓ | G3 | Erweiterte Reg. | IEmailService (Stub) | 2 Dateien |
|
||
| ✓ | G4 | Erweiterte Reg. | Services erweitern | 2 Services |
|
||
| ✓ | G5 | Erweiterte Reg. | Dashboard Pending-Widget | 1 Component |
|
||
| ✓ | G6 | Erweiterte Reg. | Admin Users Page erweitern | 1 Razor |
|
||
| ✓ | G7 | Erweiterte Reg. | Club-Beitritt UI | 1 Razor |
|
||
| ✓ | G8 | Erweiterte Reg. | Einladungslink-Handling | 2 Dateien |
|
||
|
||
**Legende:** ☐ = Offen | ☑ = In Arbeit | ✓ = Fertig
|
||
|
||
**Geschätzte Dateien insgesamt: ~90 Dateien**
|
||
|
||
---
|
||
|
||
## Detaillierte Phasen
|
||
|
||
### **Phase A1: Repository Interfaces erstellen**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Domain/Interfaces/IClubRepository.cs`
|
||
2. `src/Koogle.Domain/Interfaces/IPersonRepository.cs`
|
||
3. `src/Koogle.Domain/Interfaces/IExpenseRepository.cs`
|
||
4. `src/Koogle.Domain/Interfaces/IDayRepository.cs` (erweitern)
|
||
5. `src/Koogle.Domain/Interfaces/IPersonExpenseRepository.cs`
|
||
|
||
**Methoden pro Interface:** GetAllAsync/GetByClubIdAsync, GetByIdAsync, AddAsync, UpdateAsync, DeleteAsync
|
||
|
||
---
|
||
|
||
### **Phase A2: Repository Implementations erstellen**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Infrastructure/Repositories/ClubRepository.cs`
|
||
2. `src/Koogle.Infrastructure/Repositories/PersonRepository.cs`
|
||
3. `src/Koogle.Infrastructure/Repositories/ExpenseRepository.cs`
|
||
4. `src/Koogle.Infrastructure/Repositories/DayRepository.cs`
|
||
5. `src/Koogle.Infrastructure/Repositories/PersonExpenseRepository.cs`
|
||
|
||
**Pattern:** IDbContextFactory<AppDbContext>, ClubId-Filter, Include Navigation Properties
|
||
|
||
---
|
||
|
||
### **Phase A3: DTOs erstellen**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Application/DTOs/ClubDto.cs` (ClubDto, CreateClubDto, UpdateClubDto)
|
||
2. `src/Koogle.Application/DTOs/PersonDto.cs` (PersonDto, CreatePersonDto, UpdatePersonDto)
|
||
3. `src/Koogle.Application/DTOs/ExpenseDto.cs` (ExpenseDto, CreateExpenseDto, UpdateExpenseDto)
|
||
4. `src/Koogle.Application/DTOs/DayDto.cs` erweitern (DayDto, CreateDayDto, UpdateDayDto, DayParticipantDto)
|
||
5. `src/Koogle.Application/DTOs/PersonExpenseDto.cs` (PersonExpenseDto, CreatePersonExpenseDto, DayEvaluationDto, PersonDayEvaluationDto)
|
||
|
||
---
|
||
|
||
### **Phase A4: Service Interfaces erstellen**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Application/Interfaces/IClubService.cs`
|
||
2. `src/Koogle.Application/Interfaces/IPersonService.cs`
|
||
3. `src/Koogle.Application/Interfaces/IExpenseService.cs`
|
||
4. `src/Koogle.Application/Interfaces/IDayService.cs` (erweitern)
|
||
5. `src/Koogle.Application/Interfaces/IPersonExpenseService.cs`
|
||
|
||
**Methoden:** GetAllAsync, GetByIdAsync, CreateAsync, UpdateAsync, DeleteAsync + spezifische Methoden
|
||
|
||
---
|
||
|
||
### **Phase A5: Service Implementations erstellen**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Application/Services/ClubService.cs`
|
||
2. `src/Koogle.Application/Services/PersonService.cs`
|
||
3. `src/Koogle.Application/Services/ExpenseService.cs`
|
||
4. `src/Koogle.Application/Services/DayService.cs` (erweitern)
|
||
5. `src/Koogle.Application/Services/PersonExpenseService.cs`
|
||
|
||
**Dependencies:** Repository, ICurrentClubContext, ICurrentUserService, IMapper
|
||
**Business Logic:** ClubId-Injection, Audit-Felder, Validierung (mittels FluentValidation)
|
||
|
||
---
|
||
|
||
### **Phase A6: AutoMapper Profiles erstellen**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Application/Mapping/ClubMappingProfile.cs`
|
||
2. `src/Koogle.Application/Mapping/PersonMappingProfile.cs`
|
||
3. `src/Koogle.Application/Mapping/ExpenseMappingProfile.cs`
|
||
4. `src/Koogle.Application/Mapping/DayMappingProfile.cs`
|
||
5. `src/Koogle.Application/Mapping/PersonExpenseMappingProfile.cs`
|
||
|
||
**Pattern:** CreateMap<Entity, Dto>() bidirektional
|
||
|
||
---
|
||
|
||
### **Phase A7: DI Registration**
|
||
|
||
**Dateien ändern:**
|
||
1. `src/Koogle.Infrastructure/DependencyInjection.cs` (5 Repositories registrieren)
|
||
2. `src/Koogle.Application/DependencyInjection.cs` (5 Services registrieren)
|
||
|
||
---
|
||
|
||
### **Phase B1: UserService erweitern**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Application/Interfaces/IUserService.cs` erweitern
|
||
2. `src/Koogle.Application/Services/UserService.cs` erweitern
|
||
3. `src/Koogle.Application/DTOs/UserDto.cs` erweitern (RegisterUserDto, ResetPasswordDto, UpdateUserProfileDto)
|
||
|
||
**Neue Methoden:**
|
||
- RegisterUserAsync
|
||
- RequestPasswordResetAsync
|
||
- ResetPasswordAsync
|
||
- UpdateProfileAsync
|
||
- AssignUserToClubAsync, RemoveUserFromClubAsync
|
||
- AssignClubRoleAsync, RemoveClubRoleAsync
|
||
|
||
---
|
||
|
||
### **Phase B2: Register Page**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Web/Components/Pages/Account/Register.razor`
|
||
|
||
**Features:** Email, Password, DisplayName, Optional ClubName für initiale Zuordnung
|
||
|
||
---
|
||
|
||
### **Phase B3: Password Reset Pages**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Web/Components/Pages/Account/ForgotPassword.razor`
|
||
2. `src/Koogle.Web/Components/Pages/Account/ResetPassword.razor`
|
||
|
||
**Flow:** Email eingeben → Token per Email → Passwort zurücksetzen
|
||
|
||
---
|
||
|
||
### **Phase B4: Profile Page**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Web/Components/Pages/Account/Profile.razor`
|
||
|
||
**Features:** DisplayName, Locale, TimeZone, Club-Memberships anzeigen, Standard-Club setzen
|
||
|
||
---
|
||
|
||
### **Phase B5: Admin Users Page**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Web/Components/Pages/Admin/Users.razor`
|
||
|
||
**Features:** User-Liste, Club-Zuordnungen, Rollen pro Club
|
||
|
||
---
|
||
|
||
### **Phase C1: ClubState (Fluxor)**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Web/Store/ClubState/ClubState.cs`
|
||
2. `src/Koogle.Web/Store/ClubState/ClubActions.cs`
|
||
3. `src/Koogle.Web/Store/ClubState/ClubReducers.cs`
|
||
4. `src/Koogle.Web/Store/ClubState/ClubEffects.cs`
|
||
|
||
**Actions:** Load, Create, Update, Delete
|
||
|
||
---
|
||
|
||
### **Phase C2: Club Pages**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Web/Components/Pages/Admin/Clubs.razor`
|
||
|
||
**Features:** MudTable, CRUD-Dialogs, SuperAdmin only
|
||
|
||
---
|
||
|
||
### **Phase D1: PersonState (Fluxor)**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Web/Store/PersonState/PersonState.cs`
|
||
2. `src/Koogle.Web/Store/PersonState/PersonActions.cs`
|
||
3. `src/Koogle.Web/Store/PersonState/PersonReducers.cs`
|
||
4. `src/Koogle.Web/Store/PersonState/PersonEffects.cs`
|
||
|
||
---
|
||
|
||
### **Phase D2: Person Pages**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Web/Components/Pages/Persons/Persons.razor`
|
||
|
||
**Features:** MudTable mit Filter (Member/Guest), CRUD
|
||
|
||
---
|
||
|
||
### **Phase D3: ExpenseState (Fluxor)**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Web/Store/ExpenseState/ExpenseState.cs`
|
||
2. `src/Koogle.Web/Store/ExpenseState/ExpenseActions.cs`
|
||
3. `src/Koogle.Web/Store/ExpenseState/ExpenseReducers.cs`
|
||
4. `src/Koogle.Web/Store/ExpenseState/ExpenseEffects.cs`
|
||
|
||
---
|
||
|
||
### **Phase D4: Expense Pages**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Web/Components/Pages/Expenses/Expenses.razor`
|
||
|
||
**Features:** MudTable mit Expense-Vorlagen, CRUD
|
||
|
||
---
|
||
|
||
### **Phase E1: DayState (Fluxor)**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Web/Store/DayState/DayState.cs`
|
||
2. `src/Koogle.Web/Store/DayState/DayActions.cs`
|
||
3. `src/Koogle.Web/Store/DayState/DayReducers.cs`
|
||
4. `src/Koogle.Web/Store/DayState/DayEffects.cs`
|
||
|
||
**State:** Days, SelectedDay, SelectedDayExpenses, AvailablePersons
|
||
|
||
---
|
||
|
||
### **Phase E2: Days List Page**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Web/Components/Pages/Days/Days.razor`
|
||
|
||
**Features:** MudTable mit Jahr-Filter, Create Day
|
||
|
||
---
|
||
|
||
### **Phase E3: Day Details Page**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Web/Components/Pages/Days/DayDetails.razor`
|
||
|
||
**Features:**
|
||
- Day-Header (Datum, Status)
|
||
- Status-Workflow Buttons (New→Started→Closed)
|
||
- Teilnehmer-Sektion (Add/Remove)
|
||
- PersonExpense-Sektion
|
||
|
||
---
|
||
|
||
### **Phase E4: PersonExpense Management**
|
||
|
||
**Components in DayDetails:**
|
||
- PersonExpense-Tabelle
|
||
- Add Expense Dialog (Person auswählen, Expense auswählen, Preis editierbar wenn IsVariable)
|
||
- Delete PersonExpense (nur in New/Started)
|
||
- IsInverse Logic: 1 Person auswählen → alle anderen bekommen Expense
|
||
|
||
---
|
||
|
||
### **Phase F1: Dashboard Page**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Web/Components/Pages/Dashboard.razor`
|
||
|
||
**Features:** Summary Cards, Recent Days, Top Penalty Recipients
|
||
|
||
---
|
||
|
||
### **Phase F2: Evaluation Components**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Web/Components/Shared/DayEvaluationComponent.razor`
|
||
2. `src/Koogle.Web/Components/Shared/PersonEvaluationComponent.razor`
|
||
|
||
---
|
||
|
||
### **Phase F3: Navigation finalisieren**
|
||
|
||
**Dateien ändern:**
|
||
1. `src/Koogle.Web/Components/Layout/NavMenu.razor`
|
||
|
||
**Features:** Dashboard, Spieltage, Stammdaten, Admin, Profil
|
||
|
||
---
|
||
|
||
### **Phase G1: MembershipStatus + UserProfileClub erweitern**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Domain/Enums/MembershipStatus.cs` (neu)
|
||
- Pending, Approved, Rejected
|
||
|
||
2. `src/Koogle.Domain/Entities/UserProfileClub.cs` (erweitern)
|
||
- MembershipStatus Status (default: Pending)
|
||
- string? RejectionReason
|
||
- DateTime? ApprovedAt, Guid? ApprovedById
|
||
- DateTime? RejectedAt, Guid? RejectedById
|
||
|
||
3. Migration erstellen
|
||
|
||
---
|
||
|
||
### **Phase G2: ClubInvitation Entity**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Domain/Entities/ClubInvitation.cs` (neu)
|
||
- Guid Id, Guid ClubId
|
||
- string Token (unique, für URL)
|
||
- DateTime ExpiresAt, DateTime CreatedAt, Guid CreatedById
|
||
- int? MaxUses (null = unbegrenzt), int UsedCount
|
||
|
||
2. `src/Koogle.Infrastructure/Data/AppDbContext.cs` - DbSet hinzufügen
|
||
3. Migration erstellen
|
||
|
||
---
|
||
|
||
### **Phase G3: IEmailService (Stub)**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Application/Interfaces/IEmailService.cs` (neu)
|
||
- SendMembershipRequestNotificationAsync
|
||
- SendMembershipApprovedAsync
|
||
- SendMembershipRejectedAsync
|
||
|
||
2. `src/Koogle.Infrastructure/Services/StubEmailService.cs` (neu)
|
||
- Logging statt echtem Versand
|
||
- TODO-Kommentare für SMTP
|
||
|
||
3. DI Registration
|
||
|
||
---
|
||
|
||
### **Phase G4: Services erweitern (Membership-Logik)**
|
||
|
||
**UserService erweitern:**
|
||
- RequestClubMembershipAsync(userProfileId, clubId)
|
||
- RequestClubMembershipByNameAsync(userProfileId, clubName)
|
||
- RequestClubMembershipByInviteAsync(userProfileId, inviteToken)
|
||
- ApproveMembershipAsync(userProfileId, clubId, approvedById)
|
||
- RejectMembershipAsync(userProfileId, clubId, rejectedById, reason)
|
||
- GetPendingMembershipsAsync(clubId)
|
||
|
||
**ClubService erweitern:**
|
||
- CreateInvitationAsync(clubId, createdById, expiresAt, maxUses)
|
||
- GetInvitationByTokenAsync(token)
|
||
- ValidateInvitationAsync(token)
|
||
|
||
---
|
||
|
||
### **Phase G5: Dashboard Pending-Widget**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Web/Components/Shared/PendingMembershipsWidget.razor` (neu)
|
||
- Anzahl ausstehender Anträge für Club-Admins
|
||
- Link zur Admin Users Page
|
||
|
||
2. Dashboard.razor erweitern - Widget für Admins einbinden
|
||
|
||
---
|
||
|
||
### **Phase G6: Admin Users Page erweitern**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Web/Components/Pages/Admin/Users.razor` (ändern)
|
||
- Tab/Filter für "Ausstehende Anträge"
|
||
- Approve/Reject Buttons
|
||
- Reject-Dialog mit Begründungsfeld
|
||
|
||
---
|
||
|
||
### **Phase G7: Club-Beitritt UI**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Web/Components/Pages/Account/JoinClub.razor` (neu)
|
||
- Eingabefeld für Club-Name
|
||
- Suche/Validierung
|
||
- Beitrittsantrag senden
|
||
- Erfolgsmeldung "Antrag gestellt"
|
||
|
||
2. Dashboard.razor erweitern
|
||
- "Keinem Club zugeordnet" Meldung mit Link zu JoinClub
|
||
|
||
---
|
||
|
||
### **Phase G8: Einladungslink-Handling**
|
||
|
||
**Dateien:**
|
||
1. `src/Koogle.Web/Components/Pages/Club/JoinByInvite.razor` (neu)
|
||
- Route: `/club/join/{token}`
|
||
- Token validieren
|
||
- Wenn eingeloggt: direkt Beitritt (Pending)
|
||
- Wenn nicht eingeloggt: Redirect zu Register mit Token
|
||
|
||
2. `src/Koogle.Web/Controllers/AuthController.cs` (erweitern)
|
||
- InviteToken als optionalen Parameter bei Register
|
||
|
||
---
|
||
|
||
## Zentrale Anforderungen (User-Feedback)
|
||
|
||
### Business Rules
|
||
1. **PersonExpense.Price**: Bei IsVariable=true editierbar, aber vorbelegt aus Expense
|
||
2. **Day Status-Workflow**: Strikt New→Started→Closed, keine Sprünge
|
||
3. **User-Registrierung**: Self-Service (öffentlich)
|
||
4. **Passwort-Reset**: Email-basiert mit Token
|
||
5. **Day-Create**: Alle Members vorbelegt, Gäste manuell
|
||
6. **PersonExpense löschen**: Nur in Status New/Started
|
||
7. **Expense.IsInverse**: Automatisch - 1 Person auswählen, alle anderen bekommen Expense
|
||
8. **Dashboard Zeitraum**: Aktuelles Jahr
|
||
|
||
---
|
||
|
||
## Code-Patterns & Konventionen
|
||
|
||
### Repository Pattern
|
||
- Interface in Domain/Interfaces
|
||
- Implementation in Infrastructure/Repositories
|
||
- Standard-Methoden: GetAllAsync, GetByIdAsync, AddAsync, UpdateAsync, DeleteAsync
|
||
- ClubId-Filter via ICurrentClubContext
|
||
- IDbContextFactory<AppDbContext> für Scoping
|
||
|
||
### Service Pattern
|
||
- Interface in Application/Interfaces
|
||
- Implementation in Application/Services
|
||
- Dependencies: Repository, ICurrentClubContext, ICurrentUserService, IMapper
|
||
- ClubService: IsSuperAdmin Check
|
||
- Audit-Felder auto-setzen (CreatedById, CreatedAt, ModifiedById, ModifiedAt)
|
||
|
||
### Fluxor Pattern (Redux)
|
||
- State: Record mit Collections + IsLoading + Error
|
||
- Actions: Record per Operation (Load, LoadSuccess, LoadFailure, Create, Update, Delete)
|
||
- Reducers: Pure functions, State transformieren
|
||
- Effects: Async Operations, Service-Calls, Dispatcher
|
||
|
||
### UI Pattern (Blazor + MudBlazor)
|
||
- @inherits FluxorComponent
|
||
- @attribute [Authorize(Policy = "...")]
|
||
- MudTable für Listen
|
||
- MudDialog für Create/Edit
|
||
- MudForm mit Validation
|
||
|
||
---
|
||
|
||
## Referenzdateien für Patterns
|
||
|
||
**Service-Pattern:**
|
||
- `src/Koogle.Application/Services/UserService.cs`
|
||
|
||
**Fluxor-Pattern:**
|
||
- `src/Koogle.Web/Store/AuthState/AuthState.cs`
|
||
- `src/Koogle.Web/Store/AuthState/AuthActions.cs`
|
||
- `src/Koogle.Web/Store/AuthState/AuthReducers.cs`
|
||
- `src/Koogle.Web/Store/AuthState/AuthEffects.cs`
|
||
|
||
**AutoMapper:**
|
||
- `src/Koogle.Application/Mapping/UserProfile.cs`
|
||
|
||
**DI:**
|
||
- `src/Koogle.Infrastructure/DependencyInjection.cs`
|
||
- `src/Koogle.Application/DependencyInjection.cs`
|
||
|
||
**Domain:**
|
||
- `src/Koogle.Domain/Entities/BaseEntity.cs`
|
||
|
||
---
|
||
|
||
## Berechtigungen pro Feature
|
||
|
||
- **Club-Verwaltung**: SuperAdmin only
|
||
- **Person/Expense/Day CRUD**: ClubEditor+
|
||
- **Dashboard/Auswertungen**: ClubViewer+
|
||
|
||
Policy: `@attribute [Authorize(Policy = "ClubViewer|ClubEditor|ClubAdmin")]`
|
||
|
||
---
|
||
|
||
## Zusammenfassung Phase 1
|
||
|
||
**23 feine Phasen** → **~75 Dateien** → **MVP Phase 1 komplett** ✓
|
||
|
||
---
|
||
|
||
---
|
||
|
||
# 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
|