Match scheduling, live scoring, and event recording

The match calendar is the heart of Futsal League Manager. Every fixture in the league — from group-stage clashes to the final — lives here. Referees record goals and cards in real time while fans follow along, see live voting stats, and review detailed match reports once the game ends.

Match lifecycle

Every match moves through three statuses in order:

Status	Meaning
`pendiente`	Scheduled but not yet started. Voting is open for registered users.
`en_curso`	The match is in progress. Referees are recording events live; voting is closed.
`finalizado`	The match is over. The final score is confirmed, standings are updated, and prediction points are awarded.

Referees change the status manually as the match progresses. Once a match is marked finalizado, standings and player stats are recalculated automatically.

Match phases

The tournament is structured across five sequential phases:

Phase	Description
`fase_de_grupos`	Group stage. Results count toward standings.
`octavos`	Round of sixteen. Knockout rounds begin.
`cuartos`	Quarter-finals.
`semis`	Semi-finals.
`final`	The championship match.

Group-stage matches feed the standings table. Knockout matches use placeholder team names (e.g., “Winner Group A”) until the admin assigns confirmed teams after the group stage concludes.

Viewing matches

The match calendar displays all fixtures for the active season ordered by date. Use the season switcher in the top navigation to browse past seasons. Each match card shows:

Teams — logos, names, or placeholder labels if teams are not yet confirmed
Field — the venue name and location
Date and day of week — formatted for quick reading
Score — goals for each team, plus penalty shootout totals when applicable
Status badge — pendiente, en_curso, or finalizado
Voting bar — live breakdown of local / draw / away predictions

Match events

Events are recorded by referees during a match. Each event links a player, a team side (home or away), and one of the following types:

Event type	Description
`gol`	A regular goal. Increments the team’s score and the player’s goal tally.
`tarjeta_amarilla`	Yellow card. Recorded against the player and added to team card stats.
`tarjeta_roja`	Red card. Recorded against the player and added to team card stats.
`penalti_tanda_marcado`	A scored penalty in a shootout. Increments the penalty goal counter only — does not affect regular stats.
`penalti_tanda_fallado`	A missed penalty in a shootout. Logged for the record without affecting any counters.

Events can be removed by the referee while the match is still in progress, which reverses all associated stat changes automatically.

Match detail

Opening a match card navigates to the full detail view, which includes:

Both teams with logos and names
Venue, group, and phase
Full chronological event log (goals, cards, penalty shootout)
Live voting stats with percentage bars for each outcome
Observations field for referee notes, visible once the match has finished

Each match can only be edited by one referee at a time. When a referee opens a match for editing, it is automatically locked for up to two minutes. If another referee tries to access the same match, they see who currently holds the lock. The lock is released automatically when the referee finishes or leaves the match.

Match object structure

List response
Detail response (with events)

{
  "id": 42,
  "date": "2025-03-15T18:00:00",
  "homeTeam": {
    "id": 3,
    "name": "Los Halcones",
    "logoUrl": "https://example.com/logo.webp"
  },
  "awayTeam": {
    "id": 7,
    "name": "Tigres FC",
    "logoUrl": "https://example.com/logo2.webp"
  },
  "homeGoals": 3,
  "awayGoals": 1,
  "homePenaltyGoals": null,
  "awayPenaltyGoals": null,
  "field": {
    "id": 2,
    "name": "Pabellón Municipal",
    "location": "Calle Mayor 10"
  },
  "status": "finalizado",
  "phase": "fase_de_grupos",
  "groupName": "Grupo A",
  "dayOfWeek": "Sábado",
  "observations": null,
  "userVote": "local",
  "votingStats": {
    "local": 14,
    "draw": 4,
    "away": 6,
    "total": 24
  }
}

{
  "id": 42,
  "date": "2025-03-15T18:00:00",
  "homeTeam": { "id": 3, "name": "Los Halcones", "logoUrl": "..." },
  "awayTeam": { "id": 7, "name": "Tigres FC", "logoUrl": "..." },
  "homeGoals": 3,
  "awayGoals": 1,
  "homePenaltyGoals": null,
  "awayPenaltyGoals": null,
  "field": { "id": 2, "name": "Pabellón Municipal", "location": "Calle Mayor 10" },
  "status": "finalizado",
  "phase": "fase_de_grupos",
  "groupName": "Grupo A",
  "observations": "Great match, clean game.",
  "userVote": "local",
  "votingStats": { "local": 14, "draw": 4, "away": 6, "total": 24 },
  "events": [
    {
      "id": 101,
      "type": "goal",
      "player": { "id": 9, "name": "Marco Rossi" },
      "team": "home"
    },
    {
      "id": 102,
      "type": "yellow_card",
      "player": { "id": 15, "name": "Ahmed Khalil" },
      "team": "away"
    },
    {
      "id": 103,
      "type": "goal",
      "player": { "id": 9, "name": "Marco Rossi" },
      "team": "home"
    }
  ]
}

Getting Started

Core Features

User Accounts

Administration

Match scheduling, live scoring, and event recording

Match lifecycle

Match phases

Viewing matches

Match events

Match detail

Match object structure

Build docs developers (and LLMs) love

Getting Started

Core Features

User Accounts

Administration

Documentation Index

​Match lifecycle

​Match phases

​Viewing matches

​Match events

​Match detail

​Match object structure

Build docs developers (and LLMs) love

Match lifecycle

Match phases

Viewing matches

Match events

Match detail

Match object structure