Front end for the scoresheet

.ai/guidelines/fluxui.md

@@ -0,0 +1,4 @@
+## FluxUI
+
+- When building UI, use FluxUI components whenever possible.
+- Use custom HTML/components only when FluxUI does not provide an appropriate option for the required behavior or layout.

.ai/guidelines/git.md

@@ -0,0 +1,5 @@
+## Git
+
+- Use Conventional Commits for commit messages.
+- Format commit subjects as `<type>: <description>`, for example `feat: add misconduct controls` or `fix: correct timeout confirmation state`.
+- Prefer standard types such as `feat`, `fix`, `test`, `refactor`, `docs`, `chore`, and `style`.

.ai/guidelines/testing.md

@@ -2,6 +2,6 @@
 
 - Never pass attributes directly to `create()` or `make()` in tests. Instead, define named state methods on the factory and chain them in the test (e.g. `->asCaptain()`, `->withRole(...)`).
 
-## Static Analysis
+## Rector
 
-- After modifying PHP files, run `vendor/bin/phpstan analyse --memory-limit=256M` and fix any errors before finalizing changes.
+- After modifying PHP files, run `vendor/bin/rector process --clear-cache --memory-limit=2G` and fix any issues before finalizing changes.

.env.example

@@ -63,3 +63,6 @@ AWS_BUCKET=
 AWS_USE_PATH_STYLE_ENDPOINT=false
 
 VITE_APP_NAME="${APP_NAME}"
+
+GAME_TIMEOUT_DURATION=30
+GAME_BETWEEN_SETS_DURATION=180

app/Data/GameState/GameState.php

@@ -5,9 +5,11 @@
 namespace App\Data\GameState;
 
 use App\Enums\TeamAB;
+use App\Enums\TeamSide;
 use App\Models\GameStateSnapshot;
+use Livewire\Wireable;
 
-class GameState
+class GameState implements Wireable
 {
     /** @var array<int, int> */
     public array $rotationTeamA = [];
@@ -25,6 +27,23 @@ public function __construct(
         public int $timeoutsTeamB = 0,
         public int $substitutionsTeamA = 0,
         public int $substitutionsTeamB = 0,
+        public int $improperRequestsTeamA = 0,
+        public int $improperRequestsTeamB = 0,
+        public int $delayWarningsTeamA = 0,
+        public int $delayWarningsTeamB = 0,
+        public int $delayPenaltiesTeamA = 0,
+        public int $delayPenaltiesTeamB = 0,
+        public int $misconductWarningsTeamA = 0,
+        public int $misconductWarningsTeamB = 0,
+        public int $misconductPenaltiesTeamA = 0,
+        public int $misconductPenaltiesTeamB = 0,
+        public int $misconductExpulsionsTeamA = 0,
+        public int $misconductExpulsionsTeamB = 0,
+        public int $misconductDisqualificationsTeamA = 0,
+        public int $misconductDisqualificationsTeamB = 0,
+        public ?TeamSide $teamASide = null,
+        public ?TeamAB $fifthSetLeftTeam = null,
+        public bool $fifthSetSideSwapped = false,
         public ?TeamAB $servingTeam = null,
         public bool $setInProgress = false,
         public bool $gameEnded = false,
@@ -47,6 +66,23 @@ public static function fromSnapshot(GameStateSnapshot $snapshot): self
             timeoutsTeamB: $snapshot->timeouts_team_b,
             substitutionsTeamA: $snapshot->substitutions_team_a,
             substitutionsTeamB: $snapshot->substitutions_team_b,
+            improperRequestsTeamA: $snapshot->improper_requests_team_a,
+            improperRequestsTeamB: $snapshot->improper_requests_team_b,
+            delayWarningsTeamA: $snapshot->delay_warnings_team_a,
+            delayWarningsTeamB: $snapshot->delay_warnings_team_b,
+            delayPenaltiesTeamA: $snapshot->delay_penalties_team_a,
+            delayPenaltiesTeamB: $snapshot->delay_penalties_team_b,
+            misconductWarningsTeamA: $snapshot->misconduct_warnings_team_a,
+            misconductWarningsTeamB: $snapshot->misconduct_warnings_team_b,
+            misconductPenaltiesTeamA: $snapshot->misconduct_penalties_team_a,
+            misconductPenaltiesTeamB: $snapshot->misconduct_penalties_team_b,
+            misconductExpulsionsTeamA: $snapshot->misconduct_expulsions_team_a,
+            misconductExpulsionsTeamB: $snapshot->misconduct_expulsions_team_b,
+            misconductDisqualificationsTeamA: $snapshot->misconduct_disqualifications_team_a,
+            misconductDisqualificationsTeamB: $snapshot->misconduct_disqualifications_team_b,
+            teamASide: $snapshot->team_a_side,
+            fifthSetLeftTeam: $snapshot->fifth_set_left_team,
+            fifthSetSideSwapped: $snapshot->fifth_set_side_swapped,
             servingTeam: $snapshot->serving_team,
             setInProgress: $snapshot->set_in_progress,
             gameEnded: $snapshot->game_ended,
@@ -58,10 +94,66 @@ public static function fromSnapshot(GameStateSnapshot $snapshot): self
         return $state;
     }
 
+    /**
+     * @param  array<string, mixed>  $attributes
+     */
+    public static function fromAttributes(array $attributes): self
+    {
+        $state = new self(
+            setNumber: self::toInteger($attributes['set_number'] ?? 0),
+            scoreTeamA: self::toInteger($attributes['score_team_a'] ?? 0),
+            scoreTeamB: self::toInteger($attributes['score_team_b'] ?? 0),
+            setsWonTeamA: self::toInteger($attributes['sets_won_team_a'] ?? 0),
+            setsWonTeamB: self::toInteger($attributes['sets_won_team_b'] ?? 0),
+            timeoutsTeamA: self::toInteger($attributes['timeouts_team_a'] ?? 0),
+            timeoutsTeamB: self::toInteger($attributes['timeouts_team_b'] ?? 0),
+            substitutionsTeamA: self::toInteger($attributes['substitutions_team_a'] ?? 0),
+            substitutionsTeamB: self::toInteger($attributes['substitutions_team_b'] ?? 0),
+            improperRequestsTeamA: self::toInteger($attributes['improper_requests_team_a'] ?? 0),
+            improperRequestsTeamB: self::toInteger($attributes['improper_requests_team_b'] ?? 0),
+            delayWarningsTeamA: self::toInteger($attributes['delay_warnings_team_a'] ?? 0),
+            delayWarningsTeamB: self::toInteger($attributes['delay_warnings_team_b'] ?? 0),
+            delayPenaltiesTeamA: self::toInteger($attributes['delay_penalties_team_a'] ?? 0),
+            delayPenaltiesTeamB: self::toInteger($attributes['delay_penalties_team_b'] ?? 0),
+            misconductWarningsTeamA: self::toInteger($attributes['misconduct_warnings_team_a'] ?? 0),
+            misconductWarningsTeamB: self::toInteger($attributes['misconduct_warnings_team_b'] ?? 0),
+            misconductPenaltiesTeamA: self::toInteger($attributes['misconduct_penalties_team_a'] ?? 0),
+            misconductPenaltiesTeamB: self::toInteger($attributes['misconduct_penalties_team_b'] ?? 0),
+            misconductExpulsionsTeamA: self::toInteger($attributes['misconduct_expulsions_team_a'] ?? 0),
+            misconductExpulsionsTeamB: self::toInteger($attributes['misconduct_expulsions_team_b'] ?? 0),
+            misconductDisqualificationsTeamA: self::toInteger($attributes['misconduct_disqualifications_team_a'] ?? 0),
+            misconductDisqualificationsTeamB: self::toInteger($attributes['misconduct_disqualifications_team_b'] ?? 0),
+            teamASide: is_string($attributes['team_a_side'] ?? null)
+                ? TeamSide::tryFrom($attributes['team_a_side'])
+                : null,
+            fifthSetLeftTeam: is_string($attributes['fifth_set_left_team'] ?? null)
+                ? TeamAB::tryFrom($attributes['fifth_set_left_team'])
+                : null,
+            fifthSetSideSwapped: (bool) ($attributes['fifth_set_side_swapped'] ?? false),
+            servingTeam: is_string($attributes['serving_team'] ?? null)
+                ? TeamAB::tryFrom($attributes['serving_team'])
+                : null,
+            setInProgress: (bool) ($attributes['set_in_progress'] ?? false),
+            gameEnded: (bool) ($attributes['game_ended'] ?? false),
+        );
+
+        $rotationTeamA = $attributes['rotation_team_a'] ?? [];
+        $rotationTeamB = $attributes['rotation_team_b'] ?? [];
+
+        $state->rotationTeamA = is_array($rotationTeamA)
+            ? self::normalizeRotation($rotationTeamA)
+            : [];
+        $state->rotationTeamB = is_array($rotationTeamB)
+            ? self::normalizeRotation($rotationTeamB)
+            : [];
+
+        return $state;
+    }
+
     /**
      * @return array<string, mixed>
      */
-    public function toSnapshotAttributes(): array
+    public function toAttributes(): array
     {
         return [
             'set_number' => $this->setNumber,
@@ -73,14 +165,44 @@ public function toSnapshotAttributes(): array
             'timeouts_team_b' => $this->timeoutsTeamB,
             'substitutions_team_a' => $this->substitutionsTeamA,
             'substitutions_team_b' => $this->substitutionsTeamB,
-            'serving_team' => $this->servingTeam,
+            'improper_requests_team_a' => $this->improperRequestsTeamA,
+            'improper_requests_team_b' => $this->improperRequestsTeamB,
+            'delay_warnings_team_a' => $this->delayWarningsTeamA,
+            'delay_warnings_team_b' => $this->delayWarningsTeamB,
+            'delay_penalties_team_a' => $this->delayPenaltiesTeamA,
+            'delay_penalties_team_b' => $this->delayPenaltiesTeamB,
+            'misconduct_warnings_team_a' => $this->misconductWarningsTeamA,
+            'misconduct_warnings_team_b' => $this->misconductWarningsTeamB,
+            'misconduct_penalties_team_a' => $this->misconductPenaltiesTeamA,
+            'misconduct_penalties_team_b' => $this->misconductPenaltiesTeamB,
+            'misconduct_expulsions_team_a' => $this->misconductExpulsionsTeamA,
+            'misconduct_expulsions_team_b' => $this->misconductExpulsionsTeamB,
+            'misconduct_disqualifications_team_a' => $this->misconductDisqualificationsTeamA,
+            'misconduct_disqualifications_team_b' => $this->misconductDisqualificationsTeamB,
+            'team_a_side' => $this->teamASide?->value,
+            'fifth_set_left_team' => $this->fifthSetLeftTeam?->value,
+            'fifth_set_side_swapped' => $this->fifthSetSideSwapped,
+            'serving_team' => $this->servingTeam?->value,
             'rotation_team_a' => $this->rotationTeamA,
             'rotation_team_b' => $this->rotationTeamB,
             'set_in_progress' => $this->setInProgress,
             'game_ended' => $this->gameEnded,
         ];
     }
 
+    /**
+     * @return array<string, mixed>
+     */
+    public function toLivewire(): array
+    {
+        return $this->toAttributes();
+    }
+
+    public static function fromLivewire(mixed $value): self
+    {
+        return is_array($value) ? self::fromAttributes($value) : self::initial();
+    }
+
     public function resetCurrentSetCounters(): void
     {
         $this->scoreTeamA = 0;
@@ -107,4 +229,9 @@ private static function normalizeRotation(array $positions): array
 
         return $normalized;
     }
+
+    private static function toInteger(mixed $value): int
+    {
+        return is_numeric($value) ? (int) $value : 0;
+    }
 }

app/Enums/GameEventType.php

@@ -9,8 +9,13 @@ enum GameEventType: string
     case TossCompleted = 'toss_completed';
     case LineupSubmitted = 'lineup_submitted';
     case RallyEnded = 'rally_ended';
+    case CourtSidesSwapped = 'court_sides_swapped';
     case SubstitutionCompleted = 'substitution_completed';
     case TimeOutRequested = 'time_out_requested';
+    case ImproperRequestRecorded = 'improper_request_recorded';
+    case DelayWarningRecorded = 'delay_warning_recorded';
+    case DelayPenaltyRecorded = 'delay_penalty_recorded';
+    case MisconductRecorded = 'misconduct_recorded';
     case SetStarted = 'set_started';
     case SetEnded = 'set_ended';
     case GameEnded = 'game_ended';

app/Enums/ImproperRequestType.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Enums;
+
+enum ImproperRequestType: string
+{
+    case Timeout = 'timeout';
+    case Substitution = 'substitution';
+}

app/Enums/MisconductSanction.php

@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Enums;
+
+enum MisconductSanction: string
+{
+    case Warning = 'warning';
+    case Penalty = 'penalty';
+    case Expulsion = 'expulsion';
+    case Disqualification = 'disqualification';
+}

app/Enums/MisconductSubjectType.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Enums;
+
+enum MisconductSubjectType: string
+{
+    case Player = 'player';
+    case Staff = 'staff';
+}

app/Enums/TeamAB.php

@@ -8,4 +8,11 @@ enum TeamAB: string
 {
     case TeamA = 'team_a';
     case TeamB = 'team_b';
+
+    public function label(): string
+    {
+        return $this === self::TeamA
+            ? 'Team A'
+            : 'Team B';
+    }
 }

app/Events/Payloads/CourtSidesSwappedPayload.php

@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Events\Payloads;
+
+final readonly class CourtSidesSwappedPayload implements GameEventPayload
+{
+    /** @param array<string, mixed> $data */
+    public static function fromArray(array $data): static
+    {
+        return new self;
+    }
+
+    /** @return array<string, mixed> */
+    public function toArray(): array
+    {
+        return [];
+    }
+}

app/Events/Payloads/DelayPenaltyRecordedPayload.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Events\Payloads;
+
+use App\Enums\ImproperRequestType;
+use App\Enums\TeamAB;
+
+final readonly class DelayPenaltyRecordedPayload implements GameEventPayload
+{
+    public function __construct(
+        public TeamAB $team,
+        public TeamAB $awardedTeam,
+        public ImproperRequestType $requestType,
+    ) {}
+
+    /** @param array<string, mixed> $data */
+    public static function fromArray(array $data): static
+    {
+        return new self(
+            team: TeamAB::from($data['team']),
+            awardedTeam: TeamAB::from($data['awarded_team']),
+            requestType: ImproperRequestType::from($data['request_type']),
+        );
+    }
+
+    /** @return array{team: string, awarded_team: string, request_type: string} */
+    public function toArray(): array
+    {
+        return [
+            'team' => $this->team->value,
+            'awarded_team' => $this->awardedTeam->value,
+            'request_type' => $this->requestType->value,
+        ];
+    }
+}

app/Events/Payloads/DelayWarningRecordedPayload.php

@@ -0,0 +1,34 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Events\Payloads;
+
+use App\Enums\ImproperRequestType;
+use App\Enums\TeamAB;
+
+final readonly class DelayWarningRecordedPayload implements GameEventPayload
+{
+    public function __construct(
+        public TeamAB $team,
+        public ImproperRequestType $requestType,
+    ) {}
+
+    /** @param array<string, mixed> $data */
+    public static function fromArray(array $data): static
+    {
+        return new self(
+            team: TeamAB::from($data['team']),
+            requestType: ImproperRequestType::from($data['request_type']),
+        );
+    }
+
+    /** @return array{team: string, request_type: string} */
+    public function toArray(): array
+    {
+        return [
+            'team' => $this->team->value,
+            'request_type' => $this->requestType->value,
+        ];
+    }
+}