Introduces three new schema tables (simulator_profiles, sports_season_simulator_configs, season_participant_simulator_inputs), a central model layer (app/models/simulator.ts), and a single runner entry point so every simulator run follows the same prepare → simulate → persist → snapshot → recalculate flow. Key additions: - manifest.ts: per-simulator display names, default configs, required/ optional inputs, derivable-input declarations, and setup sections - input-policy.ts: resolves sourceElo from projectedWins, projectedTablePoints, or sourceOdds; resolves ratings from sourceOdds; supports block / fallbackElo / averageKnown / worstKnownMinus strategies - runner.ts: single entry point for admin simulation runs; materialises derived inputs, normalises result columns, zeroes omitted participants, snapshots EVs, and recalculates linked fantasy standings - /admin/simulators: inventory page with per-season readiness and bulk run - /admin/sports-seasons/:id/simulator: per-season setup page with readiness summary, input-policy editor, raw JSON config override, and CSV bulk input - NCAAM/NCAAW simulators now read ratings from season_participant_simulator_inputs, falling back to the hardcoded name-keyed maps while DB data is being populated - Clone flow copies simulator config by default; volatile inputs (odds, Elo) only copied when explicitly requested Code-review fixes included in this commit: - source field in compatibility bridge checked with !== null instead of !== undefined - sourceEloRequirementLabel no longer appends "configured fallback" when the participant is already excluded from all resolved sources - Duplicate inline label maps in input-policy.ts replaced with simulatorInputLabel - save-config preserves existing inputPolicy when the submitted JSON omits it - Input table truncation label added (Showing 20 of N) - CSV description notes values must not contain commas - N+1 comment added to listSportsSeasonSimulatorSummaries - assertRegistrySchemaDriftFree called in manifest tests - Runner test suite added covering happy path, already-running guard, readiness failure, empty results, and error recovery with status reset Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
169 lines
6.3 KiB
TypeScript
169 lines
6.3 KiB
TypeScript
import { beforeEach, describe, expect, it, vi } from "vitest";
|
|
|
|
vi.mock("~/models/sports-season", () => ({
|
|
findSportsSeasonById: vi.fn(),
|
|
updateSportsSeason: vi.fn(),
|
|
}));
|
|
vi.mock("~/models/simulator", () => ({
|
|
getSportsSeasonSimulatorConfig: vi.fn(),
|
|
validateSimulatorReadiness: vi.fn(),
|
|
prepareSimulatorInputsForRun: vi.fn(),
|
|
}));
|
|
vi.mock("~/models/season-participant", () => ({
|
|
findParticipantsBySportsSeasonId: vi.fn(),
|
|
}));
|
|
vi.mock("~/models/participant-expected-value", () => ({
|
|
batchUpsertParticipantEVs: vi.fn(),
|
|
}));
|
|
vi.mock("~/models/ev-snapshot", () => ({
|
|
batchUpsertParticipantEvSnapshots: vi.fn(),
|
|
}));
|
|
vi.mock("~/models/scoring-calculator", () => ({
|
|
recalculateStandings: vi.fn(),
|
|
}));
|
|
vi.mock("~/services/simulations/registry", () => ({
|
|
getSimulator: vi.fn(),
|
|
}));
|
|
vi.mock("~/services/simulations/simulation-probabilities", () => ({
|
|
normalizeSimulationResultColumns: vi.fn(),
|
|
}));
|
|
vi.mock("~/database/context", () => ({
|
|
database: vi.fn(() => ({
|
|
query: {
|
|
seasonSports: { findMany: vi.fn().mockResolvedValue([]) },
|
|
seasons: { findFirst: vi.fn() },
|
|
},
|
|
})),
|
|
}));
|
|
|
|
import { runSportsSeasonSimulation } from "../runner";
|
|
import { findSportsSeasonById, updateSportsSeason } from "~/models/sports-season";
|
|
import {
|
|
getSportsSeasonSimulatorConfig,
|
|
validateSimulatorReadiness,
|
|
prepareSimulatorInputsForRun,
|
|
} from "~/models/simulator";
|
|
import { findParticipantsBySportsSeasonId } from "~/models/season-participant";
|
|
import { batchUpsertParticipantEVs } from "~/models/participant-expected-value";
|
|
import { batchUpsertParticipantEvSnapshots } from "~/models/ev-snapshot";
|
|
import { getSimulator } from "~/services/simulations/registry";
|
|
import { normalizeSimulationResultColumns } from "~/services/simulations/simulation-probabilities";
|
|
|
|
const SEASON = {
|
|
id: "season-1",
|
|
simulationStatus: "idle",
|
|
fantasySeasonId: null,
|
|
};
|
|
|
|
const CONFIG = {
|
|
sportsSeasonId: "season-1",
|
|
simulatorType: "nba_bracket" as const,
|
|
config: {},
|
|
profile: { displayName: "NBA Bracket", requiredInputs: [], optionalInputs: [], setupSections: [] },
|
|
};
|
|
|
|
const READY = { canRun: true, missingInputs: [], status: "ready" as const };
|
|
|
|
const PARTICIPANTS = [{ id: "p1" }, { id: "p2" }];
|
|
|
|
const RESULTS = [
|
|
{
|
|
participantId: "p1",
|
|
probabilities: {
|
|
probFirst: 0.5, probSecond: 0.2, probThird: 0.1, probFourth: 0.1,
|
|
probFifth: 0.05, probSixth: 0.03, probSeventh: 0.01, probEighth: 0.01,
|
|
},
|
|
source: "elo_simulation" as const,
|
|
},
|
|
{
|
|
participantId: "p2",
|
|
probabilities: {
|
|
probFirst: 0.5, probSecond: 0.2, probThird: 0.1, probFourth: 0.1,
|
|
probFifth: 0.05, probSixth: 0.03, probSeventh: 0.01, probEighth: 0.01,
|
|
},
|
|
source: "elo_simulation" as const,
|
|
},
|
|
];
|
|
|
|
beforeEach(() => {
|
|
vi.clearAllMocks();
|
|
vi.mocked(findSportsSeasonById).mockResolvedValue(SEASON as never);
|
|
vi.mocked(getSportsSeasonSimulatorConfig).mockResolvedValue(CONFIG as never);
|
|
vi.mocked(validateSimulatorReadiness).mockResolvedValue(READY as never);
|
|
vi.mocked(prepareSimulatorInputsForRun).mockResolvedValue(undefined);
|
|
vi.mocked(updateSportsSeason).mockResolvedValue(undefined as never);
|
|
vi.mocked(findParticipantsBySportsSeasonId).mockResolvedValue(PARTICIPANTS as never);
|
|
vi.mocked(batchUpsertParticipantEVs).mockResolvedValue([] as never);
|
|
vi.mocked(batchUpsertParticipantEvSnapshots).mockResolvedValue(undefined as never);
|
|
vi.mocked(getSimulator).mockReturnValue({ simulate: vi.fn().mockResolvedValue(RESULTS) } as never);
|
|
vi.mocked(normalizeSimulationResultColumns).mockImplementation(() => undefined);
|
|
});
|
|
|
|
describe("runSportsSeasonSimulation", () => {
|
|
it("runs and returns a summary with zeroed participants for those not in results", async () => {
|
|
vi.mocked(findParticipantsBySportsSeasonId).mockResolvedValue([
|
|
...PARTICIPANTS,
|
|
{ id: "p3" },
|
|
] as never);
|
|
|
|
const result = await runSportsSeasonSimulation("season-1");
|
|
|
|
expect(result.simulatedParticipants).toBe(2);
|
|
expect(result.zeroedParticipants).toBe(1);
|
|
expect(result.simulatorType).toBe("nba_bracket");
|
|
expect(result.snapshotDate).toMatch(/^\d{4}-\d{2}-\d{2}$/);
|
|
});
|
|
|
|
it("sets simulationStatus to running before simulate and back to idle after", async () => {
|
|
await runSportsSeasonSimulation("season-1");
|
|
|
|
expect(vi.mocked(updateSportsSeason).mock.calls[0]).toEqual(["season-1", { simulationStatus: "running" }]);
|
|
expect(vi.mocked(updateSportsSeason).mock.calls[1]).toEqual(["season-1", { simulationStatus: "idle" }]);
|
|
});
|
|
|
|
it("throws when the sports season is not found", async () => {
|
|
vi.mocked(findSportsSeasonById).mockResolvedValue(undefined);
|
|
|
|
await expect(runSportsSeasonSimulation("missing")).rejects.toThrow("Sports season not found");
|
|
});
|
|
|
|
it("throws when no simulator config is set", async () => {
|
|
vi.mocked(getSportsSeasonSimulatorConfig).mockResolvedValue(null);
|
|
|
|
await expect(runSportsSeasonSimulation("season-1")).rejects.toThrow("no simulator type configured");
|
|
});
|
|
|
|
it("throws when a simulation is already running", async () => {
|
|
vi.mocked(findSportsSeasonById).mockResolvedValue({ ...SEASON, simulationStatus: "running" } as never);
|
|
|
|
await expect(runSportsSeasonSimulation("season-1")).rejects.toThrow("already running");
|
|
});
|
|
|
|
it("throws when readiness check fails", async () => {
|
|
vi.mocked(validateSimulatorReadiness).mockResolvedValue({
|
|
canRun: false,
|
|
missingInputs: ["Elo rating for 3 participant(s)"],
|
|
status: "not_ready",
|
|
} as never);
|
|
|
|
await expect(runSportsSeasonSimulation("season-1")).rejects.toThrow("not ready");
|
|
});
|
|
|
|
it("sets simulationStatus to failed and re-throws when the simulator errors", async () => {
|
|
vi.mocked(getSimulator).mockReturnValue({
|
|
simulate: vi.fn().mockRejectedValue(new Error("bracket data missing")),
|
|
} as never);
|
|
|
|
await expect(runSportsSeasonSimulation("season-1")).rejects.toThrow("bracket data missing");
|
|
expect(vi.mocked(updateSportsSeason).mock.calls.at(-1)).toEqual(["season-1", { simulationStatus: "failed" }]);
|
|
});
|
|
|
|
it("sets simulationStatus to failed and re-throws when simulate returns no results", async () => {
|
|
vi.mocked(getSimulator).mockReturnValue({
|
|
simulate: vi.fn().mockResolvedValue([]),
|
|
} as never);
|
|
|
|
await expect(runSportsSeasonSimulation("season-1")).rejects.toThrow("no results");
|
|
expect(vi.mocked(updateSportsSeason).mock.calls.at(-1)).toEqual(["season-1", { simulationStatus: "failed" }]);
|
|
});
|
|
});
|