Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Danielsl4/TFG_DAM_2526_Consulta/llms.txt

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

Every account on Futsal League Manager is assigned one of three roles at registration or by an administrator. Your role determines which parts of the platform you can access and what actions you can perform.
All new accounts start with the user role. Only an administrator can promote an account to referee or admin.

Roles at a glance

CapabilityUserRefereeAdmin
Browse matches and calendarYesYesYes
View standingsYesYesYes
View statisticsYesYesYes
Submit prediction votes (porra)YesYesYes
Follow teamsYesYesYes
View team and player profilesYesYesYes
Manage own profile and accountYesYesYes
Lock / unlock a matchNoYesYes
Change match statusNoYesYes
Add / remove match eventsNoYesYes
Update match observationsNoYesYes
Finish a matchNoYesYes
Create and delete fixturesNoNoYes
Manage seasons, groups, fieldsNoNoYes
Manage teams and playersNoNoYes
Upload imagesNoNoYes
Manage user accountsNoNoYes
View audit logsNoNoYes
Generate season reportsNoNoYes

User

The user role is for fans and registered members of the league community. After creating and verifying an account, you have full access to the public features of the platform.
  • View the full match calendar for any season and filter by group.
  • Open match detail pages to see goals, cards, and referee observations.
  • Browse team profiles, including the squad list and recent results.
  • Browse player profiles with per-season statistics (goals, cards, matches played).
  • View standings tables for any competition group.
  • Explore the statistics section for top scorers, card leaders, and team rankings.
Cast a vote on the outcome of any pending match — home win, draw, or away win — before the referee starts the match. Points are awarded automatically when a match finishes and your prediction is correct. Your total points and global ranking appear on your profile page.
Follow any team to add it to your profile. Your profile page shows:
  • All teams you follow with links to their profiles.
  • Upcoming fixtures for your followed teams.
  • Your total prediction points and global ranking.
You can also delete your account permanently from the profile page.
User JWT tokens expire after 7 days. You will be asked to log in again once the session expires.

Referee

The referee role is for officials who manage matches in progress. Referees have everything a user has, plus access to a set of live-match tools.
Before editing a match, a referee must lock it to prevent conflicting changes from other referees. Locks expire automatically after 2 minutes of inactivity. An administrator can also force-release a lock at any time.
Referees control the match lifecycle by changing its status:
StatusMeaning
pendienteScheduled, not yet started. Prediction voting is open.
en_cursoIn progress. Voting closes. Events can be recorded.
finalizadoFinished. Standings and prediction scores update automatically.
Status transitions are sequential: pendienteen_cursofinalizado.
While a match is in progress, referees add or remove events attributed to individual players:
  • Goal (gol) — increments the team score and the player’s goal tally.
  • Yellow card (tarjeta_amarilla) — recorded against the player and team.
  • Red card (tarjeta_roja) — recorded against the player and team.
  • Penalty shootout goal (penalti_tanda_marcado) — used during shootout phases.
  • Penalty shootout miss (penalti_tanda_fallado) — used during shootout phases.
Removing an event reverses its effect on scores and player statistics.
Referees can add free-text observations to a match at any point. When the match is over, the referee selects Finish match, optionally saves final observations, and the platform:
  1. Sets the match status to finalizado.
  2. Releases the lock automatically.
  3. Updates the group standings.
  4. Calculates and assigns prediction points to all voters.
  5. Updates player statistics (matches played, goals, cards).
Referee JWT tokens expire after 6 hours. Because referees operate live-match tools, a session that expires mid-match will require re-authentication before further edits can be saved.

Admin

The admin role has unrestricted access to every part of the platform. Administrators perform all referee actions and additionally manage the league structure and user accounts through a dedicated admin panel.
  • Create, edit, and archive seasons.
  • Manage competition groups within a season.
  • Add, edit, and remove playing fields.
  • Create fixtures manually by selecting teams, field, group, season, and kick-off date.
  • Delete fixtures (soft-delete — matches are deactivated, not permanently removed).
  • Create and edit teams, including uploading team logos.
  • Add, edit, and remove players, including uploading player photos.
  • Assign players to teams.
  • View all registered accounts.
  • Change any account’s role (user → referee, user → admin, etc.).
  • Deactivate accounts to prevent login without deleting them.
  • View the full audit log of platform actions (match creation, deletion, role changes, etc.) with timestamps and the acting user.
  • Generate season reports covering all finished matches and their events.
Admin JWT tokens expire after 6 hours, the same as referee tokens. Log in again if your session expires while working in the admin panel.

Build docs developers (and LLMs) love