Scheduling Matches

Step-by-step guide for scheduling and managing matches in the Tournament Management App

This guide covers how to create, edit, and manage matches between teams in the Tournament Management App.

Prerequisites

Before scheduling matches, you need:

1. Create at least two teams

   Matches require two different teams (home and away). Navigate to Equipos > Create to add teams.

2. Log in to your account

   Match creation and editing require authentication.

You must have at least 2 teams created before you can schedule any matches. The application will prevent match creation and show an error if this requirement isn’t met.

Creating a New Match

1. Navigate to the Matches page

   From the main navigation menu, select Partidos (Matches).

2. Click 'Crear partido'

   Click the Crear partido (Create match) button.

3. Enter match details

   Fill in all required fields:

   • Fecha y hora (Date and time): Select the match date and time
   • Seleccione un Equipo Local (Select Home Team): Choose the home team
   • Marcador Local (Home Score): Enter the home team’s score (0-100)
   • Seleccione un Equipo Visitante (Select Away Team): Choose the away team
   • Marcador Visitante (Away Score): Enter the away team’s score (0-100)
4. Submit the form

   Click Crear partido (Create match) to save the match.

The date/time field automatically populates with the current date and time when you open the create form.

Match Field Validation

Date and Time

• Required: Cannot be empty
• Format: Uses HTML5 datetime-local input (YYYY-MM-DDTHH:MM)
• Default: Current date and time

Team Selection

• Home Team (Local): Required selection from dropdown
• Away Team (Visitante): Required selection from dropdown
• Important: The same team cannot be selected for both home and away

Smart Team Selection: When you select a home team, that team is automatically hidden from the away team dropdown, and vice versa. This prevents accidentally selecting the same team twice.

Score Validation

Home Score (Marcador Local)

• Required: Cannot be empty
• Type: Must be a number
• Range: Between 0 and 100 (inclusive)
• Default: 0

Away Score (Marcador Visitante)

• Required: Cannot be empty
• Type: Must be a number
• Range: Between 0 and 100 (inclusive)
• Default: 0

Valid Scores

0
1
5
100

Duplicate Prevention: You cannot create a match with the same home team, away team, and exact date/time as an existing match. This prevents duplicate match entries.

Team Selection Interface

The match creation form includes intelligent team selection:

How It Works

1. Initial State: Both dropdowns show all available teams
2. Select Home Team: The selected team is hidden from the away team dropdown
3. Select Away Team: The selected team is hidden from the home team dropdown
4. Change Selection: Previously hidden teams become available again

Technical Implementation

The form uses JavaScript to dynamically hide/show options based on your selections:

// When you select a home team:
// - That team is hidden in the away team dropdown
// - Previously hidden teams are shown again

// When you select an away team:
// - That team is hidden in the home team dropdown
// - Previously hidden teams are shown again

This ensures you can’t accidentally schedule a match where a team plays against itself.

Viewing Matches

The matches list displays:

• Match date and time
• Home team (Local)
• Home score
• Away team (Visitante)
• Away score
• Action buttons (Detail, Edit, Delete)

All users can view match details, but editing and deleting require authentication.

Editing a Match

1. Locate the match

   Find the match you want to edit in the matches list.

2. Click 'Editar'

   Click the Editar (Edit) button for that match.

   You must be logged in to see this button.

3. Update match details

   Modify any of the following:

   • Date and time
   • Home team
   • Home score
   • Away team
   • Away score

   The match ID is read-only.

4. Save changes

   Click Editar partido (Edit match) to save your changes.

Edit Validation

When editing a match:

• All validation rules still apply
• You cannot create a duplicate (same teams and date/time)
• The smart team selection still prevents selecting the same team twice
• Scores must remain within the 0-100 range

Deleting a Match

1. Ensure you're logged in

   Authentication is required to delete matches.

2. Locate the match

   Find the match you want to delete in the list.

3. Click 'Eliminar'

   Click the Eliminar (Delete) button.

4. Confirm deletion

   Confirm the action when prompted.

Matches can typically be deleted without complex dependencies, unlike teams which may have players and matches associated with them.

Viewing Match Details

To see complete match information:

1. Click the Detalle (Detail) button for any match
2. This displays all match data including teams, scores, and date/time
3. Available to all users without authentication

Common Scenarios

Scheduling a tournament

To schedule multiple matches:

1. Create all matches with their scheduled date/time
2. Initially set scores to 0-0
3. After each match is played, edit the match to update the final score
4. Use different date/times for each match

Recording match results

For matches that have been played:

1. Find the scheduled match in the list
2. Click Editar
3. Update the Marcador Local and Marcador Visitante fields
4. Save the changes

Rescheduling a match

To change a match date:

1. Edit the match
2. Update the Fecha y hora field to the new date/time
3. Ensure the new date/time doesn’t create a duplicate
4. Save

Swapping home and away teams

If you need to change which team is home/away:

1. Edit the match
2. Select the new home team from Equipo Local
3. Select the new away team from Equipo Visitante
4. Swap the scores if they’ve already been recorded
5. Save

Troubleshooting

Error: Match already exists

This means a match with the same home team, away team, and exact date/time already exists.

Solutions:

• Change the date/time
• Select different teams
• Check if this is a duplicate entry

Cannot create matches - not enough teams

The application shows an alert: “Primero se deben crear minimos 2 Equipos antes de crear Partidos”

Solution: Click “Crear Equipos” to create at least 2 teams before scheduling matches.

Cannot select different teams

If both team dropdowns seem to show the same team:

1. Refresh the page
2. Select a home team first
3. The JavaScript should automatically hide that team from the away dropdown

Score validation error

Ensure your scores:

• Are between 0 and 100
• Contain only digits
• Are not empty
• Are realistic for soccer/football (typically 0-10)

Date/time not saving correctly

Make sure:

• The browser supports HTML5 datetime-local input
• You’ve selected both a date AND a time
• The format is correct (YYYY-MM-DDTHH:MM)

Edit/Delete buttons are disabled

These actions require authentication. Log in to your account to enable these features.

Best Practices

Tournament Organization: Create all matches at the beginning with 0-0 scores, then update scores as matches are played. This gives you a complete tournament schedule upfront.

Realistic Scores: While the system allows scores up to 100, keep scores realistic for soccer/football (typically 0-10 range).

Scheduling: Space matches appropriately in time to allow teams to rest and travel. Don’t schedule the same team to play multiple matches at the same time.

Documentation: Use the match date/time field precisely. If a match is postponed, update it immediately to avoid confusion.

Match Data Relationships

Understanding how matches relate to teams:

• Each team has a list of PartidosLocal (matches where it’s the home team)
• Each team has a list of PartidosVisitante (matches where it’s the away team)
• When you delete a team, all associated matches must be handled first
• A single match creates relationships with two teams (home and away)

Related Guides

• Managing Teams - Create and manage teams that play in matches
• Managing Players - Manage the players on your teams
• User Roles and Authentication - Understand who can create and edit matches