Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/SdazaP/ruTournament/llms.txt

Use this file to discover all available pages before exploring further.

The Categories page (/dashboard/tournament/:id/categories) lets you manage the events in an existing tournament. Unlike the creation wizard, which configures everything up front, this page is designed for ongoing mid-tournament adjustments: adding new events after registration opens, tweaking round counts or advancement quotas as the competitor list grows, or correcting schedule times without recreating the tournament. Each category is rendered as a card showing its name, format, schedule, round list, and enrolled competitor count. All edits require Edit Mode to be active and are only available when the tournament is not Finalized.

​
WCA category configuration

WCA categories use a multi-round elimination structure where competitors are ranked by their average (AO5 or AO3) and the top N advance to the next round. Rounds list Each category card shows its rounds in order. Every round displays:
  • Its label — “Ronda N” for preliminary rounds, “Final” for the last round.
  • Its format — AO5 or AO3 (selectable via dropdown when Edit Mode is active).
  • Its advancement quota — how many competitors move forward (not shown on the Final round).
Adding a round Click ”+ Añadir ronda” on a category card to append a new round. The following happens automatically:
  1. Every existing round has isFinal set to false.
  2. The new round is appended with isFinal: true, making it the new Final.
  3. The new round defaults to AO5 format.
You can add as many rounds as the competition structure requires. Removing a round Click the × button on any round row to trigger a confirmation modal. After confirming, the round is removed and the remaining rounds are renumbered. The last surviving round is always promoted to isFinal: true. At least one round must remain in every WCA category.
Deleting a round also deletes any results, groups, and scrambles associated with it. A confirmation modal warns you of this before the deletion is applied.
Advancement quota For each non-final round, select how many top competitors advance. The available options are:
ValueDescription
0 (Ninguno)No competitors advance (effectively blocks the round)
4Top 4 competitors advance
8Top 8 competitors advance
10Top 10 competitors advance
12Top 12 competitors advance
16Top 16 competitors advance
AllAll competitors advance (useful for a single group with no cutoff)
The final round does not have an advancement selector — all competitors in it are competing for the podium. Round format
  • AO5 — 5 solves; the best and worst are discarded and the middle 3 are averaged. Two or more DNFs result in a DNF average.
  • AO3 — 3 solves, mean of all three. One DNF results in a DNF average.

​
Red Bull category configuration

Red Bull categories use a head-to-head elimination bracket instead of rounds. Configuration options control how the bracket is seeded and whether a preliminary round precedes it. Bracket mode Select how competitors are placed into the bracket:
  • Aleatorio (Random) — The system auto-assigns competitors to bracket positions. Seeds are randomised at the moment the bracket is generated in the Results section.
  • Manual — The organiser drags each competitor to their bracket slot in the Results section before the matches begin.
Seeding round Toggle “Ronda de clasificación previa” to enable a preliminary round before the elimination bracket. When enabled:
  1. A seeding round is added (isSeeding: true) with its own time-entry form in the Results section.
  2. After seeding results are entered, competitors are sorted by average and the best performers receive the highest bracket seeds (or automatic byes if the bracket size is a power of 2 that exceeds the field).
  3. A seeding format selector (AO5 or AO3) lets you choose how many solves the seeding round uses.
When the seeding toggle is off, the bracket round is the only round. Competitors are placed directly according to the chosen bracket mode.

​
Schedule fields

Each category card — for both WCA and Red Bull formats — has Start Time and End Time inputs (HH:MM, 24-hour format). These values are stored in CategoryLocal.startTime and CategoryLocal.endTime and feed directly into the Schedule editor timeline (/dashboard/tournament/:id/schedule), where they appear as horizontal bars on a Gantt-style view. When Edit Mode is not active, time changes are written to IndexedDB immediately. When Edit Mode is active, changes are staged in local state and committed when you save via the Guardar Cambios modal. An optional Room field lets you assign a venue room or hall to the category. If two categories share the same room and their time windows overlap, the Schedule editor highlights the conflict in yellow.

​
Predefined WCA events

The following 12 events are available as predefined categories. Each is identified in the codebase by its WCA_EVENT_CONFIG key and rendered with its abbreviation in the UI.
EventAbbreviation
3x33×3
2x22×2
4x44×4
5x55×5
6x66×6
7x77×7
3x3 OHOH
ClockCLK
MegaminxMGA
PyraminxPYR
SkewbSKB
Square-1SQ1
Custom categories (free-text names not in this list) can be added from both the creation wizard and the Categories page. Custom categories use the same WCA or Red Bull format options as predefined events. The tournament supports a maximum of 10 active categories. The “Agregar” button is disabled and a “Límite de 10 alcanzado” message is shown once this limit is reached.

​
Edit Mode and saving

All category mutations — schedule changes, format switches, round additions/removals, advancement quota updates, Red Bull bracket mode and seeding toggles — are staged in local React state while Edit Mode is active. To commit them:
  1. Click “Activar Edición” again (the button turns red and reads “Desactivar Edición” while active).
  2. If any categories were changed or added, the Save Changes modal appears, reporting how many categories were modified.
  3. Click “Guardar Cambios” to call handleSaveAll, which rebuilds the categories array (preserving existing results and matches arrays) and writes the full TournamentLocal record to IndexedDB via db.tournaments.put().
  4. Click “Descartar Cambios” to revert all staged edits to the snapshot taken when Edit Mode was activated.
Category edits are only available when the tournament status is Active (activo) or Upcoming (Próximamente). When the tournament is Finalized, the Edit Mode button shows a lock icon and is disabled. Change the tournament status back to activo from the tournament dashboard to re-enable editing.
Switching a category from WCA to Red Bull (or vice versa) resets its entire rounds configuration. If the category already has results recorded, those results are permanently lost after the change is saved. A warning modal appears before the switch is applied — confirm only if you are certain you want to discard the existing data.

Build docs developers (and LLMs) love

Get started for freeTalk to us