rename to core

core/racing/application/use-cases/ApplyPenaltyUseCase.ts

@@ -0,0 +1,104 @@
+/**
+ * Application Use Case: ApplyPenaltyUseCase
+ * 
+ * Allows a steward to apply a penalty to a driver for an incident during a race.
+ * The penalty can be standalone or linked to an upheld protest.
+ */
+
+import { Penalty, type PenaltyType } from '../../domain/entities/Penalty';
+import type { IPenaltyRepository } from '../../domain/repositories/IPenaltyRepository';
+import type { IProtestRepository } from '../../domain/repositories/IProtestRepository';
+import type { IRaceRepository } from '../../domain/repositories/IRaceRepository';
+import type { ILeagueMembershipRepository } from '../../domain/repositories/ILeagueMembershipRepository';
+import { randomUUID } from 'crypto';
+import type { AsyncUseCase } from '@gridpilot/shared/application';
+import type { ILogger } from '../../../shared/src/logging/ILogger';
+
+export interface ApplyPenaltyCommand {
+  raceId: string;
+  driverId: string;
+  stewardId: string;
+  type: PenaltyType;
+  value?: number;
+  reason: string;
+  protestId?: string;
+  notes?: string;
+}
+
+export class ApplyPenaltyUseCase
+  implements AsyncUseCase<ApplyPenaltyCommand, { penaltyId: string }> {
+  constructor(
+    private readonly penaltyRepository: IPenaltyRepository,
+    private readonly protestRepository: IProtestRepository,
+    private readonly raceRepository: IRaceRepository,
+    private readonly leagueMembershipRepository: ILeagueMembershipRepository,
+    private readonly logger: ILogger,
+  ) {}
+
+  async execute(command: ApplyPenaltyCommand): Promise<{ penaltyId: string }> {
+    this.logger.debug('ApplyPenaltyUseCase: Executing with command', command);
+    try {
+      // Validate race exists
+      const race = await this.raceRepository.findById(command.raceId);
+      if (!race) {
+        this.logger.warn(`ApplyPenaltyUseCase: Race with ID ${command.raceId} not found.`);
+        throw new Error('Race not found');
+      }
+      this.logger.debug(`ApplyPenaltyUseCase: Race ${race.id} found.`);
+
+      // Validate steward has authority (owner or admin of the league)
+      const memberships = await this.leagueMembershipRepository.getLeagueMembers(race.leagueId);
+      const stewardMembership = memberships.find(
+        m => m.driverId === command.stewardId && m.status === 'active'
+      );
+      
+      if (!stewardMembership || (stewardMembership.role !== 'owner' && stewardMembership.role !== 'admin')) {
+        this.logger.warn(`ApplyPenaltyUseCase: Steward ${command.stewardId} does not have authority for league ${race.leagueId}.`);
+        throw new Error('Only league owners and admins can apply penalties');
+      }
+      this.logger.debug(`ApplyPenaltyUseCase: Steward ${command.stewardId} has authority.`);
+
+      // If linked to a protest, validate the protest exists and is upheld
+      if (command.protestId) {
+        const protest = await this.protestRepository.findById(command.protestId);
+        if (!protest) {
+          this.logger.warn(`ApplyPenaltyUseCase: Protest with ID ${command.protestId} not found.`);
+          throw new Error('Protest not found');
+        }
+        if (protest.status !== 'upheld') {
+          this.logger.warn(`ApplyPenaltyUseCase: Protest ${protest.id} is not upheld. Status: ${protest.status}`);
+          throw new Error('Can only create penalties for upheld protests');
+        }
+        if (protest.raceId !== command.raceId) {
+          this.logger.warn(`ApplyPenaltyUseCase: Protest ${protest.id} is for race ${protest.raceId}, not ${command.raceId}.`);
+          throw new Error('Protest is not for this race');
+        }
+        this.logger.debug(`ApplyPenaltyUseCase: Protest ${protest.id} is valid and upheld.`);
+      }
+
+      // Create the penalty
+      const penalty = Penalty.create({
+        id: randomUUID(),
+        leagueId: race.leagueId,
+        raceId: command.raceId,
+        driverId: command.driverId,
+        type: command.type,
+        ...(command.value !== undefined ? { value: command.value } : {}),
+        reason: command.reason,
+        ...(command.protestId !== undefined ? { protestId: command.protestId } : {}),
+        issuedBy: command.stewardId,
+        status: 'pending',
+        issuedAt: new Date(),
+        ...(command.notes !== undefined ? { notes: command.notes } : {}),
+      });
+
+      await this.penaltyRepository.create(penalty);
+      this.logger.info(`ApplyPenaltyUseCase: Successfully applied penalty ${penalty.id} for driver ${command.driverId} in race ${command.raceId}.`);
+
+      return { penaltyId: penalty.id };
+    } catch (error) {
+      this.logger.error('ApplyPenaltyUseCase: Failed to apply penalty', { command, error: error.message });
+      throw error;
+    }
+  }
+}