408 lines
14 KiB
TypeScript
408 lines
14 KiB
TypeScript
import { v4 as uuidv4 } from 'uuid';
|
|
import { Season } from '../../domain/entities/season/Season';
|
|
import type { ILeagueRepository } from '../../domain/repositories/ILeagueRepository';
|
|
import type { ISeasonRepository } from '../../domain/repositories/ISeasonRepository';
|
|
import type { Weekday } from '../../domain/types/Weekday';
|
|
import { LeagueTimezone } from '../../domain/value-objects/LeagueTimezone';
|
|
import { MonthlyRecurrencePattern } from '../../domain/value-objects/MonthlyRecurrencePattern';
|
|
import { RaceTimeOfDay } from '../../domain/value-objects/RaceTimeOfDay';
|
|
import { RecurrenceStrategyFactory } from '../../domain/value-objects/RecurrenceStrategy';
|
|
import { SeasonDropPolicy, type SeasonDropStrategy } from '../../domain/value-objects/SeasonDropPolicy';
|
|
import { SeasonSchedule } from '../../domain/value-objects/SeasonSchedule';
|
|
import { SeasonScoringConfig } from '../../domain/value-objects/SeasonScoringConfig';
|
|
import { SeasonStewardingConfig } from '../../domain/value-objects/SeasonStewardingConfig';
|
|
import { WeekdaySet } from '../../domain/value-objects/WeekdaySet';
|
|
import type { LeagueConfigFormModel } from '../dto/LeagueConfigFormDTO';
|
|
import type { StewardingDecisionMode } from '../../domain/entities/League';
|
|
|
|
// TODO The whole file mixes a lot of concerns...should be resolved into use cases or is it obsolet?
|
|
|
|
export interface CreateSeasonForLeagueCommand {
|
|
leagueId: string;
|
|
name: string;
|
|
gameId: string;
|
|
sourceSeasonId?: string;
|
|
config?: LeagueConfigFormModel;
|
|
}
|
|
|
|
export interface CreateSeasonForLeagueResultDTO {
|
|
seasonId: string;
|
|
}
|
|
|
|
export interface SeasonSummaryDTO {
|
|
seasonId: string;
|
|
leagueId: string;
|
|
name: string;
|
|
status: 'planned' | 'active' | 'completed' | 'archived' | 'cancelled';
|
|
startDate?: Date;
|
|
endDate?: Date;
|
|
isPrimary: boolean;
|
|
}
|
|
|
|
export interface ListSeasonsForLeagueQuery {
|
|
leagueId: string;
|
|
}
|
|
|
|
export interface ListSeasonsForLeagueResultDTO {
|
|
items: SeasonSummaryDTO[];
|
|
}
|
|
|
|
export interface GetSeasonDetailsQuery {
|
|
leagueId: string;
|
|
seasonId: string;
|
|
}
|
|
|
|
export interface SeasonDetailsDTO {
|
|
seasonId: string;
|
|
leagueId: string;
|
|
gameId: string;
|
|
name: string;
|
|
status: 'planned' | 'active' | 'completed' | 'archived' | 'cancelled';
|
|
startDate?: Date;
|
|
endDate?: Date;
|
|
maxDrivers?: number;
|
|
schedule?: {
|
|
startDate: Date;
|
|
plannedRounds: number;
|
|
};
|
|
scoring?: {
|
|
scoringPresetId: string;
|
|
customScoringEnabled: boolean;
|
|
};
|
|
dropPolicy?: {
|
|
strategy: string;
|
|
n?: number;
|
|
};
|
|
stewarding?: {
|
|
decisionMode: string;
|
|
requiredVotes?: number;
|
|
requireDefense: boolean;
|
|
defenseTimeLimit: number;
|
|
voteTimeLimit: number;
|
|
protestDeadlineHours: number;
|
|
stewardingClosesHours: number;
|
|
notifyAccusedOnProtest: boolean;
|
|
notifyOnVoteRequired: boolean;
|
|
};
|
|
}
|
|
|
|
export type SeasonLifecycleTransition = 'activate' | 'complete' | 'archive' | 'cancel';
|
|
|
|
export interface ManageSeasonLifecycleCommand {
|
|
leagueId: string;
|
|
seasonId: string;
|
|
transition: SeasonLifecycleTransition;
|
|
}
|
|
|
|
export interface ManageSeasonLifecycleResultDTO {
|
|
seasonId: string;
|
|
status: 'planned' | 'active' | 'completed' | 'archived' | 'cancelled';
|
|
startDate?: Date;
|
|
endDate?: Date;
|
|
}
|
|
|
|
export class SeasonApplicationService {
|
|
constructor(
|
|
private readonly leagueRepository: ILeagueRepository,
|
|
private readonly seasonRepository: ISeasonRepository,
|
|
) {}
|
|
|
|
async createSeasonForLeague(command: CreateSeasonForLeagueCommand): Promise<CreateSeasonForLeagueResultDTO> {
|
|
const league = await this.leagueRepository.findById(command.leagueId);
|
|
if (!league) {
|
|
throw new Error(`League not found: ${command.leagueId}`);
|
|
}
|
|
|
|
let baseSeasonProps: {
|
|
schedule?: SeasonSchedule;
|
|
scoringConfig?: SeasonScoringConfig;
|
|
dropPolicy?: SeasonDropPolicy;
|
|
stewardingConfig?: SeasonStewardingConfig;
|
|
maxDrivers?: number;
|
|
} = {};
|
|
|
|
if (command.sourceSeasonId) {
|
|
const source = await this.seasonRepository.findById(command.sourceSeasonId);
|
|
if (!source) {
|
|
throw new Error(`Source Season not found: ${command.sourceSeasonId}`);
|
|
}
|
|
baseSeasonProps = {
|
|
...(source.schedule !== undefined ? { schedule: source.schedule } : {}),
|
|
...(source.scoringConfig !== undefined ? { scoringConfig: source.scoringConfig } : {}),
|
|
...(source.dropPolicy !== undefined ? { dropPolicy: source.dropPolicy } : {}),
|
|
...(source.stewardingConfig !== undefined ? { stewardingConfig: source.stewardingConfig } : {}),
|
|
...(source.maxDrivers !== undefined ? { maxDrivers: source.maxDrivers } : {}),
|
|
};
|
|
} else if (command.config) {
|
|
baseSeasonProps = this.deriveSeasonPropsFromConfig(command.config);
|
|
}
|
|
|
|
const seasonId = uuidv4();
|
|
|
|
const season = Season.create({
|
|
id: seasonId,
|
|
leagueId: league.id.toString(),
|
|
gameId: command.gameId,
|
|
name: command.name,
|
|
year: new Date().getFullYear(),
|
|
status: 'planned',
|
|
...(baseSeasonProps?.schedule ? { schedule: baseSeasonProps.schedule } : {}),
|
|
...(baseSeasonProps?.scoringConfig ? { scoringConfig: baseSeasonProps.scoringConfig } : {}),
|
|
...(baseSeasonProps?.dropPolicy ? { dropPolicy: baseSeasonProps.dropPolicy } : {}),
|
|
...(baseSeasonProps?.stewardingConfig ? { stewardingConfig: baseSeasonProps.stewardingConfig } : {}),
|
|
...(baseSeasonProps?.maxDrivers !== undefined ? { maxDrivers: baseSeasonProps.maxDrivers } : {}),
|
|
});
|
|
|
|
await this.seasonRepository.add(season);
|
|
|
|
return { seasonId };
|
|
}
|
|
|
|
async listSeasonsForLeague(query: ListSeasonsForLeagueQuery): Promise<ListSeasonsForLeagueResultDTO> {
|
|
const league = await this.leagueRepository.findById(query.leagueId);
|
|
if (!league) {
|
|
throw new Error(`League not found: ${query.leagueId}`);
|
|
}
|
|
|
|
const seasons = await this.seasonRepository.listByLeague(league.id.toString());
|
|
const items: SeasonSummaryDTO[] = seasons.map((s) => ({
|
|
seasonId: s.id,
|
|
leagueId: s.leagueId,
|
|
name: s.name,
|
|
status: s.status,
|
|
...(s.startDate !== undefined ? { startDate: s.startDate } : {}),
|
|
...(s.endDate !== undefined ? { endDate: s.endDate } : {}),
|
|
isPrimary: false,
|
|
}));
|
|
|
|
return { items };
|
|
}
|
|
|
|
async getSeasonDetails(query: GetSeasonDetailsQuery): Promise<SeasonDetailsDTO> {
|
|
const league = await this.leagueRepository.findById(query.leagueId);
|
|
if (!league) {
|
|
throw new Error(`League not found: ${query.leagueId}`);
|
|
}
|
|
|
|
const season = await this.seasonRepository.findById(query.seasonId);
|
|
if (!season || season.leagueId !== league.id.toString()) {
|
|
throw new Error(`Season ${query.seasonId} does not belong to league ${league.id}`);
|
|
}
|
|
|
|
return {
|
|
seasonId: season.id,
|
|
leagueId: season.leagueId,
|
|
gameId: season.gameId,
|
|
name: season.name,
|
|
status: season.status,
|
|
...(season.startDate !== undefined ? { startDate: season.startDate } : {}),
|
|
...(season.endDate !== undefined ? { endDate: season.endDate } : {}),
|
|
...(season.maxDrivers !== undefined ? { maxDrivers: season.maxDrivers } : {}),
|
|
...(season.schedule
|
|
? {
|
|
schedule: {
|
|
startDate: season.schedule.startDate,
|
|
plannedRounds: season.schedule.plannedRounds,
|
|
},
|
|
}
|
|
: {}),
|
|
...(season.scoringConfig
|
|
? {
|
|
scoring: {
|
|
scoringPresetId: season.scoringConfig.scoringPresetId,
|
|
customScoringEnabled: season.scoringConfig.customScoringEnabled ?? false,
|
|
},
|
|
}
|
|
: {}),
|
|
...(season.dropPolicy
|
|
? {
|
|
dropPolicy: {
|
|
strategy: season.dropPolicy.strategy,
|
|
...(season.dropPolicy.n !== undefined ? { n: season.dropPolicy.n } : {}),
|
|
},
|
|
}
|
|
: {}),
|
|
...(season.stewardingConfig
|
|
? {
|
|
stewarding: {
|
|
decisionMode: season.stewardingConfig.decisionMode,
|
|
...(season.stewardingConfig.requiredVotes !== undefined
|
|
? { requiredVotes: season.stewardingConfig.requiredVotes }
|
|
: {}),
|
|
requireDefense: season.stewardingConfig.requireDefense,
|
|
defenseTimeLimit: season.stewardingConfig.defenseTimeLimit,
|
|
voteTimeLimit: season.stewardingConfig.voteTimeLimit,
|
|
protestDeadlineHours: season.stewardingConfig.protestDeadlineHours,
|
|
stewardingClosesHours: season.stewardingConfig.stewardingClosesHours,
|
|
notifyAccusedOnProtest: season.stewardingConfig.notifyAccusedOnProtest,
|
|
notifyOnVoteRequired: season.stewardingConfig.notifyOnVoteRequired,
|
|
},
|
|
}
|
|
: {}),
|
|
};
|
|
}
|
|
|
|
async manageSeasonLifecycle(command: ManageSeasonLifecycleCommand): Promise<ManageSeasonLifecycleResultDTO> {
|
|
const league = await this.leagueRepository.findById(command.leagueId);
|
|
if (!league) {
|
|
throw new Error(`League not found: ${command.leagueId}`);
|
|
}
|
|
|
|
const season = await this.seasonRepository.findById(command.seasonId);
|
|
if (!season || season.leagueId !== league.id.toString()) {
|
|
throw new Error(`Season ${command.seasonId} does not belong to league ${league.id}`);
|
|
}
|
|
|
|
let updated: Season;
|
|
switch (command.transition) {
|
|
case 'activate':
|
|
updated = season.activate();
|
|
break;
|
|
case 'complete':
|
|
updated = season.complete();
|
|
break;
|
|
case 'archive':
|
|
updated = season.archive();
|
|
break;
|
|
case 'cancel':
|
|
updated = season.cancel();
|
|
break;
|
|
default:
|
|
throw new Error('Unsupported Season lifecycle transition');
|
|
}
|
|
|
|
await this.seasonRepository.update(updated);
|
|
|
|
return {
|
|
seasonId: updated.id,
|
|
status: updated.status,
|
|
...(updated.startDate !== undefined ? { startDate: updated.startDate } : {}),
|
|
...(updated.endDate !== undefined ? { endDate: updated.endDate } : {}),
|
|
};
|
|
}
|
|
|
|
private parseDropStrategy(value: unknown): SeasonDropStrategy {
|
|
if (value === 'none' || value === 'bestNResults' || value === 'dropWorstN') {
|
|
return value;
|
|
}
|
|
return 'none';
|
|
}
|
|
|
|
private parseDecisionMode(value: unknown): StewardingDecisionMode {
|
|
if (
|
|
value === 'admin_only' ||
|
|
value === 'steward_decides' ||
|
|
value === 'steward_vote' ||
|
|
value === 'member_vote' ||
|
|
value === 'steward_veto' ||
|
|
value === 'member_veto'
|
|
) {
|
|
return value;
|
|
}
|
|
return 'admin_only';
|
|
}
|
|
|
|
private deriveSeasonPropsFromConfig(config: LeagueConfigFormModel): {
|
|
schedule?: SeasonSchedule;
|
|
scoringConfig?: SeasonScoringConfig;
|
|
dropPolicy?: SeasonDropPolicy;
|
|
stewardingConfig?: SeasonStewardingConfig;
|
|
maxDrivers?: number;
|
|
} {
|
|
const schedule = this.buildScheduleFromTimings(config);
|
|
|
|
const scoringConfig = config.scoring
|
|
? new SeasonScoringConfig({
|
|
scoringPresetId: config.scoring.patternId ?? 'custom',
|
|
customScoringEnabled: config.scoring.customScoringEnabled ?? false,
|
|
})
|
|
: undefined;
|
|
|
|
const dropPolicy = config.dropPolicy
|
|
? new SeasonDropPolicy({
|
|
strategy: this.parseDropStrategy(config.dropPolicy.strategy),
|
|
...(config.dropPolicy.n !== undefined ? { n: config.dropPolicy.n } : {}),
|
|
})
|
|
: undefined;
|
|
|
|
const stewardingConfig = config.stewarding
|
|
? new SeasonStewardingConfig({
|
|
decisionMode: this.parseDecisionMode(config.stewarding.decisionMode),
|
|
...(config.stewarding.requiredVotes !== undefined
|
|
? { requiredVotes: config.stewarding.requiredVotes }
|
|
: {}),
|
|
requireDefense: config.stewarding.requireDefense ?? false,
|
|
defenseTimeLimit: config.stewarding.defenseTimeLimit ?? 48,
|
|
voteTimeLimit: config.stewarding.voteTimeLimit ?? 72,
|
|
protestDeadlineHours: config.stewarding.protestDeadlineHours ?? 48,
|
|
stewardingClosesHours: config.stewarding.stewardingClosesHours ?? 168,
|
|
notifyAccusedOnProtest: config.stewarding.notifyAccusedOnProtest ?? true,
|
|
notifyOnVoteRequired: config.stewarding.notifyOnVoteRequired ?? true,
|
|
})
|
|
: undefined;
|
|
|
|
const structure = config.structure ?? {};
|
|
const maxDrivers =
|
|
typeof structure.maxDrivers === 'number' && structure.maxDrivers > 0
|
|
? structure.maxDrivers
|
|
: undefined;
|
|
|
|
return {
|
|
...(schedule !== undefined ? { schedule } : {}),
|
|
...(scoringConfig !== undefined ? { scoringConfig } : {}),
|
|
...(dropPolicy !== undefined ? { dropPolicy } : {}),
|
|
...(stewardingConfig !== undefined ? { stewardingConfig } : {}),
|
|
...(maxDrivers !== undefined ? { maxDrivers } : {}),
|
|
};
|
|
}
|
|
|
|
private buildScheduleFromTimings(config: LeagueConfigFormModel): SeasonSchedule | undefined {
|
|
const { timings } = config;
|
|
if (!timings || !timings.seasonStartDate || !timings.raceStartTime) {
|
|
return undefined;
|
|
}
|
|
|
|
const startDate = new Date(timings.seasonStartDate);
|
|
const timeOfDay = RaceTimeOfDay.fromString(timings.raceStartTime);
|
|
const timezoneId = timings.timezoneId ?? 'UTC';
|
|
const timezone = LeagueTimezone.create(timezoneId);
|
|
|
|
const plannedRounds =
|
|
typeof timings.roundsPlanned === 'number' && timings.roundsPlanned > 0
|
|
? timings.roundsPlanned
|
|
: timings.sessionCount ?? 0;
|
|
|
|
const recurrence = (() => {
|
|
const weekdays: WeekdaySet =
|
|
timings.weekdays && timings.weekdays.length > 0
|
|
? WeekdaySet.fromArray(timings.weekdays as unknown as Weekday[])
|
|
: WeekdaySet.fromArray(['Mon']);
|
|
switch (timings.recurrenceStrategy) {
|
|
case 'everyNWeeks':
|
|
return RecurrenceStrategyFactory.everyNWeeks(
|
|
timings.intervalWeeks ?? 2,
|
|
weekdays,
|
|
);
|
|
case 'monthlyNthWeekday': {
|
|
const pattern = MonthlyRecurrencePattern.create(
|
|
(timings.monthlyOrdinal ?? 1) as 1 | 2 | 3 | 4,
|
|
(timings.monthlyWeekday ?? 'Mon') as Weekday,
|
|
);
|
|
return RecurrenceStrategyFactory.monthlyNthWeekday(pattern);
|
|
}
|
|
case 'weekly':
|
|
default:
|
|
return RecurrenceStrategyFactory.weekly(weekdays);
|
|
}
|
|
})();
|
|
|
|
return new SeasonSchedule({
|
|
startDate,
|
|
timeOfDay,
|
|
timezone,
|
|
recurrence,
|
|
plannedRounds,
|
|
});
|
|
}
|
|
}
|