104 lines
4.5 KiB
TypeScript
104 lines
4.5 KiB
TypeScript
/**
|
|
* 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;
|
|
}
|
|
}
|
|
} |