Enter and manage competition results in ruTournament

The Results page (/dashboard/tournament/:id/results) is where competition data is recorded during or after the competition. It is split into two tabs — WCA Format for standard average-based categories and Red Bull for head-to-head elimination brackets. Both tabs share the same edit-mode workflow: activate editing, enter times, save, and the data is immediately persisted to IndexedDB.

WCA Format
Red Bull Format

Selecting a category and round

Use the Categoría and Ronda dropdowns at the top of the page to navigate between events. Only WCA-format categories (those without format: 'redbull') appear in this tab. Switching categories resets the selected round to round 1 and closes any open inline editor.

The results table

The results table lists every competitor registered for the selected round. Columns are:

Column	Description
Competitor	Name, left-aligned
T1 – T3 or T1 – T5	Individual solve times (3 for ao3, 5 for ao5)
Best	Fastest valid solve, highlighted in blue
Avg	Calculated average, highlighted in green

On screens narrower than 768 px the table switches to a card layout — one card per competitor, with a compact 3- or 5-column grid for the individual times.

Entering times

Activate Edit Mode

Click Activar Edición. A yellow floating badge confirms the mode is active. The button is disabled (with a lock icon) when the tournament status is not activo.

Click a time cell

Click any time cell for the competitor you want to edit. All five (or three) cells for that competitor become editable simultaneously.

Type the time

Times can be entered in several formats. The app auto-formats on blur:

Short integers — typing 974 is formatted to 9.74.
5+ digits — typing 10678 is formatted to 1:06.78.
Explicit decimal — typing 9.74 or 1:06.78 is accepted as-is.

This behaviour mirrors the WCA Smart Input standard used by official competition software.

Apply penalties (optional)

Each time cell has +2 and DNF toggle buttons. Clicking an already-active penalty clears it (toggling back to clean '').

Save

Click Guardar in the editing toolbar, or click a different competitor’s row to auto-save before switching. Click Cancelar to discard changes for the current competitor.

TimeRecord structure

Every solve is stored as a TimeRecord:

interface TimeRecord {
  base: number;      // raw time in seconds, e.g. 9.74
  penalty: '' | '+2' | 'DNF';
}

The effective time used for ranking is base + (penalty === '+2' ? 2 : 0). A penalty of 'DNF' means the solve does not count as a valid finish.

Average calculation

Averages are computed by calculateRulesStats(times, format) from ResultsWCA.tsx:

export const calculateRulesStats = (
  times: TimeRecord[],
  format: 'ao3' | 'ao5'
) => { ... };

ao5 — drop the single best and single worst valid time, average the remaining 3. If two or more solves are DNF, the average is DNF (-1).
ao3 — average all three solves. Any single DNF makes the average DNF.

Results are only computed once all solve slots have a value (base > 0 or penalty === 'DNF'); partial rows display – for best and average until complete.

Ranking rules

The sortWCA function ranks competitors in this priority order:

Valid averages (ascending).
DNF averages (after all valid averages).
Incomplete results (no average yet).

Within a tie on average, competitors are ranked by best single (ascending). A second tie falls back to alphabetical name order.

Competitors are ranked by average first, then by best single. DNF averages rank after all valid averages but before incomplete rows.

Round advancement

Each round stores a competitorsToAdvance value (a number or 'all'). The results page reads the previous round’s sorted results and filters the current round’s participant list to only include those who advanced. You do not need to manually promote competitors — switching to a later round automatically shows only the qualifying subset.

Bracket overview

The Red Bull tab manages single-elimination bracket tournaments. After brackets are generated, each elimination round displays match cards in a responsive grid (1 column on mobile, 2 on tablet, 3 on desktop).

Generating brackets

Click Generar Brackets to create matches. Two modes are available:

Random (bracketMode: 'random') — competitors are shuffled randomly into the first-round match slots. When the field size is not a power of two, the competitors not placed into first-round pairings receive byes automatically.
Manual (bracketMode: 'manual') — empty match slots are created and you assign competitors to them via dropdowns in each card while Edit Mode is active.

If the category has a seeding round (hasSeeding: true), the Generar Brackets con Clasificación button becomes available after seeding results are entered. Seeds are ranked by calculateRulesStats + sortWCA and paired using a standard top-vs-bottom bracket draw.

Seeding round

When a category includes a seeding round, it appears first in the round selector as “Clasificación”. Enter times for all competitors the same way as a WCA round — click a cell, type a time, apply penalties, and save. The seeding format (ao3 or ao5) is set when the category is created.

If the Red Bull category has hasSeeding: true, complete the seeding round results before generating brackets. The seeding order determines bracket placement — top seeds receive byes if the competitor count is not a power of two.

Entering match times

Activate Edit Mode

Click Activar Edición.

Click a match card

In Edit Mode, clicking a match card (where both competitor slots are filled) opens a modal dialog.

Enter times for both competitors

The modal shows two sections — one per competitor — each with three time inputs and +2/DNF penalty toggles. Use the same Smart Input format as WCA times.

Save the match

Click Guardar. The app calculates wins per competitor (first to 2 wins out of 3 solves), determines the match winner, and persists the result to IndexedDB.

Match structure

interface RedBullMatchLocal {
  id: string;
  competitor1Id: string;
  competitor2Id: string;
  winner?: string; // competitor ID of the winner, undefined if unfinished
  times: {
    competitor1: (TimeRecord | null)[];
    competitor2: (TimeRecord | null)[];
  };
  wins: {
    competitor1: number;
    competitor2: number;
  };
}

Win counting logic: for each of the three solve slots, the competitor with the lower effective time (applying +2 if present) wins that solve. DNF beats no opponent time, but loses to any valid time.

Automatic bracket progression

When all matches in a round are settled (every match has a winner), the app automatically creates the next round’s match list by pairing the winners. The matches for the next round are generated and saved to IndexedDB without any manual action. Competitors with byes (who sat out the first round due to a non-power-of-two field) are merged back in for the second bracket round.Winners advance automatically until the Final is reached. A blue banner below the match grid lists the advancing competitors by name.

Results entry is only available when the tournament status is Active (activo). Tournaments in Upcoming (proximamente) or Finalized (finalizado) status show a lock icon and block all editing. To re-enable editing on a finalized tournament you must reactivate it from the Dashboard panel.

Get Started

Core Concepts

Tournament Management

Competition Day

Reference

Enter and manage competition results in ruTournament

Selecting a category and round

The results table

Entering times

TimeRecord structure

Average calculation

Ranking rules

Round advancement

Bracket overview

Generating brackets

Seeding round

Entering match times

Match structure

Automatic bracket progression

Build docs developers (and LLMs) love

Get Started

Core Concepts

Tournament Management

Competition Day

Reference

Documentation Index

​Selecting a category and round

​The results table

​Entering times

​TimeRecord structure

​Average calculation

​Ranking rules

​Round advancement

​Bracket overview

​Generating brackets

​Seeding round

​Entering match times

​Match structure

​Automatic bracket progression

Build docs developers (and LLMs) love

Selecting a category and round

The results table

Entering times

TimeRecord structure

Average calculation

Ranking rules

Round advancement

Bracket overview

Generating brackets

Seeding round

Entering match times

Match structure

Automatic bracket progression